Documentation — Spybara

admin-setup.md +1 −3

Details

83Após as sessões WSL serem ativadas, estenda suas configurações gerenciadas para elas:83Após as sessões WSL serem ativadas, estenda suas configurações gerenciadas para elas:

84 84

85* Implante `wslInheritsWindowsSettings: true` através do registro HKLM ou do arquivo `C:\Program Files\ClaudeCode` para que as sessões WSL herdem a mesma política que as sessões do host.85* Implante `wslInheritsWindowsSettings: true` através do registro HKLM ou do arquivo `C:\Program Files\ClaudeCode` para que as sessões WSL herdem a mesma política que as sessões do host.

86* Verifique executando `/status` dentro de uma sessão WSL e lendo a linha `Setting sources`. Claude Code nomeia apenas a [fonte gerenciada que selecionou](/docs/pt/server-managed-settings#settings-precedence), portanto, o que a linha diz a você depende da sessão:86* Verifique executando `/status` dentro de uma sessão WSL e lendo a linha `Setting sources`. Para interpretar o que ela lista, consulte [Leia a fonte em /status](/docs/pt/managed-settings#read-the-source-in-/status).

87 * **Em uma sessão que [busca configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings#platform-availability) e recebe qualquer chave**: `Enterprise managed settings (remote)`, porque Claude Code as seleciona à frente das fontes do Windows, portanto, a linha não mostra se a flag chegou.

88 * **Em qualquer outra sessão**: `Enterprise managed settings (HKLM)` confirma uma implantação de registro. `(file)` nomeia o arquivo do Windows ou o próprio `/etc/claude-code/managed-settings.json` da distribuição, portanto, confirma uma implantação de arquivo do Windows apenas quando a distribuição não tem seu próprio arquivo gerenciado.

89 87

90Os processos dentro da VM utilitária WSL 2 não são visíveis para os sensores de detecção de endpoint do lado do Windows. Para observar a atividade de processo e arquivo dentro da distribuição, verifique a orientação WSL do seu fornecedor de detecção de endpoint para um sensor Linux que você possa executar dentro da distribuição e as exclusões que ele precisa. A [telemetria de execução de ferramentas OpenTelemetry](/docs/pt/monitoring-usage) do Claude Code é emitida de forma idêntica para sessões WSL e nativas.88Os processos dentro da VM utilitária WSL 2 não são visíveis para os sensores de detecção de endpoint do lado do Windows. Para observar a atividade de processo e arquivo dentro da distribuição, verifique a orientação WSL do seu fornecedor de detecção de endpoint para um sensor Linux que você possa executar dentro da distribuição e as exclusões que ele precisa. A [telemetria de execução de ferramentas OpenTelemetry](/docs/pt/monitoring-usage) do Claude Code é emitida de forma idêntica para sessões WSL e nativas.

91 89

advisor.md +10 −7

Details

98O advisor deve ser pelo menos tão capaz quanto o modelo principal. Os advisors aceitos para cada modelo principal são:98O advisor deve ser pelo menos tão capaz quanto o modelo principal. Os advisors aceitos para cada modelo principal são:

99 99

101| --------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |101| -------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |

103| Sonnet 4.6 | Fable, Opus, Sonnet | |103| Sonnet 4.6 | Fable, Opus, Sonnet | |

108| Fable 5 | Fable 5.1 ou Fable 5 | Um advisor Opus ou Sonnet é rejeitado |

109| Fable 5.1 | Fable 5.1 | Um advisor Opus ou Sonnet é rejeitado, e solicitações com um advisor Fable 5 falham com um erro de API |

108 110

109Fable 5.1 requer Claude Code v2.1.257 ou posterior. Ambos os modelos Fable requerem [acesso a Fable](/docs/pt/model-config#work-with-fable).111Fable 5.1 requer Claude Code v2.1.257 ou posterior. Ambos os modelos Fable requerem [acesso a Fable](/docs/pt/model-config#work-with-fable).

110 112

112 114

113Subagentes herdam o advisor configurado e aplicam a mesma verificação de emparelhamento contra seu próprio modelo.115Subagentes herdam o advisor configurado e aplicam a mesma verificação de emparelhamento contra seu próprio modelo.

114 116

115Claude Code valida o emparelhamento antes de enviar uma solicitação:117Claude Code valida o emparelhamento antes de enviar uma solicitação, e a API valida novamente:

116 118

117* Se o advisor for menos capaz que o modelo principal, o advisor não será anexado às solicitações do modelo principal. A saída do comando `/advisor` e uma notificação mostram isso. Subagentes cujo próprio modelo satisfaz o emparelhamento ainda podem usar o advisor.119* Para um advisor que a tabela lista como rejeitado, Claude Code não o anexa às solicitações do modelo principal. A saída do comando `/advisor` e uma notificação mostram isso. Subagentes cujo próprio modelo satisfaz o emparelhamento ainda podem usar o advisor.

120* Para um advisor que a tabela lista como falhando com um erro de API, Claude Code o anexa e a API o recusa. Cada solicitação falha com `'<advisor model>' cannot be used as an advisor when the request model is '<main model>'` até que você altere o advisor com `/advisor` ou o desative.

118* Se o modelo principal ou o advisor for um modelo que Claude Code não reconhece, o advisor não será anexado.121* Se o modelo principal ou o advisor for um modelo que Claude Code não reconhece, o advisor não será anexado.

119 122

120<h3 id="fable-advisor-and-usage-credits">123<h3 id="fable-advisor-and-usage-credits">

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

Details

62 * `"init"`: metadados da sessão para a execução. Quando um hook `SessionStart` ou `Setup` é executado durante a inicialização da sessão, suas [mensagens do ciclo de vida do hook](/docs/pt/agent-sdk/typescript#sdkhookstartedmessage) chegam antes da mensagem `init`62 * `"init"`: metadados da sessão para a execução. Quando um hook `SessionStart` ou `Setup` é executado durante a inicialização da sessão, suas [mensagens do ciclo de vida do hook](/docs/pt/agent-sdk/typescript#sdkhookstartedmessage) chegam antes da mensagem `init`

63 * `"compact_boundary"`: dispara após [compactação](#automatic-compaction)63 * `"compact_boundary"`: dispara após [compactação](#automatic-compaction)

64 * `"informational"`: banners de status em texto simples do loop64 * `"informational"`: banners de status em texto simples do loop

~~65 * `"worker_shutting_down"`: o loop terminará após a volta atual porque o host está saindo ou Remote Control foi desconectado~~65 * `"worker_shutting_down"`: o host está saindo ou Remote Control foi desconectado

66 66

67 Em TypeScript, cada subtipo diferente de `"init"` é seu próprio tipo na união [`SDKMessage`](/docs/pt/agent-sdk/typescript#sdkmessage) em vez de um subtipo de `SDKSystemMessage`.67 Em TypeScript, cada subtipo diferente de `"init"` é seu próprio tipo na união [`SDKMessage`](/docs/pt/agent-sdk/typescript#sdkmessage) em vez de um subtipo de `SDKSystemMessage`.

68* **`AssistantMessage`:** emitida para cada bloco de conteúdo nas respostas do Claude, incluindo a final apenas com texto. Cada uma carrega um único bloco de conteúdo, como texto ou uma chamada de ferramenta, e as mensagens de uma resposta compartilham um ID de mensagem.68* **`AssistantMessage`:** emitida para cada bloco de conteúdo nas respostas do Claude, incluindo a final apenas com texto. Cada uma carrega um único bloco de conteúdo, como texto ou uma chamada de ferramenta, e as mensagens de uma resposta compartilham um ID de mensagem.

239| `"max"` | Profundidade máxima de raciocínio | Problemas com múltiplas etapas que exigem análise profunda |239| `"max"` | Profundidade máxima de raciocínio | Problemas com múltiplas etapas que exigem análise profunda |

240 240

241Se você não definir `effort`, ambos os SDKs deixam o parâmetro indefinido e adiam para o comportamento padrão do modelo.241Se você não definir `effort`, Claude Code resolve o nível de esforço em si, na ordem que [Adjust effort level](/docs/pt/model-config#adjust-effort-level) descreve.

242 242

243<Note>243<Note>

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

357| `success` | Claude terminou a tarefa normalmente | Sim |357| `success` | Claude terminou a tarefa normalmente | Sim |

358| `error_max_turns` | Atingiu o limite de `maxTurns` antes de terminar | Não |358| `error_max_turns` | Atingiu o limite de `maxTurns` antes de terminar | Não |

359| `error_max_budget_usd` | Atingiu o limite de `maxBudgetUsd` antes de terminar | Não |359| `error_max_budget_usd` | Atingiu o limite de `maxBudgetUsd` antes de terminar | Não |

360| `error_during_execution` | Um erro interrompeu o loop (por exemplo, falha de API ou requisição cancelada) | Não |360| `error_during_execution` | Um erro interrompeu o loop (por exemplo, uma requisição cancelada) | Não |

361| `error_max_structured_output_retries` | Nenhuma saída estruturada válida foi produzida dentro do limite de tentativas configurado: todas as tentativas falharam na validação, ou um fallback de modelo retratou a saída concluída sem nenhuma tentativa bem-sucedida | Não |361| `error_max_structured_output_retries` | Nenhuma saída estruturada válida foi produzida dentro do limite de tentativas configurado: todas as tentativas falharam na validação, ou um fallback de modelo retratou a saída concluída sem nenhuma tentativa bem-sucedida | Não |

362 362

363O campo `result` contém a saída de texto final e está presente apenas na variante `success`, então sempre verifique o subtipo antes de lê-lo.363O campo `result` contém a saída de texto final e está presente apenas na variante `success`, então sempre verifique o subtipo antes de lê-lo.

agent-sdk/claude-code-features.md +0 −2

Details

196* **Filesystem hooks:** comandos shell definidos em `settings.json`, carregados quando `settingSources` inclui a fonte relevante. Estes são os mesmos hooks que você configuraria para [sessões interativas de Claude Code](/docs/pt/hooks-guide).196* **Filesystem hooks:** comandos shell definidos em `settings.json`, carregados quando `settingSources` inclui a fonte relevante. Estes são os mesmos hooks que você configuraria para [sessões interativas de Claude Code](/docs/pt/hooks-guide).

197* **Programmatic hooks:** funções de callback passadas diretamente para `query()`. Estes executam em seu processo de aplicação e podem retornar decisões estruturadas. Veja [Control execution with hooks](/docs/pt/agent-sdk/hooks).197* **Programmatic hooks:** funções de callback passadas diretamente para `query()`. Estes executam em seu processo de aplicação e podem retornar decisões estruturadas. Veja [Control execution with hooks](/docs/pt/agent-sdk/hooks).

198 198

199Ambos os tipos executam durante o mesmo ciclo de vida de hook. Se você já tem hooks no `settings.json` do seu projeto e você define `settingSources: ["project"]`, esses hooks executam automaticamente no SDK sem configuração extra.

~~200~~

201Callbacks de hook recebem a entrada da ferramenta e retornam um dict de decisão. Retornar `{}` significa permitir que a ferramenta prossiga. Para bloquear a execução, retorne um objeto `hookSpecificOutput` com `permissionDecision: "deny"` e um `permissionDecisionReason`. A razão é enviada para Claude como o resultado da ferramenta. Veja o [hooks guide](/docs/pt/agent-sdk/hooks) para a assinatura de callback completa e tipos de retorno.199Callbacks de hook recebem a entrada da ferramenta e retornam um dict de decisão. Retornar `{}` significa permitir que a ferramenta prossiga. Para bloquear a execução, retorne um objeto `hookSpecificOutput` com `permissionDecision: "deny"` e um `permissionDecisionReason`. A razão é enviada para Claude como o resultado da ferramenta. Veja o [hooks guide](/docs/pt/agent-sdk/hooks) para a assinatura de callback completa e tipos de retorno.

202 200

203<CodeGroup>201<CodeGroup>

agent-sdk/hooks.md +4 −5

Details

589 Fazer requisições HTTP a partir de hooks589 Fazer requisições HTTP a partir de hooks

590</h3>590</h3>

591 591

592Hooks podem realizar operações assíncronas como requisições HTTP. Capture erros dentro de seu hook em vez de deixá-los se propagar, pois uma exceção não tratada pode interromper o agente.592Hooks podem realizar operações assíncronas como requisições HTTP. Capture erros dentro de seu hook em vez de deixá-los se propagar.

593 593

594Este exemplo envia um webhook após cada ferramenta ser concluída, registrando qual ferramenta foi executada e quando. O hook captura erros para que um webhook falhado não interrompa o agente:594Este exemplo envia um webhook após cada ferramenta ser concluída, registrando qual ferramenta foi executada e quando. O hook captura erros de um webhook falhado:

595 595

596<CodeGroup>596<CodeGroup>

597 ```python Python theme={null}597 ```python Python theme={null}

627 # Run the blocking HTTP call in a thread to avoid blocking the event loop627 # Run the blocking HTTP call in a thread to avoid blocking the event loop

628 await asyncio.to_thread(_send_webhook, input_data["tool_name"])628 await asyncio.to_thread(_send_webhook, input_data["tool_name"])

629 except Exception as e:629 except Exception as e:

630 # Log the error but don't raise. A failed webhook shouldn't stop the agent630 # Log the error but don't raise

631 print(f"Webhook request failed: {e}")631 print(f"Webhook request failed: {e}")

632 632

633 return {}633 return {}

656 if (error instanceof Error && error.name === "AbortError") {656 if (error instanceof Error && error.name === "AbortError") {

657 console.log("Webhook request cancelled");657 console.log("Webhook request cancelled");

658 }658 }

659 // Don't re-throw. A failed webhook shouldn't stop the agent659 // Don't re-throw

660 }660 }

661 661

662 return {};662 return {};

901 901

902Um hook `UserPromptSubmit` que gera subagentes pode criar loops infinitos se esses subagentes acionarem o mesmo hook. Para evitar isso:902Um hook `UserPromptSubmit` que gera subagentes pode criar loops infinitos se esses subagentes acionarem o mesmo hook. Para evitar isso:

903 903

904* Verifique um indicador de subagente na entrada do hook antes de gerar

905* Use uma variável compartilhada ou estado de sessão para rastrear se você já está dentro de um subagente904* Use uma variável compartilhada ou estado de sessão para rastrear se você já está dentro de um subagente

906* Escopo hooks para executar apenas para a sessão de agente de nível superior905* Escopo hooks para executar apenas para a sessão de agente de nível superior

907 906

agent-sdk/mcp.md +1 −1

Details

162| :--------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |162| :--------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |

163| Servidor stdio, ou servidor HTTP/SSE sem uma lista de ferramentas em cache | Sim, até que se conecte | [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão; a conexão falha nesse prazo |163| Servidor stdio, ou servidor HTTP/SSE sem uma lista de ferramentas em cache | Sim, até que se conecte | [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão; a conexão falha nesse prazo |

164| Servidor remoto com uma lista de ferramentas em cache, salva por Claude Code de uma conexão anterior | Não; as ferramentas em cache estão disponíveis desde a primeira volta | Nenhum; conecta na sua primeira chamada de ferramenta, e essa conexão adiada tem seu próprio tempo limite |164| Servidor remoto com uma lista de ferramentas em cache, salva por Claude Code de uma conexão anterior | Não; as ferramentas em cache estão disponíveis desde a primeira volta | Nenhum; conecta na sua primeira chamada de ferramenta, e essa conexão adiada tem seu próprio tempo limite |

166 166

167Para bloquear a própria inicialização em uma fase separada e anterior à espera da primeira volta, antes da mensagem init ser enviada:167Para bloquear a própria inicialização em uma fase separada e anterior à espera da primeira volta, antes da mensagem init ser enviada:

168 168

agent-sdk/modifying-system-prompts.md +1 −1

Details

160 const options = { settings: { outputStyle: "Explanatory" } };160 const options = { settings: { outputStyle: "Explanatory" } };

161 ```161 ```

162 162

163O SDK Python não tem uma opção para selecionar um estilo de saída programaticamente. Para implantações apenas de código onde você não pode escrever em `.claude/settings.local.json`, use `append` ou uma string de prompt personalizada.163No SDK Python, defina `outputStyle` através da opção `settings`, que aceita uma string JSON como `'{"outputStyle": "Explanatory"}'` ou um caminho para um arquivo de configurações que o defina.

164 164

165**Nota para usuários do SDK:** Estilos de saída são carregados quando você inclui `settingSources: ['user']` ou `settingSources: ['project']` (TypeScript) / `setting_sources=["user"]` ou `setting_sources=["project"]` (Python) em suas opções.165**Nota para usuários do SDK:** Estilos de saída são carregados quando você inclui `settingSources: ['user']` ou `settingSources: ['project']` (TypeScript) / `setting_sources=["user"]` ou `setting_sources=["project"]` (Python) em suas opções.

166 166

agent-sdk/overview.md +1 −1

Details

16 16

17| Se você está... | Use | Por quê |17| Se você está... | Use | Por quê |

18| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |18| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |

20| Fazendo desenvolvimento interativo ou executando tarefas únicas de um terminal | [**Claude Code CLI**](/docs/pt/overview) | A interface do terminal, construída para uso interativo diário. |20| Fazendo desenvolvimento interativo ou executando tarefas únicas de um terminal | [**Claude Code CLI**](/docs/pt/overview) | A interface do terminal, construída para uso interativo diário. |

21| Chamando a API diretamente e implementando o loop de ferramentas você mesmo | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Acesso direto à API Anthropic em vez de Claude Code. Você implementa o loop de ferramentas você mesmo. |21| Chamando a API diretamente e implementando o loop de ferramentas você mesmo | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Acesso direto à API Anthropic em vez de Claude Code. Você implementa o loop de ferramentas você mesmo. |

22| Executando agentes de longa duração ou assíncronos sem gerenciar sua própria infraestrutura de sandbox ou sessão | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | API REST hospedada, um produto separado do Agent SDK. Anthropic executa o agente e o sandbox. |22| Executando agentes de longa duração ou assíncronos sem gerenciar sua própria infraestrutura de sandbox ou sessão | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | API REST hospedada, um produto separado do Agent SDK. Anthropic executa o agente e o sandbox. |

agent-sdk/permissions.md +65 −65

Details

4 4

5# Configurar permissões5# Configurar permissões

6 6

~~7> Controle como seu agente usa ferramentas com modos de permissão, hooks e regras declarativas de permitir/negar.~~7> Controle como seu agente usa ferramentas com modos de permissão, hooks e regras declarativas de permissão/negação.

8 8

9O Claude Agent SDK fornece controles de permissão para gerenciar como Claude usa ferramentas. Use modos de permissão e regras para definir o que é permitido automaticamente, e o callback [`canUseTool`](/docs/pt/agent-sdk/user-input) para lidar com tudo mais em tempo de execução.9O Claude Agent SDK fornece controles de permissão para gerenciar como Claude usa ferramentas. Use modos de permissão e regras para definir o que é permitido automaticamente, e o callback [`canUseTool`](/docs/pt/agent-sdk/user-input) para lidar com tudo mais em tempo de execução.

10 10

16 16

17<Steps>17<Steps>

18 <Step title="Hooks">18 <Step title="Hooks">

19 Execute [hooks](/docs/pt/agent-sdk/hooks) primeiro. Um hook pode negar a chamada completamente ou passá-la adiante. Um hook que retorna `allow` não ignora as regras de negar e perguntar abaixo; essas são avaliadas independentemente do resultado do hook. Um hook `PreToolUse` allow também não pode aprovar uma remoção `rm` ou `rmdir` direcionada a um [caminho crítico](/docs/pt/permission-modes#critical-paths).19 Execute [hooks](/docs/pt/agent-sdk/hooks) primeiro. Um hook pode negar a chamada completamente ou deixá-la passar. Um hook que retorna `allow` não ignora as regras de negação e pergunta abaixo; essas são avaliadas independentemente do resultado do hook. Um hook `PreToolUse` allow também não pode aprovar uma remoção `rm` ou `rmdir` direcionada a um [caminho crítico](/docs/pt/permission-modes#critical-paths).

20 </Step>20 </Step>

21 21

22 <Step title="Regras de negação">22 <Step title="Regras de negação">

23 Verifique as regras `deny` (de `disallowed_tools` e [settings.json](/docs/pt/settings-reference#permission-settings)). Se uma regra de negação corresponder, a ferramenta é bloqueada, mesmo no modo `bypassPermissions`. Regras com nome simples como `Bash` removem a ferramenta do contexto do Claude antes desta avaliação começar, portanto apenas regras com escopo como `Bash(rm *)` são verificadas neste passo.23 Verifique as regras `deny` (de `disallowed_tools` e [settings.json](/docs/pt/settings-reference#permission-settings)). Se uma regra de negação corresponder, a ferramenta é bloqueada, mesmo no modo `bypassPermissions`. Regras de negação com nome simples como `Bash` removem a ferramenta do contexto do Claude antes desta avaliação começar, portanto apenas regras com escopo como `Bash(rm *)` são verificadas nesta etapa.

24 </Step>24 </Step>

25 25

26 <Step title="Regras de pergunta">26 <Step title="Regras de pergunta">

27 Verifique as regras `ask` de [settings.json](/docs/pt/settings-reference#permission-settings). Se uma regra de pergunta corresponder, a chamada passa para seu callback [`canUseTool`](/docs/pt/agent-sdk/user-input) para confirmação, mesmo no modo `bypassPermissions`.27 Verifique as regras `ask` de [settings.json](/docs/pt/settings-reference#permission-settings). Se uma regra de pergunta corresponder, a chamada passa para seu callback [`canUseTool`](/docs/pt/agent-sdk/user-input) para confirmação, mesmo no modo `bypassPermissions`.

28 28

29 Ferramentas que requerem interação do usuário se comportam da mesma forma: `AskUserQuestion` e ferramentas MCP cujo servidor define [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool) sempre passam para o callback, mesmo quando uma regra de permitir corresponde. No modo `dontAsk` ambos os casos são negados, porque esse modo nunca solicita. A anotação MCP requer Claude Code v2.1.199 ou posterior.29 Ferramentas que requerem interação do usuário se comportam da mesma forma: `AskUserQuestion` e ferramentas MCP cujo servidor define [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool) sempre passam para o callback, mesmo quando uma regra de permissão corresponde. No modo `dontAsk` ambos os casos são negados, porque esse modo nunca solicita. A anotação MCP requer Claude Code v2.1.199 ou posterior.

30 30

31 Ferramentas do conector [claude.ai](/docs/pt/mcp#organization-controls-on-connector-tools) que sua organização definiu como `ask` também saem do fluxo neste passo. Cada chamada passa para o callback, mesmo no modo `bypassPermissions` e mesmo quando uma regra de permitir corresponde. O callback recebe o motivo `Sua organização requer aprovação para esta ferramenta`. No modo `dontAsk` a chamada é negada, porque esse modo nunca solicita.31 Ferramentas do conector [claude.ai](/docs/pt/mcp#organization-controls-on-connector-tools) que sua organização definiu como `ask` também saem do fluxo nesta etapa. Cada chamada passa para o callback, mesmo no modo `bypassPermissions` e mesmo quando uma regra de permissão corresponde. O callback recebe o motivo `Your organization requires approval for this tool`. No modo `dontAsk` a chamada é negada, porque esse modo nunca solicita.

32 </Step>32 </Step>

33 33

34 <Step title="Modo de permissão">34 <Step title="Modo de permissão">

35 Aplique o [modo de permissão](#permission-modes) ativo:35 Aplique o [modo de permissão](#permission-modes) ativo:

36 36

37 * No modo `bypassPermissions`, Claude Code aprova tudo que chega a este passo, exceto remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths), que passam adiante.37 * No modo `bypassPermissions`, Claude Code aprova tudo que chega a esta etapa, exceto remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths), que passam para a próxima etapa.

38 * No modo `acceptEdits`, Claude Code aprova as operações de arquivo listadas em [Modo Accept edits](#accept-edits-mode-acceptedits).38 * No modo `acceptEdits`, Claude Code aprova as operações de arquivo listadas em [Modo Accept edits](#accept-edits-mode-acceptedits).

39 * No modo `plan`, Claude Code envia ferramentas de edição de arquivo e escrita de shell para seu callback `canUseTool` independentemente das regras de permitir, portanto operações de escrita não podem ser aprovadas automaticamente durante o planejamento.39 * No modo `plan`, Claude Code envia ferramentas de edição de arquivo e escrita de shell para seu callback `canUseTool` independentemente das regras de permissão, para que operações de escrita não possam ser aprovadas automaticamente durante o planejamento.

~~40 * Em outros modos, a solicitação passa adiante.~~40 * Em outros modos, a solicitação passa para a próxima etapa.

41 </Step>41 </Step>

42 42

~~43 <Step title="Regras de permitir">~~43 <Step title="Regras de permissão">

44 Verifique as regras `allow` (de `allowed_tools` e settings.json). Se uma regra corresponder, a ferramenta é aprovada. Uma chamada que a ferramenta aprova por conta própria é resolvida neste passo também, sem necessidade de regra: por exemplo uma leitura de arquivo dentro de seus diretórios de trabalho ou um [comando Bash somente leitura](/docs/pt/permissions#read-only-commands). Remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) nunca são aprovadas por uma regra de permitir: elas chegam ao seu callback nos modos que solicitam, vão para o [classificador](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) no modo `auto` no Claude Code v2.1.218 ou posterior, e são negadas no modo `dontAsk`.44 Verifique as regras `allow` (de `allowed_tools` e settings.json). Se uma regra corresponder, a ferramenta é aprovada. Uma chamada que a ferramenta aprova por conta própria é resolvida nesta etapa também, sem necessidade de regra: por exemplo uma leitura de arquivo dentro de seus diretórios de trabalho ou um [comando Bash somente leitura](/docs/pt/permissions#read-only-commands). Remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) nunca são aprovadas por uma regra de permissão: elas chegam ao seu callback nos modos que solicitam, vão para o [classificador](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) no modo `auto` no Claude Code v2.1.218 ou posterior, e são negadas no modo `dontAsk`.

45 </Step>45 </Step>

46 46

47 <Step title="Callback canUseTool">47 <Step title="Callback canUseTool">

48 Se não for resolvido por nenhum dos anteriores, chame seu callback [`canUseTool`](/docs/pt/agent-sdk/user-input) para uma decisão. No modo `dontAsk`, este passo é ignorado e a ferramenta é negada.48 Se não for resolvido por nenhum dos anteriores, chame seu callback [`canUseTool`](/docs/pt/agent-sdk/user-input) para uma decisão. No modo `dontAsk`, esta etapa é ignorada e a ferramenta é negada.

49 49

50 No SDK TypeScript, se você definir [`permissionPrompts: 'none'`](/docs/pt/agent-sdk/typescript#options), seu callback não é chamado neste passo. Um hook [`PermissionRequest`](/docs/pt/hooks#permissionrequest) ainda tem a chance de decidir, e se não o fizer, Claude Code nega a chamada. A opção requer Claude Code v2.1.259 ou posterior.50 No SDK TypeScript, se você definir [`permissionPrompts: 'none'`](/docs/pt/agent-sdk/typescript#options), seu callback não é chamado nesta etapa. Um hook [`PermissionRequest`](/docs/pt/hooks#permissionrequest) ainda tem a chance de decidir, e se não decidir, Claude Code nega a chamada. A opção requer Claude Code v2.1.259 ou posterior.

51 </Step>51 </Step>

52</Steps>52</Steps>

53 53

54<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" className="dark:hidden" alt="Diagrama do fluxo de avaliação de permissões em seis etapas correspondendo aos passos acima: uma solicitação de ferramenta passa por hooks, regras de negação, regras de pergunta, modo de permissão, regras de permitir e canUseTool. Hooks, regras de negação e canUseTool podem rotear para Bloqueado; bypass de modo de permissão, regras de permitir e canUseTool podem rotear para Executar; regras de pergunta rotear para canUseTool." width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />54<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" className="dark:hidden" alt="Diagrama do fluxo de avaliação de permissões em seis etapas correspondendo às etapas acima: uma solicitação de ferramenta passa por hooks, regras de negação, regras de pergunta, modo de permissão, regras de permissão e canUseTool. Hooks, regras de negação e canUseTool podem rotear para Bloqueado; bypass do modo de permissão, regras de permissão e canUseTool podem rotear para Executar; regras de pergunta rotear para canUseTool." width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />

55 55

56<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/agent-sdk/permissions-flow-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=e53a91e9059cbf51852b7cedb4dd4251" className="hidden dark:block" alt="Diagrama do fluxo de avaliação de permissões em seis etapas correspondendo aos passos acima: uma solicitação de ferramenta passa por hooks, regras de negação, regras de pergunta, modo de permissão, regras de permitir e canUseTool. Hooks, regras de negação e canUseTool podem rotear para Bloqueado; bypass de modo de permissão, regras de permitir e canUseTool podem rotear para Executar; regras de pergunta rotear para canUseTool." width="1180" height="260" data-path="images/agent-sdk/permissions-flow-dark.svg" />56<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/agent-sdk/permissions-flow-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=e53a91e9059cbf51852b7cedb4dd4251" className="hidden dark:block" alt="Diagrama do fluxo de avaliação de permissões em seis etapas correspondendo às etapas acima: uma solicitação de ferramenta passa por hooks, regras de negação, regras de pergunta, modo de permissão, regras de permissão e canUseTool. Hooks, regras de negação e canUseTool podem rotear para Bloqueado; bypass do modo de permissão, regras de permissão e canUseTool podem rotear para Executar; regras de pergunta rotear para canUseTool." width="1180" height="260" data-path="images/agent-sdk/permissions-flow-dark.svg" />

57 57

58Se você passar um callback `canUseTool` em uma configuração onde o SDK TypeScript espera que a ordem de avaliação aprove automaticamente as chamadas antes do callback ser consultado, o SDK emite um aviso de processo Node.js uma vez quando a consulta é construída. O código do aviso é `CLAUDE_SDK_CAN_USE_TOOL_SHADOWED`. Duas configurações o acionam:58Se você passar um callback `canUseTool` em uma configuração onde o SDK TypeScript espera que a ordem de avaliação aprove automaticamente as chamadas antes do callback ser consultado, o SDK emite um aviso de processo Node.js uma vez quando a consulta é construída. O código do aviso é `CLAUDE_SDK_CAN_USE_TOOL_SHADOWED`. Duas configurações o acionam:

59 59

60* `permissionMode: 'bypassPermissions'`, que aprova automaticamente cada chamada que chega ao passo do modo de permissão, exceto pelas [ações que nenhum modo aprova automaticamente](/docs/pt/permission-modes#actions-no-mode-auto-approves)60* `permissionMode: 'bypassPermissions'`, que aprova automaticamente cada chamada que chega à etapa do modo de permissão, exceto pelas [ações que nenhum modo aprova automaticamente](/docs/pt/permission-modes#actions-no-mode-auto-approves)

61* Cada entrada `allowedTools` simples como `"Read"`, que aprova automaticamente essa ferramenta inteira antes do callback ser consultado, exceto pelas [ações que nenhum modo aprova automaticamente](/docs/pt/permission-modes#actions-no-mode-auto-approves)61* Cada entrada `allowedTools` simples como `"Read"`, que aprova automaticamente essa ferramenta inteira antes do callback ser consultado, exceto pelas [ações que nenhum modo aprova automaticamente](/docs/pt/permission-modes#actions-no-mode-auto-approves)

62 62

~~63Entradas com um especificador como `Bash(ls *)` e o modo `acceptEdits` não o acionam, e regras de permitir provenientes de arquivos de configuração não são visíveis para a verificação.~~63Entradas com um especificador como `Bash(ls *)` e o modo `acceptEdits` não o acionam, e regras de permissão provenientes de arquivos de configuração não são visíveis para a verificação.

64 64

65Ouça com `process.on('warning', ...)` e corresponda o código para registrá-lo ou suprimi-lo. Para controlar cada chamada de ferramenta independentemente do modo e das regras, use um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks) em vez disso.65Ouça com `process.on('warning', ...)` e corresponda o código para registrá-lo ou suprimi-lo. Para controlar cada chamada de ferramenta independentemente do modo e das regras, use um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks).

66 66

~~67Esta página se concentra em **regras de permitir e negar** e **modos de permissão**. Para os outros passos:~~67Esta página se concentra em **regras de permissão e negação** e **modos de permissão**. Para as outras etapas:

68 68

~~69* **Hooks:** execute código personalizado para permitir, negar ou modificar solicitações de ferramentas. Consulte [Controlar execução com hooks](/docs/pt/agent-sdk/hooks).~~69* **Hooks:** execute código personalizado para permitir, negar ou modificar solicitações de ferramenta. Veja [Controlar execução com hooks](/docs/pt/agent-sdk/hooks).

70* **Callback canUseTool:** solicite aprovação dos usuários em tempo de execução, quando nenhum passo anterior resolver a chamada. Consulte [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input).70* **Callback canUseTool:** solicite aprovação dos usuários em tempo de execução, quando nenhuma etapa anterior resolver a chamada. Veja [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input).

71 71

72<h2 id="allow-and-deny-rules">72<h2 id="allow-and-deny-rules">

~~73 Regras de permitir e negar~~73 Regras de permissão e negação

74</h2>74</h2>

75 75

76`allowed_tools` e `disallowed_tools` (TypeScript: `allowedTools` / `disallowedTools`) adicionam entradas às listas de regras de permitir e negar no fluxo de avaliação acima. Se você nomear uma das [ferramentas de rastreamento de tarefas](/docs/pt/agent-sdk/todo-tracking#model-availability) em `allowed_tools`, Claude Code também opta a sessão. Qualquer outra ferramenta não listada em `allowed_tools` ainda está disponível para Claude, e uma chamada a ela que precisa de aprovação passa para o modo de permissão. Regras de negar se comportam de forma diferente dependendo se nomeiam uma ferramenta ou definem um padrão dentro de uma.76`allowed_tools` e `disallowed_tools` (TypeScript: `allowedTools` / `disallowedTools`) adicionam entradas às listas de regras de permissão e negação no fluxo de avaliação acima. Se você nomear uma das [ferramentas de rastreamento de tarefas](/docs/pt/agent-sdk/todo-tracking#model-availability) em `allowed_tools`, Claude Code também ativa a sessão. Qualquer outra ferramenta não listada em `allowed_tools` ainda está disponível para Claude, e uma chamada a ela que precisa de aprovação passa para o modo de permissão. As regras de negação se comportam de forma diferente dependendo se nomeiam uma ferramenta ou definem um padrão dentro de uma.

77 77

78| Opção | Efeito |78| Opção | Efeito |

79| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |79| :-------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

80| `allowed_tools=["Read", "Grep"]` | `Read` e `Grep` são auto-aprovadas. Outras ferramentas não listadas aqui ainda existem, e chamadas a elas que precisam de aprovação passam para o modo de permissão e `canUseTool`. |80| `allowed_tools=["Read", "Grep"]` | `Read` e `Grep` são aprovadas automaticamente. Outras ferramentas não listadas aqui ainda existem, e chamadas a elas que precisam de aprovação passam para o modo de permissão e `canUseTool`. |

81| `disallowed_tools=["Bash"]` | A definição da ferramenta `Bash` é removida da solicitação. Claude não vê a ferramenta e não pode tentar usá-la. |81| `disallowed_tools=["Bash"]` | A definição da ferramenta `Bash` é removida da solicitação. Claude não vê a ferramenta e não pode tentar usá-la. |

82| `disallowed_tools=["Bash(rm *)"]` | `Bash` permanece disponível. Chamadas correspondentes a `rm *` [conforme escrito](/docs/pt/permissions#bash-rule-limits) são negadas em todos os modos de permissão, incluindo `bypassPermissions`. Outras chamadas de `Bash`, incluindo `/bin/rm`, passam para o modo de permissão. |82| `disallowed_tools=["Bash(rm *)"]` | `Bash` permanece disponível. Chamadas correspondentes a `rm *` [conforme escrito](/docs/pt/permissions#bash-rule-limits) são negadas em todos os modos de permissão, incluindo `bypassPermissions`. Outras chamadas `Bash`, incluindo `/bin/rm`, passam para o modo de permissão. |

83| `disallowed_tools=["*"]` | Toda definição de ferramenta é removida da solicitação. Globs de nome de ferramenta são suportados em regras de negar: `"*"` corresponde a todas as ferramentas e `"mcp__*"` corresponde a todas as ferramentas MCP em todos os servidores. |83| `disallowed_tools=["*"]` | Toda definição de ferramenta é removida da solicitação. Globs de nome de ferramenta são suportados em regras de negação: `"*"` corresponde a todas as ferramentas e `"mcp__*"` corresponde a todas as ferramentas MCP em todos os servidores. |

84 84

85Regras de permitir aceitam globs de nome de ferramenta apenas após um prefixo literal `mcp__<server>__`. O segmento do servidor deve estar livre de glob para que a regra nomeie um servidor específico que você configurou: `mcp__puppeteer__*` corresponde a todas as ferramentas do servidor `puppeteer`, e `mcp__github__get_*` corresponde às suas ferramentas `get_`. Uma entrada não ancorada como `allowed_tools=["*"]` ou `allowed_tools=["mcp__*"]` é ignorada com um aviso de inicialização e não auto-aprova nada.85As regras de permissão aceitam globs de nome de ferramenta apenas após um prefixo literal `mcp__<server>__`. O segmento do servidor deve estar livre de glob para que a regra nomeie um servidor específico que você configurou: `mcp__puppeteer__*` corresponde a todas as ferramentas do servidor `puppeteer`, e `mcp__github__get_*` corresponde às suas ferramentas `get_`. Uma entrada não ancorada como `allowed_tools=["*"]` ou `allowed_tools=["mcp__*"]` é ignorada com um aviso de inicialização e não aprova automaticamente nada.

86 86

87Regras com escopo para `Read` e `Edit` usam um padrão de caminho. Regras `Edit(path)` governam todas as ferramentas integradas que escrevem arquivos, incluindo `Write` e `NotebookEdit`; uma regra `Write(path)` nunca é correspondida pelas verificações de permissão de arquivo.87As regras com escopo para `Read` e `Edit` usam um padrão de caminho. As regras `Edit(path)` governam todas as ferramentas integradas que escrevem arquivos, incluindo `Write` e `NotebookEdit`; uma regra `Write(path)` nunca é correspondida pelas verificações de permissão de arquivo.

88 88

89Use `//path` para um caminho absoluto do sistema de arquivos: uma regra de negar de `Edit(//secrets/**)` bloqueia escritas em qualquer lugar sob `/secrets` no disco. Com uma única barra inicial, `Edit(/secrets/**)` ancora na fonte da regra em vez disso. Para regras passadas através de `allowed_tools` ou `disallowed_tools`, isso significa o diretório de trabalho da sessão, portanto a regra não bloqueia `/secrets` no disco. Consulte [Regras de Read e Edit](/docs/pt/permissions#read-and-edit) para as quatro formas de âncora e como regras de arquivos de configuração são resolvidas.89Use `//path` para um caminho absoluto do sistema de arquivos: uma regra de negação de `Edit(//secrets/**)` bloqueia escritas em qualquer lugar sob `/secrets` no disco. Com uma única barra inicial, `Edit(/secrets/**)` ancora na fonte da regra. Para regras passadas através de `allowed_tools` ou `disallowed_tools`, isso significa o diretório de trabalho da sessão, portanto a regra não bloqueia `/secrets` no disco. Veja [Regras Read e Edit](/docs/pt/permissions#read-and-edit) para as quatro formas de âncora e como as regras dos arquivos de configuração são resolvidas.

90 90

91<Warning>91<Warning>

92 **Ferramentas auto-aprovadas nunca chegam a `canUseTool`.** Uma chamada de ferramenta aprovada em qualquer etapa anterior, por `acceptEdits` ou `bypassPermissions`, ou por uma regra de permitir, ignora seu callback `canUseTool`, portanto verificações de permissão que você coloca lá são silenciosamente contornadas para essa ferramenta. `AskUserQuestion`, ferramentas MCP marcadas [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool), ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e remoções de `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda chegam ao callback, mesmo quando uma regra de permitir corresponde. No modo `auto`, remoções de caminho crítico vão para o [classificador](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) em vez do callback, enquanto as outras chamadas listadas aqui ainda chegam a ele; o roteamento do classificador requer Claude Code v2.1.218 ou posterior. No modo `dontAsk` essas chamadas são negadas em vez disso, sem invocar o callback.92 **Ferramentas aprovadas automaticamente nunca chegam a `canUseTool`.** Uma chamada de ferramenta aprovada em qualquer etapa anterior, por `acceptEdits` ou `bypassPermissions`, ou por uma regra de permissão, ignora seu callback `canUseTool`, portanto as verificações de permissão que você coloca lá são silenciosamente ignoradas para essa ferramenta. `AskUserQuestion`, ferramentas MCP marcadas [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool), ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda chegam ao callback, mesmo quando uma regra de permissão corresponde. No modo `auto`, as remoções de caminho crítico vão para o [classificador](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) em vez do callback, enquanto as outras chamadas listadas aqui ainda chegam a ele; o roteamento do classificador requer Claude Code v2.1.218 ou posterior. No modo `dontAsk` essas chamadas são negadas, sem invocar o callback.

93 93

94 A cobertura depende da forma da entrada: um nome simples como `Read` ou `mcp__github__get_issue` auto-aprova todas as chamadas para essa ferramenta, exceto as exceções acima, enquanto uma regra com escopo como `Bash(npm test *)` auto-aprova apenas chamadas correspondentes, e outras chamadas de `Bash` que precisam de aprovação ainda passam para o callback. Para verificações que devem ser executadas em todas as chamadas de ferramenta, use um hook [`PreToolUse`](/docs/pt/agent-sdk/hooks): hooks são executados antes de qualquer outra etapa, e uma negação de hook se aplica mesmo no modo `bypassPermissions`.94 A cobertura depende da forma da entrada: um nome simples como `Read` ou `mcp__github__get_issue` aprova automaticamente todas as chamadas a essa ferramenta, exceto as exceções acima, enquanto uma regra com escopo como `Bash(npm test *)` aprova automaticamente apenas chamadas correspondentes, e outras chamadas `Bash` que precisam de aprovação ainda passam para o callback. Para verificações que devem ser executadas em todas as chamadas de ferramenta, use um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks): hooks são executados antes de qualquer outra etapa, e uma negação de hook se aplica mesmo no modo `bypassPermissions`.

95</Warning>95</Warning>

96 96

97Para um agente bloqueado, combine `allowedTools` com `permissionMode: "dontAsk"`:97Para um agente bloqueado, combine `allowedTools` com `permissionMode: "dontAsk"`:

103};103};

104```104```

105 105

106Ferramentas listadas são aprovadas, exceto pelas [ações que nenhum modo auto-aprova](/docs/pt/permission-modes#actions-no-mode-auto-approves), e toda outra chamada que solicitaria é negada em vez disso. Chamadas que não precisam de aprovação no modo `default` são executadas independentemente de você listá-las, como [comandos Bash somente leitura](/docs/pt/permissions#read-only-commands), ferramentas como `Agent` que não solicitam antes de executar, e leituras de arquivo dentro de seus diretórios de trabalho. Para colocar uma ferramenta completamente fora do alcance de Claude, adicione seu nome simples a `disallowedTools`.106As ferramentas listadas são aprovadas, exceto pelas [ações que nenhum modo aprova automaticamente](/docs/pt/permission-modes#actions-no-mode-auto-approves), e todas as outras chamadas que solicitariam aprovação são negadas. Chamadas que não precisam de aprovação no modo `default` são executadas independentemente de você listá-las, como [comandos Bash somente leitura](/docs/pt/permissions#read-only-commands), ferramentas como `Agent` que não solicitam antes de executar, e leituras de arquivo dentro de seus diretórios de trabalho. Para colocar uma ferramenta completamente fora do alcance de Claude, adicione seu nome simples a `disallowedTools`.

107 107

108<Warning>108<Warning>

109 **`allowed_tools` não restringe `bypassPermissions`.** `allowed_tools` pré-aprova apenas as ferramentas que você lista. Ferramentas não listadas não são correspondidas por nenhuma regra de permitir e passam para o modo de permissão, onde `bypassPermissions` as aprova. Definir `allowed_tools=["Read"]` junto com `permission_mode="bypassPermissions"` ainda aprova todas as ferramentas, incluindo `Bash`, `Write` e `Edit`. Se você precisar de `bypassPermissions` mas quiser que ferramentas específicas sejam bloqueadas, use `disallowed_tools`.109 **`allowed_tools` não restringe `bypassPermissions`.** `allowed_tools` aprova previamente as ferramentas que você lista. Outras ferramentas não listadas não são correspondidas por nenhuma regra de permissão e passam para o modo de permissão, onde `bypassPermissions` as aprova. Definir `allowed_tools=["Read"]` junto com `permission_mode="bypassPermissions"` ainda aprova todas as ferramentas, incluindo `Bash`, `Write` e `Edit`. Se você precisar de `bypassPermissions` mas quiser ferramentas específicas bloqueadas, use `disallowed_tools`.

110</Warning>110</Warning>

111 111

112Você também pode configurar regras de permitir, negar e perguntar declarativamente em `.claude/settings.json`. Essas regras são lidas quando a fonte de configuração `project` está habilitada, o que é o padrão para opções `query()`. Se você definir `setting_sources` (TypeScript: `settingSources`) explicitamente, inclua `"project"` para que se apliquem. Consulte [Configurações de permissão](/docs/pt/settings-reference#permission-settings) para a sintaxe das regras.112Você também pode configurar regras de permissão, negação e solicitação de forma declarativa em `.claude/settings.json`. Essas regras são lidas quando a fonte de configuração `project` está habilitada, o que é o padrão para opções `query()`. Se você definir `setting_sources` (TypeScript: `settingSources`) explicitamente, inclua `"project"` para que se apliquem. Veja [Configurações de permissão](/docs/pt/settings-reference#permission-settings) para a sintaxe das regras.

113 113

114<h2 id="permission-modes">114<h2 id="permission-modes">

115 Modos de permissão115 Modos de permissão

124O SDK suporta estes modos de permissão:124O SDK suporta estes modos de permissão:

125 125

127| :------------------ | :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |127| :------------------ | :----------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

128| `default` | Comportamento de permissão padrão | Sem auto-aprovações baseadas em modo; chamadas que precisam de aprovação e não correspondem a nenhuma regra de permissão acionam seu callback `canUseTool` |128| `default` | Comportamento de permissão padrão | Sem aprovações automáticas baseadas em modo; chamadas que precisam de aprovação e não correspondem a nenhuma regra de permissão acionam seu callback `canUseTool` |

129| `dontAsk` | Negar em vez de solicitar | Qualquer chamada que de outra forma solicitaria é negada. Chamadas aprovadas por `allowed_tools` ou regras são executadas, assim como chamadas que não precisam de aprovação no modo `default`, como leituras de arquivo dentro de seus diretórios de trabalho e chamadas para `Agent`; ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e ferramentas que requerem interação do usuário são negadas mesmo se você as pré-aprovou, assim como remoções de `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths). `canUseTool` nunca é chamado |129| `dontAsk` | Negar em vez de solicitar | Qualquer chamada que de outra forma solicitaria é negada. Chamadas aprovadas por `allowed_tools` ou regras são executadas, assim como chamadas que não precisam de aprovação no modo `default`, como leituras de arquivo dentro de seus diretórios de trabalho e chamadas para `Agent`. Ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e ferramentas que exigem interação do usuário são negadas mesmo que você as tenha pré-aprovado, assim como remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths). `canUseTool` nunca é chamado |

130| `acceptEdits` | Auto-aceitar edições de arquivo | Edições de arquivo e [operações de sistema de arquivos](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv`, etc.) são automaticamente aprovadas |130| `acceptEdits` | Aceitar automaticamente edições de arquivo | Edições de arquivo e [operações do sistema de arquivos](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv`, etc.) são automaticamente aprovadas |

131| `bypassPermissions` | Ignorar verificações de permissão | As ferramentas são executadas sem solicitações de permissão, exceto pelas [ações que nenhum modo auto-aprova](/docs/pt/permission-modes#actions-no-mode-auto-approves). Use com cuidado |131| `bypassPermissions` | Contornar verificações de permissão | As ferramentas são executadas sem prompts de permissão, exceto pelas [ações que nenhum modo aprova automaticamente](/docs/pt/permission-modes#actions-no-mode-auto-approves). Use com cuidado |

132| `plan` | Modo de planejamento | Claude explora e planeja sem editar seus arquivos de origem; edições de arquivo nunca são auto-aprovadas e solicitam através de seu callback `canUseTool` |132| `plan` | Modo de planejamento | Claude explora e planeja sem editar seus arquivos de origem; edições de arquivo nunca são aprovadas automaticamente e solicitam através de seu callback `canUseTool` |

133| `auto` | Aprovações classificadas por modelo | Um classificador de modelo aprova ou nega solicitações de permissão. Consulte [Auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) para disponibilidade |133| `auto` | Aprovações classificadas pelo modelo | Um classificador de modelo aprova ou nega prompts de permissão. Consulte [Modo Auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) para disponibilidade |

134 134

135<Warning>135<Warning>

136 **Herança de subagentos:** Um subagentos é executado no modo de permissão da sessão pai, a menos que você defina `permissionMode` em sua [`AgentDefinition`](/docs/pt/agent-sdk/typescript#agentdefinition) e a sessão pai esteja em modo `default`, `dontAsk` ou `plan`. Mesmo assim, Claude Code nunca aplica um valor `"bypassPermissions"`. Um subagentos é executado em modo `bypassPermissions` apenas quando a sessão pai também está. A exceção `bypassPermissions` requer Claude Code v2.1.267 ou posterior.136 **Herança de subagente:** Um subagente é executado no modo de permissão da sessão pai, a menos que você defina `permissionMode` em sua [`AgentDefinition`](/docs/pt/agent-sdk/typescript#agentdefinition) e a sessão pai esteja em modo `default`, `dontAsk` ou `plan`. Mesmo assim, Claude Code nunca aplica um valor `"bypassPermissions"`. Um subagente é executado em modo `bypassPermissions` apenas quando a sessão pai também está. A exceção `bypassPermissions` requer Claude Code v2.1.267 ou posterior.

137 137

138 Subagentos podem ter prompts de sistema diferentes e comportamento menos restrito do que seu agente principal, portanto herdar `bypassPermissions` concede a eles acesso completo e autônomo ao sistema. As [ações que nenhum modo auto-aprova](/docs/pt/permission-modes#actions-no-mode-auto-approves) ainda se aplicam.138 Subagentes podem ter prompts de sistema diferentes e comportamento menos restrito do que seu agente principal, portanto herdar `bypassPermissions` concede a eles acesso completo e autônomo ao sistema. As [ações que nenhum modo aprova automaticamente](/docs/pt/permission-modes#actions-no-mode-auto-approves) ainda se aplicam.

139</Warning>139</Warning>

140 140

141<h3 id="set-permission-mode">141<h3 id="set-permission-mode">

190 </Tab>190 </Tab>

191 191

192 <Tab title="Durante streaming">192 <Tab title="Durante streaming">

193 Chame `set_permission_mode()` (Python) ou `setPermissionMode()` (TypeScript) para alterar o modo no meio da sessão. O novo modo entra em vigor imediatamente para todas as solicitações de ferramentas subsequentes. Isso permite que você comece restritivo e afrouxe as permissões conforme a confiança aumenta, por exemplo, alternando para `acceptEdits` após revisar a abordagem inicial de Claude.193 Chame `set_permission_mode()` (Python) ou `setPermissionMode()` (TypeScript) para alterar o modo durante a sessão. O novo modo entra em vigor imediatamente para todas as solicitações de ferramenta subsequentes. Isso permite que você comece restritivo e afrouxe as permissões conforme a confiança aumenta, por exemplo, alternando para `acceptEdits` após revisar a abordagem inicial de Claude.

194 194

195 <CodeGroup>195 <CodeGroup>

196 ```python Python theme={null}196 ```python Python theme={null}

254 Modo aceitar edições (`acceptEdits`)254 Modo aceitar edições (`acceptEdits`)

255</h4>255</h4>

256 256

257Auto-aprova operações de arquivo para que Claude possa editar código sem solicitar. Outras ferramentas (como comandos Bash que não são operações de sistema de arquivos) ainda requerem permissões normais.257Aprova automaticamente operações de arquivo para que Claude possa editar código sem solicitar. Outras ferramentas (como comandos Bash que não são operações do sistema de arquivos) ainda exigem permissões normais.

258 258

259**Operações auto-aprovadas:**259**Operações aprovadas automaticamente:**

260 260

261* Edições de arquivo (ferramentas Edit, Write)261* Edições de arquivo (ferramentas Edit, Write)

262* Comandos de sistema de arquivos: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp`, `sed`262* Comandos do sistema de arquivos: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp`, `sed`

263 263

264Ambos se aplicam apenas a caminhos dentro do diretório de trabalho ou `additionalDirectories`. No modo `acceptEdits`, Claude Code não auto-aprova a solicitação quando Claude:264Ambos se aplicam apenas a caminhos dentro do diretório de trabalho ou `additionalDirectories`. No modo `acceptEdits`, Claude Code não aprova automaticamente a solicitação quando Claude:

265 265

266* Trabalha em um caminho fora desse escopo266* Trabalha em um caminho fora desse escopo

267* Escreve em um caminho protegido267* Escreve em um caminho protegido

268* Remove um [caminho crítico](/docs/pt/permission-modes#critical-paths) com `rm` ou `rmdir`268* Remove um [caminho crítico](/docs/pt/permission-modes#critical-paths) com `rm` ou `rmdir`

269 269

270**Use quando:** você confia nas edições de Claude e quer iteração mais rápida, como durante prototipagem ou ao trabalhar em um diretório isolado.270**Use quando:** você confia nas edições de Claude e deseja iteração mais rápida, como durante prototipagem ou ao trabalhar em um diretório isolado.

271 271

272<h4 id="don’t-ask-mode-dontask">272<h4 id="don’t-ask-mode-dontask">

273 Modo não perguntar (`dontAsk`)273 Modo não perguntar (`dontAsk`)

274</h4>274</h4>

275 275

276Converte qualquer solicitação de permissão em uma negação, sem chamar `canUseTool`. Ferramentas pré-aprovadas por `allowed_tools`, regras de permissão em `settings.json` ou um hook são executadas normalmente, assim como chamadas que não precisam de aprovação no modo `default`, como leituras de arquivo dentro de seus diretórios de trabalho e chamadas para `Agent`. Ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), ferramentas que requerem interação do usuário e remoções de `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) são negadas mesmo quando uma regra de permissão corresponde. Um allow de hook `PreToolUse` não limpa uma remoção de caminho crítico.276Converte qualquer prompt de permissão em uma negação, sem chamar `canUseTool`. Ferramentas pré-aprovadas por `allowed_tools`, regras de permissão em `settings.json` ou um hook são executadas normalmente, assim como chamadas que não precisam de aprovação no modo `default`, como leituras de arquivo dentro de seus diretórios de trabalho e chamadas para `Agent`. Ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), ferramentas que exigem interação do usuário e remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) são negadas mesmo quando uma regra de permissão corresponde. Uma permissão de hook `PreToolUse` também não limpa uma remoção de caminho crítico.

277 277

278**Use quando:** você quer uma superfície de ferramenta fixa e explícita para um agente sem cabeça e prefere uma negação dura sobre confiança silenciosa em `canUseTool` estar ausente.278**Use quando:** você deseja uma superfície de ferramenta fixa e explícita para um agente sem interface e prefere uma negação definitiva em vez de depender silenciosamente de `canUseTool` estar ausente.

279 279

280<h4 id="bypass-permissions-mode-bypasspermissions">280<h4 id="bypass-permissions-mode-bypasspermissions">

281 Modo ignorar permissões (`bypassPermissions`)281 Modo contornar permissões (`bypassPermissions`)

282</h4>282</h4>

283 283

284Auto-aprova usos de ferramentas sem solicitar, exceto os casos listados no aviso abaixo. Hooks ainda são executados e podem bloquear operações se necessário.284Aprova automaticamente usos de ferramentas sem solicitar, exceto os casos listados no aviso abaixo. Hooks ainda são executados e podem bloquear operações se necessário.

285 285

286<Warning>286<Warning>

287 Use com extrema cautela. Claude tem acesso completo ao sistema neste modo. Use apenas em ambientes controlados onde você confia em todas as operações possíveis.287 Use com extrema cautela. Claude tem acesso completo ao sistema neste modo. Use apenas em ambientes controlados onde você confia em todas as operações possíveis.

288 288

289 `allowed_tools` não restringe este modo. Todas as ferramentas são aprovadas, não apenas as que você listou. Estes controles ainda se aplicam:289 `allowed_tools` não restringe este modo. Cada ferramenta é aprovada, não apenas as que você listou. Estes controles ainda se aplicam:

290 290

291 * Regras de negação, regras explícitas de `ask` e hooks são avaliados antes da verificação do modo e ainda podem bloquear uma ferramenta.291 * Regras de negação, regras explícitas `ask` e hooks são avaliados antes da verificação de modo e ainda podem bloquear uma ferramenta.

292 * Ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), ferramentas que requerem interação do usuário e remoções de `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda caem através de seu callback `canUseTool`.292 * Ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), ferramentas que exigem interação do usuário e remoções `rm` e `rmdir` direcionadas a um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda caem para seu callback `canUseTool`.

293 * As [proteções de mensagens entre sessões](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) ainda se aplicam.293 * Os [salvaguardas de mensagens entre sessões](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) ainda se aplicam.

294</Warning>294</Warning>

295 295

296<h4 id="plan-mode-plan">296<h4 id="plan-mode-plan">

297 Modo plano (`plan`)297 Modo plano (`plan`)

298</h4>298</h4>

299 299

300Claude explora a base de código e produz um plano sem editar seus arquivos de origem. Ferramentas somente leitura são executadas como no modo de permissão `default`.300Claude explora a base de código e produz um plano sem editar seus arquivos de origem. Ferramentas somente leitura são executadas como fazem no modo de permissão `default`.

301 301

302Edições de arquivo nunca são auto-aprovadas no modo plano, mesmo quando uma regra de permissão corresponde. Elas solicitam através de seu callback `canUseTool` em vez disso. No Claude Code v2.1.212 ou posterior, comandos shell que modificam arquivos, como `touch` e `rm`, chegam ao seu callback `canUseTool` da mesma forma.302Edições de arquivo nunca são aprovadas automaticamente no modo plano, mesmo quando uma regra de permissão corresponde. Em vez disso, elas solicitam através de seu callback `canUseTool`. No Claude Code v2.1.212 ou posterior, comandos shell que modificam arquivos, como `touch` e `rm`, chegam ao seu callback `canUseTool` da mesma forma.

303 303

304Claude pode usar `AskUserQuestion` para esclarecer requisitos antes de finalizar o plano. Consulte [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input#handle-clarifying-questions) para lidar com essas solicitações.304Claude pode usar `AskUserQuestion` para esclarecer requisitos antes de finalizar o plano. Consulte [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input#handle-clarifying-questions) para lidar com esses prompts.

305 305

306**Use quando:** você quer que Claude proponha mudanças sem executá-las, como durante revisão de código ou quando você precisa aprovar mudanças antes que sejam feitas.306**Use quando:** você deseja que Claude proponha alterações sem executá-las, como durante revisão de código ou quando você precisa aprovar alterações antes que sejam feitas.

307 307

308<h2 id="related-resources">308<h2 id="related-resources">

309 Recursos relacionados309 Recursos relacionados

310</h2>310</h2>

311 311

312Para os outros passos no fluxo de avaliação de permissões:312Para as outras etapas no fluxo de avaliação de permissões:

313 313

314* [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input): solicitações de aprovação interativa e perguntas de esclarecimento314* [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input): prompts de aprovação interativa e perguntas de esclarecimento

315* [Guia de hooks](/docs/pt/agent-sdk/hooks): execute código personalizado em pontos-chave do ciclo de vida do agente315* [Guia de hooks](/docs/pt/agent-sdk/hooks): executar código personalizado em pontos-chave do ciclo de vida do agente

316* [Regras de permissão](/docs/pt/settings-reference#permission-settings): regras declarativas de permitir/negar em `settings.json`316* [Regras de permissão](/docs/pt/settings-reference#permission-settings): regras declarativas de permissão/negação em `settings.json`

agent-sdk/plugins.md +1 −1

Details

69 69

70Os caminhos de plugin podem ser:70Os caminhos de plugin podem ser:

71 71

~~72* **Caminhos relativos**: resolvidos relativamente ao seu diretório de trabalho atual (por exemplo, `"./plugins/my-plugin"`)~~72* **Caminhos relativos**: resolvidos relativamente à opção `cwd` (por exemplo, `"./plugins/my-plugin"`)

73* **Caminhos absolutos**: caminhos completos do sistema de arquivos (por exemplo, `"/home/user/plugins/my-plugin"`)73* **Caminhos absolutos**: caminhos completos do sistema de arquivos (por exemplo, `"/home/user/plugins/my-plugin"`)

74 74

75<Note>75<Note>

agent-sdk/python.md +11 −4

Details

513 async def receive_messages(self) -> AsyncIterator[Message]513 async def receive_messages(self) -> AsyncIterator[Message]

514 async def receive_response(self) -> AsyncIterator[Message]514 async def receive_response(self) -> AsyncIterator[Message]

515 async def interrupt(self) -> None515 async def interrupt(self) -> None

516 async def set_permission_mode(self, mode: str) -> None516 async def set_permission_mode(self, mode: PermissionMode) -> None

517 async def set_model(self, model: str | None = None) -> None517 async def set_model(self, model: str | None = None) -> None

518 async def rewind_files(self, user_message_id: str) -> None518 async def rewind_files(self, user_message_id: str) -> None

519 async def get_mcp_status(self) -> McpStatusResponse519 async def get_mcp_status(self) -> McpStatusResponse

544| `toggle_mcp_server(server_name, enabled)` | Ativa ou desativa um servidor MCP no meio da sessão. Desativar remove suas ferramentas |544| `toggle_mcp_server(server_name, enabled)` | Ativa ou desativa um servidor MCP no meio da sessão. Desativar remove suas ferramentas |

545| `stop_task(task_id)` | Para uma tarefa de fundo em execução. Uma [`TaskNotificationMessage`](#tasknotificationmessage) com status `"stopped"` segue no fluxo de mensagens |545| `stop_task(task_id)` | Para uma tarefa de fundo em execução. Uma [`TaskNotificationMessage`](#tasknotificationmessage) com status `"stopped"` segue no fluxo de mensagens |

548 548

549<h4 id="context-manager-support">549<h4 id="context-manager-support">

2006Tipo de união de todos os blocos de conteúdo.2006Tipo de união de todos os blocos de conteúdo.

2007 2007

2008```python theme={null}2008```python theme={null}

2009ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock2009ContentBlock = (

2010 TextBlock

2011 | ThinkingBlock

2012 | ToolUseBlock

2013 | ToolResultBlock

2014 | ServerToolUseBlock

2015 | ServerToolResultBlock

2016)

2010```2017```

2011 2018

2012<h3 id="textblock">2019<h3 id="textblock">

3679| `allowManagedDomainsOnly` | `bool` | `False` | Apenas configurações gerenciadas: quando definido em configurações gerenciadas, ignore `allowedDomains` e `WebFetch(domain:...)` regras de permissão de fontes de configurações não gerenciadas. Não tem efeito quando definido via opções SDK |3686| `allowManagedDomainsOnly` | `bool` | `False` | Apenas configurações gerenciadas: quando definido em configurações gerenciadas, ignore `allowedDomains` e `WebFetch(domain:...)` regras de permissão de fontes de configurações não gerenciadas. Não tem efeito quando definido via opções SDK |

agent-sdk/skills.md +3 −3

Details

103 Confirme skills carregadas103 Confirme skills carregadas

104</h3>104</h3>

105 105

106Perto do início do stream, o SDK produz uma mensagem de sistema com subtipo `init`. Verifique seu array `skills` para confirmar que suas skills foram carregadas antes de Claude começar a trabalhar. O array inclui as skills invocáveis pelo usuário que você definiu, junto com [skills agrupadas incluídas com Claude Code](/docs/pt/skills#bundled-skills).106Perto do início do stream, o SDK produz uma mensagem de sistema com subtipo `init`. Verifique seu array `skills` para confirmar que suas skills foram carregadas antes de Claude começar a trabalhar. O array inclui as skills invocáveis pelo usuário que você definiu com um campo frontmatter `description` ou `when_to_use`, junto com [skills agrupadas incluídas com Claude Code](/docs/pt/skills#bundled-skills).

107 107

108O array lista apenas skills invocáveis pelo usuário. Uma skill com [`user-invocable: false`](/docs/pt/skills#control-who-invokes-a-skill) em seu frontmatter carrega e permanece disponível para Claude, mas não aparece no array. O array reflete o que a sessão descobriu e lista as mesmas skills independentemente de estarem ou não em sua lista `skills`.108O array lista apenas skills invocáveis pelo usuário. Uma skill com [`user-invocable: false`](/docs/pt/skills#control-who-invokes-a-skill) em seu frontmatter carrega e permanece disponível para Claude, mas não aparece no array. O array lista as mesmas skills independentemente de estarem ou não em sua lista `skills`.

109 109

110<h3 id="allow-only-specific-skills">110<h3 id="allow-only-specific-skills">

111 Permita apenas skills específicas111 Permita apenas skills específicas

173Available commands: ["clear", "compact", "context", "usage", "code-review", "verify", "security-check", ...]173Available commands: ["clear", "compact", "context", "usage", "code-review", "verify", "security-check", ...]

174```174```

175 175

176Suas skills invocáveis pelo usuário aparecem tanto nesta lista quanto no array `skills` de [Confirme skills carregadas](#confirm-skills-loaded). A lista `slash_commands` adiciona o resto dos comandos disponíveis em sua sessão. Uma skill com [`user-invocable: false`](/docs/pt/skills#control-who-invokes-a-skill) em seu frontmatter não aparece em nenhuma das duas. Sessões que configuram [servidores MCP](/docs/pt/agent-sdk/mcp) também podem expor [prompts MCP como comandos](/docs/pt/mcp#use-mcp-prompts-as-commands).176Uma skill com [`user-invocable: false`](/docs/pt/skills#control-who-invokes-a-skill) em seu frontmatter não aparece nesta lista ou no array `skills` de [Confirme skills carregadas](#confirm-skills-loaded). Sessões que configuram [servidores MCP](/docs/pt/agent-sdk/mcp) também podem expor [prompts MCP como comandos](/docs/pt/mcp#use-mcp-prompts-as-commands).

177 177

178<h3 id="dispatch-commands-by-name">178<h3 id="dispatch-commands-by-name">

179 Despache comandos por nome179 Despache comandos por nome

agent-sdk/streaming-output.md +3 −26

Details

79 79

80Quando mensagens parciais estão ativadas, você recebe eventos brutos de streaming da Claude API encapsulados em um objeto. O tipo tem nomes diferentes em cada SDK:80Quando mensagens parciais estão ativadas, você recebe eventos brutos de streaming da Claude API encapsulados em um objeto. O tipo tem nomes diferentes em cada SDK:

81 81

~~82* **Python**: `StreamEvent` (importar de `claude_agent_sdk.types`)~~82* **Python**: [`StreamEvent`](/docs/pt/agent-sdk/python#streamevent) (importar de `claude_agent_sdk.types`)

~~83* **TypeScript**: `SDKPartialAssistantMessage` com `type: 'stream_event'`~~83* **TypeScript**: [`SDKPartialAssistantMessage`](/docs/pt/agent-sdk/typescript#sdkpartialassistantmessage) com `type: 'stream_event'`

84 84

~~85Ambos contêm eventos brutos da Claude API, não texto acumulado. Você precisa extrair e acumular deltas de texto você mesmo. Aqui está a estrutura de cada tipo:~~85Ambos contêm eventos brutos da Claude API, não texto acumulado. Você precisa extrair e acumular deltas de texto você mesmo.

~~87<CodeGroup>~~

~~88 ```python Python theme={null}~~

~~89 @dataclass~~

~~90 class StreamEvent:~~

~~91 uuid: str # Unique identifier for this event~~

~~92 session_id: str # Session identifier~~

~~93 event: dict[str, Any] # The raw Claude API stream event~~

~~94 parent_tool_use_id: str | None # Always None~~

~~95 ```~~

~~97 ```typescript TypeScript theme={null}~~

~~98 type SDKPartialAssistantMessage = {~~

~~99 type: "stream_event";~~

100 event: BetaRawMessageStreamEvent; // From Anthropic SDK

101 parent_tool_use_id: string | null;

102 uuid: UUID;

103 session_id: string;

104 ttft_ms?: number; // Time to first token in ms, present only on message_start events

105 user_message_uuid?: string;

106 };

107 ```

108</CodeGroup>

109 86

110O campo `parent_tool_use_id` é sempre `None` em Python e `null` em TypeScript. Eventos de stream são emitidos apenas para a sessão principal; deltas no nível de token de subagentos não são encaminhados. Para atribuir saída a um subagentos, use mensagens completas, que carregam `parent_tool_use_id`. Veja [Detectar invocação de subagentos](/docs/pt/agent-sdk/subagents#detect-subagent-invocation).87O campo `parent_tool_use_id` é sempre `None` em Python e `null` em TypeScript. Eventos de stream são emitidos apenas para a sessão principal; deltas no nível de token de subagentos não são encaminhados. Para atribuir saída a um subagentos, use mensagens completas, que carregam `parent_tool_use_id`. Veja [Detectar invocação de subagentos](/docs/pt/agent-sdk/subagents#detect-subagent-invocation).

111 88

agent-sdk/typescript.md +2 −2

Details

498| `disallowedTools` | `string[]` | `[]` | Ferramentas para negar. Um nome simples como `"Bash"` remove a ferramenta do contexto do Claude. Uma regra com escopo como `"Bash(rm *)"` deixa a ferramenta disponível e nega chamadas correspondentes em todos os modos de permissão, incluindo `bypassPermissions`, para o comando [conforme escrito](/docs/pt/permissions#bash-rule-limits). Veja [Permissões](/docs/pt/agent-sdk/permissions#allow-and-deny-rules) |498| `disallowedTools` | `string[]` | `[]` | Ferramentas para negar. Um nome simples como `"Bash"` remove a ferramenta do contexto do Claude. Uma regra com escopo como `"Bash(rm *)"` deixa a ferramenta disponível e nega chamadas correspondentes em todos os modos de permissão, incluindo `bypassPermissions`, para o comando [conforme escrito](/docs/pt/permissions#bash-rule-limits). Veja [Permissões](/docs/pt/agent-sdk/permissions#allow-and-deny-rules) |

501| `env` | `Record<string, string \| undefined>` | `process.env` | Variáveis de ambiente. Quando definido, isso substitui o ambiente do subprocesso em vez de mesclar com `process.env`, então passe `{ ...process.env, YOUR_VAR: 'value' }` para manter variáveis herdadas como `PATH`. Veja [Lidar com respostas de API lentas ou travadas](#handle-slow-or-stalled-api-responses) para um exemplo deste padrão, e [Variáveis de ambiente](/docs/pt/env-vars) para variáveis que a CLI subjacente lê. Defina `CLAUDE_AGENT_SDK_CLIENT_APP` para identificar sua aplicação no cabeçalho User-Agent |501| `env` | `Record<string, string \| undefined>` | `process.env` | Variáveis de ambiente. Quando definido, isso substitui o ambiente do subprocesso em vez de mesclar com `process.env`, então passe `{ ...process.env, YOUR_VAR: 'value' }` para manter variáveis herdadas como `PATH`. Veja [Lidar com respostas de API lentas ou travadas](#handle-slow-or-stalled-api-responses) para um exemplo deste padrão, e [Variáveis de ambiente](/docs/pt/env-vars) para variáveis que a CLI subjacente lê. Defina `CLAUDE_AGENT_SDK_CLIENT_APP` para identificar sua aplicação no cabeçalho User-Agent |

5559 `SDKLocalCommandOutputMessage`5559 `SDKLocalCommandOutputMessage`

5560</h3>5560</h3>

5561 5561

5562Saída de um comando local como `/voice` ou `/usage`. Exibido como texto estilo assistente na transcrição.5562Claude Code não emite este tipo de mensagem. Quando você envia um comando como `/context` ou `/usage` como um prompt, sua saída chega como um [`SDKAssistantMessage`](#sdkassistantmessage).

5563 5563

5564```typescript theme={null}5564```typescript theme={null}

5565type SDKLocalCommandOutputMessage = {5565type SDKLocalCommandOutputMessage = {

agent-sdk/user-input.md +1 −5

Details

12 12

13Para perguntas de esclarecimento, Claude gera as perguntas e opções. Seu papel é apresentá-las aos usuários e retornar suas seleções. Você não pode adicionar suas próprias perguntas a este fluxo; se precisar perguntar algo aos usuários, faça isso separadamente na lógica do seu aplicativo.13Para perguntas de esclarecimento, Claude gera as perguntas e opções. Seu papel é apresentá-las aos usuários e retornar suas seleções. Você não pode adicionar suas próprias perguntas a este fluxo; se precisar perguntar algo aos usuários, faça isso separadamente na lógica do seu aplicativo.

14 14

15O callback pode permanecer pendente indefinidamente. A execução permanece pausada até que seu callback retorne, e o SDK apenas cancela a espera quando a própria consulta é cancelada. Se um usuário puder levar mais tempo para responder do que seu processo pode razoavelmente permanecer em execução, registre um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks) que retorna a [decisão `defer`](/docs/pt/hooks#defer-a-tool-call-for-later) em vez de aguardar no callback, para que o processo possa sair e retomar mais tarde a partir da sessão persistida.15O callback pode permanecer pendente indefinidamente. A execução permanece pausada até que seu callback retorne. Se um usuário puder levar mais tempo para responder do que seu processo pode razoavelmente permanecer em execução, registre um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks) que retorna a [decisão `defer`](/docs/pt/hooks#defer-a-tool-call-for-later) em vez de aguardar no callback, para que o processo possa sair e retomar mais tarde a partir da sessão persistida.

16 16

17Este guia mostra como detectar cada tipo de solicitação e responder apropriadamente.17Este guia mostra como detectar cada tipo de solicitação e responder apropriadamente.

18 18

204 ```204 ```

205</CodeGroup>205</CodeGroup>

206 206

207<Note>

208 Em Python, `can_use_tool` requer [modo de streaming](/docs/pt/agent-sdk/streaming-vs-single-mode). Quando você passa um fluxo de mensagens finito através de `query(prompt=generator)` ou `ClaudeSDKClient.connect(prompt=async_iterable)`, o SDK fecha o fluxo de entrada após a última mensagem, antes que o callback de permissão possa ser invocado, a menos que um hook registrado ou servidor MCP em processo o mantenha aberto. O exemplo acima o mantém aberto com um hook `PreToolUse` que retorna `{"continue_": True}`. Conectar sem prompt e enviar mensagens através de `ClaudeSDKClient.query()` mantém o fluxo aberto por si só e não precisa de hook.

209</Note>

~~210~~

211Este exemplo usa um fluxo s/n onde qualquer entrada diferente de `s` é tratada como uma negação. Na prática, você pode construir uma interface de usuário mais rica que permite aos usuários modificar a solicitação, fornecer feedback ou redirecionar Claude completamente. Veja [Responder a solicitações de ferramentas](#respond-to-tool-requests) para todas as maneiras que você pode responder.207Este exemplo usa um fluxo s/n onde qualquer entrada diferente de `s` é tratada como uma negação. Na prática, você pode construir uma interface de usuário mais rica que permite aos usuários modificar a solicitação, fornecer feedback ou redirecionar Claude completamente. Veja [Responder a solicitações de ferramentas](#respond-to-tool-requests) para todas as maneiras que você pode responder.

212 208

213<h3 id="respond-to-tool-requests">209<h3 id="respond-to-tool-requests">

agent-view.md +450 −170

Details

19Para comparar agent view com subagentes, equipes de agentes e worktrees, consulte [Executar agentes em paralelo](/docs/pt/agents).19Para comparar agent view com subagentes, equipes de agentes e worktrees, consulte [Executar agentes em paralelo](/docs/pt/agents).

20 20

21<Note>21<Note>

22 Agent view está em visualização de pesquisa e requer Claude Code v2.1.139 ou posterior. Verifique sua versão com `claude --version`. A interface e os atalhos de teclado podem mudar conforme o recurso evolui.22 Agent view está em visualização de pesquisa. A interface e os atalhos de teclado podem mudar conforme o recurso evolui.

23</Note>23</Note>

24 24

~~25Esta página cobre:~~

~~27* [Início rápido](#quick-start): dê a Claude uma tarefa para trabalhar em background, verifique-a e intervenha quando necessário~~

~~28* [Monitorar sessões com agent view](#monitor-sessions-with-agent-view), incluindo ícones de estado, espiada e resposta, anexação, organização e atalhos de teclado~~

~~29* [Despache novos agentes](#dispatch-new-agents) a partir de agent view, de dentro de uma sessão ou do seu shell~~

~~30* [Gerenciar sessões do shell](#manage-sessions-from-the-shell) com `claude agents`, `claude attach` e comandos relacionados~~

~~31* [Como as sessões em background são hospedadas](#how-background-sessions-are-hosted) pelo processo supervisor~~

33<h2 id="quick-start">25<h2 id="quick-start">

34 Início rápido26 Início rápido

35</h2>27</h2>

44 claude agents36 claude agents

45 ```37 ```

46 38

47 A visualização do agente abre com uma entrada na parte inferior e uma tabela que se preenche conforme as sessões começam. Pressione `Esc` a qualquer momento para retornar ao seu shell. Suas sessões continuam em execução enquanto você está ausente e reaparecem na próxima vez que você abrir a visualização do agente.39 Se você ainda não aceitou o [diálogo de confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) para o diretório, Claude Code o mostra antes da visualização do agente abrir, o mesmo diálogo que `claude` mostra. Aceite para salvar a confiança do workspace e continuar. Se você recusar, Claude Code sairá sem abrir a visualização do agente.

41 A visualização do agente abre com uma entrada na parte inferior e uma tabela que se preenche conforme as sessões começam. Pressione `Esc` para retornar ao seu shell; se você abriu a visualização do agente colocando uma sessão em background com `←`, `Esc` retorna para essa conversa em vez disso. Suas sessões continuam em execução enquanto você está ausente e reaparecem na próxima vez que você abrir a visualização do agente.

48 </Step>42 </Step>

49 43

50 <Step title="Despache uma sessão">44 <Step title="Despache uma sessão">

51 Digite um prompt descrevendo uma tarefa e pressione `Enter`. Uma nova sessão em background é iniciada nessa tarefa e aparece como uma linha mostrando se está funcionando, aguardando você ou concluída. A nova sessão usa o modelo mostrado no cabeçalho da visualização do agente e o mesmo [modo de permissão](#permission-mode-model-and-effort) que você obteria executando `claude` naquele diretório.45 Digite um prompt descrevendo uma tarefa e pressione `Enter`. Uma nova sessão em background é iniciada nessa tarefa e aparece como uma linha mostrando se está funcionando, aguardando você ou concluída. A nova sessão usa o modelo mostrado no cabeçalho da visualização do agente. [Qual modo de permissão ela inicia](#permission-mode-model-and-effort) depende de como você abriu a visualização do agente.

52 46

53 Cada prompt que você digita aqui inicia sua própria sessão nova. Digitar outro prompt e pressionar `Enter` inicia uma segunda sessão ao lado da primeira em vez de enviar um acompanhamento para ela. Você pode executar várias em paralelo desta forma.47 Cada prompt que você digita aqui inicia sua própria sessão nova. Digitar outro prompt e pressionar `Enter` inicia uma segunda sessão ao lado da primeira em vez de enviar um acompanhamento para ela. Você pode executar várias em paralelo desta forma.

54 48

64 </Step>58 </Step>

65 59

66 <Step title="Trazer uma sessão existente">60 <Step title="Trazer uma sessão existente">

67 Esta etapa precisa de uma sessão em execução. Se você seguiu as etapas anteriores, você não tem uma aberta neste terminal, portanto abra uma sessão regular `claude` em outro terminal e envie uma mensagem para ela primeiro. Para mover uma sessão que você já tem aberta para a visualização do agente, execute `/bg` dentro dela, ou pressione `←` em um prompt vazio para colocá-la em background e abrir a visualização do agente em uma etapa. A sessão continua em execução e aparece como uma linha ao lado das que você despachou.61 Esta etapa precisa de uma sessão em execução. Se você seguiu as etapas anteriores, você não tem uma aberta neste terminal, portanto abra uma sessão regular `claude` em outro terminal e envie uma mensagem para ela primeiro.

63 Para mover uma sessão que você já tem aberta para a visualização do agente, execute `/bg` dentro dela, ou pressione `←` em um prompt vazio para colocá-la em background e abrir a visualização do agente em uma etapa. Em uma sessão nova sem mensagens ainda, `/bg` pede que você envie uma mensagem primeiro, enquanto `←` funciona imediatamente. A sessão continua em execução e aparece como uma linha ao lado das que você despachou.

68 </Step>64 </Step>

69</Steps>65</Steps>

70 66

71Você pode usar `claude agents` como seu ponto de entrada principal em vez de `claude`: despache cada tarefa da visualização do agente, anexe quando quiser a conversa completa e pressione `←` para retornar à tabela.67Você pode usar `claude agents` como seu ponto de entrada principal em vez de `claude`: despache cada tarefa da visualização do agente, anexe quando quiser a conversa completa e pressione `←` para retornar à tabela.

72 68

73Dentro de uma sessão regular `claude`, a dica `←` do rodapé do prompt conta os agentes em background que estão aguardando você, como `← 2 agents`, e retorna para `← for agents` quando nenhum precisa de entrada. Contagens acima de 99 aparecem como `99+`. A contagem é atualizada aproximadamente a cada dez segundos enquanto o terminal está em foco e imediatamente quando o foco retorna. Ela muda brevemente de cor quando se move e quando um agente é concluído, a menos que a configuração [`prefersReducedMotion`](/docs/pt/settings#available-settings) esteja ativada, e fica oculta no [modo leitor de tela](/docs/pt/accessibility). No [Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry](/docs/pt/third-party-integrations), a dica permanece em sua forma simples `← for agents` sem a contagem. Requer Claude Code v2.1.205 ou posterior.69Dentro de uma sessão regular `claude`, a dica `←` do rodapé do prompt conta os agentes em background que estão aguardando você, como `← 2 agents`, e retorna para `← for agents` quando nenhum precisa de entrada. Contagens acima de 99 aparecem como `99+`. A contagem é atualizada aproximadamente a cada dez segundos enquanto o terminal está em foco e imediatamente quando o foco retorna. Ela muda brevemente de cor quando se move e quando um agente é concluído, e quando uma sessão em background é concluída enquanto nenhuma precisa de sua entrada, ela brevemente mostra o número concluído, como `← 2 done`. Ambos os flashes estão desativados quando a configuração [`prefersReducedMotion`](/docs/pt/settings-reference#prefersreducedmotion) está ativada, e a dica fica oculta no [modo leitor de tela](/docs/pt/accessibility).

74 70

75<h2 id="monitor-sessions-with-agent-view">71<h2 id="monitor-sessions-with-agent-view">

76 Monitorar sessões com agent view72 Monitorar sessões com agent view

78 74

79Execute `claude agents` para abrir agent view. Ele assume o terminal completo e lista cada sessão agrupada por estado, com sessões fixadas e as que precisam de você no topo. Cada linha mostra o nome da sessão, atividade atual e sua idade, contada a partir de quando a sessão foi criada; a idade de uma sessão concluída congela em quanto tempo a execução levou.75Execute `claude agents` para abrir agent view. Ele assume o terminal completo e lista cada sessão agrupada por estado, com sessões fixadas e as que precisam de você no topo. Cada linha mostra o nome da sessão, atividade atual e sua idade, contada a partir de quando a sessão foi criada; a idade de uma sessão concluída congela em quanto tempo a execução levou.

80 76

81O nome é tingido com a cor definida por [`/color`](/docs/pt/commands) naquela sessão. A partir da v2.1.199, a cor é mantida quando você [coloca uma sessão em background](#from-inside-a-session) com `←` ou `/background`.77O nome é tingido com a cor definida por [`/color`](/docs/pt/commands) naquela sessão, incluindo quando você [coloca uma sessão em background](#from-inside-a-session) com `←` ou `/background`.

82 78

83Por padrão, a lista mostra cada sessão em background que você iniciou, em todos os seus projetos. Uma sessão funcionando em um repositório e outra em um worktree diferente aparecem aqui, independentemente de qual diretório você abriu agent view. Para limitar a lista a um projeto, passe `--cwd`:79Por padrão, a lista mostra cada sessão em background que você iniciou, em todos os seus projetos. Uma sessão funcionando em um repositório e outra em um worktree diferente aparecem aqui, independentemente de qual diretório você abriu agent view. Para limitar a lista a um projeto, passe `--cwd`:

84 80

86claude agents --cwd ~/projects/my-app82claude agents --cwd ~/projects/my-app

87```83```

88 84

89Isso mostra apenas sessões iniciadas sob esse diretório. Uma sessão que [se moveu para um worktree](#how-file-edits-are-isolated) sob `~/projects/my-app/.claude/worktrees/` ainda conta como pertencente a `~/projects/my-app`.85Isso mostra apenas sessões iniciadas sob esse diretório. Uma sessão que [se moveu para um worktree](#how-file-edits-are-isolated) sob `~/projects/my-app/.claude/worktrees/` ainda é listada.

90 86

91Sessões interativas que você tem abertas em outros terminais não aparecem até que você as [coloque em background](#from-inside-a-session). [Subagents](/docs/pt/sub-agents) e [teammates](/docs/pt/agent-teams) que uma sessão gera não são listados como linhas separadas.87Sessões interativas que você tem abertas em outros terminais não aparecem até que você as [coloque em background](#from-inside-a-session). [Subagents](/docs/pt/sub-agents) e [teammates](/docs/pt/agent-teams) que uma sessão gera não são listados como linhas separadas.

92 88

117Cada linha começa com um ícone cuja cor e animação mostram o estado da sessão:113Cada linha começa com um ícone cuja cor e animação mostram o estado da sessão:

118 114

120| :---------- | :---------------- | :----------------------------------------------------------------------------- |116| :---------- | :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

122| Needs input | Amarelo | Claude está aguardando uma pergunta específica ou decisão de permissão de você |118| Needs input | Amarelo | Claude está aguardando algo que apenas você pode fornecer: uma resposta a uma pergunta, uma decisão de permissão ou outro prompt que apenas você pode responder, como um prompt de [sandbox](/docs/pt/sandboxing) para permitir um host de rede ou uma [solicitação de entrada](/docs/pt/mcp#respond-to-mcp-elicitation-requests) de um servidor MCP. Um comando que precisa de um terminal anexado, como `/install-github-app` ou a lista de configurações `/mcp`, [mantém uma sessão desatendida aqui também](#attach-to-a-session) |

126| Stopped | Cinza | A sessão foi interrompida com `Ctrl+X` ou `claude stop` |122| Stopped | Cinza | Você interrompeu a sessão com `Ctrl+X` ou `claude stop`, [seu processo foi encerrado de fora do Claude Code](#the-supervisor-process), ou [terminou enquanto o serviço em background estava desligado](#sessions-show-as-failed-after-shutdown) |

127 123

128Separadamente, a forma do ícone mostra se o processo subjacente está em execução:124Separadamente, a forma do ícone mostra se o processo subjacente está em execução:

129 125

130| Forma | O que significa |126| Forma | O que significa |

131| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------ |127| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------ |

133| `∙` | O processo saiu. Você ainda pode espreitar, responder ou anexar, e Claude reinicia de onde parou |129| `∙` | O processo saiu. Você ainda pode espreitar a linha, e quando você responde ou anexa, Claude reinicia de onde parou |

134| `✢` | Uma sessão [`/loop`](/docs/pt/scheduled-tasks) dormindo entre iterações. A linha mostra sua contagem de execução e uma contagem regressiva |130| `✢` | Uma sessão [`/loop`](/docs/pt/scheduled-tasks) dormindo entre iterações. A linha mostra sua contagem de execução e uma contagem regressiva |

135 131

136O rótulo `#N` que pode aparecer na borda direita de uma linha é um [pull request que a sessão está vinculada a](#pull-request-status), não parte do ícone de estado.132O rótulo `#N` ou `!N` que pode aparecer na borda direita de uma linha é um link para o [pull request ou merge request](#pull-request-status) da sessão, não parte do ícone de estado.

137 133

138O título da aba do terminal mostra a contagem de aguardando-entrada enquanto agent view está aberto: `2 awaiting input · claude agents` quando sessões precisam de entrada, ou `claude agents` quando nenhuma precisa.134O título da aba do terminal mostra a contagem de aguardando-entrada enquanto agent view está aberto: `2 awaiting input · claude agents` quando sessões precisam de entrada, ou `claude agents` quando nenhuma precisa.

139 135

140A partir da v2.1.198, enquanto agent view está aberto, Claude Code também envia uma notificação através do seu [canal de notificação de terminal](/docs/pt/terminal-config#get-a-terminal-bell-or-notification) configurado quando uma sessão em background local começa a precisar de sua entrada, termina ou falha. Sessões que executam em um cronograma, como sessões [`/loop`](/docs/pt/scheduled-tasks), notificam apenas quando precisam de sua entrada. As notificações usam a mesma configuração [`preferredNotifChannel`](/docs/pt/settings#available-settings) que o resto do Claude Code e disparam o hook [`Notification`](/docs/pt/hooks#notification) com o tipo `agent_needs_input` ou `agent_completed`.136Para ler o estado da sessão a partir de um script ou outro programa, use [`claude agents --json`](#read-session-state-from-a-script) em vez dos arquivos sob `~/.claude/jobs/`.

137

138Enquanto agent view está aberto, Claude Code também envia uma notificação através do seu [canal de notificação de terminal](/docs/pt/terminal-config#get-a-terminal-bell-or-notification) configurado quando uma sessão em background local começa a precisar de sua entrada, termina ou falha. Sessões que executam em um cronograma, como sessões [`/loop`](/docs/pt/scheduled-tasks), notificam apenas quando precisam de sua entrada. As notificações usam a mesma configuração [`preferredNotifChannel`](/docs/pt/settings-reference#preferrednotifchannel) que o resto do Claude Code e disparam o hook [`Notification`](/docs/pt/hooks#notification) com o tipo `agent_needs_input` ou `agent_completed`.

141 139

142Sessões em background não precisam de nenhum terminal aberto para continuar funcionando. Um [processo supervisor](#the-supervisor-process) separado as executa, então você pode fechar agent view, fechar seu shell ou iniciar uma nova sessão interativa e seu trabalho despachado continua.140Sessões em background não precisam de nenhum terminal aberto para continuar funcionando. Um [processo supervisor](#the-supervisor-process) separado as executa, então você pode fechar agent view, fechar seu shell ou iniciar uma nova sessão interativa e seu trabalho despachado continua.

143 141

144O estado da sessão persiste no disco através de atualizações automáticas e reinicializações do supervisor. As sessões também são preservadas quando sua máquina dorme. Seus processos retomam ao acordar e o supervisor se reconecta a eles em vez de tratar a lacuna de tempo como inatividade. Desligar ainda interrompe as sessões em execução; veja [Sessions show as failed after shutdown](#sessions-show-as-failed-after-shutdown) para saber como recuperá-las.142O estado da sessão persiste no disco através de atualizações automáticas e reinicializações do supervisor. As sessões também são preservadas quando sua máquina dorme. Seus processos retomam ao acordar e o supervisor se reconecta a eles em vez de tratar a lacuna de tempo como inatividade. Desligar ainda interrompe as sessões em execução; veja [Sessions show as failed or stopped after shutdown](#sessions-show-as-failed-after-shutdown) para saber como recuperá-las.

145 143

146Quando você abre uma sessão que parou de responder, o supervisor reinicia seu processo e a sessão continua a resposta interrompida de onde parou. Uma sessão pode acabar nesse estado quando a máquina dorme enquanto está no meio de uma resposta. Requer Claude Code v2.1.200 ou posterior.144Uma sessão que estava no meio de uma resposta quando a máquina dormiu pode voltar sem responder. Quando você abre uma sessão que parou de responder, o supervisor reinicia seu processo e a sessão continua a resposta interrompida de onde parou.

147 145

148<h3 id="row-summaries">146<h3 id="row-summaries">

149 Resumos de linha147 Resumos de linha

151 149

152O resumo de uma linha em cada linha é gerado por um [modelo Haiku-class](/docs/pt/model-config) para que a linha possa informar o que a sessão está fazendo, o que precisa ou o que produziu sem abrir o transcript. Enquanto uma sessão está ativamente funcionando, o texto da linha é atualizado no máximo uma vez a cada 15 segundos a partir da saída recente da própria sessão sem enviar uma solicitação de modelo, e o modelo escreve um resumo novo quando cada turno termina.150O resumo de uma linha em cada linha é gerado por um [modelo Haiku-class](/docs/pt/model-config) para que a linha possa informar o que a sessão está fazendo, o que precisa ou o que produziu sem abrir o transcript. Enquanto uma sessão está ativamente funcionando, o texto da linha é atualizado no máximo uma vez a cada 15 segundos a partir da saída recente da própria sessão sem enviar uma solicitação de modelo, e o modelo escreve um resumo novo quando cada turno termina.

153 151

154Uma linha funcionando mostra o que a sessão diz que está fazendo, e uma linha bloqueada mostra a pergunta que está fazendo. Durante um turno longo, o modelo também reescreve o resumo aproximadamente uma vez por minuto, aguardando o dobro do tempo após cada reescrita até quatro minutos, para que uma linha ocupada não continue mostrando um resumo desatualizado. Antes da v2.1.205, uma linha funcionando poderia mostrar uma invocação de ferramenta bruta em vez de um relatório, e uma sessão executando itens de trabalho paralelos mostrava uma contagem `done/total` como `2/5` antes do texto.152Uma linha funcionando mostra o que a sessão diz que está fazendo, e uma linha bloqueada mostra a pergunta que está fazendo. Durante um turno longo, o modelo também reescreve o resumo a cada poucos minutos para que uma linha ocupada não continue mostrando um resumo desatualizado. O texto de resumo preenche a largura restante da linha; abra o [painel de espiada](#peek-and-reply) para ler uma sentença que a borda do terminal corta.

155 153

156O texto de resumo preenche a largura restante da linha e é truncado apenas na borda direita do terminal; abra o [painel de espiada](#peek-and-reply) para ler uma sentença que a borda corta. Antes da v2.1.206, o texto era cortado em 64 colunas independentemente da largura do terminal.154Quando a lista é [agrupada por diretório](#organize-the-list), o resumo abre com o estado da sessão como uma palavra colorida, como `Needs input · double jump or wall climb?`. No agrupamento de estado padrão, o cabeçalho do grupo já nomeia o estado, então a linha mostra apenas o resumo.

157 155

158Quando a lista é [agrupada por diretório](#organize-the-list), o resumo abre com o estado da sessão como uma palavra colorida, como `Needs input · double jump or wall climb?`. No agrupamento de estado padrão, o cabeçalho do grupo já nomeia o estado, então a linha mostra apenas o resumo. Antes da v2.1.205, linhas agrupadas por diretório não tinham palavra de estado.156O resumo de fim de turno e cada reescrita de meio de turno são uma solicitação curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](/docs/pt/data-usage) que a sessão em si. As atualizações de 15 segundos entre reescritas de modelo reutilizam a saída da própria sessão e não enviam uma solicitação. Em um provedor de terceiros ou gateway sem um modelo Haiku-class configurado, a solicitação usa o modelo principal da sessão em vez disso; defina [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/pt/model-config#environment-variables) para escolher um.

~~159~~

160Um turno cuja saída inteira não contém letras ou dígitos, como uma sessão [`/loop`](/docs/pt/scheduled-tasks) que imprime um símbolo solitário em uma iteração silenciosa, mantém o resumo e estado anteriores da linha. Antes da v2.1.205, esse turno era reclassificado e poderia virar uma sessão que estava aguardando sua entrada de volta para `Working`.

~~161~~

162O resumo de fim de turno e cada reescrita de meio de turno são uma solicitação curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](/docs/pt/data-usage) que a sessão em si. As atualizações de 15 segundos entre reescritas de modelo reutilizam a saída da própria sessão e não enviam uma solicitação. Em provedores de terceiros como Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e gateways personalizados, a solicitação volta para o modelo principal da sessão quando nenhum modelo Haiku está configurado. Defina [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/pt/model-config#environment-variables) para escolher o modelo para esses resumos nesses provedores.

163 157

164<h3 id="pull-request-status">158<h3 id="pull-request-status">

165 Status de pull request159 Status de pull request

166</h3>160</h3>

167 161

168Quando uma sessão abre um pull request, um rótulo `#1234` aparece na borda direita da linha, vinculado ao pull request em terminais que suportam hiperlinks. O rótulo persiste quando você envia um acompanhamento para a sessão, então o pull request permanece visível enquanto a linha reverte para progresso ao vivo. Sessões em background que isolaram suas alterações em um worktree abrem esses pull requests por conta própria; [How file edits are isolated](#how-file-edits-are-isolated) cobre quando isso acontece e o que uma sessão nunca faz sem perguntar.162Quando uma sessão [abre um pull request](#how-file-edits-are-isolated), Claude Code adiciona um rótulo na borda direita da linha, vinculado ao pull request:

169 163

170Uma sessão que trabalha em um pull request existente está vinculada a ele da mesma forma. Editar, comentar, fechar ou marcar um pull request como pronto com `gh` vincula o pull request que a saída do próprio comando nomeia, então um comando `gh` cuja saída capturada não nomeia nenhum pull request não cria um link; `gh pr merge` é o caso comum, porque imprime seu resultado apenas para um terminal interativo. Verificar um pull request com `gh pr checkout`, ou fazer push para um branch que tem um pull request aberto, vincula-o procurando esse branch com `gh pr view` em vez disso. Antes da v2.1.205, apenas pull requests que a sessão criou ou verificou foram vinculados, e um push vinculou um apenas quando o nome do branch local correspondia.164* Claude Code escreve o rótulo como `#1234` para um pull request e como `!1234` para um merge request do GitLab.

165* Claude Code emite o link mesmo quando não consegue detectar suporte a hiperlink, por exemplo sobre SSH ou tmux. Defina [`FORCE_HYPERLINK=0`](/docs/pt/env-vars) para renderizar o rótulo como texto simples.

166* Depois que você envia um acompanhamento para a sessão, Claude Code mantém o rótulo enquanto a linha retorna ao progresso ao vivo.

171 167

172Claude Code lê o pull request da saída completa do comando, incluindo a parte salva em um arquivo quando a saída de um comando excede o limite inline. Antes da v2.1.205, um pull request criado em uma chamada Bash cuja saída excedia cerca de 30.000 caracteres não era vinculado.168Uma sessão que trabalha em um pull request existente está vinculada a ele da mesma forma. Claude Code encontra o pull request de forma diferente dependendo do comando que Claude executa:

169

170* Quando Claude edita, comenta, fecha ou marca um pull request como pronto com `gh`, Claude Code vincula o pull request que a saída do próprio comando nomeia. Um comando `gh` cuja saída capturada não nomeia nenhum pull request não cria um link; `gh pr merge` é o caso comum, porque imprime seu resultado apenas para um terminal interativo.

171* Quando Claude verifica um pull request com `gh pr checkout` ou faz push para um branch, Claude Code procura o branch com `gh pr view` e vincula seu pull request aberto.

172* O pull request não precisa existir ainda quando Claude faz push: Claude Code tenta novamente a busca do branch após até cinco comandos `git`, `gh`, `glab` ou `curl` posteriores executados no mesmo diretório, então um pull request criado após o push, incluindo um que Claude cria através da API REST do GitHub, vincula quando uma tentativa o encontra.

173 173

174Quando uma sessão está vinculada a mais de um pull request, o rótulo mostra uma contagem em vez disso, como `3 PRs`, colorido pelo pull request aberto que mais precisa de atenção. Abra o [painel de espiada](#peek-and-reply) para ver todos eles.174Quando uma sessão está vinculada a mais de um pull request, o rótulo mostra uma contagem em vez disso, como `3 PRs`, colorido pelo pull request aberto que mais precisa de atenção. Abra o [painel de espiada](#peek-and-reply) para ver todos eles.

175 175

182| Roxo | Mesclado |182| Roxo | Mesclado |

183| Cinza | Rascunho ou fechado |183| Cinza | Rascunho ou fechado |

184 184

185Para a maioria das tarefas, esta coluna é onde você coleta o resultado: revise e mescle o pull request quando seu número ficar verde.185Para uma tarefa que termina em um pull request, verifique este rótulo para o resultado: revise e mescle o pull request quando seu número ficar verde.

186 186

187<h3 id="peek-and-reply">187<h3 id="peek-and-reply">

188 Peek and reply188 Peek and reply

198 198

199Na maioria das vezes, o painel de espiada é suficiente e você não precisa abrir o transcript completo.199Na maioria das vezes, o painel de espiada é suficiente e você não precisa abrir o transcript completo.

200 200

201Antes da v2.1.207, cada espiada abria com a sentença de status e um timestamp simples, e uma sessão bloqueada tinha sua pergunta aparecendo abaixo deles prefixada com o mesmo timestamp uma segunda vez.201Digite uma resposta no painel de espiada e pressione `Enter` para enviá-la para essa sessão. Quando a sessão faz uma pergunta com opções predefinidas, o painel de espiada as mostra como uma lista numerada e você pode pressionar uma tecla numérica para escolher uma. Um prompt de permissão mostra como texto descrevendo o que a sessão quer executar, sem opções numeradas. Digite uma resposta para respondê-lo, ou anexe para responder com o prompt padrão. Para outras sessões bloqueadas, pressione `Tab` para preencher a entrada com uma resposta sugerida que você pode editar antes de enviar. Prefixe uma resposta com `!` para enviar um comando Bash em vez disso.

202 202

203Digite uma resposta no painel de espiada e pressione `Enter` para enviá-la para essa sessão. Quando a sessão está fazendo uma pergunta de múltipla escolha, o painel de espiada mostra as opções e você pode pressionar uma tecla numérica para escolher uma. Para outras sessões bloqueadas, pressione `Tab` para preencher a entrada com uma resposta sugerida que você pode editar antes de enviar. Prefixe uma resposta com `!` para enviar um comando Bash em vez disso.203Quando um hook [`PermissionRequest`](/docs/pt/hooks#permissionrequest) ou [`PreToolUse`](/docs/pt/hooks#pretooluse) retorna uma saída que Claude Code não consegue validar para a chamada que a sessão está pedindo, a linha mostra o evento do hook e `hook output invalid:` com o erro de validação antes do texto da solicitação pendente. Para um hook que falha de outra forma, a linha diz que o hook falhou. A sessão ainda aguarda a mesma solicitação.

204 204

205Uma resposta que não pode ser entregue, porque o serviço em background está inacessível ou o envio falha, é salva e enviada para a sessão como seu próximo prompt quando seu processo começar novamente, e a mensagem de erro diz que a resposta foi salva. Uma resposta prefixada com `!` não é salva, porque o texto salvo chegaria à sessão como um prompt simples em vez de executar como um comando Bash.205Uma resposta que não pode ser entregue, porque o serviço em background está inacessível ou o envio falha, é salva e enviada para a sessão como seu próximo prompt quando seu processo começar novamente, e a mensagem de erro diz que a resposta foi salva. Uma resposta prefixada com `!` não é salva, porque o texto salvo chegaria à sessão como um prompt simples em vez de executar como um comando Bash.

206 206

216 216

217Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: [comandos](/docs/pt/commands), atalhos de teclado e recursos todos funcionam, com as exceções abaixo.217Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: [comandos](/docs/pt/commands), atalhos de teclado e recursos todos funcionam, com as exceções abaixo.

218 218

219Uma sessão em background recusa `/install-github-app` e a lista de configurações [`/mcp`](/docs/pt/mcp), incluindo suas ações de autenticação, se você está anexado ou respondendo do painel de espiada. A mensagem o direciona para uma sessão `claude` regular, e `/mcp reconnect <server>`, `/mcp enable` e `/mcp disable` ainda funcionam.219Enquanto você está anexado, `/install-github-app` e a lista de configurações [`/mcp`](/docs/pt/mcp) funcionam normalmente, já que um humano no terminal pode completar seus diálogos. Quando ninguém está anexado, esses comandos não conseguem abrir seus diálogos, então a sessão aparece sob `Needs input` em agent view com uma linha como `open this session to manage MCP servers`, e a resposta do transcript diz o mesmo. Anexe e execute o comando novamente para continuar; a linha de necessidade de entrada é limpa quando você anexa. `/mcp reconnect <server>`, `/mcp enable` e `/mcp disable` funcionam sem anexar de qualquer forma.

220 220

221Sessões anexadas sempre renderizam em [modo fullscreen](/docs/pt/fullscreen), independentemente de sua configuração `tui`, porque uma sessão em background não tem scrollback de terminal para anexar. Role com `PgUp`, `PgDn` ou a roda do mouse, e pressione `Ctrl+O` para modo de transcript. O scroll nativo do seu terminal e o modo de cópia tmux mostram apenas o viewport atual, o mesmo que quando você executa qualquer aplicativo fullscreen.221Sessões anexadas sempre renderizam em [modo fullscreen](/docs/pt/fullscreen), independentemente de sua configuração `tui`, porque uma sessão em background não tem scrollback de terminal para anexar. Role com `PgUp`, `PgDn` ou a roda do mouse, e pressione `Ctrl+O` para modo de transcript. O scroll nativo do seu terminal e o modo de cópia tmux mostram apenas o viewport atual, o mesmo que quando você executa qualquer aplicativo fullscreen.

222 222

223Pressione `←` em um prompt vazio, ou execute `/exit`, para desanexar e retornar a agent view. A partir da v2.1.198, isso funciona da mesma forma se você abriu a sessão a partir de agent view ou com `claude attach <id>` a partir do seu shell.223Pressione `←` em um prompt vazio, ou execute `/exit`, para desanexar e retornar a agent view, independentemente de você ter aberto a sessão a partir de agent view ou com `claude attach <id>` a partir do seu shell.

224

225`←` também desanexa enquanto o [overlay `/btw`](/docs/pt/interactive-mode#side-questions-with-%2Fbtw) está aberto. Requer Claude Code v2.1.257 ou posterior. Uma pergunta lateral que ainda está respondendo continua em execução enquanto você está ausente. Na próxima vez que você anexar, o overlay reabre com ela, ou com sua resposta.

224 226

225`Ctrl+Z` também desanexa, mas volta para onde você começou: agent view se você anexou de lá, ou seu shell se você executou `claude attach`. Use `Ctrl+Z` quando um diálogo tem foco e não está respondendo a `←`.227No Windows, se você pressionar `←` dentro de cerca de meio segundo de anexar, Claude Code mostra `Ambiguous ←, press again to detach`, porque naquela janela o terminal pode reentrega um pressionamento de antes de você anexar. Pressione `←` novamente para desanexar.

228

229`Ctrl+Z` também desanexa mas volta para onde você começou em vez disso: agent view se você anexou de lá, ou seu shell se você executou `claude attach`. Use `Ctrl+Z` quando um diálogo tem foco e não está respondendo a `←`.

226 230

227`Ctrl+C` mantém seu comportamento de interrupção padrão enquanto anexado: ele cancela uma resposta em execução ou comando shell `!` em vez de desanexar. Pressionar `Ctrl+C` duas vezes em um prompt vazio desanexa, o mesmo que em qualquer sessão.231`Ctrl+C` mantém seu comportamento de interrupção padrão enquanto anexado: ele cancela uma resposta em execução ou comando shell `!` em vez de desanexar. Pressionar `Ctrl+C` duas vezes em um prompt vazio desanexa, o mesmo que em qualquer sessão.

228 232

229Desanexar nunca interrompe uma sessão em background: `←`, `Ctrl+Z`, `/exit` e duplo `Ctrl+C` ou duplo `Ctrl+D` a deixam em execução. Para encerrar uma sessão de dentro dela, execute `/stop`.233Desanexar nunca interrompe uma sessão em background: `←`, `Ctrl+Z`, `/exit` e duplo `Ctrl+C` ou duplo `Ctrl+D` a deixam em execução. Para encerrar uma sessão de dentro dela, execute `/stop`.

230 234

235<h4 id="switch-sessions-without-leaving-the-terminal">

236 Alternar sessões sem sair do terminal

237</h4>

238

231Em uma sessão em execução em primeiro plano, uma que você iniciou no terminal em vez de anexar a partir de agent view, pressionar `←` em um prompt vazio a coloca em background e abre agent view com essa linha selecionada, para que você possa alternar sessões sem sair do terminal. O mesmo pressionamento único desanexa uma sessão anexada.239Em uma sessão em execução em primeiro plano, uma que você iniciou no terminal em vez de anexar a partir de agent view, pressionar `←` em um prompt vazio a coloca em background e abre agent view com essa linha selecionada, para que você possa alternar sessões sem sair do terminal. O mesmo pressionamento único desanexa uma sessão anexada.

232 240

233Se uma ferramenta está em execução quando você pressiona `←`, Claude Code aguarda até cerca de dez segundos para que ela termine antes de colocar em background, e a resposta continua na sessão em background. Pressione `←` novamente para colocar em background imediatamente em vez de aguardar. Quando o trabalho em andamento não pode ser transferido para a sessão em background, o diálogo `Background this session?` aparece primeiro, o mesmo que com [`/background`](#from-inside-a-session).241Se você pressionar `←` logo após deletar o último texto do prompt ou mover pelo histórico do prompt, Claude Code pede que você confirme: o primeiro pressionamento mostra `Press ← again to open agents`, ou `Press ← again to go back to agents` em uma sessão anexada, e o segundo pressionamento alterna.

242

243Quando `←` coloca uma sessão em primeiro plano em background, agent view mostra `Your conversation moved to the background` acima da lista, com a linha dessa sessão já selecionada. De lá:

244

245* Pressione `Enter` para reabrir a conversa.

246* Pressione `Esc` para desfazer a alternância e retornar à conversa. Se `Esc` mostra `Still starting — try again in a moment`, a sessão em background ainda não está pronta, então pressione `Esc` novamente em um momento.

247* Pressione `Ctrl+C` duas vezes para sair para seu shell.

248

249Quando Claude Code não consegue reabrir a conversa, ele sai e imprime um comando `claude --resume` que a retoma.

250

251[A lista de tarefas do Claude](/docs/pt/interactive-mode#task-list) se move para a sessão em background com a conversa, então a lista de verificação está intacta quando você retorna àquela linha.

252

253A linha em que você pressionou `←` também mantém um nome em negrito e não esmaecido depois que você move a seleção com as teclas de seta ou o mouse, para que você possa dizer de qual sessão você veio.

254

255Se uma ferramenta está em execução quando você pressiona `←`, Claude Code aguarda até cerca de dez segundos para que ela termine antes de colocar em background, e Claude continua a resposta na sessão em background. Pressione `←` novamente para colocar em background imediatamente em vez de aguardar. Quando o trabalho em andamento não pode ser transferido para a sessão em background, Claude Code mostra o diálogo `Background this session?` primeiro, o mesmo que com [`/background`](#from-inside-a-session).

234 256

235O limite de dez segundos não se aplica enquanto [subagents](/docs/pt/sub-agents) estão em execução. Claude Code continua aguardando para que seu trabalho seja transferido, e mostra um aviso `Still backgrounding after the current tool` enquanto aguarda; pressione `←` novamente para colocar em background sem aguardar, o que reinicia os subagents do início. Antes da v2.1.203, a espera terminava após dez segundos e os subagents em execução eram reiniciados do início sem aviso.257O limite de dez segundos não se aplica enquanto os [subagents em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) que Claude iniciou na conversa ainda estão em execução. Claude Code continua aguardando para que seu trabalho seja transferido, e mostra um aviso `Still backgrounding after the current tool` enquanto aguarda. Pressione `←` novamente para colocar em background sem aguardar, o que reinicia esses subagents do início. Claude Code não aguarda os subagents que um [workflow dinâmico](/docs/pt/workflows) está executando. Quando um workflow tem subagents em execução, Claude Code mostra o diálogo `Background this session?` em vez disso.

236 258

237A linha é criada mesmo a partir de uma sessão nova sem histórico de conversa, então `→` retorna a ela. Antes da v2.1.203, agent view mostrava uma dica de integração abaixo dessa linha quando era a única.259Claude Code não coloca a sessão em background enquanto você tem texto não enviado na entrada do prompt, porque o texto fica na caixa de entrada do seu terminal e não se moveria para a sessão em background. Se você digitar na entrada enquanto Claude Code aguarda para colocar a sessão em background, ele cancela a alternância com `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

260

261Pressionar `←` cria a linha da sessão mesmo quando a conversa não tem mensagens ainda, então `→` ainda retorna a ela.

238 262

239Você pode desativar este atalho com a configuração `leftArrowOpensAgents` em `/config`.263Você pode desativar este atalho com a configuração `leftArrowOpensAgents` em `/config`.

240 264

255 279

256Para remover uma sessão da lista, pressione `Ctrl+X` para interrompê-la e `Ctrl+X` novamente dentro de dois segundos para deletá-la. Pressionar `Ctrl+X` em um cabeçalho de grupo deleta cada sessão naquele grupo após confirmação.280Para remover uma sessão da lista, pressione `Ctrl+X` para interrompê-la e `Ctrl+X` novamente dentro de dois segundos para deletá-la. Pressionar `Ctrl+X` em um cabeçalho de grupo deleta cada sessão naquele grupo após confirmação.

257 281

258Deletar remove a sessão de agent view. Se Claude [criou um worktree](#how-file-edits-are-isolated) para a sessão, deletar remove esse worktree também, incluindo quaisquer alterações não confirmadas nele, então faça commit do trabalho que você quer manter primeiro. Um worktree que você criou você mesmo e iniciou a sessão dentro é deixado no lugar. O transcript de conversa fica em sua máquina local e permanece disponível através de `claude --resume`.282O segundo pressionamento deleta a sessão mesmo quando a tentativa de parada falha, por exemplo porque o [serviço em background não está respondendo](#agent-view-says-the-background-service-did-not-respond): a confirmação permanece ativa por mais dois segundos, e a exclusão encerra o processo da sessão em si. Pressione `Esc` para descartar a confirmação sem deletar.

283

284Exceto nos casos mantidos cobertos em [What deleting a session removes](#what-deleting-a-session-removes), deletar remove a sessão da lista, e um worktree que Claude criou para ela é removido, mantido ou deixado no lugar dependendo de como você deleta e o que o worktree contém. O transcript de conversa sempre fica em sua máquina local, disponível através de `claude --resume`.

285

286Para trazer uma sessão de volta no Claude Code v2.1.212 ou posterior, digite `/resume` na entrada de despacho. Um seletor abre com sessões passadas do repositório a partir do qual você abriu agent view, mais recentes primeiro, incluindo sessões que você deletou da lista; sessões que já têm uma linha não são listadas. `↑`/`↓` movem a seleção, `Enter` retoma a sessão selecionada como uma sessão em background para que ela se rejunte à lista como uma linha, e `Esc` fecha o seletor.

259 287

260Deletar nunca remove um worktree com commits que não foram feitos push em lugar nenhum, ou um que outra sessão em execução reclama ou tem bloqueado. Claude Code mantém o worktree e a sessão, e o rodapé nomeia o caminho mantido e o motivo. Faça push dos commits, ou feche a outra sessão, então delete novamente.288O seletor abre apenas para um `/resume` simples. Um resume direcionado, com escopo ou restrito não pode ser servido pelo seletor, então agent view mostra a dica `attach to a session to run it` em vez disso quando:

261 289

262Deletar também limpa a sessão da [lista de sessões do supervisor](#the-supervisor-process), se você deletar com `Ctrl+X` ou com [`claude rm`](#manage-sessions-from-the-shell) a partir do shell, então a remoção persiste entre reinicializações do supervisor. Antes da v2.1.206, remover uma sessão enquanto o supervisor estava reiniciando ou inacessível a deixava naquela lista, e o próximo supervisor reiniciava seu processo e mostrava a linha novamente.290* `/resume` nomeia um id ou um termo de busca

291* a visualização tem escopo com `--cwd`

292* a visualização foi iniciada com [`--safe-mode`](/docs/pt/cli-reference#cli-flags)

293* a visualização foi aberta com um sinalizador como `--permission-mode` ou `--settings`

263 294

264Sessões concluídas que não cabem na tela se dobram em uma linha `… N more`. Falhas e sessões com um pull request aberto sempre permanecem visíveis. O grupo `Completed` preenche o espaço vertical deixado após os grupos ativos, e em um terminal curto o cabeçalho se compacta para uma única linha de resumo para que sessões que estão funcionando ou precisam de entrada permaneçam visíveis.295Sessões concluídas que não cabem na tela se dobram em uma linha `… N more`. Falhas e sessões com um pull request aberto sempre permanecem visíveis. O grupo `Completed` preenche o espaço vertical deixado após os grupos ativos, e em um terminal curto o cabeçalho se compacta para uma única linha de resumo para que sessões que estão funcionando ou precisam de entrada permaneçam visíveis.

265 296

270Digite na entrada de despacho para filtrar em vez de despachar:301Digite na entrada de despacho para filtrar em vez de despachar:

271 302

272| Filtro | Mostra |303| Filtro | Mostra |

273| :--------------------------- | :---------------------------------------------------------------------------------------------------------- |304| :---------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |

275| `s:<state>` | Sessões no estado fornecido, como `s:working`. Também aceita `s:blocked` para tudo que está aguardando você |306| `s:<state>` | Sessões no estado fornecido, como `s:working`. Também aceita `s:blocked` para tudo que está aguardando você |

277| Qualquer outra URL | A sessão cujo primeiro prompt continha essa URL |308| Qualquer outra URL | A sessão cujo primeiro prompt continha essa URL |

278 309

279<h3 id="keyboard-shortcuts">310<h3 id="keyboard-shortcuts">

283Pressione `?` em agent view para ver cada atalho em contexto. A tabela abaixo os resume.314Pressione `?` em agent view para ver cada atalho em contexto. A tabela abaixo os resume.

284 315

285| Atalho | Ação |316| Atalho | Ação |

286| :-------------------- | :---------------------------------------------------------------------------------------------- |317| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

287| `↑` / `↓` | Mover entre linhas |318| `↑` / `↓` | Mover entre linhas |

322| `Ctrl+Enter` | Despachar e anexar imediatamente, em terminais onde o overlay `?` lista `ctrl+enter to start and open` |

291| `→` | Anexar à sessão selecionada |323| `→` | Anexar à sessão selecionada |

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

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

300| `Esc` | Fechar o painel de espiada, limpar a entrada ou sair |333| `Esc` | Fechar o painel de espiada, limpar a entrada ou sair. Quando você abriu agent view colocando sua sessão em background com `←`, o `Esc` final retorna àquela conversa em vez de sair. Com [vim editor mode](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `Esc` na entrada alterna de modo INSERT para modo NORMAL e mantém seu texto, como no prompt principal |

302| `?` | Mostrar todos os atalhos |335| `?` | Mostrar todos os atalhos |

303 336

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

338

304<h2 id="dispatch-new-agents">339<h2 id="dispatch-new-agents">

305 Despachar novos agentes340 Despachar novos agentes

306</h2>341</h2>

313 348

314Digite um prompt na entrada na parte inferior de agent view e pressione `Enter` para iniciar uma nova sessão em background. A sessão é nomeada automaticamente a partir do prompt; renomeie-a mais tarde com `Ctrl+R`.349Digite um prompt na entrada na parte inferior de agent view e pressione `Enter` para iniciar uma nova sessão em background. A sessão é nomeada automaticamente a partir do prompt; renomeie-a mais tarde com `Ctrl+R`.

315 350

316Um nome que a sessão recebe mais tarde também aparece em sua linha, incluindo o nome que Claude deriva quando você [aceita um plano](/docs/pt/permission-modes#review-and-approve-a-plan) naquela sessão. Antes da v2.1.207, uma sessão em background nomeada ao aceitar um plano mostrava esse nome em `/status` mas não em sua linha de agent view até que você a renomeasse você mesmo.351O nome automático é um rótulo curto escrito por um [modelo da classe Haiku](/docs/pt/model-config). Um nome que a sessão recebe mais tarde também aparece em sua linha, incluindo o [título gerado](/docs/pt/sessions#name-your-sessions) que a sessão recebe quando você [aceita um plano](/docs/pt/permission-modes#review-and-approve-a-plan) naquela sessão.

317 352

318Cole uma imagem no prompt para incluir uma captura de tela ou diagrama com a tarefa.353Cole uma imagem no prompt para incluir uma captura de tela ou diagrama com a tarefa.

319 354

320Texto colado mais longo que 800 caracteres ou mais de duas linhas se recolhe para um placeholder `[Pasted text #N]` para que a entrada permaneça em uma linha; o texto completo é enviado quando você despacha. Para revisar ou editar o texto recolhido antes de despachar, cole o mesmo texto novamente e o placeholder se expande de volta para a entrada. Um lembrete `paste again to expand` aparece abaixo da entrada por alguns segundos após a colagem em terminais com pelo menos 90 colunas de largura. Antes da v2.1.207, colar o mesmo texto novamente adicionava um segundo placeholder em vez de expandir o primeiro.355Texto colado mais longo que 800 caracteres ou mais de três linhas se recolhe para um placeholder `[Pasted text #N]` para que a entrada permaneça em uma linha; o texto completo é enviado quando você despacha. Para revisar ou editar o texto recolhido antes de despachar, cole o mesmo texto novamente e o placeholder se expande de volta para a entrada.

321 356

322Prefixe ou mencione partes do prompt para controlar como a sessão é iniciada:357Prefixe ou mencione partes do prompt para controlar como a sessão é iniciada:

323 358

324| Entrada | Efeito |359| Entrada | Efeito |

325| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |360| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

326| `<agent-name> <prompt>` | Se a primeira palavra corresponder a um nome de [subagent](/docs/pt/sub-agents) personalizado, esse subagent é executado como o agente principal da sessão com a configuração de seu frontmatter |361| `<agent-name> <prompt>` | Se a primeira palavra corresponder a um nome de [subagent](/docs/pt/sub-agents) personalizado, esse subagent é executado como o agente principal da sessão com a configuração de seu frontmatter |

327| `@<agent-name>` | Mencione um subagent personalizado em qualquer lugar do prompt para executá-lo como o agente principal |362| `@<agent-name>` | Mencione um subagent personalizado em qualquer lugar do prompt para executá-lo como o agente principal |

328| `@<repo>` | Mencione um repositório para executar a sessão lá. Veja [Dispatch to a specific directory](#dispatch-to-a-specific-directory) para saber quais repositórios são listados |363| `@<repo>` | Mencione um repositório para executar a sessão lá. Veja [Dispatch to a specific directory](#dispatch-to-a-specific-directory) para saber quais repositórios são listados |

330| `! <command>` | Execute um comando shell como um trabalho em background em vez de iniciar uma sessão Claude. O trabalho aparece como uma linha que você pode anexar, observar e desanexar |365| `! <command>` | Execute um comando shell como um trabalho em background em vez de iniciar uma sessão Claude. O trabalho aparece como uma linha que você pode anexar, observar e desanexar |

331| `#<number>` ou uma URL de pull request | Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar |366| `#<number>` ou uma URL de pull ou merge request | Se uma sessão já está trabalhando naquele pull request ou merge request, Claude Code seleciona sua linha em vez de despachar uma nova sessão |

332| `Shift+Enter` | Despachar e anexar imediatamente à nova sessão |

333 367

334Um pequeno conjunto de comandos é executado em agent view em si em vez de ser despachado:368Um pequeno conjunto de comandos é executado em agent view em si em vez de ser despachado:

335 369

336* `/exit` e `/quit` fecham agent view370* `/exit` e `/quit` fecham agent view

337* `/logout` desconecta você371* `/logout` desconecta você

338* `/model` define o [modelo de despacho](#set-the-model)372* `/model` define o [modelo de despacho](#set-the-model)

339* A partir da v2.1.198, `/login` abre o diálogo de entrada para que você possa entrar novamente sem anexar a uma sessão373* `/login` abre o diálogo de entrada para que você possa entrar novamente sem anexar a uma sessão

374* Um `/resume` simples, ou seu alias `/continue`, abre um seletor das sessões passadas do repositório para [trazer uma de volta](#organize-the-list) como uma sessão em background. Requer Claude Code v2.1.212 ou posterior

340 375

341Skills, seus próprios comandos e built-ins que expandem prompts como `/init` são enviados para uma nova sessão em background como seu primeiro prompt. Outros comandos built-in mostram uma dica `attach to a session to run it` em vez disso. Tudo que você digitou permanece na entrada ao lado da dica para que você possa editá-lo. Antes da v2.1.203, a dica limpava a entrada e o texto digitado era perdido.376Skills, seus próprios comandos e built-ins que expandem prompts como `/init` são enviados para uma nova sessão em background como seu primeiro prompt. Outros comandos built-in mostram uma dica `attach to a session to run it` em vez disso. Tudo que você digitou permanece na entrada ao lado da dica para que você possa editá-lo.

342 377

343Empacotar uma tarefa recorrente como uma [skill](/docs/pt/skills) permite que você inicie o mesmo fluxo de trabalho a partir de agent view repetidamente sem redigitar o prompt.378Empacotar uma tarefa recorrente como uma [skill](/docs/pt/skills) permite que você inicie o mesmo fluxo de trabalho a partir de agent view repetidamente sem redigitar o prompt.

344 379

357 * Os [git worktrees](/docs/pt/worktrees) registrados do repositório a partir do qual você iniciou que vivem dentro de sua árvore de diretórios, como os que Claude cria sob `.claude/worktrees/`, rotulados com seu branch verificado. Worktrees adicionados fora do repositório, como com `git worktree add ../feature`, não são listados392 * Os [git worktrees](/docs/pt/worktrees) registrados do repositório a partir do qual você iniciou que vivem dentro de sua árvore de diretórios, como os que Claude cria sob `.claude/worktrees/`, rotulados com seu branch verificado. Worktrees adicionados fora do repositório, como com `git worktree add ../feature`, não são listados

358 * Qualquer diretório que já tenha uma sessão na lista393 * Qualquer diretório que já tenha uma sessão na lista

359 394

360 Um diretório cujo nome contém um espaço não é listado. Antes da v2.1.203, worktrees registrados não eram listados, portanto despachar para um significava executar `claude --bg` a partir do diretório daquele worktree.395 Um diretório cujo nome contém um espaço não é listado.

361* Do shell, `cd` para o diretório e execute `claude --bg "<prompt>"`.396* Do shell, `cd` para o diretório e execute `claude --bg "<prompt>"`.

362 397

363Quando agent view é agrupado por diretório, o diretório da linha destacada se torna o alvo de despacho, para que você possa rolar para um grupo e despachar nele sem redigitar o caminho.398Quando agent view é agrupado por diretório, despachar envia o prompt para o diretório da linha selecionada, para que você possa selecionar um grupo e despachar nele sem redigitar o caminho.

364 399

365<h3 id="from-inside-a-session">400<h3 id="from-inside-a-session">

366 From inside a session401 From inside a session

367</h3>402</h3>

368 403

404Dois comandos movem trabalho da sessão em que você está para o background: `/background` envia a conversa atual para lá e libera seu terminal, e `/fork` envia uma cópia enquanto você continua trabalhando onde está.

405

406<h4 id="send-the-session-to-the-background">

407 Send the session to the background

408</h4>

409

369Execute `/background` ou seu alias `/bg` para mover a conversa atual para uma sessão em background. Passe um prompt como `/bg run the test suite and fix any failures` para dar uma instrução adicional primeiro. Se Claude estiver respondendo quando você executar `/bg`, a resposta continua na sessão em background.410Execute `/background` ou seu alias `/bg` para mover a conversa atual para uma sessão em background. Passe um prompt como `/bg run the test suite and fix any failures` para dar uma instrução adicional primeiro. Se Claude estiver respondendo quando você executar `/bg`, a resposta continua na sessão em background.

370 411

371Sair de uma sessão interativa que ainda tem trabalho em background em execução, como subagents, comandos shell em background, workflows ou [monitors](/docs/pt/tools-reference#monitor-tool), mostra um diálogo `Background work is running` em vez de sair imediatamente. A partir da v2.1.198, o diálogo oferece `Move to background and exit` junto com `Exit anyway` e `Stay`. Escolhê-lo move a sessão para o background da mesma forma que `/background` faz, depois retorna você ao seu shell, para que o trabalho que pode ser transferido continue em execução e a sessão apareça em agent view. A opção não é mostrada quando agent view está [desativado](#turn-off-agent-view).412Sair de uma sessão que ainda tem trabalho em background em execução, como subagents, comandos shell em background, workflows ou [monitors](/docs/pt/tools-reference#monitor-tool), mostra um diálogo `Background work is running` em vez de sair imediatamente. Escolha `Move to background and exit` para colocar a sessão em background da mesma forma que `/background` faz e retornar ao seu shell. A opção não é mostrada quando agent view está [desativado](#turn-off-agent-view).

413

414Se uma sessão em background na lista já tem o nome da conversa, Claude Code numera o nome da nova linha, como `my-session (2)`, e deixa o nome da linha existente sozinho. Para renomear a nova linha, selecione-a em agent view e pressione `Ctrl+R`.

415

416<h4 id="copy-the-session-with-/fork">

417 Copy the session with /fork

418</h4>

419

420Execute `/fork` para copiar a conversa atual para uma nova sessão em background enquanto a original continua em execução. A cópia começa com tudo na conversa até esse ponto; veja os pontos abaixo para onde a cópia é executada. Ela também carrega o modelo, permission mode, effort level e quaisquer diretórios ou concessões de permissão "não pergunte novamente" que você adicionou durante a sessão. A cópia aparece como sua própria linha em agent view.

421

422Após o fork, as duas conversas são independentes: nada que a cópia faz entra na conversa original por conta própria, embora em sessões onde [cross-session messaging](/docs/pt/cross-session-messaging) está habilitado, Claude de qualquer sessão pode explicitamente enviar mensagens para a outra.

423

424Copiar a sessão requer Claude Code v2.1.212 ou posterior; em v2.1.161 até v2.1.211, `/fork` inicia um [subagent bifurcado](/docs/pt/sub-agents#fork-the-current-conversation) em vez disso, que agora é `/subtask`. Quando [agent view está desativado](#turn-off-agent-view), `/fork` mantém o comportamento de subagent bifurcado e `/subtask` não está disponível.

425

426Passe um prompt como `/fork open a draft pull request with the work so far` e a cópia começa a trabalhar nele imediatamente. Sem um prompt, a cópia aguarda sua primeira instrução: selecione sua linha em `claude agents` e pressione `Space` para enviar uma, ou execute `claude attach <id>`. A linha selecionada mostra `space to send it a prompt` enquanto aguarda.

372 427

373Colocar em background a partir de uma sessão interativa inicia um novo processo que retoma da conversa salva, e o trabalho em andamento se move para ele: comandos shell em background em execução, subagents em background, workflows dinâmicos e tarefas agendadas que você criou com [`/loop`](/docs/pt/scheduled-tasks) são transferidos para a sessão em background e continuam em execução lá. Um subagent se move junto com tudo que iniciou, portanto é transferido apenas quando todo esse trabalho pode se mover também, incluindo no Windows. Para parar o trabalho em andamento em vez de transferi-lo, defina a variável de ambiente [`CLAUDE_DISABLE_ADOPT=1`](/docs/pt/env-vars#variables); Claude Code então pede que você confirme antes de colocar em background.428A confirmação de `/fork` é uma linha mostrando o estado da cópia, como `session running`, o nome de sua linha de agent view e seu ID de sessão para `claude attach`. Clique no nome para alternar para a cópia: esta sessão se move para o background, o mesmo que pressionar `←`, e agent view abre a sessão da cópia.

374 429

375Trabalho que não pode ser transferido, como um [monitor](/docs/pt/tools-reference#monitor-tool) em execução, é interrompido. Um subagent em background que possui um monitor é interrompido junto com ele. Quando algum desse trabalho está em execução, Claude Code mostra um diálogo `Background this session?` para que você possa confirmar antes de ser interrompido.430Exceto quando a cópia [edita no local](#how-file-edits-are-isolated), Claude Code a instrui a criar seu próprio worktree antes de fazer alterações de código. Fora de um repositório git, apenas uma cópia movida para fora de um worktree criado por hook recebe a instrução; sem um hook [`WorktreeCreate`](/docs/pt/hooks#worktreecreate), a cópia edita no local. Uma cópia movida para fora de seu worktree também é instruída a nunca editar, executar comandos em ou entrar naquele worktree, qualquer que seja a configuração de isolamento.

431

432Onde a cópia começa depende de onde a sessão atual está em execução:

433

434* Como qualquer sessão despachada, a cópia [se move para seu próprio worktree antes de editar arquivos](#how-file-edits-are-isolated). Nesse caso, a confirmação não menciona onde a cópia é executada.

435* Quando sua sessão se moveu para seu [worktree](/docs/pt/worktrees) vinculado após iniciar, a cópia começa de volta onde a sessão estava antes da movimentação e, a menos que [edite no local](#how-file-edits-are-isolated), faz suas alterações de código em um worktree próprio lá. Quando seu worktree está verificado em um branch, essa instrução também diz a uma cópia cuja tarefa se baseia em seu trabalho para basear seu novo branch no seu, já que seu branch permanece verificado em seu worktree. A confirmação termina com `runs in the origin tree`.

436* Quando você iniciou a sessão dentro de um worktree vinculado de um repositório que tem uma árvore de trabalho principal, a cópia começa naquela árvore de trabalho principal, com a mesma regra de worktree próprio, mas sem instrução de branch. A confirmação termina com `runs in the origin tree` aqui também.

437* Uma sessão iniciada dentro de um worktree de um layout de repositório bare não tem árvore de trabalho principal para retornar, portanto a cópia permanece onde está, e a confirmação termina com `edits this checkout`. A mesma nota aparece quando o isolamento de worktree está [desativado](#how-file-edits-are-isolated) em uma sessão que não está dentro de um worktree vinculado, porque a cópia então edita os arquivos que você tem abertos.

438

439Sessões iniciadas com flags de lançamento que a cópia não herdaria, como um prompt de sistema substituído ou uma allowlist `--tools`, não podem ser bifurcadas; Claude Code diz isso em vez de fazer uma cópia parcial. Uma sessão despachada a partir de agent view bifurca normalmente: a cópia é lançada com a mesma [definição de agente](/docs/pt/sub-agents) e instruções anexadas que a sessão da qual veio.

440

441<h4 id="what-carries-over-when-you-background">

442 What carries over when you background

443</h4>

444

445Colocar em background inicia um novo processo que retoma da conversa salva, e o trabalho em andamento se move para ele: comandos shell em background em execução, subagents em background, workflows dinâmicos, tarefas agendadas que você criou com [`/loop`](/docs/pt/scheduled-tasks) e [respostas automáticas de Claude a comentários de artefatos](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own) todos se transferem e continuam em execução lá. Um subagent se move junto com tudo que iniciou, portanto é transferido apenas quando todo esse trabalho pode se mover também. Para parar o trabalho em andamento em vez de transferi-lo, defina a variável de ambiente [`CLAUDE_DISABLE_ADOPT=1`](/docs/pt/env-vars#variables); Claude Code então pede que você confirme antes de colocar em background.

446

447Quando um [workflow dinâmico](/docs/pt/workflows) ainda tem subagents em execução, Claude Code pergunta antes de colocar em background com o diálogo `Background this session?`, que diz quantos subagents seriam reiniciados. Escolha `Stay` para deixá-los terminar primeiro. Se você confirmar, Claude Code reproduz a execução na sessão em background: subagents que ainda estavam em execução começam do início, portanto os tokens que usaram até agora são gastos novamente. Veja [Resume after a pause](/docs/pt/workflows#resume-after-a-pause) para saber quais subagents concluídos retornam seus resultados salvos e quais são executados novamente.

448

449Claude Code interrompe o trabalho que não pode ser transferido, como um [monitor](/docs/pt/tools-reference#monitor-tool) em execução, e interrompe um subagent em background que possui um monitor junto com ele. Quando algum desse trabalho está em execução, Claude Code mostra o diálogo `Background this session?` para que você possa confirmar antes de ser interrompido.

376 450

377Uma vez em background, a sessão pode iniciar novos subagents, monitors e comandos em background, e esses continuam em execução em desanexações e reanexações posteriores.451Uma vez em background, a sessão pode iniciar novos subagents, monitors e comandos em background, e esses continuam em execução em desanexações e reanexações posteriores.

378 452

385* `--fallback-model`459* `--fallback-model`

386* `--allow-dangerously-skip-permissions`460* `--allow-dangerously-skip-permissions`

387 461

388Diretórios que você adicionou durante a sessão com [`/add-dir`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) também são transferidos.462Diretórios que você adicionou durante a sessão com [`/add-dir`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) também são transferidos. Transferir `--allow-dangerously-skip-permissions` mantém `bypassPermissions` acessível na sessão colocada em background, mas não concede nada novo: o modo ainda requer a aceitação interativa única descrita em [Permission mode, model, and effort](#permission-mode-model-and-effort).

~~389~~

390Transferir `--allow-dangerously-skip-permissions` mantém `bypassPermissions` acessível na sessão colocada em background, mas não concede nada novo. O modo ainda requer a mesma aceitação interativa única descrita em [Permission mode, model, and effort](#permission-mode-model-and-effort) antes que qualquer sessão possa usá-lo.

391 463

392<h3 id="from-your-shell">464<h3 id="from-your-shell">

393 From your shell465 From your shell

399claude --bg "investigate the flaky SettingsChangeDetector test"471claude --bg "investigate the flaky SettingsChangeDetector test"

400```472```

401 473

402O prompt é o argumento posicional, não um valor `-p`. A partir da v2.1.198, combinar `--bg` com `-p` ou `--print` é rejeitado com um erro antes de qualquer sessão ser criada, porque `--print` nunca inicia a sessão interativa à qual `claude agents` se anexa.474O prompt é o argumento posicional, não um valor `-p`. Claude Code rejeita `--bg` combinado com `-p` ou `--print` antes de qualquer sessão ser criada, porque `--print` nunca inicia a sessão interativa à qual `claude agents` se anexa.

403 475

404Para executar um subagent específico como o agente principal da sessão, combine `--bg` com `--agent`:476Para executar um [subagent](/docs/pt/sub-agents) específico que você definiu, como um `code-reviewer`, como o agente principal da sessão, combine `--bg` com `--agent`:

405 477

406```bash theme={null}478```bash theme={null}

407claude --agent code-reviewer --bg "address review comments on PR 1234"479claude --agent code-reviewer --bg "address review comments on PR 1234"

408```480```

409 481

482Se o nome não corresponder a nenhum de seus subagents, o lançamento falha: Claude Code imprime um aviso `no agent named` e ainda relata a sessão como colocada em background, mas a sessão sai imediatamente com um erro `--agent '<name>' not found`.

483

484Quando a sessão colocada em background mais tarde retoma ou reinicia, Claude Code restaura o agente e suas restrições de ferramenta; para seu prompt de sistema, veja [System prompt flags in resumed conversations](/docs/pt/cli-reference#system-prompt-flags-in-resumed-conversations). Ele procura o agente no diretório da própria sessão primeiro, desde que você tenha [confiado naquele workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust), portanto um agente com escopo de projeto ainda carrega quando a sessão é retomada de outro diretório. Se o agente não existir mais, a sessão continua com as ferramentas padrão e sua transcrição abre com um [aviso nomeando o agente](/docs/pt/errors#session-agent-no-longer-available).

485

486Para continuar uma conversa existente em background, passe seu ID de sessão completo com `--resume`:

487

488```bash theme={null}

489claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

490```

491

492Em Claude Code v2.1.257 ou posterior, Claude Code continua aquela sessão sob o mesmo ID, ou inicia uma cópia sob um novo ID e imprime uma linha `note:` explicando por que não pôde continuar no local. Quando a sessão continua no local, `claude agents` mostra uma linha para ela.

493

494Quando você combina `--bg` com `--continue`, um `--resume` simples, ou `--resume` com um nome ou caminho de arquivo, Claude Code sempre inicia tal cópia. Adicione `--fork-session` para iniciar uma cópia propositalmente, sem a nota.

495

410Passe `--name` para definir o nome de exibição da sessão em agent view em vez do gerado automaticamente:496Passe `--name` para definir o nome de exibição da sessão em agent view em vez do gerado automaticamente:

411 497

412```bash theme={null}498```bash theme={null}

427 Run a shell command513 Run a shell command

428</h4>514</h4>

429 515

430Para executar um comando shell como um trabalho em background em vez de uma sessão Claude, digite `!` como o primeiro caractere da entrada de despacho de agent view. O `!` aparece como um prefixo e tudo que você digita após ele é o comando. O exemplo a seguir despacha `pytest -x` a partir da caixa de entrada de agent view:516Para executar um comando shell como um trabalho em background em vez de uma sessão Claude, passe `--exec`. O exemplo a seguir executa `pytest -x` como um trabalho em background:

~~431~~

432```text theme={null}

433! pytest -x

434```

~~435~~

436Pressione `Enter` para iniciar o trabalho. O mesmo trabalho também pode ser lançado diretamente do seu shell com `--exec`:

437 517

438```bash theme={null}518```bash theme={null}

439claude --bg --exec 'pytest -x'519claude --bg --exec 'pytest -x'

440```520```

441 521

522A partir de agent view, despache o mesmo tipo de trabalho digitando `!` como o primeiro caractere da entrada de despacho: o `!` aparece como um prefixo, tudo depois dele é o comando, e `Enter` inicia o trabalho.

523

442O comando é executado como um trabalho com suporte PTY e aparece como uma linha em agent view, com a linha de saída mais recente como seu status. Um trabalho shell executa o comando no lugar de Claude, portanto nenhum modelo é invocado e a saída não é enviada para nenhuma sessão.524O comando é executado como um trabalho com suporte PTY e aparece como uma linha em agent view, com a linha de saída mais recente como seu status. Um trabalho shell executa o comando no lugar de Claude, portanto nenhum modelo é invocado e a saída não é enviada para nenhuma sessão.

443 525

444Para ver a saída, anexe à linha, pressione `Space` para espreitar sem anexar, ou execute `claude logs <id>` do seu shell. A saída capturada permanece na memória e não é escrita em disco. A linha e sua saída são limpas automaticamente cerca de cinco minutos após o comando sair, portanto leia-a antes disso se precisar do resultado.526Para ver a saída, anexe à linha, pressione `Space` para espreitar sem anexar, ou execute `claude logs <id>` do seu shell. A saída capturada permanece na memória e não é escrita em disco. A linha e sua saída são limpas automaticamente cerca de cinco minutos após o comando sair, portanto leia-a antes disso se precisar do resultado.

447 How file edits are isolated529 How file edits are isolated

448</h3>530</h3>

449 531

450Toda sessão em background, seja iniciada a partir de agent view, `/bg` ou `claude --bg`, inicia no seu diretório de trabalho. Antes de editar arquivos, Claude move a sessão para um [git worktree](/docs/pt/worktrees) isolado sob `.claude/worktrees/`, para que sessões paralelas possam ler o mesmo checkout, mas cada uma escreve no seu próprio.532Toda sessão em background, seja iniciada a partir de agent view, `/bg` ou `claude --bg`, inicia no seu diretório de trabalho. Antes de editar arquivos, Claude move a sessão para um [git worktree](/docs/pt/worktrees) isolado sob `.claude/worktrees/`, para que sessões paralelas possam ler o mesmo checkout, mas cada uma escreve no seu próprio. Uma vez que a sessão está em seu worktree, Claude Code [aplica isolamento de worktree](/docs/pt/worktrees#how-claude-code-enforces-isolation) para a sessão e para qualquer subagent que ela gera.

451 533

452Claude pula o worktree quando:534Claude pula o worktree quando:

453 535

454* A sessão já está dentro de um git worktree vinculado, seja Claude o criou sob `.claude/worktrees/` ou você o criou com `git worktree add` em outro lugar536* A sessão já está dentro de um git worktree vinculado, seja Claude o criou sob `.claude/worktrees/` ou você o criou com `git worktree add` em outro lugar

537* O arquivo que Claude está editando está dentro de um git worktree vinculado, como um que a sessão ou seu subagent criou com `git worktree add`

455* O diretório de trabalho não é um repositório git e nenhum hook [`WorktreeCreate`](/docs/pt/hooks#worktreecreate) está configurado538* O diretório de trabalho não é um repositório git e nenhum hook [`WorktreeCreate`](/docs/pt/hooks#worktreecreate) está configurado

456* A escrita está fora do diretório de trabalho539* A escrita está fora do diretório de trabalho

457 540

458Para desativar o isolamento de worktree para um repositório onde git worktrees são impraticáveis, defina [`worktree.bgIsolation`](/docs/pt/settings#worktree-settings) como `"none"`. As sessões em background editam sua cópia de trabalho diretamente sem se mover para um worktree primeiro. Adicione a configuração ao `.claude/settings.json` do projeto:541Para desativar o isolamento de worktree para um repositório onde git worktrees são impraticáveis, defina [`worktree.bgIsolation`](/docs/pt/settings-reference#worktree-bgisolation) como `"none"`. As sessões em background editam sua cópia de trabalho diretamente sem se mover para um worktree primeiro. Adicione a configuração ao `.claude/settings.json` do projeto:

459 542

460```json theme={null}543```json theme={null}

461{544{

467 550

468Fora de um repositório git, as sessões escrevem no diretório de trabalho diretamente e não são isoladas uma da outra, portanto evite despachar sessões paralelas que editam os mesmos arquivos. Se você usar um sistema de controle de versão diferente, configure um hook [`WorktreeCreate`](/docs/pt/worktrees#non-git-version-control) e Claude isola edições da mesma forma que faz para git.551Fora de um repositório git, as sessões escrevem no diretório de trabalho diretamente e não são isoladas uma da outra, portanto evite despachar sessões paralelas que editam os mesmos arquivos. Se você usar um sistema de controle de versão diferente, configure um hook [`WorktreeCreate`](/docs/pt/worktrees#non-git-version-control) e Claude isola edições da mesma forma que faz para git.

469 552

470Quando o hook falha em um diretório que não é um repositório git, a sessão pula o isolamento para aquele diretório e edita o diretório de trabalho no local. Dentro de um repositório git, as escritas permanecem bloqueadas até que a sessão se isole. Antes da v2.1.203, uma sessão em background naquele estado não podia editar nenhum arquivo: toda escrita era rejeitada até que se isolasse, e o hook nunca podia isolar aquele diretório.553Quando o hook falha em um diretório que não é um repositório git, Claude pula o isolamento para aquele diretório e edita o diretório de trabalho no local. Dentro de um repositório git, Claude Code bloqueia escritas no checkout compartilhado até que Claude mova a sessão para um worktree.

~~471~~

472Deletar uma sessão remove ou mantém o worktree que Claude criou para ela, dependendo de como você a deleta e o que o worktree contém:

~~473~~

474* Deletar em agent view com `Ctrl+X` duas vezes remove o worktree, incluindo quaisquer alterações não confirmadas, portanto confirme as alterações que você quer manter primeiro.

475* Deletar do shell com [`claude rm`](#manage-sessions-from-the-shell) mantém um worktree que tem alterações não confirmadas, junto com sua linha de sessão.

476* Nenhum caminho remove um worktree com commits que não são enviados em nenhum lugar: o worktree é [mantido junto com sua sessão](#organize-the-list) e a saída nomeia o caminho mantido e o motivo.

477* Um worktree que você criou você mesmo e iniciou a sessão dentro é deixado no lugar de qualquer forma.

478 554

479Para encontrar o caminho do worktree de uma sessão, espreite a sessão ou anexe e verifique seu diretório de trabalho.555Para encontrar o caminho do worktree de uma sessão, espreite a sessão ou anexe e verifique seu diretório de trabalho.

480 556

481Um [subagent](/docs/pt/sub-agents) que a sessão em background gera herda o diretório de trabalho da sessão, portanto suas edições de arquivo chegam ao worktree da sessão em vez de sua cópia de trabalho. Para dar a um subagent seu próprio worktree separado, defina [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter ou passe `isolation: "worktree"` ao gerá-lo.557Um [subagent](/docs/pt/sub-agents) que a sessão em background gera herda o diretório de trabalho da sessão, portanto suas edições de arquivo chegam ao worktree da sessão em vez de sua cópia de trabalho. Para dar a um subagent seu próprio worktree separado, defina [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter ou passe `isolation: "worktree"` ao gerá-lo.

482 558

483A partir da v2.1.198, uma sessão em background que isolou suas alterações de código em um worktree também confirma, envia seu próprio branch e abre um pull request de rascunho sem parar para perguntar. O rótulo [`#N`](#pull-request-status) aparece em sua linha quando o pull request é aberto. Nunca envia para `main` ou `master`, nunca força-envia ou mescla, e pula o pull request quando você disse para não abrir um ou o repositório não tem um remoto.559Quando uma sessão em background fez alterações de código em um worktree que Claude entrou, Claude Code instrui Claude a preservar o trabalho antes de terminar, para que sobreviva se você deletar a sessão e seu worktree:

560

561* **Commit e push**: Claude faz commit sem perguntar, e faz push do branch quando o repositório tem um remoto.

562* **Draft pull request**: Claude abre um quando a tarefa pede, e o rótulo [`#N`](#pull-request-status) aparece na linha.

563* **Nunca**: fazer push para `main` ou `master`, force-push e mesclar.

564* **Suas instruções git têm precedência**: se a tarefa, `CLAUDE.md` ou [memory](/docs/pt/memory) diz que você lida com commit ou push você mesmo, Claude deixa git para você.

565

566Uma sessão editando um checkout que não isolou a si mesma ainda pergunta antes de fazer commit ou alternar branches. Isso se aplica quando o isolamento é definido como `"none"`, quando a movimentação do worktree falhou, ou quando a sessão foi iniciada dentro de um worktree que já existia.

567

568Qualquer que seja a tarefa, Claude termina o trabalho com um relatório dizendo o que fez e onde o trabalho está: um caminho, um branch, um pull request ou a resposta em si.

569

570<h4 id="what-deleting-a-session-removes">

571 What deleting a session removes

572</h4>

573

574Delete uma sessão com `Ctrl+X` duas vezes em [agent view](#organize-the-list) ou com [`claude rm`](#manage-sessions-from-the-shell). Exceto nos casos mantidos abaixo, a sessão sai da lista. Sua transcrição permanece em sua máquina através de `claude --resume`, e a remoção sobrevive a reinicializações do supervisor.

575

576O que acontece com um worktree que Claude criou para a sessão:

577

578* Agent view o remove, incluindo alterações não confirmadas, portanto confirme o que você quer manter primeiro.

579* `claude rm` o mantém, junto com a linha da sessão, quando tem alterações não confirmadas.

580* Nem agent view nem `claude rm` removem um worktree que outra sessão em execução está usando ou bloqueou, e deletar novamente não muda isso. Claude Code mantém o worktree e a sessão, e nomeia o diretório mantido e o motivo; em agent view, a linha da sessão mostra `not deleted`. Feche a outra sessão, depois delete novamente.

581* Quando você deleta uma sessão cujo worktree tem commits que Claude Code não pode confirmar que estão salvos em outro lugar, Claude Code mantém o worktree e a sessão, e a mensagem nomeia o branch do worktree e quantos commits não são enviados. A mensagem também oferece os dois caminhos adiante: fazer push dos commits ou deletar novamente para descartá-los.

582

583 Commits em um remoto não bloqueiam a deleção. Nem commits na cópia local do branch padrão do seu remoto `origin`, desde que aquele branch esteja verificado em seu checkout principal, o diretório do repositório em si em vez de um worktree.

584

585 Após aquela recusa, você escolhe:

586

587 * Para manter os commits, faça push deles ou mescle-os naquele branch padrão, depois delete a sessão novamente.

588 * Para descartá-los, delete a sessão novamente sem fazer push: pressione `Ctrl+X` duas vezes em sua linha em agent view, ou execute o comando `claude rm <id> --discard-unpushed` que a recusa imprimiu. Isso remove a sessão e o worktree junto com seu branch, descartando os commits não enviados e quaisquer alterações não confirmadas.

589

590 Quando você deleta novamente, Claude Code descarta apenas o que a recusa mostrou: se o worktree ganhou um commit desde então, Claude Code o mantém novamente e mostra o estado atualizado.

591

592 Quando os registros de outra sessão concluída também nomeiam o worktree, ele permanece quando você deleta novamente; faça push dos commits, depois delete novamente.

593* Um worktree que git não reconhece mais, por exemplo após `git worktree prune`, não bloqueia a deleção. Claude Code deleta a sessão e deixa o diretório em disco.

594* Quando git ou seu hook [`WorktreeRemove`](/docs/pt/hooks#worktreeremove) falha em remover o worktree, Claude Code mantém o worktree e a sessão, e a mensagem nomeia a causa. Para um hook, a mensagem diz como terminou, como `exited 1`, e cita o início de seu stderr. A mensagem também diz qual destes fazer a seguir:

595

596 * Delete a sessão novamente para remover o diretório mesmo assim, pressionando `Ctrl+X` duas vezes em sua linha em agent view ou executando o comando `claude rm <id> --force-remove-worktree <worktree-id>` que a recusa de `claude rm` imprimiu. Claude Code oferece isso apenas quando pode confirmar que o diretório é um dos worktrees vinculados do repositório sob `.claude/worktrees/` sem alterações não confirmadas em arquivos rastreados, sem repositório aninhado dentro dele e sem registro de outra sessão nomeando-o. O branch do worktree permanece no repositório.

597 * Corrija o que está no caminho, como fazer commit ou stash das alterações não confirmadas, fechar o que está usando o diretório ou corrigir o hook, depois delete a sessão novamente.

598 * Remova o diretório você mesmo, depois delete a sessão novamente.

599

600Um worktree que você criou você mesmo e iniciou a sessão dentro é deixado no lugar de qualquer forma.

484 601

485Uma sessão editando um checkout que não isolou a si mesma ainda pergunta antes de confirmar ou alternar branches. Isso se aplica quando o isolamento é definido como `"none"`, quando a movimentação do worktree falhou, ou quando a sessão foi iniciada dentro de um worktree que já existia.602Uma sessão cujo diretório de worktree não pertence a nenhum repositório git, porque o repositório foi deletado ou um hook [`WorktreeCreate`](/docs/pt/hooks#worktreecreate) criou o diretório em outro lugar, ainda pode ser deletada. Enquanto arquivos permanecem no diretório:

603

604* Agent view pede o mesmo duplo `Ctrl+X` antes de descartá-los. Para um diretório criado por hook, ele executa seu hook [`WorktreeRemove`](/docs/pt/hooks#worktreeremove) em vez disso, e sem um, ele recusa a deleção e mantém a sessão.

605* `claude rm` mantém a sessão e worktree, e nomeia o motivo.

606

607Qualquer caminho mantém um diretório que os registros de outra sessão concluída nomeiam.

486 608

487<h3 id="set-the-model">609<h3 id="set-the-model">

488 Set the model610 Set the model

489</h3>611</h3>

490 612

491O nome do modelo mostrado no cabeçalho de agent view é o padrão de despacho. Novas sessões que você inicia a partir da entrada usam este modelo, que vem da configuração [`model`](/docs/pt/settings#available-settings) em suas settings de usuário. Defina-o selecionando um modelo no seletor [`/model`](/docs/pt/model-config), ou edite a configuração diretamente.613O nome do modelo mostrado no cabeçalho de agent view é o padrão de despacho. Novas sessões que você inicia a partir da entrada usam este modelo, que vem da configuração [`model`](/docs/pt/settings-reference#model) em suas settings de usuário. Defina-o selecionando um modelo no seletor [`/model`](/docs/pt/model-config), ou edite a configuração diretamente.

492 614

493Para substituir o padrão de despacho para toda a sessão de agent view, passe `--model` ao abrir agent view. Veja [Permission mode, model, and effort](#permission-mode-model-and-effort).615Para substituir o padrão de despacho para toda a sessão de agent view, passe `--model` ao abrir agent view. Veja [Permission mode, model, and effort](#permission-mode-model-and-effort).

494 616

511 Permission mode, model, and effort633 Permission mode, model, and effort

512</h3>634</h3>

513 635

514Uma sessão em background lê suas [settings](/docs/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá. Isso inclui valores [`env`](/docs/pt/settings#available-settings) em settings de projeto, portanto uma `ANTHROPIC_MODEL` ou variável de provedor definida lá se aplica a sessões em background naquele diretório.636Uma sessão em background leva suas settings, provedor, permission mode, modelo e esforço de onde e como você a despachou. As subseções abaixo cobrem cada fonte e o que persiste quando o supervisor reinicia a sessão.

637

638<h4 id="settings-and-provider">

639 Settings and provider

640</h4>

641

642Uma sessão em background lê suas [settings](/docs/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá. Isso inclui valores [`env`](/docs/pt/settings-reference#env) em settings de projeto, portanto uma `ANTHROPIC_MODEL` ou variável de provedor definida lá se aplica a toda sessão em background naquele diretório.

643

644Uma sessão em background também é executada com o `PATH` do shell a partir do qual você a despachou, portanto os comandos que ela executa encontram as mesmas ferramentas que seu terminal faz. Ela mantém a seleção de provedor de nuvem daquele shell também, como `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, junto com seus aliases `ANTHROPIC_DEFAULT_*_MODEL` e qualquer substituição [`CLAUDE_CODE_EXTRA_BODY`](/docs/pt/env-vars) que você exportou lá.

645

646<h4 id="llm-gateway">

647 LLM gateway

648</h4>

649

650Se você rotear Claude Code através de um [LLM gateway](/docs/pt/llm-gateway), coloque as variáveis de gateway em um bloco `env` de um arquivo de settings em vez de exportá-las em seu shell, e as sessões em background as leem com o resto de suas settings. [Set in a settings file](/docs/pt/llm-gateway-connect#set-in-a-settings-file) mostra o bloco e qual arquivo de settings usar para a credencial.

515 651

516A seleção de provedor de nuvem, como `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, e aliases `ANTHROPIC_DEFAULT_*_MODEL` seguem o shell que despachou a sessão. Se você exportar uma substituição de corpo de solicitação [`CLAUDE_CODE_EXTRA_BODY`](/docs/pt/env-vars) naquele shell, ela alcança a sessão da mesma forma. Antes da v2.1.206, workers em background ignoravam um `CLAUDE_CODE_EXTRA_BODY` exportado pelo shell.652Se você exportar um gateway `ANTHROPIC_BASE_URL` apenas em seu shell em vez disso, ele alcança uma sessão em background, junto com o `ANTHROPIC_CUSTOM_HEADERS` e credencial que você exportou com ele, apenas quando o [supervisor](#the-supervisor-process) foi ele próprio iniciado a partir de um shell que exportou o mesmo gateway, e apenas nestes casos:

517 653

518Se você exportar um gateway `ANTHROPIC_BASE_URL` no shell de despacho, ele alcança a sessão também, junto com `ANTHROPIC_CUSTOM_HEADERS`, quando o supervisor é executado com o mesmo ambiente de gateway e a sessão é executada no diretório a partir do qual você despacha ou é sua própria sessão colocada em background com `←` ou `/background`. Esse é o caso normal quando o primeiro shell a abrir agent view ou despachar uma sessão em background é o shell de gateway. Despachar para um diretório diferente com `@repo` ou `--cwd` não carrega o gateway do shell; as [settings](/docs/pt/settings) daquele projeto fornecem o endpoint. Veja [o processo supervisor](#the-supervisor-process) para como sessões em background obtêm configurações de provedor e credenciais.654* Você coloca sua própria sessão em background com `←` ou `/background`

655* Você despacha uma sessão para o diretório em que está

656* Você acorda uma sessão parada no diretório em que está anexando ou respondendo a ela

519 657

520O [permission mode](/docs/pt/permissions) depende de como você iniciou a sessão. Colocar em background uma sessão existente com `/bg` ou `←` mantém o permission mode atual, portanto uma sessão que você alterou para `acceptEdits` ou `auto` permanece naquele modo após desanexar. Despachar a partir da entrada de agent view ou executar `claude --bg` do seu shell usa o `defaultMode` das settings daquele diretório, ou o `permissionMode` do [frontmatter do subagent despachado](/docs/pt/sub-agents#supported-frontmatter-fields).658Claude Code encaminha um gateway na frente de um provedor de nuvem. Se o shell a partir do qual você despacha seleciona o provedor e exporta seu endpoint de gateway com seu flag de bypass de auth, Claude Code encaminha o par endpoint-e-flag para a sessão sob as condições que se aplicam a `ANTHROPIC_BASE_URL`, junto com `ANTHROPIC_CUSTOM_HEADERS`. Por exemplo, exporte `CLAUDE_CODE_USE_VERTEX=1` com `ANTHROPIC_VERTEX_BASE_URL` e `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, e Claude Code encaminha aquele endpoint e flag.

521 659

522O permission mode, modelo e esforço com os quais uma sessão em background foi iniciada, juntamente com os [flags de configuração que ela carrega](#from-inside-a-session), todos persistem quando o supervisor posteriormente [para e reinicia](#the-supervisor-process) seu processo. Uma sessão que você lançou com `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` permanece em `bypassPermissions` após esse reinício em vez de voltar ao `defaultMode` do diretório, e um modelo ou esforço que você alterou no meio da sessão com `/model` ou `/effort` é mantido.660Claude Code aplica um gateway encaminhado apenas ao processo em execução daquela sessão e nunca o escreve em disco.

523 661

524Um esforço que a sessão obteve da configuração [`effortLevel`](/docs/pt/settings#available-settings) em vez de `--effort` ou `/effort` não é fixado no despacho: cada processo iniciado para a sessão lê a configuração novamente, portanto editar `effortLevel` em `settings.json` alcança sessões que você coloca em background com `←` ou `/bg` e seus reinícios posteriores. Antes da v2.1.203, colocar uma sessão em background registrava seu esforço derivado de settings como se você tivesse passado `--effort`, portanto edições posteriores de `effortLevel` nunca o alcançavam.662<h4 id="permission-mode">

663 Permission mode

664</h4>

665

666O [permission mode](/docs/pt/permissions) depende de como você iniciou a sessão:

667

668* **Colocada em background com `/bg` ou `←`**: Claude Code mantém o permission mode em que a sessão estava, portanto uma que você alterou para `acceptEdits` ou `auto` permanece lá após desanexar

669* **Despachada a partir de um agent view que você abriu com `←`**: a configuração do alvo vem primeiro, e o permission mode da sessão da qual você veio se aplica quando nada mais define um

670* **Despachada a partir de `claude agents` iniciado em um shell, ou com `claude --bg`**: a nova sessão começa da forma que uma nova sessão `claude` naquele diretório começaria, a menos que você a tenha despachado a partir de um agent view que você abriu com [dispatch defaults](#dispatch-defaults). [Which permission mode a session starts in](/docs/pt/permission-modes#which-mode-a-session-starts-in) lista a ordem

671

672Para uma sessão que você despacha a partir de um agent view aberto com `←`, Claude Code leva o permission mode do primeiro destes que se aplica:

673

6741. O [`permissions.defaultMode`](/docs/pt/settings-reference#permissions-defaultmode) do diretório alvo. Duas regras de fonte se aplicam:

675 * `auto` e `bypassPermissions` [têm efeito apenas a partir de settings gerenciadas, um arquivo `--settings` ou `~/.claude/settings.json`](/docs/pt/settings-reference#permissions-defaultmode).

676 * Claude Code recusa um `defaultMode` do `.claude/settings.json` ou `.claude/settings.local.json` do projeto que seleciona um modo mais permissivo que o permission mode em que a sessão da qual você veio estava.

6772. O permission mode da sessão da qual você veio

525 678

526Um nome que você definiu com [`/rename`](/docs/pt/commands) ou `Ctrl+R` também persiste nesse reinício, portanto [`claude --resume <name>`](/docs/pt/sessions#name-your-sessions) ainda resolve a sessão. Antes da v2.1.202, o reinício revertia a sessão para o nome com o qual foi despachada e o novo nome parava de resolver.679Quando Claude Code recusa o modo de uma fonte como muito permissivo, a próxima fonte na lista decide. Por exemplo, se você despacha a partir de uma sessão em plan mode para um diretório cujas settings verificadas pedem `acceptEdits`, a nova sessão começa em plan mode. Se você mover aquele `defaultMode` para `~/.claude/settings.json`, ele se aplica independentemente do permission mode da sessão da qual você veio.

680

681Permissividade corre plan, depois Manual e `dontAsk`, depois `acceptEdits` e auto, que cada um conta como mais permissivo que o outro, depois `bypassPermissions`.

682

683<h4 id="dispatch-defaults">

684 Dispatch defaults

685</h4>

527 686

528Para definir padrões para cada sessão que você despacha a partir de agent view, passe qualquer um de `--permission-mode`, `--model`, `--effort` ou `--agent` ao abri-lo:687Para definir padrões para cada sessão que você despacha a partir de agent view, passe qualquer um de `--permission-mode`, `--model`, `--effort` ou `--agent` ao abri-lo:

529 688

531claude agents --permission-mode plan --model opus --effort high690claude agents --permission-mode plan --model opus --effort high

532```691```

533 692

534`--agent` define o [subagent](/docs/pt/sub-agents) usado quando um prompt de despacho não nomeia um, seja com `@name` ou como a primeira palavra. O padrão é a configuração [`agent`](/docs/pt/settings#available-settings) se uma estiver definida, caso contrário o agente `claude` integrado catch-all. Nomear um subagent na entrada de despacho substitui ambos.693`--effort` aqui aceita os mesmos valores que o [flag `--effort` de nível superior](/docs/pt/cli-reference#cli-flags), incluindo `ultracode`.

694

695`--agent` define o [subagent](/docs/pt/sub-agents) usado quando um prompt de despacho não nomeia um, seja com `@name` ou como a primeira palavra. O padrão é a configuração [`agent`](/docs/pt/settings-reference#agent) se uma estiver definida, caso contrário o agente `claude` integrado catch-all. Nomear um subagent na entrada de despacho substitui ambos.

535 696

536`claude agents` também aceita `--dangerously-skip-permissions` como abreviação para `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` para tornar `bypassPermissions` disponível no ciclo `Shift+Tab` de cada sessão despachada sem iniciar naquele modo. Ambos correspondem aos [flags CLI de nível superior](/docs/pt/cli-reference).697`claude agents` também aceita `--dangerously-skip-permissions` como abreviação para `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` para tornar `bypassPermissions` disponível no ciclo `Shift+Tab` de cada sessão despachada sem iniciar naquele modo. Ambos correspondem aos [flags CLI de nível superior](/docs/pt/cli-reference).

537 698

699Passe `--restricted` para iniciar cada sessão que você despacha a partir da visualização em [restricted mode](/docs/pt/cli-reference#cli-flags), como se cada uma fosse lançada com o flag de nível superior `--restricted`. Requer Claude Code v2.1.248 ou posterior.

700

538Os padrões ativos aparecem no rodapé abaixo da entrada de despacho.701Os padrões ativos aparecem no rodapé abaixo da entrada de despacho.

539 702

540Sem essas flags, a sessão usa o `defaultMode` das settings daquele diretório ou o `permissionMode` do [frontmatter do subagent despachado](/docs/pt/sub-agents#supported-frontmatter-fields), e o modelo mostrado no cabeçalho de agent view.703Claude Code recusa `claude --bg --permission-mode bypassPermissions` até que você tenha aceitado o aviso de bypass executando `claude --dangerously-skip-permissions` uma vez interativamente, já que esse modo permite que uma sessão que você não está observando aja sem aprovação. Passar `--dangerously-skip-permissions` ou `--permission-mode bypassPermissions` para `claude agents` mostra o mesmo aviso quando você não o aceitou antes, e aceitar aplica `bypassPermissions` às sessões que você inicia a partir da visualização. Passar `--allow-dangerously-skip-permissions` mostra o mesmo aviso também, e aceitar torna `bypassPermissions` disponível no ciclo `Shift+Tab` dessas sessões sem iniciá-las nele.

704

705<h4 id="what-persists-across-restarts">

706 What persists across restarts

707</h4>

708

709O permission mode, modelo e esforço que você escolheu para uma sessão em background, junto com os [flags de configuração que ela carrega](#what-carries-over-when-you-background), todos persistem quando o supervisor mais tarde [para e reinicia](#the-supervisor-process) seu processo. Uma sessão que você lançou com `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` permanece em `bypassPermissions` após aquele reinício. Um modelo ou esforço que você alterou no meio da sessão com `/model` ou `/effort` é mantido também.

710

711Se a sessão levou seu esforço de suas settings em vez de `--effort` ou `/effort`, Claude Code lê suas settings novamente cada vez que inicia um processo para a sessão. Depois que você edita o esforço salvo em `settings.json`, a mudança alcança sessões que você coloca em background com `←` ou `/bg`, e seus reinícios posteriores. O esforço salvo é a chave [`effortLevel`](/docs/pt/settings-reference#effortlevel) ou uma entrada [`modelSettings`](/docs/pt/settings-reference#modelsettings).

541 712

542Usar `bypassPermissions` com `claude --bg --permission-mode` é recusado até que você tenha aceitado o aviso de bypass executando `claude --dangerously-skip-permissions` uma vez interativamente, já que esse modo permite que uma sessão que você não está observando aja sem aprovação. Passar `--dangerously-skip-permissions` ou `--permission-mode bypassPermissions` para `claude agents` mostra o mesmo aviso quando você não o aceitou antes, e aceitar aplica `bypassPermissions` às sessões que você inicia a partir da visualização. Passar `--allow-dangerously-skip-permissions` mostra o mesmo aviso também, e aceitar torna `bypassPermissions` disponível no ciclo `Shift+Tab` dessas sessões sem iniciá-las nele.713Claude Code também mantém um nome que você definiu com [`/rename`](/docs/pt/commands) ou `Ctrl+R` através daquele reinício, portanto você ainda pode executar [`claude --resume <name>`](/docs/pt/sessions#name-your-sessions) para alcançar a sessão.

714

715Um prompt que você guardou com [`Ctrl+S`](/docs/pt/interactive-mode#general-controls) enquanto anexado é mantido com a sessão também. Reabra a sessão após seu processo ter sido parado ou reiniciado, e `Ctrl+S` restaura o texto guardado. Conteúdo colado no guarda não sobrevive ao reinício.

543 716

544<h3 id="settings-plugins-and-mcp-servers">717<h3 id="settings-plugins-and-mcp-servers">

545 Settings, plugins, and MCP servers718 Settings, plugins, and MCP servers

546</h3>719</h3>

547 720

548Agent view aceita os mesmos flags de configuração que `claude` para carregar settings, plugins, servidores MCP e diretórios adicionais. Cada flag se aplica a agent view em si e é passado para cada sessão que você despacha a partir dele, portanto um plugin ou servidor MCP que você carrega desta forma está disponível nessas sessões também.721Agent view aceita os mesmos flags de configuração que `claude` para carregar settings, plugins, servidores MCP e diretórios adicionais. Agent view aplica `--settings` e `--plugin-dir` a si mesmo e passa cada flag de configuração para as sessões que você despacha a partir dele, portanto um plugin ou servidor MCP que você carrega desta forma está disponível nessas sessões.

549 722

550| Flag | Efeito |723| Flag | Efeito |

551| :----------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- |724| :----------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

553| [`--add-dir <path>`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) | Conceder acesso a arquivo a um diretório adicional |726| [`--add-dir <path>`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) | Conceder acesso a arquivo a um diretório adicional |

556| `--strict-mcp-config` | Usar apenas os servidores MCP de `--mcp-config`, ignorando outra configuração MCP |729| `--strict-mcp-config` | Usar apenas os servidores MCP de `--mcp-config`, ignorando outra configuração MCP. Veja [Exclusive control with managed-mcp.json](/docs/pt/managed-mcp#exclusive-control-with-managed-mcp-json) para o que o flag faz sob um arquivo MCP gerenciado |

730

731Repita `--add-dir`, `--plugin-dir` ou `--mcp-config` uma vez por valor. `claude agents` não suporta a forma separada por espaço, como `--add-dir a b c`.

557 732

558Repita `--add-dir`, `--plugin-dir` ou `--mcp-config` uma vez por valor. A forma separada por espaço, como `--add-dir a b c`, não é suportada com `claude agents`.733Você pode colocar `--settings` e `--plugin-dir` antes ou depois de `agents`. Mantenha `--add-dir` e `--mcp-config` após `agents`: se você colocar qualquer um antes de `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) falha com um erro `unknown option`.

559 734

560O exemplo a seguir abre agent view com uma substituição de settings e um diretório extra:735O exemplo a seguir abre agent view com uma substituição de settings e um diretório extra:

561 736

563claude agents --settings ./ci-settings.json --add-dir ../shared-lib738claude agents --settings ./ci-settings.json --add-dir ../shared-lib

564```739```

565 740

741`--settings` aceita um caminho de arquivo ou uma string JSON inline. Um caminho de arquivo deve apontar para um arquivo existente; Claude Code sai com um erro `Settings file not found` se não apontar.

742

566<h2 id="manage-sessions-from-the-shell">743<h2 id="manage-sessions-from-the-shell">

567 Gerenciar sessões do shell744 Gerenciar sessões do shell

568</h2>745</h2>

570Cada sessão em background tem um ID curto que você pode usar do shell. O ID é impresso quando você inicia uma sessão com `claude --bg`, e o ID de cada sessão é seu nome de diretório em `~/.claude/jobs/`. Esses comandos são úteis para scripts ou quando você não quer abrir agent view.747Cada sessão em background tem um ID curto que você pode usar do shell. O ID é impresso quando você inicia uma sessão com `claude --bg`, e o ID de cada sessão é seu nome de diretório em `~/.claude/jobs/`. Esses comandos são úteis para scripts ou quando você não quer abrir agent view.

571 748

572| Comando | Propósito |749| Comando | Propósito |

573| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |750| :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

576| `claude agents --json` | Imprimir sessões ativas como um array JSON e sair: cada sessão ativa, mais sessões em background que ainda estão funcionando ou bloqueadas mesmo quando seu processo saiu. Adicione `--all` para também incluir sessões em background concluídas. Cada entrada tem `cwd`, `kind` e `startedAt`. Entradas em background também têm `id`, utilizável com `claude attach`/`logs`/`stop`, e `state`: um de `working`, `blocked`, `done`, `failed` ou `stopped`. `pid` e `status` estão presentes apenas enquanto o processo está ativo, mais `waitingFor` quando status é `waiting`, que diz no que a sessão está bloqueada, como `permission prompt` ou `input needed`; `sessionId` e `name` aparecem quando definidos. Uma entrada interativa que você nunca nomeou carrega um `name` padrão construído a partir do nome do diretório de trabalho mais um sufixo de dois caracteres, como `my-app-3f`. Combine com `--cwd <path>` para filtrar |753| `claude agents --json` | Imprimir sessões como um array JSON e sair. Veja [Listar sessões como JSON](#list-sessions-as-json) |

580| `claude respawn <id>` | Reiniciar uma sessão, em execução ou interrompida, com sua conversa intacta, por exemplo, para usar um binário Claude Code atualizado |757| `claude respawn <id>` | Reiniciar uma sessão, em execução ou interrompida, por exemplo, para usar um binário Claude Code atualizado. A sessão reiniciada retoma sua conversa salva; quando nenhuma está no disco, ela executa seu prompt original novamente como uma nova conversa |

581| `claude respawn --all` | Reiniciar cada sessão em execução, por exemplo, para mover todas as sessões para um binário Claude Code atualizado de uma vez |758| `claude respawn --all` | Reiniciar cada sessão em execução, por exemplo, para mover todas as sessões para um binário Claude Code atualizado de uma vez |

582| `claude rm <id>` | Remover uma sessão da lista. Remove um worktree que Claude criou para a sessão se não houver alterações não confirmadas e nenhum commit que não seja enviado em nenhum lugar; caso contrário, a sessão também é mantida e o comando imprime o caminho do worktree e o motivo para que você possa resolvê-lo e executar `claude rm` novamente. Deixa um worktree que você criou por conta própria no lugar. A transcrição da conversa permanece em sua máquina local e continua disponível através de `claude --resume` |759| `claude rm <id>` | Remover uma sessão da lista, junto com um worktree que Claude criou para ela quando é seguro deletar; veja [O que deletar uma sessão remove](#what-deleting-a-session-removes). A transcrição da conversa permanece em sua máquina local e continua disponível através de `claude --resume` |

760| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | Deletar uma sessão cuja exclusão foi recusada sobre commits não enviados, descartando o worktree junto com seu branch e commits. Passe o valor exato que a recusa imprimiu; veja [O que deletar uma sessão remove](#what-deleting-a-session-removes). Requer v2.1.260 ou posterior |

761| `claude rm <id> --force-remove-worktree <worktree-id>` | Deletar uma sessão cuja exclusão foi recusada porque git ou o hook `WorktreeRemove` não conseguiu remover seu worktree, deletando o diretório worktree mesmo assim e deixando seu branch no repositório. Passe o valor exato que a recusa imprimiu; veja [O que deletar uma sessão remove](#what-deleting-a-session-removes). Requer v2.1.268 ou posterior |

583| `claude daemon status` | Imprimir o estado do [supervisor](#the-supervisor-process), versão, diretório de socket e contagem de workers |762| `claude daemon status` | Imprimir o estado do [supervisor](#the-supervisor-process), versão, diretório de socket e contagem de workers |

584| `claude daemon stop --any` | Parar o processo supervisor e as sessões em background que ele hospeda. Passe `--keep-workers` para deixar as sessões em background em execução para que o próximo supervisor se reconecte a elas. O próximo `claude agents` ou `claude --bg` inicia um novo supervisor |763| `claude daemon stop --any` | Parar o processo supervisor e as sessões em background que ele hospeda. Passe `--keep-workers` para deixar as sessões em background em execução para que o próximo supervisor se reconecte a elas. O próximo `claude agents` ou `claude --bg` inicia um novo supervisor |

585 764

586<h2 id="how-background-sessions-are-hosted">765<h3 id="list-sessions-as-json">

587 Como as sessões em background são hospedadas766 Listar sessões como JSON

588</h2>

~~589~~

590Toda sessão listada na visualização de agente é considerada uma sessão em background, independentemente de você estar atualmente anexado a ela. Em contraste, uma sessão iniciada executando `claude` diretamente está vinculada a esse terminal e termina quando ele fecha, a menos que você [a envie para o background](#from-inside-a-session).

~~591~~

592<h3 id="the-supervisor-process">

593 O processo supervisor

594</h3>767</h3>

595 768

596Sessões em background são hospedadas por um processo supervisor por usuário, separado do seu terminal e da visualização de agente. O supervisor é iniciado automaticamente na primeira vez que você coloca uma sessão em background ou abre a visualização de agente, e você não o gerencia diretamente.769`claude agents --json` imprime sessões ativas como um array JSON e sai: cada sessão ativa, mais sessões em background que ainda estão funcionando ou bloqueadas mesmo quando seu processo saiu. Adicione `--all` para também incluir sessões em background concluídas, e `--cwd <path>` para limitar a lista a sessões iniciadas sob esse diretório.

~~597~~

598Quando uma atualização substituiu ou removeu o binário do qual um processo Claude Code em execução foi iniciado, esse processo inicia o supervisor a partir de outra cópia instalada, como o launcher `claude` instalado ou a versão mais recente no disco.

~~599~~

600O supervisor mantém um processo worker pré-aquecido pronto para que um dispatch da visualização de agente ou `claude --bg` seja iniciado sem o atraso de um cold launch. Quando você faz um dispatch, o supervisor atribui o worker pré-aquecido à sua sessão, aplica o diretório, configurações e credenciais dessa sessão a ele e, em seguida, inicia um substituto para o próximo dispatch. Se nenhum worker pré-aquecido saudável estiver disponível, o supervisor inicia um novo processo.

601 770

602O supervisor e suas sessões se autenticam com as mesmas credenciais armazenadas que suas sessões interativas e não fazem conexões de rede adicionais além da API do modelo. Variáveis de seleção de provedor, como `CLAUDE_CODE_USE_BEDROCK` e aliases `ANTHROPIC_DEFAULT_*_MODEL`, são lidas do shell que fez dispatch de cada sessão e são aplicadas ao seu worker.771Cada entrada descreve uma sessão:

603 772

604O `PATH` do shell de dispatch é aplicado ao worker da mesma forma, então comandos de shell que a sessão executa encontram as mesmas ferramentas que seu terminal faz. Antes da v2.1.203, uma sessão em background mantinha o `PATH` do shell que primeiro iniciou o supervisor, então ferramentas adicionadas ao seu `PATH` desde então poderiam estar faltando, mais frequentemente no Windows.773| Campo | Presente | Descrição |

774| :------------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

775| `cwd`, `kind`, `startedAt` | Sempre | O diretório de trabalho, `interactive` ou `background`, e a hora de início em milissegundos Unix |

776| `id` | Sessões em background | ID curto, utilizável com `claude attach`, `claude logs` e `claude stop` |

777| `state` | Sessões em background | Um de `working`, `blocked`, `done`, `failed` ou `stopped`. Veja [Ler estado da sessão de um script](#read-session-state-from-a-script) para o que cada valor significa |

778| `pid`, `status` | Enquanto o processo está vivo | ID do processo e um de `busy`, `waiting` ou `idle` |

779| `waitingFor` | Quando `status` é `waiting` | No que a sessão está bloqueada: `permission prompt` para uma aprovação, `input needed` para uma pergunta do Claude ou uma solicitação de entrada de um servidor MCP, `sandbox request`, `worker request` ou `dialog open` |

780| `sessionId`, `name` | Quando definido | `sessionId` é o UUID completo da sessão, utilizável com [`claude --resume`](/docs/pt/sessions). O `name` de uma sessão interativa é seu [nome de exibição padrão](/docs/pt/sessions#name-your-sessions) até que você nomeie a sessão ou aceite um plano nela |

605 781

606Uma sessão em background não herda variáveis de endpoint de gateway, como `ANTHROPIC_BASE_URL` ou as variáveis de URL base equivalentes do Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, do shell que iniciou o supervisor. Sem um gateway exportado no shell do qual você faz dispatch, a sessão usa suas credenciais armazenadas e quaisquer valores `env` no [settings](/docs/pt/settings) do diretório do projeto. Para apontar cada sessão em um projeto para um [gateway LLM](/docs/pt/llm-gateway), defina `ANTHROPIC_BASE_URL` no bloco `env` do `settings.json` do `.claude/` desse projeto.782<h3 id="read-session-state-from-a-script">

~~607~~ 783 Ler estado da sessão de um script

608Se você exportar um gateway `ANTHROPIC_BASE_URL` no shell do qual você faz dispatch, ele chega ao worker dessa sessão. `ANTHROPIC_CUSTOM_HEADERS` e a credencial exportada junto com eles são encaminhados com ele. Isso acontece quando o supervisor foi iniciado a partir de um ambiente com o mesmo gateway. O supervisor captura seu ambiente do primeiro shell que abre a visualização de agente ou faz dispatch de uma sessão em background, então começar a partir do shell do gateway lhe dá esse ambiente. O encaminhamento também se aplica apenas a sessões despachadas para o diretório do qual você está fazendo dispatch, ou colocadas em background de sua própria sessão com `←` ou `/background`: fazer dispatch para um diretório diferente com `@repo` ou `--cwd` não carrega o gateway do shell, e o bloco `env` do `settings.json` desse projeto fornece o endpoint. Quando o ambiente do supervisor carrega um gateway diferente ou nenhum, o worker mantém suas credenciais armazenadas contra o endpoint padrão em vez de misturar a credencial de um ambiente com o endpoint de outro. Antes da v2.1.203, o `ANTHROPIC_BASE_URL` do shell de dispatch era descartado enquanto a `ANTHROPIC_API_KEY` exportada junto com ele era mantida, então a chave do gateway era enviada para o endpoint padrão e cada solicitação falhava com um 401.784</h3>

~~609~~

610O endpoint encaminhado se aplica apenas a esse processo ativo e nunca é escrito no disco. Quando o supervisor interrompe uma sessão inativa e depois a reinicia, o processo reiniciado lê seu endpoint de suas configurações novamente: com um `ANTHROPIC_AUTH_TOKEN` do gateway, ele volta para suas credenciais armazenadas, e com uma `ANTHROPIC_API_KEY` emitida pelo gateway, pode falhar ao autenticar até que o gateway seja definido nas configurações.

~~611~~

612Cada sessão em background é seu próprio processo Claude Code, gerenciado pelo supervisor em vez de estar vinculado ao seu terminal. Uma sessão que está ativamente funcionando, aguardando sua entrada ou tem um terminal anexado mantém seu processo em execução. Um comando de shell em background em execução, subagent, workflow dinâmico ou monitor conta como trabalho ativo, então um processo de longa duração, como um servidor de desenvolvimento, mantém a sessão ativa.

613 785

614Depois que uma sessão termina e fica desanexada por cerca de uma hora, o supervisor interrompe seu processo para liberar recursos. Uma sessão que você [fixou](#organize-the-list) com `Ctrl+T` é isenta e mantém seu processo em execução enquanto inativo. O transcript e o estado permanecem no disco de qualquer forma, e na próxima vez que você anexar, espreitar ou responder a uma sessão parada, o supervisor inicia um novo processo de onde parou. Quando cada sessão terminou e nenhum terminal está conectado, o supervisor em si sai e é iniciado novamente na próxima vez que você precisar dele.786`claude agents --json` é a forma suportada de ler estado da sessão de fora do Claude Code, por exemplo de uma barra de status, um agendador ou outra sessão Claude que supervisiona trabalho em background. Pesquise `claude agents --json --all`, que continua listando sessões cujo processo saiu, e leia `state`, `status` e `waitingFor` de cada entrada.

615 787

616O trabalho em background que a sessão iniciou no nível superior é entregue quando seu processo é interrompido, reiniciado ou atualizado, incluindo no Windows. O próximo processo iniciado para essa sessão retoma o trabalho:788| `state` | O que significa |

789| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

790| `working` | Um turno está em execução, ou a sessão está entre etapas de trabalho que ela conduz por conta própria, como uma iteração de [`/loop`](/docs/pt/scheduled-tasks) ou uma espera em CI. `status` diz se seu processo está `busy` agora |

791| `blocked` | A sessão está esperando por você: uma pergunta que fez, uma decisão de permissão ou sandbox, um erro que apenas você pode limpar como um login expirado, ou seu primeiro prompt se você o iniciou sem um. Quando a espera é um prompt aberto em um processo ativo, `waitingFor` o nomeia |

792| `done` | O último turno terminou o que você pediu e a sessão está pronta para seu próximo prompt, independentemente de seu processo ainda estar vivo |

793| `failed`, `stopped` | A tarefa terminou com um erro, ou a sessão foi interrompida |

617 794

618* Um comando de shell em background que terminou no meio é relatado como concluído com sua saída795Uma sessão que terminou seu turno e está esperando sua próxima instrução lê `done`, não `blocked`. `blocked` sempre significa que a sessão precisa de algo de você antes de continuar.

619* Um workflow dinâmico retoma de onde parou

620* Um [subagent em background](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) retoma de seu próprio transcript

621 796

622A partir da v2.1.198, a entrega cobre todos os três. Antes da v2.1.198, cobria apenas comandos de shell e workflows, então um subagent em background parava com o processo e era relatado como falho no próximo despertar.797Os arquivos em `~/.claude/jobs/<id>/` não são uma interface estável. Valores que uma sessão ou outro programa escreve em `state`, `detail`, `tempo` ou `needs` são substituídos na próxima atualização.

623 798

624O trabalho cujo estado vive apenas dentro do próprio processo para com ele em vez de ser entregue. Isso inclui comandos de shell que um subagent iniciou, que o subagent retomado pode iniciar novamente, e [monitors](/docs/pt/tools-reference#monitor-tool) em execução, cujo fluxo de eventos não pode ser movido para outro processo.799Se você quer que uma sessão relate progresso em suas próprias palavras, faça-a escrever um arquivo próprio, por exemplo em `$CLAUDE_JOB_DIR/tmp`, em vez de editar `state.json`.

625 800

626Deletar a sessão interrompe tudo que ela entregou. Para parar todo o trabalho em background da sessão com o processo em vez de entregá-lo, defina a variável de ambiente [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/pt/env-vars#variables) como `1`.801<h2 id="how-background-sessions-are-hosted">

802 Como as sessões em background são hospedadas

803</h2>

627 804

628Um processo reiniciado encontra a conversa de uma sessão que [se moveu para uma worktree](#how-file-edits-are-isolated) no meio da tarefa: quando o transcript não está onde a sessão começou, Claude Code também procura sob as worktrees registradas do repositório. Antes da v2.1.207, reabrir essa sessão da visualização de agente após seu processo ter parado poderia mostrar uma conversa vazia com apenas seu prompt original, com o transcript ainda intacto no disco; abrir a sessão novamente na v2.1.207 ou posterior a recupera.805Claude Code trata cada sessão listada na visualização de agente como uma sessão em background, independentemente de você estar atualmente anexado a ela. Em contraste, uma sessão iniciada executando `claude` diretamente está vinculada a esse terminal e termina quando ele fecha, a menos que você [a envie para o background](#from-inside-a-session).

629 806

630Se uma sessão reiniciada volta mostrando apenas seu prompt original porque Claude Code leu mal seu transcript como vazio, o transcript de conversa é renomeado com um sufixo `.orphaned-` em vez de ser deletado, portanto permanece em sua máquina.807Para verificar que tipo de sessão você está, execute [`/status`](/docs/pt/commands). A linha `Session kind` lê `background job · attached` ou `background job · unattended` em uma sessão em background, dependendo se um terminal está anexado, e `interactive` em qualquer outra sessão.

631 808

632Uma linha vazia deixada ao pressionar `←` que nunca recebeu um prompt é removida completamente após cerca de cinco minutos para que a lista se limpe por conta própria. Sessões iniciadas com `claude --bg` e sessões aguardando um prompt de configuração, como um diálogo de confiança, não são removidas dessa forma.809<h3 id="the-supervisor-process">

810 O processo supervisor

811</h3>

633 812

634Quando o host fica com pouca memória, o supervisor interrompe as sessões inativas não fixadas primeiro e interrompe as fixadas inativas apenas se isso não liberou nada.813O supervisor é um serviço em background que executa suas sessões em background para que continuem funcionando depois que você fecha a visualização de agente ou seu terminal. Claude Code o inicia na primeira vez que você coloca uma sessão em background ou abre a visualização de agente, e você não precisa gerenciá-lo.

635 814

636O supervisor observa o binário Claude Code instalado no disco e reinicia para a nova versão após o [auto-updater](/docs/pt/setup#auto-updates) regular substituí-lo. Esta é uma observação de arquivo local, não uma verificação de rede. Sessões em background são processos desanexados, então continuam em execução durante a reinicialização e o novo supervisor se reconecta a elas. Uma sessão fixada inativa também é reiniciada no local para a nova versão para que ela pegue a atualização sem você se reconectar.815Cada sessão é seu próprio processo Claude Code sob o supervisor, e o que acontece com esse processo depende do estado da sessão:

637 816

638Depois que o novo supervisor assume, ele também reinicia as sessões inativas restantes para a nova versão, algumas de cada vez em background, após um curto atraso que permite que terminais anexados durante a reinicialização se reconectem primeiro. Uma sessão que está funcionando, aguardando sua entrada ou tem um terminal anexado não é interrompida; ela se move para a nova versão na próxima vez que seu processo reinicia. Antes da v2.1.206, o supervisor movia apenas algumas sessões inativas por minuto para uma nova versão, então as sessões poderiam continuar executando a versão antiga por um tempo após uma atualização.817* **Funcionando, pausado em um prompt de permissão ou outro diálogo, ou anexado**: o processo continua em execução. Um subagent, workflow ou monitor em execução conta como funcionando.

818* **Terminado ou aguardando sua próxima mensagem, e desanexado por cerca de uma hora**: o supervisor interrompe o processo para liberar recursos. Uma sessão que terminou seu turno fazendo uma pergunta a você conta como aguardando sua próxima mensagem. A conversa fica no disco, e na próxima vez que você anexar ou responder, a sessão retoma de onde parou. Fixe uma sessão com `Ctrl+T` para manter seu processo em execução.

819* **Saiu inesperadamente enquanto o supervisor está em execução**: o supervisor reinicia o processo. Terminar uma sessão que você colocou em background com `←` ou `/background`, por exemplo com `kill`, marca-a como parada em vez de reiniciá-la. Para sessões que terminaram com um desligamento, consulte [Sessões aparecem como falhadas ou paradas após desligamento](#sessions-show-as-failed-after-shutdown).

820* **Após uma atualização automática**: o supervisor reinicia a si mesmo para a nova versão e move sessões inativas em background. Sessões que estão funcionando, aguardando você ou anexadas não são interrompidas.

639 821

640Essas reinicializações apenas movem uma sessão para uma versão mais recente. Um supervisor executando uma versão mais antiga do Claude Code do que aquela com a qual o processo de uma sessão foi iniciado deixa esse processo sozinho; a sessão continua executando a versão mais recente até que um supervisor mais recente assume.822Quando o processo de uma sessão para ou reinicia, os comandos de shell em background, workflows dinâmicos e subagents em background que Claude iniciou nela são transferidos para seu próximo processo; monitors em execução e comandos de shell que um subagent iniciou param com o processo. Deletar a sessão para tudo que ela transferiu. Para parar tudo com o processo em vez disso, defina [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/pt/env-vars#variables) como `1`.

641 823

642Executar `claude attach` enquanto o supervisor está reiniciando uma sessão, seja para uma atualização, um travamento ou uma migração, aguarda o processo de substituição em vez de falhar. Uma linha de status como `Agent is updating to the new Claude Code…` nomeia o que está aguardando e conta os segundos decorridos, e o comando se conecta assim que a sessão estiver pronta. Após cerca de 60 segundos, ele para de aguardar e relata um erro. Antes da v2.1.205, `claude attach` parou de tentar novamente após alguns segundos e imprimiu um erro enquanto a sessão ainda estava reiniciando.824O supervisor e suas sessões se autenticam com as mesmas credenciais armazenadas que suas sessões interativas. Para quais configurações e variáveis de shell chegam a uma sessão, incluindo `PATH`, consulte [Configurações e provedor](#settings-and-provider). Para endpoints de gateway, consulte [Gateway LLM](#llm-gateway).

643 825

644<h3 id="where-state-is-stored">826<h3 id="where-state-is-stored">

645 Onde o estado é armazenado827 Onde o estado é armazenado

648O estado da sessão é armazenado sob seu diretório de configuração Claude Code. Se você definir [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars), o supervisor usa esse diretório em vez de `~/.claude` e é executado como uma instância separada com suas próprias sessões.830O estado da sessão é armazenado sob seu diretório de configuração Claude Code. Se você definir [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars), o supervisor usa esse diretório em vez de `~/.claude` e é executado como uma instância separada com suas próprias sessões.

649 831

650| Caminho | Conteúdo |832| Caminho | Conteúdo |

651| :------------------------------- | :----------------------------------------------------------------------------------------------------------- |833| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |

653| `~/.claude/daemon/roster.json` | Lista de sessões em background em execução, usada para se reconectar após uma reinicialização |835| `~/.claude/daemon/roster.json` | Lista de sessões em background em execução, usada para se reconectar após uma reinicialização |

654| `~/.claude/jobs/<id>/state.json` | Estado por sessão mostrado na visualização de agente |836| `~/.claude/jobs/<id>/state.json` | Estado por sessão mostrado na visualização de agente. Leia-o através de [`claude agents --json`](#read-session-state-from-a-script) em vez de analisar o arquivo |

655| `~/.claude/jobs/<id>/tmp/` | Diretório de rascunho por sessão. Escritas aqui não solicitam permissão. Removido quando a sessão é excluída |837| `~/.claude/jobs/<id>/tmp/` | Diretório de rascunho por sessão. Chamadas `Write` e `Edit` de Claude aqui não solicitam permissão. Removido quando a sessão é deletada |

656 838

657Cada sessão em background tem a variável de ambiente `CLAUDE_JOB_DIR` definida para seu diretório `~/.claude/jobs/<id>`, então comandos de shell que a sessão executa podem escrever arquivos temporários em `$CLAUDE_JOB_DIR/tmp` sem colidir com sessões paralelas.839Cada sessão em background tem a variável de ambiente `CLAUDE_JOB_DIR` definida para seu diretório `~/.claude/jobs/<id>`, então comandos de shell que a sessão executa podem escrever arquivos temporários em `$CLAUDE_JOB_DIR/tmp` sem colidir com sessões paralelas.

658 840

660 842

661O comando também avisa quando o supervisor em execução está em uma versão diferente do `claude` que você invocou, o que acontece após uma atualização que o supervisor ainda não reiniciou. O aviso mostra ambas as versões e diz para você executar `claude daemon stop --any` para pegar a nova versão. Quando Claude Code é instalado como um serviço do SO, o comando sugerido é `claude daemon stop` sem a flag.843O comando também avisa quando o supervisor em execução está em uma versão diferente do `claude` que você invocou, o que acontece após uma atualização que o supervisor ainda não reiniciou. O aviso mostra ambas as versões e diz para você executar `claude daemon stop --any` para pegar a nova versão. Quando Claude Code é instalado como um serviço do SO, o comando sugerido é `claude daemon stop` sem a flag.

662 844

663Sessões sobrevivem a esse desajuste de versão intactas: uma versão mais antiga do Claude Code que atualiza o `state.json` de uma sessão preserva campos que não reconhece e mantém a sessão listada. A lista de sessões em `roster.json` segue a mesma regra: uma versão mais antiga que a reescreve preserva campos que uma versão mais nova escreveu, então sessões iniciadas pela versão mais nova permanecem acessíveis e continuam aceitando entrada após o supervisor reiniciar. Antes da v2.1.200, versões mais antigas poderiam descartar esses campos ao reescrever.845Sessões sobrevivem a esse desajuste de versão intactas: uma versão mais antiga do Claude Code que atualiza o `state.json` de uma sessão preserva campos que não reconhece e mantém a sessão listada. A lista de sessões em `roster.json` segue a mesma regra, então sessões iniciadas pela versão mais nova permanecem acessíveis e continuam aceitando entrada após o supervisor reiniciar.

~~664~~

665No Windows, `claude daemon status` expõe o erro de arquivo subjacente quando o arquivo de chave de pipe do daemon está bloqueado ou ilegível em vez de relatar uma falha de conexão genérica.

666 846

667<h3 id="turn-off-agent-view">847<h3 id="turn-off-agent-view">

668 Desativar a visualização de agente848 Desativar a visualização de agente

669</h3>849</h3>

670 850

671Para desativar agentes em background e a visualização de agente completamente, defina a [configuração](/docs/pt/settings) `disableAgentView` como `true` ou defina a variável de ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Os administradores podem impor isso através de [configurações gerenciadas](/docs/pt/permissions#managed-settings).851Para desativar agentes em background e a visualização de agente completamente, defina a [configuração](/docs/pt/settings) `disableAgentView` como `true` ou defina a variável de ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Os administradores podem impor isso através de [configurações gerenciadas](/docs/pt/managed-settings).

672 852

673<h2 id="troubleshooting">853<h2 id="troubleshooting">

674 Troubleshooting854 Troubleshooting

692 Backgrounding mostra um diálogo `Background this session?`872 Backgrounding mostra um diálogo `Background this session?`

693</h3>873</h3>

694 874

695Se pressionar `←` para colocar a sessão atual em background mostrar um diálogo `Background this session?`, a sessão tem trabalho em andamento que não pode se mover para a sessão em background, como um [monitor](/docs/pt/tools-reference#monitor-tool) em execução, e Claude Code não o interromperá silenciosamente. O diálogo nomeia o trabalho que será interrompido e, separadamente, conta as tarefas que são transferidas. Execute `/tasks` para ver tudo que está em execução, depois confirme para colocar em background mesmo assim ou escolha `Stay` para deixar o trabalho terminar primeiro. Veja [From inside a session](#from-inside-a-session) para quais tipos de tarefas são transferidos e quais são interrompidos.875Se você pressionar `←` para colocar a sessão atual em background e Claude Code mostrar um diálogo `Background this session?`, a sessão tem trabalho em andamento que o backgrounding interromperia, reiniciaria ou deixaria em execução sem supervisão, e Claude Code pergunta antes de fazer qualquer um desses:

876

877* **Trabalho que não pode se mover**: a sessão tem trabalho que não pode se mover para a sessão em background, como um [monitor](/docs/pt/tools-reference#monitor-tool) em execução. O diálogo nomeia o trabalho que Claude Code interromperia e, separadamente, conta as tarefas que são transferidas.

878* **Um workflow com subagentes em execução**: um [dynamic workflow](/docs/pt/workflows) ainda tem subagentes em execução. O workflow em si é transferido, mas seus subagentes em execução reiniciam do início, e o diálogo diz quantos.

879* **Respostas automáticas de artefatos**: Claude está [respondendo a comentários em um artefato por conta própria](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own). Essas respostas continuam na sessão em background, e o diálogo diz isso.

880

881Execute `/tasks` para ver tudo que está em execução, depois confirme para colocar em background mesmo assim ou escolha `Stay` para deixar o trabalho terminar primeiro. Veja [What carries over when you background](#what-carries-over-when-you-background) para quais tipos de trabalho são transferidos e quais Claude Code interrompe.

696 882

697<h3 id="prompt-rejected-as-too-short">883<h3 id="prompt-rejected-as-too-short">

698 Prompt rejected as too short884 Prompt rejected as too short

701A entrada de dispatch espera uma descrição de tarefa, não um abridor conversacional. Um prompt com menos de quatro caracteres é rejeitado com uma dica `Too short` para que um pressionamento de tecla acidental não inicie uma sessão. Descreva o que você quer que a sessão faça, como `investigate the flaky checkout test`.887A entrada de dispatch espera uma descrição de tarefa, não um abridor conversacional. Um prompt com menos de quatro caracteres é rejeitado com uma dica `Too short` para que um pressionamento de tecla acidental não inicie uma sessão. Descreva o que você quer que a sessão faça, como `investigate the flaky checkout test`.

702 888

703<h3 id="sessions-show-as-failed-after-shutdown">889<h3 id="sessions-show-as-failed-after-shutdown">

704 Sessions show as failed after shutdown890 Sessions show as failed or stopped after shutdown

705</h3>891</h3>

706 892

707Desligar ou reiniciar sua máquina interrompe as sessões em execução em background, então elas mostram como falhadas quando você abre agent view novamente. Anexe, espreite ou responda a qualquer uma delas e a sessão reinicia de onde parou.893Desligar ou reiniciar sua máquina interrompe as sessões em execução em background. Uma sessão que estava aguardando sua entrada permanece sob `Needs input` quando você volta. Para qualquer outra sessão em execução, o que agent view mostra depende de quanto tempo atrás ela fez progresso pela última vez:

894

895* Dentro de 48 horas, a sessão mostra como falhada. Anexe ou responda a ela e ela reinicia de onde parou.

896* Passadas 48 horas, como após a máquina estar desligada por dias, a sessão mostra como parada com `ended while the background service was off`. Pressione `Enter` na linha e o rodapé mostra `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it.` Pressione `Enter` na mesma linha novamente para retomar sua conversa salva. Uma resposta, ou `claude attach <id>`, a retoma sem esse prompt de rodapé.

708 897

709Sleep sozinho não causa isso. Sessões são preservadas durante o sleep e o supervisor se reconecta a elas ao acordar.898Quando [transcript cleanup](/docs/pt/settings-reference#cleanupperioddays) removeu a conversa salva de uma sessão parada, Claude Code recusa abrir a linha: a mensagem diz que não há nada para retomar. `claude rm <id>` deleta a linha, exceto nos [casos mantidos](#what-deleting-a-session-removes) descritos acima, e `claude respawn <id>` executa seu prompt original novamente. Veja [This session's saved conversation is no longer on disk](/docs/pt/errors#this-sessions-saved-conversation-is-no-longer-on-disk).

899

900Sleep sozinho não interrompe as sessões. Sessões são preservadas durante o sleep e o supervisor se reconecta a elas ao acordar.

710 901

711<h3 id="opening-a-session-says-the-conversation-is-already-open">902<h3 id="opening-a-session-says-the-conversation-is-already-open">

712 Opening a session says the conversation is already open903 Opening a session says the conversation is already open

713</h3>904</h3>

714 905

715Abrir uma linha parada cuja conversa também está sendo mantida aberta por outro processo Claude Code não interativo em execução, por exemplo um worker em background para a mesma conversa que ainda está encerrando, mostra `This conversation is already open in another running Claude session` em vez de iniciar o processo da linha, porque dois processos não podem escrever no mesmo transcript. Responda na sessão que já tem a conversa aberta, ou saia dela e abra a linha novamente. Uma resposta que você digitou com a tentativa recusada não é perdida; ela é enviada na próxima vez que a sessão inicia.906Dois processos não podem escrever no mesmo transcript. Quando a conversa salva de uma sessão parada já está aberta em outro processo Claude Code ao vivo, Claude Code recusa iniciar o processo da sessão. O que você vê depende do que mantém a conversa:

907

908* Um terminal onde você retomou a conversa, por exemplo com `claude --resume` ou `/resume`: a linha mostra `Open in a terminal` com uma dica para continuar lá, e abrir a linha mostra `Can't open — this session is running in another terminal`. Continue naquele terminal, ou saia dele e abra a linha novamente.

909* Outro processo Claude Code não interativo, por exemplo um processo de sessão em background para a mesma conversa que ainda não saiu: abrir a linha mostra `This conversation is already open in another running Claude session`. Use esse processo, ou aguarde sua saída e abra a linha novamente.

716 910

717Antes da v2.1.203, este estado iniciava um segundo processo mesmo assim. Esse processo saía com um erro `currently running as a background agent` e a linha mostrava como falhada.911Claude Code salva uma resposta que você digitou com a tentativa recusada e a envia na próxima vez que a sessão inicia.

912

913<h3 id="opening-a-session-says-it-has-no-saved-transcript">

914 Opening a session says it has no saved transcript

915</h3>

916

917Uma sessão parada que foi [backgrounded from another conversation](#from-inside-a-session) e parou antes de sua primeira resposta terminar não tem nada para retomar: até que essa primeira resposta termine, a conversa ainda vive apenas na sessão de que foi backgrounded. `claude attach` recusa abrir com `This session has no saved transcript`.

918

919Em agent view, abrir essa linha mostra `Press enter again to restart this session fresh` abaixo da lista. Pressione `Enter` na mesma linha novamente para reiniciar a sessão com uma conversa vazia, ou execute `claude respawn <id>` do shell.

920

921A conversa original está intacta; retome-a com `claude --resume` ou continue trabalhando nela. Veja a [referência de erro](/docs/pt/errors#this-session-has-no-saved-transcript) para detalhes.

922

923<h3 id="the-terminal-host-died-or-the-session-stopped-responding">

924 The terminal host died or the session stopped responding

925</h3>

926

927O [supervisor](#the-supervisor-process) executa o terminal de cada sessão em background em seu próprio processo host. Quando esse processo morre ou para de responder, Claude Code mostra o motivo e oferece uma reinicialização; em ambos os casos a conversa é salva e a reinicialização a retoma. A [referência de erro](/docs/pt/errors#terminal-host-process-died) cita as mensagens completas.

928

929Claude Code nunca reinicia uma linha executando um [shell command](#run-a-shell-command), de `Enter` ou de `claude attach`, porque isso executaria o comando novamente; a mensagem da linha e `claude attach` ambas dizem que o comando não é executado novamente.

930

931<h4 id="terminal-host-died">

932 Terminal host died

933</h4>

934

935No Linux e WSL, o supervisor verifica cada processo host a cada poucos segundos, independentemente de você abrir a sessão ou não, e marca a sessão como falhada quando o processo saiu mas sua conexão com o supervisor nunca fechou.

936

937* Em agent view, a linha mostra `terminal host process died — press Enter to restart`. Pressione `Enter` nela e Claude Code reinicia a sessão em um novo processo host.

938* Do shell, `claude attach <id>` reinicia uma sessão já marcada como falhada. Caso contrário, relata a causa e sai, dizendo-lhe para executar `claude attach <id>` novamente.

939

940<h4 id="session-isn’t-responding">

941 Session isn't responding

942</h4>

943

944Quando o supervisor aceita uma abertura mas nenhuma saída chega por cerca de dez segundos, Claude Code encerra a tentativa e oferece uma reinicialização. Uma sessão que meramente travou, por exemplo durante o sleep da máquina, não chega a essa oferta: o supervisor [a reinicia ao abrir](#read-session-state) por conta própria.

945

946* Em agent view, o rodapé mostra `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` Pressione `Enter` na mesma linha novamente e Claude Code interrompe o processo que não responde e reinicia a sessão; ele não interrompe nada sem esse segundo pressionamento.

947* Do shell, `claude attach <id>` relata a causa e sai, dizendo-lhe para executar `claude stop <id>`, depois `claude attach <id>`.

718 948

719<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">949<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

720 A session fails before starting with a `possibly low memory` note950 A session fails before starting with a `possibly low memory` note

721</h3>951</h3>

722 952

723A partir da v2.1.199, quando o processo de uma sessão em background sai antes de terminar de iniciar e o host está com pouca memória, o status da linha nomeia a saída e adiciona `possibly low memory — free some up and retry`. Versões anteriores mostravam apenas o motivo da saída para essa falha.953Quando o processo de uma sessão em background sai antes de terminar de iniciar e o host está com pouca memória, o status da linha nomeia a saída e adiciona `possibly low memory — free some up and retry`.

724 954

725A nota é uma hipótese, não uma causa confirmada. Claude Code a adiciona apenas quando o processo saiu silenciosamente, sem escrever um erro e sem ser interrompido por um sinal, e o host relatou pouca memória naquele momento. Quando o processo escreveu um erro antes de sair, a linha mostra esse erro em vez disso.955A nota é uma hipótese, não uma causa confirmada. Claude Code a adiciona apenas quando o processo saiu silenciosamente, sem escrever um erro e sem ser interrompido por um sinal, e o host relatou pouca memória naquele momento. Quando o processo escreveu um erro antes de sair, a linha mostra esse erro em vez disso.

726 956

727Libere memória na máquina, depois anexe, espreite ou responda à linha e o supervisor inicia um novo processo para a sessão. Quando a memória permanece baixa, o supervisor também [interrompe sessões ociosas](#the-supervisor-process) para liberar recursos por conta própria.957Libere memória na máquina, depois anexe ou responda à linha e o supervisor inicia um novo processo para a sessão. Quando a memória permanece baixa, o supervisor também [interrompe sessões ociosas](#the-supervisor-process) para liberar recursos por conta própria, e interrompe sessões fixadas ociosas também se interromper as outras não liberou nada.

728 958

729<h3 id="agent-view-says-the-background-service-did-not-respond">959<h3 id="agent-view-says-the-background-service-did-not-respond">

730 Agent view says the background service did not respond960 Agent view says the background service did not respond

740 970

741Um supervisor que inicia mas não consegue aceitar conexões sai e libera seu bloqueio por conta própria, portanto o próximo `claude agents` inicia um novo sem essa parada manual. Os passos acima se aplicam quando um supervisor em execução trava.971Um supervisor que inicia mas não consegue aceitar conexões sai e libera seu bloqueio por conta própria, portanto o próximo `claude agents` inicia um novo sem essa parada manual. Os passos acima se aplicam quando um supervisor em execução trava.

742 972

973Se o comando em vez disso sair dizendo que o processo registrado não pôde ser verificado como o supervisor, verifique o ID do processo relatado: se for um supervisor que você possui, interrompa-o você mesmo, depois delete `~/.claude/daemon.lock` para que o próximo `claude agents` inicie novo.

974

743No Windows, se o supervisor não responder à solicitação de parada, o comando imprime seu ID de processo. Encerre esse processo com `taskkill /PID <pid>` para concluir a recuperação. As sessões em background ainda são preservadas quando você passou `--keep-workers`.975No Windows, se o supervisor não responder à solicitação de parada, o comando imprime seu ID de processo. Encerre esse processo com `taskkill /PID <pid>` para concluir a recuperação. As sessões em background ainda são preservadas quando você passou `--keep-workers`.

744 976

745<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">977<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

746 Dispatch fails with `Could not resolve authentication method`978 Dispatch fails with `Could not resolve authentication method`

747</h3>979</h3>

748 980

749Se um dispatch em background falhar com `Could not resolve authentication method` enquanto sessões interativas autenticam normalmente, o worker que recebeu o dispatch não pegou as credenciais. O supervisor fornece um snapshot de credencial fresco quando atribui um [pre-warmed worker](#the-supervisor-process), então este erro significa que nenhuma credencial armazenada estava disponível para o próprio processo supervisor. Confirme que você executou `/login` ou configurou uma chave de API, depois interrompa o supervisor:981Se um dispatch em background falhar com `Could not resolve authentication method` enquanto sessões interativas autenticam normalmente, o worker que recebeu o dispatch não pegou as credenciais. Sessões em background obtêm suas credenciais do [supervisor](#the-supervisor-process), então esse erro significa que nenhuma credencial armazenada estava disponível para o próprio processo supervisor. Confirme que você executou `/login` ou configurou uma chave de API, depois interrompa o supervisor:

750 982

751```bash theme={null}983```bash theme={null}

752claude daemon stop --any --keep-workers984claude daemon stop --any --keep-workers

768 Background sessions can't reach local-network hosts on macOS1000 Background sessions can't reach local-network hosts on macOS

769</h3>1001</h3>

770 1002

771No macOS 15 e posterior, o sistema bloqueia um processo de alcançar dispositivos na sua rede local até que você conceda permissão de Rede Local. Antes da v2.1.198, o host da sessão em background nunca solicitava essa permissão, então comandos direcionados a um endereço LAN falhavam com `connect: no route to host` mesmo que o mesmo comando funcionasse em um terminal em primeiro plano. A partir da v2.1.198, o primeiro comando em uma sessão em background que se conecta a um endereço de rede local dispara o prompt de permissão de Rede Local do macOS para Claude Code. Conceda uma vez e esses comandos alcançam hosts LAN da mesma forma que fazem em um terminal em primeiro plano.1003No macOS 15 e posterior, o sistema bloqueia um processo de alcançar dispositivos na sua rede local até que você conceda permissão de Rede Local, então um comando direcionado a um endereço LAN pode falhar com `connect: no route to host` em uma sessão em background mesmo que funcione em um terminal em primeiro plano. O primeiro comando em uma sessão em background que se conecta a um endereço de rede local dispara o prompt de permissão de Rede Local do macOS para Claude Code. Conceda uma vez e esses comandos alcançam hosts LAN da mesma forma que fazem em um terminal em primeiro plano.

772 1004

773<h3 id="a-session-is-slow-to-respond-after-attaching">1005<h3 id="a-session-is-slow-to-respond-after-attaching">

774 A session is slow to respond after attaching1006 A session is slow to respond after attaching

775</h3>1007</h3>

776 1008

777Depois que uma sessão termina e fica desanexada por cerca de uma hora, o supervisor interrompe seu processo para liberar recursos. Anexar inicia um novo processo de onde parou e muda para a sessão imediatamente enquanto o processo reinicia. Sessões que estão funcionando, aguardando você ou [fixadas](#organize-the-list) não são interrompidas dessa forma, portanto fixe uma sessão com `Ctrl+T` para mantê-la responsiva.1009Quando uma sessão que terminou ou está aguardando sua próxima mensagem fica desanexada por cerca de uma hora, o supervisor interrompe seu processo para liberar recursos. Anexar inicia um novo processo de onde parou e muda para a sessão imediatamente enquanto o processo reinicia. Sessões que estão funcionando, pausadas em um prompt de permissão ou outro diálogo, ou [fixadas](#organize-the-list) não são interrompidas dessa forma, portanto fixe uma sessão com `Ctrl+T` para mantê-la responsiva.

778 1010

779Enquanto o processo inicia, a última tela da transcrição da sessão é mostrada com uma nota `Session is starting` abaixo dela, e a sessão ao vivo a substitui assim que estiver pronta.1011Enquanto o processo inicia, Claude Code mostra a cauda da transcrição da sessão formatada da forma que a sessão ao vivo a renderiza, com markdown, blocos de código destacados e chamadas de ferramenta como linhas esmaecidas, acima de uma área de prompt esmaecida com uma nota `Session is starting`. A sessão ao vivo a substitui assim que estiver pronta.

780 1012

781<h3 id="claude/worktrees/-is-filling-up">1013<h3 id="claude/worktrees/-is-filling-up">

782 `.claude/worktrees/` is filling up1014 `.claude/worktrees/` is filling up

783</h3>1015</h3>

784 1016

785Deletar uma sessão em agent view remove a worktree que Claude criou para ela, e uma worktree que não pode ser removida com segurança [mantém sua linha de sessão](#organize-the-list) para que não seja órfã. `claude rm` mantém uma worktree que tem mudanças não commitadas, e sua linha de sessão, e imprime o caminho mantido. Liste entradas restantes com `git worktree list` no diretório do projeto e remova cada uma com `git worktree remove <path>`. Veja [Clean up worktrees](/docs/pt/worktrees#clean-up-worktrees).1017Deletar uma sessão em agent view remove a worktree que Claude criou para ela, mas [alguns deletes mantêm a worktree ou deixam seu diretório no disco](#what-deleting-a-session-removes), então diretórios restantes podem se acumular. Diretórios que git não reconhece mais não aparecem em `git worktree list`, então remova aqueles à mão.

1018

1019Liste entradas restantes com `git worktree list` no diretório do projeto e remova cada uma com `git worktree remove <path>`. Veja [Clean up worktrees](/docs/pt/worktrees#clean-up-worktrees).

786 1020

787<h2 id="limitations">1021<h2 id="limitations">

788 Limitações1022 Limitações

792 1026

793* **Limites de taxa se aplicam**: sessões em background consomem o uso de sua assinatura da mesma forma que sessões interativas, então executar dez agentes em paralelo usa cota aproximadamente dez vezes mais rápido do que executar um.1027* **Limites de taxa se aplicam**: sessões em background consomem o uso de sua assinatura da mesma forma que sessões interativas, então executar dez agentes em paralelo usa cota aproximadamente dez vezes mais rápido do que executar um.

794* **Sessões são locais**: sessões em background são executadas em sua máquina. Elas são preservadas durante o sleep, mas param se a máquina desligar.1028* **Sessões são locais**: sessões em background são executadas em sua máquina. Elas são preservadas durante o sleep, mas param se a máquina desligar.

795* **Worktrees criadas pelo Claude são deletadas com a sessão em agent view**: confirme as alterações antes de deletar uma sessão que editou arquivos em seu próprio worktree. Um worktree com commits que não foram enviados para lugar nenhum é mantido junto com a sessão. `claude rm` também mantém um worktree que tem alterações não confirmadas junto com sua sessão, e um worktree que você criou você mesmo é deixado no lugar.1029* **Worktrees criadas pelo Claude são deletadas com a sessão em agent view**: confirme as alterações antes de deletar uma sessão que editou arquivos em seu próprio worktree. [Algumas exclusões mantêm o worktree em vez disso](#what-deleting-a-session-removes).

796 1030

797<h2 id="related-resources">1031<h2 id="related-resources">

798 Recursos relacionados1032 Recursos relacionados

799</h2>1033</h2>

800 1034

801Para outras maneiras de executar Claude em paralelo, consulte:1035Para outras maneiras de executar Claude em paralelo e para passar descobertas entre as sessões que você executa, consulte:

802 1036

803* [Executar agentes em paralelo](/docs/pt/agents): compare agent view com subagentes, equipes de agentes e worktrees1037* [Executar agentes em paralelo](/docs/pt/agents): compare agent view com subagentes, equipes de agentes e worktrees

1038* [Mensagens entre sessões](/docs/pt/cross-session-messaging): tenha suas sessões passando descobertas uma para a outra

804* [Equipes de agentes](/docs/pt/agent-teams): coordene múltiplas sessões que se mensageiam1039* [Equipes de agentes](/docs/pt/agent-teams): coordene múltiplas sessões que se mensageiam

805* [Claude Code na web](/docs/pt/claude-code-on-the-web): execute sessões em um ambiente de nuvem gerenciado em vez de localmente1040* [Claude Code na web](/docs/pt/claude-code-on-the-web): execute sessões em um ambiente de nuvem gerenciado em vez de localmente

806 1041

811Agent view evoluiu rapidamente durante a visualização de pesquisa. Se você estiver em uma versão mais antiga do Claude Code, alguns comportamentos nesta página podem diferir; em particular, `claude agents` rejeita flags que ainda não suporta com um erro de `unknown option`. A tabela abaixo lista quando cada flag e comportamento foi adicionado.1046Agent view evoluiu rapidamente durante a visualização de pesquisa. Se você estiver em uma versão mais antiga do Claude Code, alguns comportamentos nesta página podem diferir; em particular, `claude agents` rejeita flags que ainda não suporta com um erro de `unknown option`. A tabela abaixo lista quando cada flag e comportamento foi adicionado.

812 1047

814| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1049| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1050| v2.1.268 | Quando uma [exclusão é recusada](#what-deleting-a-session-removes) porque git ou seu hook `WorktreeRemove` não conseguiu remover o worktree, a mensagem nomeia a causa, incluindo como um hook terminou e o início de seu stderr. Para um worktree vinculado sob o diretório `.claude/worktrees/` do repositório sem alterações não confirmadas em arquivos rastreados, nenhum repositório aninhado dentro dele e nenhum registro de outra sessão nomeando-o, deletar a sessão novamente remove o diretório mesmo assim, a partir de agent view ou com `claude rm <id> --force-remove-worktree <worktree-id>`. Antes desta versão, a linha mostrava apenas `worktree could not be removed (WorktreeRemove hook failed)` ou o erro do git, o stderr do hook ia apenas para o log de depuração, e deletar novamente era recusado da mesma forma. |

1051| v2.1.260 | Quando você [coloca uma sessão em background](#from-inside-a-session), a [listagem de agentes](/docs/pt/cross-session-messaging#see-which-sessions-claude-can-reach) de suas outras sessões mostra a conversa uma vez, como sua sessão em background, e suas mensagens para ela não chegam mais ao terminal de onde você a moveu. Antes desta versão, esse terminal poderia ficar listado como uma segunda sessão interativa sob o nome da conversa, e uma sessão que tinha enviado mensagens para a conversa antes da mudança continuava entregando a esse terminal. |

1052| v2.1.260 | Quando uma [exclusão é recusada sobre commits não enviados](#what-deleting-a-session-removes), a mensagem nomeia a branch do worktree e quantos commits não foram enviados, e deletar a sessão novamente descarta o worktree e seus commits. Antes desta versão, a recusa dizia apenas `worktree has commits that are not pushed anywhere`, deletar novamente era recusado da mesma forma, e deletar a sessão exigia enviar os commits ou remover o worktree manualmente. |

1053| v2.1.257 | `←` [desanexa de uma sessão anexada enquanto a sobreposição `/btw` está aberta](#attach-to-a-session), até mesmo no meio de uma resposta, e a sobreposição reabre quando você se anexa novamente. Antes desta versão, `←` não desanexava enquanto a sobreposição estava aberta. |

1054| v2.1.257 | Quando você executa [`claude --resume <session-id> --bg`](#from-your-shell), Claude Code continua essa sessão sob seu próprio ID, ou inicia uma cópia sob um novo ID e imprime uma linha `note:` explicando o motivo. `--continue`, um `--resume` simples, e `--resume` com um nome ou caminho iniciam uma cópia com a mesma nota. Antes desta versão, `--resume` com `--bg` sempre iniciava uma cópia sob um novo ID e não dizia nada. |

1055| v2.1.257 | Quando você despacha uma sessão a partir de uma agent view que você abriu com `←`, Claude Code a inicia no [modo de permissão que o diretório de destino configura](#permission-mode) através de `permissions.defaultMode`. Quando o diretório não define um, o modo de permissão da sessão de onde você veio se aplica. Antes desta versão, a sessão despachada sempre iniciava no modo de permissão da sessão de onde você veio, substituindo-o. |

1056| v2.1.257 | `Ctrl+S`, `Ctrl+T` e `Ctrl+G` em agent view [seguem seus `keybindings.json`](#keyboard-shortcuts): `Ctrl+S` e `Ctrl+T` através das ações `agents:switchView` e `agents:togglePin` do contexto `Agents`, e `Ctrl+G` através da vinculação `chat:externalEditor` do contexto `Chat`. Antes desta versão, agent view ignorava `keybindings.json` e essas teclas eram fixas. |

1057| v2.1.257 | Iniciar o [serviço de background](#the-supervisor-process) se recupera de duas causas de falha. Em uma instalação npm no macOS, um início durante uma auto-atualização [aguarda a instalação](/docs/pt/errors#eacces-when-starting-a-background-session) em vez de executar o placeholder que npm coloca enquanto substitui o binário. No Windows, um `daemon.lock` obsoleto escrito antes da última inicialização da máquina, ou cujo ID de processo registrado agora pertence a um processo diferente, é substituído. Antes desta versão, o início no macOS falhava com `Error: claude native binary not installed.` durante a janela de instalação, e o lock do Windows fazia cada início falhar com [`exited before it became reachable`](/docs/pt/errors#background-service-exited-before-it-became-reachable) até que você deletasse `~/.claude/daemon.lock`. |

1058| v2.1.257 | Quando você abre ou despacha uma sessão em background enquanto outro processo Claude Code está baixando uma atualização npm, Claude Code [continua aguardando até dois minutos](/docs/pt/errors#eacces-when-starting-a-background-session) enquanto a instalação é executada, depois falha dizendo `Claude Code is being updated by npm on this machine`. Antes desta versão, a espera parava em dez segundos, então a abertura falhava com `Couldn't start the background service` enquanto o download ainda estava em execução. |

1059| v2.1.257 | Uma sessão em background segurando uma [mensagem entre sessões](/docs/pt/cross-session-messaging#control-inbound-messages) para sua aprovação mostra `approve message from` em sua linha `Needs input`, com o endereço do remetente e o nome que o remetente afirma. Antes desta versão, a linha se movia para `Needs input` mas mantinha seu texto anterior, então nada em `claude agents` nomeava a mensagem aguardando ou seu remetente. |

1060| v2.1.257 | Um prompt armazenado com `Ctrl+S` dentro de uma sessão em background aberta [é mantido com a sessão](#what-persists-across-restarts), então `Ctrl+S` o restaura após o processo da sessão ser parado e iniciado novamente. Antes desta versão, o armazenamento vivia apenas no processo em execução e era perdido quando a sessão ficava ociosa tempo suficiente para seu processo parar, ou quando era parada e depois reabierta. |

1061| v2.1.251 | Em uma sessão em background que não [se moveu para um worktree](#how-file-edits-are-isolated), Claude e os subagentes que ele gera podem editar arquivos dentro de um worktree git vinculado. |

1062| v2.1.251 | Claude Code encaminha um gateway de provedor de nuvem exportado no shell de onde você despacha, como `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL` com sua flag de bypass de autenticação, para [o worker da sessão](#llm-gateway) sob as mesmas condições que `ANTHROPIC_BASE_URL`. Antes desta versão, se você colocasse em background ou despachasse a partir de um shell autenticado apenas através de tal gateway, cada solicitação que a sessão fazia falhava, porque o endpoint e a flag eram descartados de seu ambiente. |

1063| v2.1.251 | Quando uma sessão em background inicia enquanto outro processo Claude Code está atualizando um [marketplace de plugins](/docs/pt/plugin-marketplaces), como uma sessão irmã executando a [atualização automática do marketplace](/docs/pt/discover-plugins#configure-auto-updates), Claude Code mantém os plugins desse marketplace disponíveis. Antes desta versão, tal sessão poderia iniciar sem nenhuma das skills, agentes, hooks e servidores MCP desse marketplace e permanecer assim durante toda sua execução. |

1064| v2.1.248 | `Shift+Enter` na [entrada de despacho](#keyboard-shortcuts) insere uma nova linha, correspondendo ao prompt principal, e `Ctrl+Enter` despacha e se anexa imediatamente em terminais onde a sobreposição `?` lista `ctrl+enter to start and open`. Antes desta versão, `Shift+Enter` despachava e se anexava. |

1065| v2.1.248 | [Deletar uma sessão](#what-deleting-a-session-removes) tem sucesso quando os commits do worktree já estão na cópia local da branch padrão do seu remote `origin` e seu checkout principal tem essa branch verificada; antes desta versão, a exclusão era recusada com `has commits that are not pushed anywhere`. |

1066| v2.1.248 | Uma sessão colocada em background com `←` ou `/background` mantém o [`git worktree lock`](/docs/pt/worktrees#clean-up-subagent-and-background-session-worktrees) em seu worktree enquanto é executada; antes desta versão, colocar em background liberava o lock, e limpeza ou `git worktree remove` poderia remover o worktree sob a sessão em execução. |

1067| v2.1.248 | Uma sessão em background que não estava aguardando sua entrada e é encontrada morta mais de 48 horas após sua última atividade, como após a máquina estar desligada por dias, [mostra como parada](#sessions-show-as-failed-after-shutdown) com `ended while the background service was off`, e `Enter` nela pergunta antes de retomar sua conversa salva. Antes desta versão, tal sessão reaparecia como uma falha fresca classificada no topo da lista, e um único `Enter` puxava a conversa de semanas atrás para o primeiro plano. |

1068| v2.1.248 | Abrir uma linha parada cuja conversa [você retomou em outro terminal](#opening-a-session-says-the-conversation-is-already-open) é recusado com `Can't open — this session is running in another terminal`, e a linha mostra `Open in a terminal` em vez de mostrar sob `Working`. Antes desta versão, abrir a linha iniciava um segundo processo escrevendo para a mesma conversa. |

1069| v2.1.248 | Uma sessão em background aguardando uma decisão de permissão enquanto um hook `PermissionRequest` ou `PreToolUse` imprimiu uma resposta inválida [nomeia o evento do hook e o erro de schema em sua linha](#peek-and-reply). Antes desta versão, a linha mostrava apenas a solicitação pendente. |

1070| v2.1.248 | No Windows, `claude agents` responde ao teclado quando lançado em uma aba de terminal que um programa anterior deixou em win32-input-mode. Antes desta versão, Claude Code não decodificava os registros de chave que tal aba envia. |

1071| v2.1.247 | No Linux e WSL, uma sessão [cujo processo host do terminal morreu](#the-terminal-host-died-or-the-session-stopped-responding) falha em segundos com o motivo. Uma abertura que não produz saída termina após cerca de dez segundos com uma oferta de reinício, e `Enter` na linha reinicia a sessão com sua conversa; `claude attach <id>` relata a causa e sai. Antes desta versão, abrir tal sessão mostrava `opening… · esc to cancel` indefinidamente e `claude attach <id>` aguardava sem relatar um erro. |

1072| v2.1.246 | Em uma instalação npm, quando o [serviço de background](#the-supervisor-process) falha ao iniciar enquanto `npm install -g @anthropic-ai/claude-code` está substituindo o binário, Claude Code aguarda até dez segundos para a instalação terminar e tenta novamente antes de relatar [`EACCES: permission denied`](/docs/pt/errors#eacces-when-starting-a-background-session). |

1073| v2.1.246 | Quando o processo do [serviço de background](#the-supervisor-process) morre após imprimir um erro, Claude Code relata a falha e [cita a primeira linha de erro do serviço](/docs/pt/errors#background-service-exited-before-it-became-reachable). |

1074| v2.1.246 | Se sua máquina dormir enquanto o [serviço de background](#the-supervisor-process) está iniciando, Claude Code tenta novamente o início uma vez em vez de falhar. |

1075| v2.1.246 | Claude Code aguarda cerca de dois minutos em vez de 45 segundos por um [serviço de background](#the-supervisor-process) recém-iniciado que está vivo mas lento para aceitar conexões. |

1076| v2.1.246 | O [serviço de background](#the-supervisor-process) inicia a partir de seu diretório inicial, então no macOS e Linux um diretório inicial que foi deletado ou movido não bloqueia mais o início. |

1077| v2.1.246 | `/fork` [copia a conversa completa](#copy-the-session-with-%2Ffork) de uma sessão que ela mesma iniciou como uma cópia e não registrou um novo prompt desde: uma cópia `/fork` que você se anexou, uma sessão reexaminada após `←` ou `/background` a moveu para o background, ou uma sessão iniciada com `claude --resume <id> --fork-session`. Antes desta versão, se você executasse `/fork` em tal sessão antes de enviar um novo prompt, Claude Code imprimia a confirmação normal mas iniciava a cópia com uma conversa vazia. Mover tal sessão para o background com `←` ou `/background` perdia a conversa da mesma forma. |

1078| v2.1.246 | Quando você abre uma sessão que acabou de despachar enquanto seu processo worker ainda está iniciando, como pressionando `Enter` em sua linha, Claude Code aguarda o processo e depois se anexa. Antes desta versão, se você pressionasse `Enter` enquanto o processo ainda estava iniciando, Claude Code poderia parar a sessão com [`Session <id> was stopped while the respawn was in flight`](/docs/pt/errors#session-was-stopped-while-the-respawn-was-in-flight). |

1079| v2.1.246 | Quando você [coloca em background](#from-inside-a-session) uma sessão nomeada, Claude Code a lista uma vez, e quando você coloca em background a mesma conversa novamente, ele numera o nome da nova linha, como `my-session (2)`, com a linha existente mantendo seu nome. Antes desta versão, o terminal em que você pressionou `←` poderia aparecer em `claude agents --json` como uma segunda sessão sob o mesmo nome, e se você colocasse em background a mesma conversa novamente, Claude Code adicionava outra linha sob o nome idêntico. |

1080| v2.1.239 | Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `Esc` na entrada de agent view muda de modo INSERT para NORMAL e mantém seu texto, correspondendo ao prompt principal; em modo NORMAL com texto ainda na entrada, pressionar `Esc` o limpa, e pressionar `Esc` em uma entrada vazia sai, como o atalho [`Esc`](#keyboard-shortcuts) descreve. Antes desta versão, `Esc` limpava a entrada. |

1081| v2.1.233 | Para uma sessão vinculada a um merge request do GitLab, Claude Code escreve o rótulo da linha na sintaxe de referência `!1234` do GitLab. Você também pode colar a URL do merge request na [entrada de despacho](#filter-sessions) para selecionar essa sessão. Antes desta versão, o rótulo era renderizado como `#1234`, e uma URL de merge request colada correspondia a uma sessão apenas quando seu primeiro prompt continha a URL. |

1082| v2.1.227 | [Deletar uma sessão](#what-deleting-a-session-removes) mantém a sessão e seu worktree enquanto outra sessão Claude Code ao vivo está em execução dentro desse diretório de worktree. Agent view mostra `not deleted` na linha e o motivo no rodapé, e `claude rm` imprime `kept <id>` com o motivo, que nomeia o ID do processo da outra sessão. Antes desta versão, deletar a sessão removia o worktree enquanto a outra sessão ainda estava trabalhando nele. |

1083| v2.1.225 | `claude agents` em um diretório que você não confiou mostra o mesmo [diálogo de confiança de workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) que `claude` mostra na inicialização, antes de agent view abrir. Aceitar salva confiança para esse workspace; recusar sai sem abrir agent view. Antes desta versão, `claude agents` abria sem perguntar, então sessões que você despachava a partir dele eram executadas em um diretório que você nunca foi perguntado se confiava.<br /><br />Com a lista agrupada por diretório, passar o mouse sobre uma linha a destaca sem alterar o [alvo de despacho](#dispatch-to-a-specific-directory); selecionar uma linha com as teclas de seta ou um clique ainda altera o alvo. Antes desta versão, mover o mouse sobre uma sessão em outro projeto silenciosamente alterava o diretório em que a próxima sessão despachada iniciava. |

1084| v2.1.221 | `/status` mostra uma linha `Session kind`: `background job · attached` ou `background job · unattended` em uma sessão em background, dependendo se um terminal está anexado, e `interactive` em qualquer outra sessão. Antes desta versão, `/status` não relatava o tipo de sessão.<br /><br />`/fork`: Claude Code instrui [a cópia](#from-inside-a-session) a isolar seu trabalho da sessão original: a cópia cria seu próprio worktree antes de fazer alterações de código, fica fora do worktree da sessão original, e baseia uma nova branch na branch da original quando sua tarefa se baseia nesse trabalho. Veja a seção vinculada para as condições exatas. Antes desta versão, a cópia não recebia instrução de isolamento e poderia acabar editando o worktree ou fazendo checkout que a sessão original ainda estava trabalhando.<br /><br />Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `←` logo após desfazer o prompt de volta para vazio com `u` pede a mesma confirmação que deletar o texto ou mover através do histórico de prompts, e muda apenas na segunda pressão; antes desta versão a pressão mudava imediatamente. |

1085| v2.1.219 | Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `←` em um prompt vazio abre agent view do modo NORMAL assim como INSERT, e a dica `←` do rodapé mostra em modo NORMAL; antes desta versão o gesto e a dica eram apenas INSERT, e em modo NORMAL `←` em um prompt vazio não fazia nada. Digitar na entrada enquanto Claude Code aguarda colocar a sessão em background cancela a mudança com `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` então um rascunho digitado não é perdido. |

1086| v2.1.218 | Pressionar `←` dentro de dois segundos de uma exclusão que esvaziou o prompt, ou de mover através do histórico de prompts, mostra `Press ← again to open agents`, ou `Press ← again to go back to agents` em uma sessão anexada, e muda apenas em uma segunda pressão pelo menos um segundo depois; antes desta versão a pressão mudava imediatamente. Um `←` que chega dentro de entrada colada ou com script não dispara mais a mudança. Colocar uma sessão em primeiro plano em background com `←` mostra `Your conversation moved to the background` acima da lista, e `Esc` na raiz de agent view retorna para essa conversa em vez de sair para o shell, com duplo `Ctrl+C` permanecendo a saída; se a conversa não puder ser reabierta, Claude Code sai e imprime um comando `claude --resume` para ela. No Windows, um `←` pressionado dentro de cerca de meio segundo de se anexar mostra `Ambiguous ←, press again to detach` e desanexa na segunda pressão. |

1087| v2.1.217 | O badge de pull request na linha de uma sessão é renderizado como um hiperlink mesmo quando Claude Code não consegue detectar suporte a hiperlink de terminal, por exemplo sobre SSH ou tmux; defina [`FORCE_HYPERLINK=0`](/docs/pt/env-vars) para renderizá-lo como texto simples. Antes desta versão, o badge era renderizado como texto simples quando o suporte não era detectado. |

1088| v2.1.216 | `/fork`: a [confirmação](#from-inside-a-session) é uma linha, mostrando o estado da cópia, o nome de sua linha de agent-view, e seu ID de sessão para `claude attach`, terminando com `runs in the origin tree` ou `edits this checkout` apenas quando a cópia é executada na árvore de trabalho principal ou edita o checkout que você tem aberto. Clicar no nome coloca essa sessão em background e abre agent view na sessão da cópia. A confirmação não reafirma mais o modo de permissão herdado da cópia; versões anteriores imprimiam uma confirmação de múltiplas linhas sem nome clicável.<br /><br />Needs input: `/install-github-app` e a lista de configurações `/mcp`, executadas enquanto ninguém está anexado, mostram a sessão sob `Needs input` com uma linha nomeando o comando, e anexar e re-executar o comando continua; de v2.1.208 até v2.1.215 eles foram recusados completamente nesse estado.<br /><br />`--agent` restore: retomar ou reiniciar uma [sessão `--agent` colocada em background](#from-your-shell) restaura o prompt do sistema do agente e restrições de ferramentas, procurando no diretório da própria sessão pelo agente primeiro, quando seu workspace é confiável; uma sessão cujo agente não existe mais continua com as ferramentas padrão e prompt do sistema e abre com um aviso visível, em vez de silenciosamente reverter para o agente padrão.<br /><br />`Ctrl+X`: pressioná-lo duas vezes deleta uma sessão mesmo quando a tentativa de parada falha, em vez de uma parada falhada cancelar a exclusão pendente, e uma sessão deletada cujo processo worker tinha morrido não reaparece no próximo refresh.<br /><br />Worktree deletion: uma sessão cujo diretório de worktree não pertence a nenhum repositório git pode ser deletada; antes desta versão cada tentativa de deletar tal sessão era recusada. Um diretório que já se foi se limpa imediatamente. O double-press de agent view remove um diretório que ainda tem arquivos, executando seu hook `WorktreeRemove` para um diretório criado por hook, a menos que outro registro de sessão também o nomeie. `claude rm` mantém tal diretório sempre que arquivos permanecem. |

1089| v2.1.214 | Uma sessão colocada em background com `←` ou `/background` e deixada ociosa sem nada em execução tem seu processo parado como qualquer outra sessão ociosa, em vez de manter seu processo e o serviço de background em execução indefinidamente. Uma sessão concluída pode ser removida com `claude rm` ou a partir de agent view após o serviço de background ficar ocioso, e uma sessão que entrou em um worktree após ser despachada de um diretório que não é um repositório git, como uma pasta de workspace multi-repo, pode ser deletada a partir de agent view quando o próprio worktree pertence a um repositório git, porque a limpeza é resolvida a partir do worktree em vez do diretório de onde a sessão foi despachada; ambas as remoções foram recusadas em cada tentativa antes. Reabrir uma sessão parada restaura sua conversa salva mesmo quando uma pasta no armazenamento de transcrição não pode ser lida. |

1090| v2.1.213 | `/install-github-app`, a lista de configurações [`/mcp`](/docs/pt/mcp), e ações de autenticação MCP funcionam em uma sessão em background enquanto um terminal está anexado, e são recusadas apenas quando ninguém está anexado, com uma mensagem dizendo para você anexar e executar o comando novamente; de v2.1.208 até v2.1.212 eles foram recusados mesmo com um terminal anexado. |

1091| v2.1.212 | [`/fork` em uma sessão interativa](#from-inside-a-session) copia a conversa em uma nova sessão em background que aparece como sua própria linha, nomeada após a sessão de onde veio ou, para um fork solicitado de uma sessão sem nome, após o prompt do fork, enquanto a original continua em execução; o comportamento anterior de subagente forked de `/fork` se moveu para `/subtask`. Com [agent view desativado](#turn-off-agent-view), `/fork` mantém o comportamento de subagente forked. Uma linha focada que está aguardando seu primeiro prompt mostra `space to send it a prompt`. `Ctrl+J` insere uma nova linha na entrada de despacho em terminais com relatório de chave estendido, onde o pressionamento de chave foi previamente ignorado, e a sobreposição `?` lista o atalho. A dica de rodapé `←` em uma sessão interativa brevemente mostra `N done` quando uma sessão em background termina enquanto nenhuma precisa de sua entrada. Digitar um `/resume` simples em agent view abre um seletor de sessões passadas do repositório de onde você abriu agent view, incluindo sessões deletadas da lista, e escolher uma a retoma como uma sessão em background; antes desta versão `/resume` não estava disponível em agent view e sessões deletadas eram alcançáveis apenas com `claude --resume` ou `/resume` de uma sessão interativa. Formulários direcionados, com escopo e restritos mantêm a dica `attach to a session to run it` que versões anteriores mostravam para cada formulário. Sessões aguardando um prompt de rede-host de sandbox, uma solicitação de entrada MCP, ou um prompt de configurações gerenciadas mostram como `Needs input` em vez de `Working`, em agent view e em `claude agents --json`, e uma pergunta de Claude relata `waitingFor: input needed` em vez de `permission prompt`. Anexar a uma sessão cujo processo parou mostra sua transcrição formatada da forma que a sessão ao vivo a renderiza, em vez de como texto bruto. Uma sessão parada cuja transcrição está em um lugar inesperado retoma a partir dela via uma varredura de último recurso de suas transcrições salvas, e abrir uma linha que não tem transcrição salva mostra `Press enter again to restart this session fresh`, reiniciando-a fresca na segunda pressão; v2.1.211 mostrou a recusa sem forma de reiniciar a partir de agent view. |

1092| v2.1.211 | Acordar uma sessão parada anexando ou respondendo do diretório em que ela é executada encaminha novamente o gateway `ANTHROPIC_BASE_URL` do seu shell, sob as mesmas condições que um despacho fresco, então uma sessão autenticada através de um gateway `ANTHROPIC_AUTH_TOKEN` retoma no gateway em vez de relatar `Not logged in`. Anexar a uma sessão parada que foi colocada em background de outra conversa antes de sua primeira resposta terminar é recusado com `This session has no saved transcript` em vez de silenciosamente iniciar uma conversa em branco sob o mesmo session id; abrir a mesma linha a partir de agent view mostrou a recusa no rodapé. Terminar o processo de uma sessão `←` ou `/background` de fora do Claude Code a marca como parada em vez do supervisor reiniciá-la, uma parada já registrada no disco é honrada a menos que uma resposta que você enviou ainda esteja aguardando ser entregue, uma sessão reiniciada após um crash é informada que foi reiniciada, e uma sessão `←` ou `/background` reiniciada não retoma uma resposta interrompida mais antiga que cerca de uma hora. Uma resposta de nomeação de sessão que responde ou recusa o prompt em vez de rotulá-lo, como para um prompt que é principalmente um link, é descartada e a linha mantém um nome tirado do texto do prompt. Deletar uma sessão cujo git de worktree não reconhece mais tem sucesso, deixando o diretório de worktree no disco e nomeando seu caminho, em vez de cada tentativa ser recusada. Uma exclusão recusada mostra o motivo na linha da sessão, incluindo o erro git subjacente quando o worktree não pôde ser removido, em vez de a linha silenciosamente reaparecer. |

1093| v2.1.210 | `claude attach` aguarda enquanto o serviço de background está iniciando ou reconectando em vez de falhar com um erro `job not found` ou `still starting`, relata uma sessão que terminou durante o anexo como saída, e aplica um redimensionamento de terminal feito durante um anexo lento quando o anexo é concluído. A contagem de necessidades de entrada `←` do rodapé do prompt aparece em cada provedor, incluindo provedores de terceiros que anteriormente mostravam o formulário simples `← for agents`. Colocar uma sessão em background com `←` carrega a lista de tarefas de Claude para a sessão em background em vez de descartá-la. A linha em que você pressionou `←` mantém um nome em negrito, não atenuado após a seleção se mover. `claude agents --effort` aceita `ultracode` em vez de silenciosamente descartá-lo. |

815| v2.1.208 | Anexar a uma sessão cujo processo parou mostra a última tela cheia de sua transcrição enquanto o processo inicia, em vez de apenas uma nota de `Session is starting`. Uma resposta que não pode ser entregue porque o serviço de fundo está inacessível ou o envio falha é salva e enviada como o próximo prompt da sessão quando seu processo inicia novamente; antes desta versão, uma resposta perdida enquanto o serviço de fundo estava inacessível era descartada. Um processo cujo próprio binário foi substituído por uma atualização ainda pode iniciar o supervisor, a partir do inicializador `claude` instalado ou da versão mais recente no disco, em vez de falhar até que Claude Code fosse reiniciado. Um supervisor executando uma versão mais antiga nunca reinicia uma sessão ociosa iniciada por uma versão mais nova em seu próprio binário mais antigo. Deletar uma sessão remove seu worktree mesmo depois que a sessão moveu o worktree para uma branch diferente, e mantém o worktree junto com a linha da sessão quando o worktree tem commits que não foram enviados para lugar nenhum ou outra sessão o reclama, em vez de destruir os commits ou deixar o worktree órfão. `/install-github-app` e a lista de configurações `/mcp` e suas ações de autenticação são recusadas em uma sessão de fundo com uma mensagem nomeando a alternativa; em v2.1.208 apenas, o seletor `/model` foi recusado da mesma forma e um `/model <name>` digitado mudou apenas essa sessão em vez de também salvar seu modelo padrão. |1094| v2.1.208 | Anexar a uma sessão cujo processo parou mostra a última tela cheia de sua transcrição enquanto o processo inicia, em vez de apenas uma nota de `Session is starting`. Uma resposta que não pode ser entregue porque o serviço de fundo está inacessível ou o envio falha é salva e enviada como o próximo prompt da sessão quando seu processo inicia novamente; antes desta versão, uma resposta perdida enquanto o serviço de fundo estava inacessível era descartada. Um processo cujo próprio binário foi substituído por uma atualização ainda pode iniciar o supervisor, a partir do inicializador `claude` instalado ou da versão mais recente no disco, em vez de falhar até que Claude Code fosse reiniciado. Um supervisor executando uma versão mais antiga nunca reinicia uma sessão ociosa iniciada por uma versão mais nova em seu próprio binário mais antigo. Deletar uma sessão remove seu worktree mesmo depois que a sessão moveu o worktree para uma branch diferente, e mantém o worktree junto com a linha da sessão quando o worktree tem commits que não foram enviados para lugar nenhum ou outra sessão o reclama, em vez de destruir os commits ou deixar o worktree órfão. `/install-github-app` e a lista de configurações `/mcp` e suas ações de autenticação são recusadas em uma sessão de fundo com uma mensagem nomeando a alternativa; em v2.1.208 apenas, o seletor `/model` foi recusado da mesma forma e um `/model <name>` digitado mudou apenas essa sessão em vez de também salvar seu modelo padrão. |

816| v2.1.207 | O painel de espiada abre com a sentença que a linha trunca, como a pergunta exata para uma sessão que está aguardando você, e mostra quanto tempo uma sessão bloqueada está aguardando como uma única linha `waiting 3m` em vez de prefixar o mesmo timestamp para a sentença de status e a pergunta. Colar o mesmo texto novamente na entrada de despacho expande o placeholder `[Pasted text #N]` colapsado em vez de adicionar um segundo. Uma sessão em background nomeada ao aceitar um plano mostra esse nome em sua linha. Uma sessão em background que se moveu para um worktree mantém sua conversa quando seu processo é reiniciado a partir de agent view. |1095| v2.1.207 | O painel de espiada abre com a sentença que a linha trunca, como a pergunta exata para uma sessão que está aguardando você, e mostra quanto tempo uma sessão bloqueada está aguardando como uma única linha `waiting 3m` em vez de prefixar o mesmo timestamp para a sentença de status e a pergunta. Colar o mesmo texto novamente na entrada de despacho expande o placeholder `[Pasted text #N]` colapsado em vez de adicionar um segundo. Uma sessão em background nomeada ao aceitar um plano mostra esse nome em sua linha. Uma sessão em background que se moveu para um worktree mantém sua conversa quando seu processo é reiniciado a partir de agent view. |

817| v2.1.206 | Resumos de linha preenchem a largura restante da linha e truncam apenas na borda direita do terminal em vez de em 64 colunas. Depois que o supervisor reinicia em uma nova versão do Claude Code, ele reinicia as sessões em background ociosas restantes nessa versão em background em vez de algumas por minuto. Deletar uma sessão com `Ctrl+X` ou `claude rm` também a limpa da lista de sessão do supervisor, para que a linha não reapareça mais após um reinício do supervisor. |1096| v2.1.206 | Resumos de linha preenchem a largura restante da linha e truncam apenas na borda direita do terminal em vez de em 64 colunas. Depois que o supervisor reinicia em uma nova versão do Claude Code, ele reinicia as sessões em background ociosas restantes nessa versão em background em vez de algumas por minuto. Deletar uma sessão com `Ctrl+X` ou `claude rm` também a limpa da lista de sessão do supervisor, para que a linha não reapareça mais após um reinício do supervisor. Um override de corpo de solicitação `CLAUDE_CODE_EXTRA_BODY` exportado no shell de despacho alcança sessões em background em vez de ser ignorado. |

818| v2.1.205 | Resumos de linha mostram o relatório de uma linha da própria sessão, truncado em 64 colunas, em vez de uma invocação de ferramenta bruta ou uma contagem `done/total`; linhas agrupadas por diretório abrem com uma palavra de estado colorida. O painel de espiada abre com a sentença de status completa e, para uma sessão aguardando você, sua pergunta exata acima da entrada de resposta. Sessões que editam, comentam, fecham ou marcam um pull request como pronto com `gh` estão vinculadas a ele, não apenas aquelas que criam ou fazem checkout de um pull request, um push vincula um pull request mesmo quando o nome da branch local não corresponde, e um pull request cuja saída do comando de criação excedeu o limite inline também está vinculado. Um turno sem texto legível mantém o estado anterior da sessão em vez de revertê-lo para `Working`. `claude attach` aguarda até cerca de 60 segundos por uma sessão que está reiniciando, com uma linha de status nomeando o motivo, em vez de falhar. |1097| v2.1.205 | A dica `←` do rodapé do prompt em uma sessão regular `claude` conta os agentes em background aguardando você, como `← 2 agents`. Resumos de linha mostram o relatório de uma linha da própria sessão, truncado em 64 colunas, em vez de uma invocação de ferramenta bruta ou uma contagem `done/total`; linhas agrupadas por diretório abrem com uma palavra de estado colorida. O painel de espiada abre com a sentença de status completa e, para uma sessão aguardando você, sua pergunta exata acima da entrada de resposta. Sessões que editam, comentam, fecham ou marcam um pull request como pronto com `gh` estão vinculadas a ele, não apenas aquelas que criam ou fazem checkout de um pull request, um push vincula um pull request mesmo quando o nome da branch local não corresponde, e um pull request cuja saída do comando de criação excedeu o limite inline também está vinculado. Um turno sem texto legível mantém o estado anterior da sessão em vez de revertê-lo para `Working`. `claude attach` aguarda até cerca de 60 segundos por uma sessão que está reiniciando, com uma linha de status nomeando o motivo, em vez de falhar. |

819| v2.1.203 | Um gateway `ANTHROPIC_BASE_URL` exportado no shell de despacho alcança as sessões despachadas a partir dele no mesmo diretório quando o supervisor compartilha esse gateway environment, em vez de ser descartado enquanto a chave de API exportada junto com ele era mantida. O `PATH` do shell de despacho é aplicado a cada worker da sessão. Pressionar `←` enquanto subagentes estão em execução aguarda por eles em vez de reiniciá-los após dez segundos. A lista vazia sempre mostra os cabeçalhos da seção com uma descrição sob cada um. Digitar `@` na entrada de despacho também lista os git worktrees registrados do repositório de inicialização que vivem dentro de sua árvore de diretórios. Um esforço herdado da configuração `effortLevel` segue edições posteriores dessa configuração em vez de ser fixado no despacho. Abrir uma sessão parada cuja conversa já está aberta em outra sessão em execução é recusado com uma mensagem em vez de falhar na linha. Um comando que não está disponível em agent view deixa o texto digitado na entrada. Um hook `WorktreeCreate` que falha fora de um repositório git não bloqueia mais a sessão de editar arquivos. |1098| v2.1.203 | Um gateway `ANTHROPIC_BASE_URL` exportado no shell de despacho alcança as sessões despachadas a partir dele no mesmo diretório quando o supervisor compartilha esse gateway environment, em vez de ser descartado enquanto a chave de API exportada junto com ele era mantida. O `PATH` do shell de despacho é aplicado a cada worker da sessão. Pressionar `←` enquanto subagentes estão em execução aguarda por eles em vez de reiniciá-los após dez segundos. A lista vazia sempre mostra os cabeçalhos da seção com uma descrição sob cada um. Digitar `@` na entrada de despacho também lista os git worktrees registrados do repositório de inicialização que vivem dentro de sua árvore de diretórios. Um esforço herdado da configuração `effortLevel` segue edições posteriores dessa configuração em vez de ser fixado no despacho. Abrir uma sessão parada cuja conversa já está aberta em outra sessão em execução é recusado com uma mensagem em vez de falhar na linha. Um comando que não está disponível em agent view deixa o texto digitado na entrada. Um hook `WorktreeCreate` que falha fora de um repositório git não bloqueia mais a sessão de editar arquivos. |

820| v2.1.202 | Um nome definido com `/rename` ou `Ctrl+R` em uma sessão em background persiste quando o supervisor para e reinicia seu processo, em vez de reverter para o nome com o qual a sessão foi despachada. |1099| v2.1.202 | Um nome definido com `/rename` ou `Ctrl+R` em uma sessão em background persiste quando o supervisor para e reinicia seu processo, em vez de reverter para o nome com o qual a sessão foi despachada. |

821| v2.1.200 | Uma versão mais antiga do Claude Code que reescreve a lista de sessão em `roster.json` preserva campos escritos por uma versão mais nova, correspondendo à garantia existente de `state.json`, para que sessões iniciadas pela versão mais nova continuem aceitando entrada após o supervisor reiniciar. Quando você abre uma sessão que parou de responder, o supervisor reinicia seu processo e a sessão continua a resposta interrompida de onde parou. |1100| v2.1.200 | Uma versão mais antiga do Claude Code que reescreve a lista de sessão em `roster.json` preserva campos escritos por uma versão mais nova, correspondendo à garantia existente de `state.json`, para que sessões iniciadas pela versão mais nova continuem aceitando entrada após o supervisor reiniciar. Quando você abre uma sessão que parou de responder, o supervisor reinicia seu processo e a sessão continua a resposta interrompida de onde parou. Agent view aplica uma flag `--plugin-dir` colocada após `agents` a seu próprio subagente e autocomplete de skill na entrada de despacho assim como sessões despachadas. |

822| v2.1.199 | Uma sessão em background cujo processo sai antes de terminar de iniciar em um host com pouca memória mostra `possibly low memory — free some up and retry` no status de sua linha em vez de apenas o motivo de saída simples. Colocar uma sessão em background com `←` ou `/background` carrega seu `/color` para a nova linha. |1101| v2.1.199 | Uma sessão em background cujo processo sai antes de terminar de iniciar em um host com pouca memória mostra `possibly low memory — free some up and retry` no status de sua linha em vez de apenas o motivo de saída simples. Colocar uma sessão em background com `←` ou `/background` carrega seu `/color` para a nova linha. |

823| v2.1.198 | Agent view envia uma notificação através de `preferredNotifChannel` quando uma sessão em background precisa de entrada, termina ou falha, e dispara o hook `Notification` com o tipo `agent_needs_input` ou `agent_completed`. `←` e `/exit` dentro de `claude attach <id>` retornam para agent view em vez de sair para o shell; `Ctrl+Z` retorna para o shell. Uma sessão em background que isolou seu trabalho em um worktree faz commit, envia seu próprio branch isolado, nunca `main` ou `master`, e abre um pull request em rascunho quando termina em vez de perguntar primeiro. `/login` é executado em agent view e abre o diálogo de entrada. O diálogo de saída `Background work is running` oferece `Move to background and exit`. A entrega de saída também cobre subagentes em background, que retomam de sua transcrição no próximo despertar em vez de serem relatados como falhados. `claude --bg` combinado com `-p` ou `--print` é rejeitado com um erro. |1102| v2.1.198 | Agent view envia uma notificação através de `preferredNotifChannel` quando uma sessão em background precisa de entrada, termina ou falha, e dispara o hook `Notification` com o tipo `agent_needs_input` ou `agent_completed`. `←` e `/exit` dentro de `claude attach <id>` retornam para agent view em vez de sair para o shell; `Ctrl+Z` retorna para o shell. Uma sessão em background que isolou seu trabalho em um worktree faz commit, envia seu próprio branch isolado, nunca `main` ou `master`, e abre um pull request em rascunho quando termina em vez de perguntar primeiro. `/login` é executado em agent view e abre o diálogo de entrada. O diálogo de saída `Background work is running` oferece `Move to background and exit`. A entrega de saída também cobre subagentes em background, que retomam de sua transcrição no próximo despertar em vez de serem relatados como falhados. `claude --bg` combinado com `-p` ou `--print` é rejeitado com um erro. O host da sessão em background solicita permissão de Rede Local do macOS no primeiro acesso LAN em vez de falhar com `connect: no route to host`. |

824| v2.1.196 | Um único pressionamento de `←` coloca em background uma sessão em primeiro plano; versões anteriores exigiam dois pressionamentos, com uma dica de rodapé e uma confirmação. `--dangerously-skip-permissions` passado para `claude agents` mostra o aviso de bypass em vez de ser silenciosamente descartado. Sessões interativas que você nunca nomeou carregam um nome padrão como `my-app-3f` em listagens de sessão e `claude agents --json`. Comandos shell em background e workflows dinâmicos sobrevivem ao processo da sessão sendo interrompido, reiniciado ou atualizado, incluindo no Windows; defina `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desativar a entrega. Um transcript lido mal como vazio no reinício é renomeado com um sufixo `.orphaned-` em vez de ser deletado. |1103| v2.1.196 | Um único pressionamento de `←` coloca em background uma sessão em primeiro plano; versões anteriores exigiam dois pressionamentos, com uma dica de rodapé e uma confirmação. `--dangerously-skip-permissions` passado para `claude agents` mostra o aviso de bypass em vez de ser silenciosamente descartado. Sessões interativas que você nunca nomeou carregam um nome padrão como `my-app-3f` em listagens de sessão e `claude agents --json`. Comandos shell em background e workflows dinâmicos sobrevivem ao processo da sessão sendo interrompido, reiniciado ou atualizado, incluindo no Windows; defina `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desativar a entrega. Um transcript lido mal como vazio no reinício é renomeado com um sufixo `.orphaned-` em vez de ser deletado. |

825| v2.1.195 | O trabalho em andamento é transferido quando você coloca em background uma sessão no Windows também; defina `CLAUDE_DISABLE_ADOPT=1` para interrompê-lo em vez disso. O grupo `Completed` preenche o espaço vertical restante e o cabeçalho se compacta em terminais curtos. Uma versão mais antiga do Claude Code não descarta mais campos `state.json` mais novos ou oculta essas sessões de `claude agents`. Anexar a uma sessão parada muda imediatamente em vez de mostrar uma tela em branco por até cinco segundos. Um supervisor que não consegue aceitar conexões sai e libera seu bloqueio por conta própria. |1104| v2.1.195 | O trabalho em andamento é transferido quando você coloca em background uma sessão no Windows também; defina `CLAUDE_DISABLE_ADOPT=1` para interrompê-lo em vez disso. O grupo `Completed` preenche o espaço vertical restante e o cabeçalho se compacta em terminais curtos. Uma versão mais antiga do Claude Code não descarta mais campos `state.json` mais novos ou oculta essas sessões de `claude agents`. Anexar a uma sessão parada muda imediatamente em vez de mostrar uma tela em branco por até cinco segundos. Um supervisor que não consegue aceitar conexões sai e libera seu bloqueio por conta própria. |

1105| v2.1.191 | `claude --bg` com um nome `--agent` que não corresponde a nenhum de seus subagentes falha no lançamento: a sessão sai imediatamente com um erro `--agent '<name>' not found` em vez de executar com o agente padrão. |

826| v2.1.174 | Sessões em background não herdam mais variáveis de endpoint de gateway como `ANTHROPIC_BASE_URL` do shell de inicialização do supervisor; o supervisor fornece um snapshot de credencial fresco para workers pré-aquecidos, corrigindo erros espúrios de `Could not resolve authentication method`. |1106| v2.1.174 | Sessões em background não herdam mais variáveis de endpoint de gateway como `ANTHROPIC_BASE_URL` do shell de inicialização do supervisor; o supervisor fornece um snapshot de credencial fresco para workers pré-aquecidos, corrigindo erros espúrios de `Could not resolve authentication method`. |

827| v2.1.172 | `/model` na entrada de despacho define uma substituição de modelo de despacho com escopo de sessão. |1107| v2.1.172 | `/model` na entrada de despacho define uma substituição de modelo de despacho com escopo de sessão. |

828| v2.1.161 | Resumos de linha mostram uma contagem `done/total` para itens de trabalho paralelos; o painel de espiada nomeia o item de trabalho paralelo que está em execução há mais tempo. |1108| v2.1.161 | Resumos de linha mostram uma contagem `done/total` para itens de trabalho paralelos; o painel de espiada nomeia o item de trabalho paralelo que está em execução há mais tempo. |

amazon-bedrock.md +1 −1

Details

239 239

240A partir do Claude Code v2.1.181, a saída plana de `aws configure export-credentials --format process` também é aceita, com as mesmas chaves no nível superior em vez de aninhadas sob `Credentials`.240A partir do Claude Code v2.1.181, a saída plana de `aws configure export-credentials --format process` também é aceita, com as mesmas chaves no nível superior em vez de aninhadas sob `Credentials`.

241 241

242`Expiration` é opcional. A partir do Claude Code v2.1.176, quando o comando retorna um `Expiration` ISO 8601 válido, Claude Code armazena em cache as credenciais até cinco minutos antes desse tempo. Sem ele, ou em versões anteriores, as credenciais são armazenadas em cache por uma hora.242`Expiration` é opcional. Quando o comando retorna um `Expiration` ISO 8601 válido, Claude Code armazena em cache as credenciais até cinco minutos antes desse tempo. Sem ele, as credenciais são armazenadas em cache por uma hora.

243 243

244Quando você configura `awsCredentialExport` sem `awsAuthRefresh`, Claude Code usa as credenciais exportadas diretamente e não re-resolve a cadeia de provedor de credenciais padrão AWS na inicialização. Requer Claude Code v2.1.206 ou posterior.244Quando você configura `awsCredentialExport` sem `awsAuthRefresh`, Claude Code usa as credenciais exportadas diretamente e não re-resolve a cadeia de provedor de credenciais padrão AWS na inicialização. Requer Claude Code v2.1.206 ou posterior.

245 245

authentication.md +1 −6

Details

170* **`claude setup-token` e `/install-github-app`**: aplicam apenas `forceLoginMethod`, então eles podem cunhar um token em uma organização diferente170* **`claude setup-token` e `/install-github-app`**: aplicam apenas `forceLoginMethod`, então eles podem cunhar um token em uma organização diferente

171* **[Login do gateway](/docs/pt/claude-apps-gateway)**: selecionado por `forceLoginMethod: "gateway"` em vez de restringido por ele, e não autentica contra uma organização Anthropic, então `forceLoginOrgUUID` não se aplica; use seu provedor de identidade do gateway para restringir o acesso171* **[Login do gateway](/docs/pt/claude-apps-gateway)**: selecionado por `forceLoginMethod: "gateway"` em vez de restringido por ele, e não autentica contra uma organização Anthropic, então `forceLoginOrgUUID` não se aplica; use seu provedor de identidade do gateway para restringir o acesso

172 172

173Implante as chaves através de sua ferramenta de gerenciamento de dispositivos. [Configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) alcançam apenas contas que já estão autenticadas em sua organização, então elas não podem redirecionar o primeiro login de um desenvolvedor. Se sua organização também distribui configurações gerenciadas pelo servidor, defina as chaves em ambos os lugares: fontes de [configurações gerenciadas](/docs/pt/server-managed-settings#settings-precedence) não se mesclam, e as configurações gerenciadas pelo servidor em cache substituem o arquivo gerenciado pelo dispositivo, exceto por dois tipos de chaves que ainda preenchem de uma fonte perdedora:173Implante as chaves através de sua ferramenta de gerenciamento de dispositivos. [Configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) alcançam apenas contas que já estão autenticadas em sua organização, então elas não podem redirecionar o primeiro login de um desenvolvedor. Se sua organização também distribui configurações gerenciadas pelo servidor, defina as chaves em ambos os lugares: fontes de [configurações gerenciadas](/docs/pt/server-managed-settings#settings-precedence) não se mesclam, e as configurações gerenciadas pelo servidor em cache substituem o arquivo gerenciado pelo dispositivo, exceto por alguns [exceções por chave](/docs/pt/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` e os valores `"claudeai"` e `"console"` de `forceLoginMethod` não estão entre essas exceções, então mantenha-os em ambos os lugares.

~~174~~

175* **O bloco `env`**: [mescla por chave](/docs/pt/server-managed-settings#per-key-exceptions-across-managed-sources) no Claude Code v2.1.223 ou posterior

176* **As [chaves de bloqueio entre fontes](/docs/pt/server-managed-settings#per-key-exceptions-across-managed-sources)**: honradas de qualquer fonte de administrador

~~177~~

178`forceLoginMethod` e `forceLoginOrgUUID` não são nenhum dos dois, então mantenha-os em ambos os lugares.

179 174

180As chaves também decidem se uma sessão que não usa uma credencial de login pode iniciar. Veja [`forceLoginOrgUUID`](/docs/pt/settings-reference#forceloginorguuid) na referência de configurações para o comportamento completo.175As chaves também decidem se uma sessão que não usa uma credencial de login pode iniciar. Veja [`forceLoginOrgUUID`](/docs/pt/settings-reference#forceloginorguuid) na referência de configurações para o comportamento completo.

181 176

best-practices.md +0 −2

Details

568claude -p "<your prompt>" --output-format json | your_command568claude -p "<your prompt>" --output-format json | your_command

569```569```

570 570

571Use `--verbose` para depuração durante desenvolvimento e desligue em produção.

~~572~~

573<h3 id="run-autonomously-with-auto-mode">571<h3 id="run-autonomously-with-auto-mode">

574 Execute autonomamente com auto mode572 Execute autonomamente com auto mode

575</h3>573</h3>

chrome.md +2 −5

Details

124 Ferramentas do navegador no modo de plano124 Ferramentas do navegador no modo de plano

125</h3>125</h3>

126 126

127No [modo de plano](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), as chamadas de ferramentas do navegador que apenas leem a página ou o estado do navegador são executadas sem um prompt de permissão, e as chamadas que alteram o estado solicitam aprovação.127No [modo de plano](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), um prompt de permissão aparece antes de Claude gravar um GIF, abrir uma nova aba ou executar um atalho. Se o [modo de bypass de permissões estiver disponível](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) em sua sessão e a [busca de sinalizador de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching) estiver desativada, essas chamadas são executadas sem um prompt.

128 128

129* **Chamadas somente leitura**: `read_page`, `get_page_text`, `find`, leitura de mensagens do console ou solicitações de rede, e captura de tela129Uma chamada `tabs_context_mcp` também solicita quando define `createIfEmpty`, e o mesmo ocorre com uma chamada `browser_batch` que inclui qualquer uma dessas ações.

130* **Chamadas que alteram o estado**: cliques, digitação, navegação, gerenciamento de abas e janelas, e gravação de um GIF

~~131~~

132Uma chamada que de outra forma seria somente leitura também solicita aprovação quando define um sinalizador de entrada que altera o estado, como `createIfEmpty` em `tabs_context_mcp`, `clear` nos leitores de console e rede, ou `save_to_disk` em uma captura de tela. Uma chamada `browser_batch` é executada sem um prompt apenas quando cada ação dentro dela é somente leitura.

133 130

134<h2 id="example-workflows">131<h2 id="example-workflows">

135 Fluxos de trabalho de exemplo132 Fluxos de trabalho de exemplo

claude-code-on-the-web.md +2 −2

Details

87 `--cloud` cria sessões em nuvem. `--remote-control` não está relacionado: expõe uma sessão CLI local para monitoramento a partir da web. Veja [Remote Control](/docs/pt/remote-control).87 `--cloud` cria sessões em nuvem. `--remote-control` não está relacionado: expõe uma sessão CLI local para monitoramento a partir da web. Veja [Remote Control](/docs/pt/remote-control).

88</Note>88</Note>

89 89

90Use `/tasks` no Claude Code CLI para verificar o progresso, ou abra a sessão em claude.ai ou no aplicativo móvel Claude para interagir diretamente. De lá você pode orientar Claude, fornecer feedback ou responder perguntas como em qualquer outra conversa.90Abra a sessão em claude.ai ou no aplicativo móvel Claude para verificar o progresso ou interagir diretamente. De lá você pode orientar Claude, fornecer feedback ou responder perguntas como em qualquer outra conversa.

91 91

92Se Claude fizer uma pergunta e a sessão ficar ociosa, você ainda pode responder quando voltar, até [expiração do ambiente](#environment-expired), e a sessão continua a partir de sua resposta.92Se Claude fizer uma pergunta e a sessão ficar ociosa, você ainda pode responder quando voltar, até [expiração do ambiente](#environment-expired), e a sessão continua a partir de sua resposta.

93 93

115claude --cloud "Refactor the logger to use structured output"115claude --cloud "Refactor the logger to use structured output"

116```116```

117 117

118Monitore todas as sessões com `/tasks` no Claude Code CLI. Quando uma sessão é concluída, você pode criar um PR a partir da interface web ou [teleportar](#from-web-to-terminal) a sessão para seu terminal para continuar trabalhando.118Quando uma sessão é concluída, você pode criar um PR a partir da interface web ou [teleportar](#from-web-to-terminal) a sessão para seu terminal para continuar trabalhando.

119 119

120<h4 id="send-local-repositories-without-github">120<h4 id="send-local-repositories-without-github">

121 Envie repositórios locais sem GitHub121 Envie repositórios locais sem GitHub

claude-directory.md +2 −2

Details

1451O explorador cobre arquivos que você cria e edita. Alguns arquivos relacionados vivem em outro lugar:1451O explorador cobre arquivos que você cria e edita. Alguns arquivos relacionados vivem em outro lugar:

1452 1452

1454| ----------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

1457| Plugins instalados | `~/.claude/plugins` | Marketplaces clonados, versões de plugins instalados e dados por plugin, gerenciados por comandos `claude plugin`. Para um plugin instalado de um marketplace com [fonte `command`](/docs/pt/plugin-marketplaces#command-sources) em modo de link, Claude Code armazena links aqui em vez de uma cópia, e os arquivos do plugin permanecem no diretório que o comando imprime. Veja [cache de plugins](/docs/pt/plugins-reference#plugin-caching-and-file-resolution) para saber como versões órfãs são limpas. |1457| Plugins instalados | `~/.claude/plugins` | Marketplaces clonados, versões de plugins instalados e dados por plugin, gerenciados por comandos `claude plugin`. Para um plugin instalado de um marketplace com [fonte `command`](/docs/pt/plugin-marketplaces#command-sources) em modo de link, Claude Code armazena links aqui em vez de uma cópia, e os arquivos do plugin permanecem no diretório que o comando imprime. Uma fonte `command` requer Claude Code v2.1.229 ou posterior. Veja [cache de plugins](/docs/pt/plugins-reference#plugin-caching-and-file-resolution) para saber como versões órfãs são limpas. |

1458 1458

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

1460 1460

cloud-environments.md +5 −8

Details

540<AccordionGroup>540<AccordionGroup>

541 <Accordion title="Serviços Anthropic">541 <Accordion title="Serviços Anthropic">

542 * api.anthropic.com542 * api.anthropic.com

543 * statsig.anthropic.com

544 * docs.claude.com543 * docs.claude.com

545 * platform.claude.com544 * platform.claude.com

546 * code.claude.com545 * code.claude.com

612 * [www.java.net](http://www.java.net)611 * [www.java.net](http://www.java.net)

613 * download.oracle.com612 * download.oracle.com

614 * yum.oracle.com613 * yum.oracle.com

614 * \*.r2.cloudflarestorage.com

615 </Accordion>615 </Accordion>

616 616

617 <Accordion title="Gerenciadores de pacotes JavaScript e Node">617 <Accordion title="Gerenciadores de pacotes JavaScript e Node">

622 * npmjs.org622 * npmjs.org

623 * yarnpkg.com623 * yarnpkg.com

624 * registry.yarnpkg.com624 * registry.yarnpkg.com

625 * jsr.io

626 * npm.jsr.io

625 </Accordion>627 </Accordion>

626 628

627 <Accordion title="Gerenciadores de pacotes Python">629 <Accordion title="Gerenciadores de pacotes Python">

676 * central.maven.org678 * central.maven.org

677 * repo1.maven.org679 * repo1.maven.org

678 * repo.maven.apache.org680 * repo.maven.apache.org

681 * maven.google.com

679 * jcenter.bintray.com682 * jcenter.bintray.com

680 * gradle.org683 * gradle.org

681 * [www.gradle.org](http://www.gradle.org)684 * [www.gradle.org](http://www.gradle.org)

682 * services.gradle.org685 * services.gradle.org

683 * plugins.gradle.org686 * plugins.gradle.org

687 * plugins-artifacts.gradle.org

684 * kotlinlang.org688 * kotlinlang.org

685 * [www.kotlinlang.org](http://www.kotlinlang.org)689 * [www.kotlinlang.org](http://www.kotlinlang.org)

686 * spring.io690 * spring.io

758 </Accordion>762 </Accordion>

759 763

760 <Accordion title="Serviços na nuvem e monitoramento">764 <Accordion title="Serviços na nuvem e monitoramento">

761 * statsig.com

762 * [www.statsig.com](http://www.statsig.com)

763 * api.statsig.com

764 * sentry.io

765 * \*.sentry.io

766 * downloads.sentry-cdn.com

767 * http-intake.logs.datadoghq.com765 * http-intake.logs.datadoghq.com

768 * browser-intake-us5-datadoghq.com

769 * \*.datadoghq.com766 * \*.datadoghq.com

770 * \*.datadoghq.eu767 * \*.datadoghq.eu

771 * api.honeycomb.io768 * api.honeycomb.io

common-workflows.md +1 −1

Details

434| [Rotinas](/docs/pt/routines) | Nuvem, gerenciada pela Anthropic por padrão | Tarefas que devem ser executadas mesmo quando seu computador está desligado. Também podem ser acionadas por chamadas de API ou eventos do GitHub além de um cronograma. Configure em [claude.ai/code/routines](https://claude.ai/code/routines). |434| [Rotinas](/docs/pt/routines) | Nuvem, gerenciada pela Anthropic por padrão | Tarefas que devem ser executadas mesmo quando seu computador está desligado. Também podem ser acionadas por chamadas de API ou eventos do GitHub além de um cronograma. Configure em [claude.ai/code/routines](https://claude.ai/code/routines). |

435| [Tarefas agendadas no desktop](/docs/pt/desktop-scheduled-tasks) | Sua máquina, via aplicativo desktop | Tarefas que precisam de acesso direto a arquivos locais, ferramentas ou alterações não confirmadas. |435| [Tarefas agendadas no desktop](/docs/pt/desktop-scheduled-tasks) | Sua máquina, via aplicativo desktop | Tarefas que precisam de acesso direto a arquivos locais, ferramentas ou alterações não confirmadas. |

436| [GitHub Actions](/docs/pt/github-actions) | Seu pipeline de CI | Tarefas vinculadas a eventos de repositório como PRs abertos, ou cronogramas cron que devem viver junto com sua configuração de fluxo de trabalho. |436| [GitHub Actions](/docs/pt/github-actions) | Seu pipeline de CI | Tarefas vinculadas a eventos de repositório como PRs abertos, ou cronogramas cron que devem viver junto com sua configuração de fluxo de trabalho. |

437| [`/loop`](/docs/pt/scheduled-tasks) | A sessão CLI atual | Polling rápido enquanto uma sessão está aberta. As tarefas são canceladas quando você inicia uma nova conversa; `--resume` e `--continue` restauram as não expiradas. |437| [`/loop`](/docs/pt/scheduled-tasks) | A sessão CLI atual | Polling rápido enquanto uma sessão está aberta. `--resume` e `--continue` restauram loops de intervalo fixo não expirados. |

438 438

439<Tip>439<Tip>

440 Ao escrever prompts para tarefas agendadas, seja explícito sobre o que o sucesso parece e o que fazer com os resultados. A tarefa é executada autonomamente, então não pode fazer perguntas de esclarecimento. Por exemplo: "Review open PRs labeled `needs-review`, leave inline comments on any issues, and post a summary in the `#eng-reviews` Slack channel."440 Ao escrever prompts para tarefas agendadas, seja explícito sobre o que o sucesso parece e o que fazer com os resultados. A tarefa é executada autonomamente, então não pode fazer perguntas de esclarecimento. Por exemplo: "Review open PRs labeled `needs-review`, leave inline comments on any issues, and post a summary in the `#eng-reviews` Slack channel."

computer-use.md +2 −2

Details

112 Uma sessão por vez112 Uma sessão por vez

113</h3>113</h3>

114 114

115Apenas uma sessão por vez pode usar seu computador. Uma sessão adquire um bloqueio em toda a máquina em sua primeira ação de computer use e o libera quando a sessão sai, não quando a tarefa termina. A tentativa de computer use de uma segunda sessão falha com um erro nomeando a sessão que mantém o bloqueio. Saia dessa sessão primeiro.115Apenas uma sessão por vez pode usar seu computador. Uma sessão adquire um bloqueio em sua primeira ação de computer use e o libera quando a sessão sai, não quando a tarefa termina. A tentativa de computer use de uma segunda sessão falha com um erro nomeando a sessão que mantém o bloqueio. Saia dessa sessão primeiro.

116 116

117<h3 id="apps-are-hidden-while-claude-works">117<h3 id="apps-are-hidden-while-claude-works">

118 Os aplicativos são ocultados enquanto Claude trabalha118 Os aplicativos são ocultados enquanto Claude trabalha

134 Parar a qualquer momento134 Parar a qualquer momento

135</h3>135</h3>

136 136

137Quando Claude adquire o bloqueio, uma notificação do macOS aparece: "Claude is using your computer · press Esc to stop." Pressione `Esc` em qualquer lugar para abortar a ação atual imediatamente, ou pressione `Ctrl+C` no terminal. De qualquer forma, Claude para, mostra seus aplicativos novamente e retorna o controle a você. A sessão mantém o [bloqueio de computer use](#one-session-at-a-time) até que saia.137A primeira vez que Claude usa seu computador em cada vez, uma notificação do macOS aparece: "Claude is using your computer · press Esc to stop." Pressione `Esc` em qualquer lugar para abortar a ação atual imediatamente, ou pressione `Ctrl+C` no terminal. De qualquer forma, Claude para, mostra seus aplicativos novamente e retorna o controle a você. A sessão mantém o [bloqueio de computer use](#one-session-at-a-time) até que saia.

138 138

139Uma segunda notificação aparece quando Claude termina.139Uma segunda notificação aparece quando Claude termina.

140 140

costs.md +3 −2

Details

71 71

72Pressione `d` ou `w` para alternar entre as últimas 24 horas e os últimos 7 dias. As figuras são aproximadas e calculadas a partir do histórico de sessão local nesta máquina, portanto, o uso de outros dispositivos ou claude.ai não está incluído.72Pressione `d` ou `w` para alternar entre as últimas 24 horas e os últimos 7 dias. As figuras são aproximadas e calculadas a partir do histórico de sessão local nesta máquina, portanto, o uso de outros dispositivos ou claude.ai não está incluído.

73 73

74Na [extensão do VS Code](/docs/pt/vs-code#check-account-and-usage), as participações de atribuição e sinalizadores de comportamento aparecem no diálogo Account & usage com um alternador Day e Week, sem as linhas de Loops. Requer Claude Code v2.1.174 ou posterior.74Na [extensão do VS Code](/docs/pt/vs-code#check-account-and-usage), as participações de atribuição e sinalizadores de comportamento aparecem no diálogo Account & usage com um alternador Day e Week, sem as linhas de Loops.

75 75

76<h4 id="check-your-usage-credits-spend">76<h4 id="check-your-usage-credits-spend">

77 Verifique seu gasto em créditos de uso77 Verifique seu gasto em créditos de uso

222 Quando um desenvolvedor pergunta sobre um limite222 Quando um desenvolvedor pergunta sobre um limite

223</h3>223</h3>

224 224

225Desenvolvedores geralmente trazem perguntas sobre limites para seu administrador, então é útil saber qual teto eles atingiram. As quatro situações significam coisas diferentes:225Desenvolvedores geralmente trazem perguntas sobre limites para seu administrador, então é útil saber qual teto eles atingiram. Essas situações significam coisas diferentes:

226 226

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

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

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

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

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

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

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

desktop.md +7 −7

Details

24 24

25Para Windows ARM64, baixe o [instalador ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). No Linux, instale com apt; consulte [Claude Desktop no Linux](/docs/pt/desktop-linux).25Para Windows ARM64, baixe o [instalador ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). No Linux, instale com apt; consulte [Claude Desktop no Linux](/docs/pt/desktop-linux).

26 26

27Após instalar, inicie Claude, faça login e clique na aba **Code**. A primeira vez que você a abrir no Windows, você precisa ter o [Git for Windows](https://git-scm.com/downloads/win) instalado; reinicie o aplicativo após instalá-lo. Para um passo a passo de sua primeira sessão, consulte o [guia de primeiros passos](/docs/pt/desktop-quickstart).27Após instalar, inicie Claude, faça login e clique na aba **Code**. Para um passo a passo de sua primeira sessão, consulte o [guia de primeiros passos](/docs/pt/desktop-quickstart).

28 28

29Na aba Code, cada conversa é uma **sessão**: ela tem seu próprio histórico de chat, pasta de projeto e alterações de código, independente de qualquer outra sessão. A barra lateral lista suas sessões e permite que você execute várias em paralelo. Dentro de uma sessão você pode:29Na aba Code, cada conversa é uma **sessão**: ela tem seu próprio histórico de chat e pasta de projeto, independente de qualquer outra sessão. A barra lateral lista suas sessões e permite que você execute várias em paralelo. Dentro de uma sessão você pode:

30 30

31* [Revisar e comentar em diffs](#review-changes-with-diff-view), depois [monitorar o PR resultante através do CI](#monitor-pull-request-status)31* [Revisar e comentar em diffs](#review-changes-with-diff-view), depois [monitorar o PR resultante através do CI](#monitor-pull-request-status)

32* [Visualizar seu aplicativo em execução](#preview-your-app) no painel do navegador enquanto Claude verifica suas próprias alterações, e [abrir sites externos](#browse-external-sites) ao lado dele32* [Visualizar seu aplicativo em execução](#preview-your-app) no painel do navegador enquanto Claude verifica suas próprias alterações, e [abrir sites externos](#browse-external-sites) ao lado dele

372 Trabalhar em paralelo com sessões372 Trabalhar em paralelo com sessões

373</h3>373</h3>

374 374

375Clique em **+ New session** na barra lateral, ou pressione **Cmd+N** no macOS ou **Ctrl+N** no Windows, para trabalhar em múltiplas tarefas em paralelo. Pressione **Ctrl+Tab** e **Ctrl+Shift+Tab** para ciclar através de sessões na barra lateral. Para repositórios Git, cada sessão obtém sua própria cópia isolada do seu projeto usando [Git worktrees](/docs/pt/worktrees), para que alterações em uma sessão não afetem outras sessões até que você as faça commit.375Clique em **+ New session** na barra lateral, ou pressione **Cmd+N** no macOS ou **Ctrl+N** no Windows, para trabalhar em múltiplas tarefas em paralelo. Pressione **Ctrl+Tab** e **Ctrl+Shift+Tab** para ciclar através de sessões na barra lateral. Para repositórios Git, selecione a opção **worktree** ao lado do nome do branch para dar à sessão sua própria cópia isolada do seu projeto usando [Git worktrees](/docs/pt/worktrees), para que alterações em uma sessão não afetem outras sessões até que você as faça commit.

376 376

377Para visualizar duas sessões ao mesmo tempo, mantenha **Cmd** no macOS ou **Ctrl** no Windows e clique em uma sessão na barra lateral. A sessão abre em um segundo painel ao lado daquele que você já tem aberto. Enquanto a divisão está ativa, clicar em outra sessão da barra lateral substitui o painel que tem foco. Pressione **Cmd+\\** no macOS ou **Ctrl+\\** no Windows para fechar o painel focado e retornar a uma única sessão.377Para visualizar duas sessões ao mesmo tempo, mantenha **Cmd** no macOS ou **Ctrl** no Windows e clique em uma sessão na barra lateral. A sessão abre em um segundo painel ao lado daquele que você já tem aberto. Enquanto a divisão está ativa, clicar em outra sessão da barra lateral substitui o painel que tem foco. Pressione **Cmd+\\** no macOS ou **Ctrl+\\** no Windows para fechar o painel focado e retornar a uma única sessão.

378 378

381Para incluir arquivos gitignored como `.env` em novos worktrees, crie um [arquivo `.worktreeinclude`](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) na raiz do seu projeto.381Para incluir arquivos gitignored como `.env` em novos worktrees, crie um [arquivo `.worktreeinclude`](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) na raiz do seu projeto.

382 382

383<Note>383<Note>

384 O isolamento de sessão requer [Git](https://git-scm.com/downloads). A maioria dos Macs inclui Git por padrão. Execute `git --version` no Terminal para verificar; se imprimir um número de versão, Git está instalado. No Windows, Git é necessário para a aba Code funcionar: [baixe Git para Windows](https://git-scm.com/downloads/win), instale-o e reinicie o aplicativo. Se você encontrar erros de Git, peça a Claude na aba [Cowork](https://claude.com/product/cowork) para ajudar a solucionar problemas de sua configuração.384 O isolamento de sessão requer [Git](https://git-scm.com/downloads). A maioria dos Macs inclui Git por padrão. Execute `git --version` no Terminal para verificar; se imprimir um número de versão, Git está instalado. Se você encontrar erros de Git, peça a Claude na aba [Cowork](https://claude.com/product/cowork) para ajudar a solucionar problemas de sua configuração.

385</Note>385</Note>

386 386

387Use os controles no topo da barra lateral para filtrar sessões por status, projeto ou ambiente, e para agrupar sessões por projeto. Para renomear uma sessão, clique no título da sessão na barra de ferramentas no topo da sessão ativa.387Use os controles no topo da barra lateral para filtrar sessões por status, projeto ou ambiente, e para agrupar sessões por projeto. Para renomear uma sessão, clique no título da sessão na barra de ferramentas no topo da sessão ativa.

838| `disableAutoMode` | defina como `"disable"` para remover o modo [Auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) do seletor de modo. Também aceito em `permissions`. |838| `disableAutoMode` | defina como `"disable"` para remover o modo [Auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) do seletor de modo. Também aceito em `permissions`. |

839| `autoMode` | customize o que o classificador de modo auto confia e bloqueia em sua organização. Veja [Configurar o modo auto](/docs/pt/auto-mode-config). |839| `autoMode` | customize o que o classificador de modo auto confia e bloqueia em sua organização. Veja [Configurar o modo auto](/docs/pt/auto-mode-config). |

840| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |840| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |

841| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](/docs/pt/desktop-ios-simulator#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. |841| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](/docs/pt/desktop-ios-simulator#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |

842| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |842| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |

843| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no dropdown de ambiente. Usuários não podem editar ou excluir conexões gerenciadas. |843| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no dropdown de ambiente. Usuários não podem editar ou excluir conexões gerenciadas. |

844| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Uma matriz vazia desativa sessões SSH. Lido apenas de configurações gerenciadas. |844| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Uma matriz vazia desativa sessões SSH. Lido apenas de configurações gerenciadas. |

1093 Erros de Git e Git LFS1093 Erros de Git e Git LFS

1094</h3>1094</h3>

1095 1095

1096No Windows, Git é necessário para a aba Code iniciar sessões locais. Se você vê "Git is required," instale [Git para Windows](https://git-scm.com/downloads/win) e reinicie o aplicativo.1096Sessões que executam em seu próprio worktree precisam de Git. Se você vê "Git is required," instale [Git](https://git-scm.com/downloads), ou [Git para Windows](https://git-scm.com/downloads/win) no Windows, e tente novamente. No Windows, versões do Claude Desktop anteriores a 1.49585.0 pediam Git antes de iniciar qualquer sessão local; se você vê esse prompt e não está usando worktrees, atualize o aplicativo.

1097 1097

1098Se você vê "Git LFS is required by this repository but is not installed," instale Git LFS de [git-lfs.com](https://git-lfs.com/), execute `git lfs install` e reinicie o aplicativo.1098Se você vê "Git LFS is required by this repository but is not installed," instale Git LFS de [git-lfs.com](https://git-lfs.com/), execute `git lfs install` e reinicie o aplicativo.

1099 1099

desktop-quickstart.md +2 −2

Details

65 Selecione **Local** para executar Claude em sua máquina usando seus arquivos diretamente. Clique em **Select folder** e escolha o diretório do seu projeto.65 Selecione **Local** para executar Claude em sua máquina usando seus arquivos diretamente. Clique em **Select folder** e escolha o diretório do seu projeto.

66 66

67 <Tip>67 <Tip>

68 Comece com um pequeno projeto que você conhece bem. É a forma mais rápida de ver o que Claude Code pode fazer. No Windows, [Git](https://git-scm.com/downloads/win) deve estar instalado para que as sessões locais funcionem. A maioria dos Macs inclui Git por padrão.68 Comece com um pequeno projeto que você conhece bem. É a forma mais rápida de ver o que Claude Code pode fazer.

69 </Tip>69 </Tip>

70 70

71 Você também pode selecionar:71 Você também pode selecionar:

86 * `Add tests for the main function`86 * `Add tests for the main function`

87 * `Create a CLAUDE.md with instructions for this codebase`87 * `Create a CLAUDE.md with instructions for this codebase`

88 88

89 Uma [session](/docs/pt/desktop#work-in-parallel-with-sessions) é uma conversa com Claude sobre seu código. Cada sessão rastreia seu próprio contexto e alterações, para que você possa trabalhar em várias tarefas sem que elas interfiram uma com a outra.89 Uma [session](/docs/pt/desktop#work-in-parallel-with-sessions) é uma conversa com Claude sobre seu código. Cada sessão rastreia seu próprio contexto e alterações.

90 </Step>90 </Step>

91 91

92 <Step title="Revise e aceite as alterações">92 <Step title="Revise e aceite as alterações">

env-vars.md +396 −260

Details

6 6

7> Referência para variáveis de ambiente que controlam o comportamento do Claude Code.7> Referência para variáveis de ambiente que controlam o comportamento do Claude Code.

8 8

9As variáveis de ambiente podem controlar o comportamento do Claude Code, como seleção de modelo, autenticação, roteamento de solicitações e alternâncias de recursos. Muitos dos mesmos comportamentos também podem ser configurados através de um campo de [arquivo de configurações](/docs/pt/settings), uma [flag CLI](/docs/pt/cli-reference) ou um comando em sessão como `/model`.9Variáveis de ambiente podem controlar o comportamento do Claude Code, como seleção de modelo, autenticação, roteamento de requisições e alternâncias de recursos. Muitos dos mesmos comportamentos também podem ser configurados através de um [campo de arquivo de configurações](/docs/pt/settings), um [sinalizador CLI](/docs/pt/cli-reference) ou um comando em sessão como `/model`.

10 10

11Esta página aborda como:11Esta página aborda como:

12 12

~~13* [Definir variáveis de ambiente](#set-environment-variables) no seu shell ou em um arquivo de configurações~~13* [Definir variáveis de ambiente](#set-environment-variables) em seu shell ou em um arquivo de configurações

14* [Verificar qual valor se aplica](#precedence) quando um comportamento pode ser definido de mais de uma forma14* [Verificar qual valor se aplica](#precedence) quando um comportamento pode ser definido de mais de uma forma

15* [Procurar as variáveis que Claude Code lê](#variables)15* [Procurar as variáveis que Claude Code lê](#variables)

16* [Ver quais recursos deixam de funcionar](#features-that-need-feature-flag-fetching) quando uma variável desativa a busca de sinalizadores de recursos

16 17

17<h2 id="set-environment-variables">18<h2 id="set-environment-variables">

18 Definir variáveis de ambiente19 Definir variáveis de ambiente

33 claude34 claude

34 ```35 ```

35 36

~~36 Para defini-la para cada sessão, adicione a linha `export` a `~/.bashrc`, `~/.zshrc` ou arquivo de perfil do seu shell.~~37 Para defini-la para cada sessão, adicione a linha `export` a `~/.bashrc`, `~/.zshrc`, ou ao arquivo de perfil do seu shell.

37 </Tab>38 </Tab>

38 39

39 <Tab title="Windows PowerShell">40 <Tab title="Windows PowerShell">

55 </Tab>56 </Tab>

56</Tabs>57</Tabs>

57 58

59A linha de atribuição não imprime nada em caso de sucesso, então confirme se a variável está definida imprimindo-a no mesmo shell antes de executar `claude`:

61<Tabs>

62 <Tab title="macOS, Linux, WSL">

63 ```bash theme={null}

64 echo $API_TIMEOUT_MS

65 ```

66 </Tab>

68 <Tab title="Windows PowerShell">

69 ```powershell theme={null}

70 echo $env:API_TIMEOUT_MS

71 ```

72 </Tab>

74 <Tab title="Windows CMD">

75 ```batch theme={null}

76 echo %API_TIMEOUT_MS%

77 ```

78 </Tab>

79</Tabs>

58<h3 id="in-settings-files">81<h3 id="in-settings-files">

59 Em arquivos de configurações82 Em arquivos de configurações

60</h3>83</h3>

61 84

62Adicione variáveis sob a chave `env` em um arquivo `settings.json`. Claude Code as lê diretamente do arquivo na inicialização, então elas entram em efeito não importa como `claude` foi iniciado.85Adicione variáveis sob a chave `env` em um arquivo `settings.json`, criando o arquivo se ele não existir. Claude Code as lê diretamente do arquivo, então elas entram em vigor independentemente de como `claude` foi iniciado. Uma sessão em execução aplica valores novos e alterados ao seu ambiente quando você salva o arquivo, mas um recurso que lê suas variáveis uma vez na inicialização, como [monitoramento OpenTelemetry](/docs/pt/monitoring-usage), mantém seus valores de inicialização até que você reinicie. Remover uma variável do arquivo não a desativa em uma sessão em execução; a remoção entra em vigor na próxima vez que você iniciar `claude`.

63 86

64```json ~/.claude/settings.json theme={null}87```json ~/.claude/settings.json theme={null}

65{88{

70}93}

71```94```

72 95

~~73O arquivo que você escolhe controla para quem as variáveis se aplicam:~~96O arquivo que você escolhe controla a quem as variáveis se aplicam:

74 97

75| Arquivo | Aplica-se a |98| Arquivo | Aplica-se a |

~~76| :---------------------------- | :----------------------------------------------------------------------------------- |~~99| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |

~~79| `.claude/settings.local.json` | Você, apenas neste projeto (adicione-o ao seu gitignore se você o criar manualmente) |~~102| `.claude/settings.local.json` | Você, apenas neste projeto, ignorado pelo git quando Claude Code salva uma configuração nele; adicione-o ao seu gitignore se você o criar manualmente |

80| Configurações gerenciadas | Todos na sua organização, implantados por um administrador |103| Configurações gerenciadas | Todos na sua organização, implantados por um administrador |

81 104

82Veja [Arquivos de configurações](/docs/pt/settings#settings-files) para onde cada arquivo reside e [Precedência de configurações](/docs/pt/settings#settings-precedence) para como eles se combinam quando mais de um define a mesma variável.105Veja [Arquivos de configurações](/docs/pt/settings#where-settings-live) para saber onde cada arquivo fica e [Precedência de configurações](/docs/pt/settings#settings-precedence) para saber como eles se combinam quando mais de um define a mesma variável.

83 106

84<h2 id="precedence">107<h2 id="precedence">

85 Precedência108 Precedência

86</h2>109</h2>

87 110

88Quando o mesmo comportamento tem tanto uma variável de ambiente quanto um campo de configurações, a variável de ambiente tem precedência. Por exemplo, `ANTHROPIC_MODEL` substitui a configuração `model`, e `CLAUDE_CODE_AUTO_CONNECT_IDE` substitui `autoConnectIde`. O campo de configurações se aplica quando a variável de ambiente não está definida.111Alguns comportamentos têm tanto uma variável de ambiente quanto uma chave de configurações dedicada, e qual delas Claude Code lê primeiro difere por chave. Para `ANTHROPIC_MODEL` e `CLAUDE_CODE_AUTO_CONNECT_IDE`, Claude Code lê a variável primeiro e usa a configuração `model` ou `autoConnectIde` apenas quando a variável não está definida. Para o par que você está configurando, verifique a linha da variável abaixo e a entrada da chave na [referência de configurações](/docs/pt/settings-reference).

112

113Quando a mesma variável está definida tanto no seu shell quanto em um bloco `env` do arquivo de configurações, o valor do arquivo de configurações se aplica. Claude Code escreve cada entrada `env` no ambiente do processo, substituindo o valor herdado do shell. A [configuração `env`](/docs/pt/settings-reference#when-claude-code-applies-env-values) diz quando ela se aplica. Algumas variáveis são casos especiais; a [configuração `env`](/docs/pt/settings-reference#env) lista as exceções.

89 114

90Quando a mesma variável é definida tanto no seu shell quanto em um arquivo de configurações no bloco `env`, o valor do arquivo de configurações se aplica. Claude Code escreve cada entrada `env` no ambiente do processo na inicialização, substituindo o valor herdado do shell. Algumas variáveis são tratadas como casos especiais; a [configuração `env`](/docs/pt/settings#available-settings) lista as exceções.115Em um arquivo de configurações você pode definir uma variável, mas não pode remover uma. Para substituir uma variável que você não pode desativar, como uma `CLAUDE_CODE_USE_VERTEX` obsoleta exportada por um perfil de shell que você não controla, defina-a como uma string vazia no bloco `env`: `"CLAUDE_CODE_USE_VERTEX": ""`. Claude Code trata o valor vazio como não definido para seleção de provedor. Subprocessos ainda herdam o valor vazio.

91 116

92Entre arquivos de configurações, os valores `env` seguem a [precedência de configurações](/docs/pt/settings#settings-precedence), então uma entrada de configurações gerenciada substitui a mesma variável nas configurações de usuário ou projeto.117Entre arquivos de configurações, os valores `env` seguem a [precedência de configurações](/docs/pt/settings#settings-precedence), então uma entrada de configurações gerenciada substitui a mesma variável nas configurações de usuário ou projeto.

93 118

94Como uma variável de ambiente interage com flags CLI e comandos em sessão varia por recurso: `--model` e `/model` substituem `ANTHROPIC_MODEL`, enquanto `CLAUDE_CODE_EFFORT_LEVEL` substitui `/effort`. Quando uma variável interage com outra fonte de configuração, sua linha na lista [Variáveis](#variables) declara a precedência ou vincula à página que a documenta.119Como uma variável de ambiente interage com sinalizadores CLI e comandos em sessão varia por recurso: `--model` e `/model` substituem `ANTHROPIC_MODEL`, enquanto `CLAUDE_CODE_EFFORT_LEVEL` substitui `--effort` e `/effort`. Quando uma variável interage com outra fonte de configuração, sua linha na lista [Variáveis](#variables) declara a precedência ou vincula à página que a documenta.

95 120

~~96Claude Code lê variáveis de ambiente na inicialização, então as mudanças entram em efeito na próxima vez que você inicia `claude`.~~121Claude Code lê variáveis de ambiente do shell na inicialização, então as alterações nelas entram em vigor na próxima vez que você inicia `claude`. As variáveis definidas sob a chave `env` em arquivos de configurações são reaplicadas a uma sessão em execução quando o arquivo muda, com a exceção somente na inicialização descrita em [Em arquivos de configurações](#in-settings-files).

97 122

98<h2 id="variables">123<h2 id="variables">

99 Variáveis124 Variáveis

100</h2>125</h2>

101 126

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

128

129<Note>

130 Para variáveis que ativam ou desativam um comportamento, defina `1` ou `true` para ativar e `0` ou `false` para desativar, em qualquer capitalização.

131

132 Algumas variáveis leem apenas se você as definiu, então qualquer valor não vazio, incluindo `0`, ativa o comportamento, e você desativa o comportamento desconfigurado a variável ou definindo-a como um valor vazio. Essas variáveis funcionam dessa forma:

133

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`

136 * `DISABLE_ERROR_REPORTING`

137 * `CLAUDE_CODE_TMUX_TRUECOLOR`

138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`

140

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

142</Note>

143

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

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

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

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

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

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

109| `ANTHROPIC_BASE_URL` | Substitua o endpoint da API para rotear solicitações através de um proxy ou gateway. Quando definido para um host que não é de primeira parte, [busca de ferramentas MCP](/docs/pt/mcp#scale-with-mcp-tool-search) é desabilitada por padrão. Defina `ENABLE_TOOL_SEARCH=true` se seu proxy encaminha blocos `tool_reference`. A partir de v2.1.196, [Remote Control](/docs/pt/remote-control#requirements) é desabilitado quando isso aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento em Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |151| `ANTHROPIC_BASE_URL` | Substitua o endpoint da API para rotear solicitações através de um proxy ou gateway. Quando definido para um host que não é de primeira parte, [busca de ferramentas MCP](/docs/pt/mcp#scale-with-mcp-tool-search) é desabilitada por padrão. Defina `ENABLE_TOOL_SEARCH=true` se seu proxy encaminha blocos `tool_reference`. A partir da v2.1.196, [Remote Control](/docs/pt/remote-control#requirements) é desabilitado quando isso aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento no Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |

110| `ANTHROPIC_BEDROCK_BASE_URL` | Substitua a URL do endpoint Amazon Bedrock. Use para endpoints Amazon Bedrock personalizados ou ao rotear através de um [gateway LLM](/docs/pt/llm-gateway). Veja [Amazon Bedrock](/docs/pt/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Substitua a URL do endpoint Amazon Bedrock. Use para endpoints Amazon Bedrock personalizados ou ao rotear através de um [gateway LLM](/docs/pt/llm-gateway). Veja [Amazon Bedrock](/docs/pt/amazon-bedrock) |

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

112| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [service tier](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` ou `priority`). Enviado como cabeçalho `X-Amzn-Bedrock-Service-Tier`. Veja [Amazon Bedrock](/docs/pt/amazon-bedrock#service-tiers) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefixo do perfil de inferência entre regiões (`us`, `eu`, `apac`, `jp`, `au`, ou `global`) que Claude Code tenta primeiro em vez do derivado da região AWS. Ignorado em regiões AWS GovCloud. Requer Claude Code v2.1.224 ou posterior. Veja [Amazon Bedrock](/docs/pt/amazon-bedrock#cross-region-inference-profile-prefixes) |

113| `ANTHROPIC_BETAS` | Lista separada por vírgula de valores de cabeçalho `anthropic-beta` adicionais para incluir em solicitações de API. Claude Code já envia os cabeçalhos beta que precisa; use isso para optar por um [beta da API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) antes que Claude Code adicione suporte nativo. Diferentemente da flag [`--betas`](/docs/pt/cli-reference#cli-flags), que requer autenticação de chave de API, essa variável funciona com todos os métodos de autenticação, incluindo assinatura Claude.ai |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Nível de serviço](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex`, ou `priority`). Enviado como o cabeçalho `X-Amzn-Bedrock-Service-Tier`. Veja [Amazon Bedrock](/docs/pt/amazon-bedrock#service-tiers) |

114| `ANTHROPIC_CUSTOM_HEADERS` | Cabeçalhos personalizados para adicionar às solicitações (formato `Name: Value`, separados por quebra de linha para múltiplos cabeçalhos) |156| `ANTHROPIC_BETAS` | Lista separada por vírgulas de valores de cabeçalho `anthropic-beta` adicionais para incluir em solicitações de API. Claude Code já envia os cabeçalhos beta que precisa; use isso para optar por um [beta da API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) antes de Claude Code adicionar suporte nativo. Diferentemente da flag [`--betas`](/docs/pt/cli-reference#cli-flags), que requer autenticação de chave de API, essa variável funciona com todos os métodos de autenticação, incluindo assinatura Claude.ai |

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

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

116| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrição de exibição para a entrada de modelo personalizado no seletor `/model`. Padrão é `Custom model (<model-id>)` quando não definido |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrição de exibição para a entrada de modelo personalizado no seletor `/model`. Padrão é `Custom model (<model-id>)` quando não definido |

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

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

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

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

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

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

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

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

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

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

127| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Veja [Configuração de modelo](/docs/pt/model-config#environment-variables) |170| `ANTHROPIC_DEFAULT_MODEL` | Modelo em que novas sessões começam por padrão. Requer Claude Code v2.1.236 ou posterior. Veja [Defina um modelo padrão para novas sessões](/docs/pt/model-config#set-a-default-model-for-new-sessions) |

128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID do modelo que o alias `opus` resolve, e que `opusplan` usa enquanto Plan Mode está ativo. Veja [Configuração de modelo](/docs/pt/model-config#environment-variables) |

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

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

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

132| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID do modelo que o alias `sonnet` resolve, e que `opusplan` usa quando Plan Mode não está ativo. Veja [Configuração de modelo](/docs/pt/model-config#environment-variables) |

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

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

135| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação do Microsoft Foundry (veja [Microsoft Foundry](/docs/pt/microsoft-foundry)) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por vírgulas de [capacidades](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) que o modelo Sonnet fixado suporta, por exemplo `effort,thinking`. Veja [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

136| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Token Bearer para autenticação do Microsoft Foundry, como um token de acesso Microsoft Entra. Claude Code o envia como cabeçalho `Authorization: Bearer`. Tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` e sobre a cadeia de credencial padrão do Azure. Veja [Microsoft Foundry](/docs/pt/microsoft-foundry). Requer Claude Code v2.1.203 ou posterior |179| `ANTHROPIC_FEDERATION_RULE_ID` | ID da regra de federação para [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando você a define junto com `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleciona credenciais de federação, que têm precedência sobre sua credencial `/login`. Veja [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |

137| `ANTHROPIC_FOUNDRY_BASE_URL` | URL base completa para o recurso Microsoft Foundry (por exemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa para `ANTHROPIC_FOUNDRY_RESOURCE` (veja [Microsoft Foundry](/docs/pt/microsoft-foundry)) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação Microsoft Foundry (veja [Microsoft Foundry](/docs/pt/microsoft-foundry)) |

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

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

138| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome do recurso Microsoft Foundry (por exemplo, `my-resource`). Obrigatório se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definido (veja [Microsoft Foundry](/docs/pt/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome do recurso Microsoft Foundry (por exemplo, `my-resource`). Obrigatório se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definido (veja [Microsoft Foundry](/docs/pt/microsoft-foundry)) |

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

140| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Nome do [modelo da classe Haiku para tarefas em segundo plano](/docs/pt/costs) |185| `ANTHROPIC_ORGANIZATION_ID` | ID da organização para [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Defina junto com `ANTHROPIC_FEDERATION_RULE_ID`. Veja [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |

141| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Substitua a região AWS para o modelo da classe Haiku ao usar Amazon Bedrock ou Amazon Bedrock Mantle. Em Amazon Bedrock, isso só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou o descontinuado `ANTHROPIC_SMALL_FAST_MODEL` também está definido, já que Amazon Bedrock de outra forma executa tarefas em segundo plano no [modelo Sonnet padrão ou modelo primário](/docs/pt/amazon-bedrock#4-pin-model-versions) na região da sessão |186| `ANTHROPIC_PROFILE` | Nome do perfil Anthropic para autenticar, como um criado por [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) ou por [entrar em uma conta Console sem uma chave de API](/docs/pt/authentication#sign-in-without-an-api-key). Veja [precedência de autenticação](/docs/pt/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Nome de [modelo classe Haiku para tarefas em segundo plano](/docs/pt/costs) |

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

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

143| `ANTHROPIC_VERTEX_PROJECT_ID` | ID do projeto GCP para solicitações Google Cloud's Agent Platform. Substituído por `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` ou o projeto no seu arquivo de credenciais `GOOGLE_APPLICATION_CREDENTIALS`. Veja [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID do projeto GCP para o qual as solicitações Google Cloud's Agent Platform são endereçadas. Veja [Configurar credenciais GCP](/docs/pt/google-vertex-ai#3-configure-gcp-credentials) |

144| `ANTHROPIC_WORKSPACE_ID` | ID do workspace para [federação de identidade de carga de trabalho](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Defina isso quando sua regra de federação está no escopo de mais de um workspace para que a troca de token saiba qual workspace direcionar |191| `ANTHROPIC_WORKSPACE_ID` | ID do workspace para [federação de identidade de carga de trabalho](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Defina isso quando sua regra de federação está no escopo de mais de um workspace para que a troca de token saiba qual workspace direcionar |

145| `API_FORCE_IDLE_TIMEOUT` | Substitua o tempo limite de inatividade de 5 minutos que aborta uma resposta de modelo de streaming quando nenhum byte chega. Defina como `0` para desabilitar o tempo limite, por exemplo, quando um [gateway](/docs/pt/llm-gateway) lento ou modelo local pausa por mais de 5 minutos entre chunks. Defina como `1` para manter o tempo limite em cada provedor. Quando não definido, o tempo limite está inativo em conexões diretas da API Anthropic e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), onde o próprio watchdog de stream de nível de byte do Claude Code é executado, e ativo em cada outro provedor, incluindo [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry), [Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/docs/pt/amazon-bedrock) e conexões de gateway, para que um stream travado seja abortado em vez de ficar pendurado. A partir de v2.1.169 |192| `API_FORCE_IDLE_TIMEOUT` | Substitua o timeout de inatividade do corpo de 5 minutos que aborta uma resposta de modelo de streaming quando nenhum byte chega. Defina como `0` para desativar o timeout, por exemplo quando um [gateway](/docs/pt/llm-gateway) lento ou modelo local pausa por mais de 5 minutos entre chunks, ou `1` para mantê-lo ativo para cada provedor. Quando não definido, o timeout está ativo em provedores diferentes da API Anthropic direta e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Os [watchdogs de stream](/docs/pt/network-config#streaming-idle-watchdogs) funcionam independentemente e abortam uma pausa longa silenciosa mesmo quando você define `0` aqui |

146| `API_TIMEOUT_MS` | Tempo limite para solicitações de API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente isso quando as solicitações expiram em redes lentas ou ao rotear através de um proxy. Valores acima do máximo causam overflow do temporizador subjacente e fazem com que as solicitações falhem imediatamente |193| `API_TIMEOUT_MS` | Timeout para solicitações de API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente isso quando as solicitações expiram em redes lentas ou ao rotear através de um proxy. Valores acima do máximo transbordam o timer subjacente e causam falha imediata nas solicitações |

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

149| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres nas saídas bash antes da saída completa ser salva em um arquivo e Claude receber o caminho mais uma visualização curta. Veja [Comportamento da ferramenta Bash](/docs/pt/tools-reference#bash-tool-behavior) |196| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres de saída bash que Claude Code lê de volta para o resultado de um comando (padrão: 30000; máximo: 150000). Se você definir a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars), Claude Code ignora essa variável. Veja [Limites de saída](/docs/pt/tools-reference#output-limits) |

150| `BASH_MAX_TIMEOUT_MS` | Tempo limite máximo que o modelo pode definir para comandos bash de longa duração (padrão: 600000, ou 10 minutos) |197| `BASH_MAX_TIMEOUT_MS` | Timeout máximo que o modelo pode definir para comandos bash de longa duração (padrão: 600000, ou 10 minutos). O teto efetivo é o maior entre isso e `BASH_DEFAULT_TIMEOUT_MS` |

151| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar [`claude --cloud`](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github) a agrupar e fazer upload do seu repositório local mesmo quando o acesso ao GitHub está disponível |198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP para [rastreamento beta detalhado](/docs/pt/monitoring-usage#traces-beta): com `ENABLE_BETA_TRACING_DETAILED=1`, logs e rastreamentos vão para lá em vez dos exportadores configurados. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

152| `CLAUDECODE` | Defina como `1` em subprocessos que Claude Code gera (ferramentas Bash e PowerShell, sessões tmux, [hook](/docs/pt/hooks) comandos, [linha de status](/docs/pt/statusline) comandos, subprocessos [servidor MCP](/docs/pt/mcp) stdio). Extensões IDE também definem isso em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso gerado por Claude Code. Para verificar se o processo atual foi gerado diretamente por uma chamada de ferramenta ou hook, em vez de dentro de um servidor MCP stdio que Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION` em vez disso |199| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar [`claude --cloud`](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github) a agrupar e carregar seu repositório local em vez de clonar de seu remoto |

153| `CLAUDE_AFK_COUNTDOWN_MS` | Quantos milissegundos antes da auto-continuação a contagem regressiva na tela aparece em um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido. Padrão `20000` (20 segundos), limitado ao tempo limite de auto-continuação. Não tem efeito a menos que auto-continuação esteja ativada; veja a configuração [`askUserQuestionTimeout`](/docs/pt/settings#available-settings) e `CLAUDE_AFK_TIMEOUT_MS`. Requer Claude Code v2.1.198 ou posterior |200| `CLAUDECODE` | Defina como `1` em subprocessos que Claude Code gera (ferramentas Bash e PowerShell, sessões tmux, comandos [hook](/docs/pt/hooks), comandos [status line](/docs/pt/statusline), subprocessos [servidor MCP](/docs/pt/mcp) stdio). As extensões IDE também definem isso em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso gerado por Claude Code. Para verificar se o processo atual foi gerado diretamente por uma chamada de ferramenta ou hook, em vez de dentro de um servidor MCP stdio que Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION` |

154| `CLAUDE_AFK_TIMEOUT_MS` | Quantos milissegundos de tempo ocioso antes de um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido auto-continuar sem você. Auto-continuação está desativada por padrão; opte por participar com a configuração [`askUserQuestionTimeout`](/docs/pt/settings#available-settings). Esta variável é um override para demos e testes automatizados: quando definida, tem precedência sobre essa configuração e ativa auto-continuação mesmo quando a configuração não está definida ou é `never`. Definir `0` não desativa o tempo limite; fecha o diálogo imediatamente. Em v2.1.198 e v2.1.199, auto-continuação estava ativada por padrão com um tempo limite de `60000` (60 segundos). Requer Claude Code v2.1.198 ou posterior |201| `CLAUDE_AFK_COUNTDOWN_MS` | Quantos milissegundos antes de auto-continuar a contagem regressiva na tela aparece em um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido. Padrão `20000` (20 segundos), limitado ao timeout de auto-continuação. Não tem efeito a menos que auto-continuação esteja ativa; veja a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Requer Claude Code v2.1.198 ou posterior |

155| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desabilitar todos os tipos de [subagente](/docs/pt/sub-agents) integrados, como Explore e Plan. Aplica-se apenas em modo não interativo (a flag `-p`). Útil para usuários do SDK que desejam uma tela em branco |202| `CLAUDE_AFK_TIMEOUT_MS` | Quantos milissegundos de tempo ocioso antes de um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido auto-continuar sem você. Auto-continuação está desativada por padrão; opte por ela com a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout). Essa variável é uma substituição para demos e testes automatizados: quando definida, tem precedência sobre essa configuração e ativa auto-continuação mesmo quando a configuração não está definida ou é `never`. Definir `0` não desativa o timeout; fecha o diálogo imediatamente. Na v2.1.198 e v2.1.199, auto-continuação estava ativa por padrão com um timeout de `60000` (60 segundos). Requer Claude Code v2.1.198 ou posterior |

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

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

157| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Tempo limite de travamento em milissegundos para subagentes em segundo plano. Padrão `600000` (10 minutos). O temporizador é reiniciado em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, o subagente é abortado e a tarefa é marcada como falha, exibindo qualquer resultado parcial para o pai |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout de travamento em milissegundos para subagentes. Padrão `600000` (10 minutos); se você aumentar `CLAUDE_STREAM_IDLE_TIMEOUT_MS` enquanto o watchdog de stream está ativo, o padrão sobe com ele, como [Lidar com respostas de API lentas ou travadas](/docs/pt/agent-sdk/typescript#handle-slow-or-stalled-api-responses) descreve. O timer reinicia em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, Claude Code aborta o subagente e relata o travamento ao pai |

158| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Defina a porcentagem (1-100) da janela de auto-compactação na qual a auto-compactação é acionada. Use valores mais baixos como `50` para compactar mais cedo. Esta variável só causa compactação mais cedo quando Claude Code compacta proativamente: quando `CLAUDE_CODE_AUTO_COMPACT_WINDOW` está definido, em [sessões em nuvem](/docs/pt/claude-code-on-the-web) e em Sonnet 4.6 e Opus 4.6 sem [contexto estendido](/docs/pt/model-config#extended-context), que compactam no limite de 200K por padrão. Em Sonnet 5, compactação proativa se aplica no [limite padrão](/docs/pt/model-config#sonnet-5-context-window) do modelo. Em outros casos, como uma sessão local em Opus 4.8, auto-compactação é acionada quando a conversa atinge o limite de contexto do modelo. O override só pode baixar o limite, então valores acima do padrão não têm efeito. Aplica-se a conversas principais e subagentes |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Defina a porcentagem (1-100) da janela de auto-compactação em que a auto-compactação é acionada. Use valores mais baixos como `50` para compactar mais cedo; a variável não pode aumentar o limite, então valores acima da porcentagem padrão são ignorados. Aplica-se apenas em sessões que [compactam antes do limite de contexto do modelo](/docs/pt/model-config#context-window-and-auto-compaction). Aplica-se a conversas principais e subagentes |

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

160| `CLAUDE_AX_SCREEN_READER` | Defina como `1` para renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Defina como `0` para forçar o modo leitor de tela desativado mesmo quando [`axScreenReader`](/docs/pt/settings#available-settings) é `true`. A flag [`--ax-screen-reader`](/docs/pt/cli-reference#cli-flags) tem precedência. Requer Claude Code v2.1.181 ou posterior |208| `CLAUDE_AX_PREPARK_MS` | Em [modo leitor de tela](/docs/pt/accessibility#what-your-screen-reader-hears), quantos milissegundos Claude Code aguarda, com o cursor no início da linha, antes de escrever uma linha nova ou alterada. Padrão `50`. Defina `0` para escrever imediatamente. Claude Code limita a espera a `5000`. Requer Claude Code v2.1.233 ou posterior |

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

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

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

162| `CLAUDE_CLIENT_PRESENCE_FILE` | Caminho para um arquivo que uma ferramenta externa, como um ouvinte de bloqueio de tela, cria quando você desbloqueia sua tela e exclui quando você a bloqueia. Enquanto o arquivo existe, Claude Code pula [notificações push móveis de Remote Control](/docs/pt/remote-control#mobile-push-notifications), para que você pare de receber pushes enquanto está usando ativamente o computador. Quando o arquivo está ausente ou ilegível, as notificações são enviadas normalmente. Claude Code verifica o arquivo uma vez por evento de disparo de push em vez de fazer polling. Requer Claude Code v2.1.181 ou posterior |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout em milissegundos para o watchdog de inatividade de streaming em nível de byte; quando definido, tem precedência sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para esse watchdog e deixa o watchdog em nível de evento inalterado. Claude Code limita essa variável entre 10 segundos e 30 minutos. Requer Claude Code v2.1.210 ou posterior |

163| `CLAUDE_CODE_ACCESSIBILITY` | Defina como `1` para manter o cursor do terminal nativo visível e desabilitar o indicador de cursor de texto invertido. Permite que ampliadores de tela como macOS Zoom rastreiem a posição do cursor |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Caminho para um arquivo que uma ferramenta externa, como um ouvinte de bloqueio de tela, cria quando você desbloqueia sua tela e exclui quando você a bloqueia. Enquanto o arquivo existe, Claude Code pula [notificações push móveis Remote Control](/docs/pt/remote-control#mobile-push-notifications), para que você pare de receber pushes enquanto está usando ativamente o computador. Quando o arquivo está ausente ou ilegível, as notificações são enviadas normalmente. Claude Code verifica o arquivo uma vez por evento de disparo de push em vez de fazer polling. Requer Claude Code v2.1.181 ou posterior |

164| `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 |214| `CLAUDE_CODE_ACCESSIBILITY` | Defina como `1` para manter o cursor de terminal nativo visível e desabilitar o indicador de cursor de texto invertido. Permite que ampliadores de tela como macOS Zoom rastreiem a posição do cursor |

165| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para repintar a tela inteira em cada quadro em [renderização em tela cheia](/docs/pt/fullscreen) em vez de enviar atualizações incrementais. Use isso se o modo tela cheia mostrar fragmentos de texto obsoletos ou deslocados. Claude Code habilita isso automaticamente para sessões em segundo plano e [visualização de agentes](/docs/pt/agent-view) no Windows |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Defina como `1` para carregar arquivos de memória de diretórios especificados com `--add-dir`. Carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, e `CLAUDE.local.md`. Por padrão, diretórios adicionais não carregam arquivos de memória |

166| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro [esforço](/docs/pt/model-config#adjust-effort-level) com cada solicitação, mesmo quando Claude Code não reconhece o ID do modelo como capaz de esforço. Use isso ao rotear através de um [gateway LLM](/docs/pt/llm-gateway) ou provedor de terceiros que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, ainda são excluídos para que as solicitações não falhem |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para repintar a tela inteira em cada quadro em [renderização fullscreen](/docs/pt/fullscreen) em vez de enviar atualizações incrementais. Use isso se o modo fullscreen mostrar fragmentos de texto obsoletos ou deslocados. Claude Code ativa isso automaticamente para sessões em segundo plano e [agent view](/docs/pt/agent-view) no Windows |

167| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](/docs/pt/settings#available-settings)) |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro [effort](/docs/pt/model-config#adjust-effort-level) com cada solicitação, mesmo quando Claude Code não reconhece o ID do modelo como capaz de effort. Use isso ao rotear através de um [gateway LLM](/docs/pt/llm-gateway) ou provedor de terceiros que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro effort na API, incluindo modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1, e Haiku 4.5, ainda são excluídos para que as solicitações não falhem |

168| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para parar Claude Code de abrir o navegador automaticamente quando um novo [artefato](/docs/pt/artifacts) é publicado. Republicar um artefato existente não abre o navegador independentemente dessa configuração |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos em que as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper)) |

169| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir o bloco de atribuição (versão do cliente e impressão digital do prompt) do início do prompt do sistema. Desabilitá-lo melhora as taxas de acerto do cache de prompt ao rotear através de um [gateway LLM](/docs/pt/llm-gateway). O cache da API Anthropic não é afetado |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para impedir que Claude Code abra o navegador automaticamente quando um novo [artifact](/docs/pt/artifacts#create-an-artifact) é publicado |

170| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Defina a capacidade de contexto em tokens usada para cálculos de auto-compactação. Padrão é a janela de contexto do modelo: 200K para modelos padrão ou 1M para modelos de [contexto estendido](/docs/pt/model-config#extended-context), exceto em Sonnet 5, que tem seu próprio [limite padrão](/docs/pt/model-config#sonnet-5-context-window). Use um valor mais baixo como `500000` em um modelo de 1M para tratar a janela como 500K para fins de compactação. O valor é limitado à janela de contexto real do modelo. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` é aplicado como uma porcentagem deste valor. Definir esta variável desacopla o limite de compactação do `used_percentage` da linha de status, que sempre usa a janela de contexto completa do modelo |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Defina como `0` para parar Claude de ler e responder a [comentários em um artifact](/docs/pt/artifacts#collect-comments-on-an-artifact). Não tem efeito quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [desativou artifacts](/docs/pt/artifacts#availability). Requer Claude Code v2.1.221 ou posterior |

171| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Substitua a [conexão IDE](/docs/pt/vs-code) automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE suportada. Defina como `false` para evitar isso. Defina como `true` para forçar uma tentativa de conexão quando a detecção automática falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global [`autoConnectIde`](/docs/pt/settings#global-config-settings) |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Defina como `0` para parar Claude de [responder por conta própria a comentários enviados para ele](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own). Requer Claude Code v2.1.228 ou posterior |

172| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo em milissegundos que Claude Code aguarda para que a cadeia de provedor de credencial padrão AWS produza credenciais antes da solicitação falhar com [`AWS default-chain credential resolve timed out`](/docs/pt/errors#aws-default-chain-credential-resolve-timed-out) (padrão: `60000`). Aumente quando uma etapa em sua cadeia legitimamente precisa de mais tempo, como um sign-in SSO baseado em navegador com MFA através de um wrapper como `aws-vault`. Aplica-se onde Claude Code assina com a cadeia padrão: [Amazon Bedrock](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Requer Claude Code v2.1.207 ou posterior |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir o [bloco de atribuição](/docs/pt/llm-gateway-protocol#system-prompt-attribution-block), que carrega a versão do cliente e uma impressão digital do prompt, do início do prompt do sistema. O cache em uma conexão direta com a API Anthropic não é afetado de qualquer forma. Em algumas configurações de conexão direta, Claude Code mantém o bloco em solicitações do classificador [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) mesmo quando você define `0`. Em [Bloco de atribuição do prompt do sistema](/docs/pt/llm-gateway-protocol#system-prompt-attribution-block), verifique quais conexões e credenciais isso cobre. Antes da v2.1.181, o bloco incluía um token por solicitação em URLs de base personalizados e conexões Microsoft Foundry, então nessas versões defina como `0` quando seu gateway LLM faz cache no corpo da solicitação ou encaminha solicitações para um provedor de terceiros, ou quando você se conecta ao Microsoft Foundry diretamente |

173| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Definido automaticamente em subprocessos de ferramenta Bash e [comando hook](/docs/pt/hooks) enquanto a sessão tem uma conexão [Remote Control](/docs/pt/remote-control) ativa, e removido quando a conexão termina. O valor é o ID da sessão em forma `session_`, o mesmo identificador que aparece na URL `claude.ai/code` da sessão, para que um script possa vincular de volta à sessão que o executou. Requer Claude Code v2.1.199 ou posterior. Em [sessões em nuvem](/docs/pt/claude-code-on-the-web), leia `CLAUDE_CODE_REMOTE_SESSION_ID` em vez disso |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está ativado, segundos entre lembretes para Claude verificar [subagentes em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) que ainda estão em execução. Aceita um inteiro simples de `1` a `86400` apenas; qualquer outro valor ou grafia lê como não definido. Quando não definido, não há lembretes de check-in. Requer Claude Code v2.1.248 ou posterior |

174| `CLAUDE_CODE_CERT_STORE` | Lista separada por vírgula de fontes de certificado CA para conexões TLS. `bundled` é o conjunto de CA Mozilla fornecido com Claude Code. `system` é o armazenamento de confiança do sistema operacional, somente leitura em tempos de execução com `tls.getCACertificates`: o binário nativo, ou Node 22.15 ou posterior para instalações npm. Veja [Armazenamento de certificado CA](/docs/pt/network-config#ca-certificate-store). Padrão é `bundled,system` |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Defina a [janela de auto-compactação](/docs/pt/model-config#set-the-auto-compact-window) em tokens, de `100000` a `1000000`. Aceita um inteiro simples como `500000` apenas: um valor como `500k` lê como `500` e é limitado ao mínimo de 100K. A janela efetiva também é limitada à janela de contexto do modelo. Tem precedência sobre o comando `/autocompact`, a flag `--autocompact` e a configuração `autoCompactWindow`. A `used_percentage` da status line sempre mede contra a janela de contexto completo do modelo, então uma vez que essa variável está definida, essa porcentagem não indica mais quando a compactação será executada |

175| `CLAUDE_CODE_CHILD_SESSION` | Defina como `1` em subprocessos que Claude Code gera via ferramentas Bash, PowerShell e Monitor, [hook](/docs/pt/hooks) comandos e [linha de status](/docs/pt/statusline) comandos. Não definido para subprocessos [servidor MCP](/docs/pt/mcp) stdio, que são de longa duração e sobrevivem à sessão que os gerou. Diferentemente de `CLAUDECODE`, isso é definido apenas pelo Claude Code quando ele inicia um subprocesso e não por extensões IDE, então distingue de forma confiável uma sessão aninhada de um `claude` de nível superior iniciado em um terminal integrado IDE. Uma `claude` TUI interativa aninhada iniciada desta forma é automaticamente excluída de `--resume`, `--continue`, histórico de seta para cima e a lista `claude agents`. Sessões `claude -p` não interativas ainda persistem. Defina `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para substituir esta exclusão. Requer Claude Code v2.1.172 ou posterior |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Substitua a [conexão IDE](/docs/pt/vs-code) automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro de um terminal integrado de IDE suportado. Defina como `false` para evitar isso. Defina como `true` para forçar uma tentativa de conexão quando a auto-detecção falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global [`autoConnectIde`](/docs/pt/settings-reference#autoconnectide) |

176| `CLAUDE_CODE_CLIENT_CERT` | Caminho para arquivo de certificado do cliente para autenticação mTLS |226| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo em milissegundos que Claude Code aguarda o provedor de credencial padrão AWS produzir credenciais antes da solicitação falhar com [`AWS default-chain credential resolve timed out`](/docs/pt/errors#aws-default-chain-credential-resolve-timed-out) (padrão: `60000`). Aumente quando uma etapa em sua cadeia legitimamente precisa de mais tempo, como um sign-in baseado em navegador com MFA através de um wrapper como `aws-vault`. Aplica-se em qualquer lugar que Claude Code assine com a cadeia padrão: [Amazon Bedrock](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), e o [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Requer Claude Code v2.1.207 ou posterior |

177| `CLAUDE_CODE_CLIENT_KEY` | Caminho para arquivo de chave privada do cliente para autenticação mTLS |227| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Defina automaticamente em subprocessos de ferramenta Bash e [comando hook](/docs/pt/hooks) enquanto a sessão tem uma conexão [Remote Control](/docs/pt/remote-control) ativa, e removido quando a conexão termina. O valor é o ID da sessão em forma `session_`, o mesmo identificador que aparece na URL `claude.ai/code` da sessão, para que um script possa vincular de volta à sessão que o executou. Requer Claude Code v2.1.199 ou posterior. Em [sessões em nuvem](/docs/pt/claude-code-on-the-web), leia `CLAUDE_CODE_REMOTE_SESSION_ID` |

178| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase-passe para `CLAUDE_CODE_CLIENT_KEY` criptografada (opcional) |228| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Defina como `0` para fazer Claude Code ler o byte `0x08`, também escrito `^H`, como Backspace simples, ou `1` para lê-lo como Ctrl+Backspace. Qualquer valor substitui o padrão da plataforma. Por padrã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 Linux. Defina `0` em um terminal Windows onde [Backspace exclui uma palavra inteira](/docs/pt/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

179| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Removido em v2.1.186 e agora é um no-op. Anteriormente definia um tempo limite separado para a fase de conexão, TLS e cabeçalho de resposta de uma solicitação de API de streaming. Use `API_TIMEOUT_MS` para o tempo limite por solicitação |229| `CLAUDE_CODE_CERT_STORE` | Lista separada por vírgulas de fontes de certificado CA para conexões TLS. `bundled` é o conjunto Mozilla CA enviado com Claude Code. `system` é o armazenamento 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 npm. Veja [Armazenamento de certificado CA](/docs/pt/network-config#ca-certificate-store). Padrão é `bundled,system` |

180| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Substitua 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 habilitado separadamente via `--debug`, `/debug` ou a variável de ambiente `DEBUG`: definir apenas essa variável não habilita o logging. A flag [`--debug-file`](/docs/pt/cli-reference#cli-flags) faz ambos de uma vez. Padrão é `~/.claude/debug/<session-id>.txt` |230| `CLAUDE_CODE_CHILD_SESSION` | Defina como `1` em subprocessos que Claude Code gera via ferramentas Bash, PowerShell e Monitor, comandos [hook](/docs/pt/hooks), e comandos [status line](/docs/pt/statusline). Não definido para subprocessos [servidor MCP](/docs/pt/mcp) stdio, que são de longa duração e sobrevivem à sessão que os gerou. Diferentemente de `CLAUDECODE`, isso é definido apenas por Claude Code quando ele inicia um subprocesso e não por extensões IDE, então distingue confiável uma sessão aninhada de um `claude` de nível superior iniciado em um terminal integrado IDE. Um `claude` TUI interativo aninhado iniciado dessa forma é automaticamente excluído de `--resume`, `--continue`, histórico de seta para cima, e a lista `claude agents`. Sessões `claude -p` não interativas ainda persistem. Defina `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para substituir essa exclusão. Requer Claude Code v2.1.172 ou posterior |

181| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Nível de log mínimo escrito 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 saída completa de comando de linha de status, ou aumente para `error` para reduzir ruído |231| `CLAUDE_CODE_CLIENT_CERT` | Caminho para arquivo de certificado de cliente para autenticação mTLS |

182| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desabilitar suporte a [janela de contexto de 1M](/docs/pt/model-config#extended-context). Quando definido, variantes de modelo de 1M não estão disponíveis no seletor de modelo, e sessões [Sonnet 5](/docs/pt/model-config#sonnet-5-context-window) são tratadas como tendo uma janela de 200K. Útil para ambientes corporativos com requisitos de conformidade |232| `CLAUDE_CODE_CLIENT_KEY` | Caminho para arquivo de chave privada de cliente para autenticação mTLS |

183| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Defina como `1` para desabilitar [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) em Opus 4.6 e Sonnet 4.6 e voltar ao orçamento de pensamento fixo controlado por `MAX_THINKING_TOKENS`. A partir de v2.1.111, não tem efeito em Fable 5, Sonnet 5 ou Opus 4.7 e posterior, que sempre usam raciocínio adaptativo |233| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase-passe para CLAUDE\_CODE\_CLIENT\_KEY criptografado (opcional) |

184| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Defina como `1` para desabilitar a [ferramenta advisor](/docs/pt/advisor). O comando `/advisor` fica indisponível, qualquer `advisorModel` configurado é ignorado e a flag `--advisor` é aceita mas não tem efeito, para que scripts existentes que a passam continuem funcionando sem erros |234| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Removido na v2.1.186 e agora é um no-op. Anteriormente definia um timeout separado para a fase de conexão, TLS e cabeçalho de resposta de uma solicitação de API de streaming. Use `API_TIMEOUT_MS` para o timeout por solicitação. Para a fase de cabeçalho de resposta de uma solicitação de streaming, veja `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

185| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar [agentes em segundo plano e visualização de agentes](/docs/pt/agent-view): `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/docs/pt/settings#available-settings) |235| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Substitua 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 essa variável não ativa o logging. A flag [`--debug-file`](/docs/pt/cli-reference#cli-flags) faz ambos de uma vez. Padrão é `~/.claude/debug/<session-id>.txt` |

186| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desabilitar [renderização em tela cheia](/docs/pt/fullscreen) e usar o renderizador de tela principal clássico. A conversa permanece no scrollback nativo do seu terminal para que `Cmd+f` e modo de cópia tmux funcionem como de costume. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração [`tui`](/docs/pt/settings#available-settings). Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas de [visualização de agentes](/docs/pt/agent-view), que sempre usam renderização em tela cheia |236| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Nível de log mínimo escrito 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 saída completa de comando de status line, ou aumente para `error` para reduzir ruído |

187| `CLAUDE_CODE_DISABLE_ARTIFACT` | Defina como `1` para desabilitar a ferramenta [Artifact](/docs/pt/artifacts), que publica saída de sessão como uma página web privada em claude.ai. Equivalente à configuração [`disableArtifact`](/docs/pt/settings#available-settings) |237| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desabilitar suporte a [janela de contexto 1M](/docs/pt/model-config#extended-context). Quando definido, variantes de modelo 1M não estão disponíveis no seletor de modelo, e Claude Code mantém sessões em modelos com uma janela nativa 1M, como [Sonnet 5](/docs/pt/model-config#sonnet-5-context-window) e os modelos Fable, para uma janela 200K; veja [Contexto estendido](/docs/pt/model-config#extended-context) para como a retenção é aplicada. Útil para ambientes empresariais com requisitos de conformidade. Para seu papel em corrigir a janela para um ID de modelo `[1m]` não reconhecido, veja [Corrigir a janela para um ID de modelo gateway ou personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

188| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Defina como `1` para desabilitar o processamento de anexos. Menções de arquivo com sintaxe `@` são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo |238| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Defina como `1` para desabilitar [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) em Opus 4.6 e Sonnet 4.6 e voltar ao orçamento de pensamento fixo controlado por `MAX_THINKING_TOKENS`. Não tem efeito em [modelos Fable](/docs/pt/model-config#extended-thinking), Sonnet 5, ou Opus 4.7 e posterior, que sempre usam raciocínio adaptativo |

189| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Defina como `1` para desabilitar [memória automática](/docs/pt/memory#auto-memory). Defina como `0` para forçar a memória automática mesmo quando `--bare` mode ou [`autoMemoryEnabled: false`](/docs/pt/settings#available-settings) desabilitaria de outra forma. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática |239| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Defina como `1` para parar Claude Code de mesclar blocos `env` de [configurações gerenciadas](/docs/pt/managed-settings#precedence-within-the-managed-tier) por chave em fontes de admin, para que apenas o bloco `env` da fonte de prioridade mais alta se aplique, como antes da v2.1.223. Defina no ambiente que inicia Claude Code, já que Claude Code ignora uma cópia entregue através de um bloco `env` de configurações. Requer Claude Code v2.1.223 ou posterior |

190| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desabilitar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro `run_in_background` em ferramentas Bash e subagent, auto-backgrounding e o atalho Ctrl+B |240| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Defina como `1` para desabilitar a [ferramenta advisor](/docs/pt/advisor). O comando `/advisor` fica indisponível, qualquer `advisorModel` configurado é ignorado, e a flag `--advisor` é aceita mas não tem efeito, para que scripts existentes que a passam continuem funcionando sem erros |

191| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para pular a verificação de que uma resposta de streaming [Amazon Bedrock](/docs/pt/amazon-bedrock) carrega o tipo de conteúdo `application/vnd.amazon.eventstream`. Sem essa variável, uma resposta com um tipo de conteúdo diferente falha com um erro nomeando esse tipo de conteúdo, o que significa que um [gateway ou proxy está transformando a resposta](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Defina apenas quando o gateway reescreve o cabeçalho `Content-Type` mas passa o corpo do event-stream binário inalterado; se o corpo em si foi transformado, as solicitações falham com `Truncated event message received` em vez disso. Requer Claude Code v2.1.208 ou posterior |241| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar [agentes em segundo plano e agent view](/docs/pt/agent-view): `claude agents`, `--bg`, `/background`, e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/docs/pt/settings-reference#disableagentview) |

192| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para parar os comandos de shell em segundo plano em execução de uma [sessão em segundo plano](/docs/pt/agent-view), fluxos de trabalho dinâmicos e, a partir de v2.1.198, subagentes em segundo plano quando o [supervisor](/docs/pt/agent-view#the-supervisor-process) para, reinicia ou atualiza o processo dessa sessão, em vez de entregá-los ao próximo processo da sessão. Afeta apenas esse handoff: colocar uma sessão em segundo plano com `←` ou [`/background`](/docs/pt/agent-view#from-inside-a-session) ainda carrega o trabalho em andamento, e `CLAUDE_DISABLE_ADOPT` desativa ambos. Requer Claude Code v2.1.196 ou posterior |242| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desabilitar [renderização fullscreen](/docs/pt/fullscreen) e usar o renderizador de tela principal clássico. A conversa fica no scrollback nativo do seu terminal para que `Cmd+f` e modo de cópia tmux funcionem como de costume. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração [`tui`](/docs/pt/settings-reference#tui). Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas de [agent view](/docs/pt/agent-view), que sempre usam renderização fullscreen |

193| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para parar Claude Code de encerrar [comandos de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) quando o sistema operacional relata pressão de memória. Por padrão, em macOS e Linux, Claude Code encerra um shell em segundo plano iniciado na sessão principal em um sinal de pressão de memória uma vez que a sessão ficou ociosa por 30 minutos e nenhuma volta ou subagente está em execução. Windows não tem sinal de pressão de memória, então essa variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior |243| `CLAUDE_CODE_DISABLE_ARTIFACT` | Defina como `1` para desativar a ferramenta [Artifact](/docs/pt/artifacts), que publica saída de sessão como uma página web privada em claude.ai. Uma vez que você a define, nenhum arquivo de configurações ativa a ferramenta novamente. Para desativar a ferramenta de um arquivo de configurações, defina [`enableArtifact`](/docs/pt/settings-reference#enableartifact) como `false`; a chave deprecated [`disableArtifact`](/docs/pt/settings-reference#disableartifact) também a desativa |

194| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desabilitar as [skills](/docs/pt/skills) e workflows que vêm com Claude Code: skills agrupadas e workflows integrados são removidos inteiramente, enquanto comandos slash integrados como `/init` permanecem digitáveis mas são ocultados do modelo. `/doctor` permanece digitável como os comandos integrados; ocultá-lo com `DISABLE_DOCTOR_COMMAND` em vez disso. Skills de plugins, `.claude/skills/` e `.claude/commands/` não são afetadas. Equivalente à configuração [`disableBundledSkills`](/docs/pt/settings#available-settings); `0` não a substitui |244| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Defina como `1` para desabilitar processamento de anexos. Menções de arquivo com sintaxe `@` são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo |

195| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Defina como `1` para evitar carregar qualquer arquivo de memória CLAUDE.md no contexto, incluindo arquivos de usuário, projeto e memória automática |245| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Defina como `1` para desabilitar [memória automática](/docs/pt/memory#auto-memory). Defina como `0` para forçar memória automática ativa mesmo quando modo `--bare` ou [`autoMemoryEnabled: false`](/docs/pt/settings-reference#automemoryenabled) a desabilitaria. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática |

246| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desabilitar toda funcionalidade de tarefa em segundo plano, incluindo o parâmetro `run_in_background` em ferramentas Bash e subagente, auto-backgrounding, e o atalho Ctrl+B |

247| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Defina como `1` para parar Claude Code de tratar uma resposta de streaming [Amazon Bedrock](/docs/pt/amazon-bedrock) com cabeçalho `Content-Type` ausente ou vazio como fluxo de evento binário Amazon Bedrock. Por padrão, Claude Code assume que um gateway descartou o cabeçalho de uma resposta caso contrário não modificada, para que o streaming continue funcionando. Defina isso apenas para um gateway que também re-emite o stream como server-sent events; Claude Code então lê o corpo sem cabeçalho como server-sent events. Requer Claude Code v2.1.239 ou posterior |

248| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para pular a verificação de que uma resposta de streaming [Amazon Bedrock](/docs/pt/amazon-bedrock) carrega o tipo de conteúdo `application/vnd.amazon.eventstream`. Sem essa variável, quando uma resposta carrega um tipo de conteúdo diferente, Claude Code falha a solicitação com um erro nomeando esse tipo, o que significa um [gateway ou proxy está transformando a resposta](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configure o gateway para encaminhar o cabeçalho `Content-Type` e o corpo não modificados em vez de definir essa variável. Requer Claude Code v2.1.208 ou posterior |

249| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para parar comandos de shell em segundo plano em execução de uma [sessão em segundo plano](/docs/pt/agent-view), fluxos de trabalho dinâmicos, e, a partir da v2.1.198, subagentes em segundo plano quando o [supervisor](/docs/pt/agent-view#the-supervisor-process) para, reinicia ou atualiza o processo dessa sessão, em vez de entregá-los ao próximo processo da sessão. Afeta apenas esse handoff: backgrounding uma sessão com `←` ou [`/background`](/docs/pt/agent-view#from-inside-a-session) ainda carrega trabalho em voo, e `CLAUDE_DISABLE_ADOPT` desativa ambos. Requer Claude Code v2.1.196 ou posterior |

250| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para parar Claude Code de encerrar [comandos de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) quando o sistema operacional relata pressão de memória. Por padrão, no macOS e Linux, Claude Code encerra um shell em segundo plano iniciado na sessão principal em um sinal de pressão de memória uma vez que a sessão ficou ociosa por 30 minutos e nenhuma volta ou subagente está em execução. Windows não tem sinal de pressão de memória, então essa variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior |

251| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desabilitar as [skills](/docs/pt/skills) e fluxos de trabalho inclusos com Claude Code: skills agrupadas e fluxos de trabalho são removidos inteiramente, enquanto comandos integrados como `/init` permanecem digitáveis mas são ocultados do modelo. `/doctor` permanece digitável como os comandos integrados; ocultá-lo com `DISABLE_DOCTOR_COMMAND`. Skills de plugins, `.claude/skills/`, e `.claude/commands/` não são afetadas. Equivalente à configuração [`disableBundledSkills`](/docs/pt/settings-reference#disablebundledskills) |

252| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Defina como `1` para manter as ferramentas de navegador [Claude in Chrome](/docs/pt/chrome) disponíveis enquanto omite a seção Chrome do prompt do sistema e a [skill agrupada](/docs/pt/skills#bundled-skills) `/claude-in-chrome`. Para hosts que incorporam Claude Code e fornecem sua própria orientação de navegador. Requer Claude Code v2.1.257 ou posterior |

253| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Defina como `1` para evitar carregar qualquer arquivo de memória CLAUDE.md em contexto, incluindo arquivos de memória de usuário, projeto e automática |

196| `CLAUDE_CODE_DISABLE_CRON` | Defina como `1` para desabilitar [tarefas agendadas](/docs/pt/scheduled-tasks). A skill `/loop` e ferramentas cron ficam indisponíveis e qualquer tarefa já agendada para de disparar, incluindo tarefas que já estão em execução no meio da sessão |254| `CLAUDE_CODE_DISABLE_CRON` | Defina como `1` para desabilitar [tarefas agendadas](/docs/pt/scheduled-tasks). A skill `/loop` e ferramentas cron ficam indisponíveis e qualquer tarefa já agendada para de disparar, incluindo tarefas que já estão em execução no meio da sessão |

197| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Defina como `1` para remover cabeçalhos de solicitação `anthropic-beta` específicos do Anthropic e campos de esquema de ferramenta beta (como `defer_loading` e `eager_input_streaming`) de solicitações de API. Use isso quando um gateway proxy rejeita solicitações com erros como "Unexpected value(s) for the `anthropic-beta` header" ou "Extra inputs are not permitted". Campos padrão (`name`, `description`, `input_schema`, `cache_control`) são preservados. [Busca de ferramentas MCP](/docs/pt/mcp#scale-with-mcp-tool-search) é desabilitada e todas as ferramentas MCP carregam antecipadamente, mesmo quando `ENABLE_TOOL_SEARCH` está definido |255| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Defina como `1` para remover cabeçalhos de solicitação `anthropic-beta` específicos de Anthropic e campos de esquema de ferramenta beta (como `defer_loading` e `eager_input_streaming`) de solicitações de API. Use isso quando um gateway proxy rejeita solicitações com erros como "Unexpected value(s) for the `anthropic-beta` header" ou "Extra inputs are not permitted". Campos padrão (`name`, `description`, `input_schema`, `cache_control`) são preservados. [Busca de ferramentas MCP](/docs/pt/mcp#scale-with-mcp-tool-search) é desabilitada e todas as ferramentas MCP carregam antecipadamente, mesmo quando você define `ENABLE_TOOL_SEARCH`. No Claude Code v2.1.227 ou posterior, [configurações gerenciadas](/docs/pt/managed-settings) podem manter a busca de ferramentas ativa. [Desabilitar capacidades de pré-lançamento](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) cobre onde a substituição se aplica |

198| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Defina como `1` para desabilitar os [subagentes Explore e Plan](/docs/pt/sub-agents#built-in-subagents) integrados. Claude explora com suas ferramentas de busca ou o subagente de propósito geral em vez disso, e [modo plan](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) lê arquivos diretamente em vez de iniciar agentes Explore e Plan. Subagentes personalizados nomeados `Explore` ou `Plan` não são afetados. Para remover todos os tipos de subagentes integrados no Agent SDK ou modo não interativo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` em vez disso. Requer Claude Code v2.1.198 ou posterior |256| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Defina como `1` para desabilitar os [subagentes Explore e Plan](/docs/pt/sub-agents#built-in-subagents) integrados. Claude explora com suas ferramentas de busca ou o subagente de propósito geral, e [modo plan](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) lê arquivos diretamente em vez de iniciar agentes Explore e Plan. Subagentes personalizados nomeados `Explore` ou `Plan` não são afetados. Para remover todo tipo de subagente integrado no Agent SDK ou modo não interativo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Requer Claude Code v2.1.198 ou posterior |

200| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Defina como `1` para desabilitar as pesquisas de qualidade de sessão "Como Claude está se saindo?". Pesquisas também são desabilitadas quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definido, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` opte por participar novamente. Para definir uma taxa de amostra em vez de desabilitar completamente, use a configuração [`feedbackSurveyRate`](/docs/pt/settings#available-settings). Veja [Pesquisas de qualidade de sessão](/docs/pt/data-usage#session-quality-surveys) |258| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Defina como `1` para desabilitar as pesquisas de qualidade de sessão "How is Claude doing?". As pesquisas também são desabilitadas quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definido, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` opte por voltar. Para definir uma taxa de amostra em vez de desabilitar completamente, use a configuração [`feedbackSurveyRate`](/docs/pt/settings-reference#feedbacksurveyrate). Veja [Pesquisas de qualidade de sessão](/docs/pt/data-usage#session-quality-surveys) |

201| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Defina como `1` para desabilitar [checkpointing](/docs/pt/checkpointing) de arquivo. O comando `/rewind` não será capaz de restaurar alterações de código |259| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Defina como `1` para desabilitar [checkpointing](/docs/pt/checkpointing) de arquivo. O comando `/rewind` não será capaz de restaurar alterações de código. Substitui a configuração [`fileCheckpointingEnabled`](/docs/pt/settings-reference#filecheckpointingenabled) |

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

203| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Defina como `1` para evitar remapeamento automático de Opus 4.0 e 4.1 para a versão Opus atual na API Anthropic. Use quando você deseja intencionalmente fixar um modelo mais antigo. O remapeamento não é executado em Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry |261| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Defina como `1` para evitar remapeamento automático de Opus 4.0 e 4.1 para a versão Opus atual na API Anthropic. Use quando você intencionalmente quer fixar um modelo mais antigo. O remapeamento não é executado no Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry |

204| `CLAUDE_CODE_DISABLE_MOUSE` | Defina como `1` para desabilitar rastreamento de mouse em [renderização em tela cheia](/docs/pt/fullscreen). A rolagem por teclado com `PgUp` e `PgDn` ainda funciona. Use isso para manter o comportamento nativo de cópia ao selecionar do seu terminal |262| `CLAUDE_CODE_DISABLE_MOUSE` | Defina como `1` para desabilitar rastreamento de mouse em [renderização fullscreen](/docs/pt/fullscreen). Rolagem de teclado com `PgUp` e `PgDn` ainda funciona. Use isso para manter o comportamento nativo de cópia ao selecionar do seu terminal |

205| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Defina como `1` para desabilitar clique, arrasto e manipulação de hover em [renderização em tela cheia](/docs/pt/fullscreen) enquanto mantém a rolagem da roda do mouse. Use isso quando você quer que a rolagem da roda funcione dentro do Claude Code mas não quer que cliques posicionem o cursor, expandam saída de ferramenta ou abram links. `CLAUDE_CODE_DISABLE_MOUSE` tem precedência quando ambos estão definidos. Requer Claude Code v2.1.195 ou posterior |263| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Defina como `1` para desabilitar manipulação de clique, arrasto e hover em [renderização fullscreen](/docs/pt/fullscreen) enquanto mantém rolagem de roda do mouse. Use isso quando você quer que a rolagem de roda funcione dentro de Claude Code mas não quer que cliques posicionem o cursor, expandam saída de ferramenta ou abram links. `CLAUDE_CODE_DISABLE_MOUSE` tem precedência quando ambos estão definidos. Requer Claude Code v2.1.195 ou posterior |

206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Equivalente a definir `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` e `DISABLE_TELEMETRY` |264| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Defina como `1` para parar Claude Code de re-ler o [certificado de cliente mTLS e chave](/docs/pt/network-config#mtls-authentication) quando uma solicitação de API falha com um erro em nível de conexão, como uma redefinição de conexão ou erro de handshake TLS. Com o reload desabilitado, Claude Code carrega arquivos rotacionados apenas quando aplica configurações novamente ou na próxima inicialização. Requer Claude Code v2.1.232 ou posterior |

207| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Defina como `1` para desabilitar o fallback não-streaming quando uma solicitação de streaming falha no meio do stream. Erros de streaming se propagam para a camada de retry em vez disso. Útil quando um proxy ou gateway causa o fallback para produzir execução de ferramenta duplicada |265| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Defina como qualquer valor não vazio, como `1`, para desabilitar tráfego de rede não essencial: auto-atualizações, telemetria, relatório de erros, o comando `/feedback`, [feedback redigido por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior), notas de lançamento, as verificações de [badge de status PR e MR](/docs/pt/interactive-mode#pr-review-status), e verificações de disponibilidade como a verificação [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Também para as [execuções em segundo plano de fontes de comando plugin](/docs/pt/plugin-marketplaces#when-claude-code-re-runs-the-command), que são comandos locais em vez de tráfego de rede, porque podem disparar instalações de dependência. **Defini-lo como `0` ou `false` ainda desabilita esse tráfego**, diferentemente da maioria das variáveis on/off; desconfigurar a variável para permitir novamente. Também desabilita busca de sinalizador de recurso, o que torna [Remote Control](/docs/pt/remote-control#requirements) e os outros [recursos que precisam de busca de sinalizador de recurso](#features-that-need-feature-flag-fetching) indisponíveis. A auto-instalação do marketplace de plugin oficial não é coberta; desabilite com `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Não afeta [descoberta de modelo gateway](/docs/pt/llm-gateway-connect#add-gateway-models-to-the-model-picker), que tem seu próprio opt-in |

208| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Defina como `1` para enviar a notificação de desktop da ferramenta `PushNotification` mesmo enquanto você está digitando ou focado no terminal. Por padrão, a ferramenta pula tanto a notificação de desktop quanto o [push móvel](/docs/pt/remote-control#mobile-push-notifications) quando detecta atividade de teclado recente ou foco no terminal. Esta variável desabilita apenas essa verificação local, então o servidor ainda pode suprimir o push móvel quando detecta que você está ativo. Requer Claude Code v2.1.193 ou posterior |266| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Defina como `1` para desabilitar o fallback não-streaming quando uma solicitação de streaming falha no meio do stream. Erros de streaming se propagam para a camada de retry. Útil quando um proxy ou gateway causa o fallback produzir execução de ferramenta duplicada |

209| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Defina como `1` para pular a adição automática do marketplace de plugin oficial na primeira execução |267| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Defina como `1` para enviar a notificação de desktop da ferramenta `PushNotification` mesmo enquanto você está digitando ou focado no terminal. Por padrão a ferramenta pula tanto a notificação de desktop quanto o [push móvel](/docs/pt/remote-control#mobile-push-notifications) quando detecta atividade de teclado recente ou foco de terminal. Essa variável desabilita apenas essa verificação local, para que o servidor ainda possa suprimir o push móvel quando detecta que você está ativo. Requer Claude Code v2.1.193 ou posterior |

210| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Defina como `1` para pular o carregamento de skills do diretório de skills gerenciado em todo o sistema. Útil para sessões de contêiner ou CI que não devem carregar skills provisionadas pelo operador |268| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Defina como `1` para desabilitar registro automático do marketplace de plugin oficial. Claude Code lê a variável quando está prestes a registrar o marketplace, geralmente durante o primeiro lançamento interativo de uma máquina. Se a variável está definida nesse ponto, Claude Code pula o registro permanentemente. Desconfigurar a variável depois não desfaz o pulo. Execute `claude plugin marketplace add anthropics/claude-plugins-official` para registrar o marketplace a qualquer momento |

211| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Defina como `1` para desabilitar atualizações automáticas de título do terminal com base no contexto da conversa. Em sessões Agent SDK e `claude -p`, isso também pula a solicitação de Haiku em segundo plano que gera o título da sessão |269| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Defina como `1` para parar Claude Code de executar seus [hooks `Notification` para solicitações de permissão não respondidas](/docs/pt/hooks#notification) em sessões onde Claude Code as envia para o callback `canUseTool` do Agent SDK, que é como Claude Desktop e a extensão VS Code hospedam Claude Code. Não tem efeito em sessões de terminal. Requer Claude Code v2.1.233 ou posterior |

212| `CLAUDE_CODE_DISABLE_THINKING` | Defina como `1` para omitir o parâmetro `thinking` de solicitações de API inteiramente. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. O comportamento da variável é inalterado em relação a versões anteriores; em modelos que pensam por padrão, omitir o parâmetro significa que o modelo ainda pode pensar. Para desabilitar explicitamente [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) na API Anthropic, use `MAX_THINKING_TOKENS=0` em vez disso, que também é ineficaz em Fable 5 já que não pode ter pensamento desligado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `0` igualmente omite o parâmetro, então as duas variáveis se comportam da mesma forma lá |270| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Defina como `1` para pular carregamento de skills do diretório de skills gerenciado em todo o sistema. Útil para sessões de container ou CI que não devem carregar skills provisionadas por operador |

213| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Defina como `1` para desabilitar rolagem virtual em [renderização em tela cheia](/docs/pt/fullscreen) e renderizar cada mensagem na transcrição. Use isso se a rolagem em modo tela cheia mostrar regiões em branco onde as mensagens deveriam aparecer |271| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Defina como `1` para desabilitar atualizações automáticas de título de terminal baseadas em contexto de conversa. Em sessões Agent SDK e `claude -p`, isso também pula a solicitação de modelo pequeno/rápido em segundo plano que gera o título da sessão |

214| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desabilitar [workflows](/docs/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/docs/pt/settings#available-settings) |272| `CLAUDE_CODE_DISABLE_THINKING` | Defina como `1` para omitir o parâmetro `thinking` de solicitações de API inteiramente. 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 o modelo ainda pode pensar. Para desabilitar explicitamente [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) na API Anthropic, use `MAX_THINKING_TOKENS=0`. Nenhuma variável desativa pensamento em modelos Fable, que não podem ter pensamento desativado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `MAX_THINKING_TOKENS=0` igualmente omite o parâmetro, para que as duas variáveis se comportem igual lá |

215| `CLAUDE_CODE_EFFORT_LEVEL` | Defina o nível de esforço para modelos suportados. Valores: `low`, `medium`, `high`, `xhigh`, `max` ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `/effort` e a configuração `effortLevel`. Veja [Ajustar nível de esforço](/docs/pt/model-config#adjust-effort-level) |273| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Defina como `1` para pular [auto-compactação](/docs/pt/costs#reduce-token-usage) proativa quando Claude Code não reconhece o ID do modelo, como um alias [gateway LLM](/docs/pt/llm-gateway). Sem essa variável, Claude Code compacta na janela de contexto que assume para o ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` pode corrigir a janela assumida; veja [Corrigir a janela para um ID de modelo gateway ou personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) para quando cada variável se aplica. Requer Claude Code v2.1.223 ou posterior |

216| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | Defina como `1` para habilitar a adição de texto extra ao final do prompt do sistema de cada [subagente](/docs/pt/sub-agents). A flag [`--append-subagent-system-prompt`](/docs/pt/cli-reference#cli-flags) fornece o texto adicionado e define esta variável automaticamente, então você não precisa defini-la você mesmo. Requer Claude Code v2.1.205 ou posterior |274| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Defina como `1` para desabilitar rolagem virtual em [renderização fullscreen](/docs/pt/fullscreen) e renderizar cada mensagem na transcrição. Use isso se a rolagem em modo fullscreen mostrar regiões em branco onde mensagens devem aparecer |

217| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Aceito para compatibilidade com versões mais antigas e não tem efeito. Modo automático está disponível por padrão em cada provedor, incluindo Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e sessões [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas. Em v2.1.158 através v2.1.206, definir isso como `1` era necessário para disponibilizar [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) nesses provedores |275| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desabilitar [fluxos de trabalho](/docs/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/docs/pt/settings-reference#disableworkflows) |

218| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Substitua a disponibilidade de [recapitulação de sessão](/docs/pt/interactive-mode#session-recap). Defina como `0` para forçar recapitulações desativadas independentemente do toggle `/config`. Defina como `1` para forçar recapitulações ativadas quando [`awaySummaryEnabled`](/docs/pt/settings#available-settings) é `false`. Tem precedência sobre a configuração e toggle `/config` |276| `CLAUDE_CODE_EFFORT_LEVEL` | Defina o nível de effort para modelos suportados. Valores: `low`, `medium`, `high`, `xhigh`, `max`, ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort`, e as configurações `modelSettings` e `effortLevel`. Um limite [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) ainda se aplica. Veja [Ajustar nível de effort](/docs/pt/model-config#adjust-effort-level) |

219| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar o estado do plugin em limites de turno em [modo não interativo](/docs/pt/headless) após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o prompt do sistema no meio da sessão, o que invalida [prompt caching](/docs/pt/prompt-caching) para esse turno |277| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | Defina como `1` para ativar anexação de texto extra ao final do prompt do sistema de cada [subagente](/docs/pt/sub-agents) diferente de um [subagente bifurcado](/docs/pt/sub-agents#fork-the-current-conversation). As flags [`--append-subagent-system-prompt`](/docs/pt/cli-reference#cli-flags) e [`--append-subagent-system-prompt-file`](/docs/pt/cli-reference#cli-flags) fornecem o texto anexado e definem essa variável automaticamente, para que você não precise defini-la. Requer Claude Code v2.1.205 ou posterior |

220| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Defina como `1` para rotear a pesquisa de qualidade de sessão "Como Claude está se saindo?" para seu próprio [coletor OpenTelemetry](/docs/pt/monitoring-usage) quando o tráfego não essencial vinculado ao Anthropic está bloqueado. As classificações de pesquisa são emitidas apenas como eventos OTEL para seu coletor configurado. Nenhum dado de pesquisa é enviado ao Anthropic neste modo. Aplica-se quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` está definido, e não tem efeito caso contrário. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e a política de feedback do produto da organização têm precedência |278| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Aceito para compatibilidade com lançamentos mais antigos e não tem efeito. Modo auto está disponível por padrão em cada provedor, incluindo Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, e sessões [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas. Na v2.1.158 através v2.1.206, definir isso como `1` era necessário para tornar [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) disponível nesses provedores |

221| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla se as entradas de chamada de ferramenta são transmitidas da API conforme Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como uma escrita de arquivo longa, chega apenas após Claude terminar de gerá-la, o que pode parecer que está travando. Habilitado por padrão na API Anthropic. Em Amazon Bedrock e Google Cloud's Agent Platform, habilitado por modelo onde o contêiner implantado suporta. Defina como `0` para optar por não participar. Defina como `1` para forçar a habilitação ao rotear através de um proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Desativado por padrão em Microsoft Foundry e conexões [gateway](/docs/pt/llm-gateway) |279| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Substitua disponibilidade de [recapitulação de sessão](/docs/pt/interactive-mode#session-recap). Defina como `0` para forçar recapitulações desativadas independentemente do toggle `/config`. Defina como `1` para forçar recapitulações ativas quando [`awaySummaryEnabled`](/docs/pt/settings-reference#awaysummaryenabled) é `false`. Tem precedência sobre a configuração e toggle `/config` |

222| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Defina como `1` para popular o seletor `/model` a partir do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` aponta para um gateway compatível com Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque gateways apoiados por uma chave de API compartilhada mostrariam de outra forma cada usuário cada modelo que a chave pode acessar. Modelos descobertos ainda são filtrados pela lista de permissões [`availableModels`](/docs/pt/settings#available-settings) que a sessão recebe; entregue a lista através de [MDM ou um arquivo de configurações gerenciado](/docs/pt/settings#settings-files), já que [entrega gerenciada pelo servidor não está disponível em configurações de gateway](/docs/pt/server-managed-settings#platform-availability) |280| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar estado de plugin em limites de volta em [modo não interativo](/docs/pt/headless) após uma instalação em segundo plano completar. Desativado por padrão porque a atualização muda o prompt do sistema no meio da sessão, o que invalida [cache de prompt](/docs/pt/prompt-caching) para essa volta |

223| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Removido em v2.1.142, quando o padrão de [modo rápido](/docs/pt/fast-mode) mudou de Opus 4.6 para Opus 4.7 |281| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Defina como `1` para rotear a pesquisa de qualidade de sessão "How is Claude doing?" para seu próprio [coletor OpenTelemetry](/docs/pt/monitoring-usage) quando tráfego não essencial vinculado a Anthropic é bloqueado. Classificações de pesquisa são emitidas apenas como eventos OTEL para seu coletor configurado. Nenhum dado de pesquisa é enviado para Anthropic neste modo. Aplica-se quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, ou `DO_NOT_TRACK` está definido, 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 |

224| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Defina como `false` para desabilitar sugestões de prompt (o toggle "Prompt suggestions" em `/config`). Estas são as previsões acinzentadas que aparecem na sua entrada de prompt após Claude responder. Veja [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) |282| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla se entradas de chamada de ferramenta fazem stream da API conforme Claude as gera. Com isso desativado, uma entrada de ferramenta grande como uma escrita de arquivo longa chega apenas após Claude terminar de gerá-la, o que pode parecer que está travando. Ativado por padrão na API Anthropic. No Amazon Bedrock e Google Cloud's Agent Platform, ativado por modelo onde o container implantado o suporta. Defina como `0` para optar por não participar. Defina como `1` para forçar ativo ao rotear através de um proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, ou `ANTHROPIC_BEDROCK_BASE_URL`. Desativado por padrão em Microsoft Foundry e conexões [gateway](/docs/pt/llm-gateway) |

225| `CLAUDE_CODE_ENABLE_TASKS` | Controla se as sessões usam as ferramentas Task estruturadas (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou a ferramenta legada `TodoWrite`. A partir do Claude Code v2.1.142, as ferramentas Task são o padrão em todos os modos. Defina como `0` para reverter para `TodoWrite`. Veja [Lista de tarefas](/docs/pt/interactive-mode#task-list) e [Migrar para ferramentas Task](/docs/pt/agent-sdk/todo-tracking#migrate-to-task-tools) |283| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Defina como `1` para popular o seletor `/model` do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` aponta para um gateway compatível com Anthropic como LiteLLM, Kong, ou um proxy interno. Desativado por padrão porque gateways apoiados por uma chave de API compartilhada mostrariam cada usuário cada modelo que a chave pode acessar. Modelos descobertos ainda são filtrados por uma lista de permissão [`availableModels`](/docs/pt/settings-reference#availablemodels) que a sessão recebe; entregue a lista através de [MDM ou arquivo de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms), já que [entrega gerenciada pelo servidor não está disponível em configurações de gateway](/docs/pt/server-managed-settings#platform-availability) |

226| `CLAUDE_CODE_ENABLE_TELEMETRY` | Defina como `1` para habilitar coleta de dados OpenTelemetry para métricas e logging. Obrigatório antes de configurar exportadores OTel. Veja [Monitoramento](/docs/pt/monitoring-usage) |284| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Removido na v2.1.142, quando o padrão [modo rápido](/docs/pt/fast-mode) se moveu de Opus 4.6 para Opus 4.7 |

285| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Defina como `false` para desativar sugestões de prompt, as previsões acinzentadas que aparecem em sua entrada de prompt. Tem precedência sobre a configuração [`promptSuggestionEnabled`](/docs/pt/settings-reference#promptsuggestionenabled), que é o que o toggle **Prompt suggestions** em `/config` escreve. Claude Code também [pausa sugestões enquanto sua conta está próxima ou no seu limite de uso](/docs/pt/interactive-mode#when-claude-code-skips-suggestions). Defina como `true` para mantê-las ativas até atingir o limite. Requer Claude Code v2.1.238 ou posterior. Veja [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) |

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

287| `CLAUDE_CODE_ENABLE_TELEMETRY` | Defina como `1` para ativar coleta de dados OpenTelemetry para métricas e logging. Necessário antes de configurar exportadores OTel. Veja [Monitoramento](/docs/pt/monitoring-usage) |

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

227| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo em milissegundos para aguardar após o loop de consulta ficar ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts usando modo SDK |289| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo em milissegundos para aguardar após o loop de consulta ficar ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts usando modo SDK |

228| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para habilitar [equipes de agentes](/docs/pt/agent-teams). As equipes de agentes são experimentais e desabilitadas por padrão |290| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para ativar [equipes de agentes](/docs/pt/agent-teams). Equipes de agentes são experimentais e desabilitadas por padrão |

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

230| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Substitua o limite de token padrão para leituras de arquivo. Útil quando você precisa ler arquivos maiores na íntegra |292| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Substitua o limite de token padrão para leituras de arquivo. Útil quando você precisa ler arquivos maiores integralmente |

231| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Defina como `1` para forçar persistência de transcrição, histórico de prompt e registro `claude agents` mesmo quando este `claude` foi iniciado de dentro de outra sessão Claude Code. Use quando um valor `CLAUDE_CODE_CHILD_SESSION` herdado, por exemplo de uma sessão `screen` ou um lançador em segundo plano iniciado pela primeira vez pela ferramenta Bash do Claude Code, causa uma sessão genuína de nível superior a ser classificada incorretamente como aninhada. A partir de v2.1.178, Claude Code detecta o caso tmux automaticamente e ignora o marcador herdado, então tmux não precisa mais dessa variável. Também honrado em v2.1.169 e anterior; não tem efeito em v2.1.170 e v2.1.171, onde a detecção de sessão aninhada que ele substitui foi removida |293| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Defina como `1` para forçar persistência de transcrição, histórico de prompt, e registro `claude agents` mesmo quando este `claude` foi iniciado de dentro de outra sessão Claude Code. Use quando um valor `CLAUDE_CODE_CHILD_SESSION` herdado, por exemplo de uma sessão `screen` ou um lançador em segundo plano iniciado primeiro pela ferramenta Bash de Claude Code, causa uma sessão genuína de nível superior ser mal classificada como aninhada. A partir da v2.1.178, Claude Code detecta o caso tmux automaticamente e ignora o marcador herdado, para que tmux não precise mais dessa variável. Também honrado na v2.1.169 e anterior; não tem efeito na v2.1.170 e v2.1.171, onde a detecção de sessão aninhada que substitui foi removida |

232| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Defina como `1` para forçar renderização de tachado para `~~text~~` nas respostas do Claude quando seu terminal suporta mas não é detectado automaticamente, como sobre SSH sem `TERM_PROGRAM` encaminhado. Sem isso, terminais não detectados mostram os marcadores `~~` literais em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior |294| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Defina como `1` para forçar renderização de tachado para `~~text~~` nas respostas de Claude quando seu terminal o suporta mas não é auto-detectado, como sobre SSH sem `TERM_PROGRAM` encaminhado. Sem isso, terminais não detectados mostram os marcadores literais `~~` em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior |

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

234| `CLAUDE_CODE_FORK_SUBAGENT` | Defina como `1` para permitir [subagentes bifurcados](/docs/pt/sub-agents#fork-the-current-conversation), ou `0` para desabilitá-los, substituindo qualquer rollout do lado do servidor. Quando habilitado, Claude pode solicitar o tipo de subagente `fork` para gerar uma bifurcação, um subagente que herda o contexto de conversa completo em vez de começar do zero. Spawns sem um tipo de subagente ainda usam o subagente de propósito geral, e todos os spawns de subagente são executados em segundo plano. O comando [`/fork`](/docs/pt/commands) explícito funciona sem essa variável. Funciona em modo interativo e via SDK ou `claude -p` |296| `CLAUDE_CODE_FORK_SUBAGENT` | Controla [modo fork](/docs/pt/sub-agents#turn-fork-mode-on-or-off), que deixa Claude gerar [subagentes bifurcados](/docs/pt/sub-agents#fork-the-current-conversation) e está ativo por padrão apenas em sessões interativas. Defina como `1` para ativá-lo em `claude -p` e Agent SDK também, ou `0` para desativá-lo em todo tipo de sessão. Você pode executar `/subtask` independentemente de modo fork estar ativo. O padrão interativo requer Claude Code v2.1.232 ou posterior; em versões anteriores, defina a variável como `1` para ativar modo fork |

235| `CLAUDE_CODE_GIT_BASH_PATH` | Apenas Windows: caminho para o executável Git Bash (`bash.exe`). Use quando Git Bash está instalado mas não está no seu PATH. Veja [Configuração do Windows](/docs/pt/setup#set-up-on-windows) |297| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Defina como `1` para emitir blocos de texto e pensamento de [subagente](/docs/pt/sub-agents) em saída `claude -p --output-format stream-json`, o mesmo comportamento que a flag [`--forward-subagent-text`](/docs/pt/cli-reference#cli-flags). Use a variável quando um harness invoca `claude` e não pode passar a flag. Diferentemente da flag, que sai com um erro fora de modo não interativo com saída stream-json, a variável é ignorada lá para que invocações aninhadas continuem funcionando quando está definida em todo o processo. Requer Claude Code v2.1.211 ou posterior |

236| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles dos resultados quando Claude invoca a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). Incluído por padrão. Não afeta autocomplete de arquivo `@`, `ls`, Grep ou Read |298| `CLAUDE_CODE_GIT_BASH_PATH` | Apenas Windows: caminho para o executável Git Bash (`bash.exe`). Use quando Git Bash está instalado mas não em seu PATH. Se o caminho não existe ou o arquivo não é nomeado `bash.exe`, `sh.exe`, `bash`, ou `sh`, Claude Code ignora a variável e auto-detecta Git Bash como se estivesse desconfigurada, registrando um aviso visível com `--debug`. Antes da v2.1.219, Claude Code saía na inicialização quando o caminho não existia, e usava qualquer arquivo existente como shell sem verificar que era bash ou sh. Veja [Configuração Windows](/docs/pt/setup#set-up-on-windows) |

237| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior) respeitar padrões `.gitignore`. Por padrão, Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo git. Não afeta autocomplete de arquivo `@`, que tem sua própria [configuração `respectGitignore`](/docs/pt/settings#available-settings) |299| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles de resultados quando Claude invoca a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). Incluído por padrão. Não afeta autocompletar `@` de arquivo, `ls`, Grep, ou Read |

238| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Tempo limite em segundos para descoberta de arquivo da ferramenta Glob. Padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |300| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior) respeitar padrões `.gitignore`. Por padrão, Glob retorna todos os arquivos correspondentes incluindo os ignorados por git. Não afeta autocompletar `@` de arquivo, que tem sua própria configuração [`respectGitignore`](/docs/pt/settings-reference#respectgitignore) |

301| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout em segundos para descoberta de arquivo da ferramenta Glob. Padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |

302| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Quantos minutos trabalho em segundo plano pode manter um objetivo ativo esperando antes de Claude Code [pedir a Claude para verificá-lo](/docs/pt/goal#background-work-defers-evaluation). Padrão `30`. Defina `0` para desativar check-ins. Dê minutos inteiros em dígitos simples, no máximo `10080`, que é uma semana. Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer Claude Code v2.1.234 ou posterior |

239| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logo de inicialização. Útil para compartilhamentos de tela ou gravações onde o caminho expõe seu nome de usuário do SO |303| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logo de inicialização. Útil para compartilhamentos de tela ou gravações onde o caminho expõe seu nome de usuário do SO |

240| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Substitua o endereço de host usado para conectar à extensão IDE. Por padrão, Claude Code detecta automaticamente o endereço correto, incluindo roteamento WSL-para-Windows |304| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Substitua o endereço de host usado para conectar à extensão IDE. Por padrão Claude Code auto-detecta o endereço correto, incluindo roteamento WSL-para-Windows |

241| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular a auto-instalação de extensões IDE. Equivalente a definir [`autoInstallIdeExtension`](/docs/pt/settings#global-config-settings) como `false` |305| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular auto-instalação de extensões IDE. Equivalente a definir [`autoInstallIdeExtension`](/docs/pt/settings-reference#autoinstallideextension) como `false` |

242| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para pular validação de entradas de arquivo de bloqueio IDE durante a conexão. Use quando a auto-conexão falha em encontrar sua IDE apesar dela estar em execução |306| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para pular validação de entradas de arquivo de bloqueio IDE durante conexão. Use quando auto-conexão falha em encontrar seu IDE apesar dele estar em execução |

243| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. A partir de v2.1.193, aplicado diretamente para nomes de modelo que Claude Code não reconhece como um modelo Claude; para modelos Claude reconhecidos, só tem efeito quando `DISABLE_COMPACT` também está definido. Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome |307| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quantos [subagentes](/docs/pt/sub-agents#concurrent-subagent-limit) podem estar em execução em uma sessão antes da ferramenta Agent recusar gerar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, para que a variável possa ajustar o limite mas não desabilitá-lo. Requer Claude Code v2.1.217 ou posterior |

244| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Defina o número máximo de tokens de saída para a maioria das solicitações. Padrões e limites variam por modelo; veja [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Aumentar este valor reduz a janela de contexto efetiva disponível antes que [auto-compactação](/docs/pt/costs#reduce-token-usage) seja acionada |308| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. A partir da v2.1.193, como se aplica depende de como Claude Code resolve o ID do modelo; veja [Corrigir a janela para um ID de modelo gateway ou personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome |

245| `CLAUDE_CODE_MAX_RETRIES` | Substitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10). Limitado a 15 a partir de v2.1.186; a partir de v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Para sessões não supervisionadas que precisam aguardar através de interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG` em vez disso |309| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Defina o número máximo de tokens de saída para a maioria das solicitações. Padrões e limites variam por modelo; veja [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code padrão para 32000 para IDs de modelo que não reconhece, como nomes específicos de gateway, e reduz valores acima do limite de um modelo para o limite. Aumentar esse valor reduz a janela de contexto efetiva disponível antes de [auto-compactação](/docs/pt/costs#reduce-token-usage) ser acionada |

246| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Número máximo de ferramentas somente leitura e subagentes que podem executar em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo mas consomem mais recursos |310| `CLAUDE_CODE_MAX_RETRIES` | Substitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10). Limitado a 15 a partir da v2.1.186; a partir da v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Para sessões não supervisionadas que precisam aguardar através de interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG` |

247| `CLAUDE_CODE_MAX_TURNS` | Limite o número de voltas agentes quando nenhum limite explícito é passado. Equivalente a passar [`--max-turns`](/docs/pt/cli-reference#cli-flags), que tem precedência quando ambos estão definidos. Um valor que não é um inteiro positivo é rejeitado na inicialização com um erro em vez de ser tratado como sem limite |311| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Removido na v2.1.224 e agora é um no-op. Anteriormente limitava o número total de [subagentes](/docs/pt/sub-agents) que Claude poderia gerar com a ferramenta Agent em uma sessão (padrão: 200); gerar além do limite falhava com `Subagent spawn limit reached`. O [limite de subagente concorrente](/docs/pt/sub-agents#concurrent-subagent-limit) e o [limite de profundidade](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) ainda se aplicam |

248| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Defina como `1` para gerar servidores MCP stdio com apenas um ambiente de linha de base segura mais o `env` configurado do servidor, em vez de herdar seu ambiente de shell |312| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Número de [camadas de subagente](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) permitidas abaixo da conversa principal (padrão: 3). No padrão, subagentes podem gerar seus próprios subagentes, e um subagente na terceira camada não pode gerar mais; defina `1` para desativar aninhamento. Na v2.1.217 através v2.1.218, o padrão era 1, para que um subagente não pudesse gerar seu próprio a menos que você aumentasse o limite; v2.1.219 aumentou o padrão para 3. Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, para que o limite possa ser ajustado mas não removido. Requer Claude Code v2.1.217 ou posterior |

249| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Tempo limite de inatividade em milissegundos para chamadas de ferramentas MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou [conector claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) não envia resposta e nenhuma notificação de progresso por este tempo, a chamada de ferramenta aborta com um erro em vez de aguardar o `MCP_TOOL_TIMEOUT` geral. Substitui os padrões por transporte de 300000 (5 minutos) para servidores de rede e 1800000 (30 minutos) para servidores stdio. Defina como `0` para desabilitar a verificação de inatividade. Valores abaixo de 1000 são aumentados para um segundo, e o valor é limitado ao `MCP_TOOL_TIMEOUT` efetivo. Um `timeout` por servidor em `.mcp.json` de pelo menos 1000 aumenta a janela de inatividade desse servidor para pelo menos o valor `timeout`. Não se aplica a servidores IDE ou servidores em processo do SDK. Requer Claude Code v2.1.187 ou posterior. Antes de v2.1.203, servidores stdio eram isentos do tempo limite de inatividade |313| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Número máximo de ferramentas somente leitura e subagentes que podem executar em paralelo (padrão: 10). Valores mais altos aumentam paralelismo mas consomem mais recursos |

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

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

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

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

318| `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 claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) não envia resposta e nenhuma notificação de progresso por esse tempo, a chamada de ferramenta aborta com um erro em vez de aguardar o `MCP_TOOL_TIMEOUT` geral. Substitui os padrões por transporte de 300000 (5 minutos) para servidores de rede e 1800000 (30 minutos) para servidores stdio. Defina como `0` para desabilitar a verificação de inatividade. Valores abaixo de 1000 são aumentados para um segundo, e o valor é limitado ao `MCP_TOOL_TIMEOUT` efetivo. Um `timeout` por servidor em `.mcp.json` de pelo menos 1000 aumenta a janela de inatividade desse servidor para pelo menos o valor `timeout`. Não se aplica a servidores IDE ou servidores em processo do SDK. Requer Claude Code v2.1.187 ou posterior. Antes da v2.1.203, servidores stdio eram isentos do timeout de inatividade |

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

320| `CLAUDE_CODE_MESSAGING_TOKEN` | Defina por Claude Code, não por você: em sessões que vinculam um [socket de caixa de entrada](/docs/pt/cross-session-messaging#the-sessions-inbox-socket), Claude Code exporta esse token por sessão para hooks e comandos Bash ao lado de `CLAUDE_CODE_MESSAGING_SOCKET`. Um script postando no socket pode enviar `{"type":"auth","token":"<token>"}` como sua primeira linha para provar que pertence à sessão. No Windows nativo, Claude Code requer essa linha e fecha qualquer conexão que não abra com uma válida. As [regras de filho próprio](/docs/pt/cross-session-messaging#the-sessions-inbox-socket) dizem quando 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-lo. Requer Claude Code v2.1.228 ou posterior |

250| `CLAUDE_CODE_NATIVE_CURSOR` | Defina como `1` para mostrar o cursor próprio do terminal no cursor de entrada em vez de um bloco desenhado. O cursor respeita as configurações de piscar, forma e foco do terminal |321| `CLAUDE_CODE_NATIVE_CURSOR` | Defina como `1` para mostrar o cursor próprio do terminal no cursor de entrada em vez de um bloco desenhado. O cursor respeita as configurações de piscar, forma e foco do terminal |

251| `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 escrevê-los. Sem essa variável, `/init` gera um CLAUDE.md automaticamente sem solicitar |322| `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 escrevê-los. Sem essa variável, `/init` gera um CLAUDE.md automaticamente sem solicitar |

252| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para habilitar [renderização em tela cheia](/docs/pt/fullscreen), uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Equivalente à configuração [`tui`](/docs/pt/settings#available-settings); você também pode alternar com `/tui fullscreen` |323| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Defina como `1` para escrever saída de terminal através de um segundo descritor de arquivo não bloqueante, para que um terminal que para de ler, como um painel tmux em modo de controle pausado ou uma conexão SSH travada, não possa congelar Claude Code no meio da sessão. Aplica-se em macOS, Linux e WSL quando stdout é um terminal. Requer Claude Code v2.1.261 ou posterior |

324| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para ativar [renderização fullscreen](/docs/pt/fullscreen), uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Substitui a configuração [`tui`](/docs/pt/settings-reference#tui); você também pode alternar com `/tui fullscreen` |

253| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de atualização OAuth para autenticação 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 |325| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de atualização OAuth para autenticação 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 |

254| `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ório quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definido |326| `CLAUDE_CODE_OAUTH_SCOPES` | Escopos OAuth separados por espaço que o token de atualização foi emitido com, como `"user:profile user:inference user:sessions:claude_code"`. Necessário quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definido |

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

256| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Removido em v2.1.160 e agora é um no-op. Anteriormente fixava [modo rápido](/docs/pt/fast-mode) em Claude Opus 4.6 em vez do padrão atual. Opus 4.6 não suporta mais modo rápido |328| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Removido na v2.1.160 e agora é um no-op. Anteriormente fixava [modo rápido](/docs/pt/fast-mode) em Claude Opus 4.6 em vez do padrão atual. Opus 4.6 não suporta mais modo rápido |

257| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para escrever erros de diagnóstico do exportador OpenTelemetry para stderr. Por padrão, esses erros aparecem apenas com `--debug`, então um exportador mal configurado, como uma colisão de porta Prometheus, falha silenciosamente de outra forma. Requer Claude Code v2.1.179 ou posterior. Veja [Monitoramento](/docs/pt/monitoring-usage) |329| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Comprimento máximo de atributos OpenTelemetry que carregam conteúdo (respostas de modelo, conteúdo de ferramenta, prompts do sistema, corpos de API brutos), marcador de truncamento incluído, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). Aumente apenas se seu backend de telemetria aceita valores de atributo maiores que 64 KB, ou reduza para cortar volume de telemetria. Requer Claude Code v2.1.214 ou posterior. Veja [Monitoramento](/docs/pt/monitoring-usage) |

258| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tempo limite em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja [Monitoramento](/docs/pt/monitoring-usage) |330| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para escrever erros diagnósticos do exportador OpenTelemetry para stderr. Por padrão esses erros aparecem apenas com `--debug`, para que um exportador mal configurado como uma colisão de porta Prometheus falhe silenciosamente. Requer Claude Code v2.1.179 ou posterior. Veja [Monitoramento](/docs/pt/monitoring-usage) |

331| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja [Monitoramento](/docs/pt/monitoring-usage) |

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

260| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Tempo limite em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja [Monitoramento](/docs/pt/monitoring-usage) |333| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja [Monitoramento](/docs/pt/monitoring-usage) |

261| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Defina como `1` para permitir que 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 Homebrew e WinGet. Outros gerenciadores de pacotes continuam a mostrar o comando de atualização sem executá-lo. Veja [Auto updates](/docs/pt/setup#auto-updates) |334| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Defina como `1` para deixar Claude Code executar o comando de upgrade do seu gerenciador de pacotes em segundo plano quando uma nova versão está disponível. Aplica-se a instalações Homebrew e WinGet. Outros gerenciadores de pacotes continuam mostrando o comando de upgrade sem executá-lo. Veja [Auto-atualizações](/docs/pt/setup#auto-updates) |

262| `CLAUDE_CODE_PERFORCE_MODE` | Defina como `1` para habilitar proteção de escrita ciente de Perforce. Quando definido, Edit, Write e NotebookEdit falham com uma dica `p4 edit <file>` se o arquivo de destino não tiver o bit de escrita do proprietário, que Perforce limpa em arquivos sincronizados até que `p4 edit` os abra. Isso evita que Claude Code contorne o rastreamento de mudanças do Perforce |335| `CLAUDE_CODE_PERFORCE_MODE` | Defina como `1` para ativar proteção de escrita ciente de Perforce. Quando definido, Edit, Write, e NotebookEdit falham com uma dica `p4 edit <file>` se o arquivo alvo não tem o bit de escrita do proprietário, que Perforce limpa em arquivos sincronizados até `p4 edit` abri-los. Isso evita que Claude Code contorne rastreamento de mudança Perforce |

263| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Substitua o diretório raiz de plugins. Apesar do nome, isso define o diretório pai, não o cache em si: marketplaces e o cache de plugin vivem em subdiretórios sob este caminho. Padrão é `~/.claude/plugins` |336| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Substitua o diretório raiz de plugins. Apesar do nome, isso define o diretório pai, não o cache em si: marketplaces e o cache de plugin vivem em subdiretórios sob esse caminho. Padrão é `~/.claude/plugins` |

264| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Tempo limite em milissegundos para operações git ao instalar ou atualizar plugins (padrão: 120000). Aumente este valor para repositórios grandes ou conexões de rede lentas. Veja [Operações Git expiram](/docs/pt/plugin-marketplaces#git-operations-time-out) |337| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout em milissegundos para operações git ao instalar ou atualizar plugins (padrão: 120000). Aumente esse valor para repositórios grandes ou conexões de rede lentas. Veja [Operações Git expiram](/docs/pt/plugin-marketplaces#git-operations-time-out) |

265| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Defina como `1` para manter o cache de marketplace existente quando um `git pull` falha em vez de limpar e re-clonar. Útil em ambientes offline ou airgapped onde re-clonar falharia da mesma forma. Veja [Atualizações de marketplace falham em ambientes offline](/docs/pt/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |338| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Defina como `1` para pular a tentativa de re-clone e manter usando o cache de marketplace existente quando um `git pull` falha. Útil em ambientes offline ou airgapped onde re-cloning falharia da mesma forma. Veja [Atualizações de Marketplace falham em ambientes offline](/docs/pt/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

266| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Defina como `1` para clonar fontes de plugin GitHub `owner/repo` via HTTPS em vez de SSH. Aplica-se a instalação de plugin e atualização, e a `/plugin marketplace add` e `update`. Útil em executores CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para `github.com` |339| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Defina como `1` para clonar abreviação de fonte GitHub `owner/repo` sobre HTTPS em vez de SSH. Aplica-se a instalação e atualização de plugin, e a `/plugin marketplace add` e `update`. Útil em corredores CI, containers, ou qualquer ambiente sem uma chave SSH configurada para `github.com` |

267| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Caminho para um ou mais diretórios de seed de plugin somente leitura, separados por `:` em Unix ou `;` no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de contêiner. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem re-clonar. Veja [Pré-popular plugins para contêineres](/docs/pt/plugin-marketplaces#pre-populate-plugins-for-containers) |340| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Caminho para um ou mais diretórios de seed de plugin somente leitura, separados por `:` em Unix ou `;` no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de container. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-em cache sem re-cloning. Veja [Pré-popular plugins para containers](/docs/pt/plugin-marketplaces#pre-populate-plugins-for-containers) |

268| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Defina como `1` para parar Claude Code de passar `-ExecutionPolicy Bypass` ao gerar PowerShell para chamadas de ferramenta, hooks e comandos de linha de status, e respeitar a política de execução efetiva da máquina em vez disso. Por padrão, Claude Code contorna a política de execução no escopo do processo para que scripts `.ps1` e importações de módulo funcionem em instalações Windows padrão com Restricted. O bypass no escopo do processo nunca substitui a Política de Grupo `MachinePolicy` ou `UserPolicy` independentemente dessa configuração |341| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Defina como `1` para parar Claude Code de passar `-ExecutionPolicy Bypass` ao gerar PowerShell para chamadas de ferramenta, hooks e comandos de status line, e respeitar a política de execução efetiva da máquina. Por padrão Claude Code contorna política de execução em escopo de processo para que scripts `.ps1` e importações de módulo funcionem em instalações Windows padrão-Restricted. Bypass em escopo de processo nunca substitui `MachinePolicy` ou `UserPolicy` de Group Policy independentemente dessa configuração |

269| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Tempo máximo em milissegundos que [modo não interativo](/docs/pt/headless#background-tasks-at-exit) com a flag `-p` aguarda após a volta final para subagentes em segundo plano e workflows cujo resultado faz parte da saída. Padrão: `600000`, ou 10 minutos. Quando o limite é excedido, tarefas em segundo plano restantes são encerradas e o processo sai. Defina como `0` para aguardar indefinidamente. Este limite é separado do período de carência de cinco segundos que se aplica a shells em segundo plano simples |342| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Teto em milissegundos em espera ociosa por subagentes em segundo plano e fluxos de trabalho após a volta final em [modo não interativo](/docs/pt/headless#background-tasks-at-exit) com a flag `-p`. Espera ociosa começa novamente cada vez que Claude toma uma volta para lidar com um resultado em segundo plano. Padrão: `600000`, ou 10 minutos. Quando espera ociosa atinge o teto, Claude Code para de aguardar as tarefas em segundo plano restantes e sai. Defina como `0` para aguardar indefinidamente. Esse limite é separado do período de graça de cinco segundos que se aplica a shells em segundo plano simples. Requer Claude Code v2.1.182 ou posterior |

270| `CLAUDE_CODE_PROCESS_WRAPPER` | Inicie os processos que Claude Code começa a partir de seu próprio binário através de um executável wrapper, dado como um prefixo argv como `/opt/corp/launcher`. Cobre o serviço em segundo plano que hospeda sessões [visualização de agentes](/docs/pt/agent-view), cada sessão que ele gera e o relançamento que Claude Code realiza de si mesmo para terminar de instalar uma atualização. O primeiro token deve ser o caminho absoluto de um executável que termina executando `exec "$@"`, e a maioria dos lançadores é apenas esse caminho único. O valor é uma lista de argumentos, não um comando de shell: espaço em branco separa tokens, aspas duplas agrupam um caminho que contém espaços, e um valor que começa com `[` é lido como uma matriz de string JSON. Defina em bloco `env` de configurações de usuário ou [gerenciadas](/docs/pt/permissions#managed-settings), não como exportação de shell, para que o serviço em segundo plano desanexado o herde; configurações de projeto e local não podem defini-lo. A extensão VS Code configura seu próprio lançador separadamente através de sua configuração `claudeProcessWrapper`. Ignorado no Windows. `CLAUDE_CODE_SHELL_PREFIX` é um controle separado: envolve os comandos de shell que Claude Code executa como uma string única entre aspas, enquanto essa variável envolve os próprios processos do Claude Code como um prefixo argv. Veja [Executar Claude Code atrás de um lançador corporativo](/docs/pt/corporate-launcher) |343| `CLAUDE_CODE_PROCESS_WRAPPER` | Inicie os processos que Claude Code começa de seu próprio binário, como o serviço em segundo plano que hospeda [agent view](/docs/pt/agent-view) sessões, através de um lançador corporativo dado como um prefixo argv como `/opt/corp/launcher`. Defina em um bloco `env` de configurações de usuário ou [gerenciadas](/docs/pt/managed-settings), não como exportação de shell, para que o serviço em segundo plano desacoplado o herde; configurações de projeto e local não podem defini-lo. Equivalente à configuração [`processWrapper`](/docs/pt/settings-reference#processwrapper), que requer Claude Code v2.1.210 ou posterior; essa variável tem precedência quando ambas estão definidas. A extensão VS Code configura seu próprio lançador separadamente através de sua configuração `claudeProcessWrapper`. Ignorado no Windows. Veja [Executar Claude Code atrás de um lançador corporativo](/docs/pt/corporate-launcher) para o formato de valor, o que o lançador cobre, e o contrato que o lançador deve satisfazer. Requer Claude Code v2.1.208 ou posterior |

271| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Defina como `1` para propagar contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` aponta para um proxy personalizado. A propagação cobre o cabeçalho `traceparent` em solicitações de modelo e MCP HTTP e a variável de ambiente `TRACEPARENT` para subprocessos Bash, PowerShell e hook. Por padrão, a propagação é habilitada apenas quando conectado diretamente à API Anthropic. Adicionado em v2.1.152. Veja [Rastreamentos (beta)](/docs/pt/monitoring-usage#traces-beta) |344| `CLAUDE_CODE_PROJECT_DIR_NAME` | Defina junto com `CLAUDE_CONFIG_DIR` para escolher o nome do diretório `projects/` que Claude Code armazena transcrições e memória automática dessa sessão, em lugar de um derivado do caminho do diretório de trabalho. Por exemplo, iniciando Claude Code com `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` armazena sob `/srv/tenant-a/projects/work/`. Claude Code ignora essa variável quando `CLAUDE_CONFIG_DIR` não está definido, e a lê apenas do ambiente que você inicia `claude`, nunca de um bloco `env` de [arquivo de configurações](#in-settings-files). Veja [Nomeie o diretório de projeto você mesmo](/docs/pt/sessions#name-the-project-directory-yourself). Requer Claude Code v2.1.234 ou posterior |

272| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Definido por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, seleção de provedor, endpoint e variáveis de autenticação como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` em arquivos de configuração são ignorados para que configurações de usuário não possam substituir o roteamento do host. O opt-out automático de telemetria para Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry também é ignorado, então a telemetria segue o opt-out padrão `DISABLE_TELEMETRY`. Veja [Comportamentos padrão por provedor de API](/docs/pt/data-usage#default-behaviors-by-api-provider) |345| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Defina `5m` ou `1h`, os únicos valores que Claude Code aceita, para escolher o [TTL de cache de prompt](/docs/pt/prompt-caching#cache-lifetime) para a conversa principal: suas voltas interativas, `-p` e SDK, mais os helpers que executam inline com elas. Tem precedência sobre a configuração `promptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a substitui. Escritas de cache de 1 hora são faturadas a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior |

346| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Defina como `1` para propagar contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` aponta para um proxy personalizado. Propagação cobre o cabeçalho `traceparent` em solicitações de modelo e MCP HTTP e a variável de ambiente `TRACEPARENT` para subprocessos Bash, PowerShell e hook. Por padrão, propagação está ativada apenas quando conectado diretamente à API Anthropic. Adicionado na v2.1.152. Veja [Rastreamentos (beta)](/docs/pt/monitoring-usage#traces-beta) |

347| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Defina por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, Claude Code ignora variáveis de seleção de provedor, endpoint e autenticação como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, e `ANTHROPIC_API_KEY` em arquivos de configurações, para que configurações de usuário não possam substituir o roteamento do host. Claude Code também ignora chaves de seleção de modelo como `model`, `fallbackModel`, e `modelOverrides` em [configurações gerenciadas](/docs/pt/managed-settings), qualquer fonte gerenciada que as entregue, para que a configuração de modelo do host tenha precedência sobre um pin de modelo desatualizado. 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 lista de permissão [`availableModels`](/docs/pt/model-config#restrict-model-selection) em configurações gerenciadas ainda se aplica a menos que o host forneça a sua. Claude Code também pula o opt-out de telemetria automática que de outra forma se aplica em provedores de terceiros como Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, e Microsoft Foundry, para que telemetria siga o opt-out padrão `DISABLE_TELEMETRY`. Veja [Comportamentos padrão por provedor de API](/docs/pt/data-usage#default-behaviors-by-api-provider) |

273| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy execute resolução DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host |348| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy execute resolução DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host |

274| `CLAUDE_CODE_REMOTE` | Definido automaticamente como `true` quando Claude Code está em execução como uma [sessão em nuvem](/docs/pt/claude-code-on-the-web). Leia isso de um hook ou script de configuração para detectar se você está em um ambiente em nuvem |349| `CLAUDE_CODE_REMOTE` | Defina automaticamente como `true` quando Claude Code está em execução como uma [sessão em nuvem](/docs/pt/claude-code-on-the-web). Leia isso de um hook ou script de configuração para detectar se você está em uma sessão em nuvem |

275| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definido automaticamente em [sessões em nuvem](/docs/pt/claude-code-on-the-web) para o ID da sessão atual. Leia isso para construir um link de volta para a transcrição da sessão. Veja [Vincular saída de volta à sessão](/docs/pt/claude-code-on-the-web#link-output-back-to-the-session) |350| `CLAUDE_CODE_REMOTE_SESSION_ID` | Defina automaticamente em [sessões em nuvem](/docs/pt/claude-code-on-the-web) para o ID da sessão atual. Leia isso para construir um link de volta para a transcrição da sessão. Veja [Vincule saída de volta à sessão](/docs/pt/cloud-environments#link-output-back-to-the-session) |

276| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de uma volta. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt |351| `CLAUDE_CODE_RESTRICTED` | Defina como `1` para iniciar a sessão em modo restrito, o mesmo que passar [`--restricted`](/docs/pt/cli-reference#cli-flags). Claude Code ignora essa variável em um bloco `env` de arquivo de configurações. Requer Claude Code v2.1.248 ou posterior |

277| `CLAUDE_CODE_RESUME_PROMPT` | Substitua a mensagem de continuação injetada ao retomar uma sessão que terminou no meio de uma volta. Padrão é `Continue from where you left off.`. Scripts de spawn para agentes de longa duração podem definir isso para uma mensagem de inicialização mais diretiva. Uma string vazia usa o padrão |352| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de uma volta. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt. Para desativar isso, desconfigurar a variável ou defini-la como `0`. Antes da v2.1.221, Claude Code ignorava `0` e outros valores falsos, para que definir `0` ainda acionasse a retomada em modo não interativo e desconfigurar a variável era a única forma de desativar |

278| `CLAUDE_CODE_RETRY_WATCHDOG` | Defina como `1` para sessões não supervisionadas, como harnesses de avaliação, trabalhos 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 watchdog recua até 5 minutos entre tentativas, ou até o limite ser redefinido quando a resposta carrega um tempo de redefinição de limite de taxa, então uma sessão que atinge um limite de uso aguarda a janela restante. A partir de v2.1.199, também aumenta a contagem de retry padrão para outros erros transitórios, como erros de servidor, timeouts e conexões descartadas, 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 |353| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Idade máxima em milissegundos da última mensagem de transcrição para uma sessão que terminou no meio de uma volta para continuar automaticamente na retomada. Quando a última mensagem é mais antiga que esse limite, Claude Code pula tanto a retomada automática `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` quanto a mensagem de continuação `CLAUDE_CODE_RESUME_PROMPT` injetada, e a sessão começa ociosa para que você continue explicitamente. Desconfigurado ou `0` significa sem limite; um valor negativo ou não numérico aplica um limite de uma hora. Scripts de spawn para agentes de longa duração podem definir isso para que uma reinicialização contra uma transcrição antiga não re-execute um prompt obsoleto. Claude Code define um limite de uma hora a si mesmo quando reinicia uma sessão [agent view](/docs/pt/agent-view) travada que herdou sua conversa de uma sessão interativa. Requer Claude Code v2.1.211 ou posterior |

279| `CLAUDE_CODE_SAFE_MODE` | Defina como `1` para iniciar em modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos personalizados e agentes, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam, para solucionar problemas de uma configuração quebrada. A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Equivalente a passar [`--safe-mode`](/docs/pt/cli-reference#cli-flags). Processos filhos gerados diretamente herdam a variável |354| `CLAUDE_CODE_RESUME_PROMPT` | Substitua a mensagem de continuação injetada ao retomar uma sessão que terminou no meio de uma volta. Padrão é `Continue from where you left off.`. Scripts de spawn para agentes de longa duração podem definir isso para uma mensagem de boot mais diretiva. Uma string vazia usa o padrão |

280| `CLAUDE_CODE_SCRIPT_CAPS` | Objeto JSON limitando quantas vezes scripts específicos podem ser invocados por sessão quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` está definido. As chaves são substrings correspondidas contra o texto do comando; os valores são limites de chamadas inteiras. 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 de shell como `./scripts/deploy.sh $(evil)` ainda contam contra o limite. Fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; este é um controle de defesa em profundidade |355| `CLAUDE_CODE_RETRY_WATCHDOG` | Defina como `1` para sessões não supervisionadas como harnesses de avaliação, trabalhos CI ou workers remotos. Tenta novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. Claude Code falha imediatamente em um `429` que relata um limite de gastos ou créditos de uso esgotados, mesmo um de um [limite de gastos gateway](/docs/pt/errors#spend-limit-reached) que reinicia em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses indefinidamente. O watchdog recua até 5 minutos entre tentativas, ou até o limite reiniciar quando a resposta carrega um tempo de reinicialização de limite de taxa, para que uma sessão que atinge um limite de uso aguarde a janela restante. Na v2.1.199 ou posterior também aumenta a contagem de tentativa padrão para outros erros transitórios, como erros de servidor, timeouts e conexões descartadas, para 300, aproximadamente três horas de recuo, 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 |

281| `CLAUDE_CODE_SCROLL_SPEED` | Defina o multiplicador de rolagem da roda do mouse em [renderização em tela cheia](/docs/pt/fullscreen#mouse-wheel-scrolling). Aceita valores de 1 a 20 e valores fracionários abaixo de 1, como `0.5` para desacelerar a rolagem acelerada de trackpad e roda em terminais que já amplificam eventos de roda. Defina como `3` para corresponder a `vim` se seu terminal enviar um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio tratamento de rolagem |356| `CLAUDE_CODE_SAFE_MODE` | Defina como `1` para iniciar em modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos personalizados e agentes, estilos de saída, fluxos de trabalho, temas personalizados, atalhos de teclado personalizados, comandos de status line e sugestão de arquivo, servidores LSP, e memória automática não carregam, para solução de problemas de uma configuração quebrada. A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, status line e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado, e servidores MCP configurados por política não. Equivalente a passar [`--safe-mode`](/docs/pt/cli-reference#cli-flags). Processos filhos gerados diretamente herdam a variável |

282| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Substitua o orçamento de tempo em milissegundos para hooks [SessionEnd](/docs/pt/hooks#sessionend). Aplica-se à saída de sessão, `/clear` e alternância de sessões via `/resume` interativo. Por padrão, o orçamento é 1,5 segundos, automaticamente aumentado para o `timeout` por hook mais alto configurado em arquivos de configuração, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento |357| `CLAUDE_CODE_SCRIPT_CAPS` | Objeto JSON limitando quantas vezes scripts específicos podem ser invocados por sessão quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` está definido. Chaves são substrings correspondidas contra o texto do comando; valores são limites de chamada inteiros. Por exemplo, `{"deploy.sh": 2}` permite `deploy.sh` ser chamado no máximo duas vezes. A correspondência é baseada em substring para que truques de expansão de shell como `./scripts/deploy.sh $(evil)` ainda contem contra o limite. Fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; isso é um controle de defesa em profundidade |

283| `CLAUDE_CODE_SESSION_ID` | Definido automaticamente em subprocessos de ferramenta Bash e PowerShell, subprocessos de [comando hook](/docs/pt/hooks) e subprocessos [servidor MCP](/docs/pt/mcp) stdio para o ID da sessão atual. Para Bash, PowerShell e hooks, isso corresponde ao campo `session_id` na entrada JSON do hook e é atualizado em `/clear`. Um subprocesso de servidor MCP retém o ID com o qual foi gerado. Em `--resume <session-id>` ele recebe o ID retomado, correspondendo a hooks e Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber o ID de inicialização inicial em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que as iniciou |358| `CLAUDE_CODE_SCROLL_SPEED` | Defina o multiplicador de velocidade de rolagem de roda do mouse em [renderização fullscreen](/docs/pt/fullscreen#mouse-wheel-scrolling). Aceita qualquer valor positivo até 20, incluindo valores fracionários abaixo de 1 como `0.5` para desacelerar rolagem de trackpad e roda acelerada em terminais que já amplificam eventos de roda. Defina como `3` para corresponder `vim` se seu terminal envia um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio manuseio de rolagem |

284| `CLAUDE_CODE_SHELL` | Defina o shell que Claude Code usa para executar comandos da ferramenta Bash. Aceita um caminho para um binário `bash` ou `zsh`, por exemplo `/opt/homebrew/bin/bash`. Outros shells como `fish` não são suportados. Se o valor não for um caminho `bash` ou `zsh` funcionando, Claude Code o ignora e volta para auto-detecção. A auto-detecção usa seu `$SHELL` quando aponta para `bash` ou `zsh`, caso contrário, escolhe o primeiro `zsh` funcionando e depois `bash` encontrado no seu `PATH` e locais de instalação padrão |359| `CLAUDE_CODE_SEND_FEEDBACK` | Defina como `0` para desativar [feedback redigido por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior) para uma sessão. Defina como `1` para ativá-lo onde sua conta já tem acesso; a variável não pode conceder acesso a si mesma, e os outros switches que desativam feedback, como `DISABLE_FEEDBACK_COMMAND` e o valor `off` da configuração [`feedbackDrafts`](/docs/pt/settings-reference#feedbackdrafts), ainda se aplicam |

285| `CLAUDE_CODE_SHELL_PREFIX` | Prefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos [hook](/docs/pt/hooks), [linha de status](/docs/pt/statusline) comandos, e comandos de inicialização de [servidor MCP](/docs/pt/mcp) stdio. Hooks de forma exec e hooks PowerShell são executados sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples como `/path/to/logger.sh` executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um único argumento shell-quoted em `$1`, então o wrapper deve re-avaliar `$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 de ferramenta Bash, `$1` contém a invocação de shell completa que Claude Code monta, incluindo configuração de ambiente, não apenas o comando que Claude executou |360| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Substitua o orçamento de tempo em milissegundos para hooks [SessionEnd](/docs/pt/hooks#sessionend). Aplica-se a saída de sessão, `/clear`, e alternância de sessões via `/resume` interativo. Por padrão o orçamento é 1.5 segundos, automaticamente aumentado para o `timeout` por hook mais alto configurado em arquivos de configurações, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento |

286| `CLAUDE_CODE_SIMPLE` | Defina como `1` para executar com um prompt do sistema mínimo e apenas as ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de `--mcp-config` ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. Tokens OAuth e credenciais de keychain não são lidos, então a autenticação Anthropic deve vir de `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em `--settings`. Equivalente a passar [`--bare`](/docs/pt/headless#start-faster-with-bare-mode) |361| `CLAUDE_CODE_SESSION_ID` | Defina automaticamente para o ID da sessão atual em subprocessos de ferramenta Bash e PowerShell, subprocessos [comando hook](/docs/pt/hooks), e subprocessos [servidor MCP](/docs/pt/mcp) stdio. Para Bash, PowerShell e hooks isso corresponde ao campo `session_id` na entrada JSON do hook e é atualizado em `/clear`. Um subprocesso de servidor MCP retém o ID que foi gerado com. Em `--resume <session-id>` recebe o ID retomado, correspondendo hooks e Bash. Em `--continue` ou `--resume` sem um ID explícito pode receber o ID de inicialização inicial. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que os iniciou |

287| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Defina como `1` para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para optar por não participar mesmo em modelos onde o experimento ou configuração do servidor habilitaria de outra forma. O conjunto de ferramentas completo, hooks, servidores MCP e descoberta de CLAUDE.md permanecem habilitados |362| `CLAUDE_CODE_SHELL` | Defina o shell que Claude Code usa para executar comandos de ferramenta Bash. Aceita um caminho para um binário `bash` ou `zsh`, por exemplo `/opt/homebrew/bin/bash`. Outros shells como `fish` não são suportados. Se o valor não é um caminho `bash` ou `zsh` funcionando, Claude Code o ignora e volta para auto-detecção. Auto-detecção usa seu `$SHELL` quando aponta para `bash` ou `zsh`, caso contrário pega o primeiro `zsh` funcionando então `bash` encontrado em seu `PATH` e locais de instalação padrão |

288| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Pule autenticação do lado do cliente para [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), para gateways que assinam solicitações por conta própria |363| `CLAUDE_CODE_SHELL_PREFIX` | Prefixo de comando que envolve comandos de shell que Claude Code gera: chamadas de ferramenta Bash, comandos [hook](/docs/pt/hooks), comandos [status line](/docs/pt/statusline), e comandos de inicialização [servidor MCP](/docs/pt/mcp) stdio. Hooks de forma exec e PowerShell executam sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples como `/path/to/logger.sh` executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um argumento simples entre aspas de shell em `$1`, para que o wrapper deva re-avaliar `$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 de ferramenta Bash, `$1` contém a invocação de shell completa que Claude Code monta, incluindo configuração de ambiente, não apenas o comando que Claude executou |

289| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Defina como `1` para desativar o cache em processo de credenciais resolvidas da cadeia de provedor de credencial padrão AWS, para que Claude Code resolva a cadeia em cada solicitação de API. Com o cache desativado, um perfil apoiado por SSO solicita credenciais do IAM Identity Center em cada solicitação. Veja [cache de credencial e tempo limite de resolução](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout). Requer Claude Code v2.1.207 ou posterior |364| `CLAUDE_CODE_SIMPLE` | Defina como `1` para executar com um prompt do sistema mínimo e apenas as ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de `--mcp-config` ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, comandos personalizados, subagentes, plugins, servidores MCP, memória automática e CLAUDE.md. Skills em um diretório que você passa com `--add-dir` ainda carregam. Tokens OAuth e credenciais de keychain não são lidos, para que autenticação Anthropic deva vir de `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em `--settings`. Equivalente a passar [`--bare`](/docs/pt/headless#start-faster-with-bare-mode) |

365| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Defina como `1` para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em qualquer modelo. Defina como `0`, `false`, `no`, ou `off` para optar por não participar mesmo em modelos onde o experimento ou configuração do servidor a habilitaria. O conjunto completo de ferramentas, descoberta de hooks, servidores MCP e CLAUDE.md permanecem habilitados |

366| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Pule autenticação do lado do cliente para [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), para gateways que assinam solicitações a si mesmos |

367| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Defina como `1` para desativar o cache em processo de credenciais resolvidas da cadeia de provedor de credencial padrão AWS, para que Claude Code resolva a cadeia em cada solicitação de API. Com o cache desativado, um perfil apoiado por SSO solicita credenciais do IAM Identity Center em cada solicitação. Veja [cache de credencial e timeout de resolução](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout). Requer Claude Code v2.1.207 ou posterior |

291| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Pule autenticação Azure para Microsoft Foundry, para um proxy ou gateway que injeta seu próprio cabeçalho `Authorization`. Claude Code envia solicitações sem uma credencial do Azure e preserva o cabeçalho `Authorization` que você fornece, por exemplo através de `ANTHROPIC_CUSTOM_HEADERS`. Ignorado quando `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` está definido. Antes de v2.1.203, essa variável deixava o cliente Microsoft Foundry incapaz de enviar solicitações a menos que uma chave de API também estivesse definida |369| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Defina como `1` para tratar uma verificação de disponibilidade [modo rápido](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) falhada como disponível, para redes que bloqueiam a solicitação direta da verificação para `api.anthropic.com`. Claude Code ainda honra uma resposta "desabilitado pela sua organização" |

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

371| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Pule autenticação Azure para Microsoft Foundry, para um proxy ou gateway que injeta seu próprio cabeçalho `Authorization`. Claude Code envia solicitações sem uma credencial Azure e preserva o cabeçalho `Authorization` que você fornece, por exemplo através de `ANTHROPIC_CUSTOM_HEADERS`. Ignorado quando `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` está definido. Antes da v2.1.203, essa variável deixava o cliente Microsoft Foundry incapaz de enviar solicitações a menos que uma chave de API também estivesse definida |

292| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Pule autenticação AWS para Amazon Bedrock Mantle (por exemplo, ao usar um gateway LLM) |372| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Pule autenticação AWS para Amazon Bedrock Mantle (por exemplo, ao usar um gateway LLM) |

293| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Defina como `1` para pular a escrita de histórico de prompt e transcrições de sessão em disco. Sessões iniciadas com essa variável definida não aparecem em `--resume`, `--continue` ou histórico de seta para cima. Útil para sessões com script efêmeras |373| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Defina como `1` para pular escrita de histórico de prompt e transcrições de sessão em disco. Sessões iniciadas com essa variável definida não aparecem em `--resume`,`--continue`, ou histórico de seta para cima. Útil para sessões de script efêmeras |

294| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Pule autenticação Google para Google Cloud's Agent Platform (por exemplo, ao usar um gateway LLM) |374| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Pule autenticação Google para Google Cloud's Agent Platform (por exemplo, ao usar um gateway LLM) |

295| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Número máximo de vezes consecutivas que um hook [Stop](/docs/pt/hooks#stop) ou [SubagentStop](/docs/pt/hooks#subagentstop) pode bloquear o término da volta antes que Claude Code o substitua e termine a volta de qualquer forma (padrão: 8). Defina como `0` para desabilitar o limite. Aumente isso se seu hook legitimamente precisa de mais iterações para resolver |375| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Número máximo de vezes consecutivas que um hook [Stop](/docs/pt/hooks#stop) ou [SubagentStop](/docs/pt/hooks#subagentstop) pode bloquear a volta de terminar antes de Claude Code substituir e terminar a volta mesmo assim (padrão: 8). Defina como `0` para desabilitar o limite. Aumente isso se seu hook legitimamente precisa de mais iterações para resolver |

296| `CLAUDE_CODE_SUBAGENT_MODEL` | Veja [Configuração de modelo](/docs/pt/model-config). A partir de v2.1.196, defini-lo como `inherit` é o mesmo que deixá-lo não definido; versões anteriores tratavam `inherit` como um override que forçava cada subagente para o modelo da conversa principal |376| `CLAUDE_CODE_SUBAGENT_MODEL` | O modelo padrão para [subagentes](/docs/pt/sub-agents#choose-a-model), [equipe de agentes](/docs/pt/agent-teams#specify-teammates-and-models) companheiros, e agentes [fluxo de trabalho](/docs/pt/workflows) que não são atribuídos a um modelo de outra forma. Aceita um alias como `haiku` ou um nome de modelo completo. Duas fontes têm precedência sobre ele: um modelo que Claude passa quando gera o agente, e um campo `model` na definição do agente, incluindo `inherit`. Para mudar isso, defina [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/pt/sub-agents#run-every-subagent-on-one-model). Veja [Escolha um modelo](/docs/pt/sub-agents#choose-a-model) para a ordem completa. Defini-lo como `inherit` é o mesmo que deixá-lo desconfigurado. Antes da v2.1.251, essa variável substituía tanto o modelo por invocação quanto o campo `model` da definição |

297| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Defina como `1` para remover credenciais do Anthropic e do provedor de nuvem de ambientes de subprocesso (ferramenta Bash, hooks, servidores MCP stdio). O processo Claude pai mantém essas credenciais para chamadas de API, mas processos filhos não podem lê-las, reduzindo a exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão de shell. No Linux, isso também executa subprocessos Bash em um namespace PID isolado para que não possam ler ambientes de processo do host via `/proc`; como efeito colateral, `ps`, `pgrep` e `kill` não podem ver ou sinalizar processos do host. `claude-code-action` define isso automaticamente quando `allowed_non_write_users` está configurado |377| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Defina como `1` para forçar um modelo em subagentes, companheiros e agentes de fluxo de trabalho. [Execute cada subagente em um modelo](/docs/pt/sub-agents#run-every-subagent-on-one-model) diz qual modelo é esse. Requer Claude Code v2.1.257 ou posterior |

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

379| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Defina como `1` para remover credenciais de ambientes de subprocesso (ferramenta Bash, hooks, servidores MCP stdio): credenciais Anthropic e provedor de nuvem, qualquer outra variável que Claude Code reconhece como credencial, e credenciais incorporadas em URLs de registro de pacotes. O processo Claude pai mantém essas credenciais para chamadas de API, mas processos filhos não podem lê-las, reduzindo exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão de shell. No Linux, isso também executa subprocessos Bash em um namespace PID isolado para que não possam ler ambientes de processo host via `/proc`; como efeito colateral, `ps`, `pgrep`, e `kill` não podem ver ou sinalizar processos host. `claude-code-action` define isso automaticamente quando `allowed_non_write_users` está configurado |

298| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Defina como `1` em modo não interativo (a flag `-p`) para aguardar a conclusão da instalação de plugin antes da primeira consulta. Sem isso, plugins instalam em segundo plano e podem não estar disponíveis na primeira volta. Combine com `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar a espera |380| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Defina como `1` em modo não interativo (a flag `-p`) para aguardar a conclusão da instalação de plugin antes da primeira consulta. Sem isso, plugins instalam em segundo plano e podem não estar disponíveis na primeira volta. Combine com `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar a espera |

299| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Tempo limite em milissegundos para instalação síncrona de plugin. Quando excedido, Claude Code prossegue sem plugins e registra um erro. Sem padrão: sem essa variável, instalação síncrona aguarda até a conclusão |381| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para instalação de plugin síncrona. Quando excedido, Claude Code prossegue sem plugins e registra um erro. Sem padrão: sem essa variável, instalação síncrona aguarda até completar |

300| `CLAUDE_CODE_SYNC_SKILLS` | Defina como `1` para baixar suas skills habilitadas do claude.ai em `~/.claude/skills/` antes da primeira consulta e ressincronizar a cada 10 minutos. Aplica-se apenas em modo não interativo com a flag `-p`. Requer autenticação claude.ai. [Claude Code on the web](/docs/pt/claude-code-on-the-web) sessões recebem suas skills habilitadas do claude.ai automaticamente; você não precisa definir isso lá |382| `CLAUDE_CODE_SYNC_SKILLS` | Defina como `1` para baixar suas skills claude.ai habilitadas em `~/.claude/skills/synced/` e ressincronizar a cada 10 minutos. Antes de executar a primeira consulta, Claude Code aguarda até `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` pela lista de suas skills. Os downloads em si terminam em segundo plano, e Claude aguarda o download de uma skill quando a invoca. O nome da pasta `synced` é [reservado para esse download](/docs/pt/skills#where-skills-live). Antes da v2.1.227, as skills baixavam em `~/.claude/skills/` diretamente. Aplica-se apenas em modo não interativo com a flag `-p`. Requer autenticação claude.ai. [Sessões Claude Code na web](/docs/pt/claude-code-on-the-web) recebem suas skills claude.ai habilitadas automaticamente; você não precisa definir isso lá. Claude Code aplica [regras extras às skills baixadas](/docs/pt/skills#how-synced-skills-behave), como não executar seus comandos `!` em sua máquina |

301| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Tempo limite em milissegundos para uma ressincronização de skills no meio da sessão quando `CLAUDE_CODE_SYNC_SKILLS` está definido (padrão: 30000). Limita o download acionado quando o host solicita um recarregamento de skill durante a sessão. Quando excedido, a ressincronização para e os downloads de skill restantes continuam em segundo plano |383| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout em milissegundos para uma ressincronização de skills no meio da sessão quando `CLAUDE_CODE_SYNC_SKILLS` está definido (padrão: 30000). Limita o download acionado quando o host solicita um recarregamento de skill durante a sessão. Quando excedido, a ressincronização para e downloads restantes continuam em segundo plano |

302| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Tempo limite em milissegundos para a primeira consulta aguardar na sincronização inicial de skills quando `CLAUDE_CODE_SYNC_SKILLS` está definido (padrão: 5000). Quando excedido, a consulta prossegue e os downloads de skill restantes continuam em segundo plano |384| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout em milissegundos para a primeira consulta aguardar a lista de skill inicial quando `CLAUDE_CODE_SYNC_SKILLS` está definido (padrão: 5000). Quando excedido, a primeira consulta executa com quaisquer skills que chegaram. Os downloads terminam em segundo plano de qualquer forma, e Claude aguarda o download de uma skill quando a invoca |

303| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Defina como `false` para desabilitar destaque de sintaxe na saída de diff. Útil quando cores interferem com sua configuração de terminal. Para também desabilitar destaque em blocos de código e visualizações de arquivo, use a configuração [`syntaxHighlightingDisabled`](/docs/pt/settings) |385| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Defina como `false` para desabilitar destaque de sintaxe em saída de diff. Útil quando cores interferem com sua configuração de terminal. Para também desabilitar destaque em blocos de código e visualizações de arquivo, use a configuração [`syntaxHighlightingDisabled`](/docs/pt/settings-reference#syntaxhighlightingdisabled) |

304| `CLAUDE_CODE_TASK_LIST_ID` | Compartilhe uma lista de tarefas entre sessões. Defina o mesmo ID em múltiplas instâncias do Claude Code para coordenar em uma lista de tarefas compartilhada. Veja [Lista de tarefas](/docs/pt/interactive-mode#task-list) |386| `CLAUDE_CODE_TASK_LIST_ID` | Compartilhe uma lista de tarefas entre sessões. Defina o mesmo ID em múltiplas instâncias Claude Code para coordenar em uma lista de tarefas compartilhada, em [sessões que têm as ferramentas Task](/docs/pt/tools-reference#task-tool-availability). Veja [Lista de tarefas](/docs/pt/interactive-mode#task-list) |

305| `CLAUDE_CODE_TEAM_NAME` | Nome da equipe de agentes à qual este companheiro pertence. Definido automaticamente em membros de [equipe de agentes](/docs/pt/agent-teams) |387| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Substitua, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para sua [equipe de agentes](/docs/pt/agent-teams) terminar de desmontar. Aceita 1000 a 60000; um valor fora do intervalo é ignorado e o padrão de 10000 se aplica. Requer Claude Code v2.1.206 ou posterior |

306| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Substitua, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para que sua [equipe de agentes](/docs/pt/agent-teams) termine de desmontar. Aceita 1000 a 60000; um valor fora do intervalo é ignorado e o padrão de 10000 se aplica. Requer Claude Code v2.1.206 ou posterior |388| `CLAUDE_CODE_TMPDIR` | Substitua o diretório temp usado para arquivos temp internos. Claude Code anexa `/claude-{uid}/` em Unix ou `/claude/` no Windows a esse caminho. Padrão: `/tmp` em macOS, `os.tmpdir()` em Linux e Windows. Em macOS e Linux, subprocessos Bash [sandboxed](/docs/pt/sandboxing) recebem um fallback `$TMPDIR` curto sob o padrão do sistema quando sua substituição é um caminho longo, já que algumas ferramentas falham quando caminhos temp ficam muito longos. Comandos Bash não sandboxed herdam seu `$TMPDIR` de shell inalterado. Os próprios arquivos temp de Claude Code sempre usam sua substituição. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

307| `CLAUDE_CODE_TMPDIR` | Substitua o diretório temporário usado para arquivos temporários internos. Claude Code acrescenta `/claude-{uid}/` em Unix ou `/claude/` no Windows a este caminho. Padrão: `/tmp` em macOS, `os.tmpdir()` em Linux e Windows. A partir de v2.1.161, em macOS e Linux, subprocessos Bash [sandboxed](/docs/pt/sandboxing) recebem um fallback `$TMPDIR` curto sob o padrão do sistema quando sua substituição é um caminho longo, já que algumas ferramentas falham quando caminhos temporários ficam muito longos. Comandos Bash não sandboxed herdam seu `$TMPDIR` de shell inalterado. Os próprios arquivos temporários do Claude Code sempre usam sua substituição |389| `CLAUDE_CODE_TMUX_TRUECOLOR` | Defina como qualquer valor não vazio, como `1`, para permitir saída truecolor de 24 bits dentro de tmux. **Defini-lo como `0` ou `false` ainda permite truecolor**, diferentemente da maioria das variáveis on/off; desconfigurar a variável para restaurar o limite de 256 cores. Por padrão, Claude Code limita a 256 cores quando `$TMUX` está definido porque tmux não passa sequências de escape truecolor a menos que configurado. Defina isso após adicionar `set -ga terminal-overrides ',*:Tc'` a seu `~/.tmux.conf`. Veja [Configuração de Terminal](/docs/pt/terminal-config) para outras configurações tmux |

308| `CLAUDE_CODE_TMUX_TRUECOLOR` | Defina como `1` para permitir saída truecolor de 24 bits dentro de tmux. Por padrão, Claude Code limita a 256 cores quando `$TMUX` está definido porque tmux não passa sequências de escape truecolor a menos que esteja configurado para isso. Defina isso após adicionar `set -ga terminal-overrides ',*:Tc'` ao seu `~/.tmux.conf`. Veja [Configuração de terminal](/docs/pt/terminal-config) para outras configurações de tmux |390| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Em Linux e WSL, defina como uma lista separada por vírgulas dos tipos de processos que Claude Code [exclui do limite de memória de ferramenta](/docs/pt/tools-reference#memory-limit-on-linux-and-wsl), como `mcp` ou `lsp`. Defina `none` para limitar cada tipo, ou `all-new` para limitar apenas comandos de ferramentas Bash, PowerShell e Monitor. Claude Code mantém comandos de ferramentas Bash, PowerShell e Monitor sob o limite qualquer que você liste. Requer Claude Code v2.1.246 ou posterior |

391| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Em Linux e WSL, defina como um tamanho como `4G` para [limitar a memória que comandos de ferramentas Bash e PowerShell podem usar](/docs/pt/tools-reference#memory-limit-on-linux-and-wsl), e comandos de ferramenta Monitor na v2.1.246 ou posterior. Escreva o tamanho em dígitos simples, sozinho para um número de bytes ou com um sufixo `K`, `M`, `G`, ou `T`. Defina `0` ou `off` para desativar o limite. Uma vez que o primeiro processo que Claude Code começa tenha ativado ou desativado o limite, um valor alterado tem efeito na próxima vez que você inicia `claude`. Requer Claude Code v2.1.233 ou posterior |

392| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Prazo em milissegundos antes de Claude Code cancelar um diálogo que encaminha para um cliente remoto como um [Remote Control](/docs/pt/remote-control) ou host SDK, ou o diálogo de aprovação para uma [mensagem entre sessões retida](/docs/pt/cross-session-messaging#control-inbound-messages); prompts de permissão e perguntas `AskUserQuestion` usam seus próprios fluxos e não são governados por ele. No Claude Code v2.1.236 ou posterior, também limita o [prompt de consentimento de créditos de uso Fable](/docs/pt/model-config#fable-and-usage-credits) no meio da sessão em uma sessão que pode estar em execução não supervisionada. [Controle mensagens de entrada](/docs/pt/cross-session-messaging#control-inbound-messages) e [sessões não interativas](/docs/pt/cross-session-messaging#non-interactive-sessions) cobrem as regras de expiração de mensagem retida completa, incluindo os casos onde o prazo não se aplica. Substitui a configuração [`dialogExpiry`](/docs/pt/settings-reference#dialogexpiry). `0` ou um valor negativo desabilita o prazo |

313| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Defina como `1` para descobrir comandos personalizados, subagentes e estilos de saída usando APIs de arquivo Node.js em vez de ripgrep. Defina isso se o binário ripgrep agrupado estiver indisponível ou bloqueado em seu ambiente. Não afeta as ferramentas Grep ou busca de arquivo |397| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Defina como `1` para descobrir comandos personalizados, subagentes e estilos de saída usando APIs de arquivo Node.js em vez de ripgrep. Defina isso se o binário ripgrep agrupado não está disponível ou bloqueado em seu ambiente. Não afeta as ferramentas Grep ou busca de arquivo |

314| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta é habilitada automaticamente; defina como `0` para desabilitá-la. No Windows com Git Bash instalado, a ferramenta está sendo lançada progressivamente: defina como `1` para optar por participar ou `0` para optar por não participar. No Linux, macOS e WSL, defina como `1` para habilitá-la, o que requer `pwsh` no seu `PATH`. Quando habilitada no Windows, Claude pode executar comandos PowerShell nativamente em vez de rotear através do Git Bash. Veja [Ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) |398| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta está ativada automaticamente; defina como `0` para desabilitá-la. No Windows com Git Bash instalado, a ferramenta está ativa por padrão para contas claude.ai e Console; defina como `1` para habilitá-la em sessões Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, ou `0` para desativá-la. Em Linux, macOS e WSL, defina como `1` para habilitá-la, o que requer `pwsh` em seu `PATH`. Quando ativada no Windows, Claude pode executar comandos PowerShell nativamente em vez de rotear através de Git Bash. Veja [Ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) |

316| `CLAUDE_CONFIG_DIR` | Substitua o diretório de configuração (padrão: `~/.claude`). Todas as configurações, histórico de sessão e plugins são armazenados sob este caminho, assim como credenciais no Linux e Windows; em macOS, credenciais estão no Keychain do sistema. Útil para executar múltiplas contas lado a lado: por exemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |400| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Defina como o número de milissegundos que [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) mantém cada resposta de URL buscada em cache. O padrão é `900000`, que é 15 minutos. Aceita apenas dígitos simples; `0`, um decimal, ou qualquer outra grafia mantém o padrão. Claude Code lê o valor uma vez por lançamento, para que uma mudança em um bloco `env` de configurações se aplique quando você próximo inicia `claude`. Requer Claude Code v2.1.233 ou posterior |

317| `CLAUDE_DISABLE_ADOPT` | Defina como `1` para parar o trabalho em segundo plano em andamento em vez de carregá-lo quando você coloca uma sessão em segundo plano pressionando `←` ou com [`/background`](/docs/pt/agent-view#from-inside-a-session). Claude Code pede que você confirme antes de colocar em segundo plano, então para as tarefas que de outra forma seriam carregadas. Requer Claude Code v2.1.195 ou posterior |401| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superior em milissegundos em quanto tempo [WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) aguarda uma página baixar, incluindo qualquer redirecionamento que segue. Um download que não completou até então falha com um erro de prazo. O padrão é `300000`, que é cinco minutos. Defina como `0` para remover o limite. Aceita apenas dígitos simples; um decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior |

318| `CLAUDE_EFFORT` | Definido automaticamente em subprocessos de ferramenta Bash e comandos hook para o [nível de esforço](/docs/pt/model-config#adjust-effort-level) ativo para a volta: `low`, `medium`, `high`, `xhigh` ou `max`. Ultracode não é um nível distinto e relata como `xhigh`. Corresponde ao campo `effort.level` passado para [hooks](/docs/pt/hooks). Apenas definido quando o modelo atual suporta o parâmetro de esforço |402| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superior em milissegundos em quanto tempo um agente [fluxo de trabalho](/docs/pt/workflows) aguarda a primeira resposta de um irmão de mesmo prefixo começar antes de enviar sua própria primeira solicitação. Quando um fan-out começa vários agentes que compartilham um [prefixo de cache de prompt](/docs/pt/workflows#prompt-caching-in-a-fan-out), Claude Code mantém todos exceto o primeiro agente por até esse tempo para que o resto leia o prefixo em cache em vez de cada processá-lo sem cache. Padrão `5000`. Defina como `0` para desabilitar a espera. Quando `DISABLE_PROMPT_CACHING` está definido, agentes nunca aguardam. Requer Claude Code v2.1.229 ou posterior |

319| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Defina como `1` para forçar a habilitação do watchdog ocioso de nível de byte, ou defina como `0` para forçar a desabilitação. Quando não definido, o watchdog é habilitado por padrão para conexões diretas da API Anthropic e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). O watchdog de byte aborta uma conexão quando nenhum byte chega no fio por 180 segundos por padrão em conexões diretas da API Anthropic, 300 segundos em Claude Platform on AWS e quando habilitado em Amazon Bedrock, ou para o valor de `CLAUDE_STREAM_IDLE_TIMEOUT_MS` quando isso está definido, que é fixado a um mínimo de 5 minutos, independente do watchdog de nível de evento |403| `CLAUDE_CONFIG_DIR` | Substitua o diretório de configuração (padrão: `~/.claude`). Todas as configurações, histórico de sessão e plugins são armazenados sob esse caminho. Para credenciais, veja [onde Claude Code armazena credenciais](/docs/pt/authentication#credential-management). Útil para executar múltiplas contas lado a lado: por exemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

320| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Defina como `1` para habilitar o watchdog ocioso de streaming de nível de byte em respostas `vnd.amazon.eventstream` do Amazon Bedrock. Desativado por padrão. Configure o tempo limite com `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |404| `CLAUDE_DISABLE_ADOPT` | Defina como `1` para parar trabalho em segundo plano em voo em vez de carregá-lo quando você coloca uma sessão em segundo plano pressionando `←` ou com [`/background`](/docs/pt/agent-view#from-inside-a-session). Claude Code pede para você confirmar antes de colocar em segundo plano, então para as tarefas que de outra forma carregariam. Requer Claude Code v2.1.195 ou posterior |

321| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Defina como `0` para forçar a desabilitação do watchdog ocioso de streaming de nível de evento, ou defina como `1` para forçar a habilitação. Quando não definido, o watchdog está ativado por padrão para todos os provedores. Antes de v2.1.196, o padrão não definido era controlado pelo servidor na API Anthropic direta e desativado em outros provedores. A partir de v2.1.169, provedores diferentes da API Anthropic direta e Claude Platform on AWS também têm um tempo limite de inatividade de corpo padrão de 5 minutos independente desta variável; veja `API_FORCE_IDLE_TIMEOUT`. Em Amazon Bedrock, você também pode habilitar o watchdog de nível de byte independente com `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; os dois funcionam juntos quando ambos estão definidos. Configure o tempo limite com `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |405| `CLAUDE_EFFORT` | Defina automaticamente em subprocessos de ferramenta Bash e comandos hook para o [nível de effort](/docs/pt/model-config#adjust-effort-level) em efeito quando o subprocesso começa: `low`, `medium`, `high`, `xhigh`, ou `max`. Ultracode não é um nível distinto e relata como `xhigh`. Corresponde ao campo `effort.level` passado para [hooks](/docs/pt/hooks). Apenas definido quando o modelo atual suporta o parâmetro effort |

322| `CLAUDE_ENV_FILE` | Caminho para um script de shell cujo conteúdo Claude Code executa antes de cada comando Bash no mesmo processo de shell, para que as exportações no arquivo sejam visíveis para o comando. Use para persistir ativação de virtualenv ou conda entre comandos. Também preenchido dinamicamente por hooks [SessionStart](/docs/pt/hooks#persist-environment-variables), [Setup](/docs/pt/hooks#setup), [CwdChanged](/docs/pt/hooks#cwdchanged) e [FileChanged](/docs/pt/hooks#filechanged) |406| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Defina como `1` para forçar-ativar o watchdog de inatividade de streaming em nível de byte, ou defina como `0` para forçar-desativar. `0` também desativa o [prazo de primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) nas conexões onde esse prazo é executado. Quando desconfigurado, o watchdog está ativado por padrão para conexões API Anthropic diretas e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), e para respostas de streaming em conexões [gateway](/docs/pt/gateways) alcançadas através de `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL`; antes da v2.1.222 não era executado nessas conexões de gateway, para que o watchdog em nível de evento pudesse relatar um travamento lá mesmo enquanto pings keep-alive estavam chegando. Para timeouts e como os timers interagem, veja [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |

323| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefixo para nomes de sessão [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito é fornecido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. A flag CLI `--remote-control-session-name-prefix` define o mesmo valor para uma única invocação |407| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Defina como `1` para ativar o watchdog de inatividade de streaming em nível de byte em respostas Amazon Bedrock `vnd.amazon.eventstream`, que também ativa o [prazo de primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) em solicitações de streaming Bedrock. Desativado por padrão. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

324| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Tempo limite em milissegundos antes que o watchdog ocioso de streaming feche uma conexão travada. Quando você define esta variável explicitamente, o mínimo é `300000` (5 minutos); valores mais baixos são silenciosamente fixados para absorver pausas de pensamento estendido e buffering de proxy. Quando não definido, o watchdog de nível de evento padrão é 300 segundos e o watchdog de nível de byte padrão é 180 segundos em conexões diretas da API Anthropic (300 segundos em Claude Platform on AWS e outros provedores). O padrão de 180 segundos do watchdog de byte não definido é um valor separado e não está sujeito ao clamp de 5 minutos. O tempo limite de inatividade de corpo descrito em `API_FORCE_IDLE_TIMEOUT` se aplica independentemente. Em Amazon Bedrock, também se aplica quando `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |408| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Defina como `0` para forçar-desativar o watchdog de inatividade de streaming em nível de evento, ou defina como `1` para forçar-ativar. Quando desconfigurado, o watchdog está ativado por padrão para todos os provedores. Antes da v2.1.196, o padrão desconfigurado era controlado pelo servidor na API Anthropic direta e desativado em outros provedores. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; para os outros timers de travamento que executam ao lado deste, veja [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |

325| `DEBUG` | Defina como `1` para habilitar modo de depuração, equivalente a iniciar com [`--debug`](/docs/pt/cli-reference#cli-flags). Logs de depuração são escritos 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` habilitam modo de depuração, então padrões de namespace como `DEBUG=express:*` definidos para outras ferramentas não o acionam |409| `CLAUDE_ENV_FILE` | Caminho para um script de shell cujo conteúdo Claude Code executa antes de cada comando Bash no mesmo processo de shell, para que exports no arquivo sejam visíveis ao comando. Use para persistir ativação de virtualenv ou conda entre comandos. Também populado dinamicamente por hooks [SessionStart](/docs/pt/hooks#persist-environment-variables), [Setup](/docs/pt/hooks#setup), [CwdChanged](/docs/pt/hooks#cwdchanged), e [FileChanged](/docs/pt/hooks#filechanged) |

410| `CLAUDE_JOB_DIR` | Defina por Claude Code em cada [sessão em segundo plano](/docs/pt/agent-view) para o diretório `~/.claude/jobs/<id>` dessa sessão. Comandos de shell que a sessão executa o herdam. Escreva arquivos scratch para [`$CLAUDE_JOB_DIR/tmp`](/docs/pt/agent-view#where-state-is-stored). Chamadas `Write` e `Edit` de Claude lá não solicitam permissão, e o diretório é removido quando a sessão é excluída |

411| `CLAUDE_PID` | Claude Code define isso para seu próprio ID de processo nos subprocessos que gera: comandos de ferramentas Bash e PowerShell e comandos hook. No Linux, a integração de shell da ferramenta Bash o usa para recusar um padrão `pkill` que corresponderia ao próprio processo Claude Code; veja [a referência de erro](/docs/pt/errors#pkill-pattern-matches-the-claude-code-process). Leia de seus próprios scripts para identificar ou sinalizar o processo Claude Code pai deliberadamente. Requer Claude Code v2.1.214 ou posterior |

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

413| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Prazo em milissegundos para o primeiro byte de resposta de uma solicitação de streaming, nas conexões onde o [prazo de primeiro byte](/docs/pt/network-config#streaming-idle-watchdogs) é executado. Para como Claude Code o limita, o tempo extra que adiciona para corpos de solicitação grandes, e como escolhe o prazo quando você deixa isso desconfigurado, veja [Sem resposta da API](/docs/pt/errors#no-response-from-api). Requer Claude Code v2.1.242 ou posterior |

414| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout em milissegundos antes dos watchdogs de inatividade de streaming em nível de evento e byte fecharem uma conexão travada. Quando você define essa variável explicitamente, o mínimo é `300000` (5 minutos); valores mais baixos são silenciosamente limitados 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 essa variável para o watchdog em nível de byte. Para os padrões desconfigurados por watchdog, veja [Watchdogs de inatividade de streaming](/docs/pt/network-config#streaming-idle-watchdogs) |

415| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Removido na v2.1.260 e agora é um no-op. Anteriormente limitava quanto tempo um [comando de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) que um [subagente](/docs/pt/sub-agents) iniciou poderia executar, em milissegundos, com um padrão de 60 minutos. Veja [as regras de tempo de vida de comando em segundo plano](/docs/pt/tools-reference#background-commands) |

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

326| `DISABLE_AUTOUPDATER` | Defina como `1` para desabilitar atualizações automáticas em segundo plano. Manual `claude update` ainda funciona. Use `DISABLE_UPDATES` para bloquear ambos |417| `DISABLE_AUTOUPDATER` | Defina como `1` para desabilitar atualizações automáticas em segundo plano. Manual `claude update` ainda funciona. Use `DISABLE_UPDATES` para bloquear ambos |

327| `DISABLE_AUTO_COMPACT` | Defina como `1` para desabilitar compactação automática ao se aproximar do limite de contexto. O comando manual `/compact` permanece disponível. Use quando você deseja controle explícito sobre quando a compactação ocorre |418| `DISABLE_AUTO_COMPACT` | Defina como `1` para desabilitar compactação automática ao se aproximar do limite de contexto. O comando manual `/compact` permanece disponível. Use quando você quer controle explícito sobre quando a compactação ocorre. Substitui a configuração [`autoCompactEnabled`](/docs/pt/settings-reference#autocompactenabled) |

328| `DISABLE_COMPACT` | Defina como `1` para desabilitar toda compactação: tanto compactação automática quanto o comando manual `/compact` |419| `DISABLE_COMPACT` | Defina como `1` para desabilitar toda compactação: tanto compactação automática quanto o comando manual `/compact` |

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

331| `DISABLE_ERROR_REPORTING` | Defina como `1` para optar por não participar do relatório de erros |422| `DISABLE_ERROR_REPORTING` | Defina como qualquer valor não vazio, como `1`, para optar por não participar de relatório de erros. **Defini-lo como `0` ou `false` ainda opta por não participar**, diferentemente da maioria das variáveis on/off; desconfigurar a variável para ativar relatório de erros novamente |

332| `DISABLE_EXTRA_USAGE_COMMAND` | Defina como `1` para ocultar o comando `/usage-credits` que permite aos usuários comprar uso adicional além dos limites de taxa |423| `DISABLE_EXTRA_USAGE_COMMAND` | Defina como `1` para ocultar o comando `/usage-credits` que deixa usuários comprar uso adicional além de limites de taxa |

333| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desabilitar o comando `/feedback`. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito |424| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desabilitar o comando `/feedback` e [feedback redigido por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior). Também desabilita `/bug` e `/share`, que relatam através do mesmo caminho; antes da v2.1.212 eram aliases de `/feedback`, para que o comando fosse desabilitado sob cada nome. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito |

334| `DISABLE_GROWTHBOOK` | Defina como `1` para desabilitar busca de flag de recurso GrowthBook e usar padrões de código para cada flag. Logging de eventos de telemetria permanece ativado a menos que `DISABLE_TELEMETRY` também esteja definido |425| `DISABLE_GROWTHBOOK` | Defina como `1` ou `true` para desabilitar busca de sinalizador de recurso GrowthBook e usar padrões de código para cada sinalizador. Isso torna [Remote Control](/docs/pt/remote-control#requirements) e os outros [recursos que precisam de busca de sinalizador de recurso](#features-that-need-feature-flag-fetching) indisponíveis. Defini-lo como `0` ou `false` deixa busca ativa. Logging de evento de telemetria permanece ativo a menos que `DISABLE_TELEMETRY` também esteja definido |

335| `DISABLE_INSTALLATION_CHECKS` | Defina como `1` para desabilitar avisos de instalação. Use apenas ao gerenciar manualmente o local de instalação, pois isso pode mascarar problemas com instalações padrão |426| `DISABLE_INSTALLATION_CHECKS` | Defina como `1` para desabilitar avisos de instalação. Use apenas ao gerenciar manualmente o local de instalação, já que isso pode mascarar problemas com instalações padrão |

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

337| `DISABLE_INTERLEAVED_THINKING` | Defina como `1` para evitar enviar o cabeçalho beta de pensamento intercalado. Útil quando seu gateway LLM ou provedor não suporta [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |428| `DISABLE_INTERLEAVED_THINKING` | Defina como `1` para evitar enviar o cabeçalho beta de pensamento intercalado. Útil quando seu gateway LLM ou provedor não suporta [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

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

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

345| `DISABLE_TELEMETRY` | Defina como `1` para optar por não participar da telemetria. Eventos de telemetria não incluem dados do usuário como código, caminhos de arquivo ou comandos bash. Também desabilita busca de flags de recurso com o mesmo efeito que `DISABLE_GROWTHBOOK`, então alguns recursos sinalizados podem não estar disponíveis |436| `DISABLE_TELEMETRY` | Defina como qualquer valor não vazio, como `1`, para optar por não participar de telemetria. **Defini-lo como `0` ou `false` ainda opta por não participar**, diferentemente da maioria das variáveis on/off; desconfigurar a variável para ativar telemetria novamente. Eventos de telemetria não incluem dados de usuário como código, caminhos de arquivo ou comandos bash. Também desabilita busca de sinalizador de recurso com o mesmo efeito que `DISABLE_GROWTHBOOK`, o que torna [Remote Control](/docs/pt/remote-control#requirements) e os outros [recursos que precisam de busca de sinalizador de recurso](#features-that-need-feature-flag-fetching) indisponíveis. Veja [Desativar telemetria para sua organização](/docs/pt/managed-settings#turn-telemetry-off-for-your-organization) |

346| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações, incluindo manual `claude update` e `claude install`. Mais rigoroso que `DISABLE_AUTOUPDATER`. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar |437| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações incluindo manual `claude update` e `claude install`. Mais rigoroso que `DISABLE_AUTOUPDATER`. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar |

348| `DO_NOT_TRACK` | Defina como `1` para optar por não participar da telemetria. Equivalente a definir `DISABLE_TELEMETRY`. Claude Code honra isso como a convenção padrão entre ferramentas reconhecida por muitos CLIs de desenvolvedor |439| `DO_NOT_TRACK` | Defina como `1` para optar por não participar de telemetria, com o mesmo efeito que `DISABLE_TELEMETRY`, incluindo tornar [Remote Control](/docs/pt/remote-control#requirements) e os outros [recursos que precisam de busca de sinalizador de recurso](#features-that-need-feature-flag-fetching) indisponíveis. Claude Code lê essa variável como um booleano padrão, para que `0` deixe telemetria ativa, e a honra como a convenção entre ferramentas reconhecida por muitos CLIs de desenvolvedor |

349| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para desabilitar [servidores MCP claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) no Claude Code. Habilitado por padrão para usuários conectados. Para desabilitar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/docs/pt/settings#available-settings) em configurações em vez disso |440| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, junto com `BETA_TRACING_ENDPOINT`, para ativar [rastreamento beta detalhado](/docs/pt/monitoring-usage#traces-beta), que adiciona atributos de span que carregam conteúdo e o span `claude_code.hook`. Sessões CLI interativas também requerem sua organização estar na lista de permissão para o beta. Ambas as variáveis são ignoradas em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

350| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um TTL de cache de prompt de 1 hora em vez do padrão de 5 minutos. Destinado para usuários de chave de API, [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Usuários de assinatura recebem TTL de 1 hora automaticamente. Escritas de cache de 1 hora são cobradas a uma taxa mais alta |441| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para parar Claude Code de buscar [servidores MCP claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai). Ativado por padrão para usuários conectados. Para desabilitar por projeto ou por org, defina [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) em configurações |

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

352| `ENABLE_TOOL_SEARCH` | Controla [busca de ferramentas MCP](/docs/pt/mcp#scale-with-mcp-tool-search). Não definido: todas as ferramentas MCP adiadas por padrão, mas carregadas antecipadamente em Google Cloud's Agent Platform ou quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte. Valores: `true` (sempre adia e envia o cabeçalho beta, solicitações falham em modelos Google Cloud's Agent Platform anteriores a Sonnet 4.5 ou Opus 4.5, ou em proxies que não suportam `tool_reference`), `auto` (modo de limite: carrega antecipadamente se as ferramentas se encaixarem em 10% do contexto), `auto:N` (limite personalizado, por exemplo, `auto:5` para 5%), `false` (carrega tudo antecipadamente). Ignorado quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` está definido, que força todas as ferramentas a carregar antecipadamente |443| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecated. Use `ENABLE_PROMPT_CACHING_1H` |

353| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Defina como qualquer valor não vazio para fazer todos os modelos, não apenas Opus, parar de tentar novamente com um erro de sobrecarga repetido quando nenhum modelo fallback está configurado. A partir de v2.1.160, uma [cadeia de modelo fallback](/docs/pt/model-config#fallback-model-chains) configurada aciona em erros de sobrecarga repetidos para qualquer modelo primário, então esta variável não afeta a alternância para um modelo fallback |444| `ENABLE_TOOL_SEARCH` | Controla [busca de ferramentas MCP](/docs/pt/mcp#scale-with-mcp-tool-search). Desconfigurado, Claude Code adia todas as ferramentas MCP por padrão. Ainda as carrega antecipadamente em modelos Google Cloud's Agent Platform anteriores à geração Claude 4.5, em uma implantação Microsoft Foundry hospedada no Azure, e quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte. `true` sempre adia e envia o cabeçalho beta, exceto nesses mesmos modelos Agent Platform e implantações Microsoft Foundry; solicitações falham em proxies que não suportam `tool_reference`. `auto` carrega antecipadamente quando definições de ferramenta cabem dentro de 10% do contexto. `auto:N` define um limite personalizado, como `auto:5` para 5%. `false` carrega todas as ferramentas antecipadamente. Um valor que você define é ignorado quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` está definido. Antes da v2.1.221, Claude Code desabilitava busca de ferramentas para todos os modelos em Google Cloud's Agent Platform a menos que você definisse essa variável como `true` |

354| `FORCE_AUTOUPDATE_PLUGINS` | Defina como `1` para forçar auto-atualizações de plugins mesmo quando o auto-atualizador principal está desabilitado via `DISABLE_AUTOUPDATER` |445| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Defina como qualquer valor não vazio, como `1`, para fazer Claude Code parar de tentar novamente em erros de sobrecarga repetidos para cada modelo quando nenhum modelo fallback está configurado. **Defini-lo como `0` ou `false` ainda ativa isso**, diferentemente da maioria das variáveis on/off; desconfigurar a variável para restaurar o comportamento de retry padrão. Sem isso, Claude Code para de tentar novamente dessa forma em modelos que reconhece como modelos Opus, Fable ou Mythos quando você autentica com uma chave de API ou um [provedor de terceiros](/docs/pt/third-party-integrations) em vez de uma assinatura Claude. No Claude Code v2.1.160 ou posterior, Claude Code muda para sua [cadeia de modelo fallback](/docs/pt/model-config#fallback-model-chains) configurada em erros de sobrecarga repetidos para qualquer modelo primário, para que essa variável não afete a mudança para um modelo fallback |

355| `FORCE_HYPERLINK` | Defina como `1` para habilitar hyperlinks OSC 8 clicáveis quando seu terminal suporta mas não é detectado automaticamente, ou `0` para desabilitá-los |446| `FORCE_AUTOUPDATE_PLUGINS` | Defina como `1` para forçar auto-atualizações de plugin mesmo quando o auto-atualizador principal está desabilitado via `DISABLE_AUTOUPDATER` |

356| `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 de outra forma. Substitui `ENABLE_PROMPT_CACHING_1H` |447| `FORCE_HYPERLINK` | Defina como `1` para ativar hyperlinks OSC 8 clicáveis quando seu terminal os suporta mas não é auto-detectado, ou `0` para desabilitá-los. Quando desconfigurado, Claude Code ativa hyperlinks apenas quando detecta suporte de terminal. Claude Code analisa esse valor como um número, não um Booleano, para que um valor como `false`, `no`, ou `off` ative hyperlinks em vez de desabilitá-los. O [badge de status PR ou merge request](/docs/pt/interactive-mode#pr-review-status) do rodapé renderiza como um hyperlink mesmo quando Claude Code não pode detectar suporte de terminal, como sobre SSH. Defina `0` para renderizar o badge como texto simples |

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

359| `IS_DEMO` | Defina como `1` para habilitar modo demo: oculta seu email e nome da organização do cabeçalho e saída `/status`, e pula onboarding. Útil ao fazer streaming ou gravar uma sessão |451| `IS_DEMO` | Defina como qualquer valor não vazio, como `1`, para ativar modo demo: oculta seu email e nome da organização do cabeçalho e saída `/status`, e pula onboarding. **Defini-lo como `0` ou `false` ainda ativa modo demo**, diferentemente da maioria das variáveis on/off; desconfigurar a variável para desativá-lo. Útil ao fazer stream ou gravar uma sessão |

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

361| `MAX_STRUCTURED_OUTPUT_RETRIES` | Número de vezes para tentar novamente quando a resposta do modelo falha na validação contra o [`--json-schema`](/docs/pt/cli-reference#cli-flags) em modo não interativo (a flag `-p`). Padrão é 5 |453| `MAX_STRUCTURED_OUTPUT_RETRIES` | Número de tentativas que Claude Code permite quando a resposta do modelo falha na validação contra o [`--json-schema`](/docs/pt/cli-reference#cli-flags) em modo não interativo com a flag `-p`; após esse muitas tentativas falhadas sem saída válida, a execução falha. O mesmo limite se aplica quando a saída estruturada de um subagente [fluxo de trabalho](/docs/pt/workflows) falha na validação. Padrão para 5, uma primeira tentativa mais quatro tentativas |

362| `MAX_THINKING_TOKENS` | Substitua o orçamento de token de [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). O teto é o [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) do modelo menos um. Defina como `0` para desabilitar pensamento na API Anthropic exceto em Fable 5, que não pode ter pensamento desligado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `0` igualmente omite o parâmetro, e modelos com [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) ainda podem pensar. Para valores diferentes de zero em modelos de raciocínio adaptativo, o orçamento é ignorado a menos que raciocínio adaptativo seja desabilitado via `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |454| `MAX_THINKING_TOKENS` | Orçamento de token fixo para [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code o limita a um token abaixo dos tokens de saída máxima da solicitação e nunca abaixo de 1.024. Veja `CLAUDE_CODE_MAX_OUTPUT_TOKENS` para como esse limite é definido. Quando desconfigurado e pensamento está ativado, modelos com [raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) escolhem sua própria profundidade de pensamento, e outros modelos usam o limite. Defina como `0` para desabilitar pensamento na API Anthropic, exceto em modelos Fable, que não podem ter pensamento desativado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `0` omite o parâmetro `thinking`. Com pensamento desativado na API Anthropic, Claude Code envia effort `high` em vez de um nível mais alto para modelos que sabe [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5. Claude Code ignora valores não zero em modelos de raciocínio adaptativo, exceto nos modelos onde `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desativa raciocínio adaptativo |

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

364| `MCP_CONNECTION_NONBLOCKING` | Controla se a inicialização aguarda servidores MCP se conectarem antes da primeira consulta. A partir do Claude Code v2.1.142, a inicialização MCP é não-bloqueante por padrão: servidores se conectam em segundo plano e suas ferramentas ficam disponíveis conforme terminam. Defina como `0` para restaurar a espera de conexão bloqueante de 5 segundos. Servidores configurados com [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral) ainda bloqueiam a inicialização independentemente, já que suas ferramentas devem estar presentes quando o primeiro prompt é construído |456| `MCP_CONNECTION_NONBLOCKING` | Controla se inicialização aguarda servidores MCP se conectarem antes da primeira consulta. Inicialização MCP é não bloqueante por padrão: servidores se conectam em segundo plano e suas ferramentas ficam disponíveis conforme terminam. Defina como `0` para fazer Claude Code aguardar servidores se conectarem antes da primeira consulta. Servidores configurados com [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral) ainda fazem inicialização aguardar independentemente, exceto quando servidos do [cache de descoberta](/docs/pt/mcp#server-status-detail), já que suas ferramentas devem estar presentes quando o primeiro prompt é construído. Em modo não interativo (`-p`), Claude Code também aguarda servidores ainda pendentes antes da primeira volta independentemente dessa variável, com um prazo mais longo quando você passa [`--mcp-config`](/docs/pt/cli-reference#cli-flags) explicitamente; veja a entrada dessa flag para a exceção de servidor em cache |

365| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo a inicialização bloqueante MCP aguarda, em milissegundos, para o lote de conexão antes de tirar um snapshot da lista de ferramentas (padrão: 5000). Aplica-se quando `MCP_CONNECTION_NONBLOCKING=0` ou para servidores marcados [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral). Servidores ainda pendentes no prazo continuam se conectando em segundo plano mas não aparecerão até a próxima consulta. Distinto de `MCP_TIMEOUT`, que limita a tentativa de conexão de um servidor individual |457| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo inicialização MCP bloqueante aguarda, em milissegundos, para o lote de conexão antes de tirar um snapshot da lista de ferramentas (padrão: 5000). Aplica-se quando `MCP_CONNECTION_NONBLOCKING=0` ou para servidores marcados [`alwaysLoad: true`](/docs/pt/mcp#exempt-a-server-from-deferral). Servidores ainda pendentes no prazo continuam se conectando em segundo plano. Distinto de `MCP_TIMEOUT`, que limita a tentativa de conexão de um servidor individual |

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

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

460| `MCP_DISCOVERY_CACHE_STRIKES` | Em um início onde uma entrada [cache de descoberta](/docs/pt/mcp#server-status-detail) é mais antiga que `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code a atualiza em segundo plano. Essa variável define quantas atualizações seguidas podem falhar antes de Claude Code descartar a entrada e conectar o servidor no próximo início (padrão: 1). Aumente se sua conexão de rede cai ocasionalmente, para que uma atualização falhada não descarte a entrada. Requer Claude Code v2.1.238 ou posterior |

461| `MCP_DISCOVERY_CACHE_TTL_S` | Segundos pelos quais Claude Code usa uma entrada [cache de descoberta](/docs/pt/mcp#server-status-detail) sem atualizá-la (padrão: 900). Em um início onde a entrada é mais antiga que isso, Claude Code ainda a usa mas a atualiza em segundo plano. Uma vez que a entrada é mais antiga que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code a descarta. Claude Code limita o valor a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, que é 4 horas por padrão. Antes da v2.1.238, Claude Code não limitava o valor |

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

367| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP remotos (HTTP/SSE) para conectar em paralelo durante a inicialização (padrão: 20) |463| `MCP_PROTOCOL_NEGOTIATION` | No [runtime de cliente MCP v2](/docs/pt/mcp#mcp-client-runtimes) apenas, se Claude Code sonda servidores para revisão de protocolo MCP 2026-07-28. Defina `auto` para sondar servidores HTTP, conector claude.ai e stdio; um servidor que não responde à sonda se conecta no protocolo anterior, como servidores SSE e WebSocket sempre fazem. Defina `legacy` para pular a sonda para cada servidor. Sem a variável, Claude Code sonda servidores HTTP e conector claude.ai no Claude Code v2.1.232 ou posterior, com as exceções que a seção [runtimes de cliente MCP](/docs/pt/mcp#mcp-client-runtimes) lista. Qualquer outro valor é ignorado com um aviso no log de depuração. Requer Claude Code v2.1.221 ou posterior |

368| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP locais (stdio) para conectar em paralelo durante a inicialização (padrão: 3) |464| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP remotos (HTTP/SSE) para conectar em paralelo durante inicialização (padrão: 20) |

369| `MCP_TIMEOUT` | Tempo limite em milissegundos para inicialização do servidor MCP (padrão: 30000, ou 30 segundos) |465| `MCP_SDK_GENERATION` | Fixe qual [runtime de cliente MCP](/docs/pt/mcp#mcp-client-runtimes) este processo se conecta a servidores MCP com: `v1`, construído em MCP TypeScript SDK 1.x, ou `v2`, construído em [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sem a variável, Claude Code usa v2 no Claude Code v2.1.232 ou posterior, exceto onde essa seção diz que usa v1. No Claude Code v2.1.221 ou posterior, o runtime v2 verifica o emissor que um servidor MCP OAuth retorna em sua resposta de autorização e falha o sign-in com um erro que começa `Issuer mismatch in authorization response` quando não corresponde. O runtime v1 não executa essa verificação. Se você definir um valor não reconhecido, Claude Code o ignora e escreve um aviso no log de depuração. Claude Code lê o valor uma vez por processo. Requer Claude Code v2.1.218 ou posterior |

370| `MCP_TOOL_TIMEOUT` | Tempo limite em milissegundos para execução de ferramentas MCP (padrão: 100000000, aproximadamente 28 horas). Para um servidor HTTP, SSE ou conector claude.ai, cada solicitação também expira após 60 segundos por padrão; defina essa variável ou o `timeout` por servidor acima de 60000 para aumentar esse limite por solicitação. Um valor mais baixo ainda encurta o tempo limite geral de execução de ferramenta mas deixa o limite por solicitação em 60 segundos. Servidores Stdio e WebSocket não têm temporizador por solicitação. Um campo `timeout` por servidor em `.mcp.json` substitui isso para esse servidor. Um `timeout` por servidor de pelo menos 1000 também define a janela de inatividade mínima para as chamadas de ferramenta desse servidor, então `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborta mais cedo; este piso requer Claude Code v2.1.203 ou posterior. Para a variável env, valores abaixo de 1000 são fixados em um segundo; para o campo por servidor, valores abaixo de 1000 são ignorados |466| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP locais (stdio) para conectar em paralelo durante inicialização (padrão: 3) |

372| `OTEL_LOG_ASSISTANT_RESPONSES` | Defina como `1` para incluir o texto de resposta do modelo em eventos de log OpenTelemetry `assistant_response`. Quando não definido, o valor de `OTEL_LOG_USER_PROMPTS` é usado em vez disso. Defina como `0` para manter respostas redatadas mesmo quando `OTEL_LOG_USER_PROMPTS` está definido. Requer Claude Code v2.1.193 ou posterior. Veja [Monitoramento](/docs/pt/monitoring-usage#assistant-response-event) |468| `MCP_TOOL_TIMEOUT` | Timeout em milissegundos para execução de ferramenta MCP (padrão: 100000000, aproximadamente 28 horas). Para um servidor HTTP, SSE ou conector claude.ai, cada solicitação também expira após 60 segundos por padrão; defina essa variável, ou o `timeout` por servidor, acima de 60000 para aumentar esse limite por solicitação. Um valor mais baixo ainda encurta o timeout de execução de ferramenta geral mas deixa o timer por solicitação em 60 segundos. Servidores stdio e WebSocket não têm timer por solicitação. Um campo `timeout` por servidor em `.mcp.json` substitui isso para esse servidor. Um `timeout` por servidor de pelo menos 1000 também define a janela de inatividade mínima para chamadas de ferramenta desse servidor, para que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborte mais cedo; este piso requer Claude Code v2.1.203 ou posterior. Para a variável env, valores abaixo de 1000 são limitados a um segundo; para o campo por servidor, valores abaixo de 1000 são ignorados |

373| `OTEL_LOG_RAW_API_BODIES` | Emita solicitação e resposta JSON da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados em 60 KB, ou `file:<dir>` para escrever corpos não truncados em disco e emitir um caminho `body_ref` em vez disso. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Veja [Monitoramento](/docs/pt/monitoring-usage#api-request-body-event) |469| `NO_PROXY` | Lista de domínios e IPs para os quais solicitações serão emitidas diretamente, contornando proxy |

470| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite padrão do SDK OpenTelemetry em comprimento de valor de atributo. Claude Code limita atributos de telemetria que carregam conteúdo ao menor entre isso e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, para que o marcador de truncamento fique dentro do limite do SDK. 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. Veja [Monitoramento](/docs/pt/monitoring-usage#common-configuration-variables) |

471| `OTEL_LOG_ASSISTANT_RESPONSES` | Defina como `1` para incluir o texto de resposta do modelo em eventos de log OpenTelemetry `assistant_response`. Quando desconfigurado, o valor de `OTEL_LOG_USER_PROMPTS` é usado. Defina como `0` para manter respostas redatadas mesmo quando `OTEL_LOG_USER_PROMPTS` está definido. Requer Claude Code v2.1.193 ou posterior. Veja [Monitoramento](/docs/pt/monitoring-usage#assistant-response-event) |

472| `OTEL_LOG_RAW_API_BODIES` | Emita JSON de solicitação e resposta da API Anthropic Messages 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 escrever corpos não truncados em disco e emitir um caminho `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de conteúdo, 60 KB por padrão. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Veja [Evento de corpo de solicitação de API](/docs/pt/monitoring-usage#api-request-body-event) |

374| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir conteúdo de entrada e saída de ferramenta em eventos de span OpenTelemetry. Desabilitado por padrão para proteger dados sensíveis. Veja [Monitoramento](/docs/pt/monitoring-usage) |473| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir conteúdo de entrada e saída de ferramenta em eventos de span OpenTelemetry. Desabilitado por padrão para proteger dados sensíveis. Veja [Monitoramento](/docs/pt/monitoring-usage) |

375| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, nomes de workflow definidos pelo usuário, strings de erro bruto em falhas de ferramenta, a categoria de recusa em eventos `api_refusal` e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja [Monitoramento](/docs/pt/monitoring-usage) |474| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, nomes de fluxo de trabalho criados pelo usuário, strings de erro bruto em falhas de ferramenta, a `category` de recusa em eventos `api_refusal`, e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja [Monitoramento](/docs/pt/monitoring-usage) |

376| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir texto de prompt do usuário em rastreamentos e logs OpenTelemetry. Desabilitado por padrão (prompts são redatados). Veja [Monitoramento](/docs/pt/monitoring-usage) |475| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir texto de prompt do usuário em rastreamentos e logs OpenTelemetry. Desabilitado por padrão (prompts são redatados). Veja [Monitoramento](/docs/pt/monitoring-usage) |

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

378| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Defina como `true` para incluir o ponto de entrada da sessão em atributos de métricas (padrão: excluído). Adicionado em v2.1.152. Veja [Monitoramento](/docs/pt/monitoring-usage) |477| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Defina como `true` para incluir o ponto de entrada da sessão em atributos de métricas (padrão: excluído). Adicionado na v2.1.152. Veja [Monitoramento](/docs/pt/monitoring-usage) |

379| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partir de v2.1.161, Claude Code anexa chaves `OTEL_RESOURCE_ATTRIBUTES` aos rótulos de ponto de dados de métrica. Defina como `false` para excluí-las (padrão: incluído). Veja [Monitoramento](/docs/pt/monitoring-usage#multi-team-organization-support) |478| `OTEL_METRICS_INCLUDE_REPOSITORY` | Defina como `true` para marcar métricas e eventos OpenTelemetry com atributos `vcs.*` identificando o repositório da sessão (padrão: excluído). Requer Claude Code v2.1.269 ou posterior. Veja [Atributos de repositório](/docs/pt/monitoring-usage#repository-attributes) |

380| `OTEL_METRICS_INCLUDE_SESSION_ID` | Defina como `false` para excluir ID de sessão dos atributos de métricas (padrão: incluído). Veja [Monitoramento](/docs/pt/monitoring-usage) |479| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partir da v2.1.161, Claude Code anexa chaves `OTEL_RESOURCE_ATTRIBUTES` a rótulos de ponto de dados de métrica. Defina como `false` para excluí-las (padrão: incluído). Veja [Monitoramento](/docs/pt/monitoring-usage#multi-team-organization-support) |

381| `OTEL_METRICS_INCLUDE_VERSION` | Defina como `true` para incluir versão do Claude Code em atributos de métricas (padrão: excluído). Veja [Monitoramento](/docs/pt/monitoring-usage) |480| `OTEL_METRICS_INCLUDE_SESSION_ID` | Defina como `false` para excluir ID de sessão de atributos de métricas (padrão: incluído). Veja [Monitoramento](/docs/pt/monitoring-usage) |

382| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Substitua o orçamento de caracteres para metadados de skill mostrados à [ferramenta Skill](/docs/pt/skills#control-who-invokes-a-skill). O orçamento escala dinamicamente em 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores |481| `OTEL_METRICS_INCLUDE_VERSION` | Defina como `true` para incluir versão Claude Code em atributos de métricas (padrão: excluído). Veja [Monitoramento](/docs/pt/monitoring-usage) |

383| `TASK_MAX_OUTPUT_LENGTH` | Número máximo de caracteres na saída de [subagente](/docs/pt/sub-agents) antes de truncamento (padrão: 32000, máximo: 160000). Quando truncado, a saída completa é salva em disco e o caminho é incluído na resposta truncada |482| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Substitua o orçamento de caracteres para metadados de skill mostrados à [ferramenta Skill](/docs/pt/skills#control-who-invokes-a-skill). O orçamento escala dinamicamente em 1% da janela de contexto, com fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores |

483| `TASK_MAX_OUTPUT_LENGTH` | Número máximo de caracteres de saída de uma [tarefa em segundo plano](/docs/pt/tools-reference#background-commands) que a ferramenta `TaskOutput` mantém (padrão: 32000; máximo: 160000). Se você definir a configuração [`taskOutputMaxChars`](/docs/pt/settings-reference#taskoutputmaxchars), Claude Code ignora essa variável |

395| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Substitua região para Claude Opus 4.7 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.111 |495| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Substitua região para Claude Opus 4.7 ao usar Google Cloud's Agent Platform |

396| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Substitua região para Claude Opus 4.8 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.154 |496| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Substitua região para Claude Opus 4.8 ao usar Google Cloud's Agent Platform |

397| `VERTEX_REGION_CLAUDE_5_SONNET` | Substitua região para Claude Sonnet 5 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.197 |497| `VERTEX_REGION_CLAUDE_5_OPUS` | Substitua região para Claude Opus 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.219 |

398| `VERTEX_REGION_CLAUDE_FABLE_5` | Substitua região para Claude Fable 5 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.170 |498| `VERTEX_REGION_CLAUDE_5_SONNET` | Substitua região para Claude Sonnet 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.197 |

499| `VERTEX_REGION_CLAUDE_FABLE_5` | Substitua região para Claude Fable 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.170 |

500| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Substitua região para Claude Fable 5.1 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.257 |

400 502

401Variáveis padrão do exportador 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. Veja [Monitoramento](/docs/pt/monitoring-usage) para detalhes de configuração.503Variáveis de exportador OpenTelemetry padrão (`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. Veja [Monitoramento](/docs/pt/monitoring-usage) para detalhes de configuração.

504

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

506 Recursos que precisam de busca de feature-flag

507</h2>

508

509Claude Code ativa alguns recursos através de feature flags que busca da Anthropic. Claude Code pula essa busca nestas sessões:

510

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

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

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

514

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

516

517* [Iniciar sessões em modo automático por padrão](/docs/pt/permission-modes#which-mode-a-session-starts-in) em planos Pro, Max e Team

518* Ter a extensão VS Code [ler arquivos de configuração para o modo de permissão inicial](/docs/pt/permission-modes#switch-permission-modes)

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

520* Usar [Controle Remoto](/docs/pt/remote-control#requirements)

521* [Enviar mensagens de sessões além desta máquina](/docs/pt/cross-session-messaging#message-sessions-on-other-machines); mensagens entre sessões nesta máquina funcionam com a busca desativada

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

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

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

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

526* Obter o [runtime do cliente MCP v2](/docs/pt/mcp#mcp-client-runtimes) e sua sonda de protocolo sem definir `MCP_SDK_GENERATION` e `MCP_PROTOCOL_NEGOTIATION`; Claude Code usa o runtime v1 a menos que você defina `MCP_SDK_GENERATION=v2`, e pula a sonda a menos que você defina `MCP_PROTOCOL_NEGOTIATION=auto`

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

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

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

530

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

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

533</h3>

534

535Na sua primeira sessão após instalar Claude Code, ou atualizar para uma versão que adiciona um recurso, um [recurso com gate de flag](#features-that-need-feature-flag-fetching) pode estar faltando, e a sessão pode iniciar em modo Manual em um plano que de outra forma iniciaria em modo automático. Claude Code busca as flags durante essa sessão, então ambas estão lá na sua próxima sessão.

536

537Após uma instalação limpa, em uma sessão não interativa como `claude -p`, o Agent SDK, ou a extensão VS Code, Claude Code ainda pode pegar as flags antes de [escolher o modo de permissão inicial](/docs/pt/permission-modes#which-mode-a-session-starts-in).

402 538

403<h2 id="see-also">539<h2 id="see-also">

404 Veja também540 Veja também

fast-mode.md +1 −1

Details

123O modo rápido requer todos os seguintes:123O modo rápido requer todos os seguintes:

124 124

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

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

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

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

129 129

github-enterprise-server.md +1 −1

Details

116claude --cloud "Add retry logic to the payment webhook handler"116claude --cloud "Add retry logic to the payment webhook handler"

117```117```

118 118

119A sessão clona seu repositório do GHES e envia alterações de volta para um branch. Monitore o progresso com `/tasks` ou em [claude.ai/code](https://claude.ai/code). Consulte [Claude Code na web](/docs/pt/claude-code-on-the-web) para o fluxo de trabalho completo de sessão web, incluindo revisão de diff, auto-fix e rotinas.119A sessão clona seu repositório do GHES e envia alterações de volta para um branch. Monitore o progresso em [claude.ai/code](https://claude.ai/code). Consulte [Claude Code na web](/docs/pt/claude-code-on-the-web) para o fluxo de trabalho completo de sessão web, incluindo revisão de diff, auto-fix e rotinas.

120 120

121<h3 id="teleport-sessions-to-your-terminal">121<h3 id="teleport-sessions-to-your-terminal">

122 Teleporte de sessões para seu terminal122 Teleporte de sessões para seu terminal

goal.md +23 −6

Details

22Três abordagens mantêm a sessão atual em execução entre prompts. Escolha com base no que deve iniciar o próximo turno:22Três abordagens mantêm a sessão atual em execução entre prompts. Escolha com base no que deve iniciar o próximo turno:

23 23

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

26| `/goal` | O turno anterior termina, ou uma [verificação de inatividade](#background-work-defers-evaluation) vence enquanto o trabalho em segundo plano mantém o objetivo aguardando, até três vezes por objetivo entre seus prompts | Um modelo confirma que a condição é atendida ou julga impossível, ou um turno falha em [um erro que você tem que corrigir](#errors-you-have-to-fix-clear-the-goal), ou você executa [`/goal clear`](#clear-a-goal) |26| `/goal` | O turno anterior termina, ou, em uma sessão interativa, uma [verificação de inatividade](#background-work-defers-evaluation) ou uma [tentativa automática](#other-errors-retry-or-pause-the-goal) vence | Um modelo confirma que a condição é atendida ou julga impossível, ou um turno falha em [um erro que você tem que corrigir](#errors-you-have-to-fix-clear-the-goal), ou você executa [`/goal clear`](#clear-a-goal) |

27| [`/loop`](/docs/pt/scheduled-tasks#run-a-prompt-repeatedly-with-%2Floop) | Um intervalo de tempo decorre | Você o interrompe, ou Claude decide que o trabalho está concluído |27| [`/loop`](/docs/pt/scheduled-tasks#run-a-prompt-repeatedly-with-%2Floop) | Um intervalo de tempo decorre | Você o interrompe, ou Claude decide que o trabalho está concluído |

29 29

143 143

144Se Claude continuar respondendo ao avaliador sem fazer progresso (nenhum uso de ferramenta por vários turnos seguidos), Claude Code para o loop, imprime um aviso e retorna o controle para você com o objetivo ainda definido. A avaliação retoma após seu próximo prompt. O [guia de hooks](/docs/pt/hooks-guide#stop-hook-hits-the-block-cap) explica o mecanismo subjacente.144Se Claude continuar respondendo ao avaliador sem fazer progresso (nenhum uso de ferramenta por vários turnos seguidos), Claude Code para o loop, imprime um aviso e retorna o controle para você com o objetivo ainda definido. A avaliação retoma após seu próximo prompt. O [guia de hooks](/docs/pt/hooks-guide#stop-hook-hits-the-block-cap) explica o mecanismo subjacente.

145 145

146<h3 id="errors-you-have-to-fix-clear-the-goal">146<h3 id="when-a-turn-fails">

147 Erros que você precisa corrigir limpam o objetivo147 Quando um turno falha

148</h3>148</h3>

149 149

150Quando um turno falha, Claude Code limpa o objetivo se o erro for um que você precisa corrigir. Após qualquer outro erro, o objetivo permanece definido.

151

152<h4 id="errors-you-have-to-fix-clear-the-goal">

153 Erros que você precisa corrigir limpam o objetivo

154</h4>

155

150Se um turno falhar em um erro que não será limpo até você corrigi-lo, Claude Code limpa o objetivo e imprime um aviso nomeando a causa. O aviso começa com `Goal cleared after an unrecoverable error` e termina com `Run /goal again to continue`. Corrija a causa, então [defina o objetivo novamente](#set-a-goal) com `/goal <condition>`. Quatro tipos de falha limpam o objetivo:156Se um turno falhar em um erro que não será limpo até você corrigi-lo, Claude Code limpa o objetivo e imprime um aviso nomeando a causa. O aviso começa com `Goal cleared after an unrecoverable error` e termina com `Run /goal again to continue`. Corrija a causa, então [defina o objetivo novamente](#set-a-goal) com `/goal <condition>`. Quatro tipos de falha limpam o objetivo:

151 157

152* Uma falha de autenticação, quando Claude Code gerencia suas próprias credenciais. Quando um host as gerencia para você, como o aplicativo desktop, a extensão VS Code ou uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), Claude Code deixa o objetivo ativo porque o host restaura o acesso por conta própria.158* Uma falha de autenticação, quando Claude Code gerencia suas próprias credenciais. Quando um host as gerencia para você, como o aplicativo desktop, a extensão VS Code ou uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), Claude Code deixa o objetivo ativo porque o host restaura o acesso por conta própria.

154* Um overflow de contexto que [auto-compactação](/docs/pt/model-config#set-the-auto-compact-window) não conseguiu limpar160* Um overflow de contexto que [auto-compactação](/docs/pt/model-config#set-the-auto-compact-window) não conseguiu limpar

155* Um modelo que não está disponível161* Um modelo que não está disponível

156 162

157Após qualquer outra falha, incluindo erros transitórios como limites de taxa e servidores sobrecarregados, Claude Code deixa o objetivo ativo.163<h4 id="other-errors-retry-or-pause-the-goal">

164 Outros erros tentam novamente ou pausam o objetivo

165</h4>

166

167Após qualquer outra falha, o objetivo permanece definido. Em uma sessão interativa no Claude Code v2.1.269 ou posterior, Claude Code também imprime uma linha nomeando a causa e tenta novamente por conta própria ou aguarda você:

168

169* **Tentar novamente**: após uma falha que tende a se resolver por conta própria, como um servidor sobrecarregado ou uma conexão perdida, um aviso começando com `Goal still active` mostra a espera antes da próxima tentativa. Após três tentativas automáticas, o objetivo pausa em vez disso.

170* **Pausar**: após uma falha que uma tentativa apenas repetiria, como um limite de taxa de API, um [limite de uso](/docs/pt/errors#youve-hit-your-session-limit) do claude.ai ou um hook que encerrou o turno, um aviso começando com `Goal paused` nomeia a causa. Se a sessão está [aguardando para continuar automaticamente quando um limite de uso é redefinido](/docs/pt/interactive-mode#wait-for-a-usage-limit-to-reset), Claude retoma o trabalho em direção ao objetivo então.

171

172Envie uma mensagem a qualquer momento para iniciar o próximo turno imediatamente. Para desativar tentativas automáticas, defina [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/pt/env-vars) como `0`, o que também desativa [verificações](#background-work-defers-evaluation).

158 173

159<h3 id="background-work-defers-evaluation">174<h3 id="background-work-defers-evaluation">

160 Trabalho em segundo plano adia a avaliação175 Trabalho em segundo plano adia a avaliação

169 184

170Antes da v2.1.239, apenas as verificações ociosas recuavam dessa forma; uma verificação entregue no final de um turno recorria no primeiro intervalo.185Antes da v2.1.239, apenas as verificações ociosas recuavam dessa forma; uma verificação entregue no final de um turno recorria no primeiro intervalo.

171 186

172Para alterar o primeiro intervalo, defina [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/pt/env-vars). Claude Code usa seu valor no lugar do intervalo de 30 minutos e dimensiona os intervalos posteriores com ele. Defina como `0` para desativar as verificações. As verificações requerem Claude Code v2.1.234 ou posterior.187Para alterar o primeiro intervalo, defina [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/pt/env-vars). Claude Code usa seu valor no lugar do intervalo de 30 minutos e dimensiona os intervalos posteriores com ele. Defina como `0` para desativar as verificações e [tentativas automáticas](#other-errors-retry-or-pause-the-goal).

188

189As verificações requerem Claude Code v2.1.234 ou posterior.

173 190

174<h3 id="evaluation-model-and-cost">191<h3 id="evaluation-model-and-cost">

175 Modelo de avaliação e custo192 Modelo de avaliação e custo

how-claude-code-works.md +1 −1

Details

211 211

212Comandos integrados também o guiam através da configuração:212Comandos integrados também o guiam através da configuração:

213 213

214* `/init` o guia através da criação de um CLAUDE.md para seu projeto214* `/init` gera um CLAUDE.md inicial para seu projeto

215* `/doctor` executa uma verificação de configuração que diagnostica problemas de instalação e configuração e pode corrigi-los215* `/doctor` executa uma verificação de configuração que diagnostica problemas de instalação e configuração e pode corrigi-los

216 216

217<h3 id="it’s-a-conversation">217<h3 id="it’s-a-conversation">

jetbrains.md +3 −3

Details

106</h4>106</h4>

107 107

108* **Claude command**: Especifique um comando personalizado para executar Claude, por exemplo `claude`, `/usr/local/bin/claude`, ou `npx @anthropic-ai/claude-code`108* **Claude command**: Especifique um comando personalizado para executar Claude, por exemplo `claude`, `/usr/local/bin/claude`, ou `npx @anthropic-ai/claude-code`

109* **Suppress notification for Claude command not found**: Pule notificações sobre não encontrar o comando Claude109* **Suppress notification for when Claude Command is not found**: Pule notificações sobre não encontrar o comando Claude

110* **Enable using Option+Enter for multi-line prompts**: apenas no macOS. Quando ativado, Option+Enter insere novas linhas em prompts do Claude Code. Desative se a tecla Option estiver sendo capturada inesperadamente. Requer reinicialização do terminal.110* **Enable using Option+Enter for multi-line prompts**: apenas no macOS. Quando ativado, Option+Enter insere novas linhas em prompts do Claude Code. Desative se a tecla Option estiver sendo capturada inesperadamente. Requer reinicialização do terminal.

111* **Enable automatic updates**: Verifique e instale automaticamente atualizações do plugin, aplicadas na reinicialização111* **Enable automatic updates**: Verifique e instale automaticamente atualizações do plugin, aplicadas na reinicialização

112 112

256**Ferramentas expostas ao modelo.** O servidor hospeda várias ferramentas, mas apenas uma é visível ao modelo. O resto é RPC interno que a CLI usa para sua própria UI, como abrir diffs e ler seleções, e são filtrados antes da lista de ferramentas chegar ao Claude.256**Ferramentas expostas ao modelo.** O servidor hospeda várias ferramentas, mas apenas uma é visível ao modelo. O resto é RPC interno que a CLI usa para sua própria UI, como abrir diffs e ler seleções, e são filtrados antes da lista de ferramentas chegar ao Claude.

257 257

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

260| `mcp__ide__getDiagnostics` | Retorna os diagnósticos de inspeção do IDE, os erros e avisos mostrados no editor. Opcionalmente limitado a um arquivo. | Sim |260| `mcp__ide__getDiagnostics` | Retorna os diagnósticos de inspeção do IDE, os erros e avisos mostrados no editor. Cada chamada cobre um arquivo: o arquivo que Claude especifica, ou o arquivo no seu editor ativo se Claude não especificar um. | Sim |

261 261

262O plugin JetBrains não expõe uma ferramenta de execução de código ao modelo.262O plugin JetBrains não expõe uma ferramenta de execução de código ao modelo.

263 263

large-codebases.md +2 −2

Details

385 Mantenha skills descobríveis385 Mantenha skills descobríveis

386</h3>386</h3>

387 387

388Com skills espalhadas por muitos diretórios, a lista da qual Claude escolhe pode crescer grande. Claude escolhe uma skill lendo o nome e descrição de cada skill descoberta, e apenas o conteúdo completo da skill escolhida carrega no contexto. Esta seção cobre como manter essa lista pequena e escrever descrições que sobrevivem ao encurtamento.388Com skills espalhadas por muitos diretórios, a lista da qual Claude escolhe pode crescer grande. Claude escolhe uma skill lendo o nome e descrição de cada skill descoberta, e apenas o conteúdo completo da skill escolhida carrega no contexto. Esta seção cobre como manter essa lista pequena.

389 389

390Quais skills estão em escopo depende de onde você inicia Claude:390Quais skills estão em escopo depende de onde você inicia Claude:

391 391

393* **Da raiz do repositório**: skills de raiz, mais skills de cada subdiretório que Claude toca durante a sessão, que pode acumular em centenas393* **Da raiz do repositório**: skills de raiz, mais skills de cada subdiretório que Claude toca durante a sessão, que pode acumular em centenas

394* **Depois de adicionar um irmão com [`--add-dir`](#grant-access-across-packages-or-repositories)**: as skills desse irmão também carregam. A configuração `additionalDirectories` concede apenas acesso a arquivo e não carrega skills394* **Depois de adicionar um irmão com [`--add-dir`](#grant-access-across-packages-or-repositories)**: as skills desse irmão também carregam. A configuração `additionalDirectories` concede apenas acesso a arquivo e não carrega skills

395 395

396Os nomes sempre carregam, mas [descrições são encurtadas quando há muitas](/docs/pt/skills#skill-descriptions-are-cut-short), que pode remover as palavras-chave que Claude usa para decidir se uma skill se aplica. Mantenha descrições curtas e comece com palavras que uma solicitação conteria, como "escrevendo ou modificando testes em `packages/api/`".396Os nomes sempre carregam, mas [quando há muitas, algumas skills perdem suas descrições inteiramente](/docs/pt/skills#skill-descriptions-are-cut-short), que pode remover as palavras-chave que Claude usa para decidir se uma skill se aplica. Mantenha descrições curtas e comece com palavras que uma solicitação conteria, como "escrevendo ou modificando testes em `packages/api/`".

397 397

398Para skills que muitos diretórios compartilham, como convenções de PR ou uma checklist de deploy, coloque-as no `.claude/skills/` da raiz do repositório para que carreguem de qualquer diretório inicial. Quando skills compartilhadas precisam de seu próprio histórico de versão ou devem funcionar entre repositórios, empacote-as como um [plugin](/docs/pt/plugins) em vez disso. As skills de plugin usam um namespace `plugin-name:skill-name`, então nunca colidem com skills por diretório. Uma equipe de plataforma pode versioná-las e atualizá-las em um lugar.398Para skills que muitos diretórios compartilham, como convenções de PR ou uma checklist de deploy, coloque-as no `.claude/skills/` da raiz do repositório para que carreguem de qualquer diretório inicial. Quando skills compartilhadas precisam de seu próprio histórico de versão ou devem funcionar entre repositórios, empacote-as como um [plugin](/docs/pt/plugins) em vez disso. As skills de plugin usam um namespace `plugin-name:skill-name`, então nunca colidem com skills por diretório. Uma equipe de plataforma pode versioná-las e atualizá-las em um lugar.

399 399

managed-settings.md +3 −1

Details

143 143

144Quando sua organização entrega mais de uma fonte gerenciada para a mesma máquina, a chave [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) decide o que Claude Code faz com as outras:144Quando sua organização entrega mais de uma fonte gerenciada para a mesma máquina, a chave [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) decide o que Claude Code faz com as outras:

145 145

146* **`"first-wins"`, o padrão**: Claude Code usa a fonte de classificação mais alta que entrega pelo menos uma chave de política e ignora o resto em vez de mesclá-las, exceto pelas poucas chaves em [Chaves lidas de cada fonte de administrador](#keys-read-from-every-admin-source). Claude Code não mostra aviso para as fontes que pula; `/status` [nomeia a fonte que usou e as que pulou](#read-the-source-in-/status).146* **`"first-wins"`, o padrão**: Claude Code usa a fonte de classificação mais alta que entrega pelo menos uma chave de política e ignora o resto em vez de mesclá-las, exceto pelas chaves em [Chaves lidas de cada fonte de administrador](#keys-read-from-every-admin-source). Claude Code não mostra aviso para as fontes que pula; `/status` [nomeia a fonte que usou e as que pulou](#read-the-source-in-/status).

147* **`"merge"`**: Claude Code aplica cada fonte de administrador que entrega uma chave de política e as combina por tipo de chave: na maioria das chaves o valor da fonte de classificação mais alta se aplica, listas se unem e locks assumem o valor mais restritivo. [Compor cada fonte gerenciada](#compose-every-managed-source) diz onde definir a chave e como cada tipo de chave se combina. Requer Claude Code v2.1.242 ou posterior.147* **`"merge"`**: Claude Code aplica cada fonte de administrador que entrega uma chave de política e as combina por tipo de chave: na maioria das chaves o valor da fonte de classificação mais alta se aplica, listas se unem e locks assumem o valor mais restritivo. [Compor cada fonte gerenciada](#compose-every-managed-source) diz onde definir a chave e como cada tipo de chave se combina. Requer Claude Code v2.1.242 ou posterior.

148 148

149Ambas as configurações classificam as fontes da mesma forma. Dois termos recorrem nesta seção:149Ambas as configurações classificam as fontes da mesma forma. Dois termos recorrem nesta seção:

186* [`forceRemoteSettingsRefresh`](/docs/pt/server-managed-settings)186* [`forceRemoteSettingsRefresh`](/docs/pt/server-managed-settings)

187* `env`, mesclado por variável em fontes de administrador: cada variável vem da fonte de prioridade mais alta que a define, portanto fontes inferiores preenchem variáveis que as superiores deixam indefinidas. Algumas variáveis seguem suas próprias regras; [Exceções por chave em fontes gerenciadas](/docs/pt/server-managed-settings#per-key-exceptions-across-managed-sources) nomeia cada uma. Requer Claude Code v2.1.223 ou posterior. Antes de v2.1.223, Claude Code aplicava apenas o bloco `env` inteiro da fonte selecionada187* `env`, mesclado por variável em fontes de administrador: cada variável vem da fonte de prioridade mais alta que a define, portanto fontes inferiores preenchem variáveis que as superiores deixam indefinidas. Algumas variáveis seguem suas próprias regras; [Exceções por chave em fontes gerenciadas](/docs/pt/server-managed-settings#per-key-exceptions-across-managed-sources) nomeia cada uma. Requer Claude Code v2.1.223 ou posterior. Antes de v2.1.223, Claude Code aplicava apenas o bloco `env` inteiro da fonte selecionada

188 188

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

190

189<h3 id="compose-every-managed-source">191<h3 id="compose-every-managed-source">

190 Compor cada fonte gerenciada192 Compor cada fonte gerenciada

191</h3>193</h3>

monitoring-usage.md +59 −31

Details

150As seguintes variáveis de ambiente controlam quais atributos são incluídos nas métricas para gerenciar a cardinalidade:150As seguintes variáveis de ambiente controlam quais atributos são incluídos nas métricas para gerenciar a cardinalidade:

151 151

153| ------------------------------------------ | ----------------------------------------------------------------------------------------- | ------------ | ---------------------- |153| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ---------------------- |

159| `OTEL_METRICS_INCLUDE_REPOSITORY` | Incluir atributos de identidade de repositório `vcs.*` [repository attributes](#repository-attributes) em métricas e eventos. Requer Claude Code v2.1.269 ou posterior | `false` | `true` |

159 160

160Cardinalidade mais baixa geralmente significa melhor desempenho e custos de armazenamento mais baixos, mas dados menos granulares para análise.161Cardinalidade mais baixa geralmente significa melhor desempenho e custos de armazenamento mais baixos, mas dados menos granulares para análise.

161 162

222| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------- |223| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------- |

225| `interaction.sequence` | Contador baseado em 1 de interações nesta sessão | |226| `interaction.sequence` | Contador baseado em 1 de interações, contado por processo Claude Code em vez de por sessão, conforme descrito para [`event.sequence`](#event-correlation-attributes) | |

226| `parent.source` | Como o span obteve seu pai de rastreamento: `env` quando foi pai sob um `TRACEPARENT` de entrada, `none` quando iniciou seu próprio rastreamento. Requer Claude Code v2.1.268 ou posterior | |227| `parent.source` | Como o span obteve seu pai de rastreamento: `env` quando foi pai sob um `TRACEPARENT` de entrada, `none` quando iniciou seu próprio rastreamento. Requer Claude Code v2.1.268 ou posterior | |

228 229

390* Crie dashboards específicos de equipe391* Crie dashboards específicos de equipe

391* Configure alertas para equipes específicas392* Configure alertas para equipes específicas

392 393

393Claude Code anexa esses valores como atributos em cada ponto de dados de métrica e registro de evento, além de enviá-los no bloco de recurso OTLP. Como a maioria dos backends de métricas expõe atributos de ponto de dados como rótulos consultáveis, você pode agrupar e filtrar métricas por suas chaves personalizadas diretamente. Chaves personalizadas nunca substituem os [atributos padrão](#standard-attributes) como `user.id` ou `session.id`: quando uma chave colide, Claude Code mantém o valor integrado.394Claude Code anexa esses valores como atributos em cada ponto de dados de métrica e registro de evento, além de enviá-los no bloco de recurso OTLP. Como a maioria dos backends de métricas expõe atributos de ponto de dados como rótulos consultáveis, você pode agrupar e filtrar métricas por suas chaves personalizadas diretamente. Exceto pelos atributos de repositório `vcs.*` [repository attributes](#repository-attributes), chaves personalizadas nunca substituem os [atributos padrão](#standard-attributes) como `user.id` ou `session.id`: quando uma chave colide, Claude Code mantém o valor integrado.

394 395

395Cada chave personalizada se torna um rótulo em cada série de métrica, então valores de alta cardinalidade aumentam o custo de armazenamento no seu backend de métricas. Para enviar atributos personalizados apenas no bloco de recurso e omiti-los dos rótulos de ponto de dados, defina `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Veja [Controle de cardinalidade de métricas](#metrics-cardinality-control).396Cada chave personalizada se torna um rótulo em cada série de métrica, então valores de alta cardinalidade aumentam o custo de armazenamento no seu backend de métricas. Para enviar atributos personalizados apenas no bloco de recurso e omiti-los dos rótulos de ponto de dados, defina `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. Veja [Controle de cardinalidade de métricas](#metrics-cardinality-control).

396 397

499Todas as métricas e eventos compartilham esses atributos padrão:500Todas as métricas e eventos compartilham esses atributos padrão:

500 501

502| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |503| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |

510| `user.email` | Endereço de email do usuário, do seu login ou, em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), das credenciais da própria sessão | Sempre incluído quando disponível |511| `user.email` | Endereço de email do usuário, do seu login ou, em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), das credenciais da própria sessão | Sempre incluído quando disponível |

512| Chaves de `OTEL_RESOURCE_ATTRIBUTES` | Atributos personalizados que você define, como `department` ou `team.id`. Veja [Suporte a organização multi-equipe](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (padrão: true) |513| Chaves de `OTEL_RESOURCE_ATTRIBUTES` | Atributos personalizados que você define, como `department` ou `team.id`. Veja [Suporte a organização multi-equipe](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (padrão: true) |

514| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | A identidade do repositório da sessão, derivada do seu remote `origin`. Veja [Atributos de repositório](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (padrão: false). Requer Claude Code v2.1.269 ou posterior |

513 515

514Quando Claude Code está conectado a um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), a CLI marca as exportações com a identidade autenticada da sessão do gateway: `user.id` é o assunto do IdP em vez de um identificador de instalação anônimo, `user.email` é o email conectado e `user.groups` carrega a associação de grupo do IdP como uma string separada por vírgula. Cada exportação também carrega `identity.source: gateway-oidc`. A identidade do gateway é aplicada por último, então as chaves `user.*` e `identity.*` definidas através de `OTEL_RESOURCE_ATTRIBUTES` são ignoradas em sessões de gateway.516Quando Claude Code está conectado a um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), a CLI marca as exportações com a identidade autenticada da sessão do gateway: `user.id` é o assunto do IdP em vez de um identificador de instalação anônimo, `user.email` é o email conectado e `user.groups` carrega a associação de grupo do IdP como uma string separada por vírgula. Cada exportação também carrega `identity.source: gateway-oidc`. A identidade do gateway é aplicada por último, então as chaves `user.*` e `identity.*` definidas através de `OTEL_RESOURCE_ATTRIBUTES` são ignoradas em sessões de gateway.

515 517

520* `workflow.run_id`: identificador de execução, prefixado com `wf_`, nos eventos de API e ferramenta emitidos por agentes que pertencem a uma execução de ferramenta [Workflow](/docs/pt/workflows). Filtrando eventos por um `workflow.run_id` reconstrói as solicitações de API e resultados de ferramentas dessa execução. O identificador cobre os agentes que o script de workflow gera e quaisquer agentes que esses gerem por sua vez, como invocações de skill. Ele corresponde ao identificador de execução relatado no resultado da ferramenta Workflow. Ausente em todos os outros eventos. Requer Claude Code v2.1.202 ou posterior522* `workflow.run_id`: identificador de execução, prefixado com `wf_`, nos eventos de API e ferramenta emitidos por agentes que pertencem a uma execução de ferramenta [Workflow](/docs/pt/workflows). Filtrando eventos por um `workflow.run_id` reconstrói as solicitações de API e resultados de ferramentas dessa execução. O identificador cobre os agentes que o script de workflow gera e quaisquer agentes que esses gerem por sua vez, como invocações de skill. Ele corresponde ao identificador de execução relatado no resultado da ferramenta Workflow. Ausente em todos os outros eventos. Requer Claude Code v2.1.202 ou posterior

521* `workflow.name`: nome do workflow, o `meta.name` do seu script, emitido junto com `workflow.run_id`. Nomes de workflow integrados aparecem verbatim quando a execução executa o script integrado não modificado. Nomes criados pelo usuário, incluindo cópias editadas de scripts integrados, são substituídos por `custom` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido. Requer Claude Code v2.1.202 ou posterior523* `workflow.name`: nome do workflow, o `meta.name` do seu script, emitido junto com `workflow.run_id`. Nomes de workflow integrados aparecem verbatim quando a execução executa o script integrado não modificado. Nomes criados pelo usuário, incluindo cópias editadas de scripts integrados, são substituídos por `custom` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido. Requer Claude Code v2.1.202 ou posterior

522 524

525<h4 id="repository-attributes">

526 Atributos de repositório

527</h4>

528

529Defina `OTEL_METRICS_INCLUDE_REPOSITORY=true` para marcar métricas e eventos com a identidade do repositório da sessão, para que um coletor compartilhado possa atribuir uso por repositório. Requer Claude Code v2.1.269 ou posterior.

530

531Claude Code deriva esses atributos uma vez por sessão a partir do remote `origin` do repositório. Os remotes HTTPS e SSH de um repositório produzem valores idênticos:

532

533| Atributo | Valor |

534| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |

535| `vcs.repository.url.full` | A URL do navegador do repositório sem `.git`, como `https://github.com/example-org/example-repo` |

536| `vcs.owner.name` | O caminho do proprietário ou grupo, como `example-org`; omitido quando o caminho remoto tem um único segmento |

537| `vcs.repository.name` | O nome do repositório simples, como `example-repo` |

538| `vcs.provider.name` | `github`, `gitlab`, `bitbucket` ou `gitea` quando Claude Code reconhece o host remoto ou forma de URL como um desses provedores; omitido caso contrário |

539

540Os valores são minúsculos, e credenciais, strings de consulta e fragmentos do URL remoto nunca aparecem neles. Os atributos são omitidos quando a sessão não tem um remote `origin`, quando o remote não é em forma de URL ou quando o único repositório envolvente é seu diretório home.

541

542Uma chave `vcs.*` que você declara em [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) substitui o valor derivado para essa chave. Se você declarar `vcs.repository.url.full`, Claude Code nunca lê o remote e relata apenas as chaves que você declara.

543

544Os atributos fluem apenas para seus próprios exportadores; a telemetria Anthropic descarta cada chave `vcs.*`.

545

523<h3 id="metrics">546<h3 id="metrics">

524 Métricas547 Métricas

525</h3>548</h3>

665| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |688| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

690| `event.sequence` | Contador baseado em zero para ordenar eventos, contado por processo Claude Code em vez de por sessão |

667| `message.uuid` | UUID da mensagem conforme persistida na transcrição da sessão, os arquivos `~/.claude/projects/*/*.jsonl`. Presente em `assistant_response` e em `user_prompt` exceto para despachos de comando, que podem produzir zero ou muitas mensagens. Em `assistant_response`, esta é a entrada de transcrição final da resposta, da qual o `parentUuid` da próxima rodada se encadeia. Requer Claude Code v2.1.214 ou posterior |691| `message.uuid` | UUID da mensagem conforme persistida na transcrição da sessão, os arquivos `~/.claude/projects/*/*.jsonl`. Presente em `assistant_response` e em `user_prompt` exceto para despachos de comando, que podem produzir zero ou muitas mensagens. Em `assistant_response`, esta é a entrada de transcrição final da resposta, da qual o `parentUuid` da próxima rodada se encadeia. Requer Claude Code v2.1.214 ou posterior |

668| `client_request_id` | UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`. Presente em `api_request` e `api_error` em conexões de API de primeira parte; ausente em backends de provedor de terceiros e quando a solicitação foi repetida através do fallback não-streaming. Emparelha uma solicitação com sua resposta e permanece disponível para falhas como timeouts que nunca produziram um `request_id` do servidor. Corresponde ao mesmo atributo no span de rastreamento `llm_request`. Requer Claude Code v2.1.214 ou posterior |692| `client_request_id` | UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`. Presente em `api_request` e `api_error` em conexões de API de primeira parte; ausente em backends de provedor de terceiros e quando a solicitação foi repetida através do fallback não-streaming. Emparelha uma solicitação com sua resposta e permanece disponível para falhas como timeouts que nunca produziram um `request_id` do servidor. Corresponde ao mesmo atributo no span de rastreamento `llm_request`. Requer Claude Code v2.1.214 ou posterior |

669 693

670Para rastrear toda a atividade acionada por um único prompt, filtre seus eventos por um valor específico de `prompt.id`. Isso retorna o evento user\_prompt, quaisquer eventos api\_request e quaisquer eventos tool\_result que ocorreram ao processar esse prompt.694Para rastrear toda a atividade acionada por um único prompt, filtre seus eventos por um valor específico de `prompt.id`. Isso retorna o evento user\_prompt, quaisquer eventos api\_request e quaisquer eventos tool\_result que ocorreram ao processar esse prompt.

671 695

696`event.sequence` começa em 0 cada vez que um processo Claude Code inicia e conta para cima pela vida desse processo. Ele continua contando através de `/clear`, que atribui um novo `session.id`. Se você [retomar uma sessão sem fazer fork](/docs/pt/how-claude-code-works#resume-or-fork-sessions), a sessão mantém seu `session.id` mas toma seus valores de `event.sequence` do processo que a retomou, então dentro de uma sessão um evento posterior pode carregar um valor menor que um anterior, ou repetir um. Para ordenar os eventos de uma sessão, classifique por `event.timestamp` e use `event.sequence` para ordenar eventos que compartilham um timestamp.

697

672Para reconstrução em nível de mensagem, cada classe de evento carrega uma chave que corresponde a um campo na transcrição da sessão. O formato de entrada de transcrição é [interno ao Claude Code](/docs/pt/sessions#where-transcripts-are-stored) e muda entre versões, então um pipeline que se une nestes campos pode quebrar em qualquer versão; trate as uniões como específicas da versão em vez de um contrato estável:698Para reconstrução em nível de mensagem, cada classe de evento carrega uma chave que corresponde a um campo na transcrição da sessão. O formato de entrada de transcrição é [interno ao Claude Code](/docs/pt/sessions#where-transcripts-are-stored) e muda entre versões, então um pipeline que se une nestes campos pode quebrar em qualquer versão; trate as uniões como específicas da versão em vez de um contrato estável:

673 699

674* `message.uuid` em `user_prompt` e `assistant_response`700* `message.uuid` em `user_prompt` e `assistant_response`

688* Todos os [atributos padrão](#standard-attributes)714* Todos os [atributos padrão](#standard-attributes)

689* `event.name`: `"user_prompt"`715* `event.name`: `"user_prompt"`

690* `event.timestamp`: Timestamp ISO 8601716* `event.timestamp`: Timestamp ISO 8601

691* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão717* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

692* `prompt_length`: Comprimento do prompt718* `prompt_length`: Comprimento do prompt

693* `prompt`: Conteúdo do prompt. Reduzido por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo719* `prompt`: Conteúdo do prompt. Reduzido por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo

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

708* Todos os [atributos padrão](#standard-attributes)734* Todos os [atributos padrão](#standard-attributes)

709* `event.name`: `"assistant_response"`735* `event.name`: `"assistant_response"`

710* `event.timestamp`: Timestamp ISO 8601736* `event.timestamp`: Timestamp ISO 8601

711* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão737* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

712* `response_length`: Comprimento do texto de resposta em caracteres738* `response_length`: Comprimento do texto de resposta em caracteres

713* `response`: Texto de resposta, truncado no limite de conteúdo (60 KB por padrão). Reduzido para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` controla isso em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas reduzidas enquanto o registro de prompt está ativado739* `response`: Texto de resposta, truncado no limite de conteúdo (60 KB por padrão). Reduzido para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` controla isso em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas reduzidas enquanto o registro de prompt está ativado

714* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")740* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

729* Todos os [atributos padrão](#standard-attributes)755* Todos os [atributos padrão](#standard-attributes)

730* `event.name`: `"tool_result"`756* `event.name`: `"tool_result"`

731* `event.timestamp`: Timestamp ISO 8601757* `event.timestamp`: Timestamp ISO 8601

732* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão758* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

733* `tool_name`: Nome da ferramenta759* `tool_name`: Nome da ferramenta

734* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.760* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.

735* `success`: `"true"` ou `"false"`761* `success`: `"true"` ou `"false"`

741* `tool_input_size_bytes`: Tamanho da entrada da ferramenta serializada em JSON em bytes767* `tool_input_size_bytes`: Tamanho da entrada da ferramenta serializada em JSON em bytes

742* `tool_result_size_bytes`: Tamanho do resultado da ferramenta em bytes768* `tool_result_size_bytes`: Tamanho do resultado da ferramenta em bytes

743* `mcp_server_scope`: Identificador de escopo do servidor MCP (para ferramentas MCP)769* `mcp_server_scope`: Identificador de escopo do servidor MCP (para ferramentas MCP)

770* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quando `OTEL_LOG_TOOL_DETAILS=1`): a identidade do commit de uma execução bem-sucedida de `git commit` executada pela ferramenta Bash ou PowerShell. `vcs.ref.head.revision` é o SHA do commit, `vcs.ref.head.name` é o branch no qual foi feito o commit, e `vcs.ref.head.type` é `branch`. O nome e tipo são omitidos quando o commit foi feito em um HEAD desanexado. Requer Claude Code v2.1.269 ou posterior

744* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Para servidores integrados do Claude Desktop, em sessões que o Claude Desktop possui, o par `mcp_server_name`/`mcp_tool_name` é incluído mesmo com a flag desligada, a mesma exceção de autoria do host que o [Evento de decisão da ferramenta](#tool-decision-event), requerendo Claude Code v2.1.214 ou posterior. Os parâmetros variam por ferramenta:771* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Para servidores integrados do Claude Desktop, em sessões que o Claude Desktop possui, o par `mcp_server_name`/`mcp_tool_name` é incluído mesmo com a flag desligada, a mesma exceção de autoria do host que o [Evento de decisão da ferramenta](#tool-decision-event), requerendo Claude Code v2.1.214 ou posterior. Os parâmetros variam por ferramenta:

745 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox` e `git_commit_id` (o SHA do commit, quando um comando `git commit` é bem-sucedido). A ferramenta bash de workspace do aplicativo desktop também relata `tool_name` como `Bash`, mas inclui apenas `bash_command`, `full_command` e `timeout`772 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description` e `dangerouslyDisableSandbox`, mais `git_commit_id` e `git_branch` quando um comando `git commit` é bem-sucedido. `git_commit_id` é o SHA do commit completo quando o commit é o HEAD do diretório de trabalho da sessão, e o SHA abreviado do git caso contrário. `git_branch` é o branch no qual foi feito o commit, omitido em um HEAD desanexado

773 * Para a ferramenta Bash de workspace do aplicativo desktop, que também relata `tool_name` como `Bash`: inclui apenas `bash_command`, `full_command` e `timeout`

746 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`774 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`

747 * Para ferramenta Skill: inclui `skill_name`775 * Para ferramenta Skill: inclui `skill_name`

748 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`776 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`

761* Todos os [atributos padrão](#standard-attributes)789* Todos os [atributos padrão](#standard-attributes)

762* `event.name`: `"api_request"`790* `event.name`: `"api_request"`

763* `event.timestamp`: Timestamp ISO 8601791* `event.timestamp`: Timestamp ISO 8601

764* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão792* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

765* `model`: Modelo usado (por exemplo, "claude-sonnet-5")793* `model`: Modelo usado (por exemplo, "claude-sonnet-5")

766* `cost_usd`: Custo estimado em USD794* `cost_usd`: Custo estimado em USD

767* `cost_usd_micros`: Custo estimado em milionésimos de dólar americano, emitido como um inteiro795* `cost_usd_micros`: Custo estimado em milionésimos de dólar americano, emitido como um inteiro

790* Todos os [atributos padrão](#standard-attributes)818* Todos os [atributos padrão](#standard-attributes)

791* `event.name`: `"api_error"`819* `event.name`: `"api_error"`

792* `event.timestamp`: Timestamp ISO 8601820* `event.timestamp`: Timestamp ISO 8601

793* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão821* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

794* `model`: Modelo usado (por exemplo, "claude-sonnet-5")822* `model`: Modelo usado (por exemplo, "claude-sonnet-5")

795* `error`: Mensagem de erro823* `error`: Mensagem de erro

796* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP, como falhas de conexão.824* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP, como falhas de conexão.

816* Todos os [atributos padrão](#standard-attributes)844* Todos os [atributos padrão](#standard-attributes)

817* `event.name`: `"api_refusal"`845* `event.name`: `"api_refusal"`

818* `event.timestamp`: Timestamp ISO 8601846* `event.timestamp`: Timestamp ISO 8601

819* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão847* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

820* `model`: Identificador do modelo da solicitação848* `model`: Identificador do modelo da solicitação

821* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.849* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

822* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente. Veja [`api_request`](#api-request-event) para definições.850* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente. Veja [`api_request`](#api-request-event) para definições.

842* Todos os [atributos padrão](#standard-attributes)870* Todos os [atributos padrão](#standard-attributes)

843* `event.name`: `"api_request_body"`871* `event.name`: `"api_request_body"`

844* `event.timestamp`: Timestamp ISO 8601872* `event.timestamp`: Timestamp ISO 8601

845* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão873* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

846* `body`: Parâmetros de solicitação da API Messages serializados em JSON, como o prompt do sistema, mensagens e ferramentas, truncados no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido em turnos anteriores do assistente é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).874* `body`: Parâmetros de solicitação da API Messages serializados em JSON, como o prompt do sistema, mensagens e ferramentas, truncados no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido em turnos anteriores do assistente é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).

847* `body_ref`: Caminho absoluto para um arquivo `<dir>/<uuid>.request.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).875* `body_ref`: Caminho absoluto para um arquivo `<dir>/<uuid>.request.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

848* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`876* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`

863* Todos os [atributos padrão](#standard-attributes)891* Todos os [atributos padrão](#standard-attributes)

864* `event.name`: `"api_response_body"`892* `event.name`: `"api_response_body"`

865* `event.timestamp`: Timestamp ISO 8601893* `event.timestamp`: Timestamp ISO 8601

866* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão894* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

867* `body`: Resposta da API Messages serializada em JSON, incluindo o id, blocos de conteúdo, uso e razão de parada, truncada no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).895* `body`: Resposta da API Messages serializada em JSON, incluindo o id, blocos de conteúdo, uso e razão de parada, truncada no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).

868* `body_ref`: Caminho absoluto para um arquivo `<dir>/<request_id>.response.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).896* `body_ref`: Caminho absoluto para um arquivo `<dir>/<request_id>.response.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

869* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`897* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`

885* Todos os [atributos padrão](#standard-attributes)913* Todos os [atributos padrão](#standard-attributes)

886* `event.name`: `"tool_decision"`914* `event.name`: `"tool_decision"`

887* `event.timestamp`: Timestamp ISO 8601915* `event.timestamp`: Timestamp ISO 8601

888* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão916* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

889* `tool_name`: Nome da ferramenta (por exemplo, "Read", "Edit", "Write", "NotebookEdit")917* `tool_name`: Nome da ferramenta (por exemplo, "Read", "Edit", "Write", "NotebookEdit")

890* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.918* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.

891* `decision`: Ou `"accept"` ou `"reject"`919* `decision`: Ou `"accept"` ou `"reject"`

920* Todos os [atributos padrão](#standard-attributes)948* Todos os [atributos padrão](#standard-attributes)

921* `event.name`: `"permission_mode_changed"`949* `event.name`: `"permission_mode_changed"`

922* `event.timestamp`: Timestamp ISO 8601950* `event.timestamp`: Timestamp ISO 8601

923* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão951* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

924* `from_mode`: O modo de permissão anterior, por exemplo `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` ou `"bypassPermissions"`952* `from_mode`: O modo de permissão anterior, por exemplo `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` ou `"bypassPermissions"`

925* `to_mode`: O novo modo de permissão953* `to_mode`: O novo modo de permissão

926* `trigger`: O que causou a mudança. Um de `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` ou `"auto_opt_in"`. Ausente quando a transição se origina do SDK ou bridge954* `trigger`: O que causou a mudança. Um de `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` ou `"auto_opt_in"`. Ausente quando a transição se origina do SDK ou bridge

938* Todos os [atributos padrão](#standard-attributes)966* Todos os [atributos padrão](#standard-attributes)

939* `event.name`: `"auth"`967* `event.name`: `"auth"`

940* `event.timestamp`: Timestamp ISO 8601968* `event.timestamp`: Timestamp ISO 8601

941* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão969* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

942* `action`: `"login"` ou `"logout"`970* `action`: `"login"` ou `"logout"`

943* `success`: `"true"` ou `"false"`971* `success`: `"true"` ou `"false"`

944* `auth_method`: Método de autenticação, como `"oauth"`972* `auth_method`: Método de autenticação, como `"oauth"`

958* Todos os [atributos padrão](#standard-attributes)986* Todos os [atributos padrão](#standard-attributes)

959* `event.name`: `"mcp_server_connection"`987* `event.name`: `"mcp_server_connection"`

960* `event.timestamp`: Timestamp ISO 8601988* `event.timestamp`: Timestamp ISO 8601

961* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão989* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

962* `status`: `"connected"`, `"failed"` ou `"disconnected"`990* `status`: `"connected"`, `"failed"` ou `"disconnected"`

963* `transport_type`: Transporte do servidor, como `"stdio"`, `"sse"` ou `"http"`991* `transport_type`: Transporte do servidor, como `"stdio"`, `"sse"` ou `"http"`

964* `server_scope`: Escopo em que o servidor está configurado, como `"user"`, `"project"` ou `"local"`992* `server_scope`: Escopo em que o servidor está configurado, como `"user"`, `"project"` ou `"local"`

983* Todos os [atributos padrão](#standard-attributes)1011* Todos os [atributos padrão](#standard-attributes)

984* `event.name`: `"internal_error"`1012* `event.name`: `"internal_error"`

985* `event.timestamp`: Timestamp ISO 86011013* `event.timestamp`: Timestamp ISO 8601

986* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1014* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

987* `error_name`: Nome da classe de erro, como `"TypeError"` ou `"SyntaxError"`1015* `error_name`: Nome da classe de erro, como `"TypeError"` ou `"SyntaxError"`

988* `error_code`: Código errno Node.js como `"ENOENT"` quando presente no erro1016* `error_code`: Código errno Node.js como `"ENOENT"` quando presente no erro

989 1017

1000* Todos os [atributos padrão](#standard-attributes)1028* Todos os [atributos padrão](#standard-attributes)

1001* `event.name`: `"plugin_installed"`1029* `event.name`: `"plugin_installed"`

1002* `event.timestamp`: Timestamp ISO 86011030* `event.timestamp`: Timestamp ISO 8601

1003* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1031* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1004* `marketplace.is_official`: `"true"` se o marketplace é um marketplace oficial Anthropic, `"false"` caso contrário1032* `marketplace.is_official`: `"true"` se o marketplace é um marketplace oficial Anthropic, `"false"` caso contrário

1005* `install.trigger`: `"cli"` ou `"ui"`1033* `install.trigger`: `"cli"` ou `"ui"`

1006* `plugin.name`: Nome do plugin instalado. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`1034* `plugin.name`: Nome do plugin instalado. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`

1020* Todos os [atributos padrão](#standard-attributes)1048* Todos os [atributos padrão](#standard-attributes)

1021* `event.name`: `"plugin_loaded"`1049* `event.name`: `"plugin_loaded"`

1022* `event.timestamp`: Timestamp ISO 86011050* `event.timestamp`: Timestamp ISO 8601

1023* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1051* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1024* `plugin.name`: nome do plugin. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1052* `plugin.name`: nome do plugin. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1025* `marketplace.name`: marketplace do qual o plugin foi instalado, quando conhecido. Reduzido para `"third-party"` sob a mesma condição que `plugin.name`1053* `marketplace.name`: marketplace do qual o plugin foi instalado, quando conhecido. Reduzido para `"third-party"` sob a mesma condição que `plugin.name`

1026* `plugin.version`: versão do manifesto do plugin. Incluído apenas quando o nome não é reduzido e o manifesto declara uma versão1054* `plugin.version`: versão do manifesto do plugin. Incluído apenas quando o nome não é reduzido e o manifesto declara uma versão

1048* Todos os [atributos padrão](#standard-attributes)1076* Todos os [atributos padrão](#standard-attributes)

1049* `event.name`: `"skill_activated"`1077* `event.name`: `"skill_activated"`

1050* `event.timestamp`: Timestamp ISO 86011078* `event.timestamp`: Timestamp ISO 8601

1051* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1079* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1052* `skill.name`: Nome da skill. Para skills definidas pelo usuário e de plugin de terceiros o valor é o placeholder `"custom_skill"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1080* `skill.name`: Nome da skill. Para skills definidas pelo usuário e de plugin de terceiros o valor é o placeholder `"custom_skill"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1053* `invocation_trigger`: Como a skill foi acionada (`"user-slash"`, `"claude-proactive"` ou `"nested-skill"`)1081* `invocation_trigger`: Como a skill foi acionada (`"user-slash"`, `"claude-proactive"` ou `"nested-skill"`)

1054* `skill.source`: De onde a skill foi carregada (por exemplo, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1082* `skill.source`: De onde a skill foi carregada (por exemplo, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1069* Todos os [atributos padrão](#standard-attributes)1097* Todos os [atributos padrão](#standard-attributes)

1070* `event.name`: `"at_mention"`1098* `event.name`: `"at_mention"`

1071* `event.timestamp`: Timestamp ISO 86011099* `event.timestamp`: Timestamp ISO 8601

1072* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1100* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1073* `mention_type`: Tipo de menção (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). O valor `"peer"` significa que você mencionou [uma de suas outras sessões Claude Code](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.232 ou posterior1101* `mention_type`: Tipo de menção (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). O valor `"peer"` significa que você mencionou [uma de suas outras sessões Claude Code](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.232 ou posterior

1074* `success`: Se a menção foi resolvida com sucesso (`"true"` ou `"false"`)1102* `success`: Se a menção foi resolvida com sucesso (`"true"` ou `"false"`)

1075 1103

1086* Todos os [atributos padrão](#standard-attributes)1114* Todos os [atributos padrão](#standard-attributes)

1087* `event.name`: `"api_retries_exhausted"`1115* `event.name`: `"api_retries_exhausted"`

1088* `event.timestamp`: Timestamp ISO 86011116* `event.timestamp`: Timestamp ISO 8601

1089* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1117* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1090* `model`: Modelo usado1118* `model`: Modelo usado

1091* `error`: Mensagem de erro final1119* `error`: Mensagem de erro final

1092* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP.1120* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP.

1107* Todos os [atributos padrão](#standard-attributes)1135* Todos os [atributos padrão](#standard-attributes)

1108* `event.name`: `"hook_registered"`1136* `event.name`: `"hook_registered"`

1109* `event.timestamp`: Timestamp ISO 86011137* `event.timestamp`: Timestamp ISO 8601

1110* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1138* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1111* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`1139* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`

1112* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` ou `"agent"`1140* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` ou `"agent"`

1113* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` ou `"pluginHook"`1141* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` ou `"pluginHook"`

1129* Todos os [atributos padrão](#standard-attributes)1157* Todos os [atributos padrão](#standard-attributes)

1130* `event.name`: `"hook_execution_start"`1158* `event.name`: `"hook_execution_start"`

1131* `event.timestamp`: Timestamp ISO 86011159* `event.timestamp`: Timestamp ISO 8601

1132* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1160* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1133* `hook_event`: Tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`1161* `hook_event`: Tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`

1134* `hook_name`: Nome completo do hook incluindo matcher, como `"PreToolUse:Write"`1162* `hook_name`: Nome completo do hook incluindo matcher, como `"PreToolUse:Write"`

1135* `num_hooks`: Número de comandos de hook correspondentes1163* `num_hooks`: Número de comandos de hook correspondentes

1151* Todos os [atributos padrão](#standard-attributes)1179* Todos os [atributos padrão](#standard-attributes)

1152* `event.name`: `"hook_execution_complete"`1180* `event.name`: `"hook_execution_complete"`

1153* `event.timestamp`: Timestamp ISO 86011181* `event.timestamp`: Timestamp ISO 8601

1154* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1182* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1155* `hook_event`: Tipo de evento de hook1183* `hook_event`: Tipo de evento de hook

1156* `hook_name`: Nome completo do hook incluindo matcher1184* `hook_name`: Nome completo do hook incluindo matcher

1157* `num_hooks`: Número de comandos de hook correspondentes1185* `num_hooks`: Número de comandos de hook correspondentes

1178* Todos os [atributos padrão](#standard-attributes)1206* Todos os [atributos padrão](#standard-attributes)

1179* `event.name`: `"hook_plugin_metrics"`1207* `event.name`: `"hook_plugin_metrics"`

1180* `event.timestamp`: Timestamp ISO 86011208* `event.timestamp`: Timestamp ISO 8601

1181* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1209* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1182* `plugin_id`: identificador do plugin em forma `<name>@<marketplace>`1210* `plugin_id`: identificador do plugin em forma `<name>@<marketplace>`

1183* `hook_event`: tipo de evento de hook que emitiu as métricas1211* `hook_event`: tipo de evento de hook que emitiu as métricas

1184* Até 20 chaves de métrica emitidas pelo plugin. Os nomes correspondem a `^[a-z][a-z0-9_]{0,39}$`. Os valores são booleanos ou números.1212* Até 20 chaves de métrica emitidas pelo plugin. Os nomes correspondem a `^[a-z][a-z0-9_]{0,39}$`. Os valores são booleanos ou números.

1196* Todos os [atributos padrão](#standard-attributes)1224* Todos os [atributos padrão](#standard-attributes)

1197* `event.name`: `"compaction"`1225* `event.name`: `"compaction"`

1198* `event.timestamp`: Timestamp ISO 86011226* `event.timestamp`: Timestamp ISO 8601

1199* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1227* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1200* `trigger`: `"auto"` ou `"manual"`1228* `trigger`: `"auto"` ou `"manual"`

1201* `success`: `"true"` ou `"false"`1229* `success`: `"true"` ou `"false"`

1202* `duration_ms`: Duração da compactação1230* `duration_ms`: Duração da compactação

1218* Todos os [atributos padrão](#standard-attributes)1246* Todos os [atributos padrão](#standard-attributes)

1219* `event.name`: `"subagent_completed"`1247* `event.name`: `"subagent_completed"`

1220* `event.timestamp`: Timestamp ISO 86011248* `event.timestamp`: Timestamp ISO 8601

1221* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1249* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1222* `agent_type`: O tipo de subagente. Nomes de agente integrados e agentes de plugins do marketplace oficial aparecem verbatim; outros nomes de agente são substituídos por `"custom"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido1250* `agent_type`: O tipo de subagente. Nomes de agente integrados e agentes de plugins do marketplace oficial aparecem verbatim; outros nomes de agente são substituídos por `"custom"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido

1223* `agent.source`: De onde a definição do agente veio: `built-in`, `plugin` ou a fonte de configurações que definiu um agente customizado, como `userSettings` ou `projectSettings`1251* `agent.source`: De onde a definição do agente veio: `built-in`, `plugin` ou a fonte de configurações que definiu um agente customizado, como `userSettings` ou `projectSettings`

1224* `is_built_in`: Se o subagente é um tipo de agente integrado1252* `is_built_in`: Se o subagente é um tipo de agente integrado

1244* Todos os [atributos padrão](#standard-attributes)1272* Todos os [atributos padrão](#standard-attributes)

1245* `event.name`: `"feedback_survey"`1273* `event.name`: `"feedback_survey"`

1246* `event.timestamp`: Timestamp ISO 86011274* `event.timestamp`: Timestamp ISO 8601

1247* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1275* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1248* `event_type`: Evento do ciclo de vida da pesquisa, por exemplo `"appeared"`, `"responded"` ou `"transcript_prompt_appeared"`1276* `event_type`: Evento do ciclo de vida da pesquisa, por exemplo `"appeared"`, `"responded"` ou `"transcript_prompt_appeared"`

1249* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa1277* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa

1250* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"1278* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"

1268* Todos os [atributos padrão](#standard-attributes)1296* Todos os [atributos padrão](#standard-attributes)

1269* `event.name`: `"retention_sweep"`1297* `event.name`: `"retention_sweep"`

1270* `event.timestamp`: Timestamp ISO 86011298* `event.timestamp`: Timestamp ISO 8601

1271* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão1299* `event.sequence`: Contador por processo para ordenar eventos, descrito em [Atributos de correlação de evento](#event-correlation-attributes)

1272* `result`: `"complete"` quando a varredura foi executada, `"skipped"` quando Claude Code a pausou1300* `result`: `"complete"` quando a varredura foi executada, `"skipped"` quando Claude Code a pausou

1273* `period_days`: O valor `cleanupPeriodDays` das configurações mescladas, em dias, ou `30` quando nenhuma fonte o define. Em eventos ignorados, o valor que a varredura teria usado, computado a partir das fontes de configurações que Claude Code conseguiu ler1301* `period_days`: O valor `cleanupPeriodDays` das configurações mescladas, em dias, ou `30` quando nenhuma fonte o define. Em eventos ignorados, o valor que a varredura teria usado, computado a partir das fontes de configurações que Claude Code conseguiu ler

1274* `used_default`: `"true"` quando nenhuma fonte de configurações legível define `cleanupPeriodDays`, `"false"` caso contrário. Em eventos completos, `"true"` significa que o padrão de 30 dias foi aplicado1302* `used_default`: `"true"` quando nenhuma fonte de configurações legível define `cleanupPeriodDays`, `"false"` caso contrário. Em eventos completos, `"true"` significa que o padrão de 30 dias foi aplicado

permissions.md +3 −1

Details

67 67

68Uma regra deny ampla como `Bash(aws *)` bloqueia cada chamada correspondente, incluindo chamadas que também correspondem a uma regra allow mais estreita como `Bash(aws s3 ls)`, portanto uma regra deny não pode carregar exceções de lista de permissões. A mesma precedência se aplica entre ask e allow: uma regra ask correspondente solicita confirmação mesmo quando uma regra allow mais específica também corresponde à mesma chamada.68Uma regra deny ampla como `Bash(aws *)` bloqueia cada chamada correspondente, incluindo chamadas que também correspondem a uma regra allow mais estreita como `Bash(aws s3 ls)`, portanto uma regra deny não pode carregar exceções de lista de permissões. A mesma precedência se aplica entre ask e allow: uma regra ask correspondente solicita confirmação mesmo quando uma regra allow mais específica também corresponde à mesma chamada.

69 69

70As regras deny se comportam de forma diferente dependendo se nomeiam uma ferramenta ou definem o escopo de um padrão dentro de uma. Um nome de ferramenta simples como `Bash` remove a ferramenta do contexto do Claude completamente, então Claude nunca a vê. A remoção com nome simples se aplica a todas as ferramentas exceto [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior): uma regra deny não pode removê-la enquanto qualquer outra ferramenta permanecer, e uma regra ask nunca solicita confirmação para ela. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e bloqueia chamadas correspondentes quando Claude tenta usá-las.70As regras deny se comportam de forma diferente dependendo se nomeiam uma ferramenta ou definem o escopo de um padrão dentro de uma. Um nome de ferramenta simples como `Bash` remove a ferramenta do contexto do Claude completamente, então Claude nunca a vê. Se você adicionar tal regra no meio da sessão, Claude não pode chamar a ferramenta a partir de sua próxima chamada de ferramenta em diante; [Negando uma ferramenta inteira](/docs/pt/prompt-caching#denying-an-entire-tool) cobre o que acontece com uma definição que Claude já viu. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e bloqueia chamadas correspondentes quando Claude tenta usá-las.

72A remoção com nome simples se aplica a todas as ferramentas exceto [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior): uma regra deny não pode removê-la enquanto qualquer outra ferramenta permanecer, e uma regra ask nunca solicita confirmação para ela.

71 73

72<Note>74<Note>

73 As regras de permissão são aplicadas pelo Claude Code, não pelo modelo. As instruções em seu prompt ou `CLAUDE.md` moldam o que Claude tenta fazer, mas não alteram o que Claude Code permite. Para conceder ou revogar acesso, use `/permissions`, as regras descritas aqui, um [modo de permissão](/docs/pt/permission-modes), ou um [hook PreToolUse](#extend-permissions-with-hooks).75 As regras de permissão são aplicadas pelo Claude Code, não pelo modelo. As instruções em seu prompt ou `CLAUDE.md` moldam o que Claude tenta fazer, mas não alteram o que Claude Code permite. Para conceder ou revogar acesso, use `/permissions`, as regras descritas aqui, um [modo de permissão](/docs/pt/permission-modes), ou um [hook PreToolUse](#extend-permissions-with-hooks).

prompt-caching.md +4 −2

Details

185 Denying an entire tool185 Denying an entire tool

186</h3>186</h3>

187 187

188Adicionar um nome de ferramenta simples como `Bash` ou `WebFetch` como uma [deny rule](/docs/pt/permissions#manage-permissions) remove essa ferramenta do contexto de Claude inteiramente. Claude Code carrega definições de ferramentas integradas na camada de prompt do sistema, então adicionar ou remover uma dessas regras no meio da sessão invalida o cache. Claude Code aplica a mudança na próxima solicitação, seja você adicionar a regra através de `/permissions` ou [editando um arquivo de configurações diretamente](/docs/pt/settings#when-edits-take-effect). Isso inclui uma regra que você adiciona através de `/permissions` no meio de um turno.188Se você adicionar um nome de ferramenta simples como `Bash` ou `WebFetch` como uma [deny rule](/docs/pt/permissions#manage-permissions), Claude não pode chamar essa ferramenta a partir de sua próxima solicitação em diante, seja você adicionar a regra através de `/permissions` ou [editando um arquivo de configurações diretamente](/docs/pt/settings#when-edits-take-effect). Isso inclui uma regra que você adiciona através de `/permissions` no meio de um turno.

189 189

190Apenas uma deny rule que corresponde na posição do nome da ferramenta tem esse efeito: um nome de ferramenta simples, a forma equivalente `Bash(*)`, ou um [tool-name glob](/docs/pt/permissions#tool-name-wildcards) como `"*"`. Um glob que corresponde apenas a ferramentas MCP, como `"mcp__*"`, remove essas ferramentas da mesma forma, mas deixa o cache intacto quando as ferramentas correspondidas são [adiadas](#connecting-or-disconnecting-an-mcp-server), o padrão, já que definições adiadas nunca estiveram no prefixo armazenado em cache. Deny rules com escopo como `Bash(rm *)`, e todas as regras allow e ask, não mudam quais ferramentas Claude vê. Claude Code as verifica quando Claude tenta uma chamada, deixando o prefixo intacto.190Quando [tool search](/docs/pt/mcp#scale-with-mcp-tool-search) está ativo, que é o padrão em modelos suportados, as definições de ferramentas da solicitação não mudam e o prefixo armazenado em cache sobrevive. Quando tool search está indisponível ou desabilitado, Claude Code remove a definição da próxima solicitação, o que invalida o cache, e o mesmo acontece ao remover a regra depois.

191

192Apenas uma deny rule que corresponde na posição do nome da ferramenta bloqueia uma ferramenta dessa forma: um nome de ferramenta simples, a forma equivalente `Bash(*)`, ou um [tool-name glob](/docs/pt/permissions#tool-name-wildcards) como `"*"`. Um glob que corresponde apenas a ferramentas MCP, como `"mcp__*"`, bloqueia essas ferramentas da mesma forma. Deny rules com escopo como `Bash(rm *)`, e todas as regras allow e ask, não mudam quais ferramentas Claude vê. Claude Code as verifica quando Claude tenta uma chamada, deixando o prefixo intacto.

191 193

192<h3 id="compacting-the-conversation">194<h3 id="compacting-the-conversation">

193 Compacting the conversation195 Compacting the conversation

remote-control.md +1 −1

Details

1743. A última mensagem significativa no histórico de conversa existente1743. A última mensagem significativa no histórico de conversa existente

1754. Um nome gerado automaticamente como `myhost-graceful-unicorn`, onde `myhost` é o nome do host da sua máquina ou o prefixo que você definiu com `--remote-control-session-name-prefix`1754. Um nome gerado automaticamente como `myhost-graceful-unicorn`, onde `myhost` é o nome do host da sua máquina ou o prefixo que você definiu com `--remote-control-session-name-prefix`

176 176

177Se você não definir um nome explícito, Claude Code atualiza o título para refletir seu prompt assim que você enviar um. Claude Code corresponde títulos gerados automaticamente ao idioma da sua conversa, ou à configuração [`language`](/docs/pt/settings-reference#language) se uma estiver configurada; a correspondência de idioma requer Claude Code v2.1.176 ou posterior.177Se você não definir um nome explícito, Claude Code atualiza o título para refletir seu prompt assim que você enviar um. Claude Code corresponde títulos gerados automaticamente ao idioma da sua conversa, ou à configuração [`language`](/docs/pt/settings-reference#language) se uma estiver configurada.

178 178

179Quando você renomeia uma sessão a partir de claude.ai ou do aplicativo Claude, Claude Code também atualiza o título local mostrado em `claude --resume`. Claude Code aplica o mesmo renome ao nome da sessão mostrado na barra de prompt, e na listagem `claude agents` quando a sessão [é executada em segundo plano](/docs/pt/agent-view). Antes da v2.1.221, renomear a partir da lista de sessões em claude.ai ou no aplicativo Claude atualizava apenas o título, e a CLI mantinha seu nome de sessão anterior; `/rename`, que é executado na própria CLI, define o nome em qualquer versão.179Quando você renomeia uma sessão a partir de claude.ai ou do aplicativo Claude, Claude Code também atualiza o título local mostrado em `claude --resume`. Claude Code aplica o mesmo renome ao nome da sessão mostrado na barra de prompt, e na listagem `claude agents` quando a sessão [é executada em segundo plano](/docs/pt/agent-view). Antes da v2.1.221, renomear a partir da lista de sessões em claude.ai ou no aplicativo Claude atualizava apenas o título, e a CLI mantinha seu nome de sessão anterior; `/rename`, que é executado na própria CLI, define o nome em qualquer versão.

180 180

sandbox-environments.md +1 −1

Details

83O sandbox por comando não cobre tudo que é executado em uma sessão:83O sandbox por comando não cobre tudo que é executado em uma sessão:

84 84

85* Outras [built-in tools](/docs/pt/tools-reference) como Read, Edit e WebFetch são executadas dentro do processo do Claude Code e não geram código arbitrário. [Permission rules](/docs/pt/permissions) para caminho ou domínio as controlam.85* Outras [built-in tools](/docs/pt/tools-reference) como Read, Edit e WebFetch são executadas dentro do processo do Claude Code e não geram código arbitrário. [Permission rules](/docs/pt/permissions) para caminho ou domínio as controlam.

~~86* Servidores [MCP](/docs/pt/mcp) e hooks são processos separados que são executados sem restrições no host.~~86* Servidores [MCP](/docs/pt/mcp) e [command hooks](/docs/pt/hooks#command-hook-fields) são processos separados que são executados sem restrições no host.

87 87

88Para colocar ferramentas integradas, servidores MCP e hooks todos atrás de um limite do SO, execute todo o processo do Claude Code dentro do [sandbox runtime](#sandbox-runtime), do [dev container](#dev-containers), ou de um [custom container](#custom-container).88Para colocar ferramentas integradas, servidores MCP e hooks todos atrás de um limite do SO, execute todo o processo do Claude Code dentro do [sandbox runtime](#sandbox-runtime), do [dev container](#dev-containers), ou de um [custom container](#custom-container).

89 89

self-hosted-environments-deploy.md +1 −1

Details

486 486

487`--kill-session-after-min` é um backstop para sessões descontroladas. Em um runner na v2.1.260 ou posterior, uma sessão que atinge o limite não é encerrada imediatamente. O runner oferece uma janela de graça, 15 minutos por padrão, que você pode alterar com [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](/docs/pt/self-hosted-environments-reference#environment-variable-only-settings):487`--kill-session-after-min` é um backstop para sessões descontroladas. Em um runner na v2.1.260 ou posterior, uma sessão que atinge o limite não é encerrada imediatamente. O runner oferece uma janela de graça, 15 minutos por padrão, que você pode alterar com [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](/docs/pt/self-hosted-environments-reference#environment-variable-only-settings):

488 488

489* Se a sessão está aguardando seu usuário, ou sua vez terminou e ela mantém apenas tarefas de fundo, o runner a libera imediatamente. A sessão retoma quando seu usuário envia sua próxima mensagem.489* Se a sessão está aguardando seu usuário, o runner a libera. Se sua vez terminou e ela mantém apenas tarefas de fundo, o runner aguarda até 60 segundos para que essas tarefas terminem e então a libera. A sessão retoma quando seu usuário envia sua próxima mensagem.

490* Se uma vez ainda está em execução, o runner aguarda a vez terminar, ou para a sessão aguardar seu usuário em seguida, e então a libera.490* Se uma vez ainda está em execução, o runner aguarda a vez terminar, ou para a sessão aguardar seu usuário em seguida, e então a libera.

491* Se a sessão ainda estiver no runner quando a janela de graça terminar, o runner a encerra, e qualquer trabalho de uma vez em execução é perdido. Uma vez aguardando uma aprovação solicitada de dentro de uma chamada de ferramenta em execução é uma maneira de uma sessão ultrapassar a janela.491* Se a sessão ainda estiver no runner quando a janela de graça terminar, o runner a encerra, e qualquer trabalho de uma vez em execução é perdido. Uma vez aguardando uma aprovação solicitada de dentro de uma chamada de ferramenta em execução é uma maneira de uma sessão ultrapassar a janela.

492 492

server-managed-settings.md +2 −1

Details

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

164</h3>164</h3>

165 165

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

167 167

168* **Chaves de bloqueio entre fontes**: um pequeno conjunto de chaves, como os bloqueios da lista de permissão de sandbox, [listadas na página de configurações gerenciadas](/docs/pt/managed-settings#precedence-within-the-managed-tier). O Claude Code as honra quando qualquer fonte gerenciada controlada por administrador as define; o nível de registro HKCU gravável pelo usuário é excluído. Quando um [`policyHelper`](/docs/pt/settings-reference#policyhelper) fornece configurações gerenciadas, sua saída é a única fonte que essas verificações leem, exceto por [`forceRemoteSettingsRefresh`](/docs/pt/settings-reference#forceremotesettingsrefresh), que o Claude Code lê das fontes de administrador diretamente na inicialização.168* **Chaves de bloqueio entre fontes**: um pequeno conjunto de chaves, como os bloqueios da lista de permissão de sandbox, [listadas na página de configurações gerenciadas](/docs/pt/managed-settings#precedence-within-the-managed-tier). O Claude Code as honra quando qualquer fonte gerenciada controlada por administrador as define; o nível de registro HKCU gravável pelo usuário é excluído. Quando um [`policyHelper`](/docs/pt/settings-reference#policyhelper) fornece configurações gerenciadas, sua saída é a única fonte que essas verificações leem, exceto por [`forceRemoteSettingsRefresh`](/docs/pt/settings-reference#forceremotesettingsrefresh), que o Claude Code lê das fontes de administrador diretamente na inicialização.

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

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

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

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

172 173

173<h3 id="fetch-and-caching-behavior">174<h3 id="fetch-and-caching-behavior">

174 Comportamento de busca e cache175 Comportamento de busca e cache

settings-reference.md +9 −11

Details

830 `advisorModel`830 `advisorModel`

831</h3>831</h3>

832 832

833Escolha qual modelo responde quando Claude chama a [ferramenta advisor](/docs/pt/advisor) do lado do servidor. Deixe-a sem definir para desativar o advisor. O advisor deve ser pelo menos tão capaz quanto seu modelo principal; quando não é, Claude Code envia solicitações sem o advisor. Consulte [Escolha um modelo advisor](/docs/pt/advisor#choose-an-advisor-model).833Escolha qual modelo responde quando Claude chama a [ferramenta advisor](/docs/pt/advisor) do lado do servidor. Deixe-a sem definir para desativar o advisor. O advisor deve ser pelo menos tão capaz quanto seu modelo principal. Consulte [Escolha um modelo advisor](/docs/pt/advisor#choose-an-advisor-model) para os emparelhamentos aceitos e o que acontece quando você escolhe um que não é aceito.

834 834

835Você normalmente não edita essa chave manualmente. Execute `/advisor` para abrir um seletor que mostra a escolha atual, os modelos que podem aconselhar e **Sem advisor**. Claude Code salva sua escolha nessa chave em `~/.claude/settings.json`. Se você escolher em um cliente [Remote Control](/docs/pt/remote-control) ou em uma sessão anexada a um worker remoto, a escolha se aplica apenas a essa sessão e não altera essa chave.835Você normalmente não edita essa chave manualmente. Execute `/advisor` para abrir um seletor que mostra a escolha atual, os modelos que podem aconselhar e **Sem advisor**. Claude Code salva sua escolha nessa chave em `~/.claude/settings.json`. Se você escolher em um cliente [Remote Control](/docs/pt/remote-control) ou em uma sessão anexada a um worker remoto, a escolha se aplica apenas a essa sessão e não altera essa chave.

836 836

1347 * `true`: sessões começam em esforço `xhigh`, com ultracode ativado quando workflows dinâmicos estão habilitados para você, seu modelo suporta `xhigh` e nenhum limite de esforço está abaixo de `xhigh`1347 * `true`: sessões começam em esforço `xhigh`, com ultracode ativado quando workflows dinâmicos estão habilitados para você, seu modelo suporta `xhigh` e nenhum limite de esforço está abaixo de `xhigh`

1348 * `false`: sessões começam com ultracode desativado1348 * `false`: sessões começam com ultracode desativado

1349* **Padrão**: sem definir, então ultracode está desativado1349* **Padrão**: sem definir, então ultracode está desativado

1350* **Substituições por sessão**: `/effort ultracode` ativa ultracode para uma sessão sem essa chave. Assim como `--effort ultracode`, que requer Claude Code v2.1.203 ou posterior1350* **Substituições por sessão**: `/effort ultracode` ativa ultracode para uma sessão sem essa chave. O sinalizador `--effort ultracode` também o ativa para uma sessão e requer Claude Code v2.1.203 ou posterior

1351 1351

1352```json settings.json theme={null}1352```json settings.json theme={null}

1353{1353{

3308 `footerLinksRegexes`3308 `footerLinksRegexes`

3309</h3>3309</h3>

3310 3310

3311Renderize badges clicáveis extras no rodapé abaixo da caixa de entrada quando um regex corresponde à saída de turno: resultados de ferramentas, incluindo conteúdo de arquivo e páginas buscadas, e respostas do próprio Claude. Use-o para transformar IDs impressos por CLIs de projeto, como ferramentas de revisão e rastreadores de problemas, em links de sessão. Requer Claude Code v2.1.176 ou posterior.3311Renderize badges clicáveis extras no rodapé abaixo da caixa de entrada quando um regex corresponde à saída de turno: resultados de ferramentas, incluindo conteúdo de arquivo e páginas buscadas, e respostas do próprio Claude. Use-o para transformar IDs impressos por CLIs de projeto, como ferramentas de revisão e rastreadores de problemas, em links de sessão.

3312 3312

3313* **Scope**: [`User or managed`](#scopes)3313* **Scope**: [`User or managed`](#scopes)

3314* **Type**: array de objetos, cada um com `type` definido como `"regex"`, um regex `pattern`, um template `url`, e um `label` opcional; placeholders `{name}` em `url` e `label` são preenchidos a partir de grupos de captura nomeados em `pattern`3314* **Type**: array de objetos, cada um com `type` definido como `"regex"`, um regex `pattern`, um template `url`, e um `label` opcional; placeholders `{name}` em `url` e `label` são preenchidos a partir de grupos de captura nomeados em `pattern`

3329}3329}

3330```3330```

3331 3331

3332Com isso configurado, quando `PROJ-1234` aparece em um resultado de ferramenta ou na resposta de Claude, um badge `PROJ-1234` aparece no rodapé vinculando a `https://issues.example.com/browse/PROJ-1234`. Requer Claude Code v2.1.176 ou posterior.3332Com isso configurado, quando `PROJ-1234` aparece em um resultado de ferramenta ou na resposta de Claude, um badge `PROJ-1234` aparece no rodapé vinculando a `https://issues.example.com/browse/PROJ-1234`.

3333 3333

3334<h4 id="badge-constraints">3334<h4 id="badge-constraints">

3335 Restrições de badge3335 Restrições de badge

3916 `wheelScrollAccelerationEnabled`3916 `wheelScrollAccelerationEnabled`

3917</h3>3917</h3>

3918 3918

3919Acelere a velocidade de rolagem da roda do mouse durante rolagens rápidas em [renderização em tela cheia](/docs/pt/fullscreen#mouse-wheel-scrolling). Defina como `false` para uma taxa de rolagem constante por entalhe de roda. Requer Claude Code v2.1.174 ou posterior.3919Acelere a velocidade de rolagem da roda do mouse durante rolagens rápidas em [renderização em tela cheia](/docs/pt/fullscreen#mouse-wheel-scrolling). Defina como `false` para uma taxa de rolagem constante por entalhe de roda.

3920 3920

3921* **Scope**: [`Any file`](#scopes)3921* **Scope**: [`Any file`](#scopes)

3922* **Type**: Boolean3922* **Type**: Boolean

3930}3930}

3931```3931```

3932 3932

3933Requer Claude Code v2.1.174 ou posterior.

~~3934~~

3935<h2 id="git-and-attribution">3933<h2 id="git-and-attribution">

3936 Git e atribuição3934 Git e atribuição

3937</h2>3935</h2>

6156Sob `"merge"`, Claude Code combina cada chave por seu tipo. Esta tabela fornece a regra para cada tipo. As linhas de lista de restrição, valores tomados inteiros e apenas fonte mais alta nomeiam todas as chaves que cobrem, e as outras linhas fornecem exemplos:6154Sob `"merge"`, Claude Code combina cada chave por seu tipo. Esta tabela fornece a regra para cada tipo. As linhas de lista de restrição, valores tomados inteiros e apenas fonte mais alta nomeiam todas as chaves que cobrem, e as outras linhas fornecem exemplos:

6157 6155

6159| :----------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |6157| :----------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

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

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

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

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

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

6166| `env` | [Mescla por variável em fontes de administrador](/docs/pt/managed-settings#keys-read-from-every-admin-source), sob ambos `"first-wins"` e `"merge"` | [`env`](#env) |6164| `env` | [Mescla por variável em fontes de administrador](/docs/pt/managed-settings#keys-read-from-every-admin-source), sob ambos `"first-wins"` e `"merge"` | [`env`](#env) |

6168 6166

6169Pegar `sandbox.credentials.awsPairs` e `sandbox.ripgrep` inteiros requer Claude Code v2.1.257 ou posterior.6167Pegar `sandbox.credentials.awsPairs` e `sandbox.ripgrep` inteiros requer Claude Code v2.1.257 ou posterior.

6170 6168

6171Três dessas chaves adicionam uma condição própria:6169Algumas chaves adicionam uma condição que a tabela não mostra:

6172 6170

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

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

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

6176 6174

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

6178 6176

skills.md +15 −5

Details

169Quando duas skills compartilham um nome, de onde cada uma veio decide qual `/name` executa. A tabela cobre os locais enterprise, personal, project, nested, plugin e claude.ai, skills agrupadas e arquivos de comando:169Quando duas skills compartilham um nome, de onde cada uma veio decide qual `/name` executa. A tabela cobre os locais enterprise, personal, project, nested, plugin e claude.ai, skills agrupadas e arquivos de comando:

170 170

171| Mesmo nome em | Qual executa |171| Mesmo nome em | Qual executa |

172| :---------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |172| :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

173| Dois de enterprise, personal e project | Enterprise sobre personal, e personal sobre project. Com `deploy` em ambos `~/.claude/skills/` e `.claude/skills/` do projeto, `/deploy` executa a pessoal |173| Dois de enterprise, personal e project | Enterprise sobre personal, e personal sobre project. Com `deploy` em ambos `~/.claude/skills/` e `.claude/skills/` do projeto, `/deploy` executa a pessoal |

174| Qualquer um desses locais e uma [skill agrupada](#bundled-skills) | Sua skill substitui o comando agrupado, mas não seus aliases. Uma skill `code-review` de projeto substitui `/code-review`, e o alias agrupado `/review` nunca executa sua skill |174| Qualquer um desses locais e uma [skill agrupada](#bundled-skills) | Sua skill substitui o comando agrupado, mas não seus aliases. Uma skill `code-review` de projeto substitui `/code-review`, e o alias agrupado `/review` nunca executa sua skill |

176| Uma skill raiz de projeto e uma skill aninhada | Ambas carregam. Veja [monorepos e subdiretórios](#discovery-from-parent-and-nested-directories) |176| Uma skill raiz de projeto e uma skill aninhada | Ambas carregam. Veja [monorepos e subdiretórios](#discovery-from-parent-and-nested-directories) |

177| Uma skill de plugin e uma skill em qualquer um dos locais acima | Ambas carregam, porque skills de plugin são nomeadas como `/plugin-name:skill-name` |177| Uma skill de plugin e uma skill em qualquer um dos locais acima | Ambas carregam, porque skills de plugin são nomeadas como `/plugin-name:skill-name` |

178| Qualquer um dos acima e uma skill sincronizada do claude.ai | A outra skill ou comando. Veja [Quando um nome de skill sincronizada corresponde a outro comando](#when-a-synced-skill-name-matches-another-command) |178| Qualquer um dos acima e uma skill [sincronizada do seu claude.ai](#how-synced-skills-behave) | A outra skill ou comando. A skill sincronizada ainda executa como `/anthropic-skills:<name>`. Veja [Quando um nome de skill sincronizada corresponde a outro comando](#when-a-synced-skill-name-matches-another-command) |

179 179

180<h3 id="skills-in-cowork-and-cloud-sessions">180<h3 id="skills-in-cowork-and-cloud-sessions">

181 Use skills em sessões Cowork e cloud181 Use skills em sessões Cowork e cloud

230 Quando um nome de skill sincronizada corresponde a outro comando230 Quando um nome de skill sincronizada corresponde a outro comando

231</h4>231</h4>

232 232

233Claude Code pula uma skill sincronizada cujo nome corresponde a qualquer outro comando, e esse outro comando executa. O outro comando pode ser um comando integrado, uma [skill agrupada](#bundled-skills), uma skill em qualquer [nível local](#where-skills-live), uma skill de plugin, um arquivo em `.claude/commands/`, ou um [prompt MCP](/docs/pt/mcp#use-mcp-prompts-as-commands). Claude Code também reserva os nomes de seus próprios comandos integrados e skills agrupadas mesmo quando não estão disponíveis em sua sessão, por exemplo após você desativar skills agrupadas, então pula uma skill sincronizada com um desses nomes também.233Você pode invocar uma skill sincronizada pelo seu nome completo, `/anthropic-skills:<name>`, ou pelo seu nome curto, `/<name>`. Quando outro comando usa esse nome curto, `/<name>` executa o outro comando, e a skill sincronizada executa apenas como `/anthropic-skills:<name>`. Com uma skill `deploy` local e uma `deploy` sincronizada, `/deploy` executa a skill local e `/anthropic-skills:deploy` executa a sincronizada. Antes da v2.1.269, uma skill sincronizada tinha apenas seu nome curto.

234

235O outro comando pode ser qualquer um destes:

236

237* Um comando integrado ou uma [skill agrupada](#bundled-skills), incluindo uma que não está disponível em sua sessão, por exemplo após você desativar skills agrupadas

238* Uma skill em qualquer [nível local](#where-skills-live) ou um arquivo em `.claude/commands/`

239* Uma skill de plugin

240* Um [prompt MCP](/docs/pt/mcp#use-mcp-prompts-as-commands)

234 241

235Claude Code rotula skills sincronizadas para que você possa dizer de onde vieram. O menu `/skills` e `/context` agrupam skills sincronizadas em `claude.ai sync`, e o menu de comando `/` as marca como vindo do claude.ai.242Claude Code rotula skills sincronizadas para que você possa dizer de onde vieram. O menu `/skills` e `/context` agrupam skills sincronizadas em `claude.ai sync`, e o menu de comando `/` as marca como vindo do claude.ai.

236 243

237Quando compara nomes, Claude Code ignora maiúsculas, espaçamento e caracteres invisíveis, e trata formas de compatibilidade como letras de largura completa e variantes de travessão como seus equivalentes simples, então um `Commit` sincronizado não pode carregar ao lado de um `commit` local. Um nome que difere apenas por uma letra semelhante de outro alfabeto conta como um nome diferente, e o rótulo `claude.ai sync` é como você diferencia os dois. Essas verificações e rótulos requerem Claude Code v2.1.228 ou posterior.244Quando compara nomes, Claude Code ignora maiúsculas, espaçamento e caracteres invisíveis, e trata formas de compatibilidade como letras de largura completa e variantes de travessão como seus equivalentes simples. Por exemplo, uma skill `commit` local mantém `/commit`, e uma `Commit` sincronizada executa apenas como `/anthropic-skills:Commit`.

245

246Um nome que difere apenas por uma letra semelhante de outro alfabeto conta como um nome diferente, e o rótulo `claude.ai sync` é como você diferencia os dois. Essas verificações e rótulos requerem Claude Code v2.1.228 ou posterior.

238 247

239<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">248<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">

240 Como Claude Code lida com o frontmatter de uma skill sincronizada249 Como Claude Code lida com o frontmatter de uma skill sincronizada

404| Arquivo em um subdiretório de `.claude/commands/` | Caminho do subdiretório relativo a `commands/` com cada `/` substituído por `:`, depois o nome do arquivo sem extensão | `.claude/commands/frontend/component.md` → `/frontend:component` |413| Arquivo em um subdiretório de `.claude/commands/` | Caminho do subdiretório relativo a `commands/` com cada `/` substituído por `:`, depois o nome do arquivo sem extensão | `.claude/commands/frontend/component.md` → `/frontend:component` |

405| Subdiretório `skills/` do plugin | Frontmatter `name` ou o nome do diretório, com namespace pelo plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`, ou `/my-plugin:fancy` com `name: fancy` |414| Subdiretório `skills/` do plugin | Frontmatter `name` ou o nome do diretório, com namespace pelo plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`, ou `/my-plugin:fancy` com `name: fancy` |

406| `SKILL.md` raiz do plugin | Frontmatter `name`, com o nome do diretório do plugin como fallback | `my-plugin/SKILL.md` com `name: review` → `/my-plugin:review`. Veja [Regras de comportamento de caminho](/docs/pt/plugins-reference#path-behavior-rules) |415| `SKILL.md` raiz do plugin | Frontmatter `name`, com o nome do diretório do plugin como fallback | `my-plugin/SKILL.md` com `name: review` → `/my-plugin:review`. Veja [Regras de comportamento de caminho](/docs/pt/plugins-reference#path-behavior-rules) |

416| Skill [sincronizada do claude.ai](#how-synced-skills-behave) | O nome da skill em sua conta claude.ai, prefixado com `anthropic-skills:` | Skill de conta `deploy` → `/anthropic-skills:deploy`, ou `/deploy` enquanto nenhum outro comando usa esse nome |

407 417

408Em uma skill de plugin, o frontmatter `name` substitui o nome do diretório no último segmento do comando, então `my-plugin/skills/review/SKILL.md` com `name: fancy` se torna `/my-plugin:fancy`. O comando `/fancy` simples também invoca a skill a menos que outro comando já use esse nome. Se o `name` que você escreve já começa com o próprio prefixo do plugin, Claude Code não adiciona o prefixo novamente na v2.1.246 ou posterior. Por exemplo, `name: my-plugin:fancy` ainda se torna `/my-plugin:fancy`. Da v2.1.216 até v2.1.245, Claude Code duplicava o prefixo quando o `name` já o carregava.418Em uma skill de plugin, o frontmatter `name` substitui o nome do diretório no último segmento do comando, então `my-plugin/skills/review/SKILL.md` com `name: fancy` se torna `/my-plugin:fancy`. O comando `/fancy` simples também invoca a skill a menos que outro comando já use esse nome. Se o `name` que você escreve já começa com o próprio prefixo do plugin, Claude Code não adiciona o prefixo novamente na v2.1.246 ou posterior. Por exemplo, `name: my-plugin:fancy` ainda se torna `/my-plugin:fancy`. Da v2.1.216 até v2.1.245, Claude Code duplicava o prefixo quando o `name` já o carregava.

409 419

410Em [sessões não-interativas](/docs/pt/headless), os nomes `help` e `feedback` não são reservados para seus comandos built-in apenas de terminal, então uma skill de plugin com um desses nomes mantém seu comando simples lá. Todos os outros built-ins apenas de terminal, como `/login`, permanecem reservados mesmo que o comando não possa ser executado nessas sessões. Uma skill sincronizada chamada `help` ou `feedback` ainda é pulada lá, porque Claude Code [pula uma skill sincronizada](#when-a-synced-skill-name-matches-another-command) cujo nome corresponde a qualquer comando built-in, independentemente de esse comando poder ser executado.420Em [sessões não-interativas](/docs/pt/headless), os nomes `help` e `feedback` não são reservados para seus comandos built-in apenas de terminal, então uma skill de plugin com um desses nomes mantém seu comando simples lá. Todos os outros built-ins apenas de terminal, como `/login`, permanecem reservados mesmo que o comando não possa ser executado nessas sessões.

411 421

412Para um `SKILL.md` raiz de plugin, não há diretório de skill para obter o nome, então `name` fornece o segmento final inteiro. Sem um campo `name`, Claude Code volta para o nome do diretório do plugin.422Para um `SKILL.md` raiz de plugin, não há diretório de skill para obter o nome, então `name` fornece o segmento final inteiro. Sem um campo `name`, Claude Code volta para o nome do diretório do plugin.

413 423

terminal-config.md +4 −3

Details

27Na maioria dos terminais você também pode pressionar Shift+Enter, mas o suporte varia de acordo com o emulador de terminal:27Na maioria dos terminais você também pode pressionar Shift+Enter, mas o suporte varia de acordo com o emulador de terminal:

28 28

29| Terminal | Shift+Enter para nova linha |29| Terminal | Shift+Enter para nova linha |

~~30| :---------------------------------------------------------------------- | :--------------------------------------------- |~~30| :-------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------ |

31| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Funciona sem configuração |31| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Funciona sem configuração |

~~32| VS Code, Cursor, Devin Desktop, Alacritty, Zed | Execute `/terminal-setup` uma vez |~~32| Outros terminais que suportam o protocolo de teclado kitty, como foot e Alacritty 0.16 ou posterior | Funciona sem configuração. Requer Claude Code v2.1.269 ou posterior |

33| VS Code, Cursor, Devin Desktop, Alacritty anterior a 0.16, Zed | Execute `/terminal-setup` uma vez |

33| gnome-terminal, JetBrains IDEs como PyCharm e Android Studio | Não disponível; use Ctrl+J ou `\` depois Enter |34| gnome-terminal, JetBrains IDEs como PyCharm e Android Studio | Não disponível; use Ctrl+J ou `\` depois Enter |

34 35

35Para VS Code, Cursor, Devin Desktop, Alacritty e Zed, `/terminal-setup` escreve um atalho de teclado Shift+Enter no arquivo de configuração do terminal. Na primeira execução você vê uma confirmação como `Installed VSCode terminal Shift+Enter key binding`. Os bindings existentes são mantidos no lugar; se você vir uma mensagem como `VSCode terminal Shift+Enter key binding already configured`, nenhuma alteração foi feita. Execute `/terminal-setup` diretamente no terminal do host em vez de dentro de tmux ou screen, pois ele precisa escrever na configuração do terminal do host.36Para VS Code, Cursor, Devin Desktop, Alacritty anterior a 0.16 e Zed, `/terminal-setup` escreve um atalho de teclado Shift+Enter no arquivo de configuração do terminal. Na primeira execução você vê uma confirmação como `Installed VSCode terminal Shift+Enter key binding`. Os bindings existentes são mantidos no lugar; se você vir uma mensagem como `VSCode terminal Shift+Enter key binding already configured`, nenhuma alteração foi feita. Execute `/terminal-setup` diretamente no terminal do host em vez de dentro de tmux ou screen, pois ele precisa escrever na configuração do terminal do host.

36 37

37No VS Code, Cursor e Devin Desktop, `/terminal-setup` também atualiza duas configurações do editor: define `terminal.integrated.gpuAcceleration` para `"off"` para evitar texto distorcido no terminal integrado, e define `terminal.integrated.mouseWheelScrollSensitivity` para rolagem mais suave no [modo tela cheia](/docs/pt/fullscreen). Para desfazer a alteração de aceleração de GPU, defina-a de volta para `"auto"` e recarregue a janela do editor.38No VS Code, Cursor e Devin Desktop, `/terminal-setup` também atualiza duas configurações do editor: define `terminal.integrated.gpuAcceleration` para `"off"` para evitar texto distorcido no terminal integrado, e define `terminal.integrated.mouseWheelScrollSensitivity` para rolagem mais suave no [modo tela cheia](/docs/pt/fullscreen). Para desfazer a alteração de aceleração de GPU, defina-a de volta para `"auto"` e recarregue a janela do editor.

38 39

troubleshoot-install.md +1 −29

Details

417 417

418O comando `curl ... | bash` baixa o script e o encanua para Bash para execução. Este erro, e o relacionado `curl: (23) Failure writing output to destination`, significa que Bash não recebeu o script completo. O código de saída 56 indica que o download em si foi interrompido, e o código de saída 23 indica que curl não conseguiu escrever o que recebeu para o pipe, geralmente porque Bash saiu cedo.418O comando `curl ... | bash` baixa o script e o encanua para Bash para execução. Este erro, e o relacionado `curl: (23) Failure writing output to destination`, significa que Bash não recebeu o script completo. O código de saída 56 indica que o download em si foi interrompido, e o código de saída 23 indica que curl não conseguiu escrever o que recebeu para o pipe, geralmente porque Bash saiu cedo.

419 419

420**Soluções:**420Teste se você consegue alcançar `downloads.claude.ai` com a verificação em [Check network connectivity](#check-network-connectivity). Se você alcançou o servidor, a falha original foi provavelmente intermitente; tente novamente o comando de instalação. Você também pode [tentar um método de instalação alternativo](/docs/pt/setup#install-claude-code).

~~421~~

4221. **Verifique a estabilidade da rede**: Os binários do Claude Code são hospedados em `downloads.claude.ai`. Teste se você consegue alcançá-lo:

~~423~~

424 ```bash theme={null}

425 curl -sI https://downloads.claude.ai/claude-code-releases/latest

426 ```

~~427~~

428 Uma linha `HTTP/2 200` significa que você alcançou o servidor e a falha original foi provavelmente intermitente; tente novamente o comando de instalação. Outros resultados apontam para a causa:

~~429~~

430 * `403`: geralmente um proxy ou filtro de rede bloqueando o host, ou Claude Code [não está disponível em sua região](https://www.anthropic.com/supported-countries)

431 * `5xx`: geralmente um problema temporário de serviço; aguarde alguns minutos e tente novamente

432 * `Could not resolve host` ou um tempo limite de conexão: sua rede está bloqueando o download

~~433~~

4342. **Tente um método de instalação alternativo**:

~~435~~

436 No macOS:

~~437~~

438 ```bash theme={null}

439 brew install --cask claude-code

440 ```

~~441~~

442 No Windows:

~~443~~

444 ```powershell theme={null}

445 winget install Anthropic.ClaudeCode

446 ```

~~447~~

448 Depois execute `claude --version` para confirmar: o comando imprime um número de versão como `2.1.211 (Claude Code)`. Se o shell relatar que `claude` não foi encontrado, abra uma nova janela de terminal e tente novamente: a sessão em que você instalou mantém seu antigo `PATH`.

449 421

450<h3 id="homebrew-cask-unavailable-or-outdated">422<h3 id="homebrew-cask-unavailable-or-outdated">

451 Homebrew cask unavailable or outdated423 Homebrew cask unavailable or outdated

vs-code.md +21 −14

Details

58 58

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

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

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

62 62

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

64 </Step>64 </Step>

116 * Select **Output styles** in the Customize section to pick an [output style](/docs/pt/output-styles), including your custom styles. Requires Claude Code v2.1.257 or later.116 * Select **Output styles** in the Customize section to pick an [output style](/docs/pt/output-styles), including your custom styles. Requires Claude Code v2.1.257 or later.

117 117

118 To create a custom style instead, select **Build a custom style** from the **Output styles** menu. Claude Code writes the [style file](/docs/pt/output-styles#create-a-custom-output-style) for you at the project or user level. Requires Claude Code v2.1.261 or later.118 To create a custom style instead, select **Build a custom style** from the **Output styles** menu. Claude Code writes the [style file](/docs/pt/output-styles#create-a-custom-output-style) for you at the project or user level. Requires Claude Code v2.1.261 or later.

119 * Select **Hooks** in the Customize section to view the [hooks](/docs/pt/hooks) loaded in the session, grouped by event. You can add, edit, or remove hooks saved in your user, project, and local settings files. Hooks from other sources, such as managed settings or plugins, are read-only. Requires Claude Code v2.1.269 or later.

120 * Select **Permissions** in the Customize section to view the session's [permission rules](/docs/pt/permissions), grouped into Allow, Ask, and Deny. You can add rules to your user, project, or local settings and remove rules saved there. Rules from other sources, such as managed settings or approvals made for this session only, are read-only. Requires Claude Code v2.1.269 or later.

119 * The Settings section includes **Enable Remote Control for all sessions**, which sets [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) to control whether [new interactive sessions connect to Remote Control automatically](/docs/pt/remote-control#enable-remote-control-for-all-sessions). Requires Claude Code v2.1.203 or later.121 * The Settings section includes **Enable Remote Control for all sessions**, which sets [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) to control whether [new interactive sessions connect to Remote Control automatically](/docs/pt/remote-control#enable-remote-control-for-all-sessions). Requires Claude Code v2.1.203 or later.

120 122

121 When you turn the toggle on or off in a VS Code window, the change applies to the sessions already open in that VS Code window, not only to sessions you start afterwards. If you turn it off, the open sessions disconnect. With Claude Code v2.1.261 or later, the change also reaches sessions open in your other VS Code windows.123 When you turn the toggle on or off in a VS Code window, the change applies to the sessions already open in that VS Code window, not only to sessions you start afterwards. If you turn it off, the open sessions disconnect. With Claude Code v2.1.261 or later, the change also reaches sessions open in your other VS Code windows.

122 * The Settings section also includes **Focus view**, which hides tool calls, tool results, and thinking behind expandable rows, leaving your prompts and Claude's responses. Claude's latest to-do list stays visible, and so does the text a pending question from Claude is asking about; this requires Claude Code v2.1.225 or later. Toggle it there, with `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), or from the Command Palette with **Claude Code: Toggle Focus view**. The change applies to every open session and persists across sessions. Requires Claude Code v2.1.221 or later.124 * The Settings section also includes **Focus view**, which hides tool calls, tool results, and thinking behind expandable rows, leaving your prompts and Claude's responses. Toggle it there, with `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), or from the Command Palette with **Claude Code: Toggle Focus view**. The change applies to every open session and persists across sessions. Requires Claude Code v2.1.221 or later.

125

126 Claude's latest to-do list stays visible, and so does the text a pending question from Claude is asking about; this requires Claude Code v2.1.225 or later. While Claude runs [subagents](/docs/pt/sub-agents), live progress rows with their latest activity appear under the tool-call group that started them. This requires Claude Code v2.1.269 or later.

123 * To report a bug, click **Report a problem** at the bottom of the menu, or type `/bug` or `/feedback` with an optional description that prefills the report. When you submit the report and you're signed in to Anthropic on a first-party connection, Claude Code sends it to Anthropic. On a third-party provider, or without Anthropic credentials, the dialog still opens, but submitting shows an error and sends nothing: unlike the CLI's `/bug`, the extension doesn't write a local archive. Requires Claude Code v2.1.229 or later.127 * To report a bug, click **Report a problem** at the bottom of the menu, or type `/bug` or `/feedback` with an optional description that prefills the report. When you submit the report and you're signed in to Anthropic on a first-party connection, Claude Code sends it to Anthropic. On a third-party provider, or without Anthropic credentials, the dialog still opens, but submitting shows an error and sends nothing: unlike the CLI's `/bug`, the extension doesn't write a local archive. Requires Claude Code v2.1.229 or later.

124* **Side questions**: type `/btw` followed by a question to ask about your session [without adding to the conversation](/docs/pt/interactive-mode#side-questions-with-%2Fbtw). The answer opens in a panel beside the chat, where you can ask follow-up questions. The thread survives window reloads. Claude Code keeps the newest 20 exchanges and expires stored threads on the [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) schedule, as long as Claude Code can [safely determine the retention period](/docs/pt/claude-directory#cleaned-up-automatically). To clear a thread, click the trash icon in the panel. Requires Claude Code v2.1.227 or later.128* **Side questions**: type `/btw` followed by a question to ask about your session [without adding to the conversation](/docs/pt/interactive-mode#side-questions-with-%2Fbtw). The answer opens in a panel beside the chat, where you can ask follow-up questions. The thread survives window reloads. Claude Code keeps the newest 20 exchanges and expires stored threads on the [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) schedule, as long as Claude Code can [safely determine the retention period](/docs/pt/claude-directory#cleaned-up-automatically). To clear a thread, click the trash icon in the panel. Requires Claude Code v2.1.227 or later.

125* **Context indicator**: the prompt box shows how much of Claude's context window you're using. Claude automatically compacts when needed, or you can run `/compact` manually.129* **Context indicator**: the prompt box shows how much of Claude's context window you're using. Claude automatically compacts when needed, or you can run `/compact` manually.

130* **Agent map**: when the conversation includes [subagents](/docs/pt/sub-agents), an agent count such as **2 agents** appears at the bottom of the prompt box. Its dot shows whether any subagent is working or waiting for your permission.

131

132 Click the agent count to open the agent map, which draws the conversation's subagents as a tree under the main agent, each with its status, elapsed time, and token count. Click a subagent to see its prompt and tool calls, open its read-only transcript, or stop it while it runs. Requires Claude Code v2.1.269 or later.

126* **Extended thinking**: lets Claude spend more time reasoning through complex problems. Toggle it on via the command menu (`/`). Claude's reasoning appears in the conversation as collapsed blocks: click a block to read it, or press `Ctrl+O` to expand or collapse every thinking block in the session. See [Extended thinking](/docs/pt/model-config#extended-thinking) for details.133* **Extended thinking**: lets Claude spend more time reasoning through complex problems. Toggle it on via the command menu (`/`). Claude's reasoning appears in the conversation as collapsed blocks: click a block to read it, or press `Ctrl+O` to expand or collapse every thinking block in the session. See [Extended thinking](/docs/pt/model-config#extended-thinking) for details.

127* **Multi-line input**: press `Shift+Enter` to add a new line without sending. This also works in the "Other" free-text input of question dialogs.134* **Multi-line input**: press `Shift+Enter` to add a new line without sending. This also works in the "Other" free-text input of question dialogs.

128 135

139 146

140For large PDFs, you can ask Claude to read specific pages instead of the whole file: a single page, a range like pages 1-10, or an open-ended range like page 3 onward.147For large PDFs, you can ask Claude to read specific pages instead of the whole file: a single page, a range like pages 1-10, or an open-ended range like page 3 onward.

141 148

142When you select text in the editor, Claude can see your highlighted code automatically. The prompt box footer shows how many lines are selected. Press `Option+K` (Mac) / `Alt+K` (Windows/Linux) to insert an @-mention with the file path and line numbers (e.g., `@app.ts#5-10`). Click the selection indicator to toggle whether Claude can see your highlighted text - the eye-slash icon means the selection is hidden from Claude.149When you select text in the editor, Claude can see your highlighted code automatically. The prompt box footer shows how many lines are selected. Press `Option+K` (Mac) / `Alt+K` (Windows/Linux) to insert an @-mention with the file path and line numbers (e.g., `@app.ts#5-10`). Click the **X** on the selection indicator to remove it so Claude doesn't receive the selection. The indicator comes back when you select other text or switch to a different file.

143 150

144To attach an image, paste it from your clipboard into the prompt box. You can also hold `Shift` while dragging files into the prompt box to add them as attachments. Click the X on any attachment to remove it from context.151To attach an image, paste it from your clipboard into the prompt box. You can also hold `Shift` while dragging files into the prompt box to add them as attachments. Click the X on any attachment to remove it from context.

145 152

193 200

194Run `/usage` to open the Account & usage dialog. The dialog requires a claude.ai sign-in, so it isn't offered on a [third-party provider](#use-third-party-providers). It shows your signed-in account, your plan, and usage bars for your plan's limits, such as the current session and the week. Each bar shows how long until its limit resets.201Run `/usage` to open the Account & usage dialog. The dialog requires a claude.ai sign-in, so it isn't offered on a [third-party provider](#use-third-party-providers). It shows your signed-in account, your plan, and usage bars for your plan's limits, such as the current session and the week. Each bar shows how long until its limit resets.

195 202

196The dialog also breaks down what is contributing to your plan limits. It flags behaviors that account for 10% or more of recent usage, such as cache misses, long context, and subagent-heavy or highly parallel sessions, each with a tip to reduce it. Attribution tables show how much usage came from each skill, subagent, plugin, and MCP server. Requires Claude Code v2.1.174 or later.203The dialog also breaks down what is contributing to your plan limits. It flags behaviors that account for 10% or more of recent usage, such as cache misses, long context, and subagent-heavy or highly parallel sessions, each with a tip to reduce it. Attribution tables show how much usage came from each skill, subagent, plugin, and MCP server.

197 204

198Use the Day and Week toggle to switch between the last 24 hours and the last 7 days. The figures are approximate and computed from local sessions on this machine, so usage from other devices or claude.ai is not included. For more on tracking and reducing usage, see [Track your costs](/docs/pt/costs#track-your-costs).205Use the Day and Week toggle to switch between the last 24 hours and the last 7 days. The figures are approximate and computed from local sessions on this machine, so usage from other devices or claude.ai is not included. For more on tracking and reducing usage, see [Track your costs](/docs/pt/costs#track-your-costs).

199 206

238 245

239* **Agrupar ou desagrupar uma sessão**: clique com o botão direito em uma sessão para criar um grupo a partir dela, movê-la para um grupo existente ou removê-la de seu grupo. Cada sessão pertence a um grupo por vez, então movê-la para outro grupo a remove do primeiro.246* **Agrupar ou desagrupar uma sessão**: clique com o botão direito em uma sessão para criar um grupo a partir dela, movê-la para um grupo existente ou removê-la de seu grupo. Cada sessão pertence a um grupo por vez, então movê-la para outro grupo a remove do primeiro.

240* **Mover várias sessões de uma vez**: `Cmd`-clique (Mac) / `Ctrl`-clique (Windows/Linux) em cada sessão, ou `Shift`-clique para selecionar um intervalo, depois clique com o botão direito na seleção.247* **Mover várias sessões de uma vez**: `Cmd`-clique (Mac) / `Ctrl`-clique (Windows/Linux) em cada sessão, ou `Shift`-clique para selecionar um intervalo, depois clique com o botão direito na seleção.

241* **Agrupar uma sessão a partir de sua aba**: execute **Claude Code: Add Session Tab to Group** da Paleta de Comandos, ou clique com o botão direito na aba do editor da sessão, depois escolha ou crie um grupo. Requer Claude Code v2.1.257 ou posterior.248* **Agrupar uma sessão a partir de sua aba**: execute **Claude Code: Add Session Tab to Group** da Paleta de Comandos, depois escolha ou crie um grupo. Requer Claude Code v2.1.257 ou posterior.

242* **Renomear ou excluir um grupo**: clique com o botão direito em um cabeçalho de grupo. Excluir um grupo remove apenas o grupo, e suas sessões retornam à lista desagrupada.249* **Renomear ou excluir um grupo**: clique com o botão direito em um cabeçalho de grupo. Excluir um grupo remove apenas o grupo, e suas sessões retornam à lista desagrupada.

243 250

244A extensão salva grupos por pasta de workspace, então eles sobrevivem a recarregamentos de janela e aparecem em cada janela onde você abre a mesma pasta. Quando você pesquisa a lista, a extensão mostra correspondências em uma lista plana única em todos os grupos.251A extensão salva grupos por pasta de workspace, então eles sobrevivem a recarregamentos de janela e aparecem em cada janela onde você abre a mesma pasta. Quando você pesquisa a lista, a extensão mostra correspondências em uma lista plana única em todos os grupos.

359| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Reabrir a aba de sessão do Claude fechada mais recentemente. Volta para a reabertura normal de editor fechado do VS Code quando a última aba fechada não era uma sessão do Claude. Desabilitar com `enableReopenClosedSessionShortcut` |366| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Reabrir a aba de sessão do Claude fechada mais recentemente. Volta para a reabertura normal de editor fechado do VS Code quando a última aba fechada não era uma sessão do Claude. Desabilitar com `enableReopenClosedSessionShortcut` |

361| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Ocultar ou mostrar atividade de ferramenta na conversa. Funciona enquanto um painel ou barra lateral do Claude está visível. Requer Claude Code v2.1.221 ou posterior |368| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Ocultar ou mostrar atividade de ferramenta na conversa. Funciona enquanto um painel ou barra lateral do Claude está visível. Requer Claude Code v2.1.221 ou posterior |

362| Rename Session Tab | - | Renomear a sessão na aba ativa do Claude. O comando também aparece no menu de clique direito da aba. Requer Claude Code v2.1.257 ou posterior |369| Rename Session Tab | - | Renomear a sessão na aba ativa do Claude. Requer Claude Code v2.1.257 ou posterior |

363| Add Session Tab to Group | - | Adicionar a sessão na aba ativa do Claude a um [grupo de sessão](#organize-sessions-into-groups) que você escolher ou criar. O comando também aparece no menu de clique direito da aba. Requer Claude Code v2.1.257 ou posterior |370| Add Session Tab to Group | - | Adicionar a sessão na aba ativa do Claude a um [grupo de sessão](#organize-sessions-into-groups) que você escolher ou criar. Requer Claude Code v2.1.257 ou posterior |

364| Mark Session as Unread | - | Marcar a sessão na aba ativa do Claude como não lida na lista de sessões. O comando também aparece no menu de clique direito da aba. Requer Claude Code v2.1.257 ou posterior |371| Mark Session as Unread | - | Marcar a sessão na aba ativa do Claude como não lida na lista de sessões. Requer Claude Code v2.1.257 ou posterior |

365| Show Logs | - | Visualizar logs de depuração da extensão |372| Show Logs | - | Visualizar logs de depuração da extensão |

366| Logout | - | Sair da sua conta Anthropic |373| Logout | - | Sair da sua conta Anthropic |

367 374

424 431

425A extensão tem dois tipos de configurações:432A extensão tem dois tipos de configurações:

426 433

427* **Configurações da extensão** no VS Code: controlam o comportamento da extensão dentro do VS Code. Abra com `Cmd+,` (Mac) ou `Ctrl+,` (Windows/Linux), depois vá para Extensões → Claude Code. Você também pode digitar `/` e selecionar **General Config** para abrir as configurações.434* **Configurações da extensão** no VS Code: controlam o comportamento da extensão dentro do VS Code. Abra com `Cmd+,` (Mac) ou `Ctrl+,` (Windows/Linux), depois vá para Extensões → Claude Code. Você também pode digitar `/` e selecionar **General config…** para abrir as configurações.

428* **Configurações do Claude Code** em `~/.claude/settings.json`: compartilhadas entre a extensão e CLI. Use-a para comandos permitidos, variáveis de ambiente, hooks e servidores MCP. Nos planos Pro, Max e Team, também é uma entrada para o modo de permissão em que as conversas começam. [Switch permission modes](/docs/pt/permission-modes#switch-permission-modes) lista a ordem. Veja [Settings](/docs/pt/settings) para detalhes.435* **Configurações do Claude Code** em `~/.claude/settings.json`: compartilhadas entre a extensão e CLI. Use-a para comandos permitidos, variáveis de ambiente, hooks e servidores MCP. Nos planos Pro, Max e Team, também é uma entrada para o modo de permissão em que as conversas começam. [Switch permission modes](/docs/pt/permission-modes#switch-permission-modes) lista a ordem. Veja [Settings](/docs/pt/settings) para detalhes.

429 436

430<Tip>437<Tip>

640</h2>647</h2>

641 648

642<h3 id="extension-won’t-install">649<h3 id="extension-won’t-install">

643 A extensão não será instalada650 A extensão não é instalada

644</h3>651</h3>

645 652

646* Certifique-se de que você tem uma versão compatível do VS Code (1.94.0 ou posterior)653* Certifique-se de que você tem uma versão compatível do VS Code (1.94.0 ou posterior)

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

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

661 668

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

663 670

664<h3 id="cmd-esc-does-nothing-on-macos">671<h3 id="cmd-esc-does-nothing-on-macos">

665 Cmd+Esc não faz nada no macOS672 Cmd+Esc não faz nada no macOS

666</h3>673</h3>

667 674

668No macOS Tahoe e posterior, o atalho de teclado do Game Overlay do sistema está vinculado a `Cmd+Esc` por padrão e intercepta a tecla antes que chegue ao VS Code. Para liberar o atalho:675No macOS Tahoe e posterior, o atalho do sistema Game Overlay está vinculado a `Cmd+Esc` por padrão e intercepta a tecla antes que ela chegue ao VS Code. Para liberar o atalho:

669 676

6701. Abra Configurações do Sistema6771. Abra System Settings

6712. Vá para Keyboard, depois Keyboard Shortcuts, depois Game Controllers6782. Vá para Keyboard, depois Keyboard Shortcuts, depois Game Controllers

6723. Desmarque a caixa de seleção Game Overlay6793. Desmarque a caixa de seleção Game Overlay

673 680

677 Claude Code nunca responde684 Claude Code nunca responde

678</h3>685</h3>

679 686

680Se Claude Code não estiver respondendo aos seus prompts:687Se Claude Code não está respondendo aos seus prompts:

681 688

6821. **Verifique sua conexão com a internet**: Certifique-se de que você tem uma conexão com a internet estável6891. **Verifique sua conexão com a internet**: Certifique-se de que você tem uma conexão com a internet estável

6832. **Inicie uma nova conversa**: Tente iniciar uma conversa nova para ver se o problema persiste6902. **Inicie uma nova conversa**: Tente iniciar uma conversa nova para ver se o problema persiste

web-quickstart.md +1 −1

Details

93 Conecte do seu terminal93 Conecte do seu terminal

94</h3>94</h3>

95 95

96Se você já usa a CLI do GitHub (`gh`), você pode configurar Claude Code na web sem abrir um navegador. Isso requer a [CLI do Claude Code](/docs/pt/quickstart). Em planos Team e Enterprise, `/web-setup` está disponível apenas após um Owner ativar [Quick web setup](/docs/pt/claude-code-on-the-web#github-authentication-options).96Se você já usa a CLI do GitHub (`gh`), você pode configurar Claude Code na web do seu terminal. Isso requer a [CLI do Claude Code](/docs/pt/quickstart). Em planos Team e Enterprise, `/web-setup` está disponível apenas após um Owner ativar [Quick web setup](/docs/pt/claude-code-on-the-web#github-authentication-options).

97 97

98Quando você executa `/web-setup`, Claude Code lê o token que `gh auth token` imprime, pede que você confirme e envia o token para Anthropic. Anthropic o armazena criptografado com sua conta claude.ai, e suas sessões em nuvem o usam para acesso ao GitHub até você [removê-lo](#remove-the-web-setup-token). Uma sessão em nuvem pode então acessar qualquer repositório que esse token possa acessar, sem nenhuma instalação do Claude GitHub App.98Quando você executa `/web-setup`, Claude Code lê o token que `gh auth token` imprime, pede que você confirme e envia o token para Anthropic. Anthropic o armazena criptografado com sua conta claude.ai, e suas sessões em nuvem o usam para acesso ao GitHub até você [removê-lo](#remove-the-web-setup-token). Uma sessão em nuvem pode então acessar qualquer repositório que esse token possa acessar, sem nenhuma instalação do Claude GitHub App.

99 99

worktrees.md +1 −1

Details

9Uma [git worktree](https://git-scm.com/docs/git-worktree) é um diretório de trabalho separado com seus próprios arquivos e branch, compartilhando o mesmo histórico de repositório e remoto que seu checkout principal. Executar cada sessão do Claude Code em sua própria worktree significa que edições em uma sessão nunca tocam arquivos em outra, para que uma sessão possa construir um recurso enquanto uma segunda corrige um bug.9Uma [git worktree](https://git-scm.com/docs/git-worktree) é um diretório de trabalho separado com seus próprios arquivos e branch, compartilhando o mesmo histórico de repositório e remoto que seu checkout principal. Executar cada sessão do Claude Code em sua própria worktree significa que edições em uma sessão nunca tocam arquivos em outra, para que uma sessão possa construir um recurso enquanto uma segunda corrige um bug.

10 10

11<Note>11<Note>

12 Worktrees exigem um repositório git; para outros sistemas de controle de versão, [configure hooks para substituir a lógica git](#non-git-version-control). No [aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions), cada nova sessão obtém sua própria worktree automaticamente.12 Worktrees exigem um repositório git; para outros sistemas de controle de versão, [configure hooks para substituir a lógica git](#non-git-version-control). No [aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions), selecione a opção **worktree** quando você iniciar uma sessão para dar a ela sua própria worktree.

13</Note>13</Note>

14 14

15Worktrees são uma das várias maneiras de executar Claude em paralelo. Elas isolam edições de arquivo. [Subagentes](/docs/pt/sub-agents) dividem o trabalho dentro de uma sessão, e [mensagens entre sessões](/docs/pt/cross-session-messaging) permitem que Claude passe descobertas entre as sessões em suas worktrees. Consulte [Executar agentes em paralelo](/docs/pt/agents) para comparar as abordagens, ou pule para [Isolar subagentes com worktrees](#isolate-subagents-with-worktrees) para usar worktrees e subagentes juntos.15Worktrees são uma das várias maneiras de executar Claude em paralelo. Elas isolam edições de arquivo. [Subagentes](/docs/pt/sub-agents) dividem o trabalho dentro de uma sessão, e [mensagens entre sessões](/docs/pt/cross-session-messaging) permitem que Claude passe descobertas entre as sessões em suas worktrees. Consulte [Executar agentes em paralelo](/docs/pt/agents) para comparar as abordagens, ou pule para [Isolar subagentes com worktrees](#isolate-subagents-with-worktrees) para usar worktrees e subagentes juntos.

Documentation 2026-09-13 21:00 UTC to 2026-09-14 22:58 UTC