SpyBara
Go Premium

Documentation 2026-08-03 20:02 UTC to 2026-08-04 22:00 UTC

75 files changed +2,505 −2,517. View all changes and history on the product overview
2026
Tue 4 22:00 Mon 3 20:02 Sun 2 19:00

accessibility.md +18 −18

Details

22 22 

23* Para uma sessão: execute `claude --ax-screen-reader`.23* Para uma sessão: execute `claude --ax-screen-reader`.

24* Para sessões iniciadas a partir de um shell: defina a variável de ambiente `CLAUDE_AX_SCREEN_READER` como `1`. Em Bash ou Zsh, execute `export CLAUDE_AX_SCREEN_READER=1`; em PowerShell, execute `$env:CLAUDE_AX_SCREEN_READER = "1"`. Adicione a linha ao seu perfil de shell para cobrir todos os shells.24* Para sessões iniciadas a partir de um shell: defina a variável de ambiente `CLAUDE_AX_SCREEN_READER` como `1`. Em Bash ou Zsh, execute `export CLAUDE_AX_SCREEN_READER=1`; em PowerShell, execute `$env:CLAUDE_AX_SCREEN_READER = "1"`. Adicione a linha ao seu perfil de shell para cobrir todos os shells.

25* Para cada sessão na máquina: adicione `"axScreenReader": true` ao seu [arquivo de configurações](/pt/settings). Isso cobre qualquer terminal, incluindo o terminal integrado do VS Code.25* Para cada sessão na máquina: adicione `"axScreenReader": true` ao seu [arquivo de configurações](/docs/pt/settings). Isso cobre qualquer terminal, incluindo o terminal integrado do VS Code.

26 26 

27<Note>27<Note>

28 Os métodos são listados em ordem de precedência: a flag [`--ax-screen-reader`](/pt/cli-reference#cli-flags) substitui a variável de ambiente [`CLAUDE_AX_SCREEN_READER`](/pt/env-vars), que substitui a configuração [`axScreenReader`](/pt/settings#available-settings).28 Os métodos são listados em ordem de precedência: a flag [`--ax-screen-reader`](/docs/pt/cli-reference#cli-flags) substitui a variável de ambiente [`CLAUDE_AX_SCREEN_READER`](/docs/pt/env-vars), que substitui a configuração [`axScreenReader`](/docs/pt/settings#available-settings).

29</Note>29</Note>

30 30 

31Se você usar Claude Code via SSH, defina a variável de ambiente ou configuração na máquina remota onde Claude Code é executado.31Se você usar Claude Code via SSH, defina a variável de ambiente ou configuração na máquina remota onde Claude Code é executado.

32 32 

33Quando o modo está ativado, a primeira coisa que Claude Code imprime é uma linha de confirmação nomeando o método que o ativou: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]`, ou `[Screen Reader Mode: on via settings]`. O formato de nomeação de método requer Claude Code v2.1.206 ou posterior. Quando Claude Code se reinicia, por exemplo para terminar de instalar uma atualização, o novo processo herda o modo através da variável de ambiente `CLAUDE_AX_SCREEN_READER`, então sua linha de confirmação lê `[Screen Reader Mode: on via env]` independentemente de qual método você usou.33Quando o modo está ativado, a primeira coisa que Claude Code imprime é uma linha de confirmação nomeando o método que o ativou: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]`, ou `[Screen Reader Mode: on via settings]`. O formato de nomeação de método requer Claude Code v2.1.206 ou posterior. Quando Claude Code se reinicia, por exemplo para terminar de instalar uma atualização, o novo processo herda o modo através da variável de ambiente `CLAUDE_AX_SCREEN_READER`, então sua linha de confirmação lê `[Screen Reader Mode: on via env]` independentemente de qual método você usou.

34{/* max-version: 2.1.205 */}Versões anteriores imprimem `[Accessible screen reader mode: on]`.34Versões anteriores imprimem `[Accessible screen reader mode: on]`.

35 35 

36<h2 id="turn-off-screen-reader-mode">36<h2 id="turn-off-screen-reader-mode">

37 Desativar o modo leitor de tela37 Desativar o modo leitor de tela


48* sem caracteres de desenho de caixa para o chrome da interface48* sem caracteres de desenho de caixa para o chrome da interface

49* sem pistas apenas de cor49* sem pistas apenas de cor

50* sem redesenhos de conteúdo que não mudou; spinners de progresso são renderizados como texto estático50* sem redesenhos de conteúdo que não mudou; spinners de progresso são renderizados como texto estático

51* tabelas nas respostas de Claude são lidas como sentenças `Header: value` em vez de uma grade de caracteres de caixa. {/* min-version: 2.1.198 */}Requer Claude Code v2.1.198 ou posterior; versões anteriores desenham tabelas como grades mesmo no modo leitor de tela.51* tabelas nas respostas de Claude são lidas como sentenças `Header: value` em vez de uma grade de caracteres de caixa. Requer Claude Code v2.1.198 ou posterior; versões anteriores desenham tabelas como grades mesmo no modo leitor de tela.

52 52 

53A saída se acumula no scrollback do seu terminal, para que você possa reler turnos anteriores com os comandos de revisão do seu leitor de tela ou a busca do seu terminal.53A saída se acumula no scrollback do seu terminal, para que você possa reler turnos anteriores com os comandos de revisão do seu leitor de tela ou a busca do seu terminal.

54 54 

55O modo leitor de tela é renderizado como texto simples em rolagem, mesmo se você ativou [renderização em tela cheia](/pt/fullscreen) com a [configuração `tui`](/pt/settings#available-settings); a configuração não tem efeito enquanto o modo está ativo. Sessões de fundo anexadas ainda são renderizadas em tela cheia; consulte [Limitações conhecidas](#known-limitations).55O modo leitor de tela é renderizado como texto simples em rolagem, mesmo se você ativou [renderização em tela cheia](/docs/pt/fullscreen) com a [configuração `tui`](/docs/pt/settings#available-settings); a configuração não tem efeito enquanto o modo está ativo. Sessões de fundo anexadas ainda são renderizadas em tela cheia; consulte [Limitações conhecidas](#known-limitations).

56 56 

57Cada mensagem na transcrição começa com um rótulo que seu leitor de tela anuncia, nomeando o que é: suas mensagens, respostas de Claude, atividade de ferramentas, erros e prompts. Os rótulos também são pesquisáveis, para que você possa pular entre seções da transcrição pesquisando o scrollback do seu terminal:57Cada mensagem na transcrição começa com um rótulo que seu leitor de tela anuncia, nomeando o que é: suas mensagens, respostas de Claude, atividade de ferramentas, erros e prompts. Os rótulos também são pesquisáveis, para que você possa pular entre seções da transcrição pesquisando o scrollback do seu terminal:

58 58 


64| `tool error:` | Uma ferramenta que falhou |64| `tool error:` | Uma ferramenta que falhou |

65| `error:` | Um erro na conversa, como uma solicitação de API com falha |65| `error:` | Um erro na conversa, como uma solicitação de API com falha |

66| `Permission Required:` | Um prompt de permissão aguardando sua resposta |66| `Permission Required:` | Um prompt de permissão aguardando sua resposta |

67| `Cost:` | O resumo de custo da sessão quando Claude Code sai, se sua conta [mostra custos](/pt/costs) |67| `Cost:` | O resumo de custo da sessão quando Claude Code sai, se sua conta [mostra custos](/docs/pt/costs) |

68 68 

69O cursor do terminal segue o cursor de entrada, para que o comando de leitura de linha atual do seu leitor de tela responda "onde estou" com o prompt que você está editando.69O cursor do terminal segue o cursor de entrada, para que o comando de leitura de linha atual do seu leitor de tela responda "onde estou" com o prompt que você está editando.

70 70 


102* um prompt de permissão aparece102* um prompt de permissão aparece

103* uma ferramenta que foi executada por mais de 5 segundos termina103* uma ferramenta que foi executada por mais de 5 segundos termina

104 104 

105O sino é o alerta padrão do seu terminal. Para silenciá-lo, altere a configuração de sino no seu aplicativo de terminal. O sino não requer modo leitor de tela: fora do modo, defina [`preferredNotifChannel`](/pt/settings#available-settings) como `"terminal_bell"` para alertas semelhantes quando Claude está esperando por você. Consulte [Obter um sino de terminal ou notificação](/pt/terminal-config#get-a-terminal-bell-or-notification).105O sino é o alerta padrão do seu terminal. Para silenciá-lo, altere a configuração de sino no seu aplicativo de terminal. O sino não requer modo leitor de tela: fora do modo, defina [`preferredNotifChannel`](/docs/pt/settings#available-settings) como `"terminal_bell"` para alertas semelhantes quando Claude está esperando por você. Consulte [Obter um sino de terminal ou notificação](/docs/pt/terminal-config#get-a-terminal-bell-or-notification).

106 106 

107<h2 id="accessibility-settings-beyond-screen-reader-mode">107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 Configurações de acessibilidade além do modo leitor de tela108 Configurações de acessibilidade além do modo leitor de tela


110 110 

111Essas opções abordam necessidades de acessibilidade fora do modo leitor de tela. Todas elas funcionam junto com ele.111Essas opções abordam necessidades de acessibilidade fora do modo leitor de tela. Todas elas funcionam junto com ele.

112 112 

113* A [variável de ambiente](/pt/env-vars) `CLAUDE_CODE_ACCESSIBILITY` é para ampliadores de tela. Defina `CLAUDE_CODE_ACCESSIBILITY=1` para manter o cursor de terminal nativo visível para que ampliadores, como Zoom do macOS, possam rastrear a posição do cursor.113* A [variável de ambiente](/docs/pt/env-vars) `CLAUDE_CODE_ACCESSIBILITY` é para ampliadores de tela. Defina `CLAUDE_CODE_ACCESSIBILITY=1` para manter o cursor de terminal nativo visível para que ampliadores, como Zoom do macOS, possam rastrear a posição do cursor.

114* A [configuração](/pt/settings#available-settings) `prefersReducedMotion` reduz ou desabilita spinners, shimmer e outras animações sem alterar o resto da interface.114* A [configuração](/docs/pt/settings#available-settings) `prefersReducedMotion` reduz ou desabilita spinners, shimmer e outras animações sem alterar o resto da interface.

115* A [configuração](/pt/settings#available-settings) `theme` seleciona as cores da interface, incluindo os temas amigáveis para daltônicos `dark-daltonized` e `light-daltonized`.115* A [configuração](/docs/pt/settings#available-settings) `theme` seleciona as cores da interface, incluindo os temas amigáveis para daltônicos `dark-daltonized` e `light-daltonized`.

116 116 

117<h2 id="known-limitations">117<h2 id="known-limitations">

118 Limitações conhecidas118 Limitações conhecidas


121Alguns comportamentos não são adaptados para o modo leitor de tela:121Alguns comportamentos não são adaptados para o modo leitor de tela:

122 122 

123* O modo leitor de tela não é ativado automaticamente quando um leitor de tela está em execução.123* O modo leitor de tela não é ativado automaticamente quando um leitor de tela está em execução.

124* Mudanças de modo, como entrar em [plan mode](/pt/permission-modes#analyze-before-you-edit-with-plan-mode), ainda não são anunciadas.124* Mudanças de modo, como entrar em [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), ainda não são anunciadas.

125* Anexar a uma [sessão de fundo](/pt/agent-view) com `claude attach` ou da visualização de agente entra na tela alternativa do terminal, que não tem scrollback nativo. Este é o [mesmo comportamento que outras sessões anexadas](/pt/fullscreen). Para sair, pressione Left Arrow em um prompt vazio, ou Ctrl+Z se um diálogo tiver foco.125* Anexar a uma [sessão de fundo](/docs/pt/agent-view) com `claude attach` ou da visualização de agente entra na tela alternativa do terminal, que não tem scrollback nativo. Este é o [mesmo comportamento que outras sessões anexadas](/docs/pt/fullscreen). Para sair, pressione Left Arrow em um prompt vazio, ou Ctrl+Z se um diálogo tiver foco.

126* Claude Code anuncia custos no resumo que imprime na saída, não por turno.126* Claude Code anuncia custos no resumo que imprime na saída, não por turno.

127* O modo leitor de tela não altera [modo não interativo](/pt/headless) com a flag `-p`. O modo não interativo já escreve texto simples e permanece uma alternativa para scripts.127* O modo leitor de tela não altera [modo não interativo](/docs/pt/headless) com a flag `-p`. O modo não interativo já escreve texto simples e permanece uma alternativa para scripts.

128 128 

129<h2 id="report-an-issue">129<h2 id="report-an-issue">

130 Relatar um problema130 Relatar um problema


138 138 

139Essas páginas contêm as entradas de referência completa e a configuração relacionada para o que esta página cobre:139Essas páginas contêm as entradas de referência completa e a configuração relacionada para o que esta página cobre:

140 140 

141* [Settings](/pt/settings#available-settings): as entradas `axScreenReader`, `prefersReducedMotion`, `theme` e `preferredNotifChannel`141* [Settings](/docs/pt/settings#available-settings): as entradas `axScreenReader`, `prefersReducedMotion`, `theme` e `preferredNotifChannel`

142* [Environment variables](/pt/env-vars): as entradas `CLAUDE_AX_SCREEN_READER` e `CLAUDE_CODE_ACCESSIBILITY`142* [Environment variables](/docs/pt/env-vars): as entradas `CLAUDE_AX_SCREEN_READER` e `CLAUDE_CODE_ACCESSIBILITY`

143* [CLI reference](/pt/cli-reference#cli-flags): a flag `--ax-screen-reader`143* [CLI reference](/docs/pt/cli-reference#cli-flags): a flag `--ax-screen-reader`

144* [Terminal configuration](/pt/terminal-config): sinos, notificações e temas fora do modo leitor de tela144* [Terminal configuration](/docs/pt/terminal-config): sinos, notificações e temas fora do modo leitor de tela

145* [Non-interactive mode](/pt/headless): execuções de `claude -p` com script, que escrevem texto simples sem modo leitor de tela145* [Non-interactive mode](/docs/pt/headless): execuções de `claude -p` com script, que escrevem texto simples sem modo leitor de tela

advisor.md +17 −17

Details

22 22 

23O advisor é adequado para tarefas longas e com múltiplas etapas onde a maioria dos turnos é rotineira, mas a qualidade do plano determina o resultado. Exemplos incluem grandes refatorações, sessões de depuração onde um erro continua recorrendo, e tarefas que você deseja verificadas independentemente antes de Claude declarar que estão concluídas.23O advisor é adequado para tarefas longas e com múltiplas etapas onde a maioria dos turnos é rotineira, mas a qualidade do plano determina o resultado. Exemplos incluem grandes refatorações, sessões de depuração onde um erro continua recorrendo, e tarefas que você deseja verificadas independentemente antes de Claude declarar que estão concluídas.

24 24 

25Adiciona menos valor em tarefas curtas onde há pouco a planejar, ou em trabalho onde cada turno precisa do modelo mais forte. Para esses casos, [mude o modelo principal](/pt/model-config#setting-your-model) em vez disso, ou veja [como o advisor se compara com opusplan e subagents](#compare-with-related-features) para outras formas de obter uma segunda opinião.25Adiciona menos valor em tarefas curtas onde há pouco a planejar, ou em trabalho onde cada turno precisa do modelo mais forte. Para esses casos, [mude o modelo principal](/docs/pt/model-config#setting-your-model) em vez disso, ou veja [como o advisor se compara com opusplan e subagents](#compare-with-related-features) para outras formas de obter uma segunda opinião.

26 26 

27<h2 id="enable-the-advisor">27<h2 id="enable-the-advisor">

28 Ativar o advisor28 Ativar o advisor


31Você pode definir o modelo advisor de três formas:31Você pode definir o modelo advisor de três formas:

32 32 

33* **Comando `/advisor`**: defina ou altere o advisor no meio da sessão e salve-o como seu padrão33* **Comando `/advisor`**: defina ou altere o advisor no meio da sessão e salve-o como seu padrão

34* **Configuração `advisorModel`**: configure um padrão persistente em seu [arquivo de configurações](/pt/settings)34* **Configuração `advisorModel`**: configure um padrão persistente em seu [arquivo de configurações](/docs/pt/settings)

35* **Flag `--advisor`**: defina o advisor para uma única sessão no lançamento35* **Flag `--advisor`**: defina o advisor para uma única sessão no lançamento

36 36 

37Se qualquer uma dessas opções definir um modelo advisor, o advisor será ativado para sessões cujo modelo principal [o suporta](#choose-an-advisor-model). Para parar de usá-lo, veja [Desativar o advisor](#turn-the-advisor-off).37Se qualquer uma dessas opções definir um modelo advisor, o advisor será ativado para sessões cujo modelo principal [o suporta](#choose-an-advisor-model). Para parar de usá-lo, veja [Desativar o advisor](#turn-the-advisor-off).

38 38 

39<Note>39<Note>

40 Para usar Fable 5 como o advisor, você precisa de Claude Code v2.1.170 ou posterior e [acesso a Fable 5](/pt/model-config#work-with-fable-5) para sua organização.40 Para usar Fable 5 como o advisor, você precisa de Claude Code v2.1.170 ou posterior e [acesso a Fable 5](/docs/pt/model-config#work-with-fable-5) para sua organização.

41</Note>41</Note>

42 42 

43<h3 id="use-the-/advisor-command">43<h3 id="use-the-/advisor-command">


50/advisor opus50/advisor opus

51```51```

52 52 

53Sua seleção é salva em `advisorModel` nas configurações do usuário e persiste entre sessões. Se a allowlist [`availableModels`](/pt/model-config#restrict-model-selection) da sua organização excluir o modelo advisor salvo, o advisor não será invocado até que você escolha um modelo permitido com `/advisor`. Se seu modelo principal atual não suportar o advisor, a seleção ainda é salva e ativada quando você muda para um [modelo principal compatível](#choose-an-advisor-model) com [`/model`](/pt/model-config#setting-your-model).53Sua seleção é salva em `advisorModel` nas configurações do usuário e persiste entre sessões. Se a allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização excluir o modelo advisor salvo, o advisor não será invocado até que você escolha um modelo permitido com `/advisor`. Se seu modelo principal atual não suportar o advisor, a seleção ainda é salva e ativada quando você muda para um [modelo principal compatível](#choose-an-advisor-model) com [`/model`](/docs/pt/model-config#setting-your-model).

54 54 

55<h3 id="set-advisormodel-in-settings">55<h3 id="set-advisormodel-in-settings">

56 Defina `advisorModel` nas configurações56 Defina `advisorModel` nas configurações


74claude --advisor opus74claude --advisor opus

75```75```

76 76 

77A flag tem precedência sobre a configuração `advisorModel` para essa sessão. Ela sai com um erro se o modelo principal da sessão não suportar o advisor, ou se o modelo advisor solicitado for excluído pela allowlist [`availableModels`](/pt/model-config#restrict-model-selection) da sua organização.77A flag tem precedência sobre a configuração `advisorModel` para essa sessão. Ela sai com um erro se o modelo principal da sessão não suportar o advisor, ou se o modelo advisor solicitado for excluído pela allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização.

78 78 

79<h2 id="choose-an-advisor-model">79<h2 id="choose-an-advisor-model">

80 Escolha um modelo advisor80 Escolha um modelo advisor


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

84 84 

85| Modelo principal | Advisors aceitos | Notas |85| Modelo principal | Advisors aceitos | Notas |

86| ----------------------------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |86| --------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

87| Haiku 4.5 | Fable, Opus, Sonnet | Haiku pode chamar o advisor, mas não pode atuar como um |87| Haiku 4.5 | Fable, Opus, Sonnet | Haiku pode chamar o advisor, mas não pode atuar como um |

88| Sonnet 4.6 | Fable, Opus, Sonnet | |88| Sonnet 4.6 | Fable, Opus, Sonnet | |

89| Sonnet 5 | Fable, Opus, Sonnet 5 | Um advisor Sonnet 4.6 é rejeitado |89| Sonnet 5 | Fable, Opus, Sonnet 5 | Um advisor Sonnet 4.6 é rejeitado |

90| Opus 4.6 | Fable, Opus, Sonnet 5 | Sonnet 5 e Opus 4.6 são classificados como igualmente capazes, então um Opus 4.6 principal aceita um advisor Sonnet 5 |90| Opus 4.6 | Fable, Opus, Sonnet 5 | Sonnet 5 e Opus 4.6 são classificados como igualmente capazes, então um Opus 4.6 principal aceita um advisor Sonnet 5 |

91| Opus 4.7 ou posterior | Fable, Opus 4.7, Opus 4.8 | Opus 4.7 e Opus 4.8 são classificados como igualmente capazes, então qualquer um aceita o outro como um advisor. Um Opus 4.7 principal com um advisor Opus 4.6 ou Sonnet 5 é rejeitado |91| Opus 4.7 ou posterior | Fable, Opus 4.7, Opus 4.8 | Opus 4.7 e Opus 4.8 são classificados como igualmente capazes, então qualquer um aceita o outro como um advisor. Um Opus 4.7 principal com um advisor Opus 4.6 ou Sonnet 5 é rejeitado |

92| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Um advisor Opus ou Sonnet é rejeitado |92| Fable 5 (v2.1.170+) | Fable | Um advisor Opus ou Sonnet é rejeitado |

93 93 

94Fable 5 requer Claude Code v2.1.170 ou posterior e acesso a Fable 5, seja atuando como modelo principal ou advisor.94Fable 5 requer Claude Code v2.1.170 ou posterior e acesso a Fable 5, seja atuando como modelo principal ou advisor.

95 95 


141 141 

142Cada chamada do advisor envia a conversa para o modelo advisor, então consome tokens nas taxas do modelo advisor além do uso do seu modelo principal. Com faturamento por API, tokens do advisor são cobrados nas taxas de entrada e saída do modelo advisor. Em planos de assinatura, o uso do advisor conta para os limites de uso do seu plano.142Cada chamada do advisor envia a conversa para o modelo advisor, então consome tokens nas taxas do modelo advisor além do uso do seu modelo principal. Com faturamento por API, tokens do advisor são cobrados nas taxas de entrada e saída do modelo advisor. Em planos de assinatura, o uso do advisor conta para os limites de uso do seu plano.

143 143 

144Claude chama o advisor em pontos de decisão em vez de em cada turno, então emparelhar um modelo principal mais rápido com um advisor mais forte tipicamente custa menos que executar o modelo mais forte em toda parte. O uso do advisor conta para os totais da sessão mostrados por [`/usage`](/pt/costs#track-your-costs).144Claude chama o advisor em pontos de decisão em vez de em cada turno, então emparelhar um modelo principal mais rápido com um advisor mais forte tipicamente custa menos que executar o modelo mais forte em toda parte. O uso do advisor conta para os totais da sessão mostrados por [`/usage`](/docs/pt/costs#track-your-costs).

145 145 

146Para como tokens do advisor são reportados em respostas da API, veja [Usage and billing](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing) na documentação da API Claude.146Para como tokens do advisor são reportados em respostas da API, veja [Usage and billing](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing) na documentação da API Claude.

147 147 


149 Impacto no prompt caching149 Impacto no prompt caching

150</h2>150</h2>

151 151 

152Ativar ou desativar o advisor no meio da sessão não invalida o [prompt cache](/pt/prompt-caching) do seu modelo principal. Diferentemente de [mudar modelo ou nível de esforço](/pt/prompt-caching#actions-that-invalidate-the-cache), alternar `/advisor` mantém o prefixo em cache intacto, e a orientação retornada pelo advisor é armazenada em cache como parte da transcrição em turnos posteriores.152Ativar ou desativar o advisor no meio da sessão não invalida o [prompt cache](/docs/pt/prompt-caching) do seu modelo principal. Diferentemente de [mudar modelo ou nível de esforço](/docs/pt/prompt-caching#actions-that-invalidate-the-cache), alternar `/advisor` mantém o prefixo em cache intacto, e a orientação retornada pelo advisor é armazenada em cache como parte da transcrição em turnos posteriores.

153 153 

154A própria leitura do advisor da conversa não é armazenada em cache. Cada chamada do advisor processa a transcrição completa novamente, sem reutilização entre chamadas.154A própria leitura do advisor da conversa não é armazenada em cache. Cada chamada do advisor processa a transcrição completa novamente, sem reutilização entre chamadas.

155 155 


159 159 

160A ferramenta advisor requer todos os seguintes:160A ferramenta advisor requer todos os seguintes:

161 161 

162* **Apenas API Anthropic**: o advisor é uma ferramenta executada no servidor. Não está disponível no Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry. Através de um [LLM gateway](/pt/llm-gateway) configurado com `ANTHROPIC_BASE_URL`, a disponibilidade depende se o gateway encaminha a solicitação intacta para a API Anthropic.162* **Apenas API Anthropic**: o advisor é uma ferramenta executada no servidor. Não está disponível no Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry. Através de um [LLM gateway](/docs/pt/llm-gateway) configurado com `ANTHROPIC_BASE_URL`, a disponibilidade depende se o gateway encaminha a solicitação intacta para a API Anthropic.

163* **Modelo principal suportado**: Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 também se qualifica no Claude Code v2.1.170 ou posterior.163* **Modelo principal suportado**: Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou Haiku 4.5. Fable 5 também se qualifica no Claude Code v2.1.170 ou posterior.

164 164 

165<h2 id="turn-the-advisor-off">165<h2 id="turn-the-advisor-off">

166 Desativar o advisor166 Desativar o advisor


172/advisor off172/advisor off

173```173```

174 174 

175Para desativar a ferramenta advisor inteiramente, defina `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. O comando `/advisor` fica indisponível e qualquer `advisorModel` configurado é ignorado. A flag `--advisor` é aceita mas não tem efeito; scripts existentes que a passam continuam funcionando sem erros. Veja [Environment variables](/pt/env-vars).175Para desativar a ferramenta advisor inteiramente, defina `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. O comando `/advisor` fica indisponível e qualquer `advisorModel` configurado é ignorado. A flag `--advisor` é aceita mas não tem efeito; scripts existentes que a passam continuam funcionando sem erros. Veja [Environment variables](/docs/pt/env-vars).

176 176 

177<h2 id="compare-with-related-features">177<h2 id="compare-with-related-features">

178 Compare com recursos relacionados178 Compare com recursos relacionados


183| Abordagem | Quando o modelo mais forte é executado | Como começa |183| Abordagem | Quando o modelo mais forte é executado | Como começa |

184| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |184| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |

185| Ferramenta Advisor | Em pontos de decisão no meio da tarefa | Claude a chama quando precisa de orientação |185| Ferramenta Advisor | Em pontos de decisão no meio da tarefa | Claude a chama quando precisa de orientação |

186| [`opusplan`](/pt/model-config#opusplan-model-setting) | Durante plan mode quando [permitido por `availableModels`](/pt/model-config#restrict-model-selection), depois muda para Sonnet para execução | Você entra em plan mode |186| [`opusplan`](/docs/pt/model-config#opusplan-model-setting) | Durante plan mode quando [permitido por `availableModels`](/docs/pt/model-config#restrict-model-selection), depois muda para Sonnet para execução | Você entra em plan mode |

187| [Subagents](/pt/sub-agents#choose-a-model) com `model` definido | Para toda a subtarefa delegada | Claude delega, ou você invoca o subagent |187| [Subagents](/docs/pt/sub-agents#choose-a-model) com `model` definido | Para toda a subtarefa delegada | Claude delega, ou você invoca o subagent |

188| [`/model`](/pt/model-config#setting-your-model) | Para todos os turnos subsequentes | Você muda de modelos |188| [`/model`](/docs/pt/model-config#setting-your-model) | Para todos os turnos subsequentes | Você muda de modelos |

189 189 

190<h2 id="see-also">190<h2 id="see-also">

191 Veja também191 Veja também

192</h2>192</h2>

193 193 

194* [Model configuration](/pt/model-config): mude modelos, defina níveis de esforço, e use `opusplan`194* [Model configuration](/docs/pt/model-config): mude modelos, defina níveis de esforço, e use `opusplan`

195* [Manage costs effectively](/pt/costs): rastreie o uso de tokens entre modelos195* [Manage costs effectively](/docs/pt/costs): rastreie o uso de tokens entre modelos

196* [Advisor tool in the Claude API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool): entenda a ferramenta de servidor subjacente, ou use-a diretamente da Messages API196* [Advisor tool in the Claude API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool): entenda a ferramenta de servidor subjacente, ou use-a diretamente da Messages API

197* [The advisor strategy](https://claude.com/blog/the-advisor-strategy): por que emparelhar um modelo principal rápido com um advisor mais forte funciona197* [The advisor strategy](https://claude.com/blog/the-advisor-strategy): por que emparelhar um modelo principal rápido com um advisor mais forte funciona

agent-sdk/hooks.md +21 −21

Details

26 </Step>26 </Step>

27 27 

28 <Step title="O SDK coleta hooks registrados">28 <Step title="O SDK coleta hooks registrados">

29 O SDK verifica se há hooks registrados para esse tipo de evento. Isso inclui hooks de callback que você passa em `options.hooks` e hooks de comando shell de arquivos de configuração quando a entrada [`settingSources`](/pt/agent-sdk/typescript#settingsource) ou [`setting_sources`](/pt/agent-sdk/python#settingsource) correspondente está habilitada, o que é o padrão para opções `query()`.29 O SDK verifica se há hooks registrados para esse tipo de evento. Isso inclui hooks de callback que você passa em `options.hooks` e hooks de comando shell de arquivos de configuração quando a entrada [`settingSources`](/docs/pt/agent-sdk/typescript#settingsource) ou [`setting_sources`](/docs/pt/agent-sdk/python#settingsource) correspondente está habilitada, o que é o padrão para opções `query()`.

30 </Step>30 </Step>

31 31 

32 <Step title="Matchers filtram quais hooks são executados">32 <Step title="Matchers filtram quais hooks são executados">


155| `PostToolUseFailure` | Sim | Sim | Falha na execução de ferramenta | Lidar ou registrar erros de ferramenta |155| `PostToolUseFailure` | Sim | Sim | Falha na execução de ferramenta | Lidar ou registrar erros de ferramenta |

156| `PostToolBatch` | Não | Sim | Um lote completo de chamadas de ferramenta é resolvido, uma vez por lote antes da próxima chamada de modelo | Injetar convenções uma vez para todo o lote |156| `PostToolBatch` | Não | Sim | Um lote completo de chamadas de ferramenta é resolvido, uma vez por lote antes da próxima chamada de modelo | Injetar convenções uma vez para todo o lote |

157| `UserPromptSubmit` | Sim | Sim | Envio de prompt do usuário | Injetar contexto adicional em prompts |157| `UserPromptSubmit` | Sim | Sim | Envio de prompt do usuário | Injetar contexto adicional em prompts |

158| [`UserPromptExpansion`](/pt/hooks#userpromptexpansion) | Não | Sim | Um comando digitado pelo usuário se expande em um prompt antes de chegar ao Claude | Bloquear um comando de invocação direta ou adicionar contexto quando uma skill é digitada |158| [`UserPromptExpansion`](/docs/pt/hooks#userpromptexpansion) | Não | Sim | Um comando digitado pelo usuário se expande em um prompt antes de chegar ao Claude | Bloquear um comando de invocação direta ou adicionar contexto quando uma skill é digitada |

159| `MessageDisplay` | Não | Sim | Uma mensagem do assistente com texto é concluída, uma vez por mensagem com o texto completo da mensagem | Redigir ou reformatar o texto exibido sem alterar a transcrição |159| `MessageDisplay` | Não | Sim | Uma mensagem do assistente com texto é concluída, uma vez por mensagem com o texto completo da mensagem | Redigir ou reformatar o texto exibido sem alterar a transcrição |

160| `Stop` | Sim | Sim | Parada de execução do agente | Salvar estado da sessão antes de sair |160| `Stop` | Sim | Sim | Parada de execução do agente | Salvar estado da sessão antes de sair |

161| `SubagentStart` | Sim | Sim | Inicialização de subagente | Rastrear geração de tarefas paralelas |161| `SubagentStart` | Sim | Sim | Inicialização de subagente | Rastrear geração de tarefas paralelas |


213 Matchers213 Matchers

214</h3>214</h3>

215 215 

216Use matchers para filtrar quando seus callbacks são acionados. O campo `matcher` corresponde a um valor diferente dependendo do tipo de evento de hook. Por exemplo, hooks baseados em ferramentas correspondem ao nome da ferramenta, enquanto hooks `Notification` correspondem ao tipo de notificação. Veja a [referência de hooks do Claude Code](/pt/hooks#matcher-patterns) para a lista completa de valores de matcher para cada tipo de evento.216Use matchers para filtrar quando seus callbacks são acionados. O campo `matcher` corresponde a um valor diferente dependendo do tipo de evento de hook. Por exemplo, hooks baseados em ferramentas correspondem ao nome da ferramenta, enquanto hooks `Notification` correspondem ao tipo de notificação. Veja a [referência de hooks do Claude Code](/docs/pt/hooks#matcher-patterns) para a lista completa de valores de matcher para cada tipo de evento.

217 217 

218Os matchers do SDK seguem as mesmas regras que [matchers em arquivos de configuração](/pt/hooks#matcher-patterns). Um matcher contendo apenas letras, dígitos, `_`, `-`, espaços, `,` e `|` é comparado como uma string exata, com alternativas separadas por `|` ou `,` e espaço em branco opcional ao redor, então `Write|Edit` e `Write, Edit` correspondem exatamente a essas duas ferramentas e `code-reviewer` corresponde apenas a esse tipo de agente. Um matcher de `*`, uma string vazia, ou omitir o matcher inteiramente corresponde a cada ocorrência do evento.218Os matchers do SDK seguem as mesmas regras que [matchers em arquivos de configuração](/docs/pt/hooks#matcher-patterns). Um matcher contendo apenas letras, dígitos, `_`, `-`, espaços, `,` e `|` é comparado como uma string exata, com alternativas separadas por `|` ou `,` e espaço em branco opcional ao redor, então `Write|Edit` e `Write, Edit` correspondem exatamente a essas duas ferramentas e `code-reviewer` corresponde apenas a esse tipo de agente. Um matcher de `*`, uma string vazia, ou omitir o matcher inteiramente corresponde a cada ocorrência do evento.

219 219 

220Um matcher contendo qualquer outro caractere é avaliado como uma expressão regular sem âncora, então `^mcp__` corresponde a cada ferramenta MCP e `Edit.*` corresponde tanto a `Edit` quanto a `NotebookEdit`. Envolva uma expressão regular em `^` e `$` quando você precisar de uma correspondência de string inteira.220Um matcher contendo qualquer outro caractere é avaliado como uma expressão regular sem âncora, então `^mcp__` corresponde a cada ferramenta MCP e `Edit.*` corresponde tanto a `Edit` quanto a `NotebookEdit`. Envolva uma expressão regular em `^` e `$` quando você precisar de uma correspondência de string inteira.

221 221 


225 225 

226| Opção | Tipo | Padrão | Descrição |226| Opção | Tipo | Padrão | Descrição |

227| --------- | ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |227| --------- | ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

228| `matcher` | `string` | `undefined` | Padrão correspondido contra o campo de filtro do evento, seguindo as regras de comparação acima. Para hooks de ferramenta, este é o nome da ferramenta. As ferramentas integradas incluem `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` e outras (veja [Tipos de Entrada de Ferramenta](/pt/agent-sdk/typescript#tool-input-types) para a lista completa). Ferramentas MCP usam o padrão `mcp__<server>__<action>`. |228| `matcher` | `string` | `undefined` | Padrão correspondido contra o campo de filtro do evento, seguindo as regras de comparação acima. Para hooks de ferramenta, este é o nome da ferramenta. As ferramentas integradas incluem `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` e outras (veja [Tipos de Entrada de Ferramenta](/docs/pt/agent-sdk/typescript#tool-input-types) para a lista completa). Ferramentas MCP usam o padrão `mcp__<server>__<action>`. |

229| `hooks` | `HookCallback[]` | - | Obrigatório. Array de funções de callback a executar quando o padrão corresponde |229| `hooks` | `HookCallback[]` | - | Obrigatório. Array de funções de callback a executar quando o padrão corresponde |

230| `timeout` | `number` | `60` | Timeout em segundos |230| `timeout` | `number` | `60` | Timeout em segundos |

231 231 


234Para hooks baseados em ferramentas, matchers filtram apenas pelo nome da ferramenta, não por caminhos de arquivo ou outros argumentos. Para filtrar por caminho de arquivo, verifique `tool_input.file_path` dentro de seu callback.234Para hooks baseados em ferramentas, matchers filtram apenas pelo nome da ferramenta, não por caminhos de arquivo ou outros argumentos. Para filtrar por caminho de arquivo, verifique `tool_input.file_path` dentro de seu callback.

235 235 

236<Tip>236<Tip>

237 **Descobrindo nomes de ferramentas:** Veja [Tipos de Entrada de Ferramenta](/pt/agent-sdk/typescript#tool-input-types) para a lista completa de nomes de ferramentas integradas, ou adicione um hook sem um matcher para registrar todas as chamadas de ferramenta que sua sessão faz.237 **Descobrindo nomes de ferramentas:** Veja [Tipos de Entrada de Ferramenta](/docs/pt/agent-sdk/typescript#tool-input-types) para a lista completa de nomes de ferramentas integradas, ou adicione um hook sem um matcher para registrar todas as chamadas de ferramenta que sua sessão faz.

238 238 

239 **Nomenclatura de ferramentas MCP:** Ferramentas MCP sempre começam com `mcp__` seguido pelo nome do servidor e ação: `mcp__<server>__<action>`. Por exemplo, se você configurar um servidor chamado `playwright`, suas ferramentas serão nomeadas `mcp__playwright__browser_screenshot`, `mcp__playwright__browser_click` e assim por diante. O nome do servidor vem da chave que você usa na configuração `mcpServers`.239 **Nomenclatura de ferramentas MCP:** Ferramentas MCP sempre começam com `mcp__` seguido pelo nome do servidor e ação: `mcp__<server>__<action>`. Por exemplo, se você configurar um servidor chamado `playwright`, suas ferramentas serão nomeadas `mcp__playwright__browser_screenshot`, `mcp__playwright__browser_click` e assim por diante. O nome do servidor vem da chave que você usa na configuração `mcpServers`.

240</Tip>240</Tip>


249 249 

250Cada callback de hook recebe três argumentos:250Cada callback de hook recebe três argumentos:

251 251 

252* **Dados de entrada:** um objeto tipado contendo detalhes do evento. Cada tipo de hook tem sua própria forma de entrada. Por exemplo, `PreToolUseHookInput` inclui `tool_name` e `tool_input`, enquanto `NotificationHookInput` inclui `message`. Veja as definições de tipo completas nas referências do SDK [TypeScript](/pt/agent-sdk/typescript#hookinput) e [Python](/pt/agent-sdk/python#hookinput).252* **Dados de entrada:** um objeto tipado contendo detalhes do evento. Cada tipo de hook tem sua própria forma de entrada. Por exemplo, `PreToolUseHookInput` inclui `tool_name` e `tool_input`, enquanto `NotificationHookInput` inclui `message`. Veja as definições de tipo completas nas referências do SDK [TypeScript](/docs/pt/agent-sdk/typescript#hookinput) e [Python](/docs/pt/agent-sdk/python#hookinput).

253 * Todas as entradas de hook compartilham `session_id`, `cwd` e `hook_event_name`.253 * Todas as entradas de hook compartilham `session_id`, `cwd` e `hook_event_name`.

254 * `agent_id` e `agent_type` são preenchidos quando o hook é acionado dentro de um subagente. Em TypeScript, estes estão na entrada de hook base e disponíveis para todos os tipos de hook. Em Python, eles são campos opcionais em `PreToolUse`, `PostToolUse`, `PostToolUseFailure` e `PermissionRequest`, e campos obrigatórios em `SubagentStart` e `SubagentStop`.254 * `agent_id` e `agent_type` são preenchidos quando o hook é acionado dentro de um subagente. Em TypeScript, estes estão na entrada de hook base e disponíveis para todos os tipos de hook. Em Python, eles são campos opcionais em `PreToolUse`, `PostToolUse`, `PostToolUseFailure` e `PermissionRequest`, e campos obrigatórios em `SubagentStart` e `SubagentStop`.

255* **ID de uso de ferramenta** (`str | None` / `string | undefined`): correlaciona eventos `PreToolUse` e `PostToolUse` para a mesma chamada de ferramenta.255* **ID de uso de ferramenta** (`str | None` / `string | undefined`): correlaciona eventos `PreToolUse` e `PostToolUse` para a mesma chamada de ferramenta.


262Seu callback retorna um objeto com duas categorias de campos:262Seu callback retorna um objeto com duas categorias de campos:

263 263 

264* **Campos de nível superior** funcionam da mesma forma em cada evento: `systemMessage` mostra uma mensagem ao usuário, e `continue` (`continue_` em Python) determina se o agente continua executando após este hook.264* **Campos de nível superior** funcionam da mesma forma em cada evento: `systemMessage` mostra uma mensagem ao usuário, e `continue` (`continue_` em Python) determina se o agente continua executando após este hook.

265* **`hookSpecificOutput`** controla a operação atual. Os campos dentro dependem do tipo de evento de hook. Para hooks `PreToolUse`, é aqui que você define `permissionDecision` (`"allow"`, `"deny"`, `"ask"` ou `"defer"`), `permissionDecisionReason` e `updatedInput`. Retornar `"defer"` encerra a consulta para que você possa [retomá-la depois](/pt/hooks#defer-a-tool-call-for-later). Para hooks `PostToolUse`, você pode definir `additionalContext` para anexar informações ao resultado da ferramenta. Para substituir a saída da ferramenta antes de Claude vê-la, defina `updatedToolOutput`, que funciona para qualquer ferramenta em ambos os SDKs. O campo mais antigo `updatedMCPToolOutput` substitui apenas a saída de ferramentas MCP e está descontinuado.265* **`hookSpecificOutput`** controla a operação atual. Os campos dentro dependem do tipo de evento de hook. Para hooks `PreToolUse`, é aqui que você define `permissionDecision` (`"allow"`, `"deny"`, `"ask"` ou `"defer"`), `permissionDecisionReason` e `updatedInput`. Retornar `"defer"` encerra a consulta para que você possa [retomá-la depois](/docs/pt/hooks#defer-a-tool-call-for-later). Para hooks `PostToolUse`, você pode definir `additionalContext` para anexar informações ao resultado da ferramenta. Para substituir a saída da ferramenta antes de Claude vê-la, defina `updatedToolOutput`, que funciona para qualquer ferramenta em ambos os SDKs. O campo mais antigo `updatedMCPToolOutput` substitui apenas a saída de ferramentas MCP e está descontinuado.

266 266 

267Retorne `{}` para permitir a operação sem alterações. Hooks de callback do SDK usam o mesmo formato de saída JSON que [hooks de comando shell do Claude Code](/pt/hooks#json-output), que documenta cada campo e opção específica do evento. Para as definições de tipo do SDK, veja as referências do SDK [TypeScript](/pt/agent-sdk/typescript#synchookjsonoutput) e [Python](/pt/agent-sdk/python#synchookjsonoutput).267Retorne `{}` para permitir a operação sem alterações. Hooks de callback do SDK usam o mesmo formato de saída JSON que [hooks de comando shell do Claude Code](/docs/pt/hooks#json-output), que documenta cada campo e opção específica do evento. Para as definições de tipo do SDK, veja as referências do SDK [TypeScript](/docs/pt/agent-sdk/typescript#synchookjsonoutput) e [Python](/docs/pt/agent-sdk/python#synchookjsonoutput).

268 268 

269<Note>269<Note>

270 Quando múltiplos hooks ou regras de permissão se aplicam, `deny` tem prioridade sobre `defer`, que tem prioridade sobre `ask`, que tem prioridade sobre `allow`. Se qualquer hook retornar `deny`, a operação é bloqueada independentemente de outros hooks.270 Quando múltiplos hooks ou regras de permissão se aplicam, `deny` tem prioridade sobre `defer`, que tem prioridade sobre `ask`, que tem prioridade sobre `allow`. Se qualquer hook retornar `deny`, a operação é bloqueada independentemente de outros hooks.


539 Rastrear atividade de subagente539 Rastrear atividade de subagente

540</h3>540</h3>

541 541 

542Use hooks `SubagentStop` para monitorar quando subagentes terminam seu trabalho. Veja o tipo de entrada completo nas referências do SDK [TypeScript](/pt/agent-sdk/typescript#hookinput) e [Python](/pt/agent-sdk/python#hookinput). Este exemplo registra um resumo cada vez que um subagente é concluído:542Use hooks `SubagentStop` para monitorar quando subagentes terminam seu trabalho. Veja o tipo de entrada completo nas referências do SDK [TypeScript](/docs/pt/agent-sdk/typescript#hookinput) e [Python](/docs/pt/agent-sdk/python#hookinput). Este exemplo registra um resumo cada vez que um subagente é concluído:

543 543 

544<CodeGroup>544<CodeGroup>

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


791* Verifique se o nome do evento de hook está correto e sensível a maiúsculas/minúsculas (`PreToolUse`, não `preToolUse`)791* Verifique se o nome do evento de hook está correto e sensível a maiúsculas/minúsculas (`PreToolUse`, não `preToolUse`)

792* Verifique se seu padrão de matcher corresponde exatamente ao nome da ferramenta792* Verifique se seu padrão de matcher corresponde exatamente ao nome da ferramenta

793* Certifique-se de que o hook está sob o tipo de evento correto em `options.hooks`793* Certifique-se de que o hook está sob o tipo de evento correto em `options.hooks`

794* Para hooks não baseados em ferramentas que suportam matchers, como `Notification` e `SubagentStop`, matchers correspondem a campos diferentes, e `Stop` ignora matchers completamente (veja [padrões de matcher](/pt/hooks#matcher-patterns))794* Para hooks não baseados em ferramentas que suportam matchers, como `Notification` e `SubagentStop`, matchers correspondem a campos diferentes, e `Stop` ignora matchers completamente (veja [padrões de matcher](/docs/pt/hooks#matcher-patterns))

795* Hooks podem não ser disparados quando o agente atinge o limite [`max_turns`](/pt/agent-sdk/python#claudeagentoptions) porque a sessão termina antes que hooks possam ser executados795* Hooks podem não ser disparados quando o agente atinge o limite [`max_turns`](/docs/pt/agent-sdk/python#claudeagentoptions) porque a sessão termina antes que hooks possam ser executados

796 796 

797<h3 id="matcher-not-filtering-as-expected">797<h3 id="matcher-not-filtering-as-expected">

798 Matcher não filtra como esperado798 Matcher não filtra como esperado


818* Aumente o valor `timeout` na configuração `HookMatcher`818* Aumente o valor `timeout` na configuração `HookMatcher`

819* Use o `AbortSignal` do terceiro argumento de callback para lidar com cancelamento graciosamente em TypeScript819* Use o `AbortSignal` do terceiro argumento de callback para lidar com cancelamento graciosamente em TypeScript

820 820 

821{/* min-version: 2.1.208 */}Um callback `UserPromptSubmit` ou [`UserPromptExpansion`](/pt/hooks#userpromptexpansion) que excede seu timeout bloqueia esse prompt com uma mensagem de timeout e a sessão continua. Interromper a consulta enquanto um callback está pendente cancela a chamada de ferramenta pendente. Antes da v2.1.208, um timeout de callback nesses eventos terminava a consulta com `error_during_execution`, e uma interrupção durante um callback `PreToolUse` pendente poderia deixar a chamada de ferramenta prosseguir.821Um callback `UserPromptSubmit` ou [`UserPromptExpansion`](/docs/pt/hooks#userpromptexpansion) que excede seu timeout bloqueia esse prompt com uma mensagem de timeout e a sessão continua. Interromper a consulta enquanto um callback está pendente cancela a chamada de ferramenta pendente. Antes da v2.1.208, um timeout de callback nesses eventos terminava a consulta com `error_during_execution`, e uma interrupção durante um callback `PreToolUse` pendente poderia deixar a chamada de ferramenta prosseguir.

822 822 

823<h3 id="tool-blocked-unexpectedly">823<h3 id="tool-blocked-unexpectedly">

824 Ferramenta bloqueada inesperadamente824 Ferramenta bloqueada inesperadamente


852 Hooks de sessão não disponíveis em Python852 Hooks de sessão não disponíveis em Python

853</h3>853</h3>

854 854 

855`SessionStart` e `SessionEnd` podem ser registrados como hooks de callback do SDK em TypeScript, mas não estão disponíveis no SDK Python porque seu tipo `HookEvent` os omite. Em Python, eles estão disponíveis apenas como [hooks de comando shell](/pt/hooks#hook-events) definidos em arquivos de configuração como `.claude/settings.json`. Para carregar hooks de comando shell de sua aplicação SDK, inclua a fonte de configuração apropriada com [`setting_sources`](/pt/agent-sdk/python#settingsource) ou [`settingSources`](/pt/agent-sdk/typescript#settingsource):855`SessionStart` e `SessionEnd` podem ser registrados como hooks de callback do SDK em TypeScript, mas não estão disponíveis no SDK Python porque seu tipo `HookEvent` os omite. Em Python, eles estão disponíveis apenas como [hooks de comando shell](/docs/pt/hooks#hook-events) definidos em arquivos de configuração como `.claude/settings.json`. Para carregar hooks de comando shell de sua aplicação SDK, inclua a fonte de configuração apropriada com [`setting_sources`](/docs/pt/agent-sdk/python#settingsource) ou [`settingSources`](/docs/pt/agent-sdk/typescript#settingsource):

856 856 

857<CodeGroup>857<CodeGroup>

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


890 systemMessage não aparecendo na saída890 systemMessage não aparecendo na saída

891</h3>891</h3>

892 892 

893O campo `systemMessage` mostra uma mensagem ao usuário, não ao modelo. Por padrão, o SDK expõe a saída de hook no fluxo de mensagens apenas para hooks `SessionStart` e `Setup`, portanto uma mensagem de qualquer outro evento de hook não aparece a menos que você defina `includeHookEvents` (`include_hook_events` em Python). Para passar contexto ao modelo, retorne [`additionalContext`](/pt/hooks#add-context-for-claude).893O campo `systemMessage` mostra uma mensagem ao usuário, não ao modelo. Por padrão, o SDK expõe a saída de hook no fluxo de mensagens apenas para hooks `SessionStart` e `Setup`, portanto uma mensagem de qualquer outro evento de hook não aparece a menos que você defina `includeHookEvents` (`include_hook_events` em Python). Para passar contexto ao modelo, retorne [`additionalContext`](/docs/pt/hooks#add-context-for-claude).

894 894 

895Se você precisar expor decisões de hook para sua aplicação de forma confiável, registre-as separadamente ou use um canal de saída dedicado.895Se você precisar expor decisões de hook para sua aplicação de forma confiável, registre-as separadamente ou use um canal de saída dedicado.

896 896 


898 Recursos relacionados898 Recursos relacionados

899</h2>899</h2>

900 900 

901* [Referência de hooks do Claude Code](/pt/hooks): esquemas JSON de entrada/saída completos, documentação de eventos e padrões de matcher901* [Referência de hooks do Claude Code](/docs/pt/hooks): esquemas JSON de entrada/saída completos, documentação de eventos e padrões de matcher

902* [Guia de hooks do Claude Code](/pt/hooks-guide): exemplos de hooks de comando shell e passo a passo902* [Guia de hooks do Claude Code](/docs/pt/hooks-guide): exemplos de hooks de comando shell e passo a passo

903* [Referência do SDK TypeScript](/pt/agent-sdk/typescript): tipos de hook, definições de entrada/saída e opções de configuração903* [Referência do SDK TypeScript](/docs/pt/agent-sdk/typescript): tipos de hook, definições de entrada/saída e opções de configuração

904* [Referência do SDK Python](/pt/agent-sdk/python): tipos de hook, definições de entrada/saída e opções de configuração904* [Referência do SDK Python](/docs/pt/agent-sdk/python): tipos de hook, definições de entrada/saída e opções de configuração

905* [Permissões](/pt/agent-sdk/permissions): controlar o que seu agente pode fazer905* [Permissões](/docs/pt/agent-sdk/permissions): controlar o que seu agente pode fazer

906* [Ferramentas personalizadas](/pt/agent-sdk/custom-tools): construir ferramentas para estender capacidades do agente906* [Ferramentas personalizadas](/docs/pt/agent-sdk/custom-tools): construir ferramentas para estender capacidades do agente

Details

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 permitir/negar.

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`](/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 

11<Note>11<Note>

12 Esta página cobre modos de permissão e regras. Para construir fluxos de aprovação interativos onde os usuários aprovam ou negam solicitações de ferramentas em tempo de execução, consulte [Lidar com aprovações e entrada do usuário](/pt/agent-sdk/user-input).12 Esta página cobre modos de permissão e regras. Para construir fluxos de aprovação interativos onde os usuários aprovam ou negam solicitações de ferramentas em tempo de execução, consulte [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input).

13</Note>13</Note>

14 14 

15<h2 id="how-permissions-are-evaluated">15<h2 id="how-permissions-are-evaluated">


20 20 

21<Steps>21<Steps>

22 <Step title="Hooks">22 <Step title="Hooks">

23 Execute [hooks](/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.23 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.

24 </Step>24 </Step>

25 25 

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

27 Verifique as regras `deny` (de `disallowed_tools` e [settings.json](/pt/settings#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.27 Verifique as regras `deny` (de `disallowed_tools` e [settings.json](/docs/pt/settings#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.

28 </Step>28 </Step>

29 29 

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

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

32 32 

33 Ferramentas que requerem interação do usuário se comportam da mesma forma: `AskUserQuestion` e ferramentas MCP cujo servidor define [`_meta["anthropic/requiresUserInteraction"]`](/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. {/* min-version: 2.1.199 */}A anotação MCP requer Claude Code v2.1.199 ou posterior.33 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.

34 34 

35 Ferramentas do conector [claude.ai](/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.35 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.

36 </Step>36 </Step>

37 37 

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


44 </Step>44 </Step>

45 45 

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

47 Se não for resolvido por nenhum dos anteriores, chame seu callback [`canUseTool`](/pt/agent-sdk/user-input) para uma decisão. No modo `dontAsk`, este passo é ignorado e a ferramenta é negada.47 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 </Step>48 </Step>

49</Steps>49</Steps>

50 50 


57 57 

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

59 59 

60Ouç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`](/pt/agent-sdk/hooks) em vez disso.60Ouç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.

61 61 

62Esta página se concentra em **regras de permitir e negar** e **modos de permissão**. Para os outros passos:62Esta página se concentra em **regras de permitir e negar** e **modos de permissão**. Para os outros passos:

63 63 

64* **Hooks:** execute código personalizado para permitir, negar ou modificar solicitações de ferramentas. Consulte [Controlar execução com hooks](/pt/agent-sdk/hooks).64* **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).

65* **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](/pt/agent-sdk/user-input).65* **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).

66 66 

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

68 Regras de permitir e negar68 Regras de permitir e negar


81 81 

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

83 83 

84Use `//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](/pt/permissions#read-and-edit) para as quatro formas de âncora e como regras de arquivos de configuração são resolvidas.84Use `//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.

85 85 

86<Warning>86<Warning>

87 **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"]`](/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools) ainda chegam ao callback, mesmo quando uma regra de permitir corresponde.87 **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), e ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) ainda chegam ao callback, mesmo quando uma regra de permitir corresponde.

88 88 

89 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, enquanto uma regra com escopo como `Bash(ls *)` auto-aprova apenas chamadas correspondentes e outras chamadas de `Bash` ainda passam para o callback. Para verificações que devem ser executadas em todas as chamadas de ferramenta, use um hook [`PreToolUse`](/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`.89 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, enquanto uma regra com escopo como `Bash(ls *)` auto-aprova apenas chamadas correspondentes e outras chamadas de `Bash` 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`.

90</Warning>90</Warning>

91 91 

92Para um agente bloqueado, combine `allowedTools` com `permissionMode: "dontAsk"`. Ferramentas listadas são aprovadas, além das ferramentas que sempre solicitam no Aviso acima; qualquer outra coisa é negada completamente em vez de solicitar:92Para um agente bloqueado, combine `allowedTools` com `permissionMode: "dontAsk"`. Ferramentas listadas são aprovadas, além das ferramentas que sempre solicitam no Aviso acima; qualquer outra coisa é negada completamente em vez de solicitar:


102 **`allowed_tools` não restringe `bypassPermissions`.** `allowed_tools` apenas pré-aprova 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`.102 **`allowed_tools` não restringe `bypassPermissions`.** `allowed_tools` apenas pré-aprova 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`.

103</Warning>103</Warning>

104 104 

105Você 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](/pt/settings#permission-settings) para a sintaxe das regras.105Você 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#permission-settings) para a sintaxe das regras.

106 106 

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

108 Modos de permissão108 Modos de permissão


119| Modo | Descrição | Comportamento da ferramenta |119| Modo | Descrição | Comportamento da ferramenta |

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

121| `default` | Comportamento de permissão padrão | Sem auto-aprovações; ferramentas não correspondidas acionam seu callback `canUseTool` |121| `default` | Comportamento de permissão padrão | Sem auto-aprovações; ferramentas não correspondidas acionam seu callback `canUseTool` |

122| `dontAsk` | Negar em vez de solicitar | Qualquer coisa não pré-aprovada por `allowed_tools` ou regras é negada; ferramentas de conector [sua organização definida como `ask`](/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. `canUseTool` nunca é chamado |122| `dontAsk` | Negar em vez de solicitar | Qualquer coisa não pré-aprovada por `allowed_tools` ou regras é negada; 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. `canUseTool` nunca é chamado |

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

124| `bypassPermissions` | Ignorar verificações de permissão | As ferramentas são executadas sem solicitações de permissão, exceto ferramentas correspondidas por uma regra [`ask`](#how-permissions-are-evaluated) explícita, ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas que requerem interação do usuário (use com cuidado) |124| `bypassPermissions` | Ignorar verificações de permissão | As ferramentas são executadas sem solicitações de permissão, exceto ferramentas correspondidas por uma regra [`ask`](#how-permissions-are-evaluated) explícita, 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 (use com cuidado) |

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

126| `auto` | Aprovações classificadas por modelo | Um classificador de modelo aprova ou nega cada chamada de ferramenta. Consulte [Auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode) para disponibilidade |126| `auto` | Aprovações classificadas por modelo | Um classificador de modelo aprova ou nega cada chamada de ferramenta. Consulte [Auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) para disponibilidade |

127 127 

128<Warning>128<Warning>

129 **Herança de subagentos:** Quando o pai usa `bypassPermissions`, `acceptEdits` ou `auto`, todos os subagentos herdam esse modo e ele não pode ser substituído por subagentos. 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. Uma regra [`ask`](#how-permissions-are-evaluated) explícita, ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas que requerem interação do usuário ainda forçam uma solicitação.129 **Herança de subagentos:** Quando o pai usa `bypassPermissions`, `acceptEdits` ou `auto`, todos os subagentos herdam esse modo e ele não pode ser substituído por subagentos. 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. Uma regra [`ask`](#how-permissions-are-evaluated) explícita, 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 ainda forçam uma solicitação.

130</Warning>130</Warning>

131 131 

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


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

261</h4>261</h4>

262 262 

263Converte qualquer solicitação de permissão em uma negação. Ferramentas pré-aprovadas por `allowed_tools`, regras de permitir em `settings.json` ou um hook são executadas normalmente. Ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas que requerem interação do usuário são negadas mesmo quando uma regra de permitir corresponde. Tudo mais é negado sem chamar `canUseTool`.263Converte qualquer solicitação de permissão em uma negação. Ferramentas pré-aprovadas por `allowed_tools`, regras de permitir em `settings.json` ou um hook são executadas normalmente. 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 quando uma regra de permitir corresponde. Tudo mais é negado sem chamar `canUseTool`.

264 264 

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

266 266 


273<Warning>273<Warning>

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

275 275 

276 `allowed_tools` não restringe este modo. Todas as ferramentas são aprovadas, não apenas as que você listou. Regras de negação (`disallowed_tools`), regras explícitas de `ask` e hooks são avaliados antes da verificação do modo e ainda podem bloquear uma ferramenta. Ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas que requerem interação do usuário ainda caem através de seu callback `canUseTool`.276 `allowed_tools` não restringe este modo. Todas as ferramentas são aprovadas, não apenas as que você listou. Regras de negação (`disallowed_tools`), regras explícitas de `ask` e hooks são avaliados antes da verificação do modo e ainda podem bloquear uma ferramenta. 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 ainda caem através de seu callback `canUseTool`.

277</Warning>277</Warning>

278 278 

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

280 Modo plano (`plan`)280 Modo plano (`plan`)

281</h4>281</h4>

282 282 

283Claude 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 padrão. Edições de arquivo nunca são auto-aprovadas no modo plano, mesmo quando uma regra de permitir corresponde. Elas solicitam através de seu callback `canUseTool` em vez disso. Claude pode usar `AskUserQuestion` para esclarecer requisitos antes de finalizar o plano. Consulte [Lidar com aprovações e entrada do usuário](/pt/agent-sdk/user-input#handle-clarifying-questions) para lidar com essas solicitações.283Claude 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 padrão. Edições de arquivo nunca são auto-aprovadas no modo plano, mesmo quando uma regra de permitir corresponde. Elas solicitam através de seu callback `canUseTool` em vez disso. Claude 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.

284 284 

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

286 286 


290 290 

291Para os outros passos no fluxo de avaliação de permissões:291Para os outros passos no fluxo de avaliação de permissões:

292 292 

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

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

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

Details

18pip install claude-agent-sdk18pip install claude-agent-sdk

19```19```

20 20 

21Para uv, Windows PowerShell e configuração de chave de API, consulte [Comece no visão geral do Agent SDK](/pt/agent-sdk/overview#get-started).21Para uv, Windows PowerShell e configuração de chave de API, consulte [Comece no visão geral do Agent SDK](/docs/pt/agent-sdk/overview#get-started).

22 22 

23<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

24 Escolhendo entre `query()` e `ClaudeSDKClient`24 Escolhendo entre `query()` e `ClaudeSDKClient`


73 `query()`73 `query()`

74</h3>74</h3>

75 75 

76Cria uma nova sessão para cada interação com Claude Code por padrão. Retorna um iterador assíncrono que produz mensagens conforme chegam. Cada chamada para `query()` começa do zero sem memória de interações anteriores, a menos que você passe `continue_conversation=True` ou `resume` em [`ClaudeAgentOptions`](#claudeagentoptions). Veja [Sessions](/pt/agent-sdk/sessions).76Cria uma nova sessão para cada interação com Claude Code por padrão. Retorna um iterador assíncrono que produz mensagens conforme chegam. Cada chamada para `query()` começa do zero sem memória de interações anteriores, a menos que você passe `continue_conversation=True` ou `resume` em [`ClaudeAgentOptions`](#claudeagentoptions). Veja [Sessions](/docs/pt/agent-sdk/sessions).

77 77 

78```python theme={null}78```python theme={null}

79async def query(79async def query(


565| `interrupt()` | Envia sinal de interrupção (funciona apenas em modo de streaming) |565| `interrupt()` | Envia sinal de interrupção (funciona apenas em modo de streaming) |

566| `set_permission_mode(mode)` | Altera o modo de permissão para a sessão atual |566| `set_permission_mode(mode)` | Altera o modo de permissão para a sessão atual |

567| `set_model(model)` | Altera o modelo para a sessão atual. Passe `None` para redefinir para padrão |567| `set_model(model)` | Altera o modelo para a sessão atual. Passe `None` para redefinir para padrão |

568| `rewind_files(user_message_id)` | Restaura arquivos para seu estado na mensagem de usuário especificada. Requer `enable_file_checkpointing=True`. Veja [File checkpointing](/pt/agent-sdk/file-checkpointing) |568| `rewind_files(user_message_id)` | Restaura arquivos para seu estado na mensagem de usuário especificada. Requer `enable_file_checkpointing=True`. Veja [File checkpointing](/docs/pt/agent-sdk/file-checkpointing) |

569| `get_mcp_status()` | Obtém o status de todos os servidores MCP configurados. Retorna [`McpStatusResponse`](#mcpstatusresponse) |569| `get_mcp_status()` | Obtém o status de todos os servidores MCP configurados. Retorna [`McpStatusResponse`](#mcpstatusresponse) |

570| `reconnect_mcp_server(server_name)` | Tenta reconectar a um servidor MCP que falhou ou foi desconectado |570| `reconnect_mcp_server(server_name)` | Tenta reconectar a um servidor MCP que falhou ou foi desconectado |

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


907| Propriedade | Tipo | Padrão | Descrição |907| Propriedade | Tipo | Padrão | Descrição |

908| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |908| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

909| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Configuração de ferramentas. Use `{"type": "preset", "preset": "claude_code"}` para as ferramentas padrão do Claude Code |909| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Configuração de ferramentas. Use `{"type": "preset", "preset": "claude_code"}` para as ferramentas padrão do Claude Code |

910| `allowed_tools` | `list[str]` | `[]` | Ferramentas para auto-aprovar sem solicitar. Isso não restringe Claude apenas a essas ferramentas; ferramentas não listadas caem através de `permission_mode` e `can_use_tool`. Use `disallowed_tools` para bloquear ferramentas. Veja [Permissions](/pt/agent-sdk/permissions#allow-and-deny-rules) |910| `allowed_tools` | `list[str]` | `[]` | Ferramentas para auto-aprovar sem solicitar. Isso não restringe Claude apenas a essas ferramentas; ferramentas não listadas caem através de `permission_mode` e `can_use_tool`. Use `disallowed_tools` para bloquear ferramentas. Veja [Permissions](/docs/pt/agent-sdk/permissions#allow-and-deny-rules) |

911| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | Configuração de prompt do sistema. Passe uma string para um prompt personalizado, `{"type": "preset", "preset": "claude_code"}` para o prompt do sistema do Claude Code com `"append"` opcional, ou `{"type": "file", "path": "..."}` para carregar um prompt grande do disco. Veja [`SystemPromptPreset`](#systempromptpreset) e [`SystemPromptFile`](#systempromptfile) |911| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | Configuração de prompt do sistema. Passe uma string para um prompt personalizado, `{"type": "preset", "preset": "claude_code"}` para o prompt do sistema do Claude Code com `"append"` opcional, ou `{"type": "file", "path": "..."}` para carregar um prompt grande do disco. Veja [`SystemPromptPreset`](#systempromptpreset) e [`SystemPromptFile`](#systempromptfile) |

912| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Configurações de servidor MCP ou caminho para arquivo de configuração |912| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Configurações de servidor MCP ou caminho para arquivo de configuração |

913| `strict_mcp_config` | `bool` | `False` | Quando `True`, use apenas os servidores passados em `mcp_servers` e ignore o projeto `.mcp.json`, configurações do usuário, servidores MCP fornecidos por plugins e [conectores claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai). Mapeia para o sinalizador CLI `--strict-mcp-config` |913| `strict_mcp_config` | `bool` | `False` | Quando `True`, use apenas os servidores passados em `mcp_servers` e ignore o projeto `.mcp.json`, configurações do usuário, servidores MCP fornecidos por plugins e [conectores claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai). Mapeia para o sinalizador CLI `--strict-mcp-config` |

914| `permission_mode` | `PermissionMode \| None` | `None` | Modo de permissão para uso de ferramentas |914| `permission_mode` | `PermissionMode \| None` | `None` | Modo de permissão para uso de ferramentas |

915| `continue_conversation` | `bool` | `False` | Continua a conversa mais recente |915| `continue_conversation` | `bool` | `False` | Continua a conversa mais recente |

916| `resume` | `str \| None` | `None` | ID de sessão para retomar |916| `resume` | `str \| None` | `None` | ID de sessão para retomar |

917| `max_turns` | `int \| None` | `None` | Número máximo de turnos agênticos (rodadas de uso de ferramenta) |917| `max_turns` | `int \| None` | `None` | Número máximo de turnos agênticos (rodadas de uso de ferramenta) |

918| `max_budget_usd` | `float \| None` | `None` | Para a consulta quando a estimativa de custo do lado do cliente atinge este valor em USD. Comparado com a mesma estimativa que `total_cost_usd`; veja [Track cost and usage](/pt/agent-sdk/cost-tracking) para ressalvas de precisão |918| `max_budget_usd` | `float \| None` | `None` | Para a consulta quando a estimativa de custo do lado do cliente atinge este valor em USD. Comparado com a mesma estimativa que `total_cost_usd`; veja [Track cost and usage](/docs/pt/agent-sdk/cost-tracking) para ressalvas de precisão |

919| `disallowed_tools` | `list[str]` | `[]` | 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`. Veja [Permissions](/pt/agent-sdk/permissions#allow-and-deny-rules) |919| `disallowed_tools` | `list[str]` | `[]` | 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`. Veja [Permissions](/docs/pt/agent-sdk/permissions#allow-and-deny-rules) |

920| `enable_file_checkpointing` | `bool` | `False` | Ativa rastreamento de mudança de arquivo para retrocesso. Veja [File checkpointing](/pt/agent-sdk/file-checkpointing) |920| `enable_file_checkpointing` | `bool` | `False` | Ativa rastreamento de mudança de arquivo para retrocesso. Veja [File checkpointing](/docs/pt/agent-sdk/file-checkpointing) |

921| `model` | `str \| None` | `None` | Alias de modelo Claude ou nome de modelo completo. Veja [valores aceitos e IDs específicos do provedor](/pt/model-config#available-models) |921| `model` | `str \| None` | `None` | Alias de modelo Claude ou nome de modelo completo. Veja [valores aceitos e IDs específicos do provedor](/docs/pt/model-config#available-models) |

922| `fallback_model` | `str \| None` | `None` | Modelo de fallback a usar se o modelo primário falhar |922| `fallback_model` | `str \| None` | `None` | Modelo de fallback a usar se o modelo primário falhar |

923| `betas` | `list[SdkBeta]` | `[]` | Recursos beta para ativar. Veja [`SdkBeta`](#sdkbeta) para opções disponíveis |923| `betas` | `list[SdkBeta]` | `[]` | Recursos beta para ativar. Veja [`SdkBeta`](#sdkbeta) para opções disponíveis |

924| `output_format` | `dict[str, Any] \| None` | `None` | Formato de saída para respostas estruturadas (por exemplo, `{"type": "json_schema", "schema": {...}}`). Veja [Structured outputs](/pt/agent-sdk/structured-outputs) para detalhes |924| `output_format` | `dict[str, Any] \| None` | `None` | Formato de saída para respostas estruturadas (por exemplo, `{"type": "json_schema", "schema": {...}}`). Veja [Structured outputs](/docs/pt/agent-sdk/structured-outputs) para detalhes |

925| `permission_prompt_tool_name` | `str \| None` | `None` | Nome da ferramenta MCP para prompts de permissão |925| `permission_prompt_tool_name` | `str \| None` | `None` | Nome da ferramenta MCP para prompts de permissão |

926| `cwd` | `str \| Path \| None` | `None` | Diretório de trabalho atual |926| `cwd` | `str \| Path \| None` | `None` | Diretório de trabalho atual |

927| `cli_path` | `str \| Path \| None` | `None` | Caminho personalizado para o executável CLI do Claude Code |927| `cli_path` | `str \| Path \| None` | `None` | Caminho personalizado para o executável CLI do Claude Code |

928| `settings` | `str \| None` | `None` | Caminho para arquivo de configurações |928| `settings` | `str \| None` | `None` | Caminho para arquivo de configurações |

929| `add_dirs` | `list[str \| Path]` | `[]` | Diretórios adicionais que Claude pode acessar |929| `add_dirs` | `list[str \| Path]` | `[]` | Diretórios adicionais que Claude pode acessar |

930| `env` | `dict[str, str]` | `{}` | Variáveis de ambiente mescladas no topo do ambiente de processo herdado. Veja [Environment variables](/pt/env-vars) para variáveis que o CLI subjacente lê, e [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) para variáveis relacionadas a timeout |930| `env` | `dict[str, str]` | `{}` | Variáveis de ambiente mescladas no topo do ambiente de processo herdado. Veja [Environment variables](/docs/pt/env-vars) para variáveis que o CLI subjacente lê, e [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) para variáveis relacionadas a timeout |

931| `extra_args` | `dict[str, str \| None]` | `{}` | Argumentos CLI adicionais a passar diretamente para o CLI |931| `extra_args` | `dict[str, str \| None]` | `{}` | Argumentos CLI adicionais a passar diretamente para o CLI |

932| `max_buffer_size` | `int \| None` | `None` | Bytes máximos ao fazer buffer da saída padrão do CLI |932| `max_buffer_size` | `int \| None` | `None` | Bytes máximos ao fazer buffer da saída padrão do CLI |

933| `debug_stderr` | `Any` | `sys.stderr` | *Deprecated* - Objeto semelhante a arquivo para saída de depuração. Use callback `stderr` em vez disso |933| `debug_stderr` | `Any` | `sys.stderr` | *Deprecated* - Objeto semelhante a arquivo para saída de depuração. Use callback `stderr` em vez disso |

934| `stderr` | `Callable[[str], None] \| None` | `None` | Função de callback para saída stderr do CLI |934| `stderr` | `Callable[[str], None] \| None` | `None` | Função de callback para saída stderr do CLI |

935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Função de callback de permissão de ferramenta, invocada apenas quando o [fluxo de permissão](/pt/agent-sdk/permissions#how-permissions-are-evaluated) cai através de um prompt. Não invocada para chamadas auto-aprovadas por `allowed_tools`, regras de permissão ou `permission_mode`. `AskUserQuestion`, ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) a alcançam mesmo se você as permitiu; em modo `dontAsk` essas são negadas em vez disso. Veja [`CanUseTool`](#canusetool) para detalhes |935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Função de callback de permissão de ferramenta, invocada apenas quando o [fluxo de permissão](/docs/pt/agent-sdk/permissions#how-permissions-are-evaluated) cai através de um prompt. Não invocada para chamadas auto-aprovadas por `allowed_tools`, regras de permissão ou `permission_mode`. `AskUserQuestion`, ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) a alcançam mesmo se você as permitiu; em modo `dontAsk` essas são negadas em vez disso. Veja [`CanUseTool`](#canusetool) para detalhes |

936| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Configurações de hook para interceptar eventos |936| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Configurações de hook para interceptar eventos |

937| `user` | `str \| None` | `None` | Identificador de usuário |937| `user` | `str \| None` | `None` | Identificador de usuário |

938| `include_partial_messages` | `bool` | `False` | Inclua eventos de streaming de mensagem parcial. Quando ativado, mensagens [`StreamEvent`](#streamevent) são produzidas |938| `include_partial_messages` | `bool` | `False` | Inclua eventos de streaming de mensagem parcial. Quando ativado, mensagens [`StreamEvent`](#streamevent) são produzidas |

939| `include_hook_events` | `bool` | `False` | Inclua eventos de ciclo de vida de hook no fluxo de mensagens como objetos `HookEventMessage` |939| `include_hook_events` | `bool` | `False` | Inclua eventos de ciclo de vida de hook no fluxo de mensagens como objetos `HookEventMessage` |

940| `fork_session` | `bool` | `False` | Ao retomar com `resume`, bifurque para um novo ID de sessão em vez de continuar a sessão original |940| `fork_session` | `bool` | `False` | Ao retomar com `resume`, bifurque para um novo ID de sessão em vez de continuar a sessão original |

941| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Subagentes definidos programaticamente |941| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Subagentes definidos programaticamente |

942| `plugins` | `list[SdkPluginConfig]` | `[]` | Carregue plugins personalizados de caminhos locais. Veja [Plugins](/pt/agent-sdk/plugins) para detalhes |942| `plugins` | `list[SdkPluginConfig]` | `[]` | Carregue plugins personalizados de caminhos locais. Veja [Plugins](/docs/pt/agent-sdk/plugins) para detalhes |

943| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Configure o comportamento do sandbox programaticamente. Veja [Sandbox settings](#sandboxsettings) para detalhes |943| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Configure o comportamento do sandbox programaticamente. Veja [Sandbox settings](#sandboxsettings) para detalhes |

944| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Controle quais configurações do sistema de arquivos carregar. Passe `[]` para desabilitar configurações de usuário, projeto e local. Configurações de política gerenciada carregam independentemente; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial de organização em uma [configuração elegível](/pt/server-managed-settings#platform-availability). Veja [Use Claude Code features](/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) |944| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Controle quais configurações do sistema de arquivos carregar. Passe `[]` para desabilitar configurações de usuário, projeto e local. Configurações de política gerenciada carregam independentemente; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial de organização em uma [configuração elegível](/docs/pt/server-managed-settings#platform-availability). Veja [Use Claude Code features](/docs/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

945| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills disponíveis para a sessão. Passe `"all"` para ativar cada skill descoberto, ou uma lista de nomes de skills. Quando definido, o SDK adiciona a ferramenta Skill a `allowed_tools` automaticamente. Se você também passar `tools`, inclua `"Skill"` nessa lista. Veja [Skills](/pt/agent-sdk/skills) |945| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills disponíveis para a sessão. Passe `"all"` para ativar cada skill descoberto, ou uma lista de nomes de skills. Quando definido, o SDK adiciona a ferramenta Skill a `allowed_tools` automaticamente. Se você também passar `tools`, inclua `"Skill"` nessa lista. Veja [Skills](/docs/pt/agent-sdk/skills) |

946| `max_thinking_tokens` | `int \| None` | `None` | *Deprecated* - Tokens máximos para blocos de pensamento. Use `thinking` em vez disso |946| `max_thinking_tokens` | `int \| None` | `None` | *Deprecated* - Tokens máximos para blocos de pensamento. Use `thinking` em vez disso |

947| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Controla o comportamento de pensamento estendido. Tem precedência sobre `max_thinking_tokens` |947| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Controla o comportamento de pensamento estendido. Tem precedência sobre `max_thinking_tokens` |

948| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Nível de esforço para profundidade de pensamento. Veja [ajustar o nível de esforço](/pt/model-config#adjust-effort-level) |948| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Nível de esforço para profundidade de pensamento. Veja [ajustar o nível de esforço](/docs/pt/model-config#adjust-effort-level) |

949| `session_store` | [`SessionStore`](/pt/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Espelhe transcrições de sessão para um backend externo para que qualquer host possa retomá-las. Veja [Persist sessions to external storage](/pt/agent-sdk/session-storage) |949| `session_store` | [`SessionStore`](/docs/pt/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Espelhe transcrições de sessão para um backend externo para que qualquer host possa retomá-las. Veja [Persist sessions to external storage](/docs/pt/agent-sdk/session-storage) |

950| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quando fazer flush das entradas de transcrição espelhadas para `session_store`. `"batched"` faz flush uma vez por turno ou quando o buffer enche; `"eager"` dispara um flush de fundo após cada frame. Ignorado quando `session_store` é `None` |950| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quando fazer flush das entradas de transcrição espelhadas para `session_store`. `"batched"` faz flush uma vez por turno ou quando o buffer enche; `"eager"` dispara um flush de fundo após cada frame. Ignorado quando `session_store` é `None` |

951 951 

952<h4 id="handle-slow-or-stalled-api-responses">952<h4 id="handle-slow-or-stalled-api-responses">


966```966```

967 967 

968* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.968* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.

969* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`, limitado a `15`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff. Para execuções autônomas que precisam aguardar interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG=1`: ele tenta erros de capacidade indefinidamente, e {/* min-version: 2.1.199 */}a partir do Claude Code v2.1.199 aumenta o padrão para outros erros transitórios para `300` e remove o limite nesta variável.969* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`, limitado a `15`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff. Para execuções autônomas que precisam aguardar interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG=1`: ele tenta erros de capacidade indefinidamente, e a partir do Claude Code v2.1.199 aumenta o padrão para outros erros transitórios para `300` e remove o limite nesta variável.

970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falha e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falha e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.

971* `CLAUDE_ENABLE_STREAM_WATCHDOG` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. O watchdog está ativado por padrão para todos os provedores; defina `CLAUDE_ENABLE_STREAM_WATCHDOG=0` para desabilitá-lo. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.971* `CLAUDE_ENABLE_STREAM_WATCHDOG` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. O watchdog está ativado por padrão para todos os provedores; defina `CLAUDE_ENABLE_STREAM_WATCHDOG=0` para desabilitá-lo. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.

972 972 


1008| `type` | Sim | Deve ser `"preset"` para usar um prompt do sistema preset |1008| `type` | Sim | Deve ser `"preset"` para usar um prompt do sistema preset |

1009| `preset` | Sim | Deve ser `"claude_code"` para usar o prompt do sistema do Claude Code |1009| `preset` | Sim | Deve ser `"claude_code"` para usar o prompt do sistema do Claude Code |

1010| `append` | Não | Instruções adicionais para anexar ao prompt do sistema preset |1010| `append` | Não | Instruções adicionais para anexar ao prompt do sistema preset |

1011| `exclude_dynamic_sections` | Não | Mova contexto por sessão como diretório de trabalho, sinalizador git-repo e caminhos de memória automática do prompt do sistema para a primeira mensagem do usuário. Melhora a reutilização de cache de prompt entre usuários e máquinas. Veja [Modify system prompts](/pt/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |1011| `exclude_dynamic_sections` | Não | Mova contexto por sessão como diretório de trabalho, sinalizador git-repo e caminhos de memória automática do prompt do sistema para a primeira mensagem do usuário. Melhora a reutilização de cache de prompt entre usuários e máquinas. Veja [Modify system prompts](/docs/pt/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

1012 1012 

1013<h3 id="systempromptfile">1013<h3 id="systempromptfile">

1014 `SystemPromptFile`1014 `SystemPromptFile`

1015</h3>1015</h3>

1016 1016 

1017Configuração para carregar um prompt do sistema personalizado de um arquivo em vez de passá-lo como uma string. O SDK mapeia isso para o sinalizador CLI [`--system-prompt-file`](/pt/cli-reference#system-prompt-flags). Use a forma de arquivo quando o prompt é grande: o SDK passa um `system_prompt` string no argv do subprocess CLI, que está sujeito aos limites de comprimento de linha de comando do SO antes do SDK enviar qualquer solicitação de API. No Linux, um único argumento mais longo que aproximadamente 128 KB falha no spawn do processo com `Argument list too long`. No Windows, toda a linha de comando é limitada a aproximadamente 32 KB, então a forma de string falha em um limite inferior.1017Configuração para carregar um prompt do sistema personalizado de um arquivo em vez de passá-lo como uma string. O SDK mapeia isso para o sinalizador CLI [`--system-prompt-file`](/docs/pt/cli-reference#system-prompt-flags). Use a forma de arquivo quando o prompt é grande: o SDK passa um `system_prompt` string no argv do subprocess CLI, que está sujeito aos limites de comprimento de linha de comando do SO antes do SDK enviar qualquer solicitação de API. No Linux, um único argumento mais longo que aproximadamente 128 KB falha no spawn do processo com `Argument list too long`. No Windows, toda a linha de comando é limitada a aproximadamente 32 KB, então a forma de string falha em um limite inferior.

1018 1018 

1019```python theme={null}1019```python theme={null}

1020class SystemPromptFile(TypedDict):1020class SystemPromptFile(TypedDict):


1047 Comportamento padrão1047 Comportamento padrão

1048</h4>1048</h4>

1049 1049 

1050Quando `setting_sources` é omitido ou `None`, `query()` carrega as mesmas configurações do sistema de arquivos que o CLI do Claude Code: usuário, projeto e local. Configurações de política gerenciada são carregadas em todos os casos; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial de organização em uma [configuração elegível](/pt/server-managed-settings#platform-availability). Veja [What settingSources does not control](/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) para entradas que são lidas independentemente desta opção, e como desabilitá-las.1050Quando `setting_sources` é omitido ou `None`, `query()` carrega as mesmas configurações do sistema de arquivos que o CLI do Claude Code: usuário, projeto e local. Configurações de política gerenciada são carregadas em todos os casos; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial de organização em uma [configuração elegível](/docs/pt/server-managed-settings#platform-availability). Veja [What settingSources does not control](/docs/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) para entradas que são lidas independentemente desta opção, e como desabilitá-las.

1051 1051 

1052<h4 id="why-use-setting_sources">1052<h4 id="why-use-setting_sources">

1053 Por que usar setting\_sources1053 Por que usar setting\_sources


1257 1257 

1258Retorna um `PermissionResult` (ou `PermissionResultAllow` ou `PermissionResultDeny`).1258Retorna um `PermissionResult` (ou `PermissionResultAllow` ou `PermissionResultDeny`).

1259 1259 

1260O callback é a substituição do SDK para o prompt de permissão interativo: é invocado apenas quando o [fluxo de avaliação de permissão](/pt/agent-sdk/permissions#how-permissions-are-evaluated) se resolve para um prompt. Chamadas de ferramenta já aprovadas por uma entrada `allowed_tools`, uma regra de permissão de configurações ou o modo de permissão, como `acceptEdits` ou `bypassPermissions`, nunca o invocam. Para controlar cada chamada de ferramenta, use um [hook `PreToolUse`](/pt/agent-sdk/hooks) em vez disso.1260O callback é a substituição do SDK para o prompt de permissão interativo: é invocado apenas quando o [fluxo de avaliação de permissão](/docs/pt/agent-sdk/permissions#how-permissions-are-evaluated) se resolve para um prompt. Chamadas de ferramenta já aprovadas por uma entrada `allowed_tools`, uma regra de permissão de configurações ou o modo de permissão, como `acceptEdits` ou `bypassPermissions`, nunca o invocam. Para controlar cada chamada de ferramenta, use um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks) em vez disso.

1261 1261 

1262`AskUserQuestion`, ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) a alcançam mesmo quando uma regra de permissão corresponde. Em modo `dontAsk` essas chamadas são negadas em vez disso, sem invocar o callback.1262`AskUserQuestion`, ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) a alcançam mesmo quando uma regra de permissão corresponde. Em modo `dontAsk` essas chamadas são negadas em vez disso, sem invocar o callback.

1263 1263 

1264<h3 id="toolpermissioncontext">1264<h3 id="toolpermissioncontext">

1265 `ToolPermissionContext`1265 `ToolPermissionContext`


1606]1606]

1607```1607```

1608 1608 

1609Para informações completas sobre criação e uso de plugins, veja [Plugins](/pt/agent-sdk/plugins).1609Para informações completas sobre criação e uso de plugins, veja [Plugins](/docs/pt/agent-sdk/plugins).

1610 1610 

1611<h2 id="message-types">1611<h2 id="message-types">

1612 Tipos de Mensagem1612 Tipos de Mensagem


1749 1749 

1750| Chave | Tipo | Descrição |1750| Chave | Tipo | Descrição |

1751| ----------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1751| ----------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1752| `input_tokens` | `int` | Tokens de entrada consumidos pelo loop do agente de nível superior. [Tokens de subagente não estão incluídos](/pt/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); use `model_usage` para contabilidade de árvore completa. |1752| `input_tokens` | `int` | Tokens de entrada consumidos pelo loop do agente de nível superior. [Tokens de subagente não estão incluídos](/docs/pt/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); use `model_usage` para contabilidade de árvore completa. |

1753| `output_tokens` | `int` | Tokens de saída gerados pelo loop do agente de nível superior. Tokens de subagente não estão incluídos. |1753| `output_tokens` | `int` | Tokens de saída gerados pelo loop do agente de nível superior. Tokens de subagente não estão incluídos. |

1754| `cache_creation_input_tokens` | `int` | Tokens usados para criar novas entradas de cache. |1754| `cache_creation_input_tokens` | `int` | Tokens usados para criar novas entradas de cache. |

1755| `cache_read_input_tokens` | `int` | Tokens lidos de entradas de cache existentes. |1755| `cache_read_input_tokens` | `int` | Tokens lidos de entradas de cache existentes. |

1756 1756 

1757O dict `model_usage` mapeia nomes de modelo para uso por modelo. As chaves do dict interno usam camelCase porque o valor é passado sem modificação do processo CLI subjacente, correspondendo ao tipo TypeScript [`ModelUsage`](/pt/agent-sdk/typescript#modelusage):1757O dict `model_usage` mapeia nomes de modelo para uso por modelo. As chaves do dict interno usam camelCase porque o valor é passado sem modificação do processo CLI subjacente, correspondendo ao tipo TypeScript [`ModelUsage`](/docs/pt/agent-sdk/typescript#modelusage):

1758 1758 

1759| Chave | Tipo | Descrição |1759| Chave | Tipo | Descrição |

1760| -------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |1760| -------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |


1763| `cacheReadInputTokens` | `int` | Tokens de leitura de cache para este modelo. |1763| `cacheReadInputTokens` | `int` | Tokens de leitura de cache para este modelo. |

1764| `cacheCreationInputTokens` | `int` | Tokens de criação de cache para este modelo. |1764| `cacheCreationInputTokens` | `int` | Tokens de criação de cache para este modelo. |

1765| `webSearchRequests` | `int` | Solicitações de busca na web feitas por este modelo. |1765| `webSearchRequests` | `int` | Solicitações de busca na web feitas por este modelo. |

1766| `costUSD` | `float` | Custo estimado em USD para este modelo, computado no lado do cliente. Veja [Rastrear custo e uso](/pt/agent-sdk/cost-tracking) para ressalvas de faturamento. |1766| `costUSD` | `float` | Custo estimado em USD para este modelo, computado no lado do cliente. Veja [Rastrear custo e uso](/docs/pt/agent-sdk/cost-tracking) para ressalvas de faturamento. |

1767| `contextWindow` | `int` | Tamanho da janela de contexto para este modelo. |1767| `contextWindow` | `int` | Tamanho da janela de contexto para este modelo. |

1768| `maxOutputTokens` | `int` | Limite máximo de token de saída para este modelo. |1768| `maxOutputTokens` | `int` | Limite máximo de token de saída para este modelo. |

1769 1769 


2090 Tipos de Hook2090 Tipos de Hook

2091</h2>2091</h2>

2092 2092 

2093Para um guia abrangente sobre o uso de hooks com exemplos e padrões comuns, veja o [Guia de Hooks](/pt/agent-sdk/hooks).2093Para um guia abrangente sobre o uso de hooks com exemplos e padrões comuns, veja o [Guia de Hooks](/docs/pt/agent-sdk/hooks).

2094 2094 

2095<h3 id="hookevent">2095<h3 id="hookevent">

2096 `HookEvent`2096 `HookEvent`


2474 `HookSpecificOutput`2474 `HookSpecificOutput`

2475</h4>2475</h4>

2476 2476 

2477Um `TypedDict` contendo o nome do evento de hook e campos específicos do evento. A forma depende do valor `hookEventName`. Para detalhes completos sobre campos disponíveis por evento de hook, veja [Controlar execução com hooks](/pt/agent-sdk/hooks#outputs).2477Um `TypedDict` contendo o nome do evento de hook e campos específicos do evento. A forma depende do valor `hookEventName`. Para detalhes completos sobre campos disponíveis por evento de hook, veja [Controlar execução com hooks](/docs/pt/agent-sdk/hooks#outputs).

2478 2478 

2479Uma união discriminada de tipos de saída específicos do evento. O campo `hookEventName` determina quais campos são válidos.2479Uma união discriminada de tipos de saída específicos do evento. O campo `hookEventName` determina quais campos são válidos.

2480 2480 


2639 2639 

2640**Nome da ferramenta:** `AskUserQuestion`2640**Nome da ferramenta:** `AskUserQuestion`

2641 2641 

2642Faz perguntas de esclarecimento ao usuário durante a execução. Veja [Lidar com aprovações e entrada do usuário](/pt/agent-sdk/user-input#handle-clarifying-questions) para detalhes de uso.2642Faz perguntas de esclarecimento ao usuário durante a execução. Veja [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input#handle-clarifying-questions) para detalhes de uso.

2643 2643 

2644**Entrada:**2644**Entrada:**

2645 2645 


2717 2717 

2718Executa uma fonte de fundo e entrega cada evento para Claude para que ele possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`.2718Executa uma fonte de fundo e entrega cada evento para Claude para que ele possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`.

2719 2719 

2720Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash; uma observação de WebSocket solicita aprovação separadamente. {/* min-version: 2.1.195 */}A fonte `ws` requer Claude Code v2.1.195 ou posterior. Veja a [referência da ferramenta Monitor](/pt/tools-reference#monitor-tool) para comportamento e disponibilidade de provedor.2720Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash; uma observação de WebSocket solicita aprovação separadamente. A fonte `ws` requer Claude Code v2.1.195 ou posterior. Veja a [referência da ferramenta Monitor](/docs/pt/tools-reference#monitor-tool) para comportamento e disponibilidade de provedor.

2721 2721 

2722**Entrada:**2722**Entrada:**

2723 2723 


2995**Nome da ferramenta:** `TodoWrite`2995**Nome da ferramenta:** `TodoWrite`

2996 2996 

2997<Note>2997<Note>

2998 A partir do Claude Code v2.1.142, `TodoWrite` está desabilitado por padrão. Use `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` em seu lugar. Veja [Migrar para ferramentas Task](/pt/agent-sdk/todo-tracking#migrate-to-task-tools) para atualizar seu código de monitoramento, ou defina `CLAUDE_CODE_ENABLE_TASKS=0` para reverter para `TodoWrite`.2998 A partir do Claude Code v2.1.142, `TodoWrite` está desabilitado por padrão. Use `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` em seu lugar. Veja [Migrar para ferramentas Task](/docs/pt/agent-sdk/todo-tracking#migrate-to-task-tools) para atualizar seu código de monitoramento, ou defina `CLAUDE_CODE_ENABLE_TASKS=0` para reverter para `TodoWrite`.

2999</Note>2999</Note>

3000 3000 

3001**Entrada:**3001**Entrada:**


3699 `SandboxNetworkConfig`3699 `SandboxNetworkConfig`

3700</h3>3700</h3>

3701 3701 

3702Configuração específica de rede para modo sandbox. Essas configurações se aplicam a comandos Bash em sandbox quando `enabled` é `True` na [`SandboxSettings`](#sandboxsettings) pai. Elas não restringem a ferramenta WebFetch, que usa [regras de permissão](/pt/permissions#webfetch) em vez disso.3702Configuração específica de rede para modo sandbox. Essas configurações se aplicam a comandos Bash em sandbox quando `enabled` é `True` na [`SandboxSettings`](#sandboxsettings) pai. Elas não restringem a ferramenta WebFetch, que usa [regras de permissão](/docs/pt/permissions#webfetch) em vez disso.

3703 3703 

3704```python theme={null}3704```python theme={null}

3705class SandboxNetworkConfig(TypedDict, total=False):3705class SandboxNetworkConfig(TypedDict, total=False):


3727| `socksProxyPort` | `int` | `None` | Porta de proxy SOCKS para solicitações de rede |3727| `socksProxyPort` | `int` | `None` | Porta de proxy SOCKS para solicitações de rede |

3728 3728 

3729<Note>3729<Note>

3730 O proxy de sandbox integrado aplica a lista de permissões de rede com base no nome de host solicitado e não encerra ou inspeciona tráfego TLS, portanto técnicas como [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) podem potencialmente contorná-lo. Veja [Limitações de segurança de Sandboxing](/pt/sandboxing#security-limitations) para detalhes e [Implantação segura](/pt/agent-sdk/secure-deployment#traffic-forwarding) para configurar um proxy que encerra TLS.3730 O proxy de sandbox integrado aplica a lista de permissões de rede com base no nome de host solicitado e não encerra ou inspeciona tráfego TLS, portanto técnicas como [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) podem potencialmente contorná-lo. Veja [Limitações de segurança de Sandboxing](/docs/pt/sandboxing#security-limitations) para detalhes e [Implantação segura](/docs/pt/agent-sdk/secure-deployment#traffic-forwarding) para configurar um proxy que encerra TLS.

3731</Note>3731</Note>

3732 3732 

3733<h3 id="sandboxignoreviolations">3733<h3 id="sandboxignoreviolations">


3831 Veja também3831 Veja também

3832</h2>3832</h2>

3833 3833 

3834* [SDK overview](/pt/agent-sdk/overview) - Conceitos gerais do SDK3834* [SDK overview](/docs/pt/agent-sdk/overview) - Conceitos gerais do SDK

3835* [TypeScript SDK reference](/pt/agent-sdk/typescript) - Documentação do SDK TypeScript3835* [TypeScript SDK reference](/docs/pt/agent-sdk/typescript) - Documentação do SDK TypeScript

3836* [CLI reference](/pt/cli-reference) - Interface de linha de comando3836* [CLI reference](/docs/pt/cli-reference) - Interface de linha de comando

3837* [Common workflows](/pt/common-workflows) - Guias passo a passo3837* [Common workflows](/docs/pt/common-workflows) - Guias passo a passo

Details

17 17 

18Você pode criar subagentes de três maneiras:18Você pode criar subagentes de três maneiras:

19 19 

20* **Programaticamente**: use o parâmetro `agents` em suas opções `query()`. Veja as referências [TypeScript](/pt/agent-sdk/typescript#agentdefinition) e [Python](/pt/agent-sdk/python#agentdefinition)20* **Programaticamente**: use o parâmetro `agents` em suas opções `query()`. Veja as referências [TypeScript](/docs/pt/agent-sdk/typescript#agentdefinition) e [Python](/docs/pt/agent-sdk/python#agentdefinition)

21* **Baseado em sistema de arquivos**: defina agentes como arquivos markdown em diretórios `.claude/agents/`. Veja [definindo subagentes como arquivos](/pt/sub-agents)21* **Baseado em sistema de arquivos**: defina agentes como arquivos markdown em diretórios `.claude/agents/`. Veja [definindo subagentes como arquivos](/docs/pt/sub-agents)

22* **Propósito geral integrado**: Claude pode invocar o subagente integrado `general-purpose` a qualquer momento via a ferramenta Agent sem você definir nada22* **Propósito geral integrado**: Claude pode invocar o subagente integrado `general-purpose` a qualquer momento via a ferramenta Agent sem você definir nada

23 23 

24Este guia se concentra na abordagem programática, que é recomendada para aplicações SDK.24Este guia se concentra na abordagem programática, que é recomendada para aplicações SDK.


197| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | Não | Nível de esforço de raciocínio para este agente |197| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | Não | Nível de esforço de raciocínio para este agente |

198| `permissionMode` | `PermissionMode` | Não | Modo de permissão para execução de ferramentas dentro deste agente |198| `permissionMode` | `PermissionMode` | Não | Modo de permissão para execução de ferramentas dentro deste agente |

199 199 

200No SDK Python, nomes de campo com múltiplas palavras como `disallowedTools` e `mcpServers` mantêm sua ortografia camelCase para corresponder ao formato de transmissão em vez de seguir a convenção snake\_case do Python. Veja a referência [`AgentDefinition`](/pt/agent-sdk/python#agentdefinition) para detalhes.200No SDK Python, nomes de campo com múltiplas palavras como `disallowedTools` e `mcpServers` mantêm sua ortografia camelCase para corresponder ao formato de transmissão em vez de seguir a convenção snake\_case do Python. Veja a referência [`AgentDefinition`](/docs/pt/agent-sdk/python#agentdefinition) para detalhes.

201 201 

202Dois comportamentos de subagente mudaram no Claude Code v2.1.198:202Dois comportamentos de subagente mudaram no Claude Code v2.1.198:

203 203 

204* Subagentes são executados em fundo por padrão. Uma chamada de ferramenta Agent que omite a entrada [`run_in_background`](/pt/agent-sdk/typescript) inicia um subagente em fundo, e Claude define `run_in_background: false` quando precisa do resultado antes de continuar. Antes da v2.1.198, omitir `run_in_background` executava o subagente sincronamente. Defina o campo `background` como `true` para forçar execução em fundo para um agente específico independentemente do que Claude solicita.204* Subagentes são executados em fundo por padrão. Uma chamada de ferramenta Agent que omite a entrada [`run_in_background`](/docs/pt/agent-sdk/typescript) inicia um subagente em fundo, e Claude define `run_in_background: false` quando precisa do resultado antes de continuar. Antes da v2.1.198, omitir `run_in_background` executava o subagente sincronamente. Defina o campo `background` como `true` para forçar execução em fundo para um agente específico independentemente do que Claude solicita.

205* Um subagente herda a configuração de pensamento estendido da sessão principal. Em versões anteriores, o pensamento estendido é desabilitado dentro de subagentes independentemente da configuração da sessão principal.205* Um subagente herda a configuração de pensamento estendido da sessão principal. Em versões anteriores, o pensamento estendido é desabilitado dentro de subagentes independentemente da configuração da sessão principal.

206 206 

207<Note>207<Note>

208 {/* min-version: 2.1.172 */}A partir do Claude Code v2.1.172, subagentes podem gerar seus próprios subagentes. Um subagente cinco níveis abaixo do agente principal não pode gerar mais subagentes, independentemente de ser executado em primeiro plano ou em fundo. Para evitar que um subagente gere outros, omita `Agent` de seu array `tools` ou adicione-o a `disallowedTools`. Veja [subagentes aninhados](/pt/sub-agents#spawn-nested-subagents) para as regras de profundidade completas.208 A partir do Claude Code v2.1.172, subagentes podem gerar seus próprios subagentes. Um subagente cinco níveis abaixo do agente principal não pode gerar mais subagentes, independentemente de ser executado em primeiro plano ou em fundo. Para evitar que um subagente gere outros, omita `Agent` de seu array `tools` ou adicione-o a `disallowedTools`. Veja [subagentes aninhados](/docs/pt/sub-agents#spawn-nested-subagents) para as regras de profundidade completas.

209</Note>209</Note>

210 210 

211<h3 id="filesystem-based-definition-alternative">211<h3 id="filesystem-based-definition-alternative">

212 Definição baseada em sistema de arquivos (alternativa)212 Definição baseada em sistema de arquivos (alternativa)

213</h3>213</h3>

214 214 

215Você também pode definir subagentes como arquivos markdown em diretórios `.claude/agents/`. Veja a [documentação de subagentes Claude Code](/pt/sub-agents) para detalhes sobre essa abordagem. Agentes definidos programaticamente têm precedência sobre agentes baseados em sistema de arquivos com o mesmo nome.215Você também pode definir subagentes como arquivos markdown em diretórios `.claude/agents/`. Veja a [documentação de subagentes Claude Code](/docs/pt/sub-agents) para detalhes sobre essa abordagem. Agentes definidos programaticamente têm precedência sobre agentes baseados em sistema de arquivos com o mesmo nome.

216 216 

217<Note>217<Note>

218 Mesmo sem definir subagentes personalizados, Claude pode gerar o subagente integrado `general-purpose`. Isso é útil para delegar tarefas de pesquisa ou exploração sem criar agentes especializados. Inclua `Agent` em `allowedTools` para que essas invocações sejam aprovadas automaticamente sem um prompt de permissão.218 Mesmo sem definir subagentes personalizados, Claude pode gerar o subagente integrado `general-purpose`. Isso é útil para delegar tarefas de pesquisa ou exploração sem criar agentes especializados. Inclua `Agent` em `allowedTools` para que essas invocações sejam aprovadas automaticamente sem um prompt de permissão.


224 224 

225A janela de contexto de um subagente começa nova, sem conversa pai, mas não está vazia. O único conteúdo que você passa do pai para o subagente é a string de prompt da ferramenta Agent, então inclua quaisquer caminhos de arquivo, mensagens de erro ou decisões que o subagente precise diretamente nesse prompt.225A janela de contexto de um subagente começa nova, sem conversa pai, mas não está vazia. O único conteúdo que você passa do pai para o subagente é a string de prompt da ferramenta Agent, então inclua quaisquer caminhos de arquivo, mensagens de erro ou decisões que o subagente precise diretamente nesse prompt.

226 226 

227{/* min-version: 2.1.206 */}Um subagente que possui a ferramenta [`SendMessage`](/pt/tools-reference) começa com uma lista dos outros agentes nomeados em execução na sessão, para que saiba quais nomes pode enviar mensagens. Claude Code adiciona a lista ao primeiro turno do subagente automaticamente. Um [fork](/pt/sub-agents#fork-the-current-conversation) não recebe a lista porque herda a conversa do pai. A lista requer Claude Code v2.1.206 ou posterior.227Um subagente que possui a ferramenta [`SendMessage`](/docs/pt/tools-reference) começa com uma lista dos outros agentes nomeados em execução na sessão, para que saiba quais nomes pode enviar mensagens. Claude Code adiciona a lista ao primeiro turno do subagente automaticamente. Um [fork](/docs/pt/sub-agents#fork-the-current-conversation) não recebe a lista porque herda a conversa do pai. A lista requer Claude Code v2.1.206 ou posterior.

228 228 

229| O subagente recebe | O subagente não recebe |229| O subagente recebe | O subagente não recebe |

230| :------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------- |230| :------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------- |

231| Seu próprio prompt do sistema (`AgentDefinition.prompt`) e o prompt da ferramenta Agent | O histórico de conversa do pai ou resultados de ferramentas |231| Seu próprio prompt do sistema (`AgentDefinition.prompt`) e o prompt da ferramenta Agent | O histórico de conversa do pai ou resultados de ferramentas |

232| CLAUDE.md do projeto (carregado via [`settingSources`](/pt/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources)) | Conteúdo de skill pré-carregado, a menos que listado em `AgentDefinition.skills` |232| CLAUDE.md do projeto (carregado via [`settingSources`](/docs/pt/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources)) | Conteúdo de skill pré-carregado, a menos que listado em `AgentDefinition.skills` |

233| Definições de ferramentas (herdadas do pai, ou o subconjunto em `tools`) | O prompt do sistema do pai |233| Definições de ferramentas (herdadas do pai, ou o subconjunto em `tools`) | O prompt do sistema do pai |

234 234 

235<Note>235<Note>

236 O pai recebe a mensagem final do subagente verbatim como o resultado da ferramenta Agent, mas pode resumi-la em sua própria resposta. Para preservar a saída do subagente verbatim na resposta voltada para o usuário, inclua uma instrução para fazer isso no prompt ou opção `systemPrompt` que você passa para a chamada principal `query()`.236 O pai recebe a mensagem final do subagente verbatim como o resultado da ferramenta Agent, mas pode resumi-la em sua própria resposta. Para preservar a saída do subagente verbatim na resposta voltada para o usuário, inclua uma instrução para fazer isso no prompt ou opção `systemPrompt` que você passa para a chamada principal `query()`.

237</Note>237</Note>

238 238 

239{/* min-version: 2.1.199 */}Um erro de API que encerra o subagente antecipadamente, como um limite de taxa, nunca é entregue como seu resultado. Se um limite de taxa, sobrecarga ou erro de servidor cortar um subagente em primeiro plano que já produziu saída de texto, a ferramenta Agent retorna essa saída parcial com uma nota de que o subagente não terminou. {/* min-version: 2.1.200 */}Um subagente que não produziu nada, ou cuja única saída foram chamadas de ferramentas sem texto, falha com uma mensagem de erro, `Agent terminated early due to an API error`, seguida pelo detalhe do erro. Veja [API errors in subagents](/pt/sub-agents#api-errors-in-subagents) para o comportamento em primeiro plano e em segundo plano.239Um erro de API que encerra o subagente antecipadamente, como um limite de taxa, nunca é entregue como seu resultado. Se um limite de taxa, sobrecarga ou erro de servidor cortar um subagente em primeiro plano que já produziu saída de texto, a ferramenta Agent retorna essa saída parcial com uma nota de que o subagente não terminou. Um subagente que não produziu nada, ou cuja única saída foram chamadas de ferramentas sem texto, falha com uma mensagem de erro, `Agent terminated early due to an API error`, seguida pelo detalhe do erro. Veja [API errors in subagents](/docs/pt/sub-agents#api-errors-in-subagents) para o comportamento em primeiro plano e em segundo plano.

240 240 

241Este tratamento de saída parcial requer Claude Code v2.1.199 ou posterior. Na v2.1.199, um limite de taxa, sobrecarga ou erro de servidor deixou a forma apenas de chamadas de ferramentas com um resultado parcial vazio contendo apenas a nota de corte.241Este tratamento de saída parcial requer Claude Code v2.1.199 ou posterior. Na v2.1.199, um limite de taxa, sobrecarga ou erro de servidor deixou a forma apenas de chamadas de ferramentas com um resultado parcial vazio contendo apenas a nota de corte.

242 242 


441 441 

442Você pode retomar um subagente para continuar de onde parou em vez de começar do zero. Um subagente retomado retém seu histórico de conversa completo, incluindo todas as chamadas de ferramentas anteriores, resultados e raciocínio.442Você pode retomar um subagente para continuar de onde parou em vez de começar do zero. Um subagente retomado retém seu histórico de conversa completo, incluindo todas as chamadas de ferramentas anteriores, resultados e raciocínio.

443 443 

444Quando um subagente é concluído, o resultado da ferramenta Agent inclui um bloco de texto contendo `agentId: <id>`. Os agentes integrados [`Explore` e `Plan`](/pt/sub-agents#built-in-subagents) são de uma única execução e não retornam um `agentId`, então use um agente personalizado ou `general-purpose` quando você precisar retomar. Para retomar um subagente programaticamente:444Quando um subagente é concluído, o resultado da ferramenta Agent inclui um bloco de texto contendo `agentId: <id>`. Os agentes integrados [`Explore` e `Plan`](/docs/pt/sub-agents#built-in-subagents) são de uma única execução e não retornam um `agentId`, então use um agente personalizado ou `general-purpose` quando você precisar retomar. Para retomar um subagente programaticamente:

445 445 

4461. **Capture o ID da sessão**: extraia `session_id` de mensagens durante a primeira query4461. **Capture o ID da sessão**: extraia `session_id` de mensagens durante a primeira query

4472. **Extraia o ID do agente**: analise `agentId` do texto do resultado da ferramenta Agent4472. **Extraia o ID do agente**: analise `agentId` do texto do resultado da ferramenta Agent


661 Escalar com fluxos de trabalho dinâmicos661 Escalar com fluxos de trabalho dinâmicos

662</h2>662</h2>

663 663 

664Subagentes funcionam bem para algumas tarefas delegadas por turno. Para execuções que coordenam dezenas a centenas de agentes, use a ferramenta `Workflow`, que move a orquestração para um script que o runtime executa fora do contexto da conversa. Veja [fluxos de trabalho dinâmicos](/pt/workflows) para como fluxos de trabalho diferem da delegação de subagentes turno a turno.664Subagentes funcionam bem para algumas tarefas delegadas por turno. Para execuções que coordenam dezenas a centenas de agentes, use a ferramenta `Workflow`, que move a orquestração para um script que o runtime executa fora do contexto da conversa. Veja [fluxos de trabalho dinâmicos](/docs/pt/workflows) para como fluxos de trabalho diferem da delegação de subagentes turno a turno.

665 665 

666A ferramenta `Workflow` está disponível no TypeScript Agent SDK v0.3.149 e posterior. Inclua `Workflow` em `allowedTools` para aprovar automaticamente execuções de fluxo de trabalho. Os esquemas de entrada e saída da ferramenta estão listados na [referência TypeScript](/pt/agent-sdk/typescript#workflow).666A ferramenta `Workflow` está disponível no TypeScript Agent SDK v0.3.149 e posterior. Inclua `Workflow` em `allowedTools` para aprovar automaticamente execuções de fluxo de trabalho. Os esquemas de entrada e saída da ferramenta estão listados na [referência TypeScript](/docs/pt/agent-sdk/typescript#workflow).

667 667 

668<h2 id="troubleshooting">668<h2 id="troubleshooting">

669 Troubleshooting669 Troubleshooting


690* **`--disable-slash-commands`**: sessões iniciadas com essa flag não monitoram esses diretórios e sempre precisam de uma reinicialização para carregar novos arquivos.690* **`--disable-slash-commands`**: sessões iniciadas com essa flag não monitoram esses diretórios e sempre precisam de uma reinicialização para carregar novos arquivos.

691* **Um agente programático com o mesmo nome**: `agents` passados para `query()` substituem um agente do sistema de arquivos com o mesmo nome.691* **Um agente programático com o mesmo nome**: `agents` passados para `query()` substituem um agente do sistema de arquivos com o mesmo nome.

692 692 

693Para o formato do arquivo, veja [como escrever arquivos de subagente](/pt/sub-agents#write-subagent-files).693Para o formato do arquivo, veja [como escrever arquivos de subagente](/docs/pt/sub-agents#write-subagent-files).

694 694 

695<h3 id="long-prompt-failures-on-windows">695<h3 id="long-prompt-failures-on-windows">

696 Falhas de prompt longo no Windows696 Falhas de prompt longo no Windows


702 Documentação relacionada702 Documentação relacionada

703</h2>703</h2>

704 704 

705* [Subagentes Claude Code](/pt/sub-agents): documentação abrangente de subagentes incluindo definições baseadas em sistema de arquivos705* [Subagentes Claude Code](/docs/pt/sub-agents): documentação abrangente de subagentes incluindo definições baseadas em sistema de arquivos

706* [Fluxos de trabalho dinâmicos](/pt/workflows): orquestre muitos subagentes a partir de um script para trabalhos muito grandes para uma conversa706* [Fluxos de trabalho dinâmicos](/docs/pt/workflows): orquestre muitos subagentes a partir de um script para trabalhos muito grandes para uma conversa

707* [Visão geral do SDK](/pt/agent-sdk/overview): começando com o Claude Agent SDK707* [Visão geral do SDK](/docs/pt/agent-sdk/overview): começando com o Claude Agent SDK

Details

40 Exemplos40 Exemplos

41</h2>41</h2>

42 42 

43Antes de executar estes exemplos, instale o Claude Agent SDK seguindo o [guia de início rápido](/pt/agent-sdk/quickstart).43Antes de executar estes exemplos, instale o Claude Agent SDK seguindo o [guia de início rápido](/docs/pt/agent-sdk/quickstart).

44 44 

45Cada exemplo é executado até que o agente termine e produza sua mensagem de resultado final. Se uma sessão atingir seu limite de turnos primeiro, essa mensagem de resultado terá o subtipo `error_max_turns`. Verifique `subtype` para detectar esse encerramento.45Cada exemplo é executado até que o agente termine e produza sua mensagem de resultado final. Se uma sessão atingir seu limite de turnos primeiro, essa mensagem de resultado terá o subtipo `error_max_turns`. Verifique `subtype` para detectar esse encerramento.

46 46 

47Estes exemplos usam chamadas `query()` de um único disparo. Após produzir um resultado `error_max_turns`, `query()` lança um erro que inclui `Reached maximum number of turns`. Cada exemplo envolve seu loop em um bloco try para sair corretamente quando isso acontece.47Estes exemplos usam chamadas `query()` de um único disparo. Após produzir um resultado `error_max_turns`, `query()` lança um erro que inclui `Reached maximum number of turns`. Cada exemplo envolve seu loop em um bloco try para sair corretamente quando isso acontece.

48 48 

49Consulte [Lidar com o resultado](/pt/agent-sdk/agent-loop#handle-the-result) para os subtipos de resultado.49Consulte [Lidar com o resultado](/docs/pt/agent-sdk/agent-loop#handle-the-result) para os subtipos de resultado.

50 50 

51<h3 id="monitoring-todo-changes">51<h3 id="monitoring-todo-changes">

52 Monitorando Mudanças de Tarefas52 Monitorando Mudanças de Tarefas


253 Migrar para ferramentas Task253 Migrar para ferramentas Task

254</h2>254</h2>

255 255 

256As ferramentas Task dividem a única chamada `TodoWrite` em `TaskCreate` para cada novo item e `TaskUpdate` para cada mudança de status, com `TaskList` e `TaskGet` disponíveis para o modelo ler de volta a lista atual. Seu código de monitoramento ainda inspeciona blocos `tool_use` no fluxo do assistente, mas mantém um mapa codificado por ID de tarefa em vez de substituir a lista inteira a cada chamada. {/* min-version: 2.1.142 */}As ferramentas Task são o padrão a partir do TypeScript Agent SDK 0.3.142 e Claude Code v2.1.142, portanto nenhuma mudança em `options.env` é necessária.256As ferramentas Task dividem a única chamada `TodoWrite` em `TaskCreate` para cada novo item e `TaskUpdate` para cada mudança de status, com `TaskList` e `TaskGet` disponíveis para o modelo ler de volta a lista atual. Seu código de monitoramento ainda inspeciona blocos `tool_use` no fluxo do assistente, mas mantém um mapa codificado por ID de tarefa em vez de substituir a lista inteira a cada chamada. As ferramentas Task são o padrão a partir do TypeScript Agent SDK 0.3.142 e Claude Code v2.1.142, portanto nenhuma mudança em `options.env` é necessária.

257 257 

258| Com `TodoWrite` | Com ferramentas Task |258| Com `TodoWrite` | Com ferramentas Task |

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


338 Documentação Relacionada338 Documentação Relacionada

339</h2>339</h2>

340 340 

341* [Referência do SDK TypeScript](/pt/agent-sdk/typescript)341* [Referência do SDK TypeScript](/docs/pt/agent-sdk/typescript)

342* [Referência do SDK Python](/pt/agent-sdk/python)342* [Referência do SDK Python](/docs/pt/agent-sdk/python)

343* [Streaming vs Modo Único](/pt/agent-sdk/streaming-vs-single-mode)343* [Streaming vs Modo Único](/docs/pt/agent-sdk/streaming-vs-single-mode)

344* [Ferramentas Personalizadas](/pt/agent-sdk/custom-tools)344* [Ferramentas Personalizadas](/docs/pt/agent-sdk/custom-tools)

Details

6 6 

7> Referência completa da API para o Agent SDK TypeScript, incluindo todas as funções, tipos e interfaces.7> Referência completa da API para o Agent SDK TypeScript, incluindo todas as funções, tipos e interfaces.

8 8 

9<script src="/components/typescript-sdk-type-links.js" defer />9<script src="/docs/components/typescript-sdk-type-links.js" defer />

10 10 

11<h2 id="installation">11<h2 id="installation">

12 Instalação12 Instalação


296</h4>296</h4>

297 297 

298| Propriedade | Tipo | Descrição |298| Propriedade | Tipo | Descrição |

299| :------------------- | :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |299| :------------------- | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

300| `type` | `"user" \| "assistant"` | Papel da mensagem |300| `type` | `"user" \| "assistant"` | Papel da mensagem |

301| `uuid` | `string` | Identificador único de mensagem |301| `uuid` | `string` | Identificador único de mensagem |

302| `session_id` | `string` | Sessão a que esta mensagem pertence |302| `session_id` | `string` | Sessão a que esta mensagem pertence |

303| `message` | `unknown` | Payload de mensagem bruta da transcrição |303| `message` | `unknown` | Payload de mensagem bruta da transcrição |

304| `parent_tool_use_id` | `string \| null` | Para mensagens de subagente, o `tool_use_id` da chamada de ferramenta `Agent` geradora. `null` para mensagens de sessão principal e sessões mais antigas |304| `parent_tool_use_id` | `string \| null` | Para mensagens de subagente, o `tool_use_id` da chamada de ferramenta `Agent` geradora. `null` para mensagens de sessão principal e sessões mais antigas |

305| `parent_agent_id` | `string \| null` | Para mensagens de um [subagente aninhado](/pt/sub-agents#spawn-nested-subagents), o `agentId` do subagente que o gerou. `null` para mensagens de sessão principal, mensagens de subagentes de nível superior e sessões mais antigas. {/* min-version: 2.1.202 */}Requer Claude Code v2.1.202 ou posterior |305| `parent_agent_id` | `string \| null` | Para mensagens de um [subagente aninhado](/docs/pt/sub-agents#spawn-nested-subagents), o `agentId` do subagente que o gerou. `null` para mensagens de sessão principal, mensagens de subagentes de nível superior e sessões mais antigas. Requer Claude Code v2.1.202 ou posterior |

306 306 

307<h4 id="example-3">307<h4 id="example-3">

308 Exemplo308 Exemplo


423| :------------------------------ | :------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |423| :------------------------------ | :------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

424| `options.cwd` | `string` | `process.cwd()` | Diretório para resolver configurações de projeto e local relativas a |424| `options.cwd` | `string` | `process.cwd()` | Diretório para resolver configurações de projeto e local relativas a |

425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Todas as fontes | Quais fontes do sistema de arquivos carregar. Passe `[]` para pular configurações de usuário, projeto e local. Configurações de política gerenciada carregam em todos os casos. Configurações gerenciadas pelo servidor são obtidas de `serverManagedSettings` quando o host as passa, ou lidas do cache em disco do CLI caso contrário; o snapshot não as busca da rede |425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Todas as fontes | Quais fontes do sistema de arquivos carregar. Passe `[]` para pular configurações de usuário, projeto e local. Configurações de política gerenciada carregam em todos os casos. Configurações gerenciadas pelo servidor são obtidas de `serverManagedSettings` quando o host as passa, ou lidas do cache em disco do CLI caso contrário; o snapshot não as busca da rede |

426| `options.managedSettings` | `Settings` | `undefined` | Configurações de política restritiva fornecidas pelo host de incorporação. Descartadas por padrão quando uma camada gerenciada implantada pelo administrador está presente; mescladas sob essa camada quando [`parentSettingsBehavior`](/pt/settings#available-settings) é `"merge"`. Chaves não restritivas como `model` são silenciosamente descartadas para que essa opção possa apertar a política gerenciada, mas não afrouxá-la |426| `options.managedSettings` | `Settings` | `undefined` | Configurações de política restritiva fornecidas pelo host de incorporação. Descartadas por padrão quando uma camada gerenciada implantada pelo administrador está presente; mescladas sob essa camada quando [`parentSettingsBehavior`](/docs/pt/settings#available-settings) é `"merge"`. Chaves não restritivas como `model` são silenciosamente descartadas para que essa opção possa apertar a política gerenciada, mas não afrouxá-la |

427| `options.serverManagedSettings` | `Settings` | `undefined` | Payload de configurações gerenciadas pelo servidor de `/api/claude_code/settings`. Chaves não restritivas passam sem filtro |427| `options.serverManagedSettings` | `Settings` | `undefined` | Payload de configurações gerenciadas pelo servidor de `/api/claude_code/settings`. Chaves não restritivas passam sem filtro |

428 428 

429<h4 id="return-type-resolvedsettings">429<h4 id="return-type-resolvedsettings">


474| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Defina subagentes programaticamente |474| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Defina subagentes programaticamente |

475| `agentProgressSummaries` | `boolean` | `false` | Quando `true`, gera resumos de progresso de uma linha para subagentes e os encaminha em eventos [`task_progress`](#sdktaskprogressmessage) através do campo `summary`. Aplica-se a subagentes em primeiro plano e em segundo plano |475| `agentProgressSummaries` | `boolean` | `false` | Quando `true`, gera resumos de progresso de uma linha para subagentes e os encaminha em eventos [`task_progress`](#sdktaskprogressmessage) através do campo `summary`. Aplica-se a subagentes em primeiro plano e em segundo plano |

476| `allowDangerouslySkipPermissions` | `boolean` | `false` | Ativar bypass de permissões. Obrigatório ao usar `permissionMode: 'bypassPermissions'` |476| `allowDangerouslySkipPermissions` | `boolean` | `false` | Ativar bypass de permissões. Obrigatório ao usar `permissionMode: 'bypassPermissions'` |

477| `allowedTools` | `string[]` | `[]` | Ferramentas para auto-aprovar sem solicitar. Isso não restringe Claude apenas a essas ferramentas; ferramentas não listadas caem em `permissionMode` e `canUseTool`. Use `disallowedTools` para bloquear ferramentas. Veja [Permissões](/pt/agent-sdk/permissions#allow-and-deny-rules) |477| `allowedTools` | `string[]` | `[]` | Ferramentas para auto-aprovar sem solicitar. Isso não restringe Claude apenas a essas ferramentas; ferramentas não listadas caem em `permissionMode` e `canUseTool`. Use `disallowedTools` para bloquear ferramentas. Veja [Permissões](/docs/pt/agent-sdk/permissions#allow-and-deny-rules) |

478| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Ativar recursos beta |478| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Ativar recursos beta |

479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Função de permissão personalizada, invocada apenas quando o [fluxo de permissão](/pt/agent-sdk/permissions#how-permissions-are-evaluated) cai em um prompt. Não invocada para chamadas auto-aprovadas por `allowedTools`, regras de permissão, ou `permissionMode`. `AskUserQuestion`, ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) a alcançam mesmo se você as permitiu; em modo `dontAsk` essas são negadas em vez disso. Veja [`CanUseTool`](#canusetool) para detalhes |479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Função de permissão personalizada, invocada apenas quando o [fluxo de permissão](/docs/pt/agent-sdk/permissions#how-permissions-are-evaluated) cai em um prompt. Não invocada para chamadas auto-aprovadas por `allowedTools`, regras de permissão, ou `permissionMode`. `AskUserQuestion`, ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) a alcançam mesmo se você as permitiu; em modo `dontAsk` essas são negadas em vez disso. Veja [`CanUseTool`](#canusetool) para detalhes |

480| `continue` | `boolean` | `false` | Continuar a conversa mais recente |480| `continue` | `boolean` | `false` | Continuar a conversa mais recente |

481| `cwd` | `string` | `process.cwd()` | Diretório de trabalho atual |481| `cwd` | `string` | `process.cwd()` | Diretório de trabalho atual |

482| `debug` | `boolean` | `false` | Ativar modo de depuração para o processo Claude Code |482| `debug` | `boolean` | `false` | Ativar modo de depuração para o processo Claude Code |

483| `debugFile` | `string` | `undefined` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração |483| `debugFile` | `string` | `undefined` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração |

484| `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`. Veja [Permissões](/pt/agent-sdk/permissions#allow-and-deny-rules) |484| `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`. Veja [Permissões](/docs/pt/agent-sdk/permissions#allow-and-deny-rules) |

485| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | Padrão do modelo | Controla quanto esforço Claude coloca em sua resposta. Funciona com pensamento adaptativo para guiar a profundidade do pensamento. Veja [ajustar o nível de esforço](/pt/model-config#adjust-effort-level) |485| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | Padrão do modelo | Controla quanto esforço Claude coloca em sua resposta. Funciona com pensamento adaptativo para guiar a profundidade do pensamento. Veja [ajustar o nível de esforço](/docs/pt/model-config#adjust-effort-level) |

486| `enableFileCheckpointing` | `boolean` | `false` | Ativar rastreamento de mudanças de arquivo para retrocesso. Veja [File checkpointing](/pt/agent-sdk/file-checkpointing) |486| `enableFileCheckpointing` | `boolean` | `false` | Ativar rastreamento de mudanças de arquivo para retrocesso. Veja [File checkpointing](/docs/pt/agent-sdk/file-checkpointing) |

487| `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](/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 |487| `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 |

488| `executable` | `'bun' \| 'deno' \| 'node'` | Auto-detectado | Runtime JavaScript a usar |488| `executable` | `'bun' \| 'deno' \| 'node'` | Auto-detectado | Runtime JavaScript a usar |

489| `executableArgs` | `string[]` | `[]` | Argumentos a passar para o executável |489| `executableArgs` | `string[]` | `[]` | Argumentos a passar para o executável |

490| `extraArgs` | `Record<string, string \| null>` | `{}` | Argumentos adicionais |490| `extraArgs` | `Record<string, string \| null>` | `{}` | Argumentos adicionais |


496| `includePartialMessages` | `boolean` | `false` | Incluir eventos de mensagem parcial |496| `includePartialMessages` | `boolean` | `false` | Incluir eventos de mensagem parcial |

497| `loadTimeoutMs` | `number` | `60000` | *Alfa.* Timeout em milissegundos para cada chamada `sessionStore.load()` e `sessionStore.listSubkeys()` durante materialização de retomada. Se o adaptador não se resolver dentro desta janela, a consulta falha em vez de travar. Ignorado quando `sessionStore` não está definido |497| `loadTimeoutMs` | `number` | `60000` | *Alfa.* Timeout em milissegundos para cada chamada `sessionStore.load()` e `sessionStore.listSubkeys()` durante materialização de retomada. Se o adaptador não se resolver dentro desta janela, a consulta falha em vez de travar. Ignorado quando `sessionStore` não está definido |

498| `managedSettings` | `Settings` | `undefined` | Configurações de nível de política fornecidas pelo processo pai que está gerando. Descartadas quando uma camada de configurações gerenciadas controlada por TI já existe na máquina, a menos que esse administrador opte por `parentSettingsBehavior: 'merge'`. Filtradas apenas para chaves restritivas independentemente |498| `managedSettings` | `Settings` | `undefined` | Configurações de nível de política fornecidas pelo processo pai que está gerando. Descartadas quando uma camada de configurações gerenciadas controlada por TI já existe na máquina, a menos que esse administrador opte por `parentSettingsBehavior: 'merge'`. Filtradas apenas para chaves restritivas independentemente |

499| `maxBudgetUsd` | `number` | `undefined` | Parar a consulta quando a estimativa de custo do lado do cliente atingir este valor em USD. Comparado com a mesma estimativa que `total_cost_usd`; veja [Rastrear custo e uso](/pt/agent-sdk/cost-tracking) para ressalvas de precisão |499| `maxBudgetUsd` | `number` | `undefined` | Parar a consulta quando a estimativa de custo do lado do cliente atingir este valor em USD. Comparado com a mesma estimativa que `total_cost_usd`; veja [Rastrear custo e uso](/docs/pt/agent-sdk/cost-tracking) para ressalvas de precisão |

500| `maxThinkingTokens` | `number` | `undefined` | *Descontinuado:* Use `thinking` em vez disso. Tokens máximos para processo de pensamento |500| `maxThinkingTokens` | `number` | `undefined` | *Descontinuado:* Use `thinking` em vez disso. Tokens máximos para processo de pensamento |

501| `maxTurns` | `number` | `undefined` | Turnos agênticos máximos (round trips de uso de ferramenta) |501| `maxTurns` | `number` | `undefined` | Turnos agênticos máximos (round trips de uso de ferramenta) |

502| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Configurações de servidor MCP |502| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Configurações de servidor MCP |

503| `model` | `string` | Padrão da CLI | Alias de modelo Claude ou nome de modelo completo. Veja [valores aceitos e IDs específicos do provedor](/pt/model-config#available-models) |503| `model` | `string` | Padrão da CLI | Alias de modelo Claude ou nome de modelo completo. Veja [valores aceitos e IDs específicos do provedor](/docs/pt/model-config#available-models) |

504| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Callback para lidar com solicitações de elicitação MCP. Chamado quando um servidor MCP solicita entrada do usuário e nenhum hook a trata primeiro. Quando não fornecido, solicitações de elicitação não tratadas são recusadas automaticamente |504| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Callback para lidar com solicitações de elicitação MCP. Chamado quando um servidor MCP solicita entrada do usuário e nenhum hook a trata primeiro. Quando não fornecido, solicitações de elicitação não tratadas são recusadas automaticamente |

505| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Defina o formato de saída para resultados de agente. Veja [Structured outputs](/pt/agent-sdk/structured-outputs) para detalhes |505| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Defina o formato de saída para resultados de agente. Veja [Structured outputs](/docs/pt/agent-sdk/structured-outputs) para detalhes |

506| `outputStyle` | `string` | `undefined` | Não é um campo `Options`. Defina `outputStyle` no objeto [`settings`](/pt/settings) inline ou em um arquivo de configurações. Veja [Ativar um estilo de saída](/pt/agent-sdk/modifying-system-prompts#activate-an-output-style) |506| `outputStyle` | `string` | `undefined` | Não é um campo `Options`. Defina `outputStyle` no objeto [`settings`](/docs/pt/settings) inline ou em um arquivo de configurações. Veja [Ativar um estilo de saída](/docs/pt/agent-sdk/modifying-system-prompts#activate-an-output-style) |

507| `pathToClaudeCodeExecutable` | `string` | Auto-resolvido do binário nativo agrupado | Caminho para executável Claude Code. Apenas necessário se dependências opcionais foram puladas durante a instalação ou sua plataforma não está no conjunto suportado |507| `pathToClaudeCodeExecutable` | `string` | Auto-resolvido do binário nativo agrupado | Caminho para executável Claude Code. Apenas necessário se dependências opcionais foram puladas durante a instalação ou sua plataforma não está no conjunto suportado |

508| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | Modo de permissão para a sessão |508| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | Modo de permissão para a sessão |

509| `permissionPromptToolName` | `string` | `undefined` | Nome da ferramenta MCP para prompts de permissão |509| `permissionPromptToolName` | `string` | `undefined` | Nome da ferramenta MCP para prompts de permissão |

510| `persistSession` | `boolean` | `true` | Quando `false`, desativa persistência de sessão em disco. Sessões não podem ser retomadas depois |510| `persistSession` | `boolean` | `true` | Quando `false`, desativa persistência de sessão em disco. Sessões não podem ser retomadas depois |

511| `planModeInstructions` | `string` | `undefined` | Instruções de fluxo de trabalho personalizado para Plan Mode. Quando `permissionMode` é `'plan'`, esta string substitui o corpo de fluxo de trabalho de Plan Mode padrão. A CLI ainda o envolve com o preâmbulo de imposição somente leitura e o rodapé do protocolo ExitPlanMode |511| `planModeInstructions` | `string` | `undefined` | Instruções de fluxo de trabalho personalizado para Plan Mode. Quando `permissionMode` é `'plan'`, esta string substitui o corpo de fluxo de trabalho de Plan Mode padrão. A CLI ainda o envolve com o preâmbulo de imposição somente leitura e o rodapé do protocolo ExitPlanMode |

512| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Carregar plugins personalizados de caminhos locais. Veja [Plugins](/pt/agent-sdk/plugins) para detalhes |512| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Carregar plugins personalizados de caminhos locais. Veja [Plugins](/docs/pt/agent-sdk/plugins) para detalhes |

513| `promptSuggestions` | `boolean` | `false` | Ativar sugestões de prompt. Emite uma mensagem `prompt_suggestion` após cada turno com um prompt de usuário previsto |513| `promptSuggestions` | `boolean` | `false` | Ativar sugestões de prompt. Emite uma mensagem `prompt_suggestion` após cada turno com um prompt de usuário previsto |

514| `resume` | `string` | `undefined` | ID de sessão a retomar |514| `resume` | `string` | `undefined` | ID de sessão a retomar |

515| `resumeSessionAt` | `string` | `undefined` | Retomar sessão em um UUID de mensagem específico |515| `resumeSessionAt` | `string` | `undefined` | Retomar sessão em um UUID de mensagem específico |

516| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Configurar comportamento de sandbox programaticamente. Veja [Sandbox settings](#sandboxsettings) para detalhes |516| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Configurar comportamento de sandbox programaticamente. Veja [Sandbox settings](#sandboxsettings) para detalhes |

517| `sessionId` | `string` | Auto-gerado | Use um UUID específico para a sessão em vez de auto-gerar um |517| `sessionId` | `string` | Auto-gerado | Use um UUID específico para a sessão em vez de auto-gerar um |

518| `sessionStore` | [`SessionStore`](/pt/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Espelhar transcrições de sessão para um backend externo para que qualquer host possa retomá-las. Veja [Persist sessions to external storage](/pt/agent-sdk/session-storage) |518| `sessionStore` | [`SessionStore`](/docs/pt/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Espelhar transcrições de sessão para um backend externo para que qualquer host possa retomá-las. Veja [Persist sessions to external storage](/docs/pt/agent-sdk/session-storage) |

519| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alfa.* Modo de flush para `sessionStore`. Ignorado quando `sessionStore` não está definido |519| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alfa.* Modo de flush para `sessionStore`. Ignorado quando `sessionStore` não está definido |

520| `settings` | `string \| Settings` | `undefined` | Objeto de [configurações](/pt/settings) inline ou caminho para um arquivo de configurações. Popula a camada de configurações de flag na [ordem de precedência](/pt/settings#settings-precedence). Altere em tempo de execução com [`applyFlagSettings()`](#applyflagsettings) |520| `settings` | `string \| Settings` | `undefined` | Objeto de [configurações](/docs/pt/settings) inline ou caminho para um arquivo de configurações. Popula a camada de configurações de flag na [ordem de precedência](/docs/pt/settings#settings-precedence). Altere em tempo de execução com [`applyFlagSettings()`](#applyflagsettings) |

521| `settingSources` | [`SettingSource`](#settingsource)`[]` | Padrões da CLI (todas as fontes) | Controle quais configurações do sistema de arquivos carregar. Passe `[]` para desativar configurações de usuário, projeto e local. Configurações de política gerenciada carregam independentemente; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial organizacional em uma [configuração elegível](/pt/server-managed-settings#platform-availability). Veja [Use Claude Code features](/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) |521| `settingSources` | [`SettingSource`](#settingsource)`[]` | Padrões da CLI (todas as fontes) | Controle quais configurações do sistema de arquivos carregar. Passe `[]` para desativar configurações de usuário, projeto e local. Configurações de política gerenciada carregam independentemente; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial organizacional em uma [configuração elegível](/docs/pt/server-managed-settings#platform-availability). Veja [Use Claude Code features](/docs/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

522| `skills` | `string[] \| 'all'` | `undefined` | Skills disponíveis para a sessão. Passe `'all'` para ativar cada skill descoberta, ou uma lista de nomes de skills. Quando definido, o SDK ativa a ferramenta Skill automaticamente em `allowedTools`. Se você também passar `tools`, inclua `'Skill'` nessa lista. Veja [Skills](/pt/agent-sdk/skills) |522| `skills` | `string[] \| 'all'` | `undefined` | Skills disponíveis para a sessão. Passe `'all'` para ativar cada skill descoberta, ou uma lista de nomes de skills. Quando definido, o SDK ativa a ferramenta Skill automaticamente em `allowedTools`. Se você também passar `tools`, inclua `'Skill'` nessa lista. Veja [Skills](/docs/pt/agent-sdk/skills) |

523| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Função personalizada para gerar o processo Claude Code. Use para executar Claude Code em VMs, contêineres ou ambientes remotos |523| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Função personalizada para gerar o processo Claude Code. Use para executar Claude Code em VMs, contêineres ou ambientes remotos |

524| `stderr` | `(data: string) => void` | `undefined` | Callback para saída stderr |524| `stderr` | `(data: string) => void` | `undefined` | Callback para saída stderr |

525| `strictMcpConfig` | `boolean` | `false` | Use apenas os servidores passados em `mcpServers` e ignore o projeto `.mcp.json`, configurações do usuário, servidores MCP fornecidos por plugin e [conectores claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) |525| `strictMcpConfig` | `boolean` | `false` | Use apenas os servidores passados em `mcpServers` e ignore o projeto `.mcp.json`, configurações do usuário, servidores MCP fornecidos por plugin e [conectores claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) |

526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (prompt mínimo) | Configuração de prompt do sistema. Passe uma string para prompt personalizado, ou `{ type: 'preset', preset: 'claude_code' }` para usar o prompt do sistema do Claude Code. Ao usar a forma de objeto preset, adicione `append` para estendê-lo com instruções adicionais, e defina `excludeDynamicSections: true` para mover contexto por sessão para a primeira mensagem do usuário para [melhor reutilização de cache de prompt entre máquinas](/pt/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (prompt mínimo) | Configuração de prompt do sistema. Passe uma string para prompt personalizado, ou `{ type: 'preset', preset: 'claude_code' }` para usar o prompt do sistema do Claude Code. Ao usar a forma de objeto preset, adicione `append` para estendê-lo com instruções adicionais, e defina `excludeDynamicSections: true` para mover contexto por sessão para a primeira mensagem do usuário para [melhor reutilização de cache de prompt entre máquinas](/docs/pt/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

527| `taskBudget` | `{ total: number }` | `undefined` | *Alfa.* Orçamento de tarefa do lado da API em tokens. Quando definido, o modelo é informado sobre seu orçamento de token restante para que possa controlar o uso de ferramentas e encerrar antes do limite |527| `taskBudget` | `{ total: number }` | `undefined` | *Alfa.* Orçamento de tarefa do lado da API em tokens. Quando definido, o modelo é informado sobre seu orçamento de token restante para que possa controlar o uso de ferramentas e encerrar antes do limite |

528| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` para modelos suportados | Controla o comportamento de pensamento/raciocínio do Claude. Veja [`ThinkingConfig`](#thinkingconfig) para opções |528| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` para modelos suportados | Controla o comportamento de pensamento/raciocínio do Claude. Veja [`ThinkingConfig`](#thinkingconfig) para opções |

529| `title` | `string` | `undefined` | Título de exibição para a sessão. Ao retomar via `resume` ou `continue`, o título persistido da sessão retomada tem precedência; use [`renameSession()`](#renamesession) para renomear uma sessão existente |529| `title` | `string` | `undefined` | Título de exibição para a sessão. Ao retomar via `resume` ou `continue`, o título persistido da sessão retomada tem precedência; use [`renameSession()`](#renamesession) para renomear uma sessão existente |


552```552```

553 553 

554* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.554* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.

555* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`, limitado a `15`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff. Para execuções sem supervisão que precisam aguardar através de interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG=1`: ele tenta erros de capacidade indefinidamente, e {/* min-version: 2.1.199 */}a partir do Claude Code v2.1.199 aumenta o padrão para outros erros transitórios para `300` e remove o limite nesta variável.555* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`, limitado a `15`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff. Para execuções sem supervisão que precisam aguardar através de interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG=1`: ele tenta erros de capacidade indefinidamente, e a partir do Claude Code v2.1.199 aumenta o padrão para outros erros transitórios para `300` e remove o limite nesta variável.

556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falhada e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falhada e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.

557* `CLAUDE_ENABLE_STREAM_WATCHDOG` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. O watchdog está ativado por padrão para todos os provedores; defina `CLAUDE_ENABLE_STREAM_WATCHDOG=0` para desativá-lo. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.557* `CLAUDE_ENABLE_STREAM_WATCHDOG` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. O watchdog está ativado por padrão para todos os provedores; defina `CLAUDE_ENABLE_STREAM_WATCHDOG=0` para desativá-lo. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.

558 558 


594</h4>594</h4>

595 595 

596| Método | Descrição |596| Método | Descrição |

597| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |597| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

598| `interrupt()` | Interrompe a consulta. Apenas disponível em modo de entrada de transmissão. {/* min-version: 2.1.205 */}Quando a CLI anuncia a capacidade `interrupt_receipt_v1` em [`SDKSystemMessage.capabilities`](#sdksystemmessage), resolve com um [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listando as mensagens enfileiradas que sobrevivem à interrupção. Resolve `undefined` em CLIs anteriores a v2.1.205 |598| `interrupt()` | Interrompe a consulta. Apenas disponível em modo de entrada de transmissão. Quando a CLI anuncia a capacidade `interrupt_receipt_v1` em [`SDKSystemMessage.capabilities`](#sdksystemmessage), resolve com um [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) listando as mensagens enfileiradas que sobrevivem à interrupção. Resolve `undefined` em CLIs anteriores a v2.1.205 |

599| `rewindFiles(userMessageId, options?)` | Restaura arquivos para seu estado na mensagem de usuário especificada. Passe `{ dryRun: true }` para visualizar mudanças. Requer `enableFileCheckpointing: true`. Veja [File checkpointing](/pt/agent-sdk/file-checkpointing) |599| `rewindFiles(userMessageId, options?)` | Restaura arquivos para seu estado na mensagem de usuário especificada. Passe `{ dryRun: true }` para visualizar mudanças. Requer `enableFileCheckpointing: true`. Veja [File checkpointing](/docs/pt/agent-sdk/file-checkpointing) |

600| `setPermissionMode()` | Altera o modo de permissão (apenas disponível em modo de entrada de transmissão) |600| `setPermissionMode()` | Altera o modo de permissão (apenas disponível em modo de entrada de transmissão) |

601| `setModel()` | Altera o modelo (apenas disponível em modo de entrada de transmissão) |601| `setModel()` | Altera o modelo (apenas disponível em modo de entrada de transmissão) |

602| `setMaxThinkingTokens()` | *Descontinuado:* Use a opção `thinking` em vez disso. Altera os tokens de pensamento máximos. Passar `null` redefine o pensamento para o padrão da sessão: uma substituição no meio da sessão é limpa, e o pensamento permanece desativado para sessões que o têm desativado |602| `setMaxThinkingTokens()` | *Descontinuado:* Use a opção `thinking` em vez disso. Altera os tokens de pensamento máximos. Passar `null` redefine o pensamento para o padrão da sessão: uma substituição no meio da sessão é limpa, e o pensamento permanece desativado para sessões que o têm desativado |

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

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

605| `reinitialize()` | {/* min-version: 2.1.195 */}Re-envia a solicitação de controle `initialize` para a CLI em execução e retorna um resultado novo em vez do resultado de primeira conexão em cache. Use-o após uma lacuna de transporte, como reconectar a uma sessão após uma desconexão, para que solicitações de permissão pendentes alcancem seu callback `canUseTool` novamente. Torne o callback idempotente por ID de solicitação, porque uma solicitação cuja resposta foi perdida é despachada novamente. Requer Claude Code v2.1.195 ou posterior |605| `reinitialize()` | Re-envia a solicitação de controle `initialize` para a CLI em execução e retorna um resultado novo em vez do resultado de primeira conexão em cache. Use-o após uma lacuna de transporte, como reconectar a uma sessão após uma desconexão, para que solicitações de permissão pendentes alcancem seu callback `canUseTool` novamente. Torne o callback idempotente por ID de solicitação, porque uma solicitação cuja resposta foi perdida é despachada novamente. Requer Claude Code v2.1.195 ou posterior |

606| `supportedCommands()` | Retorna comandos slash disponíveis |606| `supportedCommands()` | Retorna comandos slash disponíveis |

607| `supportedModels()` | Retorna modelos disponíveis com informações de exibição |607| `supportedModels()` | Retorna modelos disponíveis com informações de exibição |

608| `supportedAgents()` | Retorna subagentes disponíveis como [`AgentInfo`](#agentinfo)`[]` |608| `supportedAgents()` | Retorna subagentes disponíveis como [`AgentInfo`](#agentinfo)`[]` |


619 `applyFlagSettings()`619 `applyFlagSettings()`

620</h4>620</h4>

621 621 

622Altera qualquer [configuração](/pt/settings) em uma sessão em execução sem reiniciar a consulta. Use-a quando uma configuração que não tem um setter dedicado precisa mudar no meio da sessão, como apertar `permissions` depois que o agente lê entrada não confiável. `setModel()` e `setPermissionMode()` são setters dedicados para essas duas chaves; `applyFlagSettings()` é a forma geral que aceita qualquer subconjunto das chaves de configurações, e passar `model` aqui se comporta igual a `setModel()`.622Altera qualquer [configuração](/docs/pt/settings) em uma sessão em execução sem reiniciar a consulta. Use-a quando uma configuração que não tem um setter dedicado precisa mudar no meio da sessão, como apertar `permissions` depois que o agente lê entrada não confiável. `setModel()` e `setPermissionMode()` são setters dedicados para essas duas chaves; `applyFlagSettings()` é a forma geral que aceita qualquer subconjunto das chaves de configurações, e passar `model` aqui se comporta igual a `setModel()`.

623 623 

624Apenas algumas chaves têm efeito no meio da sessão:624Apenas algumas chaves têm efeito no meio da sessão:

625 625 

626* **Aplicadas no próximo turno**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Mudar `agent` também aplica a substituição de modelo, hooks e prompt do sistema desse agente no próximo turno.626* **Aplicadas no próximo turno**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Mudar `agent` também aplica a substituição de modelo, hooks e prompt do sistema desse agente no próximo turno.

627* **Sem efeito no meio da sessão**: as opções de prompt do sistema. Estes são resolvidos uma vez na inicialização, então a sessão em execução mantém o valor original mesmo que a chamada tenha sucesso. Para alterá-los, inicie uma nova sessão.627* **Sem efeito no meio da sessão**: as opções de prompt do sistema. Estes são resolvidos uma vez na inicialização, então a sessão em execução mantém o valor original mesmo que a chamada tenha sucesso. Para alterá-los, inicie uma nova sessão.

628 628 

629`effortLevel` aceita um nome de [nível de esforço](/pt/model-config#adjust-effort-level). Também aceita `"ultracode"`, que executa a sessão em esforço `xhigh` e ativa [ultracode](/pt/workflows#let-claude-decide-with-ultracode). O tipo `Settings` declara `effortLevel` sem esse valor, então passe o equivalente `{ ultracode: true }` em TypeScript. {/* min-version: 2.1.203 */}O valor `ultracode` requer Claude Code v2.1.203 ou posterior e é aceito apenas por `applyFlagSettings()`, não pela chave `effortLevel` em um arquivo de configurações.629`effortLevel` aceita um nome de [nível de esforço](/docs/pt/model-config#adjust-effort-level). Também aceita `"ultracode"`, que executa a sessão em esforço `xhigh` e ativa [ultracode](/docs/pt/workflows#let-claude-decide-with-ultracode). O tipo `Settings` declara `effortLevel` sem esse valor, então passe o equivalente `{ ultracode: true }` em TypeScript. O valor `ultracode` requer Claude Code v2.1.203 ou posterior e é aceito apenas por `applyFlagSettings()`, não pela chave `effortLevel` em um arquivo de configurações.

630 630 

631Os valores são escritos na camada de configurações de flag, a mesma camada que a opção `settings` inline de `query()` popula na inicialização. Configurações de flag ficam perto do topo da [ordem de precedência de configurações](/pt/settings#settings-precedence): elas substituem configurações de usuário, projeto e local, e apenas configurações de política gerenciada podem substituí-las. Esta é a mesma camada que a [seção de precedência na página](#settings-precedence) chama de opções programáticas.631Os valores são escritos na camada de configurações de flag, a mesma camada que a opção `settings` inline de `query()` popula na inicialização. Configurações de flag ficam perto do topo da [ordem de precedência de configurações](/docs/pt/settings#settings-precedence): elas substituem configurações de usuário, projeto e local, e apenas configurações de política gerenciada podem substituí-las. Esta é a mesma camada que a [seção de precedência na página](#settings-precedence) chama de opções programáticas.

632 632 

633Chamadas sucessivas fazem shallow-merge de chaves de nível superior. Uma segunda chamada com `{ permissions: {...} }` substitui o objeto `permissions` inteiro da chamada anterior em vez de fazer deep-merge nele. Para limpar uma chave da camada de flag e voltar a fontes de precedência mais baixa, passe `null` para essa chave. Passar `undefined` não tem efeito porque a serialização JSON a descarta.633Chamadas sucessivas fazem shallow-merge de chaves de nível superior. Uma segunda chamada com `{ permissions: {...} }` substitui o objeto `permissions` inteiro da chamada anterior em vez de fazer deep-merge nele. Para limpar uma chave da camada de flag e voltar a fontes de precedência mais baixa, passe `null` para essa chave. Passar `undefined` não tem efeito porque a serialização JSON a descarta.

634 634 


714 714 

715* Apenas mensagens que foram enfileiradas com um UUID aparecem. Um array vazio não significa que nada mais será executado.715* Apenas mensagens que foram enfileiradas com um UUID aparecem. Um array vazio não significa que nada mais será executado.

716* Apenas mensagens da thread principal estão listadas. Mensagens endereçadas a um subagente estão fora do escopo.716* Apenas mensagens da thread principal estão listadas. Mensagens endereçadas a um subagente estão fora do escopo.

717* A lista pode incluir UUIDs que seu cliente nunca enviou, como acionadores de [tarefa agendada](/pt/scheduled-tasks). Ignore UUIDs que você não reconhece em vez de tratá-los como um erro.717* A lista pode incluir UUIDs que seu cliente nunca enviou, como acionadores de [tarefa agendada](/docs/pt/scheduled-tasks). Ignore UUIDs que você não reconhece em vez de tratá-los como um erro.

718 718 

719O recebimento é um snapshot tirado no momento em que a interrupção é processada, e em uma interrupção limpa chega antes do [`SDKResultMessage`](#sdkresultmessage) do turno interrompido. Leia o recebimento em vez de inspecionar a fila após esse resultado: o loop inicia o próximo turno enfileirado imediatamente, então a fila que você inspeciona após o resultado já mudou.719O recebimento é um snapshot tirado no momento em que a interrupção é processada, e em uma interrupção limpa chega antes do [`SDKResultMessage`](#sdkresultmessage) do turno interrompido. Leia o recebimento em vez de inspecionar a fila após esse resultado: o loop inicia o próximo turno enfileirado imediatamente, então a fila que você inspeciona após o resultado já mudou.

720 720 


792 Comportamento padrão792 Comportamento padrão

793</h4>793</h4>

794 794 

795Quando `settingSources` é omitido ou `undefined`, `query()` carrega as mesmas configurações do sistema de arquivos que a CLI do Claude Code: usuário, projeto e local. Configurações de política gerenciada são carregadas em todos os casos; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial organizacional em uma [configuração elegível](/pt/server-managed-settings#platform-availability). Veja [What settingSources does not control](/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) para entradas que são lidas independentemente desta opção, e como desativá-las.795Quando `settingSources` é omitido ou `undefined`, `query()` carrega as mesmas configurações do sistema de arquivos que a CLI do Claude Code: usuário, projeto e local. Configurações de política gerenciada são carregadas em todos os casos; configurações gerenciadas pelo servidor são buscadas quando a sessão se autentica com uma credencial organizacional em uma [configuração elegível](/docs/pt/server-managed-settings#platform-availability). Veja [What settingSources does not control](/docs/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) para entradas que são lidas independentemente desta opção, e como desativá-las.

796 796 

797<h4 id="why-use-settingsources">797<h4 id="why-use-settingsources">

798 Por que usar settingSources798 Por que usar settingSources


913 913 

914Tipo de função de permissão personalizada para controlar o uso de ferramentas.914Tipo de função de permissão personalizada para controlar o uso de ferramentas.

915 915 

916A função é a substituição do SDK para o prompt de permissão interativo: é invocada apenas quando o [fluxo de avaliação de permissão](/pt/agent-sdk/permissions#how-permissions-are-evaluated) se resolve em um prompt. Chamadas de ferramenta já aprovadas por uma entrada `allowedTools`, uma regra de permissão de configurações, ou o modo de permissão, como `acceptEdits` ou `bypassPermissions`, nunca a invocam. Para controlar cada chamada de ferramenta, use um [hook `PreToolUse`](/pt/agent-sdk/hooks) em vez disso.916A função é a substituição do SDK para o prompt de permissão interativo: é invocada apenas quando o [fluxo de avaliação de permissão](/docs/pt/agent-sdk/permissions#how-permissions-are-evaluated) se resolve em um prompt. Chamadas de ferramenta já aprovadas por uma entrada `allowedTools`, uma regra de permissão de configurações, ou o modo de permissão, como `acceptEdits` ou `bypassPermissions`, nunca a invocam. Para controlar cada chamada de ferramenta, use um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks) em vez disso.

917 917 

918`AskUserQuestion`, ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) a alcançam mesmo quando uma regra de permissão corresponde. Em modo `dontAsk` essas chamadas são negadas em vez disso, sem invocá-la.918`AskUserQuestion`, ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) a alcançam mesmo quando uma regra de permissão corresponde. Em modo `dontAsk` essas chamadas são negadas em vez disso, sem invocá-la.

919 919 

920```typescript theme={null}920```typescript theme={null}

921type CanUseTool = (921type CanUseTool = (


985 985 

986| Campo | Tipo | Descrição |986| Campo | Tipo | Descrição |

987| :------------------------------ | :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |987| :------------------------------ | :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

988| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Opta pelo campo `preview` em opções [`AskUserQuestion`](/pt/agent-sdk/user-input#question-format) e define seu formato de conteúdo. Quando não definido, Claude não emite visualizações |988| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Opta pelo campo `preview` em opções [`AskUserQuestion`](/docs/pt/agent-sdk/user-input#question-format) e define seu formato de conteúdo. Quando não definido, Claude não emite visualizações |

989 989 

990<h3 id="mcpserverconfig">990<h3 id="mcpserverconfig">

991 `McpServerConfig`991 `McpServerConfig`


1091];1091];

1092```1092```

1093 1093 

1094Para informações completas sobre criação e uso de plugins, veja [Plugins](/pt/agent-sdk/plugins).1094Para informações completas sobre criação e uso de plugins, veja [Plugins](/docs/pt/agent-sdk/plugins).

1095 1095 

1096<h2 id="message-types">1096<h2 id="message-types">

1097 Tipos de Mensagem1097 Tipos de Mensagem


1210};1210};

1211```1211```

1212 1212 

1213Um turno de usuário injetado de fora da sessão, aquele cuja [`origin`](#sdkmessageorigin) é `peer` ou `channel`, chega ao fluxo como uma repetição, independentemente de ter sido entregue durante um turno ativo ou iniciado um novo turno enquanto a sessão estava ociosa. {/* min-version: 2.1.207 */}Antes da v2.1.207, um turno injetado entregue enquanto a sessão estava ociosa não produzia nenhuma mensagem no fluxo e apenas aparecia quando você relê a transcrição.1213Um turno de usuário injetado de fora da sessão, aquele cuja [`origin`](#sdkmessageorigin) é `peer` ou `channel`, chega ao fluxo como uma repetição, independentemente de ter sido entregue durante um turno ativo ou iniciado um novo turno enquanto a sessão estava ociosa. Antes da v2.1.207, um turno injetado entregue enquanto a sessão estava ociosa não produzia nenhuma mensagem no fluxo e apenas aparecia quando você relê a transcrição.

1214 1214 

1215<h3 id="sdkresultmessage">1215<h3 id="sdkresultmessage">

1216 `SDKResultMessage`1216 `SDKResultMessage`


1279 1279 

1280O campo `origin` encaminha a [`SDKMessageOrigin`](#sdkmessageorigin) da mensagem do usuário que acionou este resultado. Quando uma tarefa em segundo plano é concluída e o SDK injeta um turno de acompanhamento sintético, a `SDKResultMessage` resultante carrega `origin: { kind: "task-notification" }`. Verifique este campo para distinguir resultados que respondem ao seu prompt de resultados emitidos para acompanhamentos de tarefas em segundo plano, para que você possa rotear ou suprimir os últimos. O campo está ausente para resultados emitidos antes de qualquer turno do usuário, como erros de inicialização.1280O campo `origin` encaminha a [`SDKMessageOrigin`](#sdkmessageorigin) da mensagem do usuário que acionou este resultado. Quando uma tarefa em segundo plano é concluída e o SDK injeta um turno de acompanhamento sintético, a `SDKResultMessage` resultante carrega `origin: { kind: "task-notification" }`. Verifique este campo para distinguir resultados que respondem ao seu prompt de resultados emitidos para acompanhamentos de tarefas em segundo plano, para que você possa rotear ou suprimir os últimos. O campo está ausente para resultados emitidos antes de qualquer turno do usuário, como erros de inicialização.

1281 1281 

1282Quando um hook `PreToolUse` retorna `permissionDecision: "defer"`, o resultado tem `stop_reason: "tool_deferred"` e `deferred_tool_use` carrega o `id`, `name` e `input` da ferramenta pendente. Leia este campo para exibir a solicitação em sua própria interface do usuário, depois retome com o mesmo `session_id` para continuar. Consulte [Adiar uma chamada de ferramenta para mais tarde](/pt/hooks#defer-a-tool-call-for-later) para a volta completa.1282Quando um hook `PreToolUse` retorna `permissionDecision: "defer"`, o resultado tem `stop_reason: "tool_deferred"` e `deferred_tool_use` carrega o `id`, `name` e `input` da ferramenta pendente. Leia este campo para exibir a solicitação em sua própria interface do usuário, depois retome com o mesmo `session_id` para continuar. Consulte [Adiar uma chamada de ferramenta para mais tarde](/docs/pt/hooks#defer-a-tool-call-for-later) para a volta completa.

1283 1283 

1284<h3 id="sdksystemmessage">1284<h3 id="sdksystemmessage">

1285 `SDKSystemMessage`1285 `SDKSystemMessage`


1313};1313};

1314```1314```

1315 1315 

1316{/* min-version: 2.1.205 */}

1317 

1318O array `capabilities` nomeia os comportamentos de protocolo que esta CLI implementa, para que você possa fazer detecção de recursos em vez de comparar strings `claude_code_version`. É um conjunto aberto: ignore valores que você não reconhecer e verifique a capacidade específica cujo comportamento você depende. O campo requer Claude Code v2.1.205 ou posterior e está ausente em CLIs anteriores.1316O array `capabilities` nomeia os comportamentos de protocolo que esta CLI implementa, para que você possa fazer detecção de recursos em vez de comparar strings `claude_code_version`. É um conjunto aberto: ignore valores que você não reconhecer e verifique a capacidade específica cujo comportamento você depende. O campo requer Claude Code v2.1.205 ou posterior e está ausente em CLIs anteriores.

1319 1317 

1320| Capacidade | Significado |1318| Capacidade | Significado |


1396 `SDKPluginInstallMessage`1394 `SDKPluginInstallMessage`

1397</h3>1395</h3>

1398 1396 

1399Evento de progresso de instalação de plugin. Emitido quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/pt/env-vars) está definido, para que sua aplicação Agent SDK possa rastrear a instalação de plugin do marketplace antes do primeiro turno. Os status `started` e `completed` delimitam a instalação geral. Os status `installed` e `failed` relatam marketplaces individuais e incluem `name`.1397Evento de progresso de instalação de plugin. Emitido quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/pt/env-vars) está definido, para que sua aplicação Agent SDK possa rastrear a instalação de plugin do marketplace antes do primeiro turno. Os status `started` e `completed` delimitam a instalação geral. Os status `installed` e `failed` relatam marketplaces individuais e incluem `name`.

1400 1398 

1401```typescript theme={null}1399```typescript theme={null}

1402type SDKPluginInstallMessage = {1400type SDKPluginInstallMessage = {


1479```1477```

1480 1478 

1481| `kind` | Significado |1479| `kind` | Significado |

1482| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1480| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1483| `human` | Entrada direta do usuário final. Em mensagens de usuário, uma `origin` ausente também significa entrada humana. |1481| `human` | Entrada direta do usuário final. Em mensagens de usuário, uma `origin` ausente também significa entrada humana. |

1484| `channel` | Mensagem chegando em um [canal](/pt/channels). `server` é o nome do servidor MCP de origem. |1482| `channel` | Mensagem chegando em um [canal](/docs/pt/channels). `server` é o nome do servidor MCP de origem. |

1485| `peer` | Mensagem de outro agente. Para um [colega de equipe](/pt/agent-teams) em processo enviando para `main` via `SendMessage`, `from` é o nome do colega de equipe e `senderTaskId` é seu ID de tarefa. Para um par entre sessões, como outro processo Claude Code local, `from` é o endereço do remetente e `senderTaskId` está ausente. {/* min-version: 2.1.205 */}`name` e `body` requerem Claude Code v2.1.205 ou posterior. `name` é o nome de exibição do remetente, normalizado pelo Claude Code: remove pontos de código de controle, formato, substituto e separador de linha ou parágrafo Unicode, depois corta o resultado e o limita a 64 pontos de código com reticências. `body` é o corpo da mensagem decodificado com o envelope de par removido, byte-exato com o que o modelo vê. Para uma mensagem de colega de equipe `body` está sempre presente; para um par entre sessões está presente apenas quando o turno é exatamente um envelope de par formado pelo Claude Code. Renderize `name` e `body` em vez de reanalisar o texto da mensagem. |1483| `peer` | Mensagem de outro agente. Para um [colega de equipe](/docs/pt/agent-teams) em processo enviando para `main` via `SendMessage`, `from` é o nome do colega de equipe e `senderTaskId` é seu ID de tarefa. Para um par entre sessões, como outro processo Claude Code local, `from` é o endereço do remetente e `senderTaskId` está ausente. `name` e `body` requerem Claude Code v2.1.205 ou posterior. `name` é o nome de exibição do remetente, normalizado pelo Claude Code: remove pontos de código de controle, formato, substituto e separador de linha ou parágrafo Unicode, depois corta o resultado e o limita a 64 pontos de código com reticências. `body` é o corpo da mensagem decodificado com o envelope de par removido, byte-exato com o que o modelo vê. Para uma mensagem de colega de equipe `body` está sempre presente; para um par entre sessões está presente apenas quando o turno é exatamente um envelope de par formado pelo Claude Code. Renderize `name` e `body` em vez de reanalisar o texto da mensagem. |

1486| `task-notification` | Turno sintético injetado após a conclusão de uma tarefa em segundo plano. Consulte [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |1484| `task-notification` | Turno sintético injetado após a conclusão de uma tarefa em segundo plano. Consulte [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |

1487| `coordinator` | Mensagem de um coordenador de equipe em uma [equipe de agente](/pt/agent-teams). |1485| `coordinator` | Mensagem de um coordenador de equipe em uma [equipe de agente](/docs/pt/agent-teams). |

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

1489 1487 

1490<h2 id="hook-types">1488<h2 id="hook-types">

1491 Tipos de Hook1489 Tipos de Hook

1492</h2>1490</h2>

1493 1491 

1494Para um guia abrangente sobre o uso de hooks com exemplos e padrões comuns, veja o [guia de Hooks](/pt/agent-sdk/hooks).1492Para um guia abrangente sobre o uso de hooks com exemplos e padrões comuns, veja o [guia de Hooks](/docs/pt/agent-sdk/hooks).

1495 1493 

1496<h3 id="hookevent">1494<h3 id="hookevent">

1497 `HookEvent`1495 `HookEvent`


1600};1598};

1601```1599```

1602 1600 

1603O campo `prompt_id` é um UUID que identifica o prompt do usuário sendo processado atualmente. Ele corresponde ao [atributo `prompt.id` em eventos OpenTelemetry](/pt/monitoring-usage#event-correlation-attributes) e está ausente até a primeira entrada do usuário. Requer Claude Code v2.1.196 ou posterior.1601O campo `prompt_id` é um UUID que identifica o prompt do usuário sendo processado atualmente. Ele corresponde ao [atributo `prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes) e está ausente até a primeira entrada do usuário. Requer Claude Code v2.1.196 ou posterior.

1604 1602 

1605<h4 id="pretoolusehookinput">1603<h4 id="pretoolusehookinput">

1606 `PreToolUseHookInput`1604 `PreToolUseHookInput`


2071};2069};

2072```2070```

2073 2071 

2074Faz perguntas de esclarecimento ao usuário durante a execução. Veja [Lidar com aprovações e entrada do usuário](/pt/agent-sdk/user-input#handle-clarifying-questions) para detalhes de uso.2072Faz perguntas de esclarecimento ao usuário durante a execução. Veja [Lidar com aprovações e entrada do usuário](/docs/pt/agent-sdk/user-input#handle-clarifying-questions) para detalhes de uso.

2075 2073 

2076<h3 id="bash">2074<h3 id="bash">

2077 Bash2075 Bash


2110};2108};

2111```2109```

2112 2110 

2113Executa uma fonte de background e entrega cada evento para Claude para que possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`. {/* min-version: 2.1.195 */}A fonte `ws` requer Claude Code v2.1.195 ou posterior.2111Executa uma fonte de background e entrega cada evento para Claude para que possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`. A fonte `ws` requer Claude Code v2.1.195 ou posterior.

2114 2112 

2115Defina `persistent: true` para watches de comprimento de sessão, como tails de log. Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash; um watch de WebSocket solicita aprovação separadamente. Veja a [referência da ferramenta Monitor](/pt/tools-reference#monitor-tool) para comportamento e disponibilidade de provedor.2113Defina `persistent: true` para watches de comprimento de sessão, como tails de log. Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash; um watch de WebSocket solicita aprovação separadamente. Veja a [referência da ferramenta Monitor](/docs/pt/tools-reference#monitor-tool) para comportamento e disponibilidade de provedor.

2116 2114 

2117<h3 id="taskoutput">2115<h3 id="taskoutput">

2118 TaskOutput2116 TaskOutput


2234};2232};

2235```2233```

2236 2234 

2237Para uma tarefa de background em execução ou shell por ID. {/* min-version: 2.1.198 */}A partir de v2.1.198, `task_id` também aceita um colega de equipe de agentes ou um agente de background nomeado por ID de agente ou nome.2235Para uma tarefa de background em execução ou shell por ID. A partir de v2.1.198, `task_id` também aceita um colega de equipe de agentes ou um agente de background nomeado por ID de agente ou nome.

2238 2236 

2239<h3 id="notebookedit">2237<h3 id="notebookedit">

2240 NotebookEdit2238 NotebookEdit


2301};2299};

2302```2300```

2303 2301 

2304Executa um [workflow dinâmico](/pt/workflows): um script que orquestra muitos subagentes em background e retorna um resultado consolidado. A ferramenta `Workflow` está disponível no Agent SDK v0.3.149 e posterior. Pelo menos um de `script`, `name` ou `scriptPath` é obrigatório.2302Executa um [workflow dinâmico](/docs/pt/workflows): um script que orquestra muitos subagentes em background e retorna um resultado consolidado. A ferramenta `Workflow` está disponível no Agent SDK v0.3.149 e posterior. Pelo menos um de `script`, `name` ou `scriptPath` é obrigatório.

2305 2303 

2306| Campo | Tipo | Descrição |2304| Campo | Tipo | Descrição |

2307| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |2305| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |


2330Cria e gerencia uma lista de tarefas estruturada para rastrear progresso.2328Cria e gerencia uma lista de tarefas estruturada para rastrear progresso.

2331 2329 

2332<Note>2330<Note>

2333 A partir do TypeScript Agent SDK 0.3.142, `TodoWrite` está desabilitado por padrão. Use `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` em vez disso. Veja [Migrar para ferramentas Task](/pt/agent-sdk/todo-tracking#migrate-to-task-tools) para atualizar seu código de monitoramento, ou defina `CLAUDE_CODE_ENABLE_TASKS=0` para reverter para `TodoWrite`.2331 A partir do TypeScript Agent SDK 0.3.142, `TodoWrite` está desabilitado por padrão. Use `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` em vez disso. Veja [Migrar para ferramentas Task](/docs/pt/agent-sdk/todo-tracking#migrate-to-task-tools) para atualizar seu código de monitoramento, ou defina `CLAUDE_CODE_ENABLE_TASKS=0` para reverter para `TodoWrite`.

2334</Note>2332</Note>

2335 2333 

2336<h3 id="taskcreate">2334<h3 id="taskcreate">


2570 2568 

2571Retorna o resultado do subagente. Discriminado no campo `status`: `"completed"` para tarefas concluídas, `"async_launched"` para tarefas em background e `"remote_launched"` para tarefas que o Claude Code despachou para uma sessão em nuvem remota, onde `sessionUrl` vincula a essa sessão e `taskId` a identifica.2569Retorna o resultado do subagente. Discriminado no campo `status`: `"completed"` para tarefas concluídas, `"async_launched"` para tarefas em background e `"remote_launched"` para tarefas que o Claude Code despachou para uma sessão em nuvem remota, onde `sessionUrl` vincula a essa sessão e `taskId` a identifica.

2572 2570 

2573O campo `resolvedModel` nas variantes `completed` e `async_launched` nomeia o modelo em que o subagente realmente foi executado, que pode diferir do input `model` solicitado quando [`availableModels`](/pt/model-config#restrict-model-selection) ou outra substituição se aplica. {/* min-version: 2.1.174 */}Este campo requer Claude Code v2.1.174 ou posterior.2571O campo `resolvedModel` nas variantes `completed` e `async_launched` nomeia o modelo em que o subagente realmente foi executado, que pode diferir do input `model` solicitado quando [`availableModels`](/docs/pt/model-config#restrict-model-selection) ou outra substituição se aplica. Este campo requer Claude Code v2.1.174 ou posterior.

2574 2572 

2575Na variante `completed`, `worktreePath` é definido quando o subagente foi executado em um worktree git isolado, e `worktreeBranch` nomeia o branch desse worktree quando o Claude Code o criou. `usage.service_tier` carrega a string de nível de serviço que a API relatou para as solicitações do subagente.2573Na variante `completed`, `worktreePath` é definido quando o subagente foi executado em um worktree git isolado, e `worktreeBranch` nomeia o branch desse worktree quando o Claude Code o criou. `usage.service_tier` carrega a string de nível de serviço que a API relatou para as solicitações do subagente.

2576 2574 


2936Retorna as listas de tarefas anteriores e atualizadas.2934Retorna as listas de tarefas anteriores e atualizadas.

2937 2935 

2938<Note>2936<Note>

2939 A partir do TypeScript Agent SDK 0.3.142, `TodoWrite` está desabilitado por padrão. Use `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` em seu lugar. Veja [Migrar para ferramentas de Task](/pt/agent-sdk/todo-tracking#migrate-to-task-tools) para atualizar seu código de monitoramento, ou defina `CLAUDE_CODE_ENABLE_TASKS=0` para reverter para `TodoWrite`.2937 A partir do TypeScript Agent SDK 0.3.142, `TodoWrite` está desabilitado por padrão. Use `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` em seu lugar. Veja [Migrar para ferramentas de Task](/docs/pt/agent-sdk/todo-tracking#migrate-to-task-tools) para atualizar seu código de monitoramento, ou defina `CLAUDE_CODE_ENABLE_TASKS=0` para reverter para `TodoWrite`.

2940</Note>2938</Note>

2941 2939 

2942<h3 id="taskcreate-2">2940<h3 id="taskcreate-2">


3230```3228```

3231 3229 

3232| Campo | Tipo | Descrição |3230| Campo | Tipo | Descrição |

3233| :------------------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3231| :------------------------- | :----------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3234| `value` | `string` | Identificador de modelo para passar em chamadas de API |3232| `value` | `string` | Identificador de modelo para passar em chamadas de API |

3235| `resolvedModel` | `string \| undefined` | ID de modelo canônico que o `value` desta entrada resolve. Uma entrada de alias como `sonnet` resolve para um ID de modelo explícito como `claude-sonnet-5`, para que um host possa corresponder um ID de modelo explícito armazenado contra a entrada de alias que o cobre. {/* min-version: 2.1.197 */}Requer Claude Code v2.1.197 ou posterior. |3233| `resolvedModel` | `string \| undefined` | ID de modelo canônico que o `value` desta entrada resolve. Uma entrada de alias como `sonnet` resolve para um ID de modelo explícito como `claude-sonnet-5`, para que um host possa corresponder um ID de modelo explícito armazenado contra a entrada de alias que o cobre. Requer Claude Code v2.1.197 ou posterior. |

3236| `displayName` | `string` | Nome de exibição legível para humanos |3234| `displayName` | `string` | Nome de exibição legível para humanos |

3237| `description` | `string` | Descrição das capacidades do modelo |3235| `description` | `string` | Descrição das capacidades do modelo |

3238| `supportsEffort` | `boolean \| undefined` | Se este modelo suporta níveis de esforço |3236| `supportsEffort` | `boolean \| undefined` | Se este modelo suporta níveis de esforço |


3327 `ModelUsage`3325 `ModelUsage`

3328</h3>3326</h3>

3329 3327 

3330Estatísticas de uso por modelo retornadas em mensagens de resultado. O valor `costUSD` é uma estimativa do lado do cliente. Veja [Rastrear custo e uso](/pt/agent-sdk/cost-tracking) para ressalvas de faturamento.3328Estatísticas de uso por modelo retornadas em mensagens de resultado. O valor `costUSD` é uma estimativa do lado do cliente. Veja [Rastrear custo e uso](/docs/pt/agent-sdk/cost-tracking) para ressalvas de faturamento.

3331 3329 

3332```typescript theme={null}3330```typescript theme={null}

3333type ModelUsage = {3331type ModelUsage = {


3392 `CallToolResult`3390 `CallToolResult`

3393</h3>3391</h3>

3394 3392 

3395Tipo de resultado de ferramenta MCP (de `@modelcontextprotocol/sdk/types.js`). `structuredContent` é um objeto JSON que pode ser retornado junto com `content`, incluindo blocos de imagem. Veja [Retornar dados estruturados](/pt/agent-sdk/custom-tools#return-structured-data).3393Tipo de resultado de ferramenta MCP (de `@modelcontextprotocol/sdk/types.js`). `structuredContent` é um objeto JSON que pode ser retornado junto com `content`, incluindo blocos de imagem. Veja [Retornar dados estruturados](/docs/pt/agent-sdk/custom-tools#return-structured-data).

3396 3394 

3397```typescript theme={null}3395```typescript theme={null}

3398type CallToolResult = {3396type CallToolResult = {


3742 3740 

3743Nada é emitido na inicialização. Redefina para um conjunto vazio sempre que o processo CLI da sessão inicia ou reinicia e deixe a próxima mudança de associação repopulá-lo.3741Nada é emitido na inicialização. Redefina para um conjunto vazio sempre que o processo CLI da sessão inicia ou reinicia e deixe a próxima mudança de associação repopulá-lo.

3744 3742 

3745{/* min-version: 2.1.203 */}Requer Claude Code v2.1.203 ou posterior.3743Requer Claude Code v2.1.203 ou posterior.

3746 3744 

3747```typescript theme={null}3745```typescript theme={null}

3748type SDKBackgroundTasksChangedMessage = {3746type SDKBackgroundTasksChangedMessage = {


3762 `SDKThinkingTokensMessage`3760 `SDKThinkingTokensMessage`

3763</h3>3761</h3>

3764 3762 

3765Emitido enquanto Claude está produzindo um bloco de pensamento, incluindo um redatado, carregando uma estimativa em execução dos tokens de pensamento gerados até agora. `estimated_tokens` é o total em execução para o bloco de pensamento atual e `estimated_tokens_delta` é o incremento carregado por este frame. Use-o para exibição de progresso. A contagem final para o loop de agente de nível superior é o `usage.output_tokens` da mensagem de resultado, que [não inclui tokens de subagente](/pt/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); use [`modelUsage`](#modelusage) para contabilidade de árvore completa.3763Emitido enquanto Claude está produzindo um bloco de pensamento, incluindo um redatado, carregando uma estimativa em execução dos tokens de pensamento gerados até agora. `estimated_tokens` é o total em execução para o bloco de pensamento atual e `estimated_tokens_delta` é o incremento carregado por este frame. Use-o para exibição de progresso. A contagem final para o loop de agente de nível superior é o `usage.output_tokens` da mensagem de resultado, que [não inclui tokens de subagente](/docs/pt/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); use [`modelUsage`](#modelusage) para contabilidade de árvore completa.

3766 3764 

3767{/* min-version: 2.1.153 */}Requer Claude Code v2.1.153 ou posterior.3765Requer Claude Code v2.1.153 ou posterior.

3768 3766 

3769```typescript theme={null}3767```typescript theme={null}

3770type SDKThinkingTokensMessage = {3768type SDKThinkingTokensMessage = {


3817};3815};

3818```3816```

3819 3817 

3820{/* min-version: 2.1.181 */}Quando `errorCode` é `"credits_required"`, a rejeição é de uma assinatura claude.ai cujo uso incluído está esgotado, e a sessão não pode continuar até que o usuário compre créditos de uso. `canUserPurchaseCredits` indica se o usuário autenticado pode comprar créditos para a conta, e `hasChargeableSavedPaymentMethod` indica se um método de pagamento salvo está registrado. Todos os três campos estão ausentes em eventos de limite de taxa que não são rejeições de créditos necessários. Requer Claude Code v2.1.181 ou posterior.3818Quando `errorCode` é `"credits_required"`, a rejeição é de uma assinatura claude.ai cujo uso incluído está esgotado, e a sessão não pode continuar até que o usuário compre créditos de uso. `canUserPurchaseCredits` indica se o usuário autenticado pode comprar créditos para a conta, e `hasChargeableSavedPaymentMethod` indica se um método de pagamento salvo está registrado. Todos os três campos estão ausentes em eventos de limite de taxa que não são rejeições de créditos necessários. Requer Claude Code v2.1.181 ou posterior.

3821 3819 

3822<h3 id="sdklocalcommandoutputmessage">3820<h3 id="sdklocalcommandoutputmessage">

3823 `SDKLocalCommandOutputMessage`3821 `SDKLocalCommandOutputMessage`


3881};3879};

3882```3880```

3883 3881 

3884{/* min-version: 2.1.203 */}As tipagens publicadas do SDK declaram `SDKConversationResetMessage` no Claude Code v2.1.203 e posterior. Antes de v2.1.203, `SDKMessage` referenciava o tipo sem declará-lo, então o estreitamento em `type === "conversation_reset"` falhou ao verificar o tipo quando `skipLibCheck` estava desativado.3882As tipagens publicadas do SDK declaram `SDKConversationResetMessage` no Claude Code v2.1.203 e posterior. Antes de v2.1.203, `SDKMessage` referenciava o tipo sem declará-lo, então o estreitamento em `type === "conversation_reset"` falhou ao verificar o tipo quando `skipLibCheck` estava desativado.

3885 3883 

3886<h3 id="aborterror">3884<h3 id="aborterror">

3887 `AbortError`3885 `AbortError`


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

3933 3931 

3934<Note>3932<Note>

3935 O sandbox depende do suporte de plataforma e, no Linux, ferramentas como `bubblewrap` e `socat`. Quando `enabled` é `true` e o sandbox não consegue iniciar, `query()` relata uma mensagem `result` com `subtype: "error_during_execution"` e o motivo em `errors`. Para uma única chamada de mensagem `query()`, o SDK lança após gerar esse resultado de erro, então envolva o loop em um bloco try para continuar além dele. Veja [Lidar com o resultado](/pt/agent-sdk/agent-loop#handle-the-result) para o contrato de erro.3933 O sandbox depende do suporte de plataforma e, no Linux, ferramentas como `bubblewrap` e `socat`. Quando `enabled` é `true` e o sandbox não consegue iniciar, `query()` relata uma mensagem `result` com `subtype: "error_during_execution"` e o motivo em `errors`. Para uma única chamada de mensagem `query()`, o SDK lança após gerar esse resultado de erro, então envolva o loop em um bloco try para continuar além dele. Veja [Lidar com o resultado](/docs/pt/agent-sdk/agent-loop#handle-the-result) para o contrato de erro.

3936 3934 

3937 Para executar sem sandbox, defina `failIfUnavailable: false`.3935 Para executar sem sandbox, defina `failIfUnavailable: false`.

3938</Note>3936</Note>


3974 `SandboxNetworkConfig`3972 `SandboxNetworkConfig`

3975</h3>3973</h3>

3976 3974 

3977Configuração específica de rede para modo sandbox. Essas configurações se aplicam a comandos Bash sandboxed quando `enabled` é `true` na [`SandboxSettings`](#sandboxsettings) pai. Elas não restringem a ferramenta WebFetch, que usa [regras de permissão](/pt/permissions#webfetch) em vez disso.3975Configuração específica de rede para modo sandbox. Essas configurações se aplicam a comandos Bash sandboxed quando `enabled` é `true` na [`SandboxSettings`](#sandboxsettings) pai. Elas não restringem a ferramenta WebFetch, que usa [regras de permissão](/docs/pt/permissions#webfetch) em vez disso.

3978 3976 

3979```typescript theme={null}3977```typescript theme={null}

3980type SandboxNetworkConfig = {3978type SandboxNetworkConfig = {


3993| :------------------------ | :--------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3991| :------------------------ | :--------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3994| `allowedDomains` | `string[]` | `[]` | Nomes de domínio que processos sandboxed podem acessar |3992| `allowedDomains` | `string[]` | `[]` | Nomes de domínio que processos sandboxed podem acessar |

3995| `deniedDomains` | `string[]` | `[]` | Nomes de domínio que processos sandboxed não podem acessar. Tem precedência sobre `allowedDomains` |3993| `deniedDomains` | `string[]` | `[]` | Nomes de domínio que processos sandboxed não podem acessar. Tem precedência sobre `allowedDomains` |

3996| `allowManagedDomainsOnly` | `boolean` | `false` | Apenas configurações gerenciadas. Quando definido em [configurações gerenciadas](/pt/permissions#managed-settings), apenas entradas `allowedDomains` de configurações gerenciadas são honradas e entradas de configurações de usuário, projeto ou local são ignoradas. Não tem efeito quando definido via opções SDK |3994| `allowManagedDomainsOnly` | `boolean` | `false` | Apenas configurações gerenciadas. Quando definido em [configurações gerenciadas](/docs/pt/permissions#managed-settings), apenas entradas `allowedDomains` de configurações gerenciadas são honradas e entradas de configurações de usuário, projeto ou local são ignoradas. Não tem efeito quando definido via opções SDK |

3997| `allowLocalBinding` | `boolean` | `false` | Permitir que processos se vinculem a portas locais (por exemplo, para servidores dev) |3995| `allowLocalBinding` | `boolean` | `false` | Permitir que processos se vinculem a portas locais (por exemplo, para servidores dev) |

3998| `allowUnixSockets` | `string[]` | `[]` | Caminhos de socket Unix que processos podem acessar (por exemplo, socket Docker) |3996| `allowUnixSockets` | `string[]` | `[]` | Caminhos de socket Unix que processos podem acessar (por exemplo, socket Docker) |

3999| `allowAllUnixSockets` | `boolean` | `false` | Permitir acesso a todos os sockets Unix |3997| `allowAllUnixSockets` | `boolean` | `false` | Permitir acesso a todos os sockets Unix |


4001| `socksProxyPort` | `number` | `undefined` | Porta de proxy SOCKS para requisições de rede |3999| `socksProxyPort` | `number` | `undefined` | Porta de proxy SOCKS para requisições de rede |

4002 4000 

4003<Note>4001<Note>

4004 O proxy de sandbox integrado impõe `allowedDomains` com base no nome de host solicitado e não encerra ou inspeciona tráfego TLS, portanto técnicas como [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) podem potencialmente contorná-lo. Veja [Limitações de segurança de sandboxing](/pt/sandboxing#security-limitations) para detalhes e [Implantação segura](/pt/agent-sdk/secure-deployment#traffic-forwarding) para configurar um proxy que encerra TLS.4002 O proxy de sandbox integrado impõe `allowedDomains` com base no nome de host solicitado e não encerra ou inspeciona tráfego TLS, portanto técnicas como [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) podem potencialmente contorná-lo. Veja [Limitações de segurança de sandboxing](/docs/pt/sandboxing#security-limitations) para detalhes e [Implantação segura](/docs/pt/agent-sdk/secure-deployment#traffic-forwarding) para configurar um proxy que encerra TLS.

4005</Note>4003</Note>

4006 4004 

4007<h3 id="sandboxfilesystemconfig">4005<h3 id="sandboxfilesystemconfig">


4079<Warning>4077<Warning>

4080 Comandos executando com `dangerouslyDisableSandbox: true` têm acesso completo ao sistema. Garanta que seu handler `canUseTool` valide essas solicitações cuidadosamente.4078 Comandos executando com `dangerouslyDisableSandbox: true` têm acesso completo ao sistema. Garanta que seu handler `canUseTool` valide essas solicitações cuidadosamente.

4081 4079 

4082 Se `permissionMode` está definido como `bypassPermissions` e `allowUnsandboxedCommands` está ativado, o modelo pode autonomamente executar comandos fora do sandbox sem quaisquer prompts de aprovação (uma [`ask` rule](/pt/agent-sdk/permissions#how-permissions-are-evaluated) explícita ainda força uma). Esta combinação efetivamente permite que o modelo escape do isolamento de sandbox silenciosamente.4080 Se `permissionMode` está definido como `bypassPermissions` e `allowUnsandboxedCommands` está ativado, o modelo pode autonomamente executar comandos fora do sandbox sem quaisquer prompts de aprovação (uma [`ask` rule](/docs/pt/agent-sdk/permissions#how-permissions-are-evaluated) explícita ainda força uma). Esta combinação efetivamente permite que o modelo escape do isolamento de sandbox silenciosamente.

4083</Warning>4081</Warning>

4084 4082 

4085<h2 id="see-also">4083<h2 id="see-also">

4086 Veja também4084 Veja também

4087</h2>4085</h2>

4088 4086 

4089* [Visão geral do SDK](/pt/agent-sdk/overview) - Conceitos gerais do SDK4087* [Visão geral do SDK](/docs/pt/agent-sdk/overview) - Conceitos gerais do SDK

4090* [Referência do SDK Python](/pt/agent-sdk/python) - Documentação do SDK Python4088* [Referência do SDK Python](/docs/pt/agent-sdk/python) - Documentação do SDK Python

4091* [Referência da CLI](/pt/cli-reference) - Interface de linha de comando4089* [Referência da CLI](/docs/pt/cli-reference) - Interface de linha de comando

4092* [Fluxos de trabalho comuns](/pt/common-workflows) - Guias passo a passo4090* [Fluxos de trabalho comuns](/docs/pt/common-workflows) - Guias passo a passo

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, retorne a decisão do [hook `defer`](/pt/hooks#defer-a-tool-call-for-later), que permite que o processo saia e retome mais tarde a partir da sessão persistida.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, retorne a decisão do [hook `defer`](/docs/pt/hooks#defer-a-tool-call-for-later), que permite que o processo saia e retome 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 


44 44 

45O callback é acionado em dois casos:45O callback é acionado em dois casos:

46 46 

471. **Ferramenta precisa de aprovação**: Claude quer usar uma ferramenta que não é aprovada automaticamente por uma [regra de permissão](/pt/agent-sdk/permissions) ou modo de permissão. Verifique `tool_name` para a ferramenta (por exemplo, `"Bash"`, `"Write"`).471. **Ferramenta precisa de aprovação**: Claude quer usar uma ferramenta que não é aprovada automaticamente por uma [regra de permissão](/docs/pt/agent-sdk/permissions) ou modo de permissão. Verifique `tool_name` para a ferramenta (por exemplo, `"Bash"`, `"Write"`).

482. **Claude faz uma pergunta**: Claude chama a ferramenta `AskUserQuestion`. Verifique se `tool_name == "AskUserQuestion"` para tratá-la diferentemente. Se você especificar um array `tools`, inclua `AskUserQuestion` para que isso funcione. Veja [Lidar com perguntas de esclarecimento](#handle-clarifying-questions) para detalhes.482. **Claude faz uma pergunta**: Claude chama a ferramenta `AskUserQuestion`. Verifique se `tool_name == "AskUserQuestion"` para tratá-la diferentemente. Se você especificar um array `tools`, inclua `AskUserQuestion` para que isso funcione. Veja [Lidar com perguntas de esclarecimento](#handle-clarifying-questions) para detalhes.

49 49 

50<Warning>50<Warning>

51 **O callback nunca é acionado para ferramentas aprovadas automaticamente.** Qualquer aprovação anterior no [fluxo de avaliação de permissões](/pt/agent-sdk/permissions#how-permissions-are-evaluated), uma regra de permissão ou um modo como `acceptEdits` ou `bypassPermissions`, resolve a chamada antes que `canUseTool` seja consultado. Se você listar uma ferramenta diretamente em `allowed_tools`, uma verificação `canUseTool` para essa ferramenta nunca é executada a menos que uma regra de pergunta ou modo `plan` redirecione a chamada de volta para um prompt. Para lógica que deve se aplicar a cada chamada de ferramenta, use um [hook `PreToolUse`](/pt/agent-sdk/hooks), que é executado antes do resto do fluxo e pode permitir, negar ou modificar solicitações.51 **O callback nunca é acionado para ferramentas aprovadas automaticamente.** Qualquer aprovação anterior no [fluxo de avaliação de permissões](/docs/pt/agent-sdk/permissions#how-permissions-are-evaluated), uma regra de permissão ou um modo como `acceptEdits` ou `bypassPermissions`, resolve a chamada antes que `canUseTool` seja consultado. Se você listar uma ferramenta diretamente em `allowed_tools`, uma verificação `canUseTool` para essa ferramenta nunca é executada a menos que uma regra de pergunta ou modo `plan` redirecione a chamada de volta para um prompt. Para lógica que deve se aplicar a cada chamada de ferramenta, use um [hook `PreToolUse`](/docs/pt/agent-sdk/hooks), que é executado antes do resto do fluxo e pode permitir, negar ou modificar solicitações.

52 52 

53 `AskUserQuestion`, ferramentas MCP marcadas como [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [que sua organização configurou como `ask`](/pt/mcp#organization-controls-on-connector-tools) chegam ao callback mesmo quando uma regra de permissão corresponde. No modo `dontAsk` essas chamadas são negadas em vez disso, sem invocar o callback.53 `AskUserQuestion`, ferramentas MCP marcadas como [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [que sua organização configurou como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) chegam ao callback mesmo quando uma regra de permissão corresponde. No modo `dontAsk` essas chamadas são negadas em vez disso, sem invocar o callback.

54</Warning>54</Warning>

55 55 

56Você também pode usar o [hook `PermissionRequest`](/pt/agent-sdk/hooks#available-hooks) para enviar notificações externas (Slack, email, push) quando Claude está aguardando aprovação.56Você também pode usar o [hook `PermissionRequest`](/docs/pt/agent-sdk/hooks#available-hooks) para enviar notificações externas (Slack, email, push) quando Claude está aguardando aprovação.

57 57 

58<h2 id="handle-tool-approval-requests">58<h2 id="handle-tool-approval-requests">

59 Lidar com solicitações de aprovação de ferramentas59 Lidar com solicitações de aprovação de ferramentas


65| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |65| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

66| `toolName` | O nome da ferramenta que Claude quer usar (por exemplo, `"Bash"`, `"Write"`, `"Edit"`) |66| `toolName` | O nome da ferramenta que Claude quer usar (por exemplo, `"Bash"`, `"Write"`, `"Edit"`) |

67| `input` | Os parâmetros que Claude está passando para a ferramenta. O conteúdo varia por ferramenta. |67| `input` | Os parâmetros que Claude está passando para a ferramenta. O conteúdo varia por ferramenta. |

68| `options` (TS) / `context` (Python) | Contexto adicional incluindo `suggestions` opcional (entradas `PermissionUpdate` propostas para evitar re-solicitação) e um sinal de cancelamento. Em TypeScript, `signal` é um `AbortSignal`; em Python, o campo de sinal é reservado para uso futuro. Veja [`ToolPermissionContext`](/pt/agent-sdk/python#toolpermissioncontext) para Python. |68| `options` (TS) / `context` (Python) | Contexto adicional incluindo `suggestions` opcional (entradas `PermissionUpdate` propostas para evitar re-solicitação) e um sinal de cancelamento. Em TypeScript, `signal` é um `AbortSignal`; em Python, o campo de sinal é reservado para uso futuro. Veja [`ToolPermissionContext`](/docs/pt/agent-sdk/python#toolpermissioncontext) para Python. |

69 69 

70O objeto `input` contém parâmetros específicos da ferramenta. Exemplos comuns:70O objeto `input` contém parâmetros específicos da ferramenta. Exemplos comuns:

71 71 


76| `Edit` | `file_path`, `old_string`, `new_string` |76| `Edit` | `file_path`, `old_string`, `new_string` |

77| `Read` | `file_path`, `offset`, `limit` |77| `Read` | `file_path`, `offset`, `limit` |

78 78 

79Veja a referência do SDK para esquemas de entrada completos: [Python](/pt/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/pt/agent-sdk/typescript#tool-input-types).79Veja a referência do SDK para esquemas de entrada completos: [Python](/docs/pt/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/docs/pt/agent-sdk/typescript#tool-input-types).

80 80 

81Você pode exibir essas informações ao usuário para que ele possa decidir se permite ou rejeita a ação, e então retornar a resposta apropriada.81Você pode exibir essas informações ao usuário para que ele possa decidir se permite ou rejeita a ação, e então retornar a resposta apropriada.

82 82 


200</CodeGroup>200</CodeGroup>

201 201 

202<Note>202<Note>

203 Em Python, `can_use_tool` requer [modo de streaming](/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.203 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.

204</Note>204</Note>

205 205 

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


216| **Permitir** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |216| **Permitir** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |

217| **Negar** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |217| **Negar** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |

218 218 

219Ao permitir, a ferramenta executa com a entrada que Claude solicitou, a menos que você retorne uma entrada modificada, `updatedInput` em TypeScript ou `updated_input` em Python. {/* min-version: 2.1.207 */}Antes da v2.1.207, Claude Code rejeitava um resultado de permissão que omitia `updatedInput` e negava a chamada de ferramenta com um erro de validação.219Ao permitir, a ferramenta executa com a entrada que Claude solicitou, a menos que você retorne uma entrada modificada, `updatedInput` em TypeScript ou `updated_input` em Python. Antes da v2.1.207, Claude Code rejeitava um resultado de permissão que omitia `updatedInput` e negava a chamada de ferramenta com um erro de validação.

220 220 

221Ao negar, forneça uma mensagem explicando por quê. Claude vê esta mensagem e pode ajustar sua abordagem.221Ao negar, forneça uma mensagem explicando por quê. Claude vê esta mensagem e pode ajustar sua abordagem.

222 222 


247* **Aprovar e lembrar**: repita uma regra de permissão sugerida para que chamadas correspondentes ignorem o prompt na próxima vez247* **Aprovar e lembrar**: repita uma regra de permissão sugerida para que chamadas correspondentes ignorem o prompt na próxima vez

248* **Rejeitar**: bloqueie a ferramenta e diga ao Claude por quê248* **Rejeitar**: bloqueie a ferramenta e diga ao Claude por quê

249* **Sugerir alternativa**: bloqueie mas guie Claude para o que o usuário quer em vez disso249* **Sugerir alternativa**: bloqueie mas guie Claude para o que o usuário quer em vez disso

250* **Redirecionar completamente**: use [entrada de streaming](/pt/agent-sdk/streaming-vs-single-mode) para enviar ao Claude uma instrução completamente nova250* **Redirecionar completamente**: use [entrada de streaming](/docs/pt/agent-sdk/streaming-vs-single-mode) para enviar ao Claude uma instrução completamente nova

251 251 

252<Tabs>252<Tabs>

253 <Tab title="Aprovar">253 <Tab title="Aprovar">


311 </Tab>311 </Tab>

312 312 

313 <Tab title="Aprovar e lembrar">313 <Tab title="Aprovar e lembrar">

314 O usuário aprova e não quer ser perguntado novamente para este tipo de chamada. O terceiro argumento de callback carrega `suggestions`, uma matriz de entradas [`PermissionUpdate`](/pt/agent-sdk/typescript#permissionupdate) prontas. Repita uma de volta em `updatedPermissions` para aplicá-la. Uma sugestão com o destino `localSettings` escreve a regra em `.claude/settings.local.json` para que futuras sessões ignorem o prompt para chamadas correspondentes.314 O usuário aprova e não quer ser perguntado novamente para este tipo de chamada. O terceiro argumento de callback carrega `suggestions`, uma matriz de entradas [`PermissionUpdate`](/docs/pt/agent-sdk/typescript#permissionupdate) prontas. Repita uma de volta em `updatedPermissions` para aplicá-la. Uma sugestão com o destino `localSettings` escreve a regra em `.claude/settings.local.json` para que futuras sessões ignorem o prompt para chamadas correspondentes.

315 315 

316 O exemplo Python requer `claude-agent-sdk` 0.1.80 ou posterior.316 O exemplo Python requer `claude-agent-sdk` 0.1.80 ou posterior.

317 317 


415 </Tab>415 </Tab>

416 416 

417 <Tab title="Redirecionar completamente">417 <Tab title="Redirecionar completamente">

418 Para uma mudança completa de direção (não apenas um empurrão), use [entrada de streaming](/pt/agent-sdk/streaming-vs-single-mode) para enviar ao Claude uma nova instrução diretamente. Isso ignora a solicitação de ferramenta atual e dá ao Claude instruções completamente novas para seguir.418 Para uma mudança completa de direção (não apenas um empurrão), use [entrada de streaming](/docs/pt/agent-sdk/streaming-vs-single-mode) para enviar ao Claude uma nova instrução diretamente. Isso ignora a solicitação de ferramenta atual e dá ao Claude instruções completamente novas para seguir.

419 </Tab>419 </Tab>

420</Tabs>420</Tabs>

421 421 


426Quando Claude precisa de mais direção em uma tarefa com múltiplas abordagens válidas, ele chama a ferramenta `AskUserQuestion`. Isso aciona seu callback `canUseTool` com `toolName` definido como `AskUserQuestion`. A entrada contém as perguntas do Claude como opções de múltipla escolha, que você exibe ao usuário e retorna suas seleções.426Quando Claude precisa de mais direção em uma tarefa com múltiplas abordagens válidas, ele chama a ferramenta `AskUserQuestion`. Isso aciona seu callback `canUseTool` com `toolName` definido como `AskUserQuestion`. A entrada contém as perguntas do Claude como opções de múltipla escolha, que você exibe ao usuário e retorna suas seleções.

427 427 

428<Tip>428<Tip>

429 Perguntas de esclarecimento são especialmente comuns no [modo `plan`](/pt/agent-sdk/permissions#plan-mode-plan), onde Claude explora a base de código e faz perguntas antes de propor um plano. Isso torna o modo plan ideal para fluxos de trabalho interativos onde você quer que Claude reúna requisitos antes de fazer alterações.429 Perguntas de esclarecimento são especialmente comuns no [modo `plan`](/docs/pt/agent-sdk/permissions#plan-mode-plan), onde Claude explora a base de código e faz perguntas antes de propor um plano. Isso torna o modo plan ideal para fluxos de trabalho interativos onde você quer que Claude reúna requisitos antes de fazer alterações.

430</Tip>430</Tip>

431 431 

432Os passos a seguir mostram como lidar com perguntas de esclarecimento:432Os passos a seguir mostram como lidar com perguntas de esclarecimento:


864 Entrada de streaming864 Entrada de streaming

865</h3>865</h3>

866 866 

867Use [entrada de streaming](/pt/agent-sdk/streaming-vs-single-mode) quando você precisar:867Use [entrada de streaming](/docs/pt/agent-sdk/streaming-vs-single-mode) quando você precisar:

868 868 

869* **Interromper o agente no meio da tarefa**: enviar um sinal de cancelamento ou mudar de direção enquanto Claude está trabalhando869* **Interromper o agente no meio da tarefa**: enviar um sinal de cancelamento ou mudar de direção enquanto Claude está trabalhando

870* **Fornecer contexto adicional**: adicionar informações que Claude precisa sem esperar que ele pergunte870* **Fornecer contexto adicional**: adicionar informações que Claude precisa sem esperar que ele pergunte


876 Ferramentas personalizadas876 Ferramentas personalizadas

877</h3>877</h3>

878 878 

879Use [ferramentas personalizadas](/pt/agent-sdk/custom-tools) quando você precisar:879Use [ferramentas personalizadas](/docs/pt/agent-sdk/custom-tools) quando você precisar:

880 880 

881* **Coletar entrada estruturada**: construir formulários, assistentes ou fluxos de trabalho de várias etapas que vão além do formato de múltipla escolha do `AskUserQuestion`881* **Coletar entrada estruturada**: construir formulários, assistentes ou fluxos de trabalho de várias etapas que vão além do formato de múltipla escolha do `AskUserQuestion`

882* **Integrar sistemas de aprovação externos**: conectar a plataformas de ticketing, fluxo de trabalho ou aprovação existentes882* **Integrar sistemas de aprovação externos**: conectar a plataformas de ticketing, fluxo de trabalho ou aprovação existentes


888 Recursos relacionados888 Recursos relacionados

889</h2>889</h2>

890 890 

891* [Configurar permissões](/pt/agent-sdk/permissions): configurar modos e regras de permissão891* [Configurar permissões](/docs/pt/agent-sdk/permissions): configurar modos e regras de permissão

892* [Controlar execução com hooks](/pt/agent-sdk/hooks): executar código personalizado em pontos-chave do ciclo de vida do agente892* [Controlar execução com hooks](/docs/pt/agent-sdk/hooks): executar código personalizado em pontos-chave do ciclo de vida do agente

893* [Referência do SDK TypeScript](/pt/agent-sdk/typescript#canusetool): documentação completa da API canUseTool893* [Referência do SDK TypeScript](/docs/pt/agent-sdk/typescript#canusetool): documentação completa da API canUseTool

agent-teams.md +30 −30

Details

7> Coordene múltiplas instâncias Claude Code trabalhando juntas como uma equipe, com tarefas compartilhadas, mensagens entre agentes e gerenciamento centralizado.7> Coordene múltiplas instâncias Claude Code trabalhando juntas como uma equipe, com tarefas compartilhadas, mensagens entre agentes e gerenciamento centralizado.

8 8 

9<Warning>9<Warning>

10 Equipes de agentes são experimentais e desabilitadas por padrão. Ative-as adicionando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` ao seu [settings.json](/pt/settings) ou ambiente. Sem essa variável, nenhuma equipe é configurada no início da sessão, nenhum diretório de equipe é escrito, e Claude não gera ou propõe companheiros de equipe. Equipes de agentes têm [limitações conhecidas](#limitations) em torno de retomada de sessão, coordenação de tarefas e comportamento de encerramento.10 Equipes de agentes são experimentais e desabilitadas por padrão. Ative-as adicionando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` ao seu [settings.json](/docs/pt/settings) ou ambiente. Sem essa variável, nenhuma equipe é configurada no início da sessão, nenhum diretório de equipe é escrito, e Claude não gera ou propõe companheiros de equipe. Equipes de agentes têm [limitações conhecidas](#limitations) em torno de retomada de sessão, coordenação de tarefas e comportamento de encerramento.

11</Warning>11</Warning>

12 12 

13Equipes de agentes permitem que você coordene múltiplas instâncias Claude Code trabalhando juntas. Uma sessão atua como o líder da equipe, coordenando o trabalho, atribuindo tarefas e sintetizando resultados. Os companheiros de equipe trabalham independentemente, cada um em sua própria context window, e se comunicam diretamente uns com os outros.13Equipes de agentes permitem que você coordene múltiplas instâncias Claude Code trabalhando juntas. Uma sessão atua como o líder da equipe, coordenando o trabalho, atribuindo tarefas e sintetizando resultados. Os companheiros de equipe trabalham independentemente, cada um em sua própria context window, e se comunicam diretamente uns com os outros.

14 14 

15Diferentemente de [subagents](/pt/sub-agents), que são executados dentro de uma única sessão e podem apenas relatar de volta ao agente principal, você também pode interagir com companheiros de equipe individuais diretamente sem passar pelo líder.15Diferentemente de [subagents](/docs/pt/sub-agents), que são executados dentro de uma única sessão e podem apenas relatar de volta ao agente principal, você também pode interagir com companheiros de equipe individuais diretamente sem passar pelo líder.

16 16 

17<Note>17<Note>

18 Esta página descreve equipes de agentes a partir da v2.1.178. Com `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` definido, gerar um companheiro de equipe não requer mais uma etapa de configuração, e a limpeza acontece automaticamente quando a sessão sai. Antes da v2.1.178, você pedia ao Claude para criar e nomear uma equipe primeiro, e Claude usava as ferramentas `TeamCreate` e `TeamDelete` para configurá-la e removê-la. Ambas as ferramentas não existem mais. A entrada `team_name` na ferramenta Agent é aceita mas ignorada, e o campo `team_name` em `TaskCreated`, `TaskCompleted`, e `TeammateIdle` [payloads de hook](/pt/hooks#taskcreated) carrega o nome derivado da sessão e está descontinuado.18 Esta página descreve equipes de agentes a partir da v2.1.178. Com `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` definido, gerar um companheiro de equipe não requer mais uma etapa de configuração, e a limpeza acontece automaticamente quando a sessão sai. Antes da v2.1.178, você pedia ao Claude para criar e nomear uma equipe primeiro, e Claude usava as ferramentas `TeamCreate` e `TeamDelete` para configurá-la e removê-la. Ambas as ferramentas não existem mais. A entrada `team_name` na ferramenta Agent é aceita mas ignorada, e o campo `team_name` em `TaskCreated`, `TaskCompleted`, e `TeammateIdle` [payloads de hook](/docs/pt/hooks#taskcreated) carrega o nome derivado da sessão e está descontinuado.

19</Note>19</Note>

20 20 

21<h2 id="when-to-use-agent-teams">21<h2 id="when-to-use-agent-teams">


29* **Depuração com hipóteses concorrentes**: companheiros de equipe testam diferentes teorias em paralelo e convergem para a resposta mais rapidamente29* **Depuração com hipóteses concorrentes**: companheiros de equipe testam diferentes teorias em paralelo e convergem para a resposta mais rapidamente

30* **Coordenação entre camadas**: mudanças que abrangem frontend, backend e testes, cada uma de propriedade de um companheiro de equipe diferente30* **Coordenação entre camadas**: mudanças que abrangem frontend, backend e testes, cada uma de propriedade de um companheiro de equipe diferente

31 31 

32Equipes de agentes adicionam sobrecarga de coordenação e usam significativamente mais tokens do que uma única sessão. Funcionam melhor quando os companheiros de equipe podem operar independentemente. Para tarefas sequenciais, edições no mesmo arquivo ou trabalho com muitas dependências, uma única sessão ou [subagents](/pt/sub-agents) são mais eficazes.32Equipes de agentes adicionam sobrecarga de coordenação e usam significativamente mais tokens do que uma única sessão. Funcionam melhor quando os companheiros de equipe podem operar independentemente. Para tarefas sequenciais, edições no mesmo arquivo ou trabalho com muitas dependências, uma única sessão ou [subagents](/docs/pt/sub-agents) são mais eficazes.

33 33 

34<h3 id="compare-with-subagents">34<h3 id="compare-with-subagents">

35 Comparar com subagents35 Comparar com subagents

36</h3>36</h3>

37 37 

38Tanto equipes de agentes quanto [subagents](/pt/sub-agents) permitem que você paralelizar o trabalho, mas operam de forma diferente. Escolha com base em se seus trabalhadores precisam se comunicar uns com os outros:38Tanto equipes de agentes quanto [subagents](/docs/pt/sub-agents) permitem que você paralelizar o trabalho, mas operam de forma diferente. Escolha com base em se seus trabalhadores precisam se comunicar uns com os outros:

39 39 

40<Frame caption="Subagents apenas relatam resultados de volta ao agente principal e nunca falam uns com os outros. Em equipes de agentes, os companheiros de equipe compartilham uma lista de tarefas, reivindicam trabalho e se comunicam diretamente uns com os outros.">40<Frame caption="Subagents apenas relatam resultados de volta ao agente principal e nunca falam uns com os outros. Em equipes de agentes, os companheiros de equipe compartilham uma lista de tarefas, reivindicam trabalho e se comunicam diretamente uns com os outros.">

41 <img src="https://mintcdn.com/claude-code/nsvRFSDNfpSU5nT7/images/subagents-vs-agent-teams-light.png?fit=max&auto=format&n=nsvRFSDNfpSU5nT7&q=85&s=2f8db9b4f3705dd3ab931fbe2d96e42a" className="dark:hidden" alt="Diagrama comparando arquiteturas de subagent e equipe de agentes. Subagents são gerados pelo agente principal, fazem trabalho e relatam resultados de volta. Equipes de agentes coordenam através de uma lista de tarefas compartilhada, com companheiros de equipe se comunicando diretamente uns com os outros." width="4245" height="1615" data-path="images/subagents-vs-agent-teams-light.png" />41 <img src="https://mintcdn.com/claude-code/nsvRFSDNfpSU5nT7/images/subagents-vs-agent-teams-light.png?fit=max&auto=format&n=nsvRFSDNfpSU5nT7&q=85&s=2f8db9b4f3705dd3ab931fbe2d96e42a" className="dark:hidden" alt="Diagrama comparando arquiteturas de subagent e equipe de agentes. Subagents são gerados pelo agente principal, fazem trabalho e relatam resultados de volta. Equipes de agentes coordenam através de uma lista de tarefas compartilhada, com companheiros de equipe se comunicando diretamente uns com os outros." width="4245" height="1615" data-path="images/subagents-vs-agent-teams-light.png" />


57 Ativar equipes de agentes57 Ativar equipes de agentes

58</h2>58</h2>

59 59 

60Equipes de agentes são desabilitadas por padrão. Ative-as definindo a variável de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` como `1`, seja no seu ambiente de shell ou através de [settings.json](/pt/settings):60Equipes de agentes são desabilitadas por padrão. Ative-as definindo a variável de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` como `1`, seja no seu ambiente de shell ou através de [settings.json](/docs/pt/settings):

61 61 

62```json settings.json theme={null}62```json settings.json theme={null}

63{63{


81one on UX, one on technical architecture, one playing devil's advocate.81one on UX, one on technical architecture, one playing devil's advocate.

82```82```

83 83 

84A partir daí, Claude popula uma [lista de tarefas compartilhada](/pt/interactive-mode#task-list), cria companheiros de equipe para cada perspectiva, faz com que explorem o problema e sintetiza descobertas quando terminar.84A partir daí, Claude popula uma [lista de tarefas compartilhada](/docs/pt/interactive-mode#task-list), cria companheiros de equipe para cada perspectiva, faz com que explorem o problema e sintetiza descobertas quando terminar.

85 85 

86O terminal do líder lista companheiros de equipe no painel do agente abaixo da entrada do prompt. A partir do painel:86O terminal do líder lista companheiros de equipe no painel do agente abaixo da entrada do prompt. A partir do painel:

87 87 


89* **Enter**: abra a transcrição do companheiro de equipe selecionado e envie uma mensagem diretamente89* **Enter**: abra a transcrição do companheiro de equipe selecionado e envie uma mensagem diretamente

90* **Escape**: interrompa o turno atual do companheiro de equipe selecionado90* **Escape**: interrompa o turno atual do companheiro de equipe selecionado

91 91 

92{/* min-version: 2.1.199 */}A partir da v2.1.199, a linha de um companheiro de equipe ocioso permanece no painel enquanto qualquer companheiro de equipe ou subagente ainda estiver trabalhando, para que você possa selecioná-lo para revisar sua transcrição ou enviar-lhe mais trabalho. Quando todos os agentes no painel estão ociosos, as linhas ociosas se ocultam após 30 segundos e reaparecem no próximo turno do companheiro de equipe; o companheiro de equipe continua em execução e endereçável enquanto oculto. Na v2.1.181 até v2.1.198, uma linha ociosa se ocultava 30 segundos após seu próprio turno terminar, mesmo enquanto outros companheiros de equipe ainda estavam trabalhando; linhas ociosas não são ocultadas em versões anteriores à v2.1.181.92A partir da v2.1.199, a linha de um companheiro de equipe ocioso permanece no painel enquanto qualquer companheiro de equipe ou subagente ainda estiver trabalhando, para que você possa selecioná-lo para revisar sua transcrição ou enviar-lhe mais trabalho. Quando todos os agentes no painel estão ociosos, as linhas ociosas se ocultam após 30 segundos e reaparecem no próximo turno do companheiro de equipe; o companheiro de equipe continua em execução e endereçável enquanto oculto. Na v2.1.181 até v2.1.198, uma linha ociosa se ocultava 30 segundos após seu próprio turno terminar, mesmo enquanto outros companheiros de equipe ainda estavam trabalhando; linhas ociosas não são ocultadas em versões anteriores à v2.1.181.

93 93 

94Quando mais de três companheiros de equipe estão ociosos ao mesmo tempo, as linhas além das três primeiras se recolhem em uma única linha que conta os companheiros de equipe recolhidos, como `2 idle agents` quando cinco estão ociosos. Selecione-a e pressione Enter para expandir as linhas recolhidas, ou pressione Esc para recolhê-las novamente. Companheiros de equipe trabalhando, companheiros de equipe que falharam e o companheiro de equipe que você está visualizando sempre mantêm suas próprias linhas.94Quando mais de três companheiros de equipe estão ociosos ao mesmo tempo, as linhas além das três primeiras se recolhem em uma única linha que conta os companheiros de equipe recolhidos, como `2 idle agents` quando cinco estão ociosos. Selecione-a e pressione Enter para expandir as linhas recolhidas, ou pressione Esc para recolhê-las novamente. Companheiros de equipe trabalhando, companheiros de equipe que falharam e o companheiro de equipe que você está visualizando sempre mantêm suas próprias linhas.

95 95 


116 116 

117O padrão é `"in-process"`. Antes da v2.1.179, o padrão era `"auto"`, portanto sessões atualizadas que anteriormente abriam split panes agora permanecem em um terminal, a menos que você defina o modo explicitamente. Defina `"auto"` para ativar split panes quando você já estiver executando dentro de uma sessão tmux ou seu terminal for iTerm2, voltando para in-process caso contrário. A configuração `"tmux"` ativa o modo split-pane e detecta automaticamente se deve usar tmux ou iTerm2 com base no seu terminal.117O padrão é `"in-process"`. Antes da v2.1.179, o padrão era `"auto"`, portanto sessões atualizadas que anteriormente abriam split panes agora permanecem em um terminal, a menos que você defina o modo explicitamente. Defina `"auto"` para ativar split panes quando você já estiver executando dentro de uma sessão tmux ou seu terminal for iTerm2, voltando para in-process caso contrário. A configuração `"tmux"` ativa o modo split-pane e detecta automaticamente se deve usar tmux ou iTerm2 com base no seu terminal.

118 118 

119{/* min-version: 2.1.186 */}A partir da v2.1.186, defina `"iterm2"` para usar explicitamente split panes nativos do iTerm2. Este modo requer o [CLI `it2`](https://github.com/mkusaka/it2) e mostra um erro com o comando de instalação se `it2` estiver faltando. O prompt de configuração que oferece instalar `it2` ou mudar para tmux aparece em `"auto"` ou `"tmux"` quando seu terminal é iTerm2 e tmux está disponível como fallback.119A partir da v2.1.186, defina `"iterm2"` para usar explicitamente split panes nativos do iTerm2. Este modo requer o [CLI `it2`](https://github.com/mkusaka/it2) e mostra um erro com o comando de instalação se `it2` estiver faltando. O prompt de configuração que oferece instalar `it2` ou mudar para tmux aparece em `"auto"` ou `"tmux"` quando seu terminal é iTerm2 e tmux está disponível como fallback.

120 120 

121Para substituir o padrão, defina [`teammateMode`](/pt/settings#available-settings) em `~/.claude/settings.json`:121Para substituir o padrão, defina [`teammateMode`](/docs/pt/settings#available-settings) em `~/.claude/settings.json`:

122 122 

123```json theme={null}123```json theme={null}

124{124{


150 150 

151Os companheiros de equipe não herdam a seleção `/model` do líder por padrão. Para alterar o modelo usado quando o prompt não especifica um, defina **Default teammate model** em `/config`. Escolha **Default (leader's model)** para que os companheiros de equipe sigam o modelo atual do líder.151Os companheiros de equipe não herdam a seleção `/model` do líder por padrão. Para alterar o modelo usado quando o prompt não especifica um, defina **Default teammate model** em `/config`. Escolha **Default (leader's model)** para que os companheiros de equipe sigam o modelo atual do líder.

152 152 

153{/* min-version: 2.1.186 */}Os companheiros de equipe herdam o [nível de esforço](/pt/model-config#adjust-effort-level) do líder. No modo split-pane isso se aplica a partir da v2.1.186; versões anteriores não passavam o esforço da sessão do líder para companheiros de equipe em split-pane.153Os companheiros de equipe herdam o [nível de esforço](/docs/pt/model-config#adjust-effort-level) do líder. No modo split-pane isso se aplica a partir da v2.1.186; versões anteriores não passavam o esforço da sessão do líder para companheiros de equipe em split-pane.

154 154 

155<h3 id="require-plan-approval-for-teammates">155<h3 id="require-plan-approval-for-teammates">

156 Exigir aprovação de plano para companheiros de equipe156 Exigir aprovação de plano para companheiros de equipe


176* **Modo in-process**: use as teclas de seta para cima e para baixo no painel de agentes para selecionar um companheiro de equipe, depois pressione Enter para visualizar sua sessão e digite para enviar uma mensagem. Pressione `x` em um companheiro de equipe selecionado para interrompê-lo. Pressione Ctrl+T para alternar a lista de tarefas.176* **Modo in-process**: use as teclas de seta para cima e para baixo no painel de agentes para selecionar um companheiro de equipe, depois pressione Enter para visualizar sua sessão e digite para enviar uma mensagem. Pressione `x` em um companheiro de equipe selecionado para interrompê-lo. Pressione Ctrl+T para alternar a lista de tarefas.

177* **Modo split-pane**: clique em um painel de companheiro de equipe para interagir com sua sessão diretamente. Cada companheiro de equipe tem uma visualização completa de seu próprio terminal.177* **Modo split-pane**: clique em um painel de companheiro de equipe para interagir com sua sessão diretamente. Cada companheiro de equipe tem uma visualização completa de seu próprio terminal.

178 178 

179Enquanto você está visualizando um companheiro de equipe in-process, texto simples e [skills](/pt/skills) vão para esse companheiro de equipe, mas comandos integrados ainda são executados na sessão do líder.179Enquanto você está visualizando um companheiro de equipe in-process, texto simples e [skills](/docs/pt/skills) vão para esse companheiro de equipe, mas comandos integrados ainda são executados na sessão do líder.

180 180 

181O modelo e modo rápido de um companheiro de equipe são fixos quando ele é gerado, portanto `/model` e `/fast` apenas alteram as configurações do líder. {/* min-version: 2.1.199 */}A partir da v2.1.199, digitar qualquer comando enquanto visualiza um companheiro de equipe mostra um aviso de que a alteração se aplica ao líder; versões anteriores a aplicavam ao líder sem indicação. `/effort` ainda se aplica aos turnos posteriores do companheiro de equipe visualizado, porque os companheiros de equipe seguem o [nível de esforço](/pt/model-config#adjust-effort-level) do líder.181O modelo e modo rápido de um companheiro de equipe são fixos quando ele é gerado, portanto `/model` e `/fast` apenas alteram as configurações do líder. A partir da v2.1.199, digitar qualquer comando enquanto visualiza um companheiro de equipe mostra um aviso de que a alteração se aplica ao líder; versões anteriores a aplicavam ao líder sem indicação. `/effort` ainda se aplica aos turnos posteriores do companheiro de equipe visualizado, porque os companheiros de equipe seguem o [nível de esforço](/docs/pt/model-config#adjust-effort-level) do líder.

182 182 

183<h3 id="assign-and-claim-tasks">183<h3 id="assign-and-claim-tasks">

184 Atribuir e reivindicar tarefas184 Atribuir e reivindicar tarefas


211 Aplicar gates de qualidade com hooks211 Aplicar gates de qualidade com hooks

212</h3>212</h3>

213 213 

214Use [hooks](/pt/hooks) para aplicar regras quando os companheiros de equipe terminam o trabalho ou as tarefas são criadas ou concluídas:214Use [hooks](/docs/pt/hooks) para aplicar regras quando os companheiros de equipe terminam o trabalho ou as tarefas são criadas ou concluídas:

215 215 

216* [`TeammateIdle`](/pt/hooks#teammateidle): é executado quando um companheiro de equipe está prestes a ficar ocioso. Saia com código 2 para enviar feedback e manter o companheiro de equipe trabalhando.216* [`TeammateIdle`](/docs/pt/hooks#teammateidle): é executado quando um companheiro de equipe está prestes a ficar ocioso. Saia com código 2 para enviar feedback e manter o companheiro de equipe trabalhando.

217* [`TaskCreated`](/pt/hooks#taskcreated): é executado quando uma tarefa está sendo criada. Saia com código 2 para evitar criação e enviar feedback.217* [`TaskCreated`](/docs/pt/hooks#taskcreated): é executado quando uma tarefa está sendo criada. Saia com código 2 para evitar criação e enviar feedback.

218* [`TaskCompleted`](/pt/hooks#taskcompleted): é executado quando uma tarefa está sendo marcada como concluída. Saia com código 2 para evitar conclusão e enviar feedback.218* [`TaskCompleted`](/docs/pt/hooks#taskcompleted): é executado quando uma tarefa está sendo marcada como concluída. Saia com código 2 para evitar conclusão e enviar feedback.

219 219 

220<h2 id="how-agent-teams-work">220<h2 id="how-agent-teams-work">

221 Como funcionam as equipes de agentes221 Como funcionam as equipes de agentes


258* **Team config**: `~/.claude/teams/{team-name}/config.json`258* **Team config**: `~/.claude/teams/{team-name}/config.json`

259* **Task list**: `~/.claude/tasks/{team-name}/`259* **Task list**: `~/.claude/tasks/{team-name}/`

260 260 

261Claude Code gera ambas automaticamente na inicialização da sessão e as atualiza conforme os companheiros de equipe entram, ficam ociosos ou saem. O diretório de configuração da equipe é removido quando a sessão termina. O diretório da lista de tarefas persiste localmente e nunca é carregado, portanto as sessões retomadas mantêm suas tarefas. A retenção é governada pelo mesmo [`cleanupPeriodDays`](/pt/settings#available-settings) que você já controla para transcrições de sessão.261Claude Code gera ambas automaticamente na inicialização da sessão e as atualiza conforme os companheiros de equipe entram, ficam ociosos ou saem. O diretório de configuração da equipe é removido quando a sessão termina. O diretório da lista de tarefas persiste localmente e nunca é carregado, portanto as sessões retomadas mantêm suas tarefas. A retenção é governada pelo mesmo [`cleanupPeriodDays`](/docs/pt/settings#available-settings) que você já controla para transcrições de sessão.

262 262 

263A configuração da equipe contém estado de tempo de execução, como IDs de sessão e IDs de painel tmux, portanto não a edite manualmente ou a crie previamente: suas alterações são sobrescritas na próxima atualização de estado.263A configuração da equipe contém estado de tempo de execução, como IDs de sessão e IDs de painel tmux, portanto não a edite manualmente ou a crie previamente: suas alterações são sobrescritas na próxima atualização de estado.

264 264 


272 Use subagent definitions for teammates272 Use subagent definitions for teammates

273</h3>273</h3>

274 274 

275Ao gerar um companheiro de equipe, você pode referenciar um tipo de [subagent](/pt/sub-agents) de qualquer [escopo de subagent](/pt/sub-agents#choose-the-subagent-scope): projeto, usuário, plugin ou definido por CLI. Isso permite que você defina um papel uma vez, como um revisor de segurança ou executor de testes, e o reutilize tanto como um subagent delegado quanto como um companheiro de equipe de equipe de agentes.275Ao gerar um companheiro de equipe, você pode referenciar um tipo de [subagent](/docs/pt/sub-agents) de qualquer [escopo de subagent](/docs/pt/sub-agents#choose-the-subagent-scope): projeto, usuário, plugin ou definido por CLI. Isso permite que você defina um papel uma vez, como um revisor de segurança ou executor de testes, e o reutilize tanto como um subagent delegado quanto como um companheiro de equipe de equipe de agentes.

276 276 

277Para usar uma definição de subagent, mencione-a pelo nome ao pedir ao Claude para gerar o companheiro de equipe:277Para usar uma definição de subagent, mencione-a pelo nome ao pedir ao Claude para gerar o companheiro de equipe:

278 278 


292 292 

293Os companheiros de equipe começam com as configurações de permissão do líder. Se o líder for executado com `--dangerously-skip-permissions`, todos os companheiros de equipe também. Após gerar, você pode alterar modos de companheiros de equipe individuais, mas não pode definir modos por companheiro de equipe no tempo de geração.293Os companheiros de equipe começam com as configurações de permissão do líder. Se o líder for executado com `--dangerously-skip-permissions`, todos os companheiros de equipe também. Após gerar, você pode alterar modos de companheiros de equipe individuais, mas não pode definir modos por companheiro de equipe no tempo de geração.

294 294 

295Quando um agente envia uma mensagem para outro sobre `SendMessage`, o agente receptor é informado de que veio de outra sessão Claude, não de você. Um companheiro de equipe não pode aprovar um prompt de permissão ou fornecer consentimento em seu nome, e um companheiro de equipe que foi negado uma ação não pode retransmiti-la para outro companheiro de equipe para contornar a verificação. Em [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode), o classificador trata uma reivindicação de aprovação retransmitida de outro agente como entrada não confiável em vez de confirmação de você.295Quando um agente envia uma mensagem para outro sobre `SendMessage`, o agente receptor é informado de que veio de outra sessão Claude, não de você. Um companheiro de equipe não pode aprovar um prompt de permissão ou fornecer consentimento em seu nome, e um companheiro de equipe que foi negado uma ação não pode retransmiti-la para outro companheiro de equipe para contornar a verificação. Em [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), o classificador trata uma reivindicação de aprovação retransmitida de outro agente como entrada não confiável em vez de confirmação de você.

296 296 

297Os prompts de permissão de companheiros de equipe aparecem na sessão líder, portanto aprove-os lá você mesmo. [Aprovação de plano](#require-plan-approval-for-teammates) é a exceção projetada: a sessão líder concede aprovações de plano de companheiros de equipe sem um prompt separado para você.297Os prompts de permissão de companheiros de equipe aparecem na sessão líder, portanto aprove-os lá você mesmo. [Aprovação de plano](#require-plan-approval-for-teammates) é a exceção projetada: a sessão líder concede aprovações de plano de companheiros de equipe sem um prompt separado para você.

298 298 


305**Como os companheiros de equipe compartilham informações:**305**Como os companheiros de equipe compartilham informações:**

306 306 

307* **Entrega automática de mensagens**: quando os companheiros de equipe enviam mensagens, elas são entregues automaticamente aos destinatários. O líder não precisa fazer polling para atualizações.307* **Entrega automática de mensagens**: quando os companheiros de equipe enviam mensagens, elas são entregues automaticamente aos destinatários. O líder não precisa fazer polling para atualizações.

308* **Notificações de ociosidade**: quando um companheiro de equipe termina e para, ele notifica automaticamente o líder. {/* min-version: 2.1.198 */}A partir da v2.1.198, um companheiro de equipe cuja vez termina em um erro de API notifica o líder que falhou e inclui o texto do erro, em vez de parecer terminar normalmente.308* **Notificações de ociosidade**: quando um companheiro de equipe termina e para, ele notifica automaticamente o líder. A partir da v2.1.198, um companheiro de equipe cuja vez termina em um erro de API notifica o líder que falhou e inclui o texto do erro, em vez de parecer terminar normalmente.

309* **Lista de tarefas compartilhada**: todos os agentes podem ver o status da tarefa e reivindicar trabalho disponível.309* **Lista de tarefas compartilhada**: todos os agentes podem ver o status da tarefa e reivindicar trabalho disponível.

310* **Mensagens de companheiros de equipe**: envie uma mensagem para um companheiro de equipe específico pelo nome. Para alcançar todos, envie uma mensagem por destinatário.310* **Mensagens de companheiros de equipe**: envie uma mensagem para um companheiro de equipe específico pelo nome. Para alcançar todos, envie uma mensagem por destinatário.

311 311 


315 Uso de tokens315 Uso de tokens

316</h3>316</h3>

317 317 

318Equipes de agentes usam significativamente mais tokens do que uma única sessão. Cada companheiro de equipe tem sua própria context window, e o uso de tokens escala com o número de companheiros de equipe ativos. Para pesquisa, revisão e trabalho de novos recursos, os tokens extras geralmente valem a pena. Para tarefas rotineiras, uma única sessão é mais econômica. Veja [custos de token de equipe de agentes](/pt/costs#agent-team-token-costs) para orientação de uso.318Equipes de agentes usam significativamente mais tokens do que uma única sessão. Cada companheiro de equipe tem sua própria context window, e o uso de tokens escala com o número de companheiros de equipe ativos. Para pesquisa, revisão e trabalho de novos recursos, os tokens extras geralmente valem a pena. Para tarefas rotineiras, uma única sessão é mais econômica. Veja [custos de token de equipe de agentes](/docs/pt/costs#agent-team-token-costs) para orientação de uso.

319 319 

320<h2 id="use-case-examples">320<h2 id="use-case-examples">

321 Exemplos de casos de uso321 Exemplos de casos de uso


379 379 

380Não há limite rígido no número de companheiros de equipe, mas restrições práticas se aplicam:380Não há limite rígido no número de companheiros de equipe, mas restrições práticas se aplicam:

381 381 

382* **Custos de token escalam linearmente**: cada companheiro de equipe tem sua própria context window e consome tokens independentemente. Veja [custos de token de equipe de agentes](/pt/costs#agent-team-token-costs) para detalhes.382* **Custos de token escalam linearmente**: cada companheiro de equipe tem sua própria context window e consome tokens independentemente. Veja [custos de token de equipe de agentes](/docs/pt/costs#agent-team-token-costs) para detalhes.

383* **Sobrecarga de coordenação aumenta**: mais companheiros de equipe significa mais comunicação, coordenação de tarefas e potencial para conflitos383* **Sobrecarga de coordenação aumenta**: mais companheiros de equipe significa mais comunicação, coordenação de tarefas e potencial para conflitos

384* **Retornos decrescentes**: além de um certo ponto, companheiros de equipe adicionais não aceleram o trabalho proporcionalmente384* **Retornos decrescentes**: além de um certo ponto, companheiros de equipe adicionais não aceleram o trabalho proporcionalmente

385 385 

386Comece com 3-5 companheiros de equipe para a maioria dos fluxos de trabalho. Isso equilibra o trabalho paralelo com coordenação gerenciável. Os exemplos neste guia usam 3-5 companheiros de equipe porque esse intervalo funciona bem em diferentes tipos de tarefas.386Comece com 3-5 companheiros de equipe para a maioria dos fluxos de trabalho. Isso equilibra o trabalho paralelo com coordenação gerenciável. Os exemplos neste guia usam 3-5 companheiros de equipe porque esse intervalo funciona bem em diferentes tipos de tarefas.

387 387 

388Ter 5-6 [tasks](/pt/agent-teams#architecture) por companheiro de equipe mantém todos produtivos sem alternância de contexto excessiva. Se você tiver 15 tarefas independentes, 3 companheiros de equipe é um bom ponto de partida.388Ter 5-6 [tasks](/docs/pt/agent-teams#architecture) por companheiro de equipe mantém todos produtivos sem alternância de contexto excessiva. Se você tiver 15 tarefas independentes, 3 companheiros de equipe é um bom ponto de partida.

389 389 

390Escale apenas quando o trabalho genuinamente se beneficiar de ter companheiros de equipe trabalhando simultaneamente. Três companheiros de equipe focados frequentemente superam cinco dispersos.390Escale apenas quando o trabalho genuinamente se beneficiar de ter companheiros de equipe trabalhando simultaneamente. Três companheiros de equipe focados frequentemente superam cinco dispersos.

391 391 


452 Muitos prompts de permissão452 Muitos prompts de permissão

453</h3>453</h3>

454 454 

455Solicitações de permissão de companheiros de equipe surgem para o líder, o que pode criar atrito. Pré-aprove operações comuns nas suas [configurações de permissão](/pt/permissions) antes de gerar companheiros de equipe para reduzir interrupções.455Solicitações de permissão de companheiros de equipe surgem para o líder, o que pode criar atrito. Pré-aprove operações comuns nas suas [configurações de permissão](/docs/pt/permissions) antes de gerar companheiros de equipe para reduzir interrupções.

456 456 

457<h3 id="teammates-stopping-on-errors">457<h3 id="teammates-stopping-on-errors">

458 Companheiros de equipe parando em erros458 Companheiros de equipe parando em erros


463* Dê a eles instruções adicionais diretamente463* Dê a eles instruções adicionais diretamente

464* Gere um companheiro de equipe de substituição para continuar o trabalho464* Gere um companheiro de equipe de substituição para continuar o trabalho

465 465 

466{/* min-version: 2.1.198 */}A partir da v2.1.198, uma mensagem do líder ou de outro companheiro de equipe acorda um companheiro de equipe in-process que está aguardando para tentar novamente uma solicitação de API com falha, para que ele tente novamente imediatamente em vez de aguardar o atraso de repetição completo.466A partir da v2.1.198, uma mensagem do líder ou de outro companheiro de equipe acorda um companheiro de equipe in-process que está aguardando para tentar novamente uma solicitação de API com falha, para que ele tente novamente imediatamente em vez de aguardar o atraso de repetição completo.

467 467 

468<h3 id="lead-shuts-down-before-work-is-done">468<h3 id="lead-shuts-down-before-work-is-done">

469 Líder encerra antes do trabalho estar pronto469 Líder encerra antes do trabalho estar pronto


493* **Encerramento pode ser lento**: os companheiros de equipe terminam sua solicitação atual ou chamada de ferramenta antes de encerrar, o que pode levar tempo.493* **Encerramento pode ser lento**: os companheiros de equipe terminam sua solicitação atual ou chamada de ferramenta antes de encerrar, o que pode levar tempo.

494* **Uma equipe por sessão**: uma sessão tem exatamente uma equipe, com escopo para essa sessão. Você não pode criar equipes nomeadas adicionais ou compartilhar uma equipe entre sessões.494* **Uma equipe por sessão**: uma sessão tem exatamente uma equipe, com escopo para essa sessão. Você não pode criar equipes nomeadas adicionais ou compartilhar uma equipe entre sessões.

495* **Sem equipes aninhadas**: os companheiros de equipe não podem gerar seus próprios companheiros de equipe. Apenas o líder pode gerenciar a equipe.495* **Sem equipes aninhadas**: os companheiros de equipe não podem gerar seus próprios companheiros de equipe. Apenas o líder pode gerenciar a equipe.

496* **Sem subagentes em segundo plano de companheiros de equipe in-process**: os próprios subagentes de um companheiro de equipe in-process são executados em primeiro plano. Pedir por um em segundo plano, seja com `run_in_background` ou uma definição de subagente que define `background: true`, retorna um erro, porque o trabalho em segundo plano de um companheiro de equipe não pode sobreviver ao processo do líder. Subagentes lançados da conversa principal seguem o [padrão de segundo plano](/pt/sub-agents#run-subagents-in-foreground-or-background).496* **Sem subagentes em segundo plano de companheiros de equipe in-process**: os próprios subagentes de um companheiro de equipe in-process são executados em primeiro plano. Pedir por um em segundo plano, seja com `run_in_background` ou uma definição de subagente que define `background: true`, retorna um erro, porque o trabalho em segundo plano de um companheiro de equipe não pode sobreviver ao processo do líder. Subagentes lançados da conversa principal seguem o [padrão de segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background).

497* **Líder é fixo**: a sessão principal é o líder por sua vida útil. Você não pode promover um companheiro de equipe a líder ou transferir liderança.497* **Líder é fixo**: a sessão principal é o líder por sua vida útil. Você não pode promover um companheiro de equipe a líder ou transferir liderança.

498* **Permissões definidas no tempo de geração**: todos os companheiros de equipe começam com o modo de permissão do líder. Você pode alterar modos de companheiros de equipe individuais após gerar, mas não pode definir modos por companheiro de equipe no tempo de geração.498* **Permissões definidas no tempo de geração**: todos os companheiros de equipe começam com o modo de permissão do líder. Você pode alterar modos de companheiros de equipe individuais após gerar, mas não pode definir modos por companheiro de equipe no tempo de geração.

499* **Split panes requerem tmux ou iTerm2**: o modo in-process padrão funciona em qualquer terminal. O modo split-pane não é suportado no terminal integrado do VS Code, Windows Terminal ou Ghostty.499* **Split panes requerem tmux ou iTerm2**: o modo in-process padrão funciona em qualquer terminal. O modo split-pane não é suportado no terminal integrado do VS Code, Windows Terminal ou Ghostty.


508 508 

509Explore abordagens relacionadas para trabalho paralelo e delegação:509Explore abordagens relacionadas para trabalho paralelo e delegação:

510 510 

511* **Delegação leve**: [subagents](/pt/sub-agents) geram agentes auxiliares para pesquisa ou verificação dentro de sua sessão, melhor para tarefas que não precisam de coordenação entre agentes511* **Delegação leve**: [subagents](/docs/pt/sub-agents) geram agentes auxiliares para pesquisa ou verificação dentro de sua sessão, melhor para tarefas que não precisam de coordenação entre agentes

512* **Sessões paralelas manuais**: [Git worktrees](/pt/worktrees) permitem que você execute múltiplas sessões Claude Code você mesmo sem coordenação de equipe automatizada512* **Sessões paralelas manuais**: [Git worktrees](/docs/pt/worktrees) permitem que você execute múltiplas sessões Claude Code você mesmo sem coordenação de equipe automatizada

513* **Comparar abordagens**: veja a comparação [subagent vs agent team](/pt/features-overview#compare-similar-features) para um detalhamento lado a lado513* **Comparar abordagens**: veja a comparação [subagent vs agent team](/docs/pt/features-overview#compare-similar-features) para um detalhamento lado a lado

agent-view.md +87 −87

Details

16 16 

17Quando você quer trabalhar de forma mais direta em qualquer sessão de um agente, anexe-se à linha para entrar na conversa completa.17Quando você quer trabalhar de forma mais direta em qualquer sessão de um agente, anexe-se à linha para entrar na conversa completa.

18 18 

19Para comparar agent view com subagentes, equipes de agentes e worktrees, consulte [Executar agentes em paralelo](/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 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.


70 70 

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

72 72 

73{/* min-version: 2.1.205 */}Dentro 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`](/pt/settings#available-settings) esteja ativada, e fica oculta no [modo leitor de tela](/pt/accessibility). No [Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry](/pt/third-party-integrations), a dica permanece em sua forma simples `← for agents` sem a contagem. Requer Claude Code v2.1.205 ou posterior.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.

74 74 

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

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


78 78 

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

80 80 

81O nome é tingido com a cor definida por [`/color`](/pt/commands) naquela sessão. {/* min-version: 2.1.199 */}A partir da v2.1.199, a cor é mantida quando você [coloca uma sessão em background](#from-inside-a-session) com `←` ou `/background`.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`.

82 82 

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

84 84 


88 88 

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

90 90 

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](/pt/sub-agents) e [teammates](/pt/agent-teams) que uma sessão gera não são listados como linhas separadas.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.

92 92 

93```text theme={null}93```text theme={null}

94Pinned94Pinned


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

132| `✻` ou `✽` animado | O processo da sessão está vivo e responde imediatamente |132| `✻` ou `✽` animado | O processo da sessão está vivo e responde imediatamente |

133| `∙` | O processo saiu. Você ainda pode espreitar, responder ou anexar, e Claude reinicia de onde parou |133| `∙` | O processo saiu. Você ainda pode espreitar, responder ou anexar, e Claude reinicia de onde parou |

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

135 135 

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

137 137 

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

139 139 

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](/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`](/pt/scheduled-tasks), notificam apenas quando precisam de sua entrada. As notificações usam a mesma configuração [`preferredNotifChannel`](/pt/settings#available-settings) que o resto do Claude Code e disparam o hook [`Notification`](/pt/hooks#notification) com o tipo `agent_needs_input` ou `agent_completed`.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`.

141 141 

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

143 143 


149 Resumos de linha149 Resumos de linha

150</h3>150</h3>

151 151 

152O resumo de uma linha em cada linha é gerado por um [modelo Haiku-class](/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.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.

153 153 

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

155 155 


157 157 

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

159 159 

160Um turno cuja saída inteira não contém letras ou dígitos, como uma sessão [`/loop`](/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`.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 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](/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`](/pt/model-config#environment-variables) para escolher o modelo para esses resumos nesses provedores.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 163 

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

165 Status de pull request165 Status de pull request


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 

207Com [voice dictation](/pt/voice-dictation) ativada, segure ou toque sua tecla push-to-talk enquanto a entrada de resposta está focada para ditar uma resposta em vez de digitá-la. O mesmo funciona na entrada de despacho na parte inferior de agent view.207Com [voice dictation](/docs/pt/voice-dictation) ativada, segure ou toque sua tecla push-to-talk enquanto a entrada de resposta está focada para ditar uma resposta em vez de digitá-la. O mesmo funciona na entrada de despacho na parte inferior de agent view.

208 208 

209Use `↑` e `↓` para espreitar sessões adjacentes sem fechar o painel, ou `→` para anexar.209Use `↑` e `↓` para espreitar sessões adjacentes sem fechar o painel, ou `→` para anexar.

210 210 


214 214 

215Pressione `Enter` ou `→` em uma linha selecionada para anexar. Agent view é substituído pela sessão interativa completa. Quando você anexa, Claude publica um breve resumo do que aconteceu enquanto você estava ausente.215Pressione `Enter` ou `→` em uma linha selecionada para anexar. Agent view é substituído pela sessão interativa completa. Quando você anexa, Claude publica um breve resumo do que aconteceu enquanto você estava ausente.

216 216 

217Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: [comandos](/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`](/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.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.

220 220 

221Sessões anexadas sempre renderizam em [modo fullscreen](/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. 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.

224 224 


232 232 

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

234 234 

235O limite de dez segundos não se aplica enquanto [subagents](/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.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.

236 236 

237A linha é criada mesmo a partir de uma sessão nova sem histórico de conversa, então `→` retorna a ela. {/* max-version: 2.1.202 */}Antes da v2.1.203, agent view mostrava uma dica de integração abaixo dessa linha quando era a única.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.

238 238 

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

240 240 


313 313 

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

315 315 

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](/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.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.

317 317 

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

319 319 

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. {/* min-version: 2.1.207 */}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.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.

321 321 

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

323 323 

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

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

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

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

329| `/<command>` | Sugerir [skills](/pt/skills) e [commands](/pt/commands) para despachar como o prompt |329| `/<command>` | Sugerir [skills](/docs/pt/skills) e [commands](/docs/pt/commands) para despachar como o prompt |

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

331| `#<number>` ou uma URL de pull request | Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar |331| `#<number>` ou uma URL de pull request | Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar |

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


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

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

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

339* {/* min-version: 2.1.198 */}A partir da v2.1.198, `/login` abre o diálogo de entrada para que você possa entrar novamente sem anexar a uma sessão339* A partir da v2.1.198, `/login` abre o diálogo de entrada para que você possa entrar novamente sem anexar a uma sessão

340 340 

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. {/* min-version: 2.1.203 */}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.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.

342 342 

343Empacotar uma tarefa recorrente como uma [skill](/pt/skills) permite que você inicie o mesmo fluxo de trabalho a partir de agent view repetidamente sem redigitar o prompt.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.

344 344 

345Quando o mesmo `@name` corresponde tanto a um subagent quanto a um repositório irmão, o subagent tem precedência. A correspondência de primeira palavra também se aplica, portanto um prompt que começa com um de seus nomes de subagent despacha esse subagent em vez de tratar a palavra como texto simples. Use a forma `@` quando quiser ser explícito, ou comece o prompt com uma palavra diferente para evitar a correspondência.345Quando o mesmo `@name` corresponde tanto a um subagent quanto a um repositório irmão, o subagent tem precedência. A correspondência de primeira palavra também se aplica, portanto um prompt que começa com um de seus nomes de subagent despacha esse subagent em vez de tratar a palavra como texto simples. Use a forma `@` quando quiser ser explícito, ou comece o prompt com uma palavra diferente para evitar a correspondência.

346 346 


354* Abra `claude agents` em um diretório pai e mencione um repositório filho com `@<repo>` no prompt. Digitando `@` lista estes destinos:354* Abra `claude agents` em um diretório pai e mencione um repositório filho com `@<repo>` no prompt. Digitando `@` lista estes destinos:

355 355 

356 * Repositórios Git um nível abaixo do diretório de lançamento356 * Repositórios Git um nível abaixo do diretório de lançamento

357 * Os [git worktrees](/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 listados357 * 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 lista358 * Qualquer diretório que já tenha uma sessão na lista

359 359 

360 Um diretório cujo nome contém um espaço não é listado. {/* min-version: 2.1.203 */}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.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.

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

362 362 

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


368 368 

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

370 370 

371Sair de uma sessão interativa que ainda tem trabalho em background em execução, como subagents, comandos shell em background, workflows ou [monitors](/pt/tools-reference#monitor-tool), mostra um diálogo `Background work is running` em vez de sair imediatamente. {/* min-version: 2.1.198 */}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).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).

372 372 

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`](/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`](/pt/env-vars#variables); Claude Code então pede que você confirme antes de colocar em background.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.

374 374 

375Trabalho que não pode ser transferido, como um [monitor](/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.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.

376 376 

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

378 378 


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

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

387 387 

388Diretórios que você adicionou durante a sessão com [`/add-dir`](/pt/permissions#additional-directories-grant-file-access-not-configuration) também são transferidos.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.

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


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

400```400```

401 401 

402O prompt é o argumento posicional, não um valor `-p`. {/* min-version: 2.1.198 */}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.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.

403 403 

404Para executar um subagent específico como o agente principal da sessão, combine `--bg` com `--agent`:404Para executar um subagent específico como o agente principal da sessão, combine `--bg` com `--agent`:

405 405 


447 How file edits are isolated447 How file edits are isolated

448</h3>448</h3>

449 449 

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](/pt/worktrees) isolado sob `.claude/worktrees/`, para que sessões paralelas possam ler o mesmo checkout, mas cada uma escreve no seu próprio.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.

451 451 

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

453 453 

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

455* O diretório de trabalho não é um repositório git e nenhum hook [`WorktreeCreate`](/pt/hooks#worktreecreate) está configurado455* 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 trabalho456* A escrita está fora do diretório de trabalho

457 457 

458Para desativar o isolamento de worktree para um repositório onde git worktrees são impraticáveis, defina [`worktree.bgIsolation`](/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: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:

459 459 

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

461{461{


465}465}

466```466```

467 467 

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`](/pt/worktrees#non-git-version-control) e Claude isola edições da mesma forma que faz para git.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.

469 469 

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

471 471 


478 478 

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

480 480 

481Um [subagent](/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`](/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter ou passe `isolation: "worktree"` ao gerá-lo.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.

482 482 

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

484 484 


488 Set the model488 Set the model

489</h3>489</h3>

490 490 

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`](/pt/settings#available-settings) em suas settings de usuário. Defina-o selecionando um modelo no seletor [`/model`](/pt/model-config), ou edite a configuração diretamente.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.

492 492 

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

494 494 


505 505 

506* Do shell, passe `--model` com `claude --bg`.506* Do shell, passe `--model` com `claude --bg`.

507* Anexe a uma sessão em execução e execute `/model` para alternar: uma escolha do seletor, ou um `/model <name>` digitado, salva como seu padrão para novas sessões a menos que você pressione `s` no seletor para uma alternância apenas de sessão. Uma alternância apenas de sessão persiste se a sessão for reiniciada.507* Anexe a uma sessão em execução e execute `/model` para alternar: uma escolha do seletor, ou um `/model <name>` digitado, salva como seu padrão para novas sessões a menos que você pressione `s` no seletor para uma alternância apenas de sessão. Uma alternância apenas de sessão persiste se a sessão for reiniciada.

508* Despache um [subagent](/pt/sub-agents) cujo frontmatter define um campo `model`.508* Despache um [subagent](/docs/pt/sub-agents) cujo frontmatter define um campo `model`.

509 509 

510<h3 id="permission-mode-model-and-effort">510<h3 id="permission-mode-model-and-effort">

511 Permission mode, model, and effort511 Permission mode, model, and effort

512</h3>512</h3>

513 513 

514Uma sessão em background lê suas [settings](/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá. Isso inclui valores [`env`](/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.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.

515 515 

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. {/* min-version: 2.1.206 */}Se você exportar uma substituição de corpo de solicitação [`CLAUDE_CODE_EXTRA_BODY`](/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.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.

517 517 

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](/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.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.

519 519 

520O [permission mode](/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](/pt/sub-agents#supported-frontmatter-fields).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).

521 521 

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

523 523 

524Um esforço que a sessão obteve da configuração [`effortLevel`](/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.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.

525 525 

526Um nome que você definiu com [`/rename`](/pt/commands) ou `Ctrl+R` também persiste nesse reinício, portanto [`claude --resume <name>`](/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.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.

527 527 

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

529 529 


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

532```532```

533 533 

534`--agent` define o [subagent](/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`](/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.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.

535 535 

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](/pt/cli-reference).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).

537 537 

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

539 539 

540Sem essas flags, a sessão usa o `defaultMode` das settings daquele diretório ou o `permissionMode` do [frontmatter do subagent despachado](/pt/sub-agents#supported-frontmatter-fields), e o modelo mostrado no cabeçalho de agent view.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.

541 541 

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

543 543 


549 549 

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

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

552| [`--settings <file-or-json>`](/pt/settings) | Substituir settings para agent view e sessões despachadas |552| [`--settings <file-or-json>`](/docs/pt/settings) | Substituir settings para agent view e sessões despachadas |

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

554| [`--plugin-dir <path>`](/pt/plugins) | Carregar um plugin de um diretório local |554| [`--plugin-dir <path>`](/docs/pt/plugins) | Carregar um plugin de um diretório local |

555| [`--mcp-config <file-or-json>`](/pt/mcp) | Carregar servidores MCP de um arquivo de configuração ou string JSON |555| [`--mcp-config <file-or-json>`](/docs/pt/mcp) | Carregar servidores MCP de um arquivo de configuração ou string JSON |

556| `--strict-mcp-config` | Usar apenas os servidores MCP de `--mcp-config`, ignorando outra configuração MCP |556| `--strict-mcp-config` | Usar apenas os servidores MCP de `--mcp-config`, ignorando outra configuração MCP |

557 557 

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


603 603 

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

605 605 

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](/pt/settings) do diretório do projeto. Para apontar cada sessão em um projeto para um [gateway LLM](/pt/llm-gateway), defina `ANTHROPIC_BASE_URL` no bloco `env` do `settings.json` do `.claude/` desse projeto.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.

607 607 

608{/* min-version: 2.1.203 */}Se 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.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.

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


617 617 

618* Um comando de shell em background que terminou no meio é relatado como concluído com sua saída618* Um comando de shell em background que terminou no meio é relatado como concluído com sua saída

619* Um workflow dinâmico retoma de onde parou619* Um workflow dinâmico retoma de onde parou

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

621 621 

622{/* min-version: 2.1.198 */}A 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.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.

623 623 

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](/pt/tools-reference#monitor-tool) em execução, cujo fluxo de eventos não pode ser movido para outro processo.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.

625 625 

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`](/pt/env-vars#variables) como `1`.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`.

627 627 

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

629 629 


633 633 

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

635 635 

636O supervisor observa o binário Claude Code instalado no disco e reinicia para a nova versão após o [auto-updater](/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.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.

637 637 

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

639 639 


645 Onde o estado é armazenado645 Onde o estado é armazenado

646</h3>646</h3>

647 647 

648O estado da sessão é armazenado sob seu diretório de configuração Claude Code. Se você definir [`CLAUDE_CONFIG_DIR`](/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.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.

649 649 

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

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


660 660 

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

662 662 

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. {/* min-version: 2.1.200 */}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.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.

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


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

669</h3>669</h3>

670 670 

671Para desativar agentes em background e a visualização de agente completamente, defina a [configuração](/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](/pt/permissions#managed-settings).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).

672 672 

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

674 Troubleshooting674 Troubleshooting


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

693</h3>693</h3>

694 694 

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](/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.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.

696 696 

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

698 Prompt rejected as too short698 Prompt rejected as too short


754 754 

755O próximo `claude agents` ou `claude --bg` inicia um novo supervisor que lê suas credenciais armazenadas. Se você autenticar com uma variável de ambiente como `ANTHROPIC_API_KEY` em vez de `/login`, execute esse próximo comando a partir de um shell onde a variável está definida.755O próximo `claude agents` ou `claude --bg` inicia um novo supervisor que lê suas credenciais armazenadas. Se você autenticar com uma variável de ambiente como `ANTHROPIC_API_KEY` em vez de `/login`, execute esse próximo comando a partir de um shell onde a variável está definida.

756 756 

757Veja a [referência de erro](/pt/errors#could-not-resolve-authentication-method) para a lista completa de causas e correções.757Veja a [referência de erro](/docs/pt/errors#could-not-resolve-authentication-method) para a lista completa de causas e correções.

758 758 

759<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">759<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

760 Background sessions can't read Desktop, Documents, or Downloads on macOS760 Background sessions can't read Desktop, Documents, or Downloads on macOS


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

769</h3>769</h3>

770 770 

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. {/* min-version: 2.1.198 */}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.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.

772 772 

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

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


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

783</h3>783</h3>

784 784 

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](/pt/worktrees#clean-up-worktrees).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).

786 786 

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

788 Limitações788 Limitações


800 800 

801Para outras maneiras de executar Claude em paralelo, consulte:801Para outras maneiras de executar Claude em paralelo, consulte:

802 802 

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

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

805* [Claude Code na web](/pt/claude-code-on-the-web): execute sessões em um ambiente de nuvem gerenciado em vez de localmente805* [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 806 

807<h2 id="version-history">807<h2 id="version-history">

808 Histórico de versões808 Histórico de versões


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

812 812 

813| Versão | Mudança |813| Versão | Mudança |

814| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |814| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

815| v2.1.208 | {/* min-version: 2.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. |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. |

816| v2.1.207 | {/* min-version: 2.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. |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. |

817| v2.1.206 | {/* min-version: 2.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. |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. |

818| v2.1.205 | {/* min-version: 2.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. |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. |

819| v2.1.203 | {/* min-version: 2.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. |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. |

820| v2.1.202 | {/* min-version: 2.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. |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. |

821| v2.1.200 | {/* min-version: 2.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. |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. |

822| v2.1.199 | {/* min-version: 2.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. |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. |

823| v2.1.198 | {/* min-version: 2.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. |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. |

824| v2.1.196 | {/* min-version: 2.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. |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. |

825| v2.1.195 | {/* min-version: 2.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. |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. |

826| v2.1.174 | {/* min-version: 2.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`. |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`. |

827| v2.1.172 | {/* min-version: 2.1.172 */}`/model` na entrada de despacho define uma substituição de modelo de despacho com escopo de sessão. |827| 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 | {/* min-version: 2.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. |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. |

829| v2.1.157 | {/* min-version: 2.1.157 */}`claude agents` aceita `--agent`; sessões despachadas honram a configuração `agent`. |829| v2.1.157 | `claude agents` aceita `--agent`; sessões despachadas honram a configuração `agent`. |

830| v2.1.145 | {/* min-version: 2.1.145 */}Voice dictation suportada na entrada de resposta do painel de espiada e na entrada de despacho. |830| v2.1.145 | Voice dictation suportada na entrada de resposta do painel de espiada e na entrada de despacho. |

831| v2.1.143 | {/* min-version: 2.1.143 */}Configuração `worktree.bgIsolation` adicionada; `claude agents` aceita `--allow-dangerously-skip-permissions`. |831| v2.1.143 | Configuração `worktree.bgIsolation` adicionada; `claude agents` aceita `--allow-dangerously-skip-permissions`. |

832| v2.1.142 | {/* min-version: 2.1.142 */}`claude agents` aceita `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` e `--strict-mcp-config`. |832| v2.1.142 | `claude agents` aceita `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` e `--strict-mcp-config`. |

833| v2.1.141 | {/* min-version: 2.1.141 */}`claude agents` aceita `--cwd` para escopar a lista a um projeto. |833| v2.1.141 | `claude agents` aceita `--cwd` para escopar a lista a um projeto. |

834| v2.1.139 | {/* min-version: 2.1.139 */}Agent view introduzido como uma visualização de pesquisa. |834| v2.1.139 | Agent view introduzido como uma visualização de pesquisa. |

agents.md +25 −25

Details

6 6 

7> Compare as formas como Claude Code pode assumir múltiplas tarefas simultaneamente: subagentes, visualização de agentes, equipes de agentes e workflows dinâmicos.7> Compare as formas como Claude Code pode assumir múltiplas tarefas simultaneamente: subagentes, visualização de agentes, equipes de agentes e workflows dinâmicos.

8 8 

9[Subagentes](/pt/sub-agents), [visualização de agentes](/pt/agent-view), [equipes de agentes](/pt/agent-teams) e [workflows dinâmicos](/pt/workflows) cada um paraleliza o trabalho de uma forma diferente. O correto depende de se você quer permanecer em cada conversa você mesmo, delegar tarefas e verificar depois, ou ter Claude coordenando um grupo de trabalhadores para você.9[Subagentes](/docs/pt/sub-agents), [visualização de agentes](/docs/pt/agent-view), [equipes de agentes](/docs/pt/agent-teams) e [workflows dinâmicos](/docs/pt/workflows) cada um paraleliza o trabalho de uma forma diferente. O correto depende de se você quer permanecer em cada conversa você mesmo, delegar tarefas e verificar depois, ou ter Claude coordenando um grupo de trabalhadores para você.

10 10 

11| Abordagem | O que oferece | Use quando |11| Abordagem | O que oferece | Use quando |

12| :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |12| :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

13| [Subagentes](/pt/sub-agents) | Trabalhadores delegados dentro de uma sessão que fazem uma tarefa secundária em seu próprio contexto e retornam um resumo | Uma tarefa secundária inundaria sua conversa principal com resultados de pesquisa, logs ou conteúdos de arquivo que você não consultará novamente |13| [Subagentes](/docs/pt/sub-agents) | Trabalhadores delegados dentro de uma sessão que fazem uma tarefa secundária em seu próprio contexto e retornam um resumo | Uma tarefa secundária inundaria sua conversa principal com resultados de pesquisa, logs ou conteúdos de arquivo que você não consultará novamente |

14| [Visualização de agentes](/pt/agent-view) | Uma tela para despachar e monitorar sessões em execução em segundo plano, aberta com `claude agents`. Visualização de pesquisa | Você tem várias tarefas independentes e quer delegá-las, verificar o status rapidamente e intervir apenas quando uma precisar de você |14| [Visualização de agentes](/docs/pt/agent-view) | Uma tela para despachar e monitorar sessões em execução em segundo plano, aberta com `claude agents`. Visualização de pesquisa | Você tem várias tarefas independentes e quer delegá-las, verificar o status rapidamente e intervir apenas quando uma precisar de você |

15| [Equipes de agentes](/pt/agent-teams) | Múltiplas sessões coordenadas com uma lista de tarefas compartilhada e mensagens entre agentes, gerenciadas por um líder. Experimental e desabilitado por padrão | Você quer que Claude divida um projeto em partes, as atribua e mantenha os trabalhadores sincronizados |15| [Equipes de agentes](/docs/pt/agent-teams) | Múltiplas sessões coordenadas com uma lista de tarefas compartilhada e mensagens entre agentes, gerenciadas por um líder. Experimental e desabilitado por padrão | Você quer que Claude divida um projeto em partes, as atribua e mantenha os trabalhadores sincronizados |

16| [Workflows dinâmicos](/pt/workflows) | Um script que executa muitos subagentes e verifica seus resultados, para um trabalho muito grande para coordenar em um único turno ou que precisa de mais de uma passagem | Uma tarefa cresce além de um punhado de subagentes, ou você quer que as descobertas sejam verificadas uma contra a outra: uma auditoria em toda a base de código, uma migração de 500 arquivos, pesquisa com verificação cruzada ou um plano elaborado de vários ângulos |16| [Workflows dinâmicos](/docs/pt/workflows) | Um script que executa muitos subagentes e verifica seus resultados, para um trabalho muito grande para coordenar em um único turno ou que precisa de mais de uma passagem | Uma tarefa cresce além de um punhado de subagentes, ou você quer que as descobertas sejam verificadas uma contra a outra: uma auditoria em toda a base de código, uma migração de 500 arquivos, pesquisa com verificação cruzada ou um plano elaborado de vários ângulos |

17 17 

18Em cada abordagem, os trabalhadores são sessões Claude. Para envolver uma ferramenta diferente, exponha-a ao Claude como um [servidor MCP](/pt/mcp).18Em cada abordagem, os trabalhadores são sessões Claude. Para envolver uma ferramenta diferente, exponha-a ao Claude como um [servidor MCP](/docs/pt/mcp).

19 19 

20Duas ferramentas adicionais suportam este trabalho sem serem uma forma de executar agentes em si:20Duas ferramentas adicionais suportam este trabalho sem serem uma forma de executar agentes em si:

21 21 

22* [Worktrees](/pt/worktrees) dão a cada sessão um checkout git separado, para que sessões paralelas nunca editem os mesmos arquivos. Use-as para sessões que você executa você mesmo. A visualização de agentes move automaticamente cada sessão despachada para seu próprio worktree, e subagentes que você gera podem cada um receber um também.22* [Worktrees](/docs/pt/worktrees) dão a cada sessão um checkout git separado, para que sessões paralelas nunca editem os mesmos arquivos. Use-as para sessões que você executa você mesmo. A visualização de agentes move automaticamente cada sessão despachada para seu próprio worktree, e subagentes que você gera podem cada um receber um também.

23* [`/batch`](/pt/commands) é uma [skill](/pt/skills) que tem Claude dividir uma grande mudança em 5 a 30 subagentes isolados em worktree que cada um abre um pull request. É um uso empacotado de subagentes e worktrees, não um estilo de coordenação separado.23* [`/batch`](/docs/pt/commands) é uma [skill](/docs/pt/skills) que tem Claude dividir uma grande mudança em 5 a 30 subagentes isolados em worktree que cada um abre um pull request. É um uso empacotado de subagentes e worktrees, não um estilo de coordenação separado.

24 24 

25Alguns outros recursos executam Claude sem você dirigir cada passo, mas resolvem um problema diferente do que dividir trabalho entre agentes:25Alguns outros recursos executam Claude sem você dirigir cada passo, mas resolvem um problema diferente do que dividir trabalho entre agentes:

26 26 

27* Um [comando bash em segundo plano](/pt/interactive-mode#background-bash-commands) executa um comando shell sem bloquear a conversa. Ele não gera um agente.27* Um [comando bash em segundo plano](/docs/pt/interactive-mode#background-bash-commands) executa um comando shell sem bloquear a conversa. Ele não gera um agente.

28* Um [subagente bifurcado](/pt/sub-agents#fork-the-current-conversation) é um subagente que herda seu contexto de conversa completo em vez de começar do zero. É uma forma de gerar um subagente, não uma superfície separada.28* Um [subagente bifurcado](/docs/pt/sub-agents#fork-the-current-conversation) é um subagente que herda seu contexto de conversa completo em vez de começar do zero. É uma forma de gerar um subagente, não uma superfície separada.

29* Uma [rotina](/pt/routines) executa uma sessão em um cronograma na nuvem da Anthropic, não em paralelo em sua máquina.29* Uma [rotina](/docs/pt/routines) executa uma sessão em um cronograma na nuvem da Anthropic, não em paralelo em sua máquina.

30 30 

31<Note>31<Note>

32 Executar várias sessões ou subagentes simultaneamente multiplica o uso de tokens. Veja [Custos](/pt/costs) para detalhes de uso e limite de taxa.32 Executar várias sessões ou subagentes simultaneamente multiplica o uso de tokens. Veja [Custos](/docs/pt/costs) para detalhes de uso e limite de taxa.

33</Note>33</Note>

34 34 

35<h2 id="choose-an-approach">35<h2 id="choose-an-approach">


39A abordagem correta depende de quem coordena o trabalho, se os trabalhadores precisam se comunicar e se editam os mesmos arquivos:39A abordagem correta depende de quem coordena o trabalho, se os trabalhadores precisam se comunicar e se editam os mesmos arquivos:

40 40 

41* **Quem coordena o trabalho?**41* **Quem coordena o trabalho?**

42 * Claude delega e coleta resultados dentro de uma conversa: [subagentes](/pt/sub-agents)42 * Claude delega e coleta resultados dentro de uma conversa: [subagentes](/docs/pt/sub-agents)

43 * Você entrega tarefas independentes e verifica depois: [visualização de agentes](/pt/agent-view)43 * Você entrega tarefas independentes e verifica depois: [visualização de agentes](/docs/pt/agent-view)

44 * Claude planeja, atribui e supervisiona um grupo de trabalhadores: [equipes de agentes](/pt/agent-teams), experimental e desabilitado por padrão44 * Claude planeja, atribui e supervisiona um grupo de trabalhadores: [equipes de agentes](/docs/pt/agent-teams), experimental e desabilitado por padrão

45 * Um script mantém o plano em vez do julgamento turno a turno de Claude: [fluxos de trabalho dinâmicos](/pt/workflows). Veja [como fluxos de trabalho se comparam a subagentes e skills](/pt/workflows#when-to-use-a-workflow)45 * Um script mantém o plano em vez do julgamento turno a turno de Claude: [fluxos de trabalho dinâmicos](/docs/pt/workflows). Veja [como fluxos de trabalho se comparam a subagentes e skills](/docs/pt/workflows#when-to-use-a-workflow)

46* **Os trabalhadores precisam conversar um com o outro?** Subagentes relatam resultados de volta para a conversa que os gerou, e sessões de visualização de agentes relatam apenas para você. Companheiros de equipe em uma equipe de agentes compartilham uma lista de tarefas e se mensageiam diretamente.46* **Os trabalhadores precisam conversar um com o outro?** Subagentes relatam resultados de volta para a conversa que os gerou, e sessões de visualização de agentes relatam apenas para você. Companheiros de equipe em uma equipe de agentes compartilham uma lista de tarefas e se mensageiam diretamente.

47* **As tarefas tocam os mesmos arquivos?** Isole o trabalho com [worktrees](/pt/worktrees). Subagentes e sessões que você executa você mesmo podem cada um usar um worktree separado. Equipes de agentes não isolam companheiros de equipe em worktrees, então [particione o trabalho](/pt/agent-teams#avoid-file-conflicts) para que cada companheiro de equipe possua um conjunto diferente de arquivos.47* **As tarefas tocam os mesmos arquivos?** Isole o trabalho com [worktrees](/docs/pt/worktrees). Subagentes e sessões que você executa você mesmo podem cada um usar um worktree separado. Equipes de agentes não isolam companheiros de equipe em worktrees, então [particione o trabalho](/docs/pt/agent-teams#avoid-file-conflicts) para que cada companheiro de equipe possua um conjunto diferente de arquivos.

48 48 

49<h2 id="check-on-running-work">49<h2 id="check-on-running-work">

50 Verifique o trabalho em execução50 Verifique o trabalho em execução


52 52 

53O comando para verificar o trabalho em execução depende de qual abordagem você usou:53O comando para verificar o trabalho em execução depende de qual abordagem você usou:

54 54 

55* Para sessões em segundo plano, `claude agents` abre [visualização de agentes](/pt/agent-view): uma tela mostrando cada sessão, seu estado e quais precisam de sua entrada.55* Para sessões em segundo plano, `claude agents` abre [visualização de agentes](/docs/pt/agent-view): uma tela mostrando cada sessão, seu estado e quais precisam de sua entrada.

56* Para subagentes na sessão atual, subagentes em segundo plano nomeados aparecem na digitação de menção @- com seu status. {/* min-version: 2.1.198 */}A partir da v2.1.198, `/agents` não abre mais um painel; imprime um aviso apontando para os locais dos arquivos de subagentes. Para [criar e editar subagentes personalizados](/pt/sub-agents#configure-subagents), peça ao Claude ou edite os arquivos diretamente. Apesar do nome similar, `/agents` é separado de `claude agents`.56* Para subagentes na sessão atual, subagentes em segundo plano nomeados aparecem na digitação de menção @- com seu status. A partir da v2.1.198, `/agents` não abre mais um painel; imprime um aviso apontando para os locais dos arquivos de subagentes. Para [criar e editar subagentes personalizados](/docs/pt/sub-agents#configure-subagents), peça ao Claude ou edite os arquivos diretamente. Apesar do nome similar, `/agents` é separado de `claude agents`.

57* Para qualquer coisa em execução em segundo plano da sessão atual, `/tasks` lista cada item e permite que você verifique, se anexe ou interrompa. A lista também inclui subagentes que terminaram.57* Para qualquer coisa em execução em segundo plano da sessão atual, `/tasks` lista cada item e permite que você verifique, se anexe ou interrompa. A lista também inclui subagentes que terminaram.

58* Para fluxos de trabalho dinâmicos, `/workflows` lista execuções em andamento e concluídas, a fase em que cada uma está e quantos agentes terminaram.58* Para fluxos de trabalho dinâmicos, `/workflows` lista execuções em andamento e concluídas, a fase em que cada uma está e quantos agentes terminaram.

59 59 

60Para uma visualização de desktop de todas as suas sessões, veja [sessões paralelas no aplicativo desktop](/pt/desktop#work-in-parallel-with-sessions).60Para uma visualização de desktop de todas as suas sessões, veja [sessões paralelas no aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions).

61 61 

62<h2 id="learn-more">62<h2 id="learn-more">

63 Saiba mais63 Saiba mais


65 65 

66Cada guia abaixo cobre configuração e configuração para uma abordagem:66Cada guia abaixo cobre configuração e configuração para uma abordagem:

67 67 

68* [Criar subagentes personalizados](/pt/sub-agents): defina especialistas reutilizáveis e controle quais ferramentas eles podem usar.68* [Criar subagentes personalizados](/docs/pt/sub-agents): defina especialistas reutilizáveis e controle quais ferramentas eles podem usar.

69* [Gerenciar agentes com visualização de agentes](/pt/agent-view): despache sessões, observe seu estado e se anexe quando uma precisar de você.69* [Gerenciar agentes com visualização de agentes](/docs/pt/agent-view): despache sessões, observe seu estado e se anexe quando uma precisar de você.

70* [Orquestrar equipes de agentes](/pt/agent-teams): configure um líder e companheiros de equipe, atribua tarefas e revise seu trabalho.70* [Orquestrar equipes de agentes](/docs/pt/agent-teams): configure um líder e companheiros de equipe, atribua tarefas e revise seu trabalho.

71* [Orquestrar fluxos de trabalho dinâmicos](/pt/workflows): execute um fluxo de trabalho agrupado ou deixe Claude escrever um que execute muitos subagentes e verifique suas descobertas um contra o outro.71* [Orquestrar fluxos de trabalho dinâmicos](/docs/pt/workflows): execute um fluxo de trabalho agrupado ou deixe Claude escrever um que execute muitos subagentes e verifique suas descobertas um contra o outro.

72* [Executar sessões paralelas com worktrees](/pt/worktrees): inicie Claude em um checkout isolado, controle o que é copiado e limpe depois.72* [Executar sessões paralelas com worktrees](/docs/pt/worktrees): inicie Claude em um checkout isolado, controle o que é copiado e limpe depois.

amazon-bedrock.md +28 −28

Details

107 </Step>107 </Step>

108 108 

109 <Step title="Seguir os prompts do assistente">109 <Step title="Seguir os prompts do assistente">

110 Escolha como você se autentica na AWS: um perfil AWS detectado do seu diretório `~/.aws`, uma chave de API do Amazon Bedrock, uma chave de acesso e segredo, ou credenciais já em seu ambiente. O assistente pega sua região, verifica quais modelos Claude sua conta pode invocar e permite que você os fixe. Ele salva o resultado no bloco `env` do seu [arquivo de configurações do usuário](/pt/settings), para que você não precise exportar variáveis de ambiente você mesmo.110 Escolha como você se autentica na AWS: um perfil AWS detectado do seu diretório `~/.aws`, uma chave de API do Amazon Bedrock, uma chave de acesso e segredo, ou credenciais já em seu ambiente. O assistente pega sua região, verifica quais modelos Claude sua conta pode invocar e permite que você os fixe. Ele salva o resultado no bloco `env` do seu [arquivo de configurações do usuário](/docs/pt/settings), para que você não precise exportar variáveis de ambiente você mesmo.

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 

114Depois de entrar, execute `/setup-bedrock` a qualquer momento para reabrir o assistente e alterar suas credenciais, região ou fixações de modelo. A etapa de fixação de modelo começa a partir de seus modelos atualmente fixados. O assistente escreve em `~/.claude/settings.json`, ou em `$CLAUDE_CONFIG_DIR/settings.json` quando [`CLAUDE_CONFIG_DIR`](/pt/env-vars#variables) está definido.114Depois de entrar, execute `/setup-bedrock` a qualquer momento para reabrir o assistente e alterar suas credenciais, região ou fixações de modelo. A etapa de fixação de modelo começa a partir de seus modelos atualmente fixados. O assistente escreve em `~/.claude/settings.json`, ou em `$CLAUDE_CONFIG_DIR/settings.json` quando [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars#variables) está definido.

115 115 

116<h2 id="set-up-manually">116<h2 id="set-up-manually">

117 Configurar manualmente117 Configurar manualmente


162export AWS_PROFILE=your-profile-name162export AWS_PROFILE=your-profile-name

163```163```

164 164 

165Claude Code solicita credenciais de função do IAM Identity Center na região nomeada pelo `sso_region` do perfil, que não precisa corresponder à região em que você executa Amazon Bedrock. {/* min-version: 2.1.208 */}Na v2.1.207, a região do Amazon Bedrock substituiu `sso_region`, então um perfil cuja instância do IAM Identity Center está em uma região diferente falhou ao autenticar com um erro `Session token not found or invalid`.165Claude Code solicita credenciais de função do IAM Identity Center na região nomeada pelo `sso_region` do perfil, que não precisa corresponder à região em que você executa Amazon Bedrock. Na v2.1.207, a região do Amazon Bedrock substituiu `sso_region`, então um perfil cuja instância do IAM Identity Center está em uma região diferente falhou ao autenticar com um erro `Session token not found or invalid`.

166 166 

167**Opção D: Credenciais do AWS Management Console**167**Opção D: Credenciais do AWS Management Console**

168 168 


188 188 

189Antes da v2.1.207, Claude Code resolvia a cadeia em cada solicitação de API, então um perfil apoiado por SSO solicitava credenciais novas do IAM Identity Center cada vez e poderia ser limitado em implantações grandes.189Antes da v2.1.207, Claude Code resolvia a cadeia em cada solicitação de API, então um perfil apoiado por SSO solicitava credenciais novas do IAM Identity Center cada vez e poderia ser limitado em implantações grandes.

190 190 

191O cache cobre todas as opções de credencial acima, exceto uma chave de API do Amazon Bedrock, que não usa a cadeia de provedor. Para resolver a cadeia em cada solicitação em vez disso, defina [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/pt/env-vars).191O cache cobre todas as opções de credencial acima, exceto uma chave de API do Amazon Bedrock, que não usa a cadeia de provedor. Para resolver a cadeia em cada solicitação em vez disso, defina [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/pt/env-vars).

192 192 

193Cada resolução da cadeia expira após 60 segundos. Se uma etapa na cadeia travar, por exemplo um auxiliar `credential_process` que aguarda entrada que não pode receber, a solicitação falha com [`AWS default-chain credential resolve timed out`](/pt/errors#aws-default-chain-credential-resolve-timed-out). Se sua cadeia executa um login interativo que legitimamente precisa de mais tempo, como SSO baseado em navegador com MFA através de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/pt/env-vars). Antes da v2.1.207, uma resolução de credencial travada deixava a solicitação aguardando indefinidamente.193Cada resolução da cadeia expira após 60 segundos. Se uma etapa na cadeia travar, por exemplo um auxiliar `credential_process` que aguarda entrada que não pode receber, a solicitação falha com [`AWS default-chain credential resolve timed out`](/docs/pt/errors#aws-default-chain-credential-resolve-timed-out). Se sua cadeia executa um login interativo que legitimamente precisa de mais tempo, como SSO baseado em navegador com MFA através de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars). Antes da v2.1.207, uma resolução de credencial travada deixava a solicitação aguardando indefinidamente.

194 194 

195<h4 id="advanced-credential-configuration">195<h4 id="advanced-credential-configuration">

196 Configuração avançada de credenciais196 Configuração avançada de credenciais

197</h4>197</h4>

198 198 

199Claude Code suporta atualização automática de credenciais para AWS SSO e provedores de identidade corporativa. Adicione estas configurações ao seu arquivo de configurações do Claude Code (veja [Settings](/pt/settings) para localizações de arquivo).199Claude Code suporta atualização automática de credenciais para AWS SSO e provedores de identidade corporativa. Adicione estas configurações ao seu arquivo de configurações do Claude Code (veja [Settings](/docs/pt/settings) para localizações de arquivo).

200 200 

201Estas duas configurações têm diferentes condições de acionamento:201Estas duas configurações têm diferentes condições de acionamento:

202 202 


235}235}

236```236```

237 237 

238{/* min-version: 2.1.181 */}A 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`.238A 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`.

239 239 

240`Expiration` é opcional. {/* min-version: 2.1.176 */}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 dessa hora. Sem ele, ou em versões anteriores, as credenciais são armazenadas em cache por uma hora.240`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 dessa hora. Sem ele, ou em versões anteriores, as credenciais são armazenadas em cache por uma hora.

241 241 

242Quando 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. Antes da v2.1.206, a inicialização também re-resolvia a cadeia de provedor padrão, o que fazia uma chamada SSO ou STS ao vivo fora de sua configuração de proxy e poderia bloquear o primeiro prompt por vários minutos em redes com saída restrita.242Quando 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. Antes da v2.1.206, a inicialização também re-resolvia a cadeia de provedor padrão, o que fazia uma chamada SSO ou STS ao vivo fora de sua configuração de proxy e poderia bloquear o primeiro prompt por vários minutos em redes com saída restrita.

243 243 


263 263 

264Ao habilitar Amazon Bedrock para Claude Code, tenha em mente o seguinte:264Ao habilitar Amazon Bedrock para Claude Code, tenha em mente o seguinte:

265 265 

266* {/* min-version: 2.1.172 */}A partir da v2.1.172, você só precisa definir `AWS_REGION` para substituir a região do seu perfil AWS ou quando seu perfil não tem região. Claude Code resolve a região nesta ordem:266* A partir da v2.1.172, você só precisa definir `AWS_REGION` para substituir a região do seu perfil AWS ou quando seu perfil não tem região. Claude Code resolve a região nesta ordem:

267 267 

268 * `AWS_REGION`268 * `AWS_REGION`

269 * `AWS_DEFAULT_REGION`269 * `AWS_DEFAULT_REGION`


272 272 

273 O perfil ativo é `AWS_PROFILE` se definido, caso contrário `default`. Defina `AWS_SHARED_CREDENTIALS_FILE` ou `AWS_CONFIG_FILE` para apontar para caminhos de arquivo não padrão. Execute `/status` para ver a região resolvida. Quando a região veio de seus arquivos de configuração AWS ou do fallback padrão, `/status` também anota a fonte. Na v2.1.171 e anterior, Claude Code não lê os arquivos de configuração AWS, então defina `AWS_REGION` explicitamente.273 O perfil ativo é `AWS_PROFILE` se definido, caso contrário `default`. Defina `AWS_SHARED_CREDENTIALS_FILE` ou `AWS_CONFIG_FILE` para apontar para caminhos de arquivo não padrão. Execute `/status` para ver a região resolvida. Quando a região veio de seus arquivos de configuração AWS ou do fallback padrão, `/status` também anota a fonte. Na v2.1.171 e anterior, Claude Code não lê os arquivos de configuração AWS, então defina `AWS_REGION` explicitamente.

274* Ao usar Amazon Bedrock, o comando `/logout` não está disponível, pois a autenticação é tratada através de credenciais AWS.274* Ao usar Amazon Bedrock, o comando `/logout` não está disponível, pois a autenticação é tratada através de credenciais AWS.

275* A ferramenta WebSearch não está disponível no Amazon Bedrock. Veja [comportamento da ferramenta WebSearch](/pt/tools-reference#websearch-tool-behavior).275* A ferramenta WebSearch não está disponível no Amazon Bedrock. Veja [comportamento da ferramenta WebSearch](/docs/pt/tools-reference#websearch-tool-behavior).

276* Você pode usar arquivos de configurações para variáveis de ambiente como `AWS_PROFILE` que você não quer vazar para outros processos. Veja [Settings](/pt/settings) para mais informações.276* Você pode usar arquivos de configurações para variáveis de ambiente como `AWS_PROFILE` que você não quer vazar para outros processos. Veja [Settings](/docs/pt/settings) para mais informações.

277 277 

278<h3 id="4-pin-model-versions">278<h3 id="4-pin-model-versions">

279 4. Fixar versões de modelo279 4. Fixar versões de modelo


293export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'293export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

294```294```

295 295 

296Estas variáveis usam IDs de perfil de inferência entre regiões (com o prefixo `us.`). Se você usar um prefixo de região diferente ou perfis de inferência de aplicação, ajuste de acordo. Em regiões AWS GovCloud, use o prefixo `us-gov.`. Para IDs de modelo atuais e legados, veja [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Veja [Configuração de modelo](/pt/model-config#pin-models-for-third-party-deployments) para a lista completa de variáveis de ambiente.296Estas variáveis usam IDs de perfil de inferência entre regiões (com o prefixo `us.`). Se você usar um prefixo de região diferente ou perfis de inferência de aplicação, ajuste de acordo. Em regiões AWS GovCloud, use o prefixo `us-gov.`. Para IDs de modelo atuais e legados, veja [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Veja [Configuração de modelo](/docs/pt/model-config#pin-models-for-third-party-deployments) para a lista completa de variáveis de ambiente.

297 297 

298Claude Code usa estes modelos padrão quando nenhuma variável de fixação está definida:298Claude Code usa estes modelos padrão quando nenhuma variável de fixação está definida:

299 299 


311 Modelos Opus têm um preço por token mais alto do que modelos Sonnet, então uma implantação que não fixa um modelo primário é cobrada à taxa Opus uma vez que atualiza para v2.1.207 ou posterior. Para manter Sonnet 4.5 como o modelo primário, defina `ANTHROPIC_MODEL` para seu ID de modelo completo. Uma implantação que direciona o padrão com `ANTHROPIC_DEFAULT_SONNET_MODEL` e não define `ANTHROPIC_DEFAULT_OPUS_MODEL` mantém seu modelo Sonnet direcionado como o padrão.311 Modelos Opus têm um preço por token mais alto do que modelos Sonnet, então uma implantação que não fixa um modelo primário é cobrada à taxa Opus uma vez que atualiza para v2.1.207 ou posterior. Para manter Sonnet 4.5 como o modelo primário, defina `ANTHROPIC_MODEL` para seu ID de modelo completo. Uma implantação que direciona o padrão com `ANTHROPIC_DEFAULT_SONNET_MODEL` e não define `ANTHROPIC_DEFAULT_OPUS_MODEL` mantém seu modelo Sonnet direcionado como o padrão.

312</Warning>312</Warning>

313 313 

314{/* min-version: 2.1.207 */}Antes da v2.1.207, o modelo primário no Amazon Bedrock padronizava para Sonnet 4.5, o alias `opus` resolvia para Opus 4.6, e tarefas em segundo plano sempre usavam o modelo primário.314Antes da v2.1.207, o modelo primário no Amazon Bedrock padronizava para Sonnet 4.5, o alias `opus` resolvia para Opus 4.6, e tarefas em segundo plano sempre usavam o modelo primário.

315 315 

316Para personalizar modelos ainda mais, use um destes métodos:316Para personalizar modelos ainda mais, use um destes métodos:

317 317 


330export ENABLE_PROMPT_CACHING_1H=1330export ENABLE_PROMPT_CACHING_1H=1

331```331```

332 332 

333O TTL de cache de 1 hora é cobrado a uma taxa mais alta do que o padrão de 5 minutos. Veja [tempo de vida do cache](/pt/prompt-caching#cache-lifetime).333O TTL de cache de 1 hora é cobrado a uma taxa mais alta do que o padrão de 5 minutos. Veja [tempo de vida do cache](/docs/pt/prompt-caching#cache-lifetime).

334 334 

335<Note>O cache de prompt pode não estar disponível em todas as regiões do Amazon Bedrock. Se as contagens de tokens de cache permanecerem em zero, verifique [modelos, regiões e limites suportados](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) na documentação do Amazon Bedrock.</Note>335<Note>O cache de prompt pode não estar disponível em todas as regiões do Amazon Bedrock. Se as contagens de tokens de cache permanecerem em zero, verifique [modelos, regiões e limites suportados](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) na documentação do Amazon Bedrock.</Note>

336 336 


338 Mapear cada versão de modelo para um perfil de inferência338 Mapear cada versão de modelo para um perfil de inferência

339</h4>339</h4>

340 340 

341As variáveis de ambiente `ANTHROPIC_DEFAULT_*_MODEL` configuram um perfil de inferência por família de modelo. Se sua organização precisa expor várias versões da mesma família no seletor `/model`, cada uma roteada para seu próprio ARN de perfil de inferência de aplicação, use a configuração `modelOverrides` em seu [arquivo de configurações](/pt/settings#settings-files) em vez disso.341As variáveis de ambiente `ANTHROPIC_DEFAULT_*_MODEL` configuram um perfil de inferência por família de modelo. Se sua organização precisa expor várias versões da mesma família no seletor `/model`, cada uma roteada para seu próprio ARN de perfil de inferência de aplicação, use a configuração `modelOverrides` em seu [arquivo de configurações](/docs/pt/settings#settings-files) em vez disso.

342 342 

343Este exemplo mapeia quatro versões de Opus para ARNs distintos para que os usuários possam alternar entre elas sem contornar os perfis de inferência de sua organização:343Este exemplo mapeia quatro versões de Opus para ARNs distintos para que os usuários possam alternar entre elas sem contornar os perfis de inferência de sua organização:

344 344 


353}353}

354```354```

355 355 

356Quando um usuário seleciona uma dessas versões em `/model`, Claude Code chama Amazon Bedrock com o ARN mapeado. {/* min-version: 2.1.200 */}O mesmo mapeamento se aplica quando você passa o ID de modelo Anthropic diretamente através de `--model` ou `ANTHROPIC_MODEL`. Versões sem uma substituição voltam para o ID de modelo Amazon Bedrock integrado ou qualquer perfil de inferência correspondente descoberto na inicialização. Antes da v2.1.200, os valores `--model` e `ANTHROPIC_MODEL` chegavam ao Amazon Bedrock como estavam sem passar pelo mapa de substituição. Veja [Substituir IDs de modelo por versão](/pt/model-config#override-model-ids-per-version) para detalhes sobre como as substituições interagem com `availableModels` e outras configurações de modelo.356Quando um usuário seleciona uma dessas versões em `/model`, Claude Code chama Amazon Bedrock com o ARN mapeado. O mesmo mapeamento se aplica quando você passa o ID de modelo Anthropic diretamente através de `--model` ou `ANTHROPIC_MODEL`. Versões sem uma substituição voltam para o ID de modelo Amazon Bedrock integrado ou qualquer perfil de inferência correspondente descoberto na inicialização. Antes da v2.1.200, os valores `--model` e `ANTHROPIC_MODEL` chegavam ao Amazon Bedrock como estavam sem passar pelo mapa de substituição. Veja [Substituir IDs de modelo por versão](/docs/pt/model-config#override-model-ids-per-version) para detalhes sobre como as substituições interagem com `availableModels` e outras configurações de modelo.

357 357 

358<h2 id="startup-model-checks">358<h2 id="startup-model-checks">

359 Verificações de modelo na inicialização359 Verificações de modelo na inicialização


361 361 

362Quando Claude Code inicia com Amazon Bedrock configurado, ele verifica que os modelos que pretende usar estão acessíveis em sua conta.362Quando Claude Code inicia com Amazon Bedrock configurado, ele verifica que os modelos que pretende usar estão acessíveis em sua conta.

363 363 

364Se você fixou uma versão de modelo que é mais antiga do que o padrão atual do Claude Code, e sua conta pode invocar a versão mais recente, Claude Code o solicita a atualizar a fixação. Aceitar escreve o novo ID de modelo em seu [arquivo de configurações do usuário](/pt/settings) e reinicia Claude Code. Recusar é lembrado até a próxima mudança de versão padrão. Fixações que apontam para um [ARN de perfil de inferência de aplicação](#map-each-model-version-to-an-inference-profile) são ignoradas, pois são gerenciadas pelo seu administrador.364Se você fixou uma versão de modelo que é mais antiga do que o padrão atual do Claude Code, e sua conta pode invocar a versão mais recente, Claude Code o solicita a atualizar a fixação. Aceitar escreve o novo ID de modelo em seu [arquivo de configurações do usuário](/docs/pt/settings) e reinicia Claude Code. Recusar é lembrado até a próxima mudança de versão padrão. Fixações que apontam para um [ARN de perfil de inferência de aplicação](#map-each-model-version-to-an-inference-profile) são ignoradas, pois são gerenciadas pelo seu administrador.

365 365 

366Se você não fixou um modelo e o padrão atual não está disponível em sua conta, Claude Code volta para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, volta para o modelo Sonnet padrão. O fallback não é persistido. Habilite o modelo mais recente em sua conta Amazon Bedrock ou [fixe uma versão](#4-pin-model-versions) para tornar a escolha permanente.366Se você não fixou um modelo e o padrão atual não está disponível em sua conta, Claude Code volta para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, volta para o modelo Sonnet padrão. O fallback não é persistido. Habilite o modelo mais recente em sua conta Amazon Bedrock ou [fixe uma versão](#4-pin-model-versions) para tornar a escolha permanente.

367 367 


426 426 

427Claude Sonnet 5, Opus 4.6 e posteriores, e Sonnet 4.6 suportam a [janela de contexto de 1M de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) no Amazon Bedrock. Sonnet 5 é servido através do [endpoint Mantle](#use-the-mantle-endpoint) e sempre é executado com a janela de 1M, sem nenhuma variante `[1m]` para selecionar. Para os outros modelos, Claude Code habilita automaticamente a janela de contexto estendida quando você seleciona uma variante de modelo de 1M.427Claude Sonnet 5, Opus 4.6 e posteriores, e Sonnet 4.6 suportam a [janela de contexto de 1M de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) no Amazon Bedrock. Sonnet 5 é servido através do [endpoint Mantle](#use-the-mantle-endpoint) e sempre é executado com a janela de 1M, sem nenhuma variante `[1m]` para selecionar. Para os outros modelos, Claude Code habilita automaticamente a janela de contexto estendida quando você seleciona uma variante de modelo de 1M.

428 428 

429O [assistente de configuração](#sign-in-with-bedrock) oferece uma opção de contexto de 1M quando fixa modelos. Para habilitá-lo para um modelo fixado manualmente em vez disso, acrescente `[1m]` ao ID do modelo. Veja [Fixar modelos para implantações de terceiros](/pt/model-config#pin-models-for-third-party-deployments) para detalhes.429O [assistente de configuração](#sign-in-with-bedrock) oferece uma opção de contexto de 1M quando fixa modelos. Para habilitá-lo para um modelo fixado manualmente em vez disso, acrescente `[1m]` ao ID do modelo. Veja [Fixar modelos para implantações de terceiros](/docs/pt/model-config#pin-models-for-third-party-deployments) para detalhes.

430 430 

431<h2 id="service-tiers">431<h2 id="service-tiers">

432 Camadas de serviço432 Camadas de serviço


444 AWS Guardrails444 AWS Guardrails

445</h2>445</h2>

446 446 

447[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) permitem que você implemente filtragem de conteúdo para Claude Code. Crie um Guardrail no [console do Amazon Bedrock](https://console.aws.amazon.com/bedrock/), publique uma versão, então adicione os cabeçalhos do Guardrail ao seu [arquivo de configurações](/pt/settings). Habilite inferência entre regiões em seu Guardrail se você estiver usando perfis de inferência entre regiões.447[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) permitem que você implemente filtragem de conteúdo para Claude Code. Crie um Guardrail no [console do Amazon Bedrock](https://console.aws.amazon.com/bedrock/), publique uma versão, então adicione os cabeçalhos do Guardrail ao seu [arquivo de configurações](/docs/pt/settings). Habilite inferência entre regiões em seu Guardrail se você estiver usando perfis de inferência entre regiões.

448 448 

449Exemplo de configuração:449Exemplo de configuração:

450 450 


473export AWS_REGION=us-east-1473export AWS_REGION=us-east-1

474```474```

475 475 

476Claude Code constrói a URL do endpoint a partir da região AWS. {/* min-version: 2.1.172 */}A partir da v2.1.172, a região é resolvida com a mesma precedência que [Amazon Bedrock acima](#3-configure-claude-code); versões anteriores usam apenas `AWS_REGION`. Para substituir a URL por um endpoint personalizado ou gateway, defina `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.476Claude Code constrói a URL do endpoint a partir da região AWS. A partir da v2.1.172, a região é resolvida com a mesma precedência que [Amazon Bedrock acima](#3-configure-claude-code); versões anteriores usam apenas `AWS_REGION`. Para substituir a URL por um endpoint personalizado ou gateway, defina `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.

477 477 

478Execute `/status` dentro do Claude Code para confirmar. A linha do provedor mostra `Amazon Bedrock (Mantle)` quando Mantle está ativo.478Execute `/status` dentro do Claude Code para confirmar. A linha do provedor mostra `Amazon Bedrock (Mantle)` quando Mantle está ativo.

479 479 


500export CLAUDE_CODE_USE_MANTLE=1500export CLAUDE_CODE_USE_MANTLE=1

501```501```

502 502 

503Para exibir um modelo Mantle no seletor `/model`, liste seu ID em `availableModels` em seu [arquivo de configurações](/pt/settings). Esta configuração também restringe o seletor às entradas listadas. Listar `anthropic.claude-haiku-4-5` remove o alias simples `haiku` do seletor, então também liste prefixos de versão ou IDs completos para as versões que você quer manter selecionáveis. O ID Mantle e o alias `haiku` resolvem para a mesma família de modelo, então a mesclagem mantém apenas a entrada mais específica. Veja [Comportamento de mesclagem](/pt/model-config#merge-behavior):503Para exibir um modelo Mantle no seletor `/model`, liste seu ID em `availableModels` em seu [arquivo de configurações](/docs/pt/settings). Esta configuração também restringe o seletor às entradas listadas. Listar `anthropic.claude-haiku-4-5` remove o alias simples `haiku` do seletor, então também liste prefixos de versão ou IDs completos para as versões que você quer manter selecionáveis. O ID Mantle e o alias `haiku` resolvem para a mesma família de modelo, então a mesclagem mantém apenas a entrada mais específica. Veja [Comportamento de mesclagem](/docs/pt/model-config#merge-behavior):

504 504 

505```json theme={null}505```json theme={null}

506{506{


508}508}

509```509```

510 510 

511Entradas com o prefixo `anthropic.` são adicionadas como opções de seletor personalizadas e roteadas para Mantle. Substitua `anthropic.claude-haiku-4-5` pelo ID de modelo que sua conta foi concedida. Veja [Restringir seleção de modelo](/pt/model-config#restrict-model-selection) para como `availableModels` interage com outras configurações de modelo.511Entradas com o prefixo `anthropic.` são adicionadas como opções de seletor personalizadas e roteadas para Mantle. Substitua `anthropic.claude-haiku-4-5` pelo ID de modelo que sua conta foi concedida. Veja [Restringir seleção de modelo](/docs/pt/model-config#restrict-model-selection) para como `availableModels` interage com outras configurações de modelo.

512 512 

513Quando ambos os provedores estão ativos, `/status` mostra `Amazon Bedrock + Amazon Bedrock (Mantle)`.513Quando ambos os provedores estão ativos, `/status` mostra `Amazon Bedrock + Amazon Bedrock (Mantle)`.

514 514 


516 Rotear Mantle através de um gateway516 Rotear Mantle através de um gateway

517</h3>517</h3>

518 518 

519Se sua organização roteia tráfego de modelo através de um [gateway LLM](/pt/llm-gateway) centralizado que injeta credenciais AWS no lado do servidor, desabilite a autenticação no lado do cliente para que Claude Code envie solicitações sem assinaturas SigV4 ou cabeçalhos `x-api-key`:519Se sua organização roteia tráfego de modelo através de um [gateway LLM](/docs/pt/llm-gateway) centralizado que injeta credenciais AWS no lado do servidor, desabilite a autenticação no lado do cliente para que Claude Code envie solicitações sem assinaturas SigV4 ou cabeçalhos `x-api-key`:

520 520 

521```bash theme={null}521```bash theme={null}

522export CLAUDE_CODE_USE_MANTLE=1522export CLAUDE_CODE_USE_MANTLE=1


528 Variáveis de ambiente Mantle528 Variáveis de ambiente Mantle

529</h3>529</h3>

530 530 

531Estas variáveis são específicas para o endpoint Mantle. Veja [Variáveis de ambiente](/pt/env-vars) para a lista completa.531Estas variáveis são específicas para o endpoint Mantle. Veja [Variáveis de ambiente](/docs/pt/env-vars) para a lista completa.

532 532 

533| Variável | Propósito |533| Variável | Propósito |

534| :-------------------------------------- | :------------------------------------------------------------------------------------- |534| :-------------------------------------- | :------------------------------------------------------------------------------------- |


545 Loop de autenticação com SSO e proxies corporativos545 Loop de autenticação com SSO e proxies corporativos

546</h3>546</h3>

547 547 

548Se abas do navegador aparecem repetidamente ao usar AWS SSO, remova a configuração `awsAuthRefresh` do seu [arquivo de configurações](/pt/settings). Isso pode ocorrer quando VPNs corporativas ou proxies de inspeção TLS interrompem o fluxo do navegador SSO. Claude Code trata a conexão interrompida como uma falha de autenticação, executa novamente `awsAuthRefresh` e entra em loop indefinidamente.548Se abas do navegador aparecem repetidamente ao usar AWS SSO, remova a configuração `awsAuthRefresh` do seu [arquivo de configurações](/docs/pt/settings). Isso pode ocorrer quando VPNs corporativas ou proxies de inspeção TLS interrompem o fluxo do navegador SSO. Claude Code trata a conexão interrompida como uma falha de autenticação, executa novamente `awsAuthRefresh` e entra em loop indefinidamente.

549 549 

550Se seu ambiente de rede interfere com fluxos SSO automáticos baseados em navegador, use `aws sso login` manualmente antes de iniciar Claude Code em vez de depender de `awsAuthRefresh`.550Se seu ambiente de rede interfere com fluxos SSO automáticos baseados em navegador, use `aws sso login` manualmente antes de iniciar Claude Code em vez de depender de `awsAuthRefresh`.

551 551 


573 573 

574Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` depois que toda a resposta tinha sido armazenada em buffer.574Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` depois que toda a resposta tinha sido armazenada em buffer.

575 575 

576Para corrigir, configure o gateway para passar o corpo da resposta `InvokeModelWithResponseStream` e seu cabeçalho `Content-Type` sem modificações. Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/pt/env-vars) para pular a verificação até que o gateway seja corrigido. Com a verificação desativada, um corpo de resposta que foi transformado falha com `Truncated event message received` novamente.576Para corrigir, configure o gateway para passar o corpo da resposta `InvokeModelWithResponseStream` e seu cabeçalho `Content-Type` sem modificações. Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/pt/env-vars) para pular a verificação até que o gateway seja corrigido. Com a verificação desativada, um corpo de resposta que foi transformado falha com `Truncated event message received` novamente.

577 577 

578<h3 id="zero-token-counts-in-/context">578<h3 id="zero-token-counts-in-/context">

579 Contagens de token zero em /context579 Contagens de token zero em /context

580</h3>580</h3>

581 581 

582O comando `/context` conta tokens para cada grupo de ferramentas enviando os esquemas de ferramentas para a API count-tokens do Amazon Bedrock. {/* min-version: 2.1.196 */}Em versões do Claude Code anteriores à v2.1.196, Amazon Bedrock rejeitou essa solicitação porque os esquemas carregavam campos que sua API count-tokens não aceita, então cada grupo de ferramentas mostrava 0 tokens. Outras linhas na análise, como mensagens e arquivos de memória, não são afetadas.582O comando `/context` conta tokens para cada grupo de ferramentas enviando os esquemas de ferramentas para a API count-tokens do Amazon Bedrock. Em versões do Claude Code anteriores à v2.1.196, Amazon Bedrock rejeitou essa solicitação porque os esquemas carregavam campos que sua API count-tokens não aceita, então cada grupo de ferramentas mostrava 0 tokens. Outras linhas na análise, como mensagens e arquivos de memória, não são afetadas.

583 583 

584Atualize para v2.1.196 ou posterior.584Atualize para v2.1.196 ou posterior.

585 585 


587 Erros de endpoint Mantle587 Erros de endpoint Mantle

588</h3>588</h3>

589 589 

590Se `/status` não mostra `Amazon Bedrock (Mantle)` depois que você defina `CLAUDE_CODE_USE_MANTLE`, a variável não está chegando ao processo. Confirme que ela é exportada no shell onde você lançou `claude`, ou defina-a no bloco `env` do seu [arquivo de configurações](/pt/settings).590Se `/status` não mostra `Amazon Bedrock (Mantle)` depois que você defina `CLAUDE_CODE_USE_MANTLE`, a variável não está chegando ao processo. Confirme que ela é exportada no shell onde você lançou `claude`, ou defina-a no bloco `env` do seu [arquivo de configurações](/docs/pt/settings).

591 591 

592Um `403` do endpoint Mantle com credenciais válidas significa que sua conta AWS não foi concedida acesso ao modelo que você solicitou. Entre em contato com sua equipe de conta AWS para solicitar acesso.592Um `403` do endpoint Mantle com credenciais válidas significa que sua conta AWS não foi concedida acesso ao modelo que você solicitou. Entre em contato com sua equipe de conta AWS para solicitar acesso.

593 593 

artifacts.md +15 −19

Details

6 6 

7> Artefatos transformam o trabalho do Claude Code em páginas ao vivo e interativas no claude.ai que você pode manter privadas, compartilhar com sua organização ou publicar em um link público.7> Artefatos transformam o trabalho do Claude Code em páginas ao vivo e interativas no claude.ai que você pode manter privadas, compartilhar com sua organização ou publicar em um link público.

8 8 

9{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}

10 

11<Note>9<Note>

12 Artefatos estão disponíveis nos planos Pro, Max, Team e Enterprise e exigem uma sessão conectada com [`/login`](/pt/setup#authenticate). Consulte [Disponibilidade](#availability) para o conjunto completo de requisitos.10 Artefatos estão disponíveis nos planos Pro, Max, Team e Enterprise e exigem uma sessão conectada com [`/login`](/docs/pt/setup#authenticate). Consulte [Disponibilidade](#availability) para o conjunto completo de requisitos.

13</Note>11</Note>

14 12 

15Um artefato é uma página da web ao vivo e interativa que Claude Code publica de sua sessão para uma URL privada no claude.ai. Você a abre em um navegador e ela é atualizada no local conforme a sessão continua. Compartilhe-a do cabeçalho da página quando quiser que alguém mais a veja também. Por exemplo, use um artefato para guiar um revisor através de uma solicitação de pull com diffs anotados, criar um painel a partir de dados de sessão ou manter uma linha do tempo de investigação que se preenche conforme Claude trabalha.13Um artefato é uma página da web ao vivo e interativa que Claude Code publica de sua sessão para uma URL privada no claude.ai. Você a abre em um navegador e ela é atualizada no local conforme a sessão continua. Compartilhe-a do cabeçalho da página quando quiser que alguém mais a veja também. Por exemplo, use um artefato para guiar um revisor através de uma solicitação de pull com diffs anotados, criar um painel a partir de dados de sessão ou manter uma linha do tempo de investigação que se preenche conforme Claude trabalha.


22 Quando usar um artefato20 Quando usar um artefato

23</h2>21</h2>

24 22 

25Use um artefato quando o texto do terminal é o meio errado para o que Claude produziu: saída que é mais fácil de visualizar e interagir do que ler linha por linha. Claude constrói a página a partir de qualquer coisa que sua sessão possa alcançar, incluindo sua base de código e dados que ela extrai através de suas [ferramentas conectadas](/pt/mcp), para que a página possa mostrar coisas que levariam parágrafos para descrever. Por exemplo, peça a Claude para:23Use um artefato quando o texto do terminal é o meio errado para o que Claude produziu: saída que é mais fácil de visualizar e interagir do que ler linha por linha. Claude constrói a página a partir de qualquer coisa que sua sessão possa alcançar, incluindo sua base de código e dados que ela extrai através de suas [ferramentas conectadas](/docs/pt/mcp), para que a página possa mostrar coisas que levariam parágrafos para descrever. Por exemplo, peça a Claude para:

26 24 

27* Guiar um revisor através de uma solicitação de pull com diffs anotados25* Guiar um revisor através de uma solicitação de pull com diffs anotados

28* Renderizar um painel a partir de dados que a sessão já extraiu26* Renderizar um painel a partir de dados que a sessão já extraiu


104 Extrair dados ao vivo com conectores MCP102 Extrair dados ao vivo com conectores MCP

105</h2>103</h2>

106 104 

107{/* plan-availability: feature=artifact-mcp plans=pro,max,team,enterprise providers=anthropic */}105Um artefato pode chamar [conectores MCP](/docs/pt/mcp#use-mcp-servers-from-claude-ai) cada vez que alguém o visualiza, para que a página mostre dados atuais em vez de um instantâneo da sessão que a construiu. Chamadas de conectores de artefatos estão disponíveis nos planos Pro, Max, Team e Enterprise e exigem Claude Code v2.1.209 ou posterior. Em versões anteriores, Claude publica a página com os dados que a sessão coletou durante sua construção.

108 

109Um artefato pode chamar [conectores MCP](/pt/mcp#use-mcp-servers-from-claude-ai) cada vez que alguém o visualiza, para que a página mostre dados atuais em vez de um instantâneo da sessão que a construiu. Chamadas de conectores de artefatos estão disponíveis nos planos Pro, Max, Team e Enterprise e exigem Claude Code v2.1.209 ou posterior. Em versões anteriores, Claude publica a página com os dados que a sessão coletou durante sua construção.

110 106 

111Para criar uma página com suporte de conectores, nomeie o conector e os dados que deseja em seu prompt:107Para criar uma página com suporte de conectores, nomeie o conector e os dados que deseja em seu prompt:

112 108 


202 Melhorar o design visual198 Melhorar o design visual

203</h2>199</h2>

204 200 

205A partir do Claude Code v2.1.183, Claude aplica uma skill de design integrada quando constrói um artefato, portanto as páginas recebem uma paleta deliberada, tipografia e layout sem prompting extra. Essa skill também procura por um sistema de design existente em seu projeto antes de escolher o seu próprio. Para manter os artefatos consistentes com a marca do seu produto, registre seus tokens de design onde Claude possa encontrá-los, como o [CLAUDE.md](/pt/memory) do projeto ou um arquivo de tema em seu repositório:201A partir do Claude Code v2.1.183, Claude aplica uma skill de design integrada quando constrói um artefato, portanto as páginas recebem uma paleta deliberada, tipografia e layout sem prompting extra. Essa skill também procura por um sistema de design existente em seu projeto antes de escolher o seu próprio. Para manter os artefatos consistentes com a marca do seu produto, registre seus tokens de design onde Claude possa encontrá-los, como o [CLAUDE.md](/docs/pt/memory) do projeto ou um arquivo de tema em seu repositório:

206 202 

207```markdown theme={null}203```markdown theme={null}

208## Design system204## Design system


243| Requisito | Disponível quando |239| Requisito | Disponível quando |

244| :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |240| :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

245| Plano | Pro, Max, Team ou Enterprise. Em planos Pro e Max, artefatos são privados para você até que você os compartilhe, e nenhuma gestão de admin se aplica. Em planos Team, artefatos estão ativados por padrão. Em planos Enterprise, um Owner [os habilita](#manage-artifacts-for-your-organization) nas configurações de admin do claude.ai. |241| Plano | Pro, Max, Team ou Enterprise. Em planos Pro e Max, artefatos são privados para você até que você os compartilhe, e nenhuma gestão de admin se aplica. Em planos Team, artefatos estão ativados por padrão. Em planos Enterprise, um Owner [os habilita](#manage-artifacts-for-your-organization) nas configurações de admin do claude.ai. |

246| Autenticação | A sessão é apoiada por uma conta claude.ai: faça login com `/login` na CLI ou aplicativo de desktop. Sessões Claude Tag são conectadas através da identidade do agente, portanto nenhuma etapa é necessária. Sessões usando uma chave de API, [token de gateway](/pt/llm-gateway) ou credencial de provedor de nuvem não podem publicar. |242| Autenticação | A sessão é apoiada por uma conta claude.ai: faça login com `/login` na CLI ou aplicativo de desktop. Sessões Claude Tag são conectadas através da identidade do agente, portanto nenhuma etapa é necessária. Sessões usando uma chave de API, [token de gateway](/docs/pt/llm-gateway) ou credencial de provedor de nuvem não podem publicar. |

247| Provedor de modelo | API Anthropic. Não disponível em [Amazon Bedrock](/pt/amazon-bedrock), [Google Cloud's Agent Platform](/pt/google-vertex-ai) ou [Microsoft Foundry](/pt/microsoft-foundry). |243| Provedor de modelo | API Anthropic. Não disponível em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) ou [Microsoft Foundry](/docs/pt/microsoft-foundry). |

248| Política da organização | Chaves de criptografia gerenciadas pelo cliente (CMEK), HIPAA e [Retenção Zero de Dados](/pt/zero-data-retention) não estão habilitadas para a organização. |244| Política da organização | Chaves de criptografia gerenciadas pelo cliente (CMEK), HIPAA e [Retenção Zero de Dados](/docs/pt/zero-data-retention) não estão habilitadas para a organização. |

249| Superfície | Claude Code CLI versão 2.1.183 ou posterior, ou aplicativo de desktop Claude versão 1.13576.0 ou posterior. Sessões [Claude Tag](https://claude.com/docs/claude-tag/overview) também podem publicar artefatos quando Claude Tag e artefatos estão habilitados para a organização. Desativado por padrão em contextos [Agent SDK](/pt/agent-sdk/overview), GitHub Action e MCP-server, e quando [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/pt/env-vars) está definido. |245| Superfície | Claude Code CLI versão 2.1.183 ou posterior, ou aplicativo de desktop Claude versão 1.13576.0 ou posterior. Sessões [Claude Tag](https://claude.com/docs/claude-tag/overview) também podem publicar artefatos quando Claude Tag e artefatos estão habilitados para a organização. Desativado por padrão em contextos [Agent SDK](/docs/pt/agent-sdk/overview), GitHub Action e MCP-server, e quando [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars) está definido. |

250 246 

251<h2 id="disable-artifacts">247<h2 id="disable-artifacts">

252 Desabilitar artefatos248 Desabilitar artefatos


256 252 

257| Método | Configuração |253| Método | Configuração |

258| :--------------------------------------- | :--------------------------------------- |254| :--------------------------------------- | :--------------------------------------- |

259| [Arquivo de configurações](/pt/settings) | `"disableArtifact": true` |255| [Arquivo de configurações](/docs/pt/settings) | `"disableArtifact": true` |

260| [Variável de ambiente](/pt/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` |256| [Variável de ambiente](/docs/pt/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` |

261| [Regra de permissão](/pt/permissions) | Adicione `Artifact` a `permissions.deny` |257| [Regra de permissão](/docs/pt/permissions) | Adicione `Artifact` a `permissions.deny` |

262 258 

263<h2 id="manage-artifacts-for-your-organization">259<h2 id="manage-artifacts-for-your-organization">

264 Gerenciar artefatos para sua organização260 Gerenciar artefatos para sua organização


300 Adicionar o domínio do visualizador à lista de permissões296 Adicionar o domínio do visualizador à lista de permissões

301</h3>297</h3>

302 298 

303O visualizador em claude.ai carrega cada artefato de uma origem `*.claudeusercontent.com` em sandbox. Se sua organização restringe o acesso à rede de saída, adicione esse domínio à sua lista de permissões junto com `claude.ai`. Consulte [Requisitos de acesso à rede](/pt/network-config#network-access-requirements) para a lista completa.299O visualizador em claude.ai carrega cada artefato de uma origem `*.claudeusercontent.com` em sandbox. Se sua organização restringe o acesso à rede de saída, adicione esse domínio à sua lista de permissões junto com `claude.ai`. Consulte [Requisitos de acesso à rede](/docs/pt/network-config#network-access-requirements) para a lista completa.

304 300 

305<h3 id="list-and-delete-artifacts-with-the-compliance-api">301<h3 id="list-and-delete-artifacts-with-the-compliance-api">

306 Listar e excluir artefatos com a API de Conformidade302 Listar e excluir artefatos com a API de Conformidade


320 Recursos relacionados316 Recursos relacionados

321</h2>317</h2>

322 318 

323* Procure [padrões de prompting e fluxos de trabalho](/pt/prompt-library) que se emparelham com artefatos319* Procure [padrões de prompting e fluxos de trabalho](/docs/pt/prompt-library) que se emparelham com artefatos

324* Transforme um prompt de artefato que você reutiliza em uma [skill](/pt/skills) para que você possa invocá-lo como um comando320* Transforme um prompt de artefato que você reutiliza em uma [skill](/docs/pt/skills) para que você possa invocá-lo como um comando

325* [Conecte servidores MCP](/pt/mcp) para que Claude possa extrair dados para um artefato enquanto ele constrói a página321* [Conecte servidores MCP](/docs/pt/mcp) para que Claude possa extrair dados para um artefato enquanto ele constrói a página

authentication.md +28 −28

Details

12 Faça login no Claude Code12 Faça login no Claude Code

13</h2>13</h2>

14 14 

15Após [instalar Claude Code](/pt/setup#install-claude-code), execute `claude` no seu terminal. No primeiro lançamento, Claude Code abre uma janela do navegador para você fazer login.15Após [instalar Claude Code](/docs/pt/setup#install-claude-code), execute `claude` no seu terminal. No primeiro lançamento, Claude Code abre uma janela do navegador para você fazer login.

16 16 

17Se o navegador não abrir automaticamente, pressione `c` para copiar a URL de login para sua área de transferência, depois cole-a no seu navegador.17Se o navegador não abrir automaticamente, pressione `c` para copiar a URL de login para sua área de transferência, depois cole-a no seu navegador.

18 18 


25* **Assinatura Claude Pro ou Max**: faça login com sua conta Claude.ai. Assine em [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).25* **Assinatura Claude Pro ou Max**: faça login com sua conta Claude.ai. Assine em [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

26* **Claude for Teams ou Enterprise**: faça login com a conta Claude.ai que seu administrador de equipe o convidou.26* **Claude for Teams ou Enterprise**: faça login com a conta Claude.ai que seu administrador de equipe o convidou.

27* **Claude Console**: faça login com suas credenciais do Console. Seu administrador deve ter [o convidado](#claude-console-authentication) primeiro.27* **Claude Console**: faça login com suas credenciais do Console. Seu administrador deve ter [o convidado](#claude-console-authentication) primeiro.

28* **Provedores de nuvem**: se sua organização usa [Amazon Bedrock](/pt/amazon-bedrock), [Google Cloud's Agent Platform](/pt/google-vertex-ai) ou [Microsoft Foundry](/pt/microsoft-foundry), defina as variáveis de ambiente necessárias antes de executar `claude`, ou selecione **plataforma de terceiros** no prompt de login, que inicia um assistente de configuração interativa para Bedrock e Vertex AI. Nenhum login do navegador é necessário.28* **Provedores de nuvem**: se sua organização usa [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) ou [Microsoft Foundry](/docs/pt/microsoft-foundry), defina as variáveis de ambiente necessárias antes de executar `claude`, ou selecione **plataforma de terceiros** no prompt de login, que inicia um assistente de configuração interativa para Bedrock e Vertex AI. Nenhum login do navegador é necessário.

29* **Cloud gateway**: se sua organização executa um [gateway de aplicativos Claude](/pt/claude-apps-gateway) auto-hospedado, faça login com SSO corporativo através de `/login`. O token emitido pelo gateway é a única credencial da sessão.29* **Cloud gateway**: se sua organização executa um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado, faça login com SSO corporativo através de `/login`. O token emitido pelo gateway é a única credencial da sessão.

30 30 

31Administradores podem restringir login interativo com as configurações gerenciadas [`forceLoginMethod` e `forceLoginOrgUUID`](/pt/settings#available-settings). Quando qualquer uma delas é definida, sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` são bloqueadas na inicialização; sessões de provedores de nuvem não são afetadas.31Administradores podem restringir login interativo com as configurações gerenciadas [`forceLoginMethod` e `forceLoginOrgUUID`](/docs/pt/settings#available-settings). Quando qualquer uma delas é definida, sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` são bloqueadas na inicialização; sessões de provedores de nuvem não são afetadas.

32 32 

33Para fazer logout e se autenticar novamente, digite `/logout` no prompt do Claude Code. Fazer logout também redefine seu estado de configuração de primeiro lançamento, portanto, na próxima vez que você executar `claude`, ele o guiará novamente pelo login e configuração.33Para fazer logout e se autenticar novamente, digite `/logout` no prompt do Claude Code. Fazer logout também redefine seu estado de configuração de primeiro lançamento, portanto, na próxima vez que você executar `claude`, ele o guiará novamente pelo login e configuração.

34 34 

35Se você está tendo problemas para fazer login, consulte [solução de problemas de autenticação](/pt/troubleshoot-install#login-and-authentication).35Se você está tendo problemas para fazer login, consulte [solução de problemas de autenticação](/docs/pt/troubleshoot-install#login-and-authentication).

36 36 

37<h2 id="set-up-team-authentication">37<h2 id="set-up-team-authentication">

38 Configure a autenticação da equipe38 Configure a autenticação da equipe


42 42 

43* [Claude for Teams ou Enterprise](#claude-for-teams-or-enterprise), recomendado para a maioria das equipes43* [Claude for Teams ou Enterprise](#claude-for-teams-or-enterprise), recomendado para a maioria das equipes

44* [Claude Console](#claude-console-authentication)44* [Claude Console](#claude-console-authentication)

45* [Claude apps gateway](/pt/claude-apps-gateway), um gateway auto-hospedado que faz login dos desenvolvedores com seu IdP e roteia a inferência para o provedor de nuvem que você configurar45* [Claude apps gateway](/docs/pt/claude-apps-gateway), um gateway auto-hospedado que faz login dos desenvolvedores com seu IdP e roteia a inferência para o provedor de nuvem que você configurar

46* [Amazon Bedrock](/pt/amazon-bedrock)46* [Amazon Bedrock](/docs/pt/amazon-bedrock)

47* [Google Cloud's Agent Platform](/pt/google-vertex-ai)47* [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai)

48* [Microsoft Foundry](/pt/microsoft-foundry)48* [Microsoft Foundry](/docs/pt/microsoft-foundry)

49 49 

50<h3 id="claude-for-teams-or-enterprise">50<h3 id="claude-for-teams-or-enterprise">

51 Claude for Teams ou Enterprise51 Claude for Teams ou Enterprise


99 Cada usuário convidado precisa:99 Cada usuário convidado precisa:

100 100 

101 * Aceitar o convite do Console101 * Aceitar o convite do Console

102 * [Verificar requisitos do sistema](/pt/setup#system-requirements)102 * [Verificar requisitos do sistema](/docs/pt/setup#system-requirements)

103 * [Instalar Claude Code](/pt/setup#install-claude-code)103 * [Instalar Claude Code](/docs/pt/setup#install-claude-code)

104 * Fazer login com credenciais da conta do Console104 * Fazer login com credenciais da conta do Console

105 </Step>105 </Step>

106</Steps>106</Steps>


113 113 

114<Steps>114<Steps>

115 <Step title="Siga a configuração do provedor">115 <Step title="Siga a configuração do provedor">

116 Siga a [documentação do Amazon Bedrock](/pt/amazon-bedrock), [documentação do Google Cloud's Agent Platform](/pt/google-vertex-ai) ou [documentação do Microsoft Foundry](/pt/microsoft-foundry).116 Siga a [documentação do Amazon Bedrock](/docs/pt/amazon-bedrock), [documentação do Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) ou [documentação do Microsoft Foundry](/docs/pt/microsoft-foundry).

117 </Step>117 </Step>

118 118 

119 <Step title="Distribua a configuração">119 <Step title="Distribua a configuração">

120 Distribua as variáveis de ambiente e instruções para gerar credenciais de nuvem para seus usuários. Leia mais sobre como [gerenciar a configuração aqui](/pt/settings).120 Distribua as variáveis de ambiente e instruções para gerar credenciais de nuvem para seus usuários. Leia mais sobre como [gerenciar a configuração aqui](/docs/pt/settings).

121 </Step>121 </Step>

122 122 

123 <Step title="Instale Claude Code">123 <Step title="Instale Claude Code">

124 Os usuários podem [instalar Claude Code](/pt/setup#install-claude-code).124 Os usuários podem [instalar Claude Code](/docs/pt/setup#install-claude-code).

125 </Step>125 </Step>

126</Steps>126</Steps>

127 127 


136 * No Linux, as credenciais são armazenadas em `~/.claude/.credentials.json` com modo de arquivo `0600`.136 * No Linux, as credenciais são armazenadas em `~/.claude/.credentials.json` com modo de arquivo `0600`.

137 * No Windows, as credenciais são armazenadas em `%USERPROFILE%\.claude\.credentials.json` e herdam os controles de acesso do diretório do seu perfil de usuário, o que restringe o arquivo à sua conta de usuário por padrão.137 * No Windows, as credenciais são armazenadas em `%USERPROFILE%\.claude\.credentials.json` e herdam os controles de acesso do diretório do seu perfil de usuário, o que restringe o arquivo à sua conta de usuário por padrão.

138 * Se você definiu a variável de ambiente `CLAUDE_CONFIG_DIR` no Linux ou Windows, o arquivo `.credentials.json` fica sob esse diretório em vez disso.138 * Se você definiu a variável de ambiente `CLAUDE_CONFIG_DIR` no Linux ou Windows, o arquivo `.credentials.json` fica sob esse diretório em vez disso.

139 * Claude Code gerencia `.credentials.json` através de `/login` e `/logout`. Para rotear solicitações através de um endpoint de API personalizado, defina a variável de ambiente [`ANTHROPIC_BASE_URL`](/pt/env-vars) em vez disso.139 * Claude Code gerencia `.credentials.json` através de `/login` e `/logout`. Para rotear solicitações através de um endpoint de API personalizado, defina a variável de ambiente [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) em vez disso.

140* **Tipos de autenticação suportados**: credenciais Claude.ai, credenciais da API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth e tokens de sessão do [gateway de aplicativos Claude](/pt/claude-apps-gateway).140* **Tipos de autenticação suportados**: credenciais Claude.ai, credenciais da API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth e tokens de sessão do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway).

141* **Scripts de credenciais personalizados**: a configuração [`apiKeyHelper`](/pt/settings#available-settings) pode ser configurada para executar um script de shell que retorna uma chave de API.141* **Scripts de credenciais personalizados**: a configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) pode ser configurada para executar um script de shell que retorna uma chave de API.

142* **Intervalos de atualização**: por padrão, `apiKeyHelper` é chamado após 5 minutos ou em resposta HTTP 401. Defina a variável de ambiente `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` para intervalos de atualização personalizados.142* **Intervalos de atualização**: por padrão, `apiKeyHelper` é chamado após 5 minutos ou em resposta HTTP 401. Defina a variável de ambiente `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` para intervalos de atualização personalizados.

143* **Aviso de helper lento**: se `apiKeyHelper` levar mais de 10 segundos para retornar uma chave, Claude Code exibe um aviso na barra de prompt mostrando o tempo decorrido. Se você vir este aviso regularmente, verifique se seu script de credenciais pode ser otimizado.143* **Aviso de helper lento**: se `apiKeyHelper` levar mais de 10 segundos para retornar uma chave, Claude Code exibe um aviso na barra de prompt mostrando o tempo decorrido. Se você vir este aviso regularmente, verifique se seu script de credenciais pode ser otimizado.

144* **Falhas do helper**: {/* min-version: 2.1.208 */}quando o script sai com um erro, expira ou não imprime nada, as solicitações falham com [`Your apiKeyHelper script is failing`](/pt/errors#your-apikeyhelper-script-is-failing) dentro de três tentativas. Antes da v2.1.208, as falhas do helper apareciam como um 401 genérico após cerca de dez tentativas silenciosas.144* **Falhas do helper**: quando o script sai com um erro, expira ou não imprime nada, as solicitações falham com [`Your apiKeyHelper script is failing`](/docs/pt/errors#your-apikeyhelper-script-is-failing) dentro de três tentativas. Antes da v2.1.208, as falhas do helper apareciam como um 401 genérico após cerca de dez tentativas silenciosas.

145 145 

146`apiKeyHelper`, `ANTHROPIC_API_KEY` e `ANTHROPIC_AUTH_TOKEN` se aplicam à CLI e às superfícies que a envolvem, incluindo a extensão VS Code, o Agent SDK e GitHub Actions. Claude Desktop e sessões na nuvem não chamam `apiKeyHelper` ou leem essas variáveis de ambiente: eles usam OAuth, exceto sessões de desktop executando uma [configuração de inferência de terceiros](/pt/llm-gateway-connect#desktop-app), que se autenticam com a credencial dessa configuração.146`apiKeyHelper`, `ANTHROPIC_API_KEY` e `ANTHROPIC_AUTH_TOKEN` se aplicam à CLI e às superfícies que a envolvem, incluindo a extensão VS Code, o Agent SDK e GitHub Actions. Claude Desktop e sessões na nuvem não chamam `apiKeyHelper` ou leem essas variáveis de ambiente: eles usam OAuth, exceto sessões de desktop executando uma [configuração de inferência de terceiros](/docs/pt/llm-gateway-connect#desktop-app), que se autenticam com a credencial dessa configuração.

147 147 

148<h3 id="renew-an-expiring-login">148<h3 id="renew-an-expiring-login">

149 Renovar um login que está expirando149 Renovar um login que está expirando


153 153 

154Execute `/login` para renovar. O aviso é informativo e nunca bloqueia uma solicitação: a autenticação continua funcionando até que o login realmente expire. O tempo de vida do login em si não muda; o aviso antecipado é o que v2.1.203 adiciona.154Execute `/login` para renovar. O aviso é informativo e nunca bloqueia uma solicitação: a autenticação continua funcionando até que o login realmente expire. O tempo de vida do login em si não muda; o aviso antecipado é o que v2.1.203 adiciona.

155 155 

156{/* min-version: 2.1.206 */}Quando o login armazenado expira e não pode ser atualizado, cada solicitação falha com [`Login expired · Please run /login`](/pt/errors#login-expired) até que você se conecte novamente. Antes da v2.1.206, um login expirado aparecia como um erro de modelo em vez disso.156Quando o login armazenado expira e não pode ser atualizado, cada solicitação falha com [`Login expired · Please run /login`](/docs/pt/errors#login-expired) até que você se conecte novamente. Antes da v2.1.206, um login expirado aparecia como um erro de modelo em vez disso.

157 157 

158O aviso aparece apenas quando um login claude.ai ou Claude Console é a credencial ativa, e não quando um provedor de nuvem, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fornece a credencial.158O aviso aparece apenas quando um login claude.ai ou Claude Console é a credencial ativa, e não quando um provedor de nuvem, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fornece a credencial.

159 159 

160Renovar antecipadamente é mais importante para sessões que são executadas sem supervisão. Uma [sessão em segundo plano na visualização de agente](/pt/agent-view) ou uma sessão de [Remote Control](/pt/remote-control) que sobrevive ao login para de fazer progresso uma vez que a credencial expira e não pode se recuperar até que você se conecte novamente.160Renovar antecipadamente é mais importante para sessões que são executadas sem supervisão. Uma [sessão em segundo plano na visualização de agente](/docs/pt/agent-view) ou uma sessão de [Remote Control](/docs/pt/remote-control) que sobrevive ao login para de fazer progresso uma vez que a credencial expira e não pode se recuperar até que você se conecte novamente.

161 161 

162<h3 id="authentication-precedence">162<h3 id="authentication-precedence">

163 Precedência de autenticação163 Precedência de autenticação


165 165 

166Quando múltiplas credenciais estão presentes, Claude Code escolhe uma nesta ordem:166Quando múltiplas credenciais estão presentes, Claude Code escolhe uma nesta ordem:

167 167 

1681. Credenciais do provedor de nuvem, quando `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido. Consulte [integrações de terceiros](/pt/third-party-integrations) para configuração.1681. Credenciais do provedor de nuvem, quando `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido. Consulte [integrações de terceiros](/docs/pt/third-party-integrations) para configuração.

1692. Variável de ambiente `ANTHROPIC_AUTH_TOKEN`. Enviada como o cabeçalho `Authorization: Bearer`. Use isso ao rotear através de um [gateway LLM ou proxy](/pt/llm-gateway) que autentica com tokens bearer em vez de chaves de API Anthropic.1692. Variável de ambiente `ANTHROPIC_AUTH_TOKEN`. Enviada como o cabeçalho `Authorization: Bearer`. Use isso ao rotear através de um [gateway LLM ou proxy](/docs/pt/llm-gateway) que autentica com tokens bearer em vez de chaves de API Anthropic.

1703. Variável de ambiente `ANTHROPIC_API_KEY`. Enviada como o cabeçalho `X-Api-Key`. Use isso para acesso direto à API Anthropic com uma chave do [Claude Console](https://platform.claude.com). No modo interativo, você é solicitado uma vez a aprovar ou recusar a chave, e sua escolha é lembrada. Para alterá-la depois, use o toggle "Use custom API key" em `/config`. O toggle aparece apenas enquanto `ANTHROPIC_API_KEY` está definido em seu ambiente. No modo não interativo (`-p`), a chave é sempre usada quando presente.1703. Variável de ambiente `ANTHROPIC_API_KEY`. Enviada como o cabeçalho `X-Api-Key`. Use isso para acesso direto à API Anthropic com uma chave do [Claude Console](https://platform.claude.com). No modo interativo, você é solicitado uma vez a aprovar ou recusar a chave, e sua escolha é lembrada. Para alterá-la depois, use o toggle "Use custom API key" em `/config`. O toggle aparece apenas enquanto `ANTHROPIC_API_KEY` está definido em seu ambiente. No modo não interativo (`-p`), a chave é sempre usada quando presente.

1714. Saída do script [`apiKeyHelper`](/pt/settings#available-settings). Use isso para credenciais dinâmicas ou rotativas, como tokens de curta duração obtidos de um cofre.1714. Saída do script [`apiKeyHelper`](/docs/pt/settings#available-settings). Use isso para credenciais dinâmicas ou rotativas, como tokens de curta duração obtidos de um cofre.

1725. Variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Um token OAuth de longa duração gerado por [`claude setup-token`](#generate-a-long-lived-token). Use isso para pipelines de CI e scripts onde login do navegador não está disponível.1725. Variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Um token OAuth de longa duração gerado por [`claude setup-token`](#generate-a-long-lived-token). Use isso para pipelines de CI e scripts onde login do navegador não está disponível.

1736. Credenciais OAuth de assinatura de `/login`. Este é o padrão para usuários Claude Pro, Max, Team e Enterprise.1736. Credenciais OAuth de assinatura de `/login`. Este é o padrão para usuários Claude Pro, Max, Team e Enterprise.

174 174 

175Uma sessão do [gateway de aplicativos Claude](/pt/claude-apps-gateway) assinada fica fora desta lista: é uma seleção de provedor como Amazon Bedrock ou Google Cloud's Agent Platform, e a supera. Quando uma sessão de gateway existe, a CLI se autentica com o token do gateway mesmo se `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido, e as entradas de token bearer, chave de API e `apiKeyHelper` acima não são usadas.175Uma sessão do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) assinada fica fora desta lista: é uma seleção de provedor como Amazon Bedrock ou Google Cloud's Agent Platform, e a supera. Quando uma sessão de gateway existe, a CLI se autentica com o token do gateway mesmo se `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido, e as entradas de token bearer, chave de API e `apiKeyHelper` acima não são usadas.

176 176 

177Se você tem uma assinatura Claude ativa mas também tem `ANTHROPIC_API_KEY` definido em seu ambiente, a chave de API tem precedência uma vez aprovada. Isso pode causar falhas de autenticação se a chave pertencer a uma organização desabilitada ou expirada. Execute `unset ANTHROPIC_API_KEY` para voltar à sua assinatura e verifique `/status` para confirmar qual método está ativo. A linha `Login method` mostra sua conta de assinatura, e uma linha `API key` aparece quando uma chave de API está em uso.177Se você tem uma assinatura Claude ativa mas também tem `ANTHROPIC_API_KEY` definido em seu ambiente, a chave de API tem precedência uma vez aprovada. Isso pode causar falhas de autenticação se a chave pertencer a uma organização desabilitada ou expirada. Execute `unset ANTHROPIC_API_KEY` para voltar à sua assinatura e verifique `/status` para confirmar qual método está ativo. A linha `Login method` mostra sua conta de assinatura, e uma linha `API key` aparece quando uma chave de API está em uso.

178 178 

179[Claude Code na Web](/pt/claude-code-on-the-web) sempre usa suas credenciais de assinatura. Se você definir `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` no ambiente sandbox, isso não substitui suas credenciais de assinatura.179[Claude Code na Web](/docs/pt/claude-code-on-the-web) sempre usa suas credenciais de assinatura. Se você definir `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` no ambiente sandbox, isso não substitui suas credenciais de assinatura.

180 180 

181<h3 id="generate-a-long-lived-token">181<h3 id="generate-a-long-lived-token">

182 Gere um token de longa duração182 Gere um token de longa duração


194export CLAUDE_CODE_OAUTH_TOKEN=your-token194export CLAUDE_CODE_OAUTH_TOKEN=your-token

195```195```

196 196 

197Este token se autentica com sua assinatura Claude e requer um plano Pro, Max, Team ou Enterprise. Ele é limitado apenas a inferência e não pode estabelecer sessões de [Remote Control](/pt/remote-control).197Este token se autentica com sua assinatura Claude e requer um plano Pro, Max, Team ou Enterprise. Ele é limitado apenas a inferência e não pode estabelecer sessões de [Remote Control](/docs/pt/remote-control).

198 198 

199[Bare mode](/pt/headless#start-faster-with-bare-mode) não lê `CLAUDE_CODE_OAUTH_TOKEN`. Se seu script passar `--bare`, autentique com `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em vez disso.199[Bare mode](/docs/pt/headless#start-faster-with-bare-mode) não lê `CLAUDE_CODE_OAUTH_TOKEN`. Se seu script passar `--bare`, autentique com `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em vez disso.

Details

6 6 

7> Diga ao classificador do modo automático quais repositórios, buckets e domínios sua organização confia. Defina o contexto do ambiente, substitua as regras de bloqueio e permissão padrão e inspecione sua configuração efetiva com os subcomandos da CLI do modo automático.7> Diga ao classificador do modo automático quais repositórios, buckets e domínios sua organização confia. Defina o contexto do ambiente, substitua as regras de bloqueio e permissão padrão e inspecione sua configuração efetiva com os subcomandos da CLI do modo automático.

8 8 

9[Modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) permite que Claude Code seja executado sem prompts de permissão rotineiros, roteando chamadas de ferramentas através de um classificador que bloqueia qualquer coisa irreversível, destrutiva ou direcionada para fora do seu ambiente. Regras de negação e solicitação explícita são avaliadas antes do classificador e ainda bloqueiam ou solicitam. Use o bloco de configurações `autoMode` para dizer ao classificador quais repositórios, buckets e domínios sua organização confia, para que ele pare de bloquear operações internas rotineiras.9[Modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) permite que Claude Code seja executado sem prompts de permissão rotineiros, roteando chamadas de ferramentas através de um classificador que bloqueia qualquer coisa irreversível, destrutiva ou direcionada para fora do seu ambiente. Regras de negação e solicitação explícita são avaliadas antes do classificador e ainda bloqueiam ou solicitam. Use o bloco de configurações `autoMode` para dizer ao classificador quais repositórios, buckets e domínios sua organização confia, para que ele pare de bloquear operações internas rotineiras.

10 10 

11<Note>11<Note>

12 Modo automático está disponível para todos os usuários em todos os provedores, incluindo a API Anthropic, Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões do [gateway de aplicativos Claude](/pt/claude-apps-gateway) conectadas. Se Claude Code relatar que o modo automático não está disponível para sua conta, verifique os [requisitos completos](/pt/permission-modes#eliminate-prompts-with-auto-mode), que também cobrem os modelos suportados e a habilitação do Proprietário em planos Team e Enterprise. {/* min-version: 2.1.207 */}Nas versões v2.1.158 a v2.1.206, o modo automático no Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões do gateway de aplicativos Claude exigiam a definição de `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 removeu o requisito.12 Modo automático está disponível para todos os usuários em todos os provedores, incluindo a API Anthropic, Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas. Se Claude Code relatar que o modo automático não está disponível para sua conta, verifique os [requisitos completos](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), que também cobrem os modelos suportados e a habilitação do Proprietário em planos Team e Enterprise. Nas versões v2.1.158 a v2.1.206, o modo automático no Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões do gateway de aplicativos Claude exigiam a definição de `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 removeu o requisito.

13</Note>13</Note>

14 14 

15Por padrão, o classificador confia apenas no diretório de trabalho e nos remotos configurados do repositório atual. Ações como enviar para a organização de controle de fonte da sua empresa ou escrever em um bucket de nuvem da equipe são bloqueadas até que você as adicione a `autoMode.environment`.15Por padrão, o classificador confia apenas no diretório de trabalho e nos remotos configurados do repositório atual. Ações como enviar para a organização de controle de fonte da sua empresa ou escrever em um bucket de nuvem da equipe são bloqueadas até que você as adicione a `autoMode.environment`.

16 16 

17Para saber como ativar o modo automático e o que ele bloqueia por padrão, consulte [Modos de permissão](/pt/permission-modes#eliminate-prompts-with-auto-mode). Esta página é a referência de configuração.17Para saber como ativar o modo automático e o que ele bloqueia por padrão, consulte [Modos de permissão](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode). Esta página é a referência de configuração.

18 18 

19Esta página cobre como:19Esta página cobre como:

20 20 


32 32 

33O modo automático permite pushes para sua branch de trabalho, pushes rotineiros para a branch padrão do repositório e criação de pull request por padrão. O classificador bloqueia um push apenas quando ele apresenta risco, como um force push ou conteúdo que contorna uma revisão que você configurou. Se você quiser um checkpoint humano antes de cada push ou pull request, adicione regras de permissão: as receitas abaixo mantêm o modo automático ativado para tudo mais.33O modo automático permite pushes para sua branch de trabalho, pushes rotineiros para a branch padrão do repositório e criação de pull request por padrão. O classificador bloqueia um push apenas quando ele apresenta risco, como um force push ou conteúdo que contorna uma revisão que você configurou. Se você quiser um checkpoint humano antes de cada push ou pull request, adicione regras de permissão: as receitas abaixo mantêm o modo automático ativado para tudo mais.

34 34 

35O mecanismo mais direto é [`permissions.ask`](/pt/permissions#permission-rule-syntax). Regras ask com escopo de conteúdo como as abaixo são avaliadas antes do classificador e sempre forçam um prompt de permissão, mesmo em modo automático, porque uma regra ask explícita é sua intenção declarada de ser solicitado para essa ação. Adicione as regras em suas [settings](/pt/settings#settings-files):35O mecanismo mais direto é [`permissions.ask`](/docs/pt/permissions#permission-rule-syntax). Regras ask com escopo de conteúdo como as abaixo são avaliadas antes do classificador e sempre forçam um prompt de permissão, mesmo em modo automático, porque uma regra ask explícita é sua intenção declarada de ser solicitado para essa ação. Adicione as regras em suas [settings](/docs/pt/settings#settings-files):

36 36 

37```json theme={null}37```json theme={null}

38{38{


51| :---------------------------- | :------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :---------------------------- | :------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| Solicitar antes da ação | `permissions.ask` | Sempre solicita para regras com escopo de conteúdo como a receita acima. O classificador não pode aprovar automaticamente uma ação correspondente. |52| Solicitar antes da ação | `permissions.ask` | Sempre solicita para regras com escopo de conteúdo como a receita acima. O classificador não pode aprovar automaticamente uma ação correspondente. |

53| Nunca executar a ação | `permissions.deny` | Bloqueia antes do classificador ser consultado. Nem o classificador nem a intenção do usuário podem substituí-lo. |53| Nunca executar a ação | `permissions.deny` | Bloqueia antes do classificador ser consultado. Nem o classificador nem a intenção do usuário podem substituí-lo. |

54| Limite único para esta sessão | Declare na conversa, como "não faça push até eu revisar" | O classificador bloqueia ações correspondentes, mas o limite pode ser perdido se a [compactação de contexto](/pt/costs#reduce-token-usage) remover a mensagem que o declarou. Use uma regra ask ou deny para uma garantia durável. |54| Limite único para esta sessão | Declare na conversa, como "não faça push até eu revisar" | O classificador bloqueia ações correspondentes, mas o limite pode ser perdido se a [compactação de contexto](/docs/pt/costs#reduce-token-usage) remover a mensagem que o declarou. Use uma regra ask ou deny para uma garantia durável. |

55 55 

56<h2 id="where-the-classifier-reads-configuration">56<h2 id="where-the-classifier-reads-configuration">

57 Onde o classificador lê a configuração57 Onde o classificador lê a configuração

58</h2>58</h2>

59 59 

60O classificador lê o mesmo conteúdo [CLAUDE.md](/pt/memory) que o próprio Claude carrega, portanto uma instrução como "nunca force push" no CLAUDE.md do seu projeto orienta tanto Claude quanto o classificador ao mesmo tempo. Comece lá para convenções de projeto e regras de comportamento.60O classificador lê o mesmo conteúdo [CLAUDE.md](/docs/pt/memory) que o próprio Claude carrega, portanto uma instrução como "nunca force push" no CLAUDE.md do seu projeto orienta tanto Claude quanto o classificador ao mesmo tempo. Comece lá para convenções de projeto e regras de comportamento.

61 61 

62Para regras que se aplicam em todos os projetos, como infraestrutura confiável ou regras de negação em toda a organização, use o bloco de configurações `autoMode`. O classificador lê `autoMode` dos seguintes escopos:62Para regras que se aplicam em todos os projetos, como infraestrutura confiável ou regras de negação em toda a organização, use o bloco de configurações `autoMode`. O classificador lê `autoMode` dos seguintes escopos:

63 63 

64| Escopo | Arquivo | Use para |64| Escopo | Arquivo | Use para |

65| :----------------------------- | :------------------------------------------------------- | :----------------------------------------------------------------- |65| :----------------------------- | :------------------------------------------------------- | :----------------------------------------------------------------- |

66| Um desenvolvedor | `~/.claude/settings.json` | Infraestrutura confiável pessoal |66| Um desenvolvedor | `~/.claude/settings.json` | Infraestrutura confiável pessoal |

67| Em toda a organização | [Configurações gerenciadas](/pt/server-managed-settings) | Infraestrutura confiável distribuída para todos os desenvolvedores |67| Em toda a organização | [Configurações gerenciadas](/docs/pt/server-managed-settings) | Infraestrutura confiável distribuída para todos os desenvolvedores |

68| Flag `--settings` ou Agent SDK | JSON inline | Substituições por invocação para automação |68| Flag `--settings` ou Agent SDK | JSON inline | Substituições por invocação para automação |

69 69 

70O classificador não lê `autoMode` das configurações do projeto em `.claude/settings.json` ou `.claude/settings.local.json`. Ambos os arquivos residem no diretório do repositório, portanto um repositório verificado ou uma etapa de compilação poderia injetar suas próprias regras de permissão. Antes da v2.1.207, o classificador também lia `.claude/settings.local.json`; mova qualquer bloco `autoMode` nesse arquivo para `~/.claude/settings.json`. Excluir `.claude/settings.local.json` também fecha o caso em que um repositório confirma o arquivo ou uma ferramenta local ou etapa de compilação o escreve.70O classificador não lê `autoMode` das configurações do projeto em `.claude/settings.json` ou `.claude/settings.local.json`. Ambos os arquivos residem no diretório do repositório, portanto um repositório verificado ou uma etapa de compilação poderia injetar suas próprias regras de permissão. Antes da v2.1.207, o classificador também lia `.claude/settings.local.json`; mova qualquer bloco `autoMode` nesse arquivo para `~/.claude/settings.json`. Excluir `.claude/settings.local.json` também fecha o caso em que um repositório confirma o arquivo ou uma ferramenta local ou etapa de compilação o escreve.


72As entradas de cada escopo são combinadas. Um desenvolvedor pode estender `environment`, `allow`, `soft_deny` e `hard_deny` com entradas pessoais, mas não pode remover entradas que as configurações gerenciadas fornecem. Como as regras de permissão atuam como exceções às regras de bloqueio suave dentro do classificador, uma entrada `allow` adicionada pelo desenvolvedor pode substituir uma entrada `soft_deny` da organização: a combinação é aditiva, não um limite de política rígida.72As entradas de cada escopo são combinadas. Um desenvolvedor pode estender `environment`, `allow`, `soft_deny` e `hard_deny` com entradas pessoais, mas não pode remover entradas que as configurações gerenciadas fornecem. Como as regras de permissão atuam como exceções às regras de bloqueio suave dentro do classificador, uma entrada `allow` adicionada pelo desenvolvedor pode substituir uma entrada `soft_deny` da organização: a combinação é aditiva, não um limite de política rígida.

73 73 

74<Note>74<Note>

75 O classificador é um segundo portão que é executado após o [sistema de permissões](/pt/permissions). Para ações que nunca devem ser executadas independentemente da intenção do usuário ou da configuração do classificador, use `permissions.deny` nas configurações gerenciadas, que bloqueia a ação antes do classificador ser consultado e não pode ser substituída.75 O classificador é um segundo portão que é executado após o [sistema de permissões](/docs/pt/permissions). Para ações que nunca devem ser executadas independentemente da intenção do usuário ou da configuração do classificador, use `permissions.deny` nas configurações gerenciadas, que bloqueia a ação antes do classificador ser consultado e não pode ser substituída.

76</Note>76</Note>

77 77 

78<h2 id="define-trusted-infrastructure">78<h2 id="define-trusted-infrastructure">


87 * **Organização**87 * **Organização**

88 * **Uso principal do Claude Code**: padrão para desenvolvimento de software88 * **Uso principal do Claude Code**: padrão para desenvolvimento de software

89 * **Provedor(es) de nuvem**89 * **Provedor(es) de nuvem**

90 * **Visibilidade do repositório**: um repositório é assumido como privado a menos que seu host remoto e nome indiquem o contrário, {/* min-version: 2.1.200 */}ou uma verificação de visibilidade anterior na conversa que o classificador lê mostre que é público. O classificador lê suas mensagens e os comandos que Claude executa, não sua saída, portanto a evidência tem que ser algo que ele possa ler, como sua própria mensagem nomeando o repositório como público; a saída de um `gh repo view` por si só não o alcança. A verificação de evidência de transcrição requer Claude Code v2.1.200 ou posterior90 * **Visibilidade do repositório**: um repositório é assumido como privado a menos que seu host remoto e nome indiquem o contrário, ou uma verificação de visibilidade anterior na conversa que o classificador lê mostre que é público. O classificador lê suas mensagens e os comandos que Claude executa, não sua saída, portanto a evidência tem que ser algo que ele possa ler, como sua própria mensagem nomeando o repositório como público; a saída de um `gh repo view` por si só não o alcança. A verificação de evidência de transcrição requer Claude Code v2.1.200 ou posterior

91 * **Compartilhamento interno / hospedagem de snippet**: serviços públicos de paste e gist são tratados como fora do limite de confiança até que você nomeie um91 * **Compartilhamento interno / hospedagem de snippet**: serviços públicos de paste e gist são tratados como fora do limite de confiança até que você nomeie um

92 * **CLIs específicas da organização**92 * **CLIs específicas da organização**

93 * **Gerenciamento de segredos**93 * **Gerenciamento de segredos**


96 * **Postura de rede**96 * **Postura de rede**

97 * **Namespaces / ambientes de implantação protegidos**: volta para a heurística de alvos remotos sensíveis até que você nomeie eles97 * **Namespaces / ambientes de implantação protegidos**: volta para a heurística de alvos remotos sensíveis até que você nomeie eles

98 * **Retenção de dados / desclassificação**98 * **Retenção de dados / desclassificação**

99* **Slots de confiança**: nomeiam o que o classificador trata como dentro de seu limite. Os slots são Repositório confiável, Controle de código-fonte, Domínios internos confiáveis, Buckets de nuvem confiáveis, Serviços internos principais e Registro de pacotes interno. As entradas de repositório e controle de código-fonte padrão para o repositório de trabalho e seus remotes configurados. Todos os outros slots de confiança padrão para `None configured`, portanto nada mais é confiável até que você o adicione. {/* min-version: 2.1.203 */}A visibilidade de um repositório abrange apenas material confidencial: um repositório privado é um destino aceitável para material confidencial, mas tornar um repositório privado nunca limpa segredos ou dados pessoais ou confiados nele, e o classificador trata o conteúdo portado, repontado ou lido pela primeira vez de fora do repositório de trabalho como não sendo trabalho daquele repositório. Este escopo requer Claude Code v2.1.203 ou posterior.99* **Slots de confiança**: nomeiam o que o classificador trata como dentro de seu limite. Os slots são Repositório confiável, Controle de código-fonte, Domínios internos confiáveis, Buckets de nuvem confiáveis, Serviços internos principais e Registro de pacotes interno. As entradas de repositório e controle de código-fonte padrão para o repositório de trabalho e seus remotes configurados. Todos os outros slots de confiança padrão para `None configured`, portanto nada mais é confiável até que você o adicione. A visibilidade de um repositório abrange apenas material confidencial: um repositório privado é um destino aceitável para material confidencial, mas tornar um repositório privado nunca limpa segredos ou dados pessoais ou confiados nele, e o classificador trata o conteúdo portado, repontado ou lido pela primeira vez de fora do repositório de trabalho como não sendo trabalho daquele repositório. Este escopo requer Claude Code v2.1.203 ou posterior.

100* **Slots de sensibilidade**: nomeiam o que as regras de proteção tratam como alto risco. Os slots são Locais de dados sensíveis e públicos, Alvos remotos sensíveis e Escopos de IaC protegidos. Cada um padrão para uma heurística ampla, como tratar qualquer host ou namespace cujo nome carrega `prod` ou `production` como um alvo remoto sensível, portanto as regras de proteção estão ativas antes de você configurar qualquer coisa. Nomear alvos concretos em um slot de sensibilidade faz com que essas regras se apliquem aos alvos nomeados em vez da heurística.100* **Slots de sensibilidade**: nomeiam o que as regras de proteção tratam como alto risco. Os slots são Locais de dados sensíveis e públicos, Alvos remotos sensíveis e Escopos de IaC protegidos. Cada um padrão para uma heurística ampla, como tratar qualquer host ou namespace cujo nome carrega `prod` ou `production` como um alvo remoto sensível, portanto as regras de proteção estão ativas antes de você configurar qualquer coisa. Nomear alvos concretos em um slot de sensibilidade faz com que essas regras se apliquem aos alvos nomeados em vez da heurística.

101 101 

102Para adicionar suas próprias entradas junto com os padrões, inclua a string literal `"$defaults"` no array. As entradas padrão são inseridas nessa posição, portanto suas entradas personalizadas podem vir antes ou depois delas.102Para adicionar suas próprias entradas junto com os padrões, inclua a string literal `"$defaults"` no array. As entradas padrão são inseridas nessa posição, portanto suas entradas personalizadas podem vir antes ou depois delas.


125* **Domínios internos confiáveis**: nomes de host para APIs, painéis e serviços dentro de sua rede, como `*.internal.example.com`125* **Domínios internos confiáveis**: nomes de host para APIs, painéis e serviços dentro de sua rede, como `*.internal.example.com`

126* **Serviços internos principais**: CI, registros de artefatos, índices de pacotes internos, ferramentas de incidentes126* **Serviços internos principais**: CI, registros de artefatos, índices de pacotes internos, ferramentas de incidentes

127* **Registro de pacotes interno**: o registro npm, PyPI ou outro privado através do qual as instalações devem ser roteadas, portanto as instalações que o contornam para um registro público são bloqueadas127* **Registro de pacotes interno**: o registro npm, PyPI ou outro privado através do qual as instalações devem ser roteadas, portanto as instalações que o contornam para um registro público são bloqueadas

128* **Locais de dados sensíveis e públicos**: os buckets, bancos de dados ou caminhos que contêm dados pessoais, dados comerciais confidenciais, credenciais, dados regulados ou material similarmente sensível, e os públicos com os quais os dados em cada local podem ser compartilhados, para que o classificador proteja esses locais em vez de adivinhar pelo conteúdo. {/* min-version: 2.1.195 */}{/* max-version: 2.1.197 */}Claude Code v2.1.195 através de v2.1.197 nomeiam esta entrada Locais de PII / dados regulados e cobrem apenas locais que contêm dados pessoais ou regulados, sem a dimensão de público128* **Locais de dados sensíveis e públicos**: os buckets, bancos de dados ou caminhos que contêm dados pessoais, dados comerciais confidenciais, credenciais, dados regulados ou material similarmente sensível, e os públicos com os quais os dados em cada local podem ser compartilhados, para que o classificador proteja esses locais em vez de adivinhar pelo conteúdo. Claude Code v2.1.195 através de v2.1.197 nomeiam esta entrada Locais de PII / dados regulados e cobrem apenas locais que contêm dados pessoais ou regulados, sem a dimensão de público

129* **Alvos remotos sensíveis**: os namespaces, hosts ou contêineres que contam como produção, portanto shells remotos e port-forwards para eles precisam de sua aprovação explícita129* **Alvos remotos sensíveis**: os namespaces, hosts ou contêineres que contam como produção, portanto shells remotos e port-forwards para eles precisam de sua aprovação explícita

130* **Escopos de IaC protegidos**: os recursos de infraestrutura cuja aplicação ou destruição sempre devem exigir que você nomeie a mudança130* **Escopos de IaC protegidos**: os recursos de infraestrutura cuja aplicação ou destruição sempre devem exigir que você nomeie a mudança

131* **Contexto adicional**: restrições de indústria regulada, infraestrutura multi-tenant ou requisitos de conformidade que afetam o que o classificador deve tratar como arriscado131* **Contexto adicional**: restrições de indústria regulada, infraestrutura multi-tenant ou requisitos de conformidade que afetam o que o classificador deve tratar como arriscado


165* `autoMode.soft_deny`: ações destrutivas que a intenção do usuário pode contornar165* `autoMode.soft_deny`: ações destrutivas que a intenção do usuário pode contornar

166* `autoMode.allow`: exceções às regras de bloqueio soft166* `autoMode.allow`: exceções às regras de bloqueio soft

167 167 

168Cada um é uma matriz de descrições em prosa, lidas como regras em linguagem natural. Para bloqueios baseados em padrões de ferramentas que são executados antes do classificador, use [`permissions.deny`](/pt/permissions).168Cada um é uma matriz de descrições em prosa, lidas como regras em linguagem natural. Para bloqueios baseados em padrões de ferramentas que são executados antes do classificador, use [`permissions.deny`](/docs/pt/permissions).

169 169 

170Dentro do classificador, a precedência funciona em quatro camadas:170Dentro do classificador, a precedência funciona em quatro camadas:

171 171 


254claude auto-mode defaults254claude auto-mode defaults

255```255```

256 256 

257{/* min-version: 2.1.208 */}Para ler a redação completa de uma regra sem canalizar através de `jq`, passe `--label` com o início do rótulo da regra, como `claude auto-mode defaults --label 'Git Destructive'`. A correspondência é um prefixo case-insensitive no rótulo de cada regra, e seções sem correspondência são impressas como listas vazias. Requer Claude Code v2.1.208 ou posterior.257Para ler a redação completa de uma regra sem canalizar através de `jq`, passe `--label` com o início do rótulo da regra, como `claude auto-mode defaults --label 'Git Destructive'`. A correspondência é um prefixo case-insensitive no rótulo de cada regra, e seções sem correspondência são impressas como listas vazias. Requer Claude Code v2.1.208 ou posterior.

258 258 

259Imprima o que o classificador realmente usa como JSON, com suas configurações aplicadas onde definidas e padrões caso contrário:259Imprima o que o classificador realmente usa como JSON, com suas configurações aplicadas onde definidas e padrões caso contrário:

260 260 


282 282 

283Negações repetidas para o mesmo destino geralmente significam que o classificador está perdendo contexto. Adicione esse destino a `autoMode.environment`, depois execute `claude auto-mode config` para confirmar que teve efeito.283Negações repetidas para o mesmo destino geralmente significam que o classificador está perdendo contexto. Adicione esse destino a `autoMode.environment`, depois execute `claude auto-mode config` para confirmar que teve efeito.

284 284 

285Para reagir a negações programaticamente, use o hook [`PermissionDenied`](/pt/hooks#permissiondenied).285Para reagir a negações programaticamente, use o hook [`PermissionDenied`](/docs/pt/hooks#permissiondenied).

286 286 

287<h2 id="see-also">287<h2 id="see-also">

288 Veja também288 Veja também

289</h2>289</h2>

290 290 

291* [Permission modes](/pt/permission-modes#eliminate-prompts-with-auto-mode): o que é modo automático, o que ele bloqueia por padrão e como ativá-lo291* [Permission modes](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode): o que é modo automático, o que ele bloqueia por padrão e como ativá-lo

292* [Managed settings](/pt/server-managed-settings): implante a configuração `autoMode` em toda a sua organização292* [Managed settings](/docs/pt/server-managed-settings): implante a configuração `autoMode` em toda a sua organização

293* [Permissions](/pt/permissions): regras de permissão, pergunta e negação que se aplicam antes do classificador ser executado293* [Permissions](/docs/pt/permissions): regras de permissão, pergunta e negação que se aplicam antes do classificador ser executado

294* [Settings](/pt/settings): a referência de configurações completa, incluindo a chave `autoMode`294* [Settings](/docs/pt/settings): a referência de configurações completa, incluindo a chave `autoMode`

Details

21Claude Code rastreia todas as alterações feitas por suas ferramentas de edição de arquivo:21Claude Code rastreia todas as alterações feitas por suas ferramentas de edição de arquivo:

22 22 

23* Cada prompt do usuário cria um novo checkpoint23* Cada prompt do usuário cria um novo checkpoint

24* Claude Code mantém snapshots de arquivo para os 100 checkpoints mais recentes em uma sessão. Descartar um checkpoint mais antigo deleta os arquivos de snapshot que nenhum checkpoint restante referencia, exceto o primeiro snapshot de cada arquivo, que a extensão VS Code usa como baseline para seus diffs de sessão. {/* min-version: 2.1.208 */}Antes da v2.1.208, esses arquivos de snapshot substituídos permaneciam no disco até que a sessão fosse limpa.24* Claude Code mantém snapshots de arquivo para os 100 checkpoints mais recentes em uma sessão. Descartar um checkpoint mais antigo deleta os arquivos de snapshot que nenhum checkpoint restante referencia, exceto o primeiro snapshot de cada arquivo, que a extensão VS Code usa como baseline para seus diffs de sessão. Antes da v2.1.208, esses arquivos de snapshot substituídos permaneciam no disco até que a sessão fosse limpa.

25* Os checkpoints são salvos com a conversa, para que uma sessão retomada ainda possa `/rewind` para eles25* Os checkpoints são salvos com a conversa, para que uma sessão retomada ainda possa `/rewind` para eles

26* Limpeza automática junto com as sessões após 30 dias (configurável)26* Limpeza automática junto com as sessões após 30 dias (configurável)

27 27 


66Em ambos os casos, as mensagens originais são preservadas na transcrição da sessão, para que Claude possa fazer referência aos detalhes se necessário. Você pode digitar instruções opcionais para orientar o que o resumo se concentra. Isso é semelhante ao `/compact`, mas direcionado: em vez de resumir toda a conversa, você escolhe qual lado da mensagem selecionada compactar.66Em ambos os casos, as mensagens originais são preservadas na transcrição da sessão, para que Claude possa fazer referência aos detalhes se necessário. Você pode digitar instruções opcionais para orientar o que o resumo se concentra. Isso é semelhante ao `/compact`, mas direcionado: em vez de resumir toda a conversa, você escolhe qual lado da mensagem selecionada compactar.

67 67 

68<Note>68<Note>

69 Resumir mantém você na mesma sessão e compacta o contexto. Se você quiser ramificar e tentar uma abordagem diferente enquanto preserva a sessão original intacta, use [fork](/pt/sessions#branch-a-session) em vez disso (`claude --continue --fork-session`).69 Resumir mantém você na mesma sessão e compacta o contexto. Se você quiser ramificar e tentar uma abordagem diferente enquanto preserva a sessão original intacta, use [fork](/docs/pt/sessions#branch-a-session) em vez disso (`claude --continue --fork-session`).

70</Note>70</Note>

71 71 

72<h2 id="common-use-cases">72<h2 id="common-use-cases">


118 Veja também118 Veja também

119</h2>119</h2>

120 120 

121* [Modo interativo](/pt/interactive-mode) - Atalhos de teclado e controles de sessão121* [Modo interativo](/docs/pt/interactive-mode) - Atalhos de teclado e controles de sessão

122* [Comandos](/pt/commands) - Acessando checkpoints usando `/rewind`122* [Comandos](/docs/pt/commands) - Acessando checkpoints usando `/rewind`

123* [Referência CLI](/pt/cli-reference) - Opções de linha de comando123* [Referência CLI](/docs/pt/cli-reference) - Opções de linha de comando

Details

64<Note>64<Note>

65 **Implante em sua rede privada.** Claude Code só se conecta a um gateway cujo endereço é privado. Esta é uma proteção de segurança, porque um gateway confiável pode enviar configurações que executam comandos em máquinas de desenvolvedores. Coloque o gateway atrás de um balanceador de carga interno ou VPN e dê a ele um nome de host que resolve apenas para IPs privados.65 **Implante em sua rede privada.** Claude Code só se conecta a um gateway cujo endereço é privado. Esta é uma proteção de segurança, porque um gateway confiável pode enviar configurações que executam comandos em máquinas de desenvolvedores. Coloque o gateway atrás de um balanceador de carga interno ou VPN e dê a ele um nome de host que resolve apenas para IPs privados.

66 66 

67 Os endpoints de gateway público operados pela Anthropic são a exceção: `/login` os aceita via `https://`. Estes são um pequeno conjunto fixo de gateways que a própria Anthropic opera; não são uma opção de implantação que você pode selecionar ou configurar. A lista é compilada no Claude Code, portanto nenhuma configuração pode adicionar um nome de host a ela e nenhum gateway que você hospeda se qualifica para a isenção. {/* min-version: 2.1.206 */}Antes da v2.1.206, `/login` rejeitava esses endpoints como qualquer outro endereço público.67 Os endpoints de gateway público operados pela Anthropic são a exceção: `/login` os aceita via `https://`. Estes são um pequeno conjunto fixo de gateways que a própria Anthropic opera; não são uma opção de implantação que você pode selecionar ou configurar. A lista é compilada no Claude Code, portanto nenhuma configuração pode adicionar um nome de host a ela e nenhum gateway que você hospeda se qualifica para a isenção. Antes da v2.1.206, `/login` rejeitava esses endpoints como qualquer outro endereço público.

68</Note>68</Note>

69 69 

70<h3 id="prerequisites">70<h3 id="prerequisites">


74Tenha estes em vigor antes de começar:74Tenha estes em vigor antes de começar:

75 75 

76| Você precisa | Detalhes |76| Você precisa | Detalhes |

77| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |77| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

78| Claude Code v2.1.195 ou posterior | O subcomando `claude gateway` e o fluxo de sign-in do gateway são enviados na v2.1.195. Compilações públicas anteriores não as incluem. Tanto a máquina executando o servidor gateway quanto a máquina de cada desenvolvedor devem estar na v2.1.195 ou posterior; execute `claude update` para obter a versão mais recente. {/* min-version: 2.1.198 */}O [upstream Claude Platform on AWS](/docs/pt/claude-apps-gateway-config#claude-platform-on-aws) requer Claude Code v2.1.198 ou posterior no servidor gateway. |78| Claude Code v2.1.195 ou posterior | O subcomando `claude gateway` e o fluxo de sign-in do gateway são enviados na v2.1.195. Compilações públicas anteriores não as incluem. Tanto a máquina executando o servidor gateway quanto a máquina de cada desenvolvedor devem estar na v2.1.195 ou posterior; execute `claude update` para obter a versão mais recente. O [upstream Claude Platform on AWS](/docs/pt/claude-apps-gateway-config#claude-platform-on-aws) requer Claude Code v2.1.198 ou posterior no servidor gateway. |

79| Provedor de identidade OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak ou Dex, ou qualquer outro IdP compatível com OIDC, como PingFederate. O gateway executa descoberta OIDC padrão e o fluxo de código de autorização contra ele. SAML e LDAP não são suportados. |79| Provedor de identidade OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak ou Dex, ou qualquer outro IdP compatível com OIDC, como PingFederate. O gateway executa descoberta OIDC padrão e o fluxo de código de autorização contra ele. SAML e LDAP não são suportados. |

80| PostgreSQL 14 ou posterior | Faz backup do fluxo de sign-in do dispositivo, onde o callback do navegador escreve e a CLI de polling lê, além de contadores de limite de taxa. Qualquer Postgres gerenciado funciona, incluindo o menor nível. Sem limites de gastos configurados, o gateway armazena alguns KB de estado de autenticação de curta duração; com [limites de gastos](/docs/pt/claude-apps-gateway-spend-limits), também mantém tabelas de gastos, auditoria e identidade duráveis que devem ser feitas backup. TLS via `?sslmode=require` é recomendado. |80| PostgreSQL 14 ou posterior | Faz backup do fluxo de sign-in do dispositivo, onde o callback do navegador escreve e a CLI de polling lê, além de contadores de limite de taxa. Qualquer Postgres gerenciado funciona, incluindo o menor nível. Sem limites de gastos configurados, o gateway armazena alguns KB de estado de autenticação de curta duração; com [limites de gastos](/docs/pt/claude-apps-gateway-spend-limits), também mantém tabelas de gastos, auditoria e identidade duráveis que devem ser feitas backup. TLS via `?sslmode=require` é recomendado. |

81| Upstream de modelo | Credenciais do Amazon Bedrock, credenciais do Claude Platform on AWS, credenciais do Google Cloud, um recurso Microsoft Foundry ou uma chave de API Anthropic. Múltiplos upstreams são suportados com failover. |81| Upstream de modelo | Credenciais do Amazon Bedrock, credenciais do Claude Platform on AWS, credenciais do Google Cloud, um recurso Microsoft Foundry ou uma chave de API Anthropic. Múltiplos upstreams são suportados com failover. |

82| HTTPS | O gateway deve ser acessível via `https://` de laptops de desenvolvedores e de qualquer navegador usado para sign-in; o gateway serve a página de verificação do dispositivo no mesmo listener. Forneça um certificado TLS via `listen.tls` ou execute atrás de um ingress que termina TLS e defina `listen.public_url`. Uma origem `http://` simples é aceita apenas em loopback, para desenvolvimento local. |82| HTTPS | O gateway deve ser acessível via `https://` de laptops de desenvolvedores e de qualquer navegador usado para sign-in; o gateway serve a página de verificação do dispositivo no mesmo listener. Forneça um certificado TLS via `listen.tls` ou execute atrás de um ingress que termina TLS e defina `listen.public_url`. Uma origem `http://` simples é aceita apenas em loopback, para desenvolvimento local. |

83| Endereço de rede privada | Em `/login`, Claude Code requer que o nome de host ou endereço IP do gateway resolva apenas para endereços privados: RFC 1918, CGNAT `100.64.0.0/10`, ULA IPv6 `fc00::/7` ou loopback para desenvolvimento local. A verificação é executada em cada IP resolvido, então se qualquer endereço para o qual o nome resolve for público, `/login` rejeita a URL. Se máquinas de desenvolvedores rotear HTTPS através de um proxy corporativo, o sign-in também requer que o host proxy resolva para endereços privados; se não resolver, adicione o host do gateway a `NO_PROXY` para que a CLI se conecte diretamente. {/* min-version: 2.1.206 */}Os endpoints de gateway público operados pela Anthropic estão isentos das verificações de endereço privado e proxy: `/login` os aceita via `https://` por correspondência exata de nome de host, portanto o requisito de rede privada se aplica apenas a um gateway que você hospeda. Antes da v2.1.206, `/login` rejeitava um endpoint operado pela Anthropic como qualquer outro endereço público. |83| Endereço de rede privada | Em `/login`, Claude Code requer que o nome de host ou endereço IP do gateway resolva apenas para endereços privados: RFC 1918, CGNAT `100.64.0.0/10`, ULA IPv6 `fc00::/7` ou loopback para desenvolvimento local. A verificação é executada em cada IP resolvido, então se qualquer endereço para o qual o nome resolve for público, `/login` rejeita a URL. Se máquinas de desenvolvedores rotear HTTPS através de um proxy corporativo, o sign-in também requer que o host proxy resolva para endereços privados; se não resolver, adicione o host do gateway a `NO_PROXY` para que a CLI se conecte diretamente. Os endpoints de gateway público operados pela Anthropic estão isentos das verificações de endereço privado e proxy: `/login` os aceita via `https://` por correspondência exata de nome de host, portanto o requisito de rede privada se aplica apenas a um gateway que você hospeda. Antes da v2.1.206, `/login` rejeitava um endpoint operado pela Anthropic como qualquer outro endereço público. |

84| Runtime Linux | O servidor gateway é executado apenas no binário Linux nativo. macOS funciona para desenvolvimento local. Windows não é suportado como plataforma de servidor. |84| Runtime Linux | O servidor gateway é executado apenas no binário Linux nativo. macOS funciona para desenvolvimento local. Windows não é suportado como plataforma de servidor. |

85 85 

86O servidor gateway requer o binário `claude` nativo; baixe uma versão fixada conforme descrito em [Instalar Claude Code](/docs/pt/setup). O servidor usa recursos de runtime que não estão disponíveis quando Claude Code é executado sob Node. Se você vir `requires the native binary` na inicialização, mude para um dos métodos de instalação autônomos.86O servidor gateway requer o binário `claude` nativo; baixe uma versão fixada conforme descrito em [Instalar Claude Code](/docs/pt/setup). O servidor usa recursos de runtime que não estão disponíveis quando Claude Code é executado sob Node. Se você vir `requires the native binary` na inicialização, mude para um dos métodos de instalação autônomos.


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

333| Cache de prompt padrão | Disponível | Os pontos de interrupção `cache_control` são encaminhados para cada upstream |333| Cache de prompt padrão | Disponível | Os pontos de interrupção `cache_control` são encaminhados para cada upstream |

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

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

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

337| OTLP/gRPC | Não suportado | OTLP sobre HTTP apenas |337| OTLP/gRPC | Não suportado | OTLP sobre HTTP apenas |

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

Details

20<Note>20<Note>

21 **Implante em sua rede privada.** Claude Code apenas se conecta a um gateway cujo endereço é privado. Esta é uma proteção de segurança, porque um gateway confiável pode enviar configurações que executam comandos em máquinas de desenvolvedor. Coloque o gateway que você implanta atrás de um balanceador de carga interno ou VPN e dê a ele um nome de host que seja resolvido apenas para IPs privados.21 **Implante em sua rede privada.** Claude Code apenas se conecta a um gateway cujo endereço é privado. Esta é uma proteção de segurança, porque um gateway confiável pode enviar configurações que executam comandos em máquinas de desenvolvedor. Coloque o gateway que você implanta atrás de um balanceador de carga interno ou VPN e dê a ele um nome de host que seja resolvido apenas para IPs privados.

22 22 

23 Os endpoints de gateway público operados pela Anthropic são a exceção: `/login` os aceita sobre `https://`. Estes são um pequeno conjunto fixo de gateways que a própria Anthropic opera; eles não são uma opção de implantação que você pode selecionar ou configurar. A lista é compilada no Claude Code, portanto nenhuma configuração pode adicionar um nome de host a ela e nenhum gateway que você hospeda se qualifica para a isenção. {/* min-version: 2.1.206 */}Antes da v2.1.206, `/login` rejeitava esses endpoints como qualquer outro endereço público.23 Os endpoints de gateway público operados pela Anthropic são a exceção: `/login` os aceita sobre `https://`. Estes são um pequeno conjunto fixo de gateways que a própria Anthropic opera; eles não são uma opção de implantação que você pode selecionar ou configurar. A lista é compilada no Claude Code, portanto nenhuma configuração pode adicionar um nome de host a ela e nenhum gateway que você hospeda se qualifica para a isenção. Antes da v2.1.206, `/login` rejeitava esses endpoints como qualquer outro endereço público.

24</Note>24</Note>

25 25 

26<h2 id="identity-provider-setup">26<h2 id="identity-provider-setup">


275O stderr do gateway inclui o fluxo de eventos de auditoria, o log de auditoria registra identidades de desenvolvedores, e o arquivo de debug registra saída de hook e servidor MCP da máquina do desenvolvedor. Revise e remova essas informações antes de postar em uma issue pública.275O stderr do gateway inclui o fluxo de eventos de auditoria, o log de auditoria registra identidades de desenvolvedores, e o arquivo de debug registra saída de hook e servidor MCP da máquina do desenvolvedor. Revise e remova essas informações antes de postar em uma issue pública.

276 276 

277| Sintoma | Causa | Correção |277| Sintoma | Causa | Correção |

278| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |278| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

279| A `/login` de um desenvolvedor mostra o seletor de conta padrão em vez da tela **Cloud gateway** | `forceLoginMethod` ou `forceLoginGatewayUrl` não está definido em configurações gerenciadas nessa máquina | Implante o [arquivo de configurações gerenciadas](/docs/pt/claude-apps-gateway#set-the-gateway-url) no dispositivo; `/login` lê a URL do gateway de lá |279| A `/login` de um desenvolvedor mostra o seletor de conta padrão em vez da tela **Cloud gateway** | `forceLoginMethod` ou `forceLoginGatewayUrl` não está definido em configurações gerenciadas nessa máquina | Implante o [arquivo de configurações gerenciadas](/docs/pt/claude-apps-gateway#set-the-gateway-url) no dispositivo; `/login` lê a URL do gateway de lá |

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

281| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | O nome de host do gateway se resolve para pelo menos um endereço IP público. Claude Code verifica cada endereço resolvido e requer que cada um seja privado. Uma causa comum é um nome de pilha dupla onde uma família se resolve para um endereço público, incluindo balanceadores de carga de pilha dupla internos da AWS, que retornam endereços AAAA de intervalo público. {/* min-version: 2.1.206 */}Os endpoints de gateway público operados pela Anthropic estão isentos da verificação, e `/login` os aceita sobre `https://`. Antes da v2.1.206, `/login` os rejeitava como qualquer outro endereço público | Faça o nome do gateway se resolver apenas para endereços privados em máquinas de desenvolvedores. Para um nome de pilha dupla, solte o registro de intervalo público ou sirva um nome DNS apenas interno separado. Consulte o [pré-requisito de rede privada](/docs/pt/claude-apps-gateway#prerequisites). |281| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | O nome de host do gateway se resolve para pelo menos um endereço IP público. Claude Code verifica cada endereço resolvido e requer que cada um seja privado. Uma causa comum é um nome de pilha dupla onde uma família se resolve para um endereço público, incluindo balanceadores de carga de pilha dupla internos da AWS, que retornam endereços AAAA de intervalo público. Os endpoints de gateway público operados pela Anthropic estão isentos da verificação, e `/login` os aceita sobre `https://`. Antes da v2.1.206, `/login` os rejeitava como qualquer outro endereço público | Faça o nome do gateway se resolver apenas para endereços privados em máquinas de desenvolvedores. Para um nome de pilha dupla, solte o registro de intervalo público ou sirva um nome DNS apenas interno separado. Consulte o [pré-requisito de rede privada](/docs/pt/claude-apps-gateway#prerequisites). |

282| CLI `/login`: `Gateway login requires a direct connection and does not support connecting through an HTTP proxy` | Um `HTTPS_PROXY` ou `HTTP_PROXY` se aplica ao host do gateway e o nome de host do proxy se resolve para um endereço público. Um proxy cujo host se resolve apenas para endereços privados é permitido e não dispara esse erro | Adicione o host do gateway a `NO_PROXY` na máquina do desenvolvedor para que a conexão seja direta, ou use um proxy cujo nome de host se resolve para endereços privados |282| CLI `/login`: `Gateway login requires a direct connection and does not support connecting through an HTTP proxy` | Um `HTTPS_PROXY` ou `HTTP_PROXY` se aplica ao host do gateway e o nome de host do proxy se resolve para um endereço público. Um proxy cujo host se resolve apenas para endereços privados é permitido e não dispara esse erro | Adicione o host do gateway a `NO_PROXY` na máquina do desenvolvedor para que a conexão seja direta, ou use um proxy cujo nome de host se resolve para endereços privados |

283| CLI `/login`: `Could not resolve gateway host <host>` | A máquina não consegue resolver o nome DNS interno do gateway, normalmente porque não está na rede corporativa | Peça ao desenvolvedor para se conectar à sua rede ou VPN e tente `/login` novamente |283| CLI `/login`: `Could not resolve gateway host <host>` | A máquina não consegue resolver o nome DNS interno do gateway, normalmente porque não está na rede corporativa | Peça ao desenvolvedor para se conectar à sua rede ou VPN e tente `/login` novamente |

284| A inicialização sai com um erro de validação de configuração nomeando `store.postgres_url` | Nenhum Postgres configurado; o gateway requer Postgres | Defina `store.postgres_url`. Para desenvolvimento local, use um contêiner descartável: `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |284| A inicialização sai com um erro de validação de configuração nomeando `store.postgres_url` | Nenhum Postgres configurado; o gateway requer Postgres | Defina `store.postgres_url`. Para desenvolvimento local, use um contêiner descartável: `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |

Details

140 140 

141Cada sessão em nuvem tem uma URL de transcrição em claude.ai, e a sessão pode ler seu próprio ID a partir da variável de ambiente `CLAUDE_CODE_REMOTE_SESSION_ID`. Use isso para colocar um link rastreável em corpos de PR, mensagens de commit, posts do Slack ou relatórios gerados para que um revisor possa abrir a execução que os produziu.141Cada sessão em nuvem tem uma URL de transcrição em claude.ai, e a sessão pode ler seu próprio ID a partir da variável de ambiente `CLAUDE_CODE_REMOTE_SESSION_ID`. Use isso para colocar um link rastreável em corpos de PR, mensagens de commit, posts do Slack ou relatórios gerados para que um revisor possa abrir a execução que os produziu.

142 142 

143A partir da v2.1.179, commits que Claude cria em uma sessão web incluem um trailer git `Claude-Session: <url>`, e corpos de PR incluem a URL da sessão em sua própria linha. {/* min-version: 2.1.182 */}A partir da v2.1.182, defina [`attribution.sessionUrl`](/docs/pt/settings#attribution-settings) como `false` para omitir o trailer e o link do corpo de PR.143A partir da v2.1.179, commits que Claude cria em uma sessão web incluem um trailer git `Claude-Session: <url>`, e corpos de PR incluem a URL da sessão em sua própria linha. A partir da v2.1.182, defina [`attribution.sessionUrl`](/docs/pt/settings#attribution-settings) como `false` para omitir o trailer e o link do corpo de PR.

144 144 

145Para incluir o link da sessão em algo diferente de um commit ou PR, como uma mensagem do Slack que Claude posta ou um arquivo de relatório que ele escreve, peça a Claude para executar o seguinte comando e use sua saída. O comando converte o prefixo `cse_` no valor da variável de ambiente para o prefixo `session_` que a URL de transcrição espera:145Para incluir o link da sessão em algo diferente de um commit ou PR, como uma mensagem do Slack que Claude posta ou um arquivo de relatório que ele escreve, peça a Claude para executar o seguinte comando e use sua saída. O comando converte o prefixo `cse_` no valor da variável de ambiente para o prefixo `session_` que a URL de transcrição espera:

146 146 


669 669 

670Isso cria uma nova sessão em nuvem em claude.ai. A sessão clona o remoto GitHub do seu diretório atual na sua branch atual, então envie primeiro se você tiver commits locais, já que a VM clona do GitHub em vez de sua máquina. `--cloud` funciona com um repositório por vez. A tarefa é executada na nuvem enquanto você continua trabalhando localmente. A ortografia mais antiga `--remote` ainda funciona como um alias descontinuado para `--cloud`.670Isso cria uma nova sessão em nuvem em claude.ai. A sessão clona o remoto GitHub do seu diretório atual na sua branch atual, então envie primeiro se você tiver commits locais, já que a VM clona do GitHub em vez de sua máquina. `--cloud` funciona com um repositório por vez. A tarefa é executada na nuvem enquanto você continua trabalhando localmente. A ortografia mais antiga `--remote` ainda funciona como um alias descontinuado para `--cloud`.

671 671 

672{/* min-version: 2.1.195 */}A partir da v2.1.195, o CLI mostra uma lista de verificação ao vivo das etapas de configuração, como clonar o repositório e executar seu [script de configuração](#setup-scripts), enquanto o contêiner em nuvem é iniciado. As mensagens que você digita enquanto o contêiner está sendo provisionado são enfileiradas e enviadas assim que a sessão estiver pronta.672A partir da v2.1.195, o CLI mostra uma lista de verificação ao vivo das etapas de configuração, como clonar o repositório e executar seu [script de configuração](#setup-scripts), enquanto o contêiner em nuvem é iniciado. As mensagens que você digita enquanto o contêiner está sendo provisionado são enfileiradas e enviadas assim que a sessão estiver pronta.

673 673 

674<Note>674<Note>

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


772 772 

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

774 774 

775* {/* min-version: 2.1.205 */}**`/model`, `/effort`, `/fast`, `/color` e `/rename`**: passam o valor como um argumento, por exemplo `/model sonnet`, em vez de abrir o seletor de terminal ou controle deslizante. As formas de argumento requerem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as [notas de disponibilidade](/docs/pt/commands#all-commands) de cada comando: `/effort` relata `Not applied` enquanto um [esforço padrão de lançamento](/docs/pt/model-config#adjust-effort-level) de modelo está em vigor, e `/fast` funciona apenas em uma sessão que começou com o modo rápido ativado.775* **`/model`, `/effort`, `/fast`, `/color` e `/rename`**: passam o valor como um argumento, por exemplo `/model sonnet`, em vez de abrir o seletor de terminal ou controle deslizante. As formas de argumento requerem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as [notas de disponibilidade](/docs/pt/commands#all-commands) de cada comando: `/effort` relata `Not applied` enquanto um [esforço padrão de lançamento](/docs/pt/model-config#adjust-effort-level) de modelo está em vigor, e `/fast` funciona apenas em uma sessão que começou com o modo rápido ativado.

776* **`/config`**: na web, abre a seção Claude Code de suas configurações em vez de definir um valor, e o texto após o comando, incluindo `key=value`, é ignorado. Para alterar as configurações de uma sessão em nuvem, use [variáveis de ambiente](#configure-your-environment) ou confirme [arquivos de configurações](/docs/pt/settings) no repositório.776* **`/config`**: na web, abre a seção Claude Code de suas configurações em vez de definir um valor, e o texto após o comando, incluindo `key=value`, é ignorado. Para alterar as configurações de uma sessão em nuvem, use [variáveis de ambiente](#configure-your-environment) ou confirme [arquivos de configurações](/docs/pt/settings) no repositório.

777 777 

778Para gerenciamento de contexto especificamente:778Para gerenciamento de contexto especificamente:

Details

188 188 

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

190 190 

191Claude Platform on AWS é a API Claude operada pela Anthropic com autenticação AWS, controle de acesso IAM e faturamento do AWS Marketplace. As solicitações chegam diretamente à API da Anthropic, portanto você obtém os mesmos modelos e recursos de API que a [Claude API](https://platform.claude.com/docs) no mesmo cronograma de lançamento. Os recursos do lado do cliente que Claude Code ativa através do serviço de sinalizadores de recursos da Anthropic, como [`/loop` auto-ritmo](/pt/scheduled-tasks#let-claude-choose-the-interval), estão desativados por padrão, e a [ferramenta advisor](/pt/advisor) não está disponível. Consulte a [matriz de disponibilidade de recursos](/pt/feature-availability#summary-by-provider) para obter a lista completa. Você se autentica com credenciais AWS ou uma chave de API do workspace, e paga através do AWS Marketplace.191Claude Platform on AWS é a API Claude operada pela Anthropic com autenticação AWS, controle de acesso IAM e faturamento do AWS Marketplace. As solicitações chegam diretamente à API da Anthropic, portanto você obtém os mesmos modelos e recursos de API que a [Claude API](https://platform.claude.com/docs) no mesmo cronograma de lançamento. Os recursos do lado do cliente que Claude Code ativa através do serviço de sinalizadores de recursos da Anthropic, como [`/loop` auto-ritmo](/docs/pt/scheduled-tasks#let-claude-choose-the-interval), estão desativados por padrão, e a [ferramenta advisor](/docs/pt/advisor) não está disponível. Consulte a [matriz de disponibilidade de recursos](/docs/pt/feature-availability#summary-by-provider) para obter a lista completa. Você se autentica com credenciais AWS ou uma chave de API do workspace, e paga através do AWS Marketplace.

192 192 

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

194 194 


230 230 

231Para CI e automação, dê ao executor uma função IAM com permissão para invocar o serviço Anthropic e defina `AWS_REGION`. A cadeia de credenciais pega a função automaticamente.231Para CI e automação, dê ao executor uma função IAM com permissão para invocar o serviço Anthropic e defina `AWS_REGION`. A cadeia de credenciais pega a função automaticamente.

232 232 

233Se suas credenciais SSO expirarem durante a sessão, configure [`awsAuthRefresh`](/pt/amazon-bedrock#advanced-credential-configuration) para que Claude Code execute novamente seu comando de login e tente novamente em vez de falhar. A atualização automática no Claude Platform on AWS requer Claude Code v2.1.198 ou posterior; versões anteriores param com um prompt para executar `/login`, que não pode atualizar credenciais AWS. Adicione o comando ao seu `settings.json`:233Se suas credenciais SSO expirarem durante a sessão, configure [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) para que Claude Code execute novamente seu comando de login e tente novamente em vez de falhar. A atualização automática no Claude Platform on AWS requer Claude Code v2.1.198 ou posterior; versões anteriores param com um prompt para executar `/login`, que não pode atualizar credenciais AWS. Adicione o comando ao seu `settings.json`:

234 234 

235```json theme={null}235```json theme={null}

236{236{


250 250 

251A chave é enviada como `x-api-key` e tem precedência sobre SigV4, portanto qualquer credencial AWS em seu ambiente é ignorada. Chaves de API de uma organização Claude Console separada não funcionarão aqui.251A chave é enviada como `x-api-key` e tem precedência sobre SigV4, portanto qualquer credencial AWS em seu ambiente é ignorada. Chaves de API de uma organização Claude Console separada não funcionarão aqui.

252 252 

253Trate chaves de API do workspace como qualquer outra credencial de produção. O bloco `env` do [arquivo de configurações do usuário](/pt/settings) é uma maneira conveniente de escopar a chave para sua máquina sem exportá-la globalmente.253Trate chaves de API do workspace como qualquer outra credencial de produção. O bloco `env` do [arquivo de configurações do usuário](/docs/pt/settings) é uma maneira conveniente de escopar a chave para sua máquina sem exportá-la globalmente.

254 254 

255<Note>255<Note>

256 Os comandos `/login` e `/logout` não o autenticam em uma assinatura Claude.ai para Claude Platform on AWS. A autenticação é executada através de suas credenciais AWS ou chave de API do workspace. A exceção é a opção **atualizar credenciais** que `/login` mostra quando `awsAuthRefresh` está configurado, que relê suas credenciais AWS conforme descrito acima.256 Os comandos `/login` e `/logout` não o autenticam em uma assinatura Claude.ai para Claude Platform on AWS. A autenticação é executada através de suas credenciais AWS ou chave de API do workspace. A exceção é a opção **atualizar credenciais** que `/login` mostra quando `awsAuthRefresh` está configurado, que relê suas credenciais AWS conforme descrito acima.


278 278 

279Claude Platform on AWS usa os mesmos IDs de modelo que a API Claude direta.279Claude Platform on AWS usa os mesmos IDs de modelo que a API Claude direta.

280 280 

281Os aliases padrão `fable`, `opus`, `sonnet` e `haiku` resolvem para os padrões integrados do Claude Code para Claude Platform on AWS, que podem ficar atrás da versão mais recente. Sem `ANTHROPIC_DEFAULT_OPUS_MODEL`, o alias `opus` resolve para Opus 4.8. {/* min-version: 2.1.207 */}Antes da v2.1.207, ele resolvia para Opus 4.7.281Os aliases padrão `fable`, `opus`, `sonnet` e `haiku` resolvem para os padrões integrados do Claude Code para Claude Platform on AWS, que podem ficar atrás da versão mais recente. Sem `ANTHROPIC_DEFAULT_OPUS_MODEL`, o alias `opus` resolve para Opus 4.8. Antes da v2.1.207, ele resolvia para Opus 4.7.

282 282 

283Se você implantar Claude Code para uma equipe, fixe os IDs de modelo explicitamente para que um novo lançamento não mova todos de uma vez:283Se você implantar Claude Code para uma equipe, fixe os IDs de modelo explicitamente para que um novo lançamento não mova todos de uma vez:

284 284 


289export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5289export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

290```290```

291 291 

292Para a lista completa de IDs de modelo e aliases, consulte [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Para outras variáveis relacionadas a modelos, consulte [Configuração de modelo](/pt/model-config).292Para a lista completa de IDs de modelo e aliases, consulte [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Para outras variáveis relacionadas a modelos, consulte [Configuração de modelo](/docs/pt/model-config).

293 293 

294[Prompt caching](/pt/prompt-caching) é ativado automaticamente. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina `ENABLE_PROMPT_CACHING_1H=1`. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Consulte [preços de prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) para as taxas.294[Prompt caching](/docs/pt/prompt-caching) é ativado automaticamente. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina `ENABLE_PROMPT_CACHING_1H=1`. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Consulte [preços de prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) para as taxas.

295 295 

296<h2 id="use-the-agent-sdk">296<h2 id="use-the-agent-sdk">

297 Use o Agent SDK297 Use o Agent SDK

298</h2>298</h2>

299 299 

300O [Agent SDK](/pt/agent-sdk/overview) lê as mesmas variáveis de ambiente que a CLI, portanto qualquer programa que gere o subprocesso Claude Code pode direcionar Claude Platform on AWS exportando `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID` e `ANTHROPIC_AWS_API_KEY` ou credenciais AWS antes da chamada.300O [Agent SDK](/docs/pt/agent-sdk/overview) lê as mesmas variáveis de ambiente que a CLI, portanto qualquer programa que gere o subprocesso Claude Code pode direcionar Claude Platform on AWS exportando `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID` e `ANTHROPIC_AWS_API_KEY` ou credenciais AWS antes da chamada.

301 301 

302```typescript theme={null}302```typescript theme={null}

303import { query } from "@anthropic-ai/claude-agent-sdk";303import { query } from "@anthropic-ai/claude-agent-sdk";


311}311}

312```312```

313 313 

314Este exemplo depende da cadeia de credenciais AWS ambiente para SigV4. Para autenticar com uma chave de API do workspace em vez disso, defina `ANTHROPIC_AWS_API_KEY` da mesma forma. Para a superfície mais ampla do Agent SDK, consulte [Visão geral do Agent SDK](/pt/agent-sdk/overview).314Este exemplo depende da cadeia de credenciais AWS ambiente para SigV4. Para autenticar com uma chave de API do workspace em vez disso, defina `ANTHROPIC_AWS_API_KEY` da mesma forma. Para a superfície mais ampla do Agent SDK, consulte [Visão geral do Agent SDK](/docs/pt/agent-sdk/overview).

315 315 

316<h2 id="route-through-a-corporate-proxy">316<h2 id="route-through-a-corporate-proxy">

317 Rotear através de um proxy corporativo317 Rotear através de um proxy corporativo

318</h2>318</h2>

319 319 

320Para rotear tráfego através de um proxy ou [gateway LLM](/pt/llm-gateway), defina `ANTHROPIC_AWS_BASE_URL` para o endereço do proxy. Claude Code envia solicitações para essa URL com os mesmos cabeçalhos de workspace e autenticação, portanto qualquer gateway que os encaminhe inalterados funciona.320Para rotear tráfego através de um proxy ou [gateway LLM](/docs/pt/llm-gateway), defina `ANTHROPIC_AWS_BASE_URL` para o endereço do proxy. Claude Code envia solicitações para essa URL com os mesmos cabeçalhos de workspace e autenticação, portanto qualquer gateway que os encaminhe inalterados funciona.

321 321 

322```bash theme={null}322```bash theme={null}

323export CLAUDE_CODE_USE_ANTHROPIC_AWS=1323export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

cli-reference.md +68 −68

Details

22| `claude -c -p "query"` | Continuar via SDK | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | Continuar via SDK | `claude -c -p "Check for type errors"` |

23| `claude -r "<session>" "query"` | Retomar sessão por ID ou nome | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | Retomar sessão por ID ou nome | `claude -r "auth-refactor" "Finish this PR"` |

24| `claude update` | Atualizar para a versão mais recente | `claude update` |24| `claude update` | Atualizar para a versão mais recente | `claude update` |

25| `claude gateway` | Iniciar o servidor [gateway de aplicativos Claude](/pt/claude-apps-gateway) auto-hospedado, para administradores implantando SSO e política na frente do Claude Code no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Requer `--config` apontando para um [`gateway.yaml`](/pt/claude-apps-gateway-config). Disponível no Claude Code v2.1.195 e posterior. | `claude gateway --config gateway.yaml` |25| `claude gateway` | Iniciar o servidor [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado, para administradores implantando SSO e política na frente do Claude Code no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Requer `--config` apontando para um [`gateway.yaml`](/docs/pt/claude-apps-gateway-config). Disponível no Claude Code v2.1.195 e posterior. | `claude gateway --config gateway.yaml` |

26| `claude install [version]` | Instalar ou reinstalar o binário nativo. Aceita uma versão como `2.1.118`, ou `stable` ou `latest`. Veja [Instalar uma versão específica](/pt/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | Instalar ou reinstalar o binário nativo. Aceita uma versão como `2.1.118`, ou `stable` ou `latest`. Veja [Instalar uma versão específica](/docs/pt/setup#install-a-specific-version) | `claude install stable` |

27| `claude auth login` | Faça login em sua conta Anthropic. Use `--email` para preencher previamente seu endereço de email, `--sso` para forçar autenticação SSO e `--console` para fazer login com Anthropic Console para faturamento de uso de API em vez de uma assinatura Claude | `claude auth login --console` |27| `claude auth login` | Faça login em sua conta Anthropic. Use `--email` para preencher previamente seu endereço de email, `--sso` para forçar autenticação SSO e `--console` para fazer login com Anthropic Console para faturamento de uso de API em vez de uma assinatura Claude | `claude auth login --console` |

28| `claude auth logout` | Fazer logout de sua conta Anthropic | `claude auth logout` |28| `claude auth logout` | Fazer logout de sua conta Anthropic | `claude auth logout` |

29| `claude auth status` | Mostrar status de autenticação como JSON. Use `--text` para saída legível por humanos. Sai com código 0 se conectado, 1 se não | `claude auth status` |29| `claude auth status` | Mostrar status de autenticação como JSON. Use `--text` para saída legível por humanos. Sai com código 0 se conectado, 1 se não | `claude auth status` |

30| `claude agents` | Abrir [visualização de agente](/pt/agent-view) para monitorar e despachar sessões de fundo paralelas. Use `--cwd <path>` para mostrar apenas sessões iniciadas nesse diretório, ou `--json` para imprimir sessões ativas como um array JSON para scripts (`--json --all` também inclui sessões de fundo concluídas). Passe `--permission-mode`, `--model`, `--effort` ou `--agent` para definir [padrões para sessões despachadas](/pt/agent-view#permission-mode-model-and-effort). Aceita `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` como o comando `claude` de nível superior. Abrir visualização de agente requer um terminal interativo | `claude agents --json` |30| `claude agents` | Abrir [visualização de agente](/docs/pt/agent-view) para monitorar e despachar sessões de fundo paralelas. Use `--cwd <path>` para mostrar apenas sessões iniciadas nesse diretório, ou `--json` para imprimir sessões ativas como um array JSON para scripts (`--json --all` também inclui sessões de fundo concluídas). Passe `--permission-mode`, `--model`, `--effort` ou `--agent` para definir [padrões para sessões despachadas](/docs/pt/agent-view#permission-mode-model-and-effort). Aceita `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` como o comando `claude` de nível superior. Abrir visualização de agente requer um terminal interativo | `claude agents --json` |

31| `claude attach <id>` | Anexar a uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) neste terminal | `claude attach 7c5dcf5d` |31| `claude attach <id>` | Anexar a uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell) neste terminal | `claude attach 7c5dcf5d` |

32| `claude auto-mode defaults` | Imprimir as regras do classificador [auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `claude auto-mode config` para ver sua configuração efetiva com as configurações aplicadas. {/* min-version: 2.1.208 */}}`--label <prefix>` imprime apenas as regras cujo rótulo começa com esse prefixo, correspondência sem distinção de maiúsculas e minúsculas. Requer Claude Code v2.1.208 ou posterior | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Imprimir as regras do classificador [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `claude auto-mode config` para ver sua configuração efetiva com as configurações aplicadas. }`--label <prefix>` imprime apenas as regras cujo rótulo começa com esse prefixo, correspondência sem distinção de maiúsculas e minúsculas. Requer Claude Code v2.1.208 ou posterior | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude daemon status` | Imprimir o estado do [supervisor](/pt/agent-view#the-supervisor-process) de sessão de fundo, versão, diretório de socket e contagem de workers para diagnósticos. Sai com 1 se o supervisor não estiver em execução | `claude daemon status` |33| `claude daemon status` | Imprimir o estado do [supervisor](/docs/pt/agent-view#the-supervisor-process) de sessão de fundo, versão, diretório de socket e contagem de workers para diagnósticos. Sai com 1 se o supervisor não estiver em execução | `claude daemon status` |

34| `claude daemon stop --any` | Parar o [supervisor](/pt/agent-view#the-supervisor-process) de sessão de fundo e as sessões que ele hospeda. Passe `--keep-workers` para deixar as sessões de fundo em execução para que o próximo supervisor se reconecte a elas. `--any` confirma a parada de um supervisor sob demanda, que é o padrão. Use isto para recuperar de um [supervisor não responsivo](/pt/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | Parar o [supervisor](/docs/pt/agent-view#the-supervisor-process) de sessão de fundo e as sessões que ele hospeda. Passe `--keep-workers` para deixar as sessões de fundo em execução para que o próximo supervisor se reconecte a elas. `--any` confirma a parada de um supervisor sob demanda, que é o padrão. Use isto para recuperar de um [supervisor não responsivo](/docs/pt/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

35| `claude doctor` | Imprimir diagnósticos de instalação e configurações somente leitura do terminal sem iniciar uma sessão, incluindo saúde da instalação, erros de validação de arquivo de configurações e elegibilidade de Controle Remoto. Para a verificação de configuração em sessão que também pode aplicar correções, execute [`/doctor`](/pt/commands#all-commands) | `claude doctor` |35| `claude doctor` | Imprimir diagnósticos de instalação e configurações somente leitura do terminal sem iniciar uma sessão, incluindo saúde da instalação, erros de validação de arquivo de configurações e elegibilidade de Controle Remoto. Para a verificação de configuração em sessão que também pode aplicar correções, execute [`/doctor`](/docs/pt/commands#all-commands) | `claude doctor` |

36| `claude logs <id>` | Imprimir saída recente de uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |36| `claude logs <id>` | Imprimir saída recente de uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

37| `claude mcp` | Configurar servidores Model Context Protocol (MCP) | Veja a [documentação Claude Code MCP](/pt/mcp). |37| `claude mcp` | Configurar servidores Model Context Protocol (MCP) | Veja a [documentação Claude Code MCP](/docs/pt/mcp). |

38| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Executar o fluxo OAuth de um servidor MCP configurado sem abrir o painel interativo `/mcp`. Funciona para servidores HTTP, SSE e conectores claude.ai. Adicione `--no-browser` via SSH para imprimir a URL de autorização em vez de abrir um navegador, depois cole a URL de redirecionamento de volta no prompt. Requer Claude Code v2.1.186 ou posterior. Veja [Autenticar a partir da linha de comando](/pt/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |38| `claude mcp login <name>` | Executar o fluxo OAuth de um servidor MCP configurado sem abrir o painel interativo `/mcp`. Funciona para servidores HTTP, SSE e conectores claude.ai. Adicione `--no-browser` via SSH para imprimir a URL de autorização em vez de abrir um navegador, depois cole a URL de redirecionamento de volta no prompt. Requer Claude Code v2.1.186 ou posterior. Veja [Autenticar a partir da linha de comando](/docs/pt/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

39| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}Limpar credenciais OAuth armazenadas para um servidor MCP. Requer Claude Code v2.1.186 ou posterior | `claude mcp logout sentry` |39| `claude mcp logout <name>` | Limpar credenciais OAuth armazenadas para um servidor MCP. Requer Claude Code v2.1.186 ou posterior | `claude mcp logout sentry` |

40| `claude plugin` | Gerenciar Claude Code [plugins](/pt/plugins). Alias: `claude plugins`. Veja [referência de plugin](/pt/plugins-reference#cli-commands-reference) para subcomandos | `claude plugin install code-review@claude-plugins-official` |40| `claude plugin` | Gerenciar Claude Code [plugins](/docs/pt/plugins). Alias: `claude plugins`. Veja [referência de plugin](/docs/pt/plugins-reference#cli-commands-reference) para subcomandos | `claude plugin install code-review@claude-plugins-official` |

41| `claude project purge [path]` | Excluir todo o estado local do Claude Code para um projeto: transcrições, listas de tarefas, logs de depuração, histórico de edição de arquivo, linhas de histórico de prompt e a entrada do projeto em `~/.claude.json`. Omita `[path]` para escolher em uma lista interativa. Sinalizadores: `--dry-run` para visualizar, `-y`/`--yes` para pular confirmação, `-i`/`--interactive` para confirmar cada item, `--all` para cada projeto. Veja [Limpar dados locais](/pt/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |41| `claude project purge [path]` | Excluir todo o estado local do Claude Code para um projeto: transcrições, listas de tarefas, logs de depuração, histórico de edição de arquivo, linhas de histórico de prompt e a entrada do projeto em `~/.claude.json`. Omita `[path]` para escolher em uma lista interativa. Sinalizadores: `--dry-run` para visualizar, `-y`/`--yes` para pular confirmação, `-i`/`--interactive` para confirmar cada item, `--all` para cada projeto. Veja [Limpar dados locais](/docs/pt/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

42| `claude remote-control` | Iniciar um servidor [Remote Control](/pt/remote-control) para controlar Claude Code a partir de Claude.ai ou do aplicativo Claude. Executa em modo servidor (sem sessão interativa local). Veja [Sinalizadores de modo servidor](/pt/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |42| `claude remote-control` | Iniciar um servidor [Remote Control](/docs/pt/remote-control) para controlar Claude Code a partir de Claude.ai ou do aplicativo Claude. Executa em modo servidor (sem sessão interativa local). Veja [Sinalizadores de modo servidor](/docs/pt/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

43| `claude respawn <id>` | Reiniciar uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell), em execução ou parada, com sua conversa intacta. Use `--all` para reiniciar cada sessão em execução, por exemplo, para pegar um binário Claude Code atualizado | `claude respawn 7c5dcf5d` |43| `claude respawn <id>` | Reiniciar uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell), em execução ou parada, com sua conversa intacta. Use `--all` para reiniciar cada sessão em execução, por exemplo, para pegar um binário Claude Code atualizado | `claude respawn 7c5dcf5d` |

44| `claude rm <id>` | Remover uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) da lista. A transcrição da conversa permanece em sua máquina local, disponível através de `claude --resume` | `claude rm 7c5dcf5d` |44| `claude rm <id>` | Remover uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell) da lista. A transcrição da conversa permanece em sua máquina local, disponível através de `claude --resume` | `claude rm 7c5dcf5d` |

45| `claude setup-token` | Gerar um token OAuth de longa duração para CI e scripts. Imprime o token no terminal sem salvá-lo. Requer uma assinatura Claude. Veja [Gerar um token de longa duração](/pt/authentication#generate-a-long-lived-token) | `claude setup-token` |45| `claude setup-token` | Gerar um token OAuth de longa duração para CI e scripts. Imprime o token no terminal sem salvá-lo. Requer uma assinatura Claude. Veja [Gerar um token de longa duração](/docs/pt/authentication#generate-a-long-lived-token) | `claude setup-token` |

46| `claude stop <id>` | Parar uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell). Também aceita `claude kill` | `claude stop 7c5dcf5d` |46| `claude stop <id>` | Parar uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell). Também aceita `claude kill` | `claude stop 7c5dcf5d` |

47| `claude ultrareview [target]` | Executar [ultrareview](/pt/ultrareview#run-ultrareview-non-interactively) de forma não interativa. Imprime descobertas para stdout e sai com 0 em caso de sucesso ou 1 em caso de falha. Use `--json` para o payload bruto e `--timeout <minutes>` para substituir o padrão de 30 minutos | `claude ultrareview 1234 --json` |47| `claude ultrareview [target]` | Executar [ultrareview](/docs/pt/ultrareview#run-ultrareview-non-interactively) de forma não interativa. Imprime descobertas para stdout e sai com 0 em caso de sucesso ou 1 em caso de falha. Use `--json` para o payload bruto e `--timeout <minutes>` para substituir o padrão de 30 minutos | `claude ultrareview 1234 --json` |

48 48 

49Se você digitar incorretamente um subcomando, Claude Code sugere a correspondência mais próxima e sai sem iniciar uma sessão. Por exemplo, `claude udpate` imprime `Did you mean claude update?`.49Se você digitar incorretamente um subcomando, Claude Code sugere a correspondência mais próxima e sai sem iniciar uma sessão. Por exemplo, `claude udpate` imprime `Did you mean claude update?`.

50 50 

51{/* min-version: 2.1.199 */}A partir da v2.1.199, `claude --dangerously-skip-permissions daemon <subcommand>` executa o subcomando `daemon`. Versões anteriores tratavam `daemon <subcommand>` como o prompt para uma nova sessão interativa, então o subcomando nunca era executado quando a flag vinha primeiro, uma configuração comum quando `claude` é aliasado para incluir a flag. Apenas um `--dangerously-skip-permissions` ou `--allow-dangerously-skip-permissions` à frente roteia para `daemon` desta forma; qualquer outra flag à frente ainda inicia uma sessão interativa.51A partir da v2.1.199, `claude --dangerously-skip-permissions daemon <subcommand>` executa o subcomando `daemon`. Versões anteriores tratavam `daemon <subcommand>` como o prompt para uma nova sessão interativa, então o subcomando nunca era executado quando a flag vinha primeiro, uma configuração comum quando `claude` é aliasado para incluir a flag. Apenas um `--dangerously-skip-permissions` ou `--allow-dangerously-skip-permissions` à frente roteia para `daemon` desta forma; qualquer outra flag à frente ainda inicia uma sessão interativa.

52 52 

53<h2 id="cli-flags">53<h2 id="cli-flags">

54 Sinalizadores CLI54 Sinalizadores CLI


57Personalize o comportamento do Claude Code com estes sinalizadores de linha de comando. `claude --help` não lista todos os sinalizadores, portanto a ausência de um sinalizador em `--help` não significa que ele não está disponível.57Personalize o comportamento do Claude Code com estes sinalizadores de linha de comando. `claude --help` não lista todos os sinalizadores, portanto a ausência de um sinalizador em `--help` não significa que ele não está disponível.

58 58 

59| Sinalizador | Descrição | Exemplo |59| Sinalizador | Descrição | Exemplo |

60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

61| `--add-dir` | Adicionar diretórios de trabalho adicionais para Claude ler e editar arquivos. Concede acesso a arquivos; a maioria da configuração `.claude/` [não é descoberta](/pt/permissions#additional-directories-grant-file-access-not-configuration) desses diretórios. Valida se cada caminho existe como um diretório. Para persistir esses diretórios entre sessões, defina [`permissions.additionalDirectories`](/pt/settings#permission-settings) nas configurações | `claude --add-dir ../apps ../lib` |61| `--add-dir` | Adicionar diretórios de trabalho adicionais para Claude ler e editar arquivos. Concede acesso a arquivos; a maioria da configuração `.claude/` [não é descoberta](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) desses diretórios. Valida se cada caminho existe como um diretório. Para persistir esses diretórios entre sessões, defina [`permissions.additionalDirectories`](/docs/pt/settings#permission-settings) nas configurações | `claude --add-dir ../apps ../lib` |

62| `--advisor <model>` | Ativar a [ferramenta advisor](/pt/advisor) do lado do servidor para esta sessão com um alias de modelo: `opus`, `sonnet` ou `fable` ({/* min-version: 2.1.170 */}v2.1.170+), ou um ID de modelo completo. Tem precedência sobre a configuração `advisorModel` para a sessão | `claude --advisor opus` |62| `--advisor <model>` | Ativar a [ferramenta advisor](/docs/pt/advisor) do lado do servidor para esta sessão com um alias de modelo: `opus`, `sonnet` ou `fable` (v2.1.170+), ou um ID de modelo completo. Tem precedência sobre a configuração `advisorModel` para a sessão | `claude --advisor opus` |

63| `--agent` | Especificar um agente para a sessão atual (substitui a configuração `agent`) | `claude --agent my-custom-agent` |63| `--agent` | Especificar um agente para a sessão atual (substitui a configuração `agent`) | `claude --agent my-custom-agent` |

64| `--agents` | Definir subagents personalizados dinamicamente via JSON. Usa os mesmos nomes de campo que o [frontmatter](/pt/sub-agents#supported-frontmatter-fields) de subagent, mais um campo `prompt` para as instruções do agente | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | Definir subagents personalizados dinamicamente via JSON. Usa os mesmos nomes de campo que o [frontmatter](/docs/pt/sub-agents#supported-frontmatter-fields) de subagent, mais um campo `prompt` para as instruções do agente | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

65| `--allow-dangerously-skip-permissions` | Adicionar `bypassPermissions` ao ciclo de modo `Shift+Tab` sem iniciar nele. Permite começar em um modo diferente como `plan` e mudar para `bypassPermissions` depois. Veja [modos de permissão](/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | Adicionar `bypassPermissions` ao ciclo de modo `Shift+Tab` sem iniciar nele. Permite começar em um modo diferente como `plan` e mudar para `bypassPermissions` depois. Veja [modos de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

66| `--allowedTools`, `--allowed-tools` | Ferramentas que executam sem solicitar permissão. Veja [sintaxe de regra de permissão](/pt/settings#permission-rule-syntax) para correspondência de padrões. Para restringir quais ferramentas estão disponíveis, use `--tools` em vez disso | `"Bash(git log *)" "Bash(git diff *)" "Read"` |66| `--allowedTools`, `--allowed-tools` | Ferramentas que executam sem solicitar permissão. Veja [sintaxe de regra de permissão](/docs/pt/settings#permission-rule-syntax) para correspondência de padrões. Para restringir quais ferramentas estão disponíveis, use `--tools` em vez disso | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Anexar texto personalizado ao final do prompt do sistema de cada [subagent](/pt/sub-agents), incluindo subagents aninhados. Aplica-se apenas em modo não interativo com `-p`. Requer Claude Code v2.1.205 ou posterior | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | Anexar texto personalizado ao final do prompt do sistema de cada [subagent](/docs/pt/sub-agents), incluindo subagents aninhados. Aplica-se apenas em modo não interativo com `-p`. Requer Claude Code v2.1.205 ou posterior | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

68| `--append-system-prompt` | Anexar texto personalizado ao final do prompt do sistema padrão | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | Anexar texto personalizado ao final do prompt do sistema padrão | `claude --append-system-prompt "Always use TypeScript"` |

69| `--append-system-prompt-file` | Carregar texto de prompt do sistema adicional de um arquivo e anexar ao prompt padrão | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | Carregar texto de prompt do sistema adicional de um arquivo e anexar ao prompt padrão | `claude --append-system-prompt-file ./extra-rules.txt` |

70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Força o renderizador clássico, portanto a configuração [`tui`](/pt/settings#available-settings) não tem efeito; sessões [background](/pt/agent-view) anexadas ainda renderizam em tela cheia. Tem precedência sobre [`CLAUDE_AX_SCREEN_READER`](/pt/env-vars) e a configuração [`axScreenReader`](/pt/settings#available-settings). Requer Claude Code v2.1.181 ou posterior | `claude --ax-screen-reader` |70| `--ax-screen-reader` | Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Força o renderizador clássico, portanto a configuração [`tui`](/docs/pt/settings#available-settings) não tem efeito; sessões [background](/docs/pt/agent-view) anexadas ainda renderizam em tela cheia. Tem precedência sobre [`CLAUDE_AX_SCREEN_READER`](/docs/pt/env-vars) e a configuração [`axScreenReader`](/docs/pt/settings#available-settings). Requer Claude Code v2.1.181 ou posterior | `claude --ax-screen-reader` |

71| `--bare` | Modo mínimo: pular auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md para que chamadas com script iniciem mais rapidamente. Claude tem acesso a ferramentas Bash, leitura de arquivo e edição de arquivo. Define [`CLAUDE_CODE_SIMPLE`](/pt/env-vars). Veja [modo bare](/pt/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |71| `--bare` | Modo mínimo: pular auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md para que chamadas com script iniciem mais rapidamente. Claude tem acesso a ferramentas Bash, leitura de arquivo e edição de arquivo. Define [`CLAUDE_CODE_SIMPLE`](/docs/pt/env-vars). Veja [modo bare](/docs/pt/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

72| `--betas` | Cabeçalhos beta para incluir em solicitações de API (apenas usuários de chave de API) | `claude --betas interleaved-thinking` |72| `--betas` | Cabeçalhos beta para incluir em solicitações de API (apenas usuários de chave de API) | `claude --betas interleaved-thinking` |

73| `--bg`, `--background` | Iniciar a sessão como um [agente de fundo](/pt/agent-view) e retornar imediatamente. Imprime o ID da sessão e comandos de gerenciamento. Combine com `--exec` para executar um comando shell como um trabalho de fundo em vez de uma sessão Claude, ou com `--agent` para executar um subagent específico. {/* min-version: 2.1.198 */}Não pode ser combinado com `-p`/`--print`; veja a [referência de erro](/pt/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | Iniciar a sessão como um [agente de fundo](/docs/pt/agent-view) e retornar imediatamente. Imprime o ID da sessão e comandos de gerenciamento. Combine com `--exec` para executar um comando shell como um trabalho de fundo em vez de uma sessão Claude, ou com `--agent` para executar um subagent específico. Não pode ser combinado com `-p`/`--print`; veja a [referência de erro](/docs/pt/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

74| `--channels` | (Visualização de pesquisa) Servidores MCP cujas notificações de [channel](/pt/channels) Claude deve ouvir nesta sessão. Lista separada por espaço de entradas `plugin:<name>@<marketplace>`. Requer autenticação Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |74| `--channels` | (Visualização de pesquisa) Servidores MCP cujas notificações de [channel](/docs/pt/channels) Claude deve ouvir nesta sessão. Lista separada por espaço de entradas `plugin:<name>@<marketplace>`. Requer autenticação Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |

75| `--chrome` | Ativar [integração do navegador Chrome](/pt/chrome) para automação web e testes | `claude --chrome` |75| `--chrome` | Ativar [integração do navegador Chrome](/docs/pt/chrome) para automação web e testes | `claude --chrome` |

76| `--cloud` | Criar uma nova [sessão web](/pt/claude-code-on-the-web) em claude.ai com a descrição de tarefa fornecida | `claude --cloud "Fix the login bug"` |76| `--cloud` | Criar uma nova [sessão web](/docs/pt/claude-code-on-the-web) em claude.ai com a descrição de tarefa fornecida | `claude --cloud "Fix the login bug"` |

77| `--continue`, `-c` | Carregar a conversa mais recente no diretório atual. Inclui sessões que adicionaram este diretório com `/add-dir` | `claude --continue` |77| `--continue`, `-c` | Carregar a conversa mais recente no diretório atual. Inclui sessões que adicionaram este diretório com `/add-dir` | `claude --continue` |

78| `--dangerously-load-development-channels` | Ativar [channels](/pt/channels-reference#test-during-the-research-preview) que não estão na lista de permissões aprovada, para desenvolvimento local. Aceita entradas `plugin:<name>@<marketplace>` e `server:<name>`. Solicita confirmação | `claude --dangerously-load-development-channels server:webhook` |78| `--dangerously-load-development-channels` | Ativar [channels](/docs/pt/channels-reference#test-during-the-research-preview) que não estão na lista de permissões aprovada, para desenvolvimento local. Aceita entradas `plugin:<name>@<marketplace>` e `server:<name>`. Solicita confirmação | `claude --dangerously-load-development-channels server:webhook` |

79| `--dangerously-skip-permissions` | Pular prompts de permissão. Equivalente a `--permission-mode bypassPermissions`. Veja [modos de permissão](/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para o que isso faz e não faz. Para sessões iniciadas com `--bg`, o modo [persiste quando o supervisor reinicia a sessão](/pt/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | Pular prompts de permissão. Equivalente a `--permission-mode bypassPermissions`. Veja [modos de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para o que isso faz e não faz. Para sessões iniciadas com `--bg`, o modo [persiste quando o supervisor reinicia a sessão](/docs/pt/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

80| `--debug` | Ativar modo de depuração com filtragem de categoria opcional (por exemplo, `"api,hooks"` ou `"!statsig,!file"`) | `claude --debug "api,mcp"` |80| `--debug` | Ativar modo de depuração com filtragem de categoria opcional (por exemplo, `"api,hooks"` ou `"!statsig,!file"`) | `claude --debug "api,mcp"` |

81| `--debug-file <path>` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |81| `--debug-file <path>` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

82| `--disable-slash-commands` | Desativar todas as skills e comandos para esta sessão | `claude --disable-slash-commands` |82| `--disable-slash-commands` | Desativar todas as skills e comandos para esta sessão | `claude --disable-slash-commands` |

83| `--disallowedTools`, `--disallowed-tools` | Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do modelo: `"Edit"` remove Edit, `"*"` remove todas as ferramentas e `"mcp__*"` remove todas as ferramentas MCP. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e nega apenas chamadas correspondentes | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`, `--disallowed-tools` | Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do modelo: `"Edit"` remove Edit, `"*"` remove todas as ferramentas e `"mcp__*"` remove todas as ferramentas MCP. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e nega apenas chamadas correspondentes | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

84| `--effort` | Definir o [nível de esforço](/pt/model-config#adjust-effort-level) para a sessão atual. Opções: `low`, `medium`, `high`, `xhigh`, `max` ou {/* min-version: 2.1.203 */}}`ultracode`. Os níveis disponíveis dependem do modelo. `ultracode` inicia a sessão em esforço `xhigh` com [ultracode](/pt/workflows#let-claude-decide-with-ultracode) ativado e requer Claude Code v2.1.203 ou posterior. Substitui a configuração [`effortLevel`](/pt/settings#available-settings) para esta sessão e não persiste | `claude --effort high` |84| `--effort` | Definir o [nível de esforço](/docs/pt/model-config#adjust-effort-level) para a sessão atual. Opções: `low`, `medium`, `high`, `xhigh`, `max` ou }`ultracode`. Os níveis disponíveis dependem do modelo. `ultracode` inicia a sessão em esforço `xhigh` com [ultracode](/docs/pt/workflows#let-claude-decide-with-ultracode) ativado e requer Claude Code v2.1.203 ou posterior. Substitui a configuração [`effortLevel`](/docs/pt/settings#available-settings) para esta sessão e não persiste | `claude --effort high` |

85| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Removido em v2.1.111. Auto mode agora está no ciclo `Shift+Tab` por padrão; use `--permission-mode auto` para iniciar nele | `claude --permission-mode auto` |85| `--enable-auto-mode` | Removido em v2.1.111. Auto mode agora está no ciclo `Shift+Tab` por padrão; use `--permission-mode auto` para iniciar nele | `claude --permission-mode auto` |

86| `--exclude-dynamic-system-prompt-sections` | Mover seções por máquina do prompt do sistema (diretório de trabalho, informações de ambiente, caminhos de memória, status do git) para a primeira mensagem do usuário. Melhora a reutilização de prompt-cache em diferentes usuários e máquinas executando a mesma tarefa. Aplica-se apenas com o prompt do sistema padrão; ignorado quando `--system-prompt` ou `--system-prompt-file` está definido. Use com `-p` para cargas de trabalho com script e multi-usuário | `claude -p --exclude-dynamic-system-prompt-sections "query"` |86| `--exclude-dynamic-system-prompt-sections` | Mover seções por máquina do prompt do sistema (diretório de trabalho, informações de ambiente, caminhos de memória, status do git) para a primeira mensagem do usuário. Melhora a reutilização de prompt-cache em diferentes usuários e máquinas executando a mesma tarefa. Aplica-se apenas com o prompt do sistema padrão; ignorado quando `--system-prompt` ou `--system-prompt-file` está definido. Use com `-p` para cargas de trabalho com script e multi-usuário | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

87| `--exec` | Executar um comando shell como um trabalho de fundo com suporte PTY em vez de iniciar uma sessão Claude. Use com `--bg` para iniciar a partir do shell | `claude --bg --exec 'pytest -x'` |87| `--exec` | Executar um comando shell como um trabalho de fundo com suporte PTY em vez de iniciar uma sessão Claude. Use com `--bg` para iniciar a partir do shell | `claude --bg --exec 'pytest -x'` |

88| `--fallback-model` | Ativar fallback automático para o(s) modelo(s) especificado(s) quando o modelo primário está sobrecarregado ou não está disponível, por exemplo um modelo descontinuado. Aceita uma lista separada por vírgula tentada em ordem. Veja [Cadeias de modelo fallback](/pt/model-config#fallback-model-chains). Para persistir uma cadeia entre sessões, use a configuração [`fallbackModel`](/pt/settings#available-settings), que este sinalizador substitui | `claude --fallback-model sonnet,haiku` |88| `--fallback-model` | Ativar fallback automático para o(s) modelo(s) especificado(s) quando o modelo primário está sobrecarregado ou não está disponível, por exemplo um modelo descontinuado. Aceita uma lista separada por vírgula tentada em ordem. Veja [Cadeias de modelo fallback](/docs/pt/model-config#fallback-model-chains). Para persistir uma cadeia entre sessões, use a configuração [`fallbackModel`](/docs/pt/settings#available-settings), que este sinalizador substitui | `claude --fallback-model sonnet,haiku` |

89| `--fork-session` | Ao retomar, criar um novo ID de sessão em vez de reutilizar o original (use com `--resume` ou `--continue`) | `claude --resume abc123 --fork-session` |89| `--fork-session` | Ao retomar, criar um novo ID de sessão em vez de reutilizar o original (use com `--resume` ou `--continue`) | `claude --resume abc123 --fork-session` |

90| `--from-pr` | Retomar sessões vinculadas a um pull request específico. Aceita um número de PR, uma URL de PR do GitHub ou GitHub Enterprise, uma URL de merge request do GitLab ou uma URL de pull request do Bitbucket. As sessões são vinculadas automaticamente quando Claude cria o pull request | `claude --from-pr 123` |90| `--from-pr` | Retomar sessões vinculadas a um pull request específico. Aceita um número de PR, uma URL de PR do GitHub ou GitHub Enterprise, uma URL de merge request do GitLab ou uma URL de pull request do Bitbucket. As sessões são vinculadas automaticamente quando Claude cria o pull request | `claude --from-pr 123` |

91| `--ide` | Conectar automaticamente ao IDE na inicialização se exatamente um IDE válido estiver disponível | `claude --ide` |91| `--ide` | Conectar automaticamente ao IDE na inicialização se exatamente um IDE válido estiver disponível | `claude --ide` |

92| `--init` | Executar hooks de [Setup](/pt/hooks#setup) com o matcher `init` antes da sessão (apenas modo print) | `claude -p --init "query"` |92| `--init` | Executar hooks de [Setup](/docs/pt/hooks#setup) com o matcher `init` antes da sessão (apenas modo print) | `claude -p --init "query"` |

93| `--init-only` | Executar hooks de [Setup](/pt/hooks#setup) e `SessionStart`, depois sair sem iniciar uma conversa | `claude --init-only` |93| `--init-only` | Executar hooks de [Setup](/docs/pt/hooks#setup) e `SessionStart`, depois sair sem iniciar uma conversa | `claude --init-only` |

94| `--include-hook-events` | Incluir eventos do ciclo de vida do hook de cada evento de hook no fluxo de saída. Eventos de hook `SessionStart` e `Setup` são sempre incluídos e não precisam deste sinalizador. Requer `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | Incluir eventos do ciclo de vida do hook de cada evento de hook no fluxo de saída. Eventos de hook `SessionStart` e `Setup` são sempre incluídos e não precisam deste sinalizador. Requer `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

95| `--include-partial-messages` | Incluir eventos de streaming parcial na saída. Requer `--print` e `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |95| `--include-partial-messages` | Incluir eventos de streaming parcial na saída. Requer `--print` e `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

96| `--input-format` | Especificar formato de entrada para modo print (opções: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |96| `--input-format` | Especificar formato de entrada para modo print (opções: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

97| `--json-schema` | Obter saída JSON validada correspondendo a um JSON Schema após o agente completar seu fluxo de trabalho (apenas modo print). Veja [saídas estruturadas](/pt/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Claude Code sai com um erro em um schema inválido e aceita a palavra-chave `format` como uma anotação sem validação do lado do cliente. Antes de v2.1.205, um schema inválido produzia saída não estruturada sem erro, e schemas usando `format` eram tratados como inválidos | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |97| `--json-schema` | Obter saída JSON validada correspondendo a um JSON Schema após o agente completar seu fluxo de trabalho (apenas modo print). Veja [saídas estruturadas](/docs/pt/agent-sdk/structured-outputs). Claude Code sai com um erro em um schema inválido e aceita a palavra-chave `format` como uma anotação sem validação do lado do cliente. Antes de v2.1.205, um schema inválido produzia saída não estruturada sem erro, e schemas usando `format` eram tratados como inválidos | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

98| `--maintenance` | Executar hooks de [Setup](/pt/hooks#setup) com o matcher `maintenance` antes da sessão (apenas modo print) | `claude -p --maintenance "query"` |98| `--maintenance` | Executar hooks de [Setup](/docs/pt/hooks#setup) com o matcher `maintenance` antes da sessão (apenas modo print) | `claude -p --maintenance "query"` |

99| `--max-budget-usd` | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print) | `claude -p --max-budget-usd 5.00 "query"` |99| `--max-budget-usd` | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print) | `claude -p --max-budget-usd 5.00 "query"` |

100| `--max-turns` | Limitar o número de turnos de agente (apenas modo print). Sai com um erro quando o limite é atingido. Sem limite por padrão. {/* min-version: 2.1.205 */}Com `--input-format stream-json`, uma mensagem enviada enquanto Claude está trabalhando fica na fila e é executada como seu próprio turno, com seu próprio limite, quando o limite termina o atual. Antes de v2.1.205, Claude Code descartava essa mensagem | `claude -p --max-turns 3 "query"` |100| `--max-turns` | Limitar o número de turnos de agente (apenas modo print). Sai com um erro quando o limite é atingido. Sem limite por padrão. Com `--input-format stream-json`, uma mensagem enviada enquanto Claude está trabalhando fica na fila e é executada como seu próprio turno, com seu próprio limite, quando o limite termina o atual. Antes de v2.1.205, Claude Code descartava essa mensagem | `claude -p --max-turns 3 "query"` |

101| `--mcp-config` | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço) | `claude --mcp-config ./mcp.json` |101| `--mcp-config` | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço) | `claude --mcp-config ./mcp.json` |

102| `--model` | Define o modelo para a sessão atual com um alias para o modelo mais recente (`sonnet`, `opus`, `haiku` ou `fable`) ou o nome completo de um modelo. Substitui a configuração [`model`](/pt/settings#available-settings) e [`ANTHROPIC_MODEL`](/pt/model-config#environment-variables) | `claude --model claude-sonnet-5` |102| `--model` | Define o modelo para a sessão atual com um alias para o modelo mais recente (`sonnet`, `opus`, `haiku` ou `fable`) ou o nome completo de um modelo. Substitui a configuração [`model`](/docs/pt/settings#available-settings) e [`ANTHROPIC_MODEL`](/docs/pt/model-config#environment-variables) | `claude --model claude-sonnet-5` |

103| `--name`, `-n` | Definir um nome de exibição para a sessão, mostrado em `/resume` e no título do terminal. Você pode retomar uma sessão nomeada com `claude --resume <name>`. <br /><br />[`/rename`](/pt/commands) altera o nome durante a sessão e também o mostra na barra de prompt | `claude -n "my-feature-work"` |103| `--name`, `-n` | Definir um nome de exibição para a sessão, mostrado em `/resume` e no título do terminal. Você pode retomar uma sessão nomeada com `claude --resume <name>`. <br /><br />[`/rename`](/docs/pt/commands) altera o nome durante a sessão e também o mostra na barra de prompt | `claude -n "my-feature-work"` |

104| `--no-chrome` | Desativar [integração do navegador Chrome](/pt/chrome) para esta sessão | `claude --no-chrome` |104| `--no-chrome` | Desativar [integração do navegador Chrome](/docs/pt/chrome) para esta sessão | `claude --no-chrome` |

105| `--no-session-persistence` | Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/pt/env-vars) faz o mesmo em qualquer modo | `claude -p --no-session-persistence "query"` |105| `--no-session-persistence` | Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/pt/env-vars) faz o mesmo em qualquer modo | `claude -p --no-session-persistence "query"` |

106| `--output-format` | Especificar formato de saída para modo print (opções: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |106| `--output-format` | Especificar formato de saída para modo print (opções: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

107| `--permission-mode` | Começar em um [modo de permissão](/pt/permission-modes) especificado. Aceita `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` ou {/* min-version: 2.1.200 */}}`manual` como um alias para `default`. O alias `manual` seleciona o modo que a UI rotula como Manual e requer Claude Code v2.1.200 ou posterior; `claude --help` o lista no lugar de `default` e ambos os valores funcionam. Substitui `defaultMode` dos arquivos de configuração | `claude --permission-mode plan` |107| `--permission-mode` | Começar em um [modo de permissão](/docs/pt/permission-modes) especificado. Aceita `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` ou }`manual` como um alias para `default`. O alias `manual` seleciona o modo que a UI rotula como Manual e requer Claude Code v2.1.200 ou posterior; `claude --help` o lista no lugar de `default` e ambos os valores funcionam. Substitui `defaultMode` dos arquivos de configuração | `claude --permission-mode plan` |

108| `--permission-prompt-tool` | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. {/* min-version: 2.1.206 */}Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/pt/env-vars) de 30 segundos. Antes de v2.1.206, um servidor de inicialização lenta poderia fazer a execução [sair com um erro de que a ferramenta MCP não foi encontrada](/pt/errors#mcp-permission-prompt-tool-not-found). <br /><br />{/* min-version: 2.1.199 */}A ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como [exigindo interação do usuário](/pt/mcp#require-approval-for-a-specific-tool): Claude Code converte um resultado `allow` para uma em uma negação. Esta restrição requer Claude Code v2.1.199 ou posterior | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/docs/pt/env-vars) de 30 segundos. Antes de v2.1.206, um servidor de inicialização lenta poderia fazer a execução [sair com um erro de que a ferramenta MCP não foi encontrada](/docs/pt/errors#mcp-permission-prompt-tool-not-found). <br /><br />A ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como [exigindo interação do usuário](/docs/pt/mcp#require-approval-for-a-specific-tool): Claude Code converte um resultado `allow` para uma em uma negação. Esta restrição requer Claude Code v2.1.199 ou posterior | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

109| `--plugin-dir` | Carregar um plugin de um diretório ou arquivo `.zip` apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para vários plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |109| `--plugin-dir` | Carregar um plugin de um diretório ou arquivo `.zip` apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para vários plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

110| `--plugin-url` | Buscar um arquivo `.zip` de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas | `claude --plugin-url https://example.com/plugin.zip` |110| `--plugin-url` | Buscar um arquivo `.zip` de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas | `claude --plugin-url https://example.com/plugin.zip` |

111| `--print`, `-p` | Imprimir resposta sem modo interativo (veja [documentação do Agent SDK](/pt/agent-sdk/overview) para detalhes de uso programático) | `claude -p "query"` |111| `--print`, `-p` | Imprimir resposta sem modo interativo (veja [documentação do Agent SDK](/docs/pt/agent-sdk/overview) para detalhes de uso programático) | `claude -p "query"` |

112| `--prompt-suggestions` | Emitir uma mensagem `prompt_suggestion` após cada turno com um prompt de usuário previsto. Requer `--print`, `--output-format stream-json` e `--verbose`. Veja [Sugestões de prompt](/pt/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |112| `--prompt-suggestions` | Emitir uma mensagem `prompt_suggestion` após cada turno com um prompt de usuário previsto. Requer `--print`, `--output-format stream-json` e `--verbose`. Veja [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

113| `--remote` | Alias descontinuado para `--cloud` | `claude --remote "Fix the login bug"` |113| `--remote` | Alias descontinuado para `--cloud` | `claude --remote "Fix the login bug"` |

114| `--remote-control`, `--rc` | Iniciar uma sessão interativa com [Remote Control](/pt/remote-control#start-a-remote-control-session) ativado para que você também possa controlá-la a partir de claude.ai ou do aplicativo Claude. Opcionalmente, passe um nome para a sessão | `claude --remote-control "My Project"` |114| `--remote-control`, `--rc` | Iniciar uma sessão interativa com [Remote Control](/docs/pt/remote-control#start-a-remote-control-session) ativado para que você também possa controlá-la a partir de claude.ai ou do aplicativo Claude. Opcionalmente, passe um nome para a sessão | `claude --remote-control "My Project"` |

115| `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão [Remote Control](/pt/remote-control) gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito | `claude remote-control --remote-control-session-name-prefix dev-box` |115| `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito | `claude remote-control --remote-control-session-name-prefix dev-box` |

116| `--replay-user-messages` | Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer `--input-format stream-json` e `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |116| `--replay-user-messages` | Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer `--input-format stream-json` e `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

117| `--resume`, `-r` | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com `/add-dir`; passar um ID de sessão pesquisa apenas o diretório do projeto atual e seus git worktrees. A partir de v2.1.144, [sessões de fundo](/pt/agent-view) aparecem no seletor marcadas com `bg` | `claude --resume auth-refactor` |117| `--resume`, `-r` | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com `/add-dir`; passar um ID de sessão pesquisa apenas o diretório do projeto atual e seus git worktrees. A partir de v2.1.144, [sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg` | `claude --resume auth-refactor` |

118| `--safe-mode` | {/* min-version: 2.1.169 */}Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de [`--bare`](/pt/headless#start-faster-with-bare-mode). 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. Útil para verificar se uma personalização é o que dispara [fallback automático de Fable 5](/pt/model-config#automatic-model-fallback). Define [`CLAUDE_CODE_SAFE_MODE`](/pt/env-vars) | `claude --safe-mode` |118| `--safe-mode` | Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de [`--bare`](/docs/pt/headless#start-faster-with-bare-mode). 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. Útil para verificar se uma personalização é o que dispara [fallback automático de Fable 5](/docs/pt/model-config#automatic-model-fallback). Define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars) | `claude --safe-mode` |

119| `--session-id` | Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |119| `--session-id` | Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

120| `--setting-sources` | Lista separada por vírgula de fontes de configuração a carregar (`user`, `project`, `local`) | `claude --setting-sources user,project` |120| `--setting-sources` | Lista separada por vírgula de fontes de configuração a carregar (`user`, `project`, `local`) | `claude --setting-sources user,project` |

121| `--settings` | Caminho para um arquivo JSON de configurações ou uma string JSON para carregar configurações adicionais. Os valores que você define aqui substituem as mesmas chaves em seus arquivos `settings.json` para esta sessão. As chaves que você omite mantêm seus valores baseados em arquivo. Veja [precedência de configurações](/pt/settings#settings-precedence) | `claude --settings ./settings.json` |121| `--settings` | Caminho para um arquivo JSON de configurações ou uma string JSON para carregar configurações adicionais. Os valores que você define aqui substituem as mesmas chaves em seus arquivos `settings.json` para esta sessão. As chaves que você omite mantêm seus valores baseados em arquivo. Veja [precedência de configurações](/docs/pt/settings#settings-precedence) | `claude --settings ./settings.json` |

122| `--strict-mcp-config` | Usar apenas servidores MCP de `--mcp-config`, ignorando todas as outras configurações de MCP | `claude --strict-mcp-config --mcp-config ./mcp.json` |122| `--strict-mcp-config` | Usar apenas servidores MCP de `--mcp-config`, ignorando todas as outras configurações de MCP | `claude --strict-mcp-config --mcp-config ./mcp.json` |

123| `--system-prompt` | Substituir todo o prompt do sistema por texto personalizado | `claude --system-prompt "You are a Python expert"` |123| `--system-prompt` | Substituir todo o prompt do sistema por texto personalizado | `claude --system-prompt "You are a Python expert"` |

124| `--system-prompt-file` | Carregar prompt do sistema de um arquivo, substituindo o prompt padrão | `claude --system-prompt-file ./custom-prompt.txt` |124| `--system-prompt-file` | Carregar prompt do sistema de um arquivo, substituindo o prompt padrão | `claude --system-prompt-file ./custom-prompt.txt` |

125| `--teleport` | Retomar uma [sessão web](/pt/claude-code-on-the-web) em seu terminal local | `claude --teleport` |125| `--teleport` | Retomar uma [sessão web](/docs/pt/claude-code-on-the-web) em seu terminal local | `claude --teleport` |

126| `--teammate-mode` | Definir como [equipe de agentes](/pt/agent-teams) colegas de equipe são exibidos: `in-process` (padrão), `auto`, `tmux` ou {/* min-version: 2.1.186 */}}`iterm2` (adicionado em v2.1.186). O padrão mudou de `auto` em v2.1.179. Substitui a configuração [`teammateMode`](/pt/settings#available-settings) para esta sessão. Veja [Escolher um modo de exibição](/pt/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |126| `--teammate-mode` | Definir como [equipe de agentes](/docs/pt/agent-teams) colegas de equipe são exibidos: `in-process` (padrão), `auto`, `tmux` ou }`iterm2` (adicionado em v2.1.186). O padrão mudou de `auto` em v2.1.179. Substitui a configuração [`teammateMode`](/docs/pt/settings#available-settings) para esta sessão. Veja [Escolher um modo de exibição](/docs/pt/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

127| `--tmux` | Criar uma sessão tmux para o worktree. Requer `--worktree`. Usa painéis nativos do iTerm2 quando disponível; passe `--tmux=classic` para tmux tradicional | `claude -w feature-auth --tmux` |127| `--tmux` | Criar uma sessão tmux para o worktree. Requer `--worktree`. Usa painéis nativos do iTerm2 quando disponível; passe `--tmux=classic` para tmux tradicional | `claude -w feature-auth --tmux` |

128| `--tools` | Restringir quais ferramentas integradas Claude pode usar. Use `""` para desativar todas, `"default"` para todas, ou nomes de ferramentas como `"Bash,Edit,Read"`. Ferramentas MCP não são afetadas; para negar essas também, use `--disallowedTools "mcp__*"` ou passe `--strict-mcp-config` sem `--mcp-config` para que nenhum servidor MCP carregue | `claude --tools "Bash,Edit,Read"` |128| `--tools` | Restringir quais ferramentas integradas Claude pode usar. Use `""` para desativar todas, `"default"` para todas, ou nomes de ferramentas como `"Bash,Edit,Read"`. Ferramentas MCP não são afetadas; para negar essas também, use `--disallowedTools "mcp__*"` ou passe `--strict-mcp-config` sem `--mcp-config` para que nenhum servidor MCP carregue | `claude --tools "Bash,Edit,Read"` |

129| `--verbose` | Ativar logging detalhado, mostra saída completa turno por turno. Substitui a configuração [`viewMode`](/pt/settings#available-settings) para esta sessão | `claude --verbose` |129| `--verbose` | Ativar logging detalhado, mostra saída completa turno por turno. Substitui a configuração [`viewMode`](/docs/pt/settings#available-settings) para esta sessão | `claude --verbose` |

130| `--version`, `-v` | Exibir o número da versão | `claude -v` |130| `--version`, `-v` | Exibir o número da versão | `claude -v` |

131| `--worktree`, `-w` | Iniciar Claude em um [git worktree](/pt/worktrees) isolado em `<repo>/.claude/worktrees/<name>`. Se nenhum nome for fornecido, um será gerado automaticamente. Passe `#<number>` ou uma URL de pull request do GitHub para buscar esse PR de `origin` e ramificar o worktree a partir dele | `claude -w feature-auth` |131| `--worktree`, `-w` | Iniciar Claude em um [git worktree](/docs/pt/worktrees) isolado em `<repo>/.claude/worktrees/<name>`. Se nenhum nome for fornecido, um será gerado automaticamente. Passe `#<number>` ou uma URL de pull request do GitHub para buscar esse PR de `origin` e ramificar o worktree a partir dele | `claude -w feature-auth` |

132 132 

133<h3 id="system-prompt-flags">133<h3 id="system-prompt-flags">

134 Sinalizadores de prompt do sistema134 Sinalizadores de prompt do sistema


147 147 

148Escolha com base em se a identidade padrão do Claude Code ainda se adequa à sua tarefa. Use um sinalizador de anexação quando Claude deve permanecer um assistente de codificação que também segue suas regras extras: instruções por invocação, formatação de saída ou contexto de domínio para um script `-p`. Anexar preserva a orientação de ferramentas padrão, instruções de segurança e convenções de codificação, portanto você fornece apenas o que difere. Use um sinalizador de substituição quando a superfície, identidade ou modelo de permissão diferir do Claude Code, como um agente não codificador em um pipeline que nenhum humano observa. Substituir descarta todo o prompt padrão, incluindo orientação de ferramentas e instruções de segurança, portanto você assume a responsabilidade por tudo o que sua tarefa ainda precisa.148Escolha com base em se a identidade padrão do Claude Code ainda se adequa à sua tarefa. Use um sinalizador de anexação quando Claude deve permanecer um assistente de codificação que também segue suas regras extras: instruções por invocação, formatação de saída ou contexto de domínio para um script `-p`. Anexar preserva a orientação de ferramentas padrão, instruções de segurança e convenções de codificação, portanto você fornece apenas o que difere. Use um sinalizador de substituição quando a superfície, identidade ou modelo de permissão diferir do Claude Code, como um agente não codificador em um pipeline que nenhum humano observa. Substituir descarta todo o prompt padrão, incluindo orientação de ferramentas e instruções de segurança, portanto você assume a responsabilidade por tudo o que sua tarefa ainda precisa.

149 149 

150Esses sinalizadores se aplicam apenas à invocação atual. Para personas persistentes que você pode alternar e compartilhar em um projeto, use [estilos de saída](/pt/output-styles). Para convenções de projeto que Claude deve sempre seguir, use [CLAUDE.md](/pt/memory). O [guia do Agent SDK sobre prompts do sistema](/pt/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) cobre a mesma decisão com mais profundidade.150Esses sinalizadores se aplicam apenas à invocação atual. Para personas persistentes que você pode alternar e compartilhar em um projeto, use [estilos de saída](/docs/pt/output-styles). Para convenções de projeto que Claude deve sempre seguir, use [CLAUDE.md](/docs/pt/memory). O [guia do Agent SDK sobre prompts do sistema](/docs/pt/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) cobre a mesma decisão com mais profundidade.

151 151 

152<h2 id="see-also">152<h2 id="see-also">

153 Veja também153 Veja também

154</h2>154</h2>

155 155 

156* [Extensão Chrome](/pt/chrome) - Automação de navegador e testes web156* [Extensão Chrome](/docs/pt/chrome) - Automação de navegador e testes web

157* [Modo interativo](/pt/interactive-mode) - Atalhos de teclado, modos de entrada e recursos interativos157* [Modo interativo](/docs/pt/interactive-mode) - Atalhos de teclado, modos de entrada e recursos interativos

158* [Guia de início rápido](/pt/quickstart) - Começar com Claude Code158* [Guia de início rápido](/docs/pt/quickstart) - Começar com Claude Code

159* [Fluxos de trabalho comuns](/pt/common-workflows) - Fluxos de trabalho e padrões avançados159* [Fluxos de trabalho comuns](/docs/pt/common-workflows) - Fluxos de trabalho e padrões avançados

160* [Configurações](/pt/settings) - Opções de configuração160* [Configurações](/docs/pt/settings) - Opções de configuração

161* [Documentação do Agent SDK](/pt/agent-sdk/overview) - Uso programático e integrações161* [Documentação do Agent SDK](/docs/pt/agent-sdk/overview) - Uso programático e integrações

code-review.md +14 −14

Details

7> Configure análises automatizadas de PR que detectam erros de lógica, vulnerabilidades de segurança e regressões usando análise multi-agente de sua base de código completa7> Configure análises automatizadas de PR que detectam erros de lógica, vulnerabilidades de segurança e regressões usando análise multi-agente de sua base de código completa

8 8 

9<Note>9<Note>

10 Code Review está em visualização de pesquisa, disponível para assinaturas [Team e Enterprise](https://claude.ai/admin-settings/claude-code). Não está disponível para organizações com [Zero Data Retention](/pt/zero-data-retention) ativado.10 Code Review está em visualização de pesquisa, disponível para assinaturas [Team e Enterprise](https://claude.ai/admin-settings/claude-code). Não está disponível para organizações com [Zero Data Retention](/docs/pt/zero-data-retention) ativado.

11</Note>11</Note>

12 12 

13Code Review analisa seus pull requests do GitHub e publica descobertas como comentários inline nas linhas de código onde encontrou problemas. Uma frota de agentes especializados examina as alterações de código no contexto de sua base de código completa, procurando por erros de lógica, vulnerabilidades de segurança, casos extremos quebrados e regressões sutis.13Code Review analisa seus pull requests do GitHub e publica descobertas como comentários inline nas linhas de código onde encontrou problemas. Uma frota de agentes especializados examina as alterações de código no contexto de sua base de código completa, procurando por erros de lógica, vulnerabilidades de segurança, casos extremos quebrados e regressões sutis.

14 14 

15As descobertas são marcadas por severidade e não aprovam ou bloqueiam seu PR, portanto os fluxos de trabalho de revisão existentes permanecem intactos. Você pode ajustar o que Claude sinaliza adicionando um arquivo `CLAUDE.md` ou `REVIEW.md` ao seu repositório.15As descobertas são marcadas por severidade e não aprovam ou bloqueiam seu PR, portanto os fluxos de trabalho de revisão existentes permanecem intactos. Você pode ajustar o que Claude sinaliza adicionando um arquivo `CLAUDE.md` ou `REVIEW.md` ao seu repositório.

16 16 

17Para executar Claude em sua própria infraestrutura de CI em vez deste serviço gerenciado, consulte [GitHub Actions](/pt/github-actions) ou [GitLab CI/CD](/pt/gitlab-ci-cd). Para repositórios em uma instância GitHub auto-hospedada, consulte [GitHub Enterprise Server](/pt/github-enterprise-server).17Para executar Claude em sua própria infraestrutura de CI em vez deste serviço gerenciado, consulte [GitHub Actions](/docs/pt/github-actions) ou [GitLab CI/CD](/docs/pt/gitlab-ci-cd). Para repositórios em uma instância GitHub auto-hospedada, consulte [GitHub Enterprise Server](/docs/pt/github-enterprise-server).

18 18 

19Esta página cobre:19Esta página cobre:

20 20 


112 * **Issues**: leitura e escrita112 * **Issues**: leitura e escrita

113 * **Pull requests**: leitura e escrita113 * **Pull requests**: leitura e escrita

114 114 

115 Code Review usa acesso de leitura a conteúdos e acesso de escrita a pull requests. O conjunto de permissões mais amplo também suporta [GitHub Actions](/pt/github-actions) se você ativar isso mais tarde.115 Code Review usa acesso de leitura a conteúdos e acesso de escrita a pull requests. O conjunto de permissões mais amplo também suporta [GitHub Actions](/docs/pt/github-actions) se você ativar isso mais tarde.

116 </Step>116 </Step>

117 117 

118 <Step title="Selecionar repositórios">118 <Step title="Selecionar repositórios">


173 173 

174Code Review lê seus arquivos `CLAUDE.md` do repositório e trata violações recém-introduzidas como descobertas de [nível nit](#severity-levels). Isso funciona bidirecionalmente: se seu PR altera o código de uma forma que torna uma declaração `CLAUDE.md` desatualizada, Claude sinaliza que os docs precisam ser atualizados também.174Code Review lê seus arquivos `CLAUDE.md` do repositório e trata violações recém-introduzidas como descobertas de [nível nit](#severity-levels). Isso funciona bidirecionalmente: se seu PR altera o código de uma forma que torna uma declaração `CLAUDE.md` desatualizada, Claude sinaliza que os docs precisam ser atualizados também.

175 175 

176Claude lê arquivos `CLAUDE.md` em cada nível de sua hierarquia de diretórios, portanto as regras no `CLAUDE.md` de um subdiretório se aplicam apenas aos arquivos sob esse caminho. Consulte a [documentação de memory](/pt/memory) para mais informações sobre como `CLAUDE.md` funciona.176Claude lê arquivos `CLAUDE.md` em cada nível de sua hierarquia de diretórios, portanto as regras no `CLAUDE.md` de um subdiretório se aplicam apenas aos arquivos sob esse caminho. Consulte a [documentação de memory](/docs/pt/memory) para mais informações sobre como `CLAUDE.md` funciona.

177 177 

178Para orientação específica de revisão que você não deseja aplicada a sessões gerais do Claude Code, use [`REVIEW.md`](#review-md) em vez disso.178Para orientação específica de revisão que você não deseja aplicada a sessões gerais do Claude Code, use [`REVIEW.md`](#review-md) em vez disso.

179 179 


183 183 

184`REVIEW.md` é um arquivo na raiz do seu repositório que substitui como Code Review se comporta no seu repo. Seu conteúdo é injetado no prompt do sistema de cada agente no pipeline de revisão como o bloco de instrução de prioridade máxima, tendo precedência sobre a orientação de revisão padrão.184`REVIEW.md` é um arquivo na raiz do seu repositório que substitui como Code Review se comporta no seu repo. Seu conteúdo é injetado no prompt do sistema de cada agente no pipeline de revisão como o bloco de instrução de prioridade máxima, tendo precedência sobre a orientação de revisão padrão.

185 185 

186Como é colado verbatim, `REVIEW.md` é instruções simples: a [sintaxe `@` import](/pt/memory#import-additional-files) não é expandida e os arquivos referenciados não são lidos no prompt. Coloque as regras que você deseja aplicadas diretamente no arquivo.186Como é colado verbatim, `REVIEW.md` é instruções simples: a [sintaxe `@` import](/docs/pt/memory#import-additional-files) não é expandida e os arquivos referenciados não são lidos no prompt. Coloque as regras que você deseja aplicadas diretamente no arquivo.

187 187 

188<h4 id="what-you-can-tune">188<h4 id="what-you-can-tune">

189 O que você pode ajustar189 O que você pode ajustar


313 Revisar um diff localmente313 Revisar um diff localmente

314</h2>314</h2>

315 315 

316O comando [`/code-review`](/pt/commands) revisa um diff em seu terminal sem instalar o GitHub App. Execute-o em qualquer sessão Claude Code: ele relata bugs de correção e {/* min-version: 2.1.151 */}reutilização, simplificação e limpezas de eficiência. Por padrão, a revisão local cobre os commits de sua branch à frente de sua upstream mais quaisquer alterações não confirmadas na árvore de trabalho. Passe `--comment` para publicar descobertas como comentários PR inline, ou `--fix` para aplicar as descobertas à sua árvore de trabalho após a revisão.316O comando [`/code-review`](/docs/pt/commands) revisa um diff em seu terminal sem instalar o GitHub App. Execute-o em qualquer sessão Claude Code: ele relata bugs de correção e reutilização, simplificação e limpezas de eficiência. Por padrão, a revisão local cobre os commits de sua branch à frente de sua upstream mais quaisquer alterações não confirmadas na árvore de trabalho. Passe `--comment` para publicar descobertas como comentários PR inline, ou `--fix` para aplicar as descobertas à sua árvore de trabalho após a revisão.

317 317 

318Níveis de [esforço](/pt/model-config#adjust-effort-level) mais baixos retornam menos descobertas com maior confiança, enquanto `high` até `max` fornecem cobertura mais ampla e podem incluir descobertas incertas. Sem um argumento de esforço, a revisão usa o esforço atual da sessão. Para revisar algo diferente do diff padrão, passe um alvo: um caminho de arquivo, um número de PR, um nome de branch ou um intervalo de ref como `main...my-feature`. A forma de intervalo de ref revisa o diff confirmado que um pull request de `my-feature` para `main` conteria, independentemente de como a upstream da branch está configurada.318Níveis de [esforço](/docs/pt/model-config#adjust-effort-level) mais baixos retornam menos descobertas com maior confiança, enquanto `high` até `max` fornecem cobertura mais ampla e podem incluir descobertas incertas. Sem um argumento de esforço, a revisão usa o esforço atual da sessão. Para revisar algo diferente do diff padrão, passe um alvo: um caminho de arquivo, um número de PR, um nome de branch ou um intervalo de ref como `main...my-feature`. A forma de intervalo de ref revisa o diff confirmado que um pull request de `my-feature` para `main` conteria, independentemente de como a upstream da branch está configurada.

319 319 

320`/code-review ultra --fix` executa a [ultrareview](/pt/ultrareview) mais profunda na nuvem, então aplica suas descobertas à sua árvore de trabalho quando chegam de volta em sua sessão. Ultrareview usa seu próprio escopo: sua branch atual contra a branch padrão do repositório, mais quaisquer alterações não confirmadas e preparadas na árvore de trabalho.320`/code-review ultra --fix` executa a [ultrareview](/docs/pt/ultrareview) mais profunda na nuvem, então aplica suas descobertas à sua árvore de trabalho quando chegam de volta em sua sessão. Ultrareview usa seu próprio escopo: sua branch atual contra a branch padrão do repositório, mais quaisquer alterações não confirmadas e preparadas na árvore de trabalho.

321 321 

322O comando foi nomeado `/simplify` antes da v2.1.147, quando aplicava correções por padrão. {/* min-version: 2.1.154 */}A partir da v2.1.154, `/simplify` executa uma revisão separada apenas de limpeza que aplica correções sem procurar por bugs. Se você criou scripts com `/simplify` para busca de bugs, mude para `/code-review --fix`, que permanece inalterado.322O comando foi nomeado `/simplify` antes da v2.1.147, quando aplicava correções por padrão. A partir da v2.1.154, `/simplify` executa uma revisão separada apenas de limpeza que aplica correções sem procurar por bugs. Se você criou scripts com `/simplify` para busca de bugs, mude para `/code-review --fix`, que permanece inalterado.

323 323 

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

325 Recursos relacionados325 Recursos relacionados


327 327 

328Code Review é projetado para funcionar junto com o resto do Claude Code. Se você deseja executar revisões localmente antes de abrir um PR, precisa de uma configuração auto-hospedada ou deseja aprofundar como `CLAUDE.md` molda o comportamento do Claude em todas as ferramentas, estas páginas são bons próximos passos:328Code Review é projetado para funcionar junto com o resto do Claude Code. Se você deseja executar revisões localmente antes de abrir um PR, precisa de uma configuração auto-hospedada ou deseja aprofundar como `CLAUDE.md` molda o comportamento do Claude em todas as ferramentas, estas páginas são bons próximos passos:

329 329 

330* [Commands](/pt/commands): execute `/code-review` em uma sessão local do Claude Code para verificar um diff antes de fazer push330* [Commands](/docs/pt/commands): execute `/code-review` em uma sessão local do Claude Code para verificar um diff antes de fazer push

331* [GitHub Actions](/pt/github-actions): execute Claude em seus próprios fluxos de trabalho do GitHub Actions para automação personalizada além de code review331* [GitHub Actions](/docs/pt/github-actions): execute Claude em seus próprios fluxos de trabalho do GitHub Actions para automação personalizada além de code review

332* [GitLab CI/CD](/pt/gitlab-ci-cd): integração Claude auto-hospedada para pipelines GitLab332* [GitLab CI/CD](/docs/pt/gitlab-ci-cd): integração Claude auto-hospedada para pipelines GitLab

333* [Memory](/pt/memory): como arquivos `CLAUDE.md` funcionam em Claude Code333* [Memory](/docs/pt/memory): como arquivos `CLAUDE.md` funcionam em Claude Code

334* [Analytics](/pt/analytics): rastreie o uso de Claude Code além de code review334* [Analytics](/docs/pt/analytics): rastreie o uso de Claude Code além de code review

commands.md +85 −85

Details

10 10 

11Digite `/` para ver todos os comandos disponíveis para você, ou digite `/` seguido de letras para filtrar.11Digite `/` para ver todos os comandos disponíveis para você, ou digite `/` seguido de letras para filtrar.

12 12 

13Um comando é reconhecido apenas no início da sua mensagem. O texto que segue o nome do comando é passado para ele como argumentos. {/* min-version: 2.1.199 */}A partir da v2.1.199, [skills](/pt/skills#pass-arguments-to-skills) são a exceção: uma invocação de skill seguida por mais skills, como `/skill-a /skill-b do XYZ`, carrega cada skill nomeada no início e passa o texto final para cada uma como argumentos. Até seis skills podem ser encadeadas.13Um comando é reconhecido apenas no início da sua mensagem. O texto que segue o nome do comando é passado para ele como argumentos. A partir da v2.1.199, [skills](/docs/pt/skills#pass-arguments-to-skills) são a exceção: uma invocação de skill seguida por mais skills, como `/skill-a /skill-b do XYZ`, carrega cada skill nomeada no início e passa o texto final para cada uma como argumentos. Até seis skills podem ser encadeadas.

14 14 

15Se você enviar um comando enquanto Claude está respondendo, ele é enfileirado e executado após o turno atual terminar. Alguns comandos, como `/status`, `/tasks` e `/usage`, são executados imediatamente sem interromper a resposta.15Se você enviar um comando enquanto Claude está respondendo, ele é enfileirado e executado após o turno atual terminar. Alguns comandos, como `/status`, `/tasks` e `/usage`, são executados imediatamente sem interromper a resposta.

16 16 


20 20 

21A maioria dos comandos é útil em um ponto específico de uma sessão, desde a configuração de um projeto até o envio de uma alteração.21A maioria dos comandos é útil em um ponto específico de uma sessão, desde a configuração de um projeto até o envio de uma alteração.

22 22 

23**Primeira sessão em um repositório.** Execute `/init` para gerar um `CLAUDE.md` inicial, depois `/memory` para refiná-lo. Use `/mcp` para configurar quaisquer servidores que o projeto necessite, peça a Claude para criar quaisquer [subagentes](/pt/sub-agents) que você queira, e execute `/permissions` para definir suas regras de aprovação.23**Primeira sessão em um repositório.** Execute `/init` para gerar um `CLAUDE.md` inicial, depois `/memory` para refiná-lo. Use `/mcp` para configurar quaisquer servidores que o projeto necessite, peça a Claude para criar quaisquer [subagentes](/docs/pt/sub-agents) que você queira, e execute `/permissions` para definir suas regras de aprovação.

24 24 

25**Durante uma tarefa.** `/plan` alterna para o Plan Mode antes de uma grande alteração. `/model` e `/effort` ajustam qual modelo você está usando e quanto raciocínio ele aplica. Quando a conversa fica longa, `/context` mostra o que está preenchendo a janela e `/compact` a resume para liberar espaço. Use `/btw` para uma observação rápida que não deve ser adicionada ao histórico de conversa.25**Durante uma tarefa.** `/plan` alterna para o Plan Mode antes de uma grande alteração. `/model` e `/effort` ajustam qual modelo você está usando e quanto raciocínio ele aplica. Quando a conversa fica longa, `/context` mostra o que está preenchendo a janela e `/compact` a resume para liberar espaço. Use `/btw` para uma observação rápida que não deve ser adicionada ao histórico de conversa.

26 26 

27**Executando trabalho em paralelo.** Claude delega tarefas secundárias para [subagentes](/pt/sub-agents), e `/tasks` lista o trabalho em segundo plano da sessão atual, incluindo subagentes que foram concluídos. `/background` desanexa a sessão inteira para continuar em execução como um [agente de fundo](/pt/agent-view) e libera seu terminal. Para uma grande alteração que abrange a base de código, `/batch` a decompõe em unidades independentes e executa cada uma em seu próprio [worktree](/pt/worktrees). Consulte [Executar agentes em paralelo](/pt/agents) para saber como essas abordagens se relacionam.27**Executando trabalho em paralelo.** Claude delega tarefas secundárias para [subagentes](/docs/pt/sub-agents), e `/tasks` lista o trabalho em segundo plano da sessão atual, incluindo subagentes que foram concluídos. `/background` desanexa a sessão inteira para continuar em execução como um [agente de fundo](/docs/pt/agent-view) e libera seu terminal. Para uma grande alteração que abrange a base de código, `/batch` a decompõe em unidades independentes e executa cada uma em seu próprio [worktree](/docs/pt/worktrees). Consulte [Executar agentes em paralelo](/docs/pt/agents) para saber como essas abordagens se relacionam.

28 28 

29**Antes de você enviar.** `/diff` mostra o que mudou, `/code-review` verifica o diff quanto a bugs de correção e limpezas e pode aplicar as descobertas com `--fix`, `/review` fornece uma revisão rápida de uma única passagem, somente leitura de uma solicitação de pull do GitHub, `/code-review <level> <pr#>` executa uma revisão multi-agente de uma, e `/security-review` verifica o diff quanto a vulnerabilidades de segurança. `/code-review ultra` executa uma revisão multi-agente na nuvem.29**Antes de você enviar.** `/diff` mostra o que mudou, `/code-review` verifica o diff quanto a bugs de correção e limpezas e pode aplicar as descobertas com `--fix`, `/review` fornece uma revisão rápida de uma única passagem, somente leitura de uma solicitação de pull do GitHub, `/code-review <level> <pr#>` executa uma revisão multi-agente de uma, e `/security-review` verifica o diff quanto a vulnerabilidades de segurança. `/code-review ultra` executa uma revisão multi-agente na nuvem.

30 30 


38 38 

39A tabela abaixo lista todos os comandos incluídos no Claude Code. A maioria são comandos integrados cujo comportamento é codificado na CLI. Dois tipos de entradas são marcados:39A tabela abaixo lista todos os comandos incluídos no Claude Code. A maioria são comandos integrados cujo comportamento é codificado na CLI. Dois tipos de entradas são marcados:

40 40 

41* **[Skill](/pt/skills#bundled-skills)**: uma skill agrupada. Funciona como skills que você escreve: um prompt entregue ao Claude, que Claude também pode invocar automaticamente quando relevante.41* **[Skill](/docs/pt/skills#bundled-skills)**: uma skill agrupada. Funciona como skills que você escreve: um prompt entregue ao Claude, que Claude também pode invocar automaticamente quando relevante.

42* **[Workflow](/pt/workflows#bundled-workflows)**: um [workflow dinâmico](/pt/workflows) agrupado que se expande entre muitos subagentes e é executado em segundo plano.42* **[Workflow](/docs/pt/workflows#bundled-workflows)**: um [workflow dinâmico](/docs/pt/workflows) agrupado que se expande entre muitos subagentes e é executado em segundo plano.

43 43 

44Para adicionar seus próprios comandos, consulte [skills](/pt/skills).44Para adicionar seus próprios comandos, consulte [skills](/docs/pt/skills).

45 45 

46Na tabela abaixo, `<arg>` indica um argumento obrigatório e `[arg]` indica um opcional.46Na tabela abaixo, `<arg>` indica um argumento obrigatório e `[arg]` indica um opcional.

47 47 


50</Note>50</Note>

51 51 

52| Comando | Propósito |52| Comando | Propósito |

53| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |53| :--------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

54| `/add-dir <path>` | Adicionar um diretório de trabalho para acesso a arquivos durante a sessão atual. Digitando um caminho parcial mostra sugestões de diretório correspondentes; pressione `Tab` para aceitar um. A maioria da configuração `.claude/` [não é descoberta](/pt/permissions#additional-directories-grant-file-access-not-configuration) do diretório adicionado. Você pode retomar a sessão posteriormente do diretório adicionado com `--continue` ou `--resume` |54| `/add-dir <path>` | Adicionar um diretório de trabalho para acesso a arquivos durante a sessão atual. Digitando um caminho parcial mostra sugestões de diretório correspondentes; pressione `Tab` para aceitar um. A maioria da configuração `.claude/` [não é descoberta](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) do diretório adicionado. Você pode retomar a sessão posteriormente do diretório adicionado com `--continue` ou `--resume` |

55| `/advisor [model\|off]` | Ativar ou desativar a [ferramenta advisor](/pt/advisor), que consulta um segundo modelo para orientação em momentos-chave durante uma tarefa. Aceita `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+), ou um ID de modelo completo. Sem um argumento, abre um seletor |55| `/advisor [model\|off]` | Ativar ou desativar a [ferramenta advisor](/docs/pt/advisor), que consulta um segundo modelo para orientação em momentos-chave durante uma tarefa. Aceita `opus`, `sonnet`, `fable` (v2.1.170+), ou um ID de modelo completo. Sem um argumento, abre um seletor |

56| `/agents` | {/* min-version: 2.1.198 */}A partir da v2.1.198, executar `/agents` imprime um lembrete para pedir ao Claude para criar ou gerenciar [subagentes](/pt/sub-agents), ou para editar `.claude/agents/` ou `~/.claude/agents/` diretamente. {/* max-version: 2.1.197 */}Na v2.1.197 e anteriores, abre uma interface interativa para criar e gerenciar configurações de subagente |56| `/agents` | A partir da v2.1.198, executar `/agents` imprime um lembrete para pedir ao Claude para criar ou gerenciar [subagentes](/docs/pt/sub-agents), ou para editar `.claude/agents/` ou `~/.claude/agents/` diretamente. Na v2.1.197 e anteriores, abre uma interface interativa para criar e gerenciar configurações de subagente |

57| `/autofix-pr [prompt]` | Gerar uma sessão [Claude Code na web](/pt/claude-code-on-the-web#auto-fix-pull-requests) que monitora o PR do branch atual e envia correções quando o CI falha ou revisores deixam comentários. Detecta o PR aberto do seu branch verificado com `gh pr view`; para monitorar um PR diferente, primeiro verifique seu branch. Por padrão, a sessão remota é instruída a corrigir todas as falhas de CI e comentários de revisão; passe um prompt para dar instruções diferentes, por exemplo `/autofix-pr only fix lint and type errors`. Requer a CLI `gh` e acesso a [Claude Code na web](/pt/claude-code-on-the-web) |57| `/autofix-pr [prompt]` | Gerar uma sessão [Claude Code na web](/docs/pt/claude-code-on-the-web#auto-fix-pull-requests) que monitora o PR do branch atual e envia correções quando o CI falha ou revisores deixam comentários. Detecta o PR aberto do seu branch verificado com `gh pr view`; para monitorar um PR diferente, primeiro verifique seu branch. Por padrão, a sessão remota é instruída a corrigir todas as falhas de CI e comentários de revisão; passe um prompt para dar instruções diferentes, por exemplo `/autofix-pr only fix lint and type errors`. Requer a CLI `gh` e acesso a [Claude Code na web](/docs/pt/claude-code-on-the-web) |

58| `/background [prompt]` | Desanexar a sessão atual para executar como um [agente de fundo](/pt/agent-view) e liberar este terminal. Passe um prompt para enviar uma instrução adicional antes de desanexar. Monitore a sessão com `claude agents`. Alias: `/bg` |58| `/background [prompt]` | Desanexar a sessão atual para executar como um [agente de fundo](/docs/pt/agent-view) e liberar este terminal. Passe um prompt para enviar uma instrução adicional antes de desanexar. Monitore a sessão com `claude agents`. Alias: `/bg` |

59| `/batch <instruction>` | **[Skill](/pt/skills#bundled-skills).** Orquestrar mudanças em larga escala em um codebase em paralelo. Pesquisa o codebase, decompõe o trabalho em 5 a 30 unidades independentes e apresenta um plano. Uma vez aprovado, gera um [subagent de fundo](/pt/sub-agents#run-subagents-in-foreground-or-background) por unidade em um [git worktree](/pt/worktrees) isolado. Cada subagent implementa sua unidade, executa testes e abre uma solicitação de pull. Requer um repositório git. Exemplo: `/batch migrate src/ from Solid to React` |59| `/batch <instruction>` | **[Skill](/docs/pt/skills#bundled-skills).** Orquestrar mudanças em larga escala em um codebase em paralelo. Pesquisa o codebase, decompõe o trabalho em 5 a 30 unidades independentes e apresenta um plano. Uma vez aprovado, gera um [subagent de fundo](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) por unidade em um [git worktree](/docs/pt/worktrees) isolado. Cada subagent implementa sua unidade, executa testes e abre uma solicitação de pull. Requer um repositório git. Exemplo: `/batch migrate src/ from Solid to React` |

60| `/branch [name]` | Criar um branch da conversa atual neste ponto, para que você possa tentar uma direção diferente sem perder a conversa como está. Alterna você para o branch e preserva o original, ao qual você pode retornar com `/resume`. Para entregar uma tarefa secundária a um subagent de fundo em vez de alternar para uma cópia você mesmo, use `/fork` |60| `/branch [name]` | Criar um branch da conversa atual neste ponto, para que você possa tentar uma direção diferente sem perder a conversa como está. Alterna você para o branch e preserva o original, ao qual você pode retornar com `/resume`. Para entregar uma tarefa secundária a um subagent de fundo em vez de alternar para uma cópia você mesmo, use `/fork` |

61| `/btw <question>` | Fazer uma [pergunta rápida](/pt/interactive-mode#side-questions-with-%2Fbtw) sem adicionar à conversa |61| `/btw <question>` | Fazer uma [pergunta rápida](/docs/pt/interactive-mode#side-questions-with-%2Fbtw) sem adicionar à conversa |

62| `/cd <path>` | {/* min-version: 2.1.169 */}Mover esta sessão para um novo diretório de trabalho. O cache de prompt da conversa é preservado: o [`CLAUDE.md`](/pt/memory) do novo diretório é anexado como uma mensagem em vez de reconstruir o prompt do sistema. A sessão é relocada para o armazenamento de projeto do novo diretório, então `--resume` e `--continue` o encontram de lá. Solicita que você confie no diretório se você não tiver trabalhado nele antes. {/* min-version: 2.1.206 */}Digitando um caminho parcial mostra sugestões de diretório correspondentes; pressione `Tab` para aceitar um. As sugestões requerem Claude Code v2.1.206 ou posterior. Para conceder acesso a um diretório extra sem mover a sessão, use `/add-dir`. Restrinja ou desative destinos `/cd` com [regras de permissão `Cd`](/pt/permissions#cd). Requer Claude Code v2.1.169 ou posterior; versões anteriores relatam `Unknown command: /cd` |62| `/cd <path>` | Mover esta sessão para um novo diretório de trabalho. O cache de prompt da conversa é preservado: o [`CLAUDE.md`](/docs/pt/memory) do novo diretório é anexado como uma mensagem em vez de reconstruir o prompt do sistema. A sessão é relocada para o armazenamento de projeto do novo diretório, então `--resume` e `--continue` o encontram de lá. Solicita que você confie no diretório se você não tiver trabalhado nele antes. Digitando um caminho parcial mostra sugestões de diretório correspondentes; pressione `Tab` para aceitar um. As sugestões requerem Claude Code v2.1.206 ou posterior. Para conceder acesso a um diretório extra sem mover a sessão, use `/add-dir`. Restrinja ou desative destinos `/cd` com [regras de permissão `Cd`](/docs/pt/permissions#cd). Requer Claude Code v2.1.169 ou posterior; versões anteriores relatam `Unknown command: /cd` |

63| `/chrome` | Configurar configurações do [Claude no Chrome](/pt/chrome) |63| `/chrome` | Configurar configurações do [Claude no Chrome](/docs/pt/chrome) |

64| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/pt/skills#bundled-skills).** Carregar material de referência da API Claude para a linguagem do seu projeto (Python, TypeScript, Java, Go, Ruby, C#, PHP ou cURL) e referência de Managed Agents. Cobre uso de ferramentas, streaming, lotes, saídas estruturadas e armadilhas comuns. Também ativa automaticamente quando seu código importa `anthropic` ou `@anthropic-ai/sdk`. Execute `/claude-api migrate` para atualizar o código existente da API Claude para um modelo mais recente: Claude pergunta quais arquivos verificar e qual modelo direcionar, depois atualiza IDs de modelo, configuração de thinking e outros parâmetros que mudaram entre versões. Execute `/claude-api managed-agents-onboard` para um passo a passo interativo que cria um novo Managed Agent do zero |64| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/docs/pt/skills#bundled-skills).** Carregar material de referência da API Claude para a linguagem do seu projeto (Python, TypeScript, Java, Go, Ruby, C#, PHP ou cURL) e referência de Managed Agents. Cobre uso de ferramentas, streaming, lotes, saídas estruturadas e armadilhas comuns. Também ativa automaticamente quando seu código importa `anthropic` ou `@anthropic-ai/sdk`. Execute `/claude-api migrate` para atualizar o código existente da API Claude para um modelo mais recente: Claude pergunta quais arquivos verificar e qual modelo direcionar, depois atualiza IDs de modelo, configuração de thinking e outros parâmetros que mudaram entre versões. Execute `/claude-api managed-agents-onboard` para um passo a passo interativo que cria um novo Managed Agent do zero |

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

66| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/pt/skills#bundled-skills).** Revisar o diff atual para bugs de correção e para relatar descobertas de reutilização, simplificação e eficiência. Passe `--fix` para aplicar descobertas à sua árvore de trabalho, `--comment` para postá-las como comentários inline do GitHub PR, ou `ultra` para executar uma [revisão em nuvem](/pt/ultrareview) profunda. {/* min-version: 2.1.154 */}A partir da v2.1.154, `/simplify` executa uma revisão separada apenas de limpeza que aplica correções sem procurar por bugs. Consulte [Revisar um diff localmente](/pt/code-review#review-a-diff-locally) para níveis de esforço e direcionamento |66| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/docs/pt/skills#bundled-skills).** Revisar o diff atual para bugs de correção e para relatar descobertas de reutilização, simplificação e eficiência. Passe `--fix` para aplicar descobertas à sua árvore de trabalho, `--comment` para postá-las como comentários inline do GitHub PR, ou `ultra` para executar uma [revisão em nuvem](/docs/pt/ultrareview) profunda. A partir da v2.1.154, `/simplify` executa uma revisão separada apenas de limpeza que aplica correções sem procurar por bugs. Consulte [Revisar um diff localmente](/docs/pt/code-review#review-a-diff-locally) para níveis de esforço e direcionamento |

67| `/color [color\|default]` | Definir a cor da barra de prompt para a sessão atual. Cores disponíveis: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Use `default` para redefinir, ou execute sem argumento para escolher uma cor aleatória. Quando [Remote Control](/pt/remote-control) está conectado, a cor sincroniza com claude.ai/code. {/* min-version: 2.1.205 */}Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior |67| `/color [color\|default]` | Definir a cor da barra de prompt para a sessão atual. Cores disponíveis: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Use `default` para redefinir, ou execute sem argumento para escolher uma cor aleatória. Quando [Remote Control](/docs/pt/remote-control) está conectado, a cor sincroniza com claude.ai/code. Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior |

68| `/compact [instructions]` | Liberar contexto resumindo a conversa até agora. Opcionalmente, passe instruções de foco para o resumo. Consulte [como a compactação lida com regras, skills e arquivos de memória](/pt/context-window#what-survives-compaction) |68| `/compact [instructions]` | Liberar contexto resumindo a conversa até agora. Opcionalmente, passe instruções de foco para o resumo. Consulte [como a compactação lida com regras, skills e arquivos de memória](/docs/pt/context-window#what-survives-compaction) |

69| `/config [key=value ...]` | Abrir a interface de [Configurações](/pt/settings) para ajustar tema, modelo, [estilo de saída](/pt/output-styles) e outras preferências. {/* min-version: 2.1.181 */}A partir da v2.1.181, passe um ou mais pares `key=value` para definir uma configuração diretamente sem abrir a interface, por exemplo `/config thinking=false`. {/* min-version: 2.1.182 */}A partir da v2.1.182, chaves de atalho nomeadas também são aceitas, como `/config theme=dark` ou `/config model=sonnet`. O formulário `key=value` também funciona em modo não interativo (`-p`) e do aplicativo móvel Claude via [Remote Control](/pt/remote-control). Execute `/config --help` para listar todas as chaves configuráveis com suas opções. Alias: `/settings` |69| `/config [key=value ...]` | Abrir a interface de [Configurações](/docs/pt/settings) para ajustar tema, modelo, [estilo de saída](/docs/pt/output-styles) e outras preferências. A partir da v2.1.181, passe um ou mais pares `key=value` para definir uma configuração diretamente sem abrir a interface, por exemplo `/config thinking=false`. A partir da v2.1.182, chaves de atalho nomeadas também são aceitas, como `/config theme=dark` ou `/config model=sonnet`. O formulário `key=value` também funciona em modo não interativo (`-p`) e do aplicativo móvel Claude via [Remote Control](/docs/pt/remote-control). Execute `/config --help` para listar todas as chaves configuráveis com suas opções. Alias: `/settings` |

70| `/context [all]` | Visualizar o uso atual de contexto como uma grade colorida. Mostra sugestões de otimização para ferramentas pesadas em contexto, inchaço de memória e avisos de capacidade. No [modo tela cheia](/pt/fullscreen), o detalhamento por item é recolhido para manter a grade visível. Passe `all` para expandi-lo |70| `/context [all]` | Visualizar o uso atual de contexto como uma grade colorida. Mostra sugestões de otimização para ferramentas pesadas em contexto, inchaço de memória e avisos de capacidade. No [modo tela cheia](/docs/pt/fullscreen), o detalhamento por item é recolhido para manter a grade visível. Passe `all` para expandi-lo |

71| `/copy [N]` | Copiar a última resposta do assistente para a área de transferência. Passe um número `N` para copiar a N-ésima resposta mais recente: `/copy 2` copia a segunda mais recente. Quando há blocos de código, mostra um seletor interativo para selecionar blocos individuais ou a resposta completa. Pressione `w` no seletor para escrever a seleção em um arquivo em vez da área de transferência, o que é útil via SSH |71| `/copy [N]` | Copiar a última resposta do assistente para a área de transferência. Passe um número `N` para copiar a N-ésima resposta mais recente: `/copy 2` copia a segunda mais recente. Quando há blocos de código, mostra um seletor interativo para selecionar blocos individuais ou a resposta completa. Pressione `w` no seletor para escrever a seleção em um arquivo em vez da área de transferência, o que é útil via SSH |

72| `/cost` | Alias para `/usage` |72| `/cost` | Alias para `/usage` |

73| `/dataviz [request]` | **[Skill](/pt/skills#bundled-skills).** Orientação de design para gráficos, diagramas e painéis. Claude escolhe a forma de gráfico para os dados, atribui cor por função, valida a paleta para segurança de daltonismo e contraste com um script agrupado, e aplica regras de marca, interação e acessibilidade. Usa uma paleta de espaço reservado neutra da marca que você substitui pela sua própria. {/* min-version: 2.1.198 */}Requer Claude Code v2.1.198 ou posterior |73| `/dataviz [request]` | **[Skill](/docs/pt/skills#bundled-skills).** Orientação de design para gráficos, diagramas e painéis. Claude escolhe a forma de gráfico para os dados, atribui cor por função, valida a paleta para segurança de daltonismo e contraste com um script agrupado, e aplica regras de marca, interação e acessibilidade. Usa uma paleta de espaço reservado neutra da marca que você substitui pela sua própria. Requer Claude Code v2.1.198 ou posterior |

74| `/debug [description]` | **[Skill](/pt/skills#bundled-skills).** Ativar registro de depuração para a sessão atual e solucionar problemas lendo o log de depuração da sessão. O registro de depuração está desativado por padrão, a menos que você tenha iniciado com `claude --debug`, então executar `/debug` no meio da sessão começa a capturar logs a partir desse ponto. Opcionalmente, descreva o problema para focar a análise |74| `/debug [description]` | **[Skill](/docs/pt/skills#bundled-skills).** Ativar registro de depuração para a sessão atual e solucionar problemas lendo o log de depuração da sessão. O registro de depuração está desativado por padrão, a menos que você tenha iniciado com `claude --debug`, então executar `/debug` no meio da sessão começa a capturar logs a partir desse ponto. Opcionalmente, descreva o problema para focar a análise |

75| `/deep-research <question>` | **[Workflow](/pt/workflows#bundled-workflows).** Expandir buscas na web em uma pergunta, buscar e verificar fontes e sintetizar um relatório citado |75| `/deep-research <question>` | **[Workflow](/docs/pt/workflows#bundled-workflows).** Expandir buscas na web em uma pergunta, buscar e verificar fontes e sintetizar um relatório citado |

76| `/design-login` | Autorizar acesso ao sistema de design para `/design-sync` com sua conta claude.ai |76| `/design-login` | Autorizar acesso ao sistema de design para `/design-sync` com sua conta claude.ai |

77| `/design-sync [hint]` | **[Skill](/pt/skills#bundled-skills).** Converter o sistema de design React do seu repositório e carregá-lo em [Claude Design](https://claude.ai/design), para que os designs que ele produz usem seus componentes reais. Opcionalmente, nomeie o sistema de design, por exemplo `/design-sync Acme DS`. Uma primeira sincronização verifica cada componente e pode levar algumas horas em um repositório grande. Disponível na API Anthropic; no Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry e no Claude Platform na AWS, a ferramenta subjacente não consegue acessar claude.ai, então o comando não está disponível |77| `/design-sync [hint]` | **[Skill](/docs/pt/skills#bundled-skills).** Converter o sistema de design React do seu repositório e carregá-lo em [Claude Design](https://claude.ai/design), para que os designs que ele produz usem seus componentes reais. Opcionalmente, nomeie o sistema de design, por exemplo `/design-sync Acme DS`. Uma primeira sincronização verifica cada componente e pode levar algumas horas em um repositório grande. Disponível na API Anthropic; no Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry e no Claude Platform na AWS, a ferramenta subjacente não consegue acessar claude.ai, então o comando não está disponível |

78| `/desktop` | Continuar a sessão atual no aplicativo Claude Code Desktop. Requer macOS ou Windows e uma assinatura Claude. Alias: `/app` |78| `/desktop` | Continuar a sessão atual no aplicativo Claude Code Desktop. Requer macOS ou Windows e uma assinatura Claude. Alias: `/app` |

79| `/diff` | Abrir um visualizador de diff interativo mostrando alterações não confirmadas e diffs por turno. Use as setas esquerda/direita para alternar entre o diff git atual e turnos individuais do Claude, e cima/baixo para navegar pelos arquivos. Pressione Enter para abrir o diff do arquivo selecionado, role-o com cima/baixo ou PageUp/PageDown, e pressione Esc para retornar à lista de arquivos. {/* min-version: 2.1.198 */}A partir da v2.1.198, o visualizador aberto também se atualiza automaticamente quando o estado git do repositório muda fora da sessão, como uma mudança de branch ou commit em outro terminal |79| `/diff` | Abrir um visualizador de diff interativo mostrando alterações não confirmadas e diffs por turno. Use as setas esquerda/direita para alternar entre o diff git atual e turnos individuais do Claude, e cima/baixo para navegar pelos arquivos. Pressione Enter para abrir o diff do arquivo selecionado, role-o com cima/baixo ou PageUp/PageDown, e pressione Esc para retornar à lista de arquivos. A partir da v2.1.198, o visualizador aberto também se atualiza automaticamente quando o estado git do repositório muda fora da sessão, como uma mudança de branch ou commit em outro terminal |

80| `/doctor` | **[Skill](/pt/skills#bundled-skills).** Executar uma verificação de configuração que diagnostica problemas e pode corrigi-los. Verifica a saúde da instalação, incluindo instalações duplicadas ou restantes, problemas de `PATH` e arquivos de configurações não analisáveis. Encontra skills não utilizadas, servidores MCP e plugins versus seu custo de contexto, sinaliza [hooks](/pt/hooks) lentos e verifica uma versão mais recente no seu canal de lançamento. Deduplica arquivos `CLAUDE.md` locais contra os verificados, aparas arquivos [`CLAUDE.md`](/pt/memory) verificados cortando conteúdo que Claude poderia derivar do codebase, e migra a orientação sempre carregada que permanece para [skills](/pt/skills) e arquivos `CLAUDE.md` aninhados que carregam sob demanda. O corte remove seções como layouts de diretório, listas de dependências e visões gerais de arquitetura, e mantém armadilhas, lógica e convenções que diferem dos padrões de ferramentas. Também oferece tornar [modo automático](/pt/permissions#permission-modes) seu padrão e [pré-aprovar](/pt/permissions) comandos somente leitura frequentemente negados. Relata descobertas primeiro e pede confirmação antes de alterar qualquer coisa. Do terminal, `claude doctor` imprime diagnósticos de instalação somente leitura sem iniciar uma sessão. Alias: `/checkup`. {/* min-version: 2.1.206 */}A verificação de corte `CLAUDE.md` requer Claude Code v2.1.206 ou posterior. Antes da v2.1.206, a verificação de versão comparava instalações do Homebrew contra a configuração `autoUpdatesChannel` em vez do [canal do cask instalado](/pt/setup#configure-release-channel). {/* min-version: 2.1.205 */}Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos somente leitura e pressionar `f` enviava o relatório para Claude |80| `/doctor` | **[Skill](/docs/pt/skills#bundled-skills).** Executar uma verificação de configuração que diagnostica problemas e pode corrigi-los. Verifica a saúde da instalação, incluindo instalações duplicadas ou restantes, problemas de `PATH` e arquivos de configurações não analisáveis. Encontra skills não utilizadas, servidores MCP e plugins versus seu custo de contexto, sinaliza [hooks](/docs/pt/hooks) lentos e verifica uma versão mais recente no seu canal de lançamento. Deduplica arquivos `CLAUDE.md` locais contra os verificados, aparas arquivos [`CLAUDE.md`](/docs/pt/memory) verificados cortando conteúdo que Claude poderia derivar do codebase, e migra a orientação sempre carregada que permanece para [skills](/docs/pt/skills) e arquivos `CLAUDE.md` aninhados que carregam sob demanda. O corte remove seções como layouts de diretório, listas de dependências e visões gerais de arquitetura, e mantém armadilhas, lógica e convenções que diferem dos padrões de ferramentas. Também oferece tornar [modo automático](/docs/pt/permissions#permission-modes) seu padrão e [pré-aprovar](/docs/pt/permissions) comandos somente leitura frequentemente negados. Relata descobertas primeiro e pede confirmação antes de alterar qualquer coisa. Do terminal, `claude doctor` imprime diagnósticos de instalação somente leitura sem iniciar uma sessão. Alias: `/checkup`. A verificação de corte `CLAUDE.md` requer Claude Code v2.1.206 ou posterior. Antes da v2.1.206, a verificação de versão comparava instalações do Homebrew contra a configuração `autoUpdatesChannel` em vez do [canal do cask instalado](/docs/pt/setup#configure-release-channel). Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos somente leitura e pressionar `f` enviava o relatório para Claude |

81| `/effort [level\|auto]` | Definir o [nível de esforço](/pt/model-config#adjust-effort-level) do modelo. Aceita `low`, `medium`, `high`, `xhigh`, `max` ou `ultracode`; os níveis disponíveis dependem do modelo, e `max` e `ultracode` são apenas para sessão. `ultracode` é uma configuração do Claude Code que combina raciocínio `xhigh` com orquestração automática de [workflow](/pt/workflows#let-claude-decide-with-ultracode). `auto` redefine para o padrão do modelo. Sem um argumento, abre um controle deslizante interativo; use as setas esquerda e direita para escolher um nível e `Enter` para aplicar. Entra em vigor imediatamente sem esperar a resposta atual terminar. {/* min-version: 2.1.205 */}Também disponível em modo não interativo (`-p`) com um argumento de nível, onde se aplica apenas à sessão atual e não é salvo como seu padrão; requer Claude Code v2.1.205 ou posterior. No Fable 5, Opus 4.8 e Opus 4.7, um `/effort` não interativo relata `Not applied` enquanto a [retenção de esforço padrão do modelo](/pt/model-config#adjust-effort-level) está em vigor, então passe `--effort` no lançamento em vez disso |81| `/effort [level\|auto]` | Definir o [nível de esforço](/docs/pt/model-config#adjust-effort-level) do modelo. Aceita `low`, `medium`, `high`, `xhigh`, `max` ou `ultracode`; os níveis disponíveis dependem do modelo, e `max` e `ultracode` são apenas para sessão. `ultracode` é uma configuração do Claude Code que combina raciocínio `xhigh` com orquestração automática de [workflow](/docs/pt/workflows#let-claude-decide-with-ultracode). `auto` redefine para o padrão do modelo. Sem um argumento, abre um controle deslizante interativo; use as setas esquerda e direita para escolher um nível e `Enter` para aplicar. Entra em vigor imediatamente sem esperar a resposta atual terminar. Também disponível em modo não interativo (`-p`) com um argumento de nível, onde se aplica apenas à sessão atual e não é salvo como seu padrão; requer Claude Code v2.1.205 ou posterior. No Fable 5, Opus 4.8 e Opus 4.7, um `/effort` não interativo relata `Not applied` enquanto a [retenção de esforço padrão do modelo](/docs/pt/model-config#adjust-effort-level) está em vigor, então passe `--effort` no lançamento em vez disso |

82| `/exit` | Sair da CLI. Em uma [sessão de fundo](/pt/agent-view#attach-to-a-session) anexada, isso desanexa e a sessão continua em execução. Alias: `/quit` |82| `/exit` | Sair da CLI. Em uma [sessão de fundo](/docs/pt/agent-view#attach-to-a-session) anexada, isso desanexa e a sessão continua em execução. Alias: `/quit` |

83| `/export [filename]` | Exportar a conversa atual como texto simples. Com um nome de arquivo, escreve diretamente nesse arquivo. Sem um, abre um diálogo para copiar para a área de transferência ou salvar em um arquivo |83| `/export [filename]` | Exportar a conversa atual como texto simples. Com um nome de arquivo, escreve diretamente nesse arquivo. Sem um, abre um diálogo para copiar para a área de transferência ou salvar em um arquivo |

84| `/fast [on\|off]` | Alternar [modo rápido](/pt/fast-mode) ativado ou desativado. {/* min-version: 2.1.205 */}Em modo não interativo (`-p`), `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância se aplica apenas à sessão atual e não é salva como seu padrão, e em qualquer outra sessão não interativa o comando relata que modo rápido não está disponível. Requer Claude Code v2.1.205 ou posterior |84| `/fast [on\|off]` | Alternar [modo rápido](/docs/pt/fast-mode) ativado ou desativado. Em modo não interativo (`-p`), `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](/docs/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância se aplica apenas à sessão atual e não é salva como seu padrão, e em qualquer outra sessão não interativa o comando relata que modo rápido não está disponível. Requer Claude Code v2.1.205 ou posterior |

85| `/feedback [report]` | Enviar feedback, relatar um bug ou compartilhar sua conversa. Enviar para Anthropic requer [autenticação](/pt/authentication). Aliases: `/bug`, `/share` |85| `/feedback [report]` | Enviar feedback, relatar um bug ou compartilhar sua conversa. Enviar para Anthropic requer [autenticação](/docs/pt/authentication). Aliases: `/bug`, `/share` |

86| `/fewer-permission-prompts` | **[Skill](/pt/skills#bundled-skills).** Verificar seus transcritos para chamadas de ferramentas Bash e MCP comuns somente leitura, depois adicionar uma lista de permissões priorizada ao projeto `.claude/settings.json` para reduzir prompts de permissão |86| `/fewer-permission-prompts` | **[Skill](/docs/pt/skills#bundled-skills).** Verificar seus transcritos para chamadas de ferramentas Bash e MCP comuns somente leitura, depois adicionar uma lista de permissões priorizada ao projeto `.claude/settings.json` para reduzir prompts de permissão |

87| `/focus` | Alternar a visualização de foco, que mostra apenas seu último prompt, um resumo de chamada de ferramenta de uma linha com estatísticas de edição de diff e a resposta final. {/* min-version: 2.1.198 */}A partir da v2.1.198, o resumo de chamada de ferramenta também conta os subagentes lançados no turno e recolhe notificações de tarefas de fundo concluídas em uma única contagem. A seleção persiste entre sessões; defina [`viewMode`](/pt/settings#available-settings) nas configurações para substituir. Disponível apenas em [renderização em tela cheia](/pt/fullscreen) |87| `/focus` | Alternar a visualização de foco, que mostra apenas seu último prompt, um resumo de chamada de ferramenta de uma linha com estatísticas de edição de diff e a resposta final. A partir da v2.1.198, o resumo de chamada de ferramenta também conta os subagentes lançados no turno e recolhe notificações de tarefas de fundo concluídas em uma única contagem. A seleção persiste entre sessões; defina [`viewMode`](/docs/pt/settings#available-settings) nas configurações para substituir. Disponível apenas em [renderização em tela cheia](/docs/pt/fullscreen) |

88| `/fork <directive>` | {/* min-version: 2.1.161 */}Gerar um [subagent bifurcado](/pt/sub-agents#fork-the-current-conversation): um subagent de fundo que herda a conversa completa e trabalha na diretiva enquanto você continua. Seu resultado retorna à sua conversa quando termina. Para alternar para uma cópia da conversa você mesmo, use `/branch`. Antes da v2.1.161, `/fork` é um alias para `/branch` |88| `/fork <directive>` | Gerar um [subagent bifurcado](/docs/pt/sub-agents#fork-the-current-conversation): um subagent de fundo que herda a conversa completa e trabalha na diretiva enquanto você continua. Seu resultado retorna à sua conversa quando termina. Para alternar para uma cópia da conversa você mesmo, use `/branch`. Antes da v2.1.161, `/fork` é um alias para `/branch` |

89| `/goal [condition\|clear]` | Definir uma [meta](/pt/goal): Claude continua trabalhando entre turnos até que a condição seja atendida. Sem um argumento, mostra a meta atual ou mais recentemente alcançada. `clear`, `stop`, `off`, `reset`, `none` ou `cancel` remove uma meta ativa antecipadamente |89| `/goal [condition\|clear]` | Definir uma [meta](/docs/pt/goal): Claude continua trabalhando entre turnos até que a condição seja atendida. Sem um argumento, mostra a meta atual ou mais recentemente alcançada. `clear`, `stop`, `off`, `reset`, `none` ou `cancel` remove uma meta ativa antecipadamente |

90| `/heapdump` | Escrever um snapshot de heap JavaScript e um detalhamento de memória para `~/Desktop`, ou seu diretório inicial no Linux sem uma pasta Desktop, para diagnosticar alto uso de memória. O arquivo `.heapsnapshot` contém sua conversa completa e credenciais, então não o compartilhe. Consulte [solução de problemas](/pt/troubleshooting#high-cpu-or-memory-usage) |90| `/heapdump` | Escrever um snapshot de heap JavaScript e um detalhamento de memória para `~/Desktop`, ou seu diretório inicial no Linux sem uma pasta Desktop, para diagnosticar alto uso de memória. O arquivo `.heapsnapshot` contém sua conversa completa e credenciais, então não o compartilhe. Consulte [solução de problemas](/docs/pt/troubleshooting#high-cpu-or-memory-usage) |

91| `/help` | Mostrar ajuda e comandos disponíveis |91| `/help` | Mostrar ajuda e comandos disponíveis |

92| `/hooks` | Visualizar configurações de [hook](/pt/hooks) para eventos de ferramentas |92| `/hooks` | Visualizar configurações de [hook](/docs/pt/hooks) para eventos de ferramentas |

93| `/ide` | Gerenciar integrações de IDE e mostrar status |93| `/ide` | Gerenciar integrações de IDE e mostrar status |

94| `/init` | Inicializar projeto com um guia `CLAUDE.md`. Defina `CLAUDE_CODE_NEW_INIT=1` para um fluxo interativo que também orienta através de skills, hooks e arquivos de memória pessoal |94| `/init` | Inicializar projeto com um guia `CLAUDE.md`. Defina `CLAUDE_CODE_NEW_INIT=1` para um fluxo interativo que também orienta através de skills, hooks e arquivos de memória pessoal |

95| `/insights` | Gerar um relatório analisando suas sessões do Claude Code, incluindo áreas do projeto, padrões de interação e pontos de fricção |95| `/insights` | Gerar um relatório analisando suas sessões do Claude Code, incluindo áreas do projeto, padrões de interação e pontos de fricção |

96| `/install-github-app` | Instalar o aplicativo Claude GitHub para um repositório, com uma etapa opcional para configurar workflows do [GitHub Actions](/pt/github-actions) e segredos. Orienta você na seleção de um repositório e configuração da integração |96| `/install-github-app` | Instalar o aplicativo Claude GitHub para um repositório, com uma etapa opcional para configurar workflows do [GitHub Actions](/docs/pt/github-actions) e segredos. Orienta você na seleção de um repositório e configuração da integração |

97| `/install-slack-app` | Instalar o aplicativo Claude Slack. Abre um navegador para concluir o fluxo OAuth |97| `/install-slack-app` | Instalar o aplicativo Claude Slack. Abre um navegador para concluir o fluxo OAuth |

98| `/keybindings` | Abrir seu arquivo de [atalhos de teclado](/pt/keybindings) |98| `/keybindings` | Abrir seu arquivo de [atalhos de teclado](/docs/pt/keybindings) |

99| `/login` | Entrar em sua conta Anthropic |99| `/login` | Entrar em sua conta Anthropic |

100| `/logout` | Sair de sua conta Anthropic |100| `/logout` | Sair de sua conta Anthropic |

101| `/loop [interval] [prompt]` | **[Skill](/pt/skills#bundled-skills).** Executar um prompt repetidamente enquanto a sessão permanece aberta. Omita o intervalo e Claude se auto-regula entre iterações. Omita o prompt e, [onde disponível](/pt/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude executa uma verificação de manutenção autônoma ou o prompt em `.claude/loop.md`. Exemplo: `/loop 5m check if the deploy finished`. Consulte [Executar prompts em um cronograma](/pt/scheduled-tasks). Alias: `/proactive` |101| `/loop [interval] [prompt]` | **[Skill](/docs/pt/skills#bundled-skills).** Executar um prompt repetidamente enquanto a sessão permanece aberta. Omita o intervalo e Claude se auto-regula entre iterações. Omita o prompt e, [onde disponível](/docs/pt/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude executa uma verificação de manutenção autônoma ou o prompt em `.claude/loop.md`. Exemplo: `/loop 5m check if the deploy finished`. Consulte [Executar prompts em um cronograma](/docs/pt/scheduled-tasks). Alias: `/proactive` |

102| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gerenciar conexões de servidor MCP e autenticação OAuth. Execute sem argumento para abrir a lista interativa, passe `reconnect <server>` para reconectar um servidor desconectado, ou passe `enable`/`disable` com um nome de servidor ou `all` para alterar o estado de conexão sem abrir o diálogo. {/* min-version: 2.1.205 */}Também disponível em modo não interativo (`-p`), onde executá-lo sem argumento imprime um resumo de texto do status do servidor em vez de abrir a lista; requer Claude Code v2.1.205 ou posterior |102| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gerenciar conexões de servidor MCP e autenticação OAuth. Execute sem argumento para abrir a lista interativa, passe `reconnect <server>` para reconectar um servidor desconectado, ou passe `enable`/`disable` com um nome de servidor ou `all` para alterar o estado de conexão sem abrir o diálogo. Também disponível em modo não interativo (`-p`), onde executá-lo sem argumento imprime um resumo de texto do status do servidor em vez de abrir a lista; requer Claude Code v2.1.205 ou posterior |

103| `/memory` | Editar arquivos de memória `CLAUDE.md`, ativar ou desativar [auto-memory](/pt/memory#auto-memory) e visualizar entradas de auto-memory |103| `/memory` | Editar arquivos de memória `CLAUDE.md`, ativar ou desativar [auto-memory](/docs/pt/memory#auto-memory) e visualizar entradas de auto-memory |

104| `/mobile` | Mostrar código QR para baixar o aplicativo Claude mobile. Aliases: `/ios`, `/android` |104| `/mobile` | Mostrar código QR para baixar o aplicativo Claude mobile. Aliases: `/ios`, `/android` |

105| `/model [model]` | Alternar o modelo de IA e salvá-lo como padrão para novas sessões. Para modelos que suportam, use as setas esquerda/direita para [ajustar o nível de esforço](/pt/model-config#adjust-effort-level). Sem um argumento, abre um seletor; pressione `s` em uma linha para alternar apenas para a sessão atual. O seletor pede confirmação quando a conversa tem saída anterior, já que a próxima resposta relê o histórico completo sem contexto em cache. Uma vez confirmado, a alteração entra em vigor sem esperar a resposta atual terminar. {/* min-version: 2.1.205 */}Também disponível em modo não interativo (`-p`) com um argumento de modelo em vez do seletor, onde se aplica apenas à sessão atual e não é salvo como seu padrão; requer Claude Code v2.1.205 ou posterior |105| `/model [model]` | Alternar o modelo de IA e salvá-lo como padrão para novas sessões. Para modelos que suportam, use as setas esquerda/direita para [ajustar o nível de esforço](/docs/pt/model-config#adjust-effort-level). Sem um argumento, abre um seletor; pressione `s` em uma linha para alternar apenas para a sessão atual. O seletor pede confirmação quando a conversa tem saída anterior, já que a próxima resposta relê o histórico completo sem contexto em cache. Uma vez confirmado, a alteração entra em vigor sem esperar a resposta atual terminar. Também disponível em modo não interativo (`-p`) com um argumento de modelo em vez do seletor, onde se aplica apenas à sessão atual e não é salvo como seu padrão; requer Claude Code v2.1.205 ou posterior |

106| `/passes` | Compartilhar uma semana gratuita do Claude Code com amigos. Visível apenas se sua conta for elegível |106| `/passes` | Compartilhar uma semana gratuita do Claude Code com amigos. Visível apenas se sua conta for elegível |

107| `/permissions` | Gerenciar regras de permissão para permitir, perguntar e negar ferramentas. Abre um diálogo interativo onde você pode visualizar regras por escopo, adicionar ou remover regras, gerenciar diretórios de trabalho e revisar [negações de modo automático recentes](/pt/auto-mode-config#review-denials). Alias: `/allowed-tools` |107| `/permissions` | Gerenciar regras de permissão para permitir, perguntar e negar ferramentas. Abre um diálogo interativo onde você pode visualizar regras por escopo, adicionar ou remover regras, gerenciar diretórios de trabalho e revisar [negações de modo automático recentes](/docs/pt/auto-mode-config#review-denials). Alias: `/allowed-tools` |

108| `/plan [description]` | Entrar no Plan Mode diretamente do prompt. Passe uma descrição opcional para entrar no Plan Mode e começar imediatamente com essa tarefa, por exemplo `/plan fix the auth bug` |108| `/plan [description]` | Entrar no Plan Mode diretamente do prompt. Passe uma descrição opcional para entrar no Plan Mode e começar imediatamente com essa tarefa, por exemplo `/plan fix the auth bug` |

109| `/plugin [subcommand]` | Gerenciar [plugins](/pt/plugins) do Claude Code. Execute sem argumento para abrir o menu de plugin, ou passe um subcomando como `list`, `install`, `enable` ou `disable` para agir diretamente |109| `/plugin [subcommand]` | Gerenciar [plugins](/docs/pt/plugins) do Claude Code. Execute sem argumento para abrir o menu de plugin, ou passe um subcomando como `list`, `install`, `enable` ou `disable` para agir diretamente |

110| `/powerup` | Descobrir recursos do Claude Code através de lições interativas rápidas com demos animadas |110| `/powerup` | Descobrir recursos do Claude Code através de lições interativas rápidas com demos animadas |

111| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Removido na v2.1.91. Peça ao Claude diretamente para visualizar comentários de solicitação de pull. Em versões anteriores, busca e exibe comentários de uma solicitação de pull do GitHub; detecta automaticamente o PR para o branch atual, ou passe uma URL ou número de PR. Requer a CLI `gh` |111| `/pr-comments [PR]` | Removido na v2.1.91. Peça ao Claude diretamente para visualizar comentários de solicitação de pull. Em versões anteriores, busca e exibe comentários de uma solicitação de pull do GitHub; detecta automaticamente o PR para o branch atual, ou passe uma URL ou número de PR. Requer a CLI `gh` |

112| `/privacy-settings` | Visualizar e atualizar suas configurações de privacidade. Disponível apenas para assinantes dos planos Pro e Max |112| `/privacy-settings` | Visualizar e atualizar suas configurações de privacidade. Disponível apenas para assinantes dos planos Pro e Max |

113| `/radio` | Abrir Claude FM lo-fi radio em seu navegador. Imprime a URL do stream quando nenhum navegador está disponível. Não disponível no Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry ou no Claude Platform na AWS |113| `/radio` | Abrir Claude FM lo-fi radio em seu navegador. Imprime a URL do stream quando nenhum navegador está disponível. Não disponível no Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry ou no Claude Platform na AWS |

114| `/recap` | Gerar um resumo de uma linha da sessão atual sob demanda. Consulte [Session recap](/pt/interactive-mode#session-recap) para o recap automático que aparece depois que você esteve ausente |114| `/recap` | Gerar um resumo de uma linha da sessão atual sob demanda. Consulte [Session recap](/docs/pt/interactive-mode#session-recap) para o recap automático que aparece depois que você esteve ausente |

115| `/release-notes` | Visualizar o changelog em um seletor de versão interativo. Selecione uma versão específica para ver suas notas de lançamento, ou escolha mostrar todas as versões. {/* min-version: 2.1.208 */}As notas aparecem em sua transcrição sem entrar na conversa que Claude vê. Antes da v2.1.208, as notas visualizadas entravam na conversa, incluindo todo o changelog ao mostrar todas as versões |115| `/release-notes` | Visualizar o changelog em um seletor de versão interativo. Selecione uma versão específica para ver suas notas de lançamento, ou escolha mostrar todas as versões. As notas aparecem em sua transcrição sem entrar na conversa que Claude vê. Antes da v2.1.208, as notas visualizadas entravam na conversa, incluindo todo o changelog ao mostrar todas as versões |

116| `/reload-plugins [--force]` | Recarregar todos os [plugins](/pt/plugins) ativos para aplicar alterações pendentes sem reiniciar. Relata contagens para cada componente recarregado e sinaliza quaisquer erros de carregamento. Quando o recarregamento alteraria quais ferramentas MCP são carregadas e invalidaria o cache de prompt, o comando avisa e pula a menos que você passe `--force` |116| `/reload-plugins [--force]` | Recarregar todos os [plugins](/docs/pt/plugins) ativos para aplicar alterações pendentes sem reiniciar. Relata contagens para cada componente recarregado e sinaliza quaisquer erros de carregamento. Quando o recarregamento alteraria quais ferramentas MCP são carregadas e invalidaria o cache de prompt, o comando avisa e pula a menos que você passe `--force` |

117| `/reload-skills` | {/* min-version: 2.1.152 */}Verificar novamente [skill](/pt/skills) e diretórios de comando para que skills adicionadas ou alteradas no disco durante a sessão fiquem disponíveis sem reiniciar. Relata quantas skills estão disponíveis e quantas foram adicionadas ou removidas. Adicionado na v2.1.152 |117| `/reload-skills` | Verificar novamente [skill](/docs/pt/skills) e diretórios de comando para que skills adicionadas ou alteradas no disco durante a sessão fiquem disponíveis sem reiniciar. Relata quantas skills estão disponíveis e quantas foram adicionadas ou removidas. Adicionado na v2.1.152 |

118| `/remote-control` | Disponibilizar esta sessão para [Remote Control](/pt/remote-control) do claude.ai. {/* min-version: 2.1.206 */}Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como entrar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |118| `/remote-control` | Disponibilizar esta sessão para [Remote Control](/docs/pt/remote-control) do claude.ai. Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como entrar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |

119| `/remote-env` | Escolher o ambiente padrão para [agentes em nuvem](/pt/claude-code-on-the-web#configure-your-environment) |119| `/remote-env` | Escolher o ambiente padrão para [agentes em nuvem](/docs/pt/claude-code-on-the-web#configure-your-environment) |

120| `/rename [name]` | Renomear a sessão atual e mostrar o nome na barra de prompt. Sem um nome, gera automaticamente um a partir do histórico de conversa. {/* min-version: 2.1.205 */}Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior |120| `/rename [name]` | Renomear a sessão atual e mostrar o nome na barra de prompt. Sem um nome, gera automaticamente um a partir do histórico de conversa. Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior |

121| `/resume [session]` | Retomar uma conversa por ID ou nome, ou abrir o seletor de sessão. A partir da v2.1.144, [sessões de fundo](/pt/agent-view) aparecem no seletor marcadas com `bg`; uma que ainda está em execução não pode ser retomada aqui, então anexe-a de `claude agents` ou pare-a lá primeiro. Alias: `/continue` |121| `/resume [session]` | Retomar uma conversa por ID ou nome, ou abrir o seletor de sessão. A partir da v2.1.144, [sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg`; uma que ainda está em execução não pode ser retomada aqui, então anexe-a de `claude agents` ou pare-a lá primeiro. Alias: `/continue` |

122| `/review [PR]` | {/* min-version: 2.1.202 */}Executar uma revisão rápida de uma única passagem e somente leitura de uma solicitação de pull do GitHub por número. Sem argumento, lista PRs abertos para escolher; texto após o número do PR se torna instruções de revisão adicionais. De v2.1.186 a v2.1.201, `/review` executava o mesmo mecanismo de multi-agente que `/code-review medium`. Para uma revisão de multi-agente em um nível de esforço escolhido, use [`/code-review <level> <pr#>`](/pt/code-review#review-a-diff-locally); para uma revisão baseada em nuvem, consulte [`/code-review ultra`](/pt/ultrareview) |122| `/review [PR]` | Executar uma revisão rápida de uma única passagem e somente leitura de uma solicitação de pull do GitHub por número. Sem argumento, lista PRs abertos para escolher; texto após o número do PR se torna instruções de revisão adicionais. De v2.1.186 a v2.1.201, `/review` executava o mesmo mecanismo de multi-agente que `/code-review medium`. Para uma revisão de multi-agente em um nível de esforço escolhido, use [`/code-review <level> <pr#>`](/docs/pt/code-review#review-a-diff-locally); para uma revisão baseada em nuvem, consulte [`/code-review ultra`](/docs/pt/ultrareview) |

123| `/rewind` | Retroceder a conversa e/ou código para um ponto anterior, ou resumir a partir de uma mensagem selecionada. Consulte [checkpointing](/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |123| `/rewind` | Retroceder a conversa e/ou código para um ponto anterior, ou resumir a partir de uma mensagem selecionada. Consulte [checkpointing](/docs/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |

124| `/run` | **[Skill](/pt/skills#bundled-skills).** Iniciar e conduzir o aplicativo do seu projeto para ver uma alteração funcionando, não apenas em testes. Consulte [Executar e verificar seu aplicativo](/pt/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Requer Claude Code v2.1.145 ou posterior |124| `/run` | **[Skill](/docs/pt/skills#bundled-skills).** Iniciar e conduzir o aplicativo do seu projeto para ver uma alteração funcionando, não apenas em testes. Consulte [Executar e verificar seu aplicativo](/docs/pt/skills#run-and-verify-your-app). Requer Claude Code v2.1.145 ou posterior |

125| `/run-skill-generator` | **[Skill](/pt/skills#bundled-skills).** Ensinar `/run` e `/verify` como construir, iniciar e conduzir o aplicativo do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/pt/skills#run-and-verify-your-app) por projeto. {/* min-version: 2.1.145 */}Requer Claude Code v2.1.145 ou posterior |125| `/run-skill-generator` | **[Skill](/docs/pt/skills#bundled-skills).** Ensinar `/run` e `/verify` como construir, iniciar e conduzir o aplicativo do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/docs/pt/skills#run-and-verify-your-app) por projeto. Requer Claude Code v2.1.145 ou posterior |

126| `/sandbox` | Alternar [modo sandbox](/pt/sandboxing). Disponível apenas em plataformas suportadas |126| `/sandbox` | Alternar [modo sandbox](/docs/pt/sandboxing). Disponível apenas em plataformas suportadas |

127| `/schedule [description]` | Criar, atualizar, listar ou executar [rotinas](/pt/routines), que são executadas na infraestrutura em nuvem gerenciada pela Anthropic. Claude orienta você através da configuração conversacionalmente. Alias: `/routines` |127| `/schedule [description]` | Criar, atualizar, listar ou executar [rotinas](/docs/pt/routines), que são executadas na infraestrutura em nuvem gerenciada pela Anthropic. Claude orienta você através da configuração conversacionalmente. Alias: `/routines` |

128| `/scroll-speed` | Ajustar a [velocidade de rolagem](/pt/fullscreen#mouse-wheel-scrolling) do mouse interativamente, com uma régua que você pode rolar enquanto o diálogo está aberto para visualizar a alteração. Disponível apenas em [renderização em tela cheia](/pt/fullscreen) e não no terminal do IDE JetBrains |128| `/scroll-speed` | Ajustar a [velocidade de rolagem](/docs/pt/fullscreen#mouse-wheel-scrolling) do mouse interativamente, com uma régua que você pode rolar enquanto o diálogo está aberto para visualizar a alteração. Disponível apenas em [renderização em tela cheia](/docs/pt/fullscreen) e não no terminal do IDE JetBrains |

129| `/security-review` | Analisar alterações pendentes no branch atual para vulnerabilidades de segurança. Revisa o diff git e identifica riscos como injeção, problemas de autenticação e exposição de dados |129| `/security-review` | Analisar alterações pendentes no branch atual para vulnerabilidades de segurança. Revisa o diff git e identifica riscos como injeção, problemas de autenticação e exposição de dados |

130| `/setup-bedrock` | Configurar autenticação, região e fixações de modelo do [Amazon Bedrock](/pt/amazon-bedrock) através de um assistente interativo. Visível apenas quando `CLAUDE_CODE_USE_BEDROCK=1` está definido. Usuários do Amazon Bedrock pela primeira vez também podem acessar este assistente na tela de login |130| `/setup-bedrock` | Configurar autenticação, região e fixações de modelo do [Amazon Bedrock](/docs/pt/amazon-bedrock) através de um assistente interativo. Visível apenas quando `CLAUDE_CODE_USE_BEDROCK=1` está definido. Usuários do Amazon Bedrock pela primeira vez também podem acessar este assistente na tela de login |

131| `/setup-vertex` | Configurar autenticação, projeto, região e fixações de modelo da [plataforma de agentes do Google Cloud](/pt/google-vertex-ai) através de um assistente interativo. Visível apenas quando `CLAUDE_CODE_USE_VERTEX=1` está definido. Usuários da plataforma de agentes do Google Cloud pela primeira vez também podem acessar este assistente na tela de login |131| `/setup-vertex` | Configurar autenticação, projeto, região e fixações de modelo da [plataforma de agentes do Google Cloud](/docs/pt/google-vertex-ai) através de um assistente interativo. Visível apenas quando `CLAUDE_CODE_USE_VERTEX=1` está definido. Usuários da plataforma de agentes do Google Cloud pela primeira vez também podem acessar este assistente na tela de login |

132| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/pt/skills#bundled-skills).** Revisar o código alterado para oportunidades de limpeza e aplicar as correções. Quatro [agentes](/pt/sub-agents) de revisão são executados em paralelo, cobrindo reutilização de helpers existentes, simplificação, eficiência e se a alteração está no nível certo de abstração. A partir da v2.1.154, a revisão não procura por bugs de correção. Use `/code-review` para encontrar bugs. Em versões anteriores, `/simplify` é equivalente a `/code-review --fix`. Passe um caminho ou referência de PR para revisar um alvo específico |132| `/simplify [target]` | **[Skill](/docs/pt/skills#bundled-skills).** Revisar o código alterado para oportunidades de limpeza e aplicar as correções. Quatro [agentes](/docs/pt/sub-agents) de revisão são executados em paralelo, cobrindo reutilização de helpers existentes, simplificação, eficiência e se a alteração está no nível certo de abstração. A partir da v2.1.154, a revisão não procura por bugs de correção. Use `/code-review` para encontrar bugs. Em versões anteriores, `/simplify` é equivalente a `/code-review --fix`. Passe um caminho ou referência de PR para revisar um alvo específico |

133| `/skills` | Listar [skills](/pt/skills) disponíveis. {/* min-version: 2.1.121 */}A partir da v2.1.121, digite para filtrar a lista por nome. Pressione `t` para classificar por contagem de tokens. Pressione `Space` para [ocultar uma skill do Claude ou do menu `/`](/pt/skills#override-skill-visibility-from-settings), depois `Enter` para salvar |133| `/skills` | Listar [skills](/docs/pt/skills) disponíveis. A partir da v2.1.121, digite para filtrar a lista por nome. Pressione `t` para classificar por contagem de tokens. Pressione `Space` para [ocultar uma skill do Claude ou do menu `/`](/docs/pt/skills#override-skill-visibility-from-settings), depois `Enter` para salvar |

134| `/stats` | Alias para `/usage`. Abre na aba Stats |134| `/stats` | Alias para `/usage`. Abre na aba Stats |

135| `/status` | Abrir a interface de Configurações na aba Status, mostrando versão, modelo, conta e conectividade. Funciona enquanto Claude está respondendo |135| `/status` | Abrir a interface de Configurações na aba Status, mostrando versão, modelo, conta e conectividade. Funciona enquanto Claude está respondendo |

136| `/statusline` | Configurar a [linha de status](/pt/statusline) do Claude Code. Descreva o que você quer, ou execute sem argumentos para auto-configurar a partir do seu prompt de shell |136| `/statusline` | Configurar a [linha de status](/docs/pt/statusline) do Claude Code. Descreva o que você quer, ou execute sem argumentos para auto-configurar a partir do seu prompt de shell |

137| `/stickers` | Pedir adesivos do Claude Code |137| `/stickers` | Pedir adesivos do Claude Code |

138| `/stop` | Parar a [sessão de fundo](/pt/agent-view) atual. Disponível apenas enquanto anexado a uma sessão de fundo; a transcrição e qualquer worktree são mantidos. Para desanexar sem parar, use `/exit` ou pressione `←` |138| `/stop` | Parar a [sessão de fundo](/docs/pt/agent-view) atual. Disponível apenas enquanto anexado a uma sessão de fundo; a transcrição e qualquer worktree são mantidos. Para desanexar sem parar, use `/exit` ou pressione `←` |

139| `/tasks` | Visualizar e gerenciar trabalho em segundo plano na sessão atual, incluindo subagentes que terminaram. Também disponível como `/bashes` |139| `/tasks` | Visualizar e gerenciar trabalho em segundo plano na sessão atual, incluindo subagentes que terminaram. Também disponível como `/bashes` |

140| `/team-onboarding` | Gerar um guia de integração de equipe a partir do seu histórico de uso do Claude Code. Claude analisa suas sessões, comandos e uso de servidor MCP dos últimos 30 dias e produz um guia markdown que um colega de equipe pode colar como primeira mensagem para se configurar rapidamente. Para assinantes do claude.ai nos planos Pro, Max, Team e Enterprise, também retorna um link de compartilhamento que colegas de equipe podem abrir diretamente no Claude Code |140| `/team-onboarding` | Gerar um guia de integração de equipe a partir do seu histórico de uso do Claude Code. Claude analisa suas sessões, comandos e uso de servidor MCP dos últimos 30 dias e produz um guia markdown que um colega de equipe pode colar como primeira mensagem para se configurar rapidamente. Para assinantes do claude.ai nos planos Pro, Max, Team e Enterprise, também retorna um link de compartilhamento que colegas de equipe podem abrir diretamente no Claude Code |

141| `/teleport` | Puxar uma sessão [Claude Code na web](/pt/claude-code-on-the-web#from-web-to-terminal) para este terminal: abre um seletor, depois busca o branch e a conversa. Também disponível como `/tp`. Requer uma assinatura claude.ai |141| `/teleport` | Puxar uma sessão [Claude Code na web](/docs/pt/claude-code-on-the-web#from-web-to-terminal) para este terminal: abre um seletor, depois busca o branch e a conversa. Também disponível como `/tp`. Requer uma assinatura claude.ai |

142| `/terminal-setup` | Configurar atalhos de teclado do terminal para Shift+Enter e outros atalhos. Visível apenas em terminais que precisam, como VS Code, Cursor, Devin Desktop, Alacritty ou Zed |142| `/terminal-setup` | Configurar atalhos de teclado do terminal para Shift+Enter e outros atalhos. Visível apenas em terminais que precisam, como VS Code, Cursor, Devin Desktop, Alacritty ou Zed |

143| `/theme` | Alterar o tema de cor. Inclui uma opção `auto` que segue o modo escuro ou claro do seu terminal, variantes claro e escuro, temas acessíveis para daltônicos (daltonizados), temas ANSI que usam a paleta de cores do seu terminal e qualquer [tema personalizado](/pt/terminal-config#create-a-custom-theme) de `~/.claude/themes/` ou plugins. Selecione **New custom theme…** para criar um |143| `/theme` | Alterar o tema de cor. Inclui uma opção `auto` que segue o modo escuro ou claro do seu terminal, variantes claro e escuro, temas acessíveis para daltônicos (daltonizados), temas ANSI que usam a paleta de cores do seu terminal e qualquer [tema personalizado](/docs/pt/terminal-config#create-a-custom-theme) de `~/.claude/themes/` ou plugins. Selecione **New custom theme…** para criar um |

144| `/tui [default\|fullscreen]` | Definir o renderizador de interface do usuário do terminal e relançar nele com sua conversa intacta. `fullscreen` ativa o [renderizador alt-screen sem cintilação](/pt/fullscreen). Sem um argumento, imprime o renderizador ativo |144| `/tui [default\|fullscreen]` | Definir o renderizador de interface do usuário do terminal e relançar nele com sua conversa intacta. `fullscreen` ativa o [renderizador alt-screen sem cintilação](/docs/pt/fullscreen). Sem um argumento, imprime o renderizador ativo |

145| `/ultraplan <prompt>` | Rascunhar um plano em uma sessão [ultraplan](/pt/ultraplan), revisá-lo em seu navegador, depois executar remotamente ou enviá-lo de volta para seu terminal |145| `/ultraplan <prompt>` | Rascunhar um plano em uma sessão [ultraplan](/docs/pt/ultraplan), revisá-lo em seu navegador, depois executar remotamente ou enviá-lo de volta para seu terminal |

146| `/ultrareview [PR]` | Executar uma revisão de código profunda e multi-agente em uma sandbox em nuvem com [ultrareview](/pt/ultrareview). A invocação preferida agora é `/code-review ultra`, e `/ultrareview` permanece como um alias. Inclui 3 execuções gratuitas em Pro e Max, depois requer [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |146| `/ultrareview [PR]` | Executar uma revisão de código profunda e multi-agente em uma sandbox em nuvem com [ultrareview](/docs/pt/ultrareview). A invocação preferida agora é `/code-review ultra`, e `/ultrareview` permanece como um alias. Inclui 3 execuções gratuitas em Pro e Max, depois requer [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

147| `/upgrade` | Abrir a página de upgrade em seu navegador para mudar para um nível de plano superior. Quando o navegador falha ao abrir, o comando mostra um prompt de entrada sem imprimir a URL |147| `/upgrade` | Abrir a página de upgrade em seu navegador para mudar para um nível de plano superior. Quando o navegador falha ao abrir, o comando mostra um prompt de entrada sem imprimir a URL |

148| `/usage` | Mostrar custo da sessão, limites de uso do plano e estatísticas de atividade. Em um plano Pro, Max, Team ou Enterprise, inclui um detalhamento de uso por skill, subagent, plugin e servidor MCP. Consulte o [guia de rastreamento de custos](/pt/costs#using-the-%2Fusage-command) para detalhes. `/cost` e `/stats` são aliases |148| `/usage` | Mostrar custo da sessão, limites de uso do plano e estatísticas de atividade. Em um plano Pro, Max, Team ou Enterprise, inclui um detalhamento de uso por skill, subagent, plugin e servidor MCP. Consulte o [guia de rastreamento de custos](/docs/pt/costs#using-the-%2Fusage-command) para detalhes. `/cost` e `/stats` são aliases |

149| `/usage-credits` | Configurar créditos de uso para continuar trabalhando quando você atinge um limite. Em planos Pro e Max, abre um [diálogo em CLI](/pt/costs#set-a-spend-limit-on-pro-and-max) para comprar créditos de uso, definir um limite de gastos mensal e configurar auto-recarga; em versões do Claude Code antes da v2.1.207 e em outros planos, abre a página de faturamento de créditos de uso em seu navegador, exceto que membros do Team e Enterprise sem acesso de faturamento enviam uma solicitação de créditos de uso para seu admin da CLI. {/* min-version: 2.1.205 */}Quando nenhum navegador pode abrir a página de faturamento, por exemplo via SSH, o comando imprime a URL para visitar em vez disso; isso requer Claude Code v2.1.205 ou posterior, e versões anteriores não mostraram nada nesse caso. Anteriormente `/extra-usage` |149| `/usage-credits` | Configurar créditos de uso para continuar trabalhando quando você atinge um limite. Em planos Pro e Max, abre um [diálogo em CLI](/docs/pt/costs#set-a-spend-limit-on-pro-and-max) para comprar créditos de uso, definir um limite de gastos mensal e configurar auto-recarga; em versões do Claude Code antes da v2.1.207 e em outros planos, abre a página de faturamento de créditos de uso em seu navegador, exceto que membros do Team e Enterprise sem acesso de faturamento enviam uma solicitação de créditos de uso para seu admin da CLI. Quando nenhum navegador pode abrir a página de faturamento, por exemplo via SSH, o comando imprime a URL para visitar em vez disso; isso requer Claude Code v2.1.205 ou posterior, e versões anteriores não mostraram nada nesse caso. Anteriormente `/extra-usage` |

150| `/verify` | **[Skill](/pt/skills#bundled-skills).** Confirmar que uma alteração de código faz o que deveria fazendo construir o aplicativo do seu projeto, executá-lo e observar o resultado, em vez de confiar em testes ou verificações de tipo. Consulte [Executar e verificar seu aplicativo](/pt/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Requer Claude Code v2.1.145 ou posterior |150| `/verify` | **[Skill](/docs/pt/skills#bundled-skills).** Confirmar que uma alteração de código faz o que deveria fazendo construir o aplicativo do seu projeto, executá-lo e observar o resultado, em vez de confiar em testes ou verificações de tipo. Consulte [Executar e verificar seu aplicativo](/docs/pt/skills#run-and-verify-your-app). Requer Claude Code v2.1.145 ou posterior |

151| `/vim` | {/* max-version: 2.1.91 */}Removido na v2.1.92. Para alternar entre modos de edição Vim e Normal, use `/config` → Editor mode |151| `/vim` | Removido na v2.1.92. Para alternar entre modos de edição Vim e Normal, use `/config` → Editor mode |

152| `/voice [hold\|tap\|off]` | Alternar [ditado por voz](/pt/voice-dictation), ou ativá-lo em um modo específico. Requer uma conta Claude.ai |152| `/voice [hold\|tap\|off]` | Alternar [ditado por voz](/docs/pt/voice-dictation), ou ativá-lo em um modo específico. Requer uma conta Claude.ai |

153| `/web-setup` | Conectar sua conta GitHub ao [Claude Code na web](/pt/web-quickstart#connect-from-your-terminal) usando suas credenciais locais de `gh` CLI. `/schedule` solicita isso automaticamente se o GitHub não estiver conectado |153| `/web-setup` | Conectar sua conta GitHub ao [Claude Code na web](/docs/pt/web-quickstart#connect-from-your-terminal) usando suas credenciais locais de `gh` CLI. `/schedule` solicita isso automaticamente se o GitHub não estiver conectado |

154| `/workflows` | Abrir a visualização de progresso do [workflow](/pt/workflows#watch-the-run) para assistir, pausar, retomar ou salvar workflows em execução e concluídos |154| `/workflows` | Abrir a visualização de progresso do [workflow](/docs/pt/workflows#watch-the-run) para assistir, pausar, retomar ou salvar workflows em execução e concluídos |

155 155 

156<h2 id="mcp-prompts">156<h2 id="mcp-prompts">

157 MCP prompts157 MCP prompts

158</h2>158</h2>

159 159 

160Os servidores MCP podem expor prompts que aparecem como comandos. Estes usam o formato `/mcp__<server>__<prompt>` e são descobertos dinamicamente a partir de servidores conectados. Consulte [MCP prompts](/pt/mcp#use-mcp-prompts-as-commands) para detalhes.160Os servidores MCP podem expor prompts que aparecem como comandos. Estes usam o formato `/mcp__<server>__<prompt>` e são descobertos dinamicamente a partir de servidores conectados. Consulte [MCP prompts](/docs/pt/mcp#use-mcp-prompts-as-commands) para detalhes.

161 161 

162<h2 id="see-also">162<h2 id="see-also">

163 Veja também163 Veja também

164</h2>164</h2>

165 165 

166* [Skills](/pt/skills): criar seus próprios comandos166* [Skills](/docs/pt/skills): criar seus próprios comandos

167* [Modo interativo](/pt/interactive-mode): atalhos de teclado, modo Vim e histórico de comandos167* [Modo interativo](/docs/pt/interactive-mode): atalhos de teclado, modo Vim e histórico de comandos

168* [Referência CLI](/pt/cli-reference): sinalizadores de tempo de inicialização168* [Referência CLI](/docs/pt/cli-reference): sinalizadores de tempo de inicialização

computer-use.md +11 −11

Details

12 12 

13Computer use permite que Claude abra aplicativos, controle sua tela e trabalhe em sua máquina da forma como você faria. A partir da CLI, Claude pode compilar um aplicativo Swift, iniciá-lo, clicar em cada botão e capturar uma tela do resultado, tudo na mesma conversa em que escreveu o código.13Computer use permite que Claude abra aplicativos, controle sua tela e trabalhe em sua máquina da forma como você faria. A partir da CLI, Claude pode compilar um aplicativo Swift, iniciá-lo, clicar em cada botão e capturar uma tela do resultado, tudo na mesma conversa em que escreveu o código.

14 14 

15Esta página aborda como o computer use funciona na CLI. Para o aplicativo Desktop no macOS ou Windows, consulte [computer use em Desktop](/pt/desktop#let-claude-use-your-computer).15Esta página aborda como o computer use funciona na CLI. Para o aplicativo Desktop no macOS ou Windows, consulte [computer use em Desktop](/docs/pt/desktop#let-claude-use-your-computer).

16 16 

17<h2 id="what-you-can-do-with-computer-use">17<h2 id="what-you-can-do-with-computer-use">

18 O que você pode fazer com computer use18 O que você pode fazer com computer use


31 31 

32Claude tem várias maneiras de interagir com um aplicativo ou serviço. Computer use é a mais ampla e lenta, portanto Claude tenta a ferramenta mais precisa primeiro:32Claude tem várias maneiras de interagir com um aplicativo ou serviço. Computer use é a mais ampla e lenta, portanto Claude tenta a ferramenta mais precisa primeiro:

33 33 

34* Se você tiver um [servidor MCP](/pt/mcp) para o serviço, Claude usa isso.34* Se você tiver um [servidor MCP](/docs/pt/mcp) para o serviço, Claude usa isso.

35* Se a tarefa for um comando shell, Claude usa Bash.35* Se a tarefa for um comando shell, Claude usa Bash.

36* Se a tarefa for trabalho de navegador e você tiver [Claude no Chrome](/pt/chrome) configurado, Claude usa isso.36* Se a tarefa for trabalho de navegador e você tiver [Claude no Chrome](/docs/pt/chrome) configurado, Claude usa isso.

37* Se nenhum desses se aplicar, Claude usa computer use.37* Se nenhum desses se aplicar, Claude usa computer use.

38 38 

39O controle de tela é reservado para coisas que nada mais pode alcançar: aplicativos nativos, simuladores e ferramentas sem uma API.39O controle de tela é reservado para coisas que nada mais pode alcançar: aplicativos nativos, simuladores e ferramentas sem uma API.


98 98 

99Esses aplicativos não são bloqueados. O aviso permite que você decida se a tarefa justifica esse nível de acesso.99Esses aplicativos não são bloqueados. O aviso permite que você decida se a tarefa justifica esse nível de acesso.

100 100 

101O nível de controle de Claude também varia por categoria de aplicativo: navegadores e plataformas de negociação são apenas visualização, terminais e IDEs são apenas clique, e tudo o mais obtém controle total. Consulte [permissões de aplicativo em Desktop](/pt/desktop#app-permissions) para a divisão de camada completa.101O nível de controle de Claude também varia por categoria de aplicativo: navegadores e plataformas de negociação são apenas visualização, terminais e IDEs são apenas clique, e tudo o mais obtém controle total. Consulte [permissões de aplicativo em Desktop](/docs/pt/desktop#app-permissions) para a divisão de camada completa.

102 102 

103<h2 id="how-claude-works-on-your-screen">103<h2 id="how-claude-works-on-your-screen">

104 Como Claude trabalha em sua tela104 Como Claude trabalha em sua tela


110 Uma sessão por vez110 Uma sessão por vez

111</h3>111</h3>

112 112 

113Computer use mantém um bloqueio em toda a máquina a partir da primeira ação de computer use até que a sessão que o adquiriu saia. {/* min-version: 2.1.195 */}A partir da v2.1.195, terminar a tarefa não libera o bloqueio; apenas sair da sessão faz isso. Se outra sessão do Claude Code já estiver usando seu computador, novas tentativas falharão com uma mensagem informando qual sessão mantém o bloqueio. Saia dessa sessão primeiro.113Computer use mantém um bloqueio em toda a máquina a partir da primeira ação de computer use até que a sessão que o adquiriu saia. A partir da v2.1.195, terminar a tarefa não libera o bloqueio; apenas sair da sessão faz isso. Se outra sessão do Claude Code já estiver usando seu computador, novas tentativas falharão com uma mensagem informando qual sessão mantém o bloqueio. Saia dessa sessão primeiro.

114 114 

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

116 Os aplicativos são ocultados enquanto Claude trabalha116 Os aplicativos são ocultados enquanto Claude trabalha


141</h2>141</h2>

142 142 

143<Warning>143<Warning>

144 Ao contrário da [ferramenta Bash em sandbox](/pt/sandboxing), computer use é executado em seu desktop real com acesso aos aplicativos que você aprova. Claude verifica cada ação e sinaliza possível injeção de prompt do conteúdo na tela, mas o limite de confiança é diferente. Consulte o [guia de segurança do computer use](https://support.claude.com/en/articles/14128542) para as melhores práticas.144 Ao contrário da [ferramenta Bash em sandbox](/docs/pt/sandboxing), computer use é executado em seu desktop real com acesso aos aplicativos que você aprova. Claude verifica cada ação e sinaliza possível injeção de prompt do conteúdo na tela, mas o limite de confiança é diferente. Consulte o [guia de segurança do computer use](https://support.claude.com/en/articles/14128542) para as melhores práticas.

145</Warning>145</Warning>

146 146 

147Os guardrails integrados reduzem o risco sem exigir configuração:147Os guardrails integrados reduzem o risco sem exigir configuração:


235 235 

236O servidor só aparece em configurações elegíveis. Verifique se:236O servidor só aparece em configurações elegíveis. Verifique se:

237 237 

238* Você está no macOS. Computer use na CLI não está disponível no Linux ou Windows. No Windows, use [computer use em Desktop](/pt/desktop#let-claude-use-your-computer) em vez disso.238* Você está no macOS. Computer use na CLI não está disponível no Linux ou Windows. No Windows, use [computer use em Desktop](/docs/pt/desktop#let-claude-use-your-computer) em vez disso.

239* Você está em um plano Pro ou Max. Execute `/status` para confirmar sua assinatura.239* Você está em um plano Pro ou Max. Execute `/status` para confirmar sua assinatura.

240* Você está autenticado através de claude.ai. Computer use não está disponível com provedores de terceiros como Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Se você acessar Claude exclusivamente através de um provedor de terceiros, você precisa de uma conta claude.ai separada para usar este recurso.240* Você está autenticado através de claude.ai. Computer use não está disponível com provedores de terceiros como Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Se você acessar Claude exclusivamente através de um provedor de terceiros, você precisa de uma conta claude.ai separada para usar este recurso.

241* Você está em uma sessão interativa. Computer use não está disponível em modo não interativo com a flag `-p`.241* Você está em uma sessão interativa. Computer use não está disponível em modo não interativo com a flag `-p`.


244 Veja também244 Veja também

245</h2>245</h2>

246 246 

247* [Computer use em Desktop](/pt/desktop#let-claude-use-your-computer): a mesma capacidade com uma página de configurações gráfica247* [Computer use em Desktop](/docs/pt/desktop#let-claude-use-your-computer): a mesma capacidade com uma página de configurações gráfica

248* [Claude no Chrome](/pt/chrome): automação de navegador para tarefas baseadas na web248* [Claude no Chrome](/docs/pt/chrome): automação de navegador para tarefas baseadas na web

249* [MCP](/pt/mcp): conecte Claude a ferramentas e APIs estruturadas249* [MCP](/docs/pt/mcp): conecte Claude a ferramentas e APIs estruturadas

250* [Sandboxing](/pt/sandboxing): como a ferramenta Bash de Claude isola o acesso ao sistema de arquivos e rede250* [Sandboxing](/docs/pt/sandboxing): como a ferramenta Bash de Claude isola o acesso ao sistema de arquivos e rede

251* [Guia de segurança do computer use](https://support.claude.com/en/articles/14128542): melhores práticas para uso seguro de computer use251* [Guia de segurança do computer use](https://support.claude.com/en/articles/14128542): melhores práticas para uso seguro de computer use

context-window.md +13 −13

Details

1578 1578 

1579A sessão percorre um fluxo realista com contagens de tokens representativas:1579A sessão percorre um fluxo realista com contagens de tokens representativas:

1580 1580 

1581* **Antes de você digitar qualquer coisa**: CLAUDE.md, memória automática, nomes de ferramentas MCP e descrições de skills são todos carregados no contexto. Sua própria configuração pode adicionar mais aqui, como um [estilo de saída](/pt/output-styles) ou texto de [`--append-system-prompt`](/pt/cli-reference), que ambos vão para o prompt do sistema da mesma forma.1581* **Antes de você digitar qualquer coisa**: CLAUDE.md, memória automática, nomes de ferramentas MCP e descrições de skills são todos carregados no contexto. Sua própria configuração pode adicionar mais aqui, como um [estilo de saída](/docs/pt/output-styles) ou texto de [`--append-system-prompt`](/docs/pt/cli-reference), que ambos vão para o prompt do sistema da mesma forma.

1582* **Conforme Claude trabalha**: cada leitura de arquivo adiciona ao contexto, [regras com escopo de caminho](/pt/memory#path-specific-rules) são carregadas automaticamente junto com arquivos correspondentes, e um [hook PostToolUse](/pt/hooks-guide) é acionado após cada edição.1582* **Conforme Claude trabalha**: cada leitura de arquivo adiciona ao contexto, [regras com escopo de caminho](/docs/pt/memory#path-specific-rules) são carregadas automaticamente junto com arquivos correspondentes, e um [hook PostToolUse](/docs/pt/hooks-guide) é acionado após cada edição.

1583* **O prompt de acompanhamento**: um [subagent](/pt/sub-agents) lida com a pesquisa em sua própria janela de contexto separada, então as leituras de arquivo grandes ficam fora da sua. Apenas o resumo e um pequeno trailer de metadados voltam.1583* **O prompt de acompanhamento**: um [subagent](/docs/pt/sub-agents) lida com a pesquisa em sua própria janela de contexto separada, então as leituras de arquivo grandes ficam fora da sua. Apenas o resumo e um pequeno trailer de metadados voltam.

1584* **No final**: `/compact` substitui a conversa por um resumo estruturado. A maioria do conteúdo de inicialização é recarregada automaticamente; a tabela abaixo mostra o que acontece com cada mecanismo.1584* **No final**: `/compact` substitui a conversa por um resumo estruturado. A maioria do conteúdo de inicialização é recarregada automaticamente; a tabela abaixo mostra o que acontece com cada mecanismo.

1585 1585 

1586<h2 id="what-survives-compaction">1586<h2 id="what-survives-compaction">

1587 O que sobrevive à compactação1587 O que sobrevive à compactação

1588</h2>1588</h2>

1589 1589 

1590Quando uma sessão longa é compactada, Claude Code resume o histórico de conversa para caber na janela de contexto. {/* min-version: 2.1.198 */}A partir da v2.1.198, a solicitação de resumo herda a configuração de [extended thinking](/pt/model-config#extended-thinking) da sua sessão, portanto ela raciocina com o thinking habilitado quando sua sessão o tem habilitado e permanece desativado caso contrário. O thinking afeta apenas como o resumo é produzido; suas configurações de sessão permanecem inalteradas depois. O que acontece com suas instruções depende de como foram carregadas:1590Quando uma sessão longa é compactada, Claude Code resume o histórico de conversa para caber na janela de contexto. A partir da v2.1.198, a solicitação de resumo herda a configuração de [extended thinking](/docs/pt/model-config#extended-thinking) da sua sessão, portanto ela raciocina com o thinking habilitado quando sua sessão o tem habilitado e permanece desativado caso contrário. O thinking afeta apenas como o resumo é produzido; suas configurações de sessão permanecem inalteradas depois. O que acontece com suas instruções depende de como foram carregadas:

1591 1591 

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

1593| :----------------------------------------------- | :---------------------------------------------------------------------------------------------------------------- |1593| :----------------------------------------------- | :---------------------------------------------------------------------------------------------------------------- |


1607 Quando sua janela de contexto se preenche1607 Quando sua janela de contexto se preenche

1608</h2>1608</h2>

1609 1609 

1610Claude Code faz compactação automática conforme você se aproxima do limite, então uma janela de contexto cheia não encerra sua sessão. A passagem automática funciona da mesma forma que a etapa `/compact` na linha do tempo. Veja [Quando o contexto se preenche](/pt/how-claude-code-works#when-context-fills-up) para o que ela preserva.1610Claude Code faz compactação automática conforme você se aproxima do limite, então uma janela de contexto cheia não encerra sua sessão. A passagem automática funciona da mesma forma que a etapa `/compact` na linha do tempo. Veja [Quando o contexto se preenche](/docs/pt/how-claude-code-works#when-context-fills-up) para o que ela preserva.

1611 1611 

1612Você também pode agir antes da passagem automática ser executada:1612Você também pode agir antes da passagem automática ser executada:

1613 1613 

1614* **Compacte com um foco**: execute `/compact` com instruções, como `/compact focus on the auth bug fix`, antes de iniciar uma tarefa longa nova. O resumo mantém o que você escolhe em vez do que a passagem automática acha que é importante.1614* **Compacte com um foco**: execute `/compact` com instruções, como `/compact focus on the auth bug fix`, antes de iniciar uma tarefa longa nova. O resumo mantém o que você escolhe em vez do que a passagem automática acha que é importante.

1615* **Limpe entre tarefas**: execute `/clear` ao mudar para trabalho não relacionado. Conversa antiga ocupa espaço dos arquivos que você precisa em seguida e custa tokens em cada mensagem.1615* **Limpe entre tarefas**: execute `/clear` ao mudar para trabalho não relacionado. Conversa antiga ocupa espaço dos arquivos que você precisa em seguida e custa tokens em cada mensagem.

1616* **Delegue leituras grandes**: envie pesquisa para um [subagent](/pt/sub-agents) para que o conteúdo do arquivo fique em sua janela de contexto, não na sua.1616* **Delegue leituras grandes**: envie pesquisa para um [subagent](/docs/pt/sub-agents) para que o conteúdo do arquivo fique em sua janela de contexto, não na sua.

1617 1617 

1618Se você precisar de uma janela maior em vez de uma conversa menor, Fable 5, Sonnet 5, Opus 4.6 e posteriores, e Sonnet 4.6 suportam uma janela de contexto de 1 milhão de tokens. Veja [Extended context](/pt/model-config#extended-context) para disponibilidade por plano e como selecionar uma variante de modelo `[1m]`. Sonnet 5 é executado em 1M sem variante `[1m]` para selecionar; veja [Sonnet 5 context window](/pt/model-config#sonnet-5-context-window) para seus limites de auto-compactação e a exceção do gateway LLM. A compactação funciona da mesma forma no limite maior.1618Se você precisar de uma janela maior em vez de uma conversa menor, Fable 5, Sonnet 5, Opus 4.6 e posteriores, e Sonnet 4.6 suportam uma janela de contexto de 1 milhão de tokens. Veja [Extended context](/docs/pt/model-config#extended-context) para disponibilidade por plano e como selecionar uma variante de modelo `[1m]`. Sonnet 5 é executado em 1M sem variante `[1m]` para selecionar; veja [Sonnet 5 context window](/docs/pt/model-config#sonnet-5-context-window) para seus limites de auto-compactação e a exceção do gateway LLM. A compactação funciona da mesma forma no limite maior.

1619 1619 

1620<h2 id="check-your-own-session">1620<h2 id="check-your-own-session">

1621 Verifique sua própria sessão1621 Verifique sua própria sessão


1629 1629 

1630Para cobertura mais profunda dos recursos mostrados na linha do tempo, veja estas páginas:1630Para cobertura mais profunda dos recursos mostrados na linha do tempo, veja estas páginas:

1631 1631 

1632* [Estenda Claude Code](/pt/features-overview): quando usar CLAUDE.md vs skills vs regras vs hooks vs MCP1632* [Estenda Claude Code](/docs/pt/features-overview): quando usar CLAUDE.md vs skills vs regras vs hooks vs MCP

1633* [Armazene instruções e memórias](/pt/memory): hierarquia CLAUDE.md e memória automática1633* [Armazene instruções e memórias](/docs/pt/memory): hierarquia CLAUDE.md e memória automática

1634* [Subagents](/pt/sub-agents): delegue pesquisa a uma janela de contexto separada1634* [Subagents](/docs/pt/sub-agents): delegue pesquisa a uma janela de contexto separada

1635* [Melhores práticas](/pt/best-practices): gerenciando contexto como sua restrição principal1635* [Melhores práticas](/docs/pt/best-practices): gerenciando contexto como sua restrição principal

1636* [Prompt caching](/pt/prompt-caching): quais ações invalidam o prefixo em cache1636* [Prompt caching](/docs/pt/prompt-caching): quais ações invalidam o prefixo em cache

1637* [Reduza o uso de tokens](/pt/costs#reduce-token-usage): estratégias para manter o uso de contexto baixo1637* [Reduza o uso de tokens](/docs/pt/costs#reduce-token-usage): estratégias para manter o uso de contexto baixo

Details

8 8 

9Quando Claude ignora uma instrução ou um recurso que você configurou não aparece, a causa geralmente é que o arquivo não foi carregado, foi carregado de um local diferente do esperado, ou outro arquivo o sobrescreveu. Este guia mostra como inspecionar o que Claude Code realmente carregou para que você possa estreitar qual se aplica.9Quando Claude ignora uma instrução ou um recurso que você configurou não aparece, a causa geralmente é que o arquivo não foi carregado, foi carregado de um local diferente do esperado, ou outro arquivo o sobrescreveu. Este guia mostra como inspecionar o que Claude Code realmente carregou para que você possa estreitar qual se aplica.

10 10 

11Para problemas de instalação, autenticação e conectividade, consulte [Troubleshooting installation and login](/pt/troubleshoot-install) em vez disso.11Para problemas de instalação, autenticação e conectividade, consulte [Troubleshooting installation and login](/docs/pt/troubleshoot-install) em vez disso.

12 12 

13<h2 id="see-what-loaded-into-context">13<h2 id="see-what-loaded-into-context">

14 Veja o que foi carregado no contexto14 Veja o que foi carregado no contexto


25| `/hooks` | Configurações de hook ativas |25| `/hooks` | Configurações de hook ativas |

26| `/mcp` | Servidores MCP conectados e seu status |26| `/mcp` | Servidores MCP conectados e seu status |

27| `/permissions` | Regras de permissão e negação resolvidas atualmente em vigor |27| `/permissions` | Regras de permissão e negação resolvidas atualmente em vigor |

28| `/doctor` | Diagnóstico de configuração: saúde da instalação, arquivos de configurações inválidos, extensões não utilizadas, nomes de [subagente](/pt/sub-agents) duplicados no mesmo diretório e conteúdo `CLAUDE.md` verificado que Claude pode derivar da base de código, com correções propostas |28| `/doctor` | Diagnóstico de configuração: saúde da instalação, arquivos de configurações inválidos, extensões não utilizadas, nomes de [subagente](/docs/pt/sub-agents) duplicados no mesmo diretório e conteúdo `CLAUDE.md` verificado que Claude pode derivar da base de código, com correções propostas |

29| `/debug [issue]` | Ativa o log de depuração para a sessão e solicita que Claude diagnostique usando a saída do log e caminhos de configurações |29| `/debug [issue]` | Ativa o log de depuração para a sessão e solicita que Claude diagnostique usando a saída do log e caminhos de configurações |

30| `/status` | Fontes de configurações ativas, incluindo se as configurações gerenciadas estão em vigor |30| `/status` | Fontes de configurações ativas, incluindo se as configurações gerenciadas estão em vigor |

31 31 

32Se um arquivo de memória estiver faltando em `/memory`, verifique sua localização em relação a [como os arquivos CLAUDE.md são carregados](/pt/memory#how-claude-md-files-load). Os arquivos `CLAUDE.md` do subdiretório são carregados sob demanda quando Claude lê um arquivo nesse diretório com a ferramenta Read, não no início da sessão.32Se um arquivo de memória estiver faltando em `/memory`, verifique sua localização em relação a [como os arquivos CLAUDE.md são carregados](/docs/pt/memory#how-claude-md-files-load). Os arquivos `CLAUDE.md` do subdiretório são carregados sob demanda quando Claude lê um arquivo nesse diretório com a ferramenta Read, não no início da sessão.

33 33 

34Se `/memory` confirmar que o arquivo foi carregado mas Claude ainda não está seguindo uma instrução particular, o problema provavelmente é como a instrução é escrita e não se foi carregada. CLAUDE.md funciona bem para o tipo de orientação que você daria a um novo colega de equipe, como convenções de projeto, comandos de compilação e onde os arquivos pertencem.34Se `/memory` confirmar que o arquivo foi carregado mas Claude ainda não está seguindo uma instrução particular, o problema provavelmente é como a instrução é escrita e não se foi carregada. CLAUDE.md funciona bem para o tipo de orientação que você daria a um novo colega de equipe, como convenções de projeto, comandos de compilação e onde os arquivos pertencem.

35 35 

36A aderência diminui quando uma instrução é vaga o suficiente para ser interpretada de várias maneiras, quando dois arquivos dão direções conflitantes, ou quando o arquivo cresceu o suficiente para que regras individuais recebam menos atenção. [Escreva instruções eficazes](/pt/memory#write-effective-instructions) cobre os padrões de especificidade, tamanho e estrutura que mantêm a aderência alta.36A aderência diminui quando uma instrução é vaga o suficiente para ser interpretada de várias maneiras, quando dois arquivos dão direções conflitantes, ou quando o arquivo cresceu o suficiente para que regras individuais recebam menos atenção. [Escreva instruções eficazes](/docs/pt/memory#write-effective-instructions) cobre os padrões de especificidade, tamanho e estrutura que mantêm a aderência alta.

37 37 

38<Note>38<Note>

39 CLAUDE.md e permissões resolvem problemas diferentes. CLAUDE.md diz a Claude como seu projeto funciona para que ele tome boas decisões. [Permissões](/pt/permissions) e [hooks](/pt/hooks) aplicam limites independentemente do que Claude decide. Use CLAUDE.md para "fazemos assim aqui". Use permissões ou hooks para limites de segurança e qualquer coisa que nunca deve acontecer, onde você precisa de uma garantia em vez de orientação.39 CLAUDE.md e permissões resolvem problemas diferentes. CLAUDE.md diz a Claude como seu projeto funciona para que ele tome boas decisões. [Permissões](/docs/pt/permissions) e [hooks](/docs/pt/hooks) aplicam limites independentemente do que Claude decide. Use CLAUDE.md para "fazemos assim aqui". Use permissões ou hooks para limites de segurança e qualquer coisa que nunca deve acontecer, onde você precisa de uma garantia em vez de orientação.

40</Note>40</Note>

41 41 

42<h2 id="check-resolved-settings">42<h2 id="check-resolved-settings">

43 Verifique as configurações resolvidas43 Verifique as configurações resolvidas

44</h2>44</h2>

45 45 

46As configurações se mesclam entre escopos gerenciados, de usuário, de projeto e locais. As configurações gerenciadas sempre vencem quando presentes. Entre o resto, o escopo mais próximo substitui o mais amplo na ordem local, depois projeto, depois usuário. Algumas configurações também podem ser definidas por sinalizadores de linha de comando ou [variáveis de ambiente](/pt/env-vars), que atuam como outra camada de substituição. Quando uma configuração não parece se aplicar, o valor que você definiu geralmente está sendo substituído por outro escopo ou uma variável de ambiente.46As configurações se mesclam entre escopos gerenciados, de usuário, de projeto e locais. As configurações gerenciadas sempre vencem quando presentes. Entre o resto, o escopo mais próximo substitui o mais amplo na ordem local, depois projeto, depois usuário. Algumas configurações também podem ser definidas por sinalizadores de linha de comando ou [variáveis de ambiente](/docs/pt/env-vars), que atuam como outra camada de substituição. Quando uma configuração não parece se aplicar, o valor que você definiu geralmente está sendo substituído por outro escopo ou uma variável de ambiente.

47 47 

48Execute `/doctor` para verificar sua configuração e instalação. Ele relata o que encontra, incluindo arquivos de configurações inválidos, instalações duplicadas, extensões não utilizadas e {/* min-version: 2.1.206 */}conteúdo de `CLAUDE.md` verificado que Claude pode derivar da base de código, depois propõe correções que aplica apenas após você confirmar. A verificação de corte de `CLAUDE.md` requer Claude Code v2.1.206 ou posterior. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos somente leitura e pressionar `f` enviava o relatório a Claude para corrigir.48Execute `/doctor` para verificar sua configuração e instalação. Ele relata o que encontra, incluindo arquivos de configurações inválidos, instalações duplicadas, extensões não utilizadas e conteúdo de `CLAUDE.md` verificado que Claude pode derivar da base de código, depois propõe correções que aplica apenas após você confirmar. A verificação de corte de `CLAUDE.md` requer Claude Code v2.1.206 ou posterior. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos somente leitura e pressionar `f` enviava o relatório a Claude para corrigir.

49 49 

50Do terminal, `claude doctor` imprime diagnósticos de instalação e configurações somente leitura sem iniciar uma sessão.50Do terminal, `claude doctor` imprime diagnósticos de instalação e configurações somente leitura sem iniciar uma sessão.

51 51 

52Execute `/status` para ver quais fontes de configurações estão ativas, incluindo se as configurações gerenciadas estão em vigor. Para entender qual escopo vence para uma chave específica, consulte [Como os escopos interagem](/pt/settings#how-scopes-interact).52Execute `/status` para ver quais fontes de configurações estão ativas, incluindo se as configurações gerenciadas estão em vigor. Para entender qual escopo vence para uma chave específica, consulte [Como os escopos interagem](/docs/pt/settings#how-scopes-interact).

53 53 

54<h2 id="check-mcp-servers">54<h2 id="check-mcp-servers">

55 Verifique os servidores MCP55 Verifique os servidores MCP


61* Um servidor que falha ao iniciar aparece como falho em `/mcp`. Caminhos de arquivo relativos em `command` ou `args` são uma causa frequente, pois são resolvidos em relação ao diretório de onde você iniciou Claude Code em vez da localização de `.mcp.json`.61* Um servidor que falha ao iniciar aparece como falho em `/mcp`. Caminhos de arquivo relativos em `command` ou `args` são uma causa frequente, pois são resolvidos em relação ao diretório de onde você iniciou Claude Code em vez da localização de `.mcp.json`.

62* Um servidor que aparece como conectado mas lista zero ferramentas iniciou com sucesso mas não está retornando uma lista de ferramentas. Selecione **Reconnect** em `/mcp`. Se a contagem permanecer em zero, execute `claude --debug mcp` para ver a saída stderr do servidor.62* Um servidor que aparece como conectado mas lista zero ferramentas iniciou com sucesso mas não está retornando uma lista de ferramentas. Selecione **Reconnect** em `/mcp`. Se a contagem permanecer em zero, execute `claude --debug mcp` para ver a saída stderr do servidor.

63 63 

64Para localizações de configuração e regras de escopo, consulte [MCP](/pt/mcp).64Para localizações de configuração e regras de escopo, consulte [MCP](/docs/pt/mcp).

65 65 

66<h2 id="check-hooks">66<h2 id="check-hooks">

67 Verifique hooks67 Verifique hooks


71 71 

72Se o hook aparecer mas não disparar, o matcher é a causa usual. Verifique-o para estes erros:72Se o hook aparecer mas não disparar, o matcher é a causa usual. Verifique-o para estes erros:

73 73 

74* O campo `matcher` é uma única string que usa `|` para corresponder a vários nomes de ferramentas, por exemplo `"Edit|Write"`. {/* min-version: 2.1.191 */}Um separador `,` é equivalente, então `"Edit,Write"` corresponde às mesmas ferramentas. Antes da v2.1.191, uma vírgula passava para avaliação de regex e o matcher nunca correspondia, então use `|` se você não estiver na v2.1.191 ainda.74* O campo `matcher` é uma única string que usa `|` para corresponder a vários nomes de ferramentas, por exemplo `"Edit|Write"`. Um separador `,` é equivalente, então `"Edit,Write"` corresponde às mesmas ferramentas. Antes da v2.1.191, uma vírgula passava para avaliação de regex e o matcher nunca correspondia, então use `|` se você não estiver na v2.1.191 ainda.

75* Um nome de ferramenta digitado incorretamente produz um matcher que não corresponde a nada, então o hook falha silenciosamente.75* Um nome de ferramenta digitado incorretamente produz um matcher que não corresponde a nada, então o hook falha silenciosamente.

76* Um valor de array é um erro de schema: Claude Code mostra um aviso de erro de configurações e rejeita o arquivo de configurações do usuário, projeto ou local inteiro, `claude doctor` relata a falha de validação, e nenhum hook desse arquivo aparece em `/hooks`. Em [configurações gerenciadas](/pt/settings#settings-files), apenas a entrada inválida é removida e os outros hooks do arquivo ainda se aplicam.76* Um valor de array é um erro de schema: Claude Code mostra um aviso de erro de configurações e rejeita o arquivo de configurações do usuário, projeto ou local inteiro, `claude doctor` relata a falha de validação, e nenhum hook desse arquivo aparece em `/hooks`. Em [configurações gerenciadas](/docs/pt/settings#settings-files), apenas a entrada inválida é removida e os outros hooks do arquivo ainda se aplicam.

77 77 

78As edições em `settings.json` entram em vigor na sessão em execução após um breve atraso de estabilidade de arquivo. Você não precisa reiniciar. Se `/hooks` ainda mostrar a definição antiga alguns segundos após salvar, execute `/hooks` novamente para atualizar a visualização.78As edições em `settings.json` entram em vigor na sessão em execução após um breve atraso de estabilidade de arquivo. Você não precisa reiniciar. Se `/hooks` ainda mostrar a definição antiga alguns segundos após salvar, execute `/hooks` novamente para atualizar a visualização.

79 79 

80Se `/hooks` mostrar o hook mas ele ainda não disparar, o próximo passo é observar a avaliação do hook ao vivo. Inicie uma sessão com `claude --debug hooks` e dispare a chamada de ferramenta. O log de depuração registra cada evento, quais matchers foram verificados, e o código de saída e saída do hook. Consulte [Debug hooks](/pt/hooks#debug-hooks) para o formato do log e [troubleshooting de hooks](/pt/hooks-guide#limitations-and-troubleshooting) para padrões de falha comuns.80Se `/hooks` mostrar o hook mas ele ainda não disparar, o próximo passo é observar a avaliação do hook ao vivo. Inicie uma sessão com `claude --debug hooks` e dispare a chamada de ferramenta. O log de depuração registra cada evento, quais matchers foram verificados, e o código de saída e saída do hook. Consulte [Debug hooks](/docs/pt/hooks#debug-hooks) para o formato do log e [troubleshooting de hooks](/docs/pt/hooks-guide#limitations-and-troubleshooting) para padrões de falha comuns.

81 81 

82<h2 id="test-against-a-clean-configuration">82<h2 id="test-against-a-clean-configuration">

83 Teste contra uma configuração limpa83 Teste contra uma configuração limpa

84</h2>84</h2>

85 85 

86{/* min-version: 2.1.169 */}Comece com [`claude --safe-mode`](/pt/cli-reference#cli-flags), que inicia uma sessão com todas as personalizações desabilitadas, incluindo `CLAUDE.md`, skills, plugins, hooks, servidores MCP e comandos e agentes personalizados. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente. Se o problema desaparecer no modo seguro, uma dessas superfícies é a causa; use as verificações direcionadas acima para descobrir qual. O modo seguro ainda aplica hooks gerenciados e política de configurações da sua organização. Plugins gerenciados, skills, `CLAUDE.md` e servidores MCP são desativados.86Comece com [`claude --safe-mode`](/docs/pt/cli-reference#cli-flags), que inicia uma sessão com todas as personalizações desabilitadas, incluindo `CLAUDE.md`, skills, plugins, hooks, servidores MCP e comandos e agentes personalizados. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente. Se o problema desaparecer no modo seguro, uma dessas superfícies é a causa; use as verificações direcionadas acima para descobrir qual. O modo seguro ainda aplica hooks gerenciados e política de configurações da sua organização. Plugins gerenciados, skills, `CLAUDE.md` e servidores MCP são desativados.

87 87 

88Se o problema persistir no modo seguro, ou suas configurações em si forem suspeitas, compare contra uma sessão que não carrega nada de sua configuração usual. Aponte [`CLAUDE_CONFIG_DIR`](/pt/env-vars) para um diretório vazio para contornar tudo sob `~/.claude` e inicie a partir de um diretório que não tenha pasta `.claude`, `.mcp.json` ou `CLAUDE.md` para que a configuração do projeto também seja ignorada.88Se o problema persistir no modo seguro, ou suas configurações em si forem suspeitas, compare contra uma sessão que não carrega nada de sua configuração usual. Aponte [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) para um diretório vazio para contornar tudo sob `~/.claude` e inicie a partir de um diretório que não tenha pasta `.claude`, `.mcp.json` ou `CLAUDE.md` para que a configuração do projeto também seja ignorada.

89 89 

90```bash theme={null}90```bash theme={null}

91cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude91cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude


97* No Linux e Windows, você será solicitado a fazer login novamente porque as credenciais são armazenadas sob o diretório de configuração97* No Linux e Windows, você será solicitado a fazer login novamente porque as credenciais são armazenadas sob o diretório de configuração

98* No macOS, as credenciais estão no Keychain e são transferidas para a sessão limpa98* No macOS, as credenciais estão no Keychain e são transferidas para a sessão limpa

99 99 

100Se o problema desaparecer aqui, a causa está em algum lugar em seus arquivos reais `~/.claude` ou `.claude` do projeto. Reintroduza-os um de cada vez, copiando arquivos para o diretório temporário ou iniciando a partir de seu projeto, para encontrar qual. Se persistir na sessão limpa, a causa está fora de sua configuração de usuário e projeto. Execute `/status` para verificar se as configurações gerenciadas estão em vigor, procure por [variáveis de ambiente](/pt/env-vars) que afetam Claude Code e consulte [Solução de problemas](/pt/troubleshooting).100Se o problema desaparecer aqui, a causa está em algum lugar em seus arquivos reais `~/.claude` ou `.claude` do projeto. Reintroduza-os um de cada vez, copiando arquivos para o diretório temporário ou iniciando a partir de seu projeto, para encontrar qual. Se persistir na sessão limpa, a causa está fora de sua configuração de usuário e projeto. Execute `/status` para verificar se as configurações gerenciadas estão em vigor, procure por [variáveis de ambiente](/docs/pt/env-vars) que afetam Claude Code e consulte [Solução de problemas](/docs/pt/troubleshooting).

101 101 

102<h2 id="check-common-causes">102<h2 id="check-common-causes">

103 Verifique as causas comuns103 Verifique as causas comuns


107 107 

108| Sintoma | Causa | Correção |108| Sintoma | Causa | Correção |

109| :---------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |109| :---------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

110| Hook nunca dispara | `matcher` é um array JSON em vez de uma string | Use uma única string com `\|` para corresponder a várias ferramentas, por exemplo `"Edit\|Write"`. Consulte [padrões de matcher](/pt/hooks#matcher-patterns). |110| Hook nunca dispara | `matcher` é um array JSON em vez de uma string | Use uma única string com `\|` para corresponder a várias ferramentas, por exemplo `"Edit\|Write"`. Consulte [padrões de matcher](/docs/pt/hooks#matcher-patterns). |

111| Hook nunca dispara | `matcher` usa `,` como separador em uma versão anterior a v2.1.191 | {/* min-version: 2.1.191 */}Claude Code v2.1.191 ou posterior trata `,` como um separador de lista como `\|`. Versões anteriores avaliam uma vírgula como um caractere literal, então `"Edit,Write"` não corresponde a nada. Use `\|` em vez disso, ou atualize Claude Code. |111| Hook nunca dispara | `matcher` usa `,` como separador em uma versão anterior a v2.1.191 | Claude Code v2.1.191 ou posterior trata `,` como um separador de lista como `\|`. Versões anteriores avaliam uma vírgula como um caractere literal, então `"Edit,Write"` não corresponde a nada. Use `\|` em vez disso, ou atualize Claude Code. |

112| Hook nunca dispara | O valor de `matcher` está em minúsculas, por exemplo `"bash"` | A correspondência diferencia maiúsculas de minúsculas. Os nomes das ferramentas são capitalizados: `Bash`, `Edit`, `Write`, `Read`. |112| Hook nunca dispara | O valor de `matcher` está em minúsculas, por exemplo `"bash"` | A correspondência diferencia maiúsculas de minúsculas. Os nomes das ferramentas são capitalizados: `Bash`, `Edit`, `Write`, `Read`. |

113| Hook nunca dispara | Hooks estão definidos em um arquivo autônomo em vez de em `settings.json` | Não há arquivo de hooks autônomo para configuração de projeto ou usuário. Defina hooks sob a chave `"hooks"` em `settings.json`. Apenas [plugins](/pt/plugins-reference#hooks) carregam um `hooks/hooks.json` separado. Consulte [configuração de hook](/pt/hooks). |113| Hook nunca dispara | Hooks estão definidos em um arquivo autônomo em vez de em `settings.json` | Não há arquivo de hooks autônomo para configuração de projeto ou usuário. Defina hooks sob a chave `"hooks"` em `settings.json`. Apenas [plugins](/docs/pt/plugins-reference#hooks) carregam um `hooks/hooks.json` separado. Consulte [configuração de hook](/docs/pt/hooks). |

114| Permissões, hooks ou env definidos globalmente são ignorados | A configuração foi adicionada a `~/.claude.json` | `~/.claude.json` contém estado do aplicativo e alternâncias de UI. `permissions`, `hooks` e `env` pertencem a `~/.claude/settings.json`. Estes são dois arquivos diferentes. |114| Permissões, hooks ou env definidos globalmente são ignorados | A configuração foi adicionada a `~/.claude.json` | `~/.claude.json` contém estado do aplicativo e alternâncias de UI. `permissions`, `hooks` e `env` pertencem a `~/.claude/settings.json`. Estes são dois arquivos diferentes. |

115| Um valor de `settings.json` parece ser ignorado | A mesma chave está definida em `settings.local.json` | `settings.local.json` substitui `settings.json`, e ambos substituem `~/.claude/settings.json`. Consulte [precedência de configurações](/pt/settings#how-scopes-interact). |115| Um valor de `settings.json` parece ser ignorado | A mesma chave está definida em `settings.local.json` | `settings.local.json` substitui `settings.json`, e ambos substituem `~/.claude/settings.json`. Consulte [precedência de configurações](/docs/pt/settings#how-scopes-interact). |

116| Skill não aparece em `/skills` | O arquivo de skill está em `.claude/skills/name.md` em vez de em uma pasta | Use uma pasta com `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |116| Skill não aparece em `/skills` | O arquivo de skill está em `.claude/skills/name.md` em vez de em uma pasta | Use uma pasta com `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |

117| Skill aparece em `/skills` mas Claude nunca o invoca | Skill tem `disable-model-invocation: true` em seu frontmatter, ou sua descrição não corresponde a como você frasa a solicitação | Verifique o badge em `/skills`: um rótulo "user-only" significa que Claude não o acionará por conta própria. Consulte [invocação de skill](/pt/skills). |117| Skill aparece em `/skills` mas Claude nunca o invoca | Skill tem `disable-model-invocation: true` em seu frontmatter, ou sua descrição não corresponde a como você frasa a solicitação | Verifique o badge em `/skills`: um rótulo "user-only" significa que Claude não o acionará por conta própria. Consulte [invocação de skill](/docs/pt/skills). |

118| As instruções de `CLAUDE.md` do subdiretório parecem ser ignoradas | Os arquivos do subdiretório são carregados sob demanda, não no início da sessão | Eles são carregados quando Claude lê um arquivo nesse diretório com a ferramenta Read, não no lançamento e não ao escrever ou criar arquivos lá. Consulte [como os arquivos CLAUDE.md são carregados](/pt/memory#how-claude-md-files-load). |118| As instruções de `CLAUDE.md` do subdiretório parecem ser ignoradas | Os arquivos do subdiretório são carregados sob demanda, não no início da sessão | Eles são carregados quando Claude lê um arquivo nesse diretório com a ferramenta Read, não no lançamento e não ao escrever ou criar arquivos lá. Consulte [como os arquivos CLAUDE.md são carregados](/docs/pt/memory#how-claude-md-files-load). |

119| Subagente ignora as instruções de `CLAUDE.md` | Os agentes Explore e Plan integrados pulam `CLAUDE.md`. Subagentes personalizados o carregam da mesma forma que a conversa principal | Para Explore ou Plan, reafirme a instrução em seu prompt de delegação. Para um subagente personalizado, coloque instruções críticas no corpo do arquivo do agente, que se torna o prompt do sistema do agente. Consulte [o que é carregado na inicialização](/pt/sub-agents#what-loads-at-startup). |119| Subagente ignora as instruções de `CLAUDE.md` | Os agentes Explore e Plan integrados pulam `CLAUDE.md`. Subagentes personalizados o carregam da mesma forma que a conversa principal | Para Explore ou Plan, reafirme a instrução em seu prompt de delegação. Para um subagente personalizado, coloque instruções críticas no corpo do arquivo do agente, que se torna o prompt do sistema do agente. Consulte [o que é carregado na inicialização](/docs/pt/sub-agents#what-loads-at-startup). |

120| A lógica de limpeza nunca é executada no final da sessão | Nenhum hook `SessionEnd` configurado | Adicione um hook `SessionEnd` em `settings.json`. Consulte a [lista de eventos de hook](/pt/hooks#hook-events). |120| A lógica de limpeza nunca é executada no final da sessão | Nenhum hook `SessionEnd` configurado | Adicione um hook `SessionEnd` em `settings.json`. Consulte a [lista de eventos de hook](/docs/pt/hooks#hook-events). |

121| Servidores MCP em `.mcp.json` nunca são carregados | O arquivo está sob `.claude/` ou usa o formato de configuração do Claude Desktop | A configuração MCP do projeto vai na raiz do repositório como `.mcp.json`, não dentro de `.claude/`. Consulte [configuração MCP](/pt/mcp). |121| Servidores MCP em `.mcp.json` nunca são carregados | O arquivo está sob `.claude/` ou usa o formato de configuração do Claude Desktop | A configuração MCP do projeto vai na raiz do repositório como `.mcp.json`, não dentro de `.claude/`. Consulte [configuração MCP](/docs/pt/mcp). |

122| Servidores MCP adicionados sob `mcpServers` em `settings.json` nunca aparecem | `settings.json` não lê uma chave `mcpServers` | Defina servidores de projeto em `.mcp.json` na raiz do repositório, ou execute `claude mcp add --scope user` para servidores com escopo de usuário. Consulte [configuração MCP](/pt/mcp). |122| Servidores MCP adicionados sob `mcpServers` em `settings.json` nunca aparecem | `settings.json` não lê uma chave `mcpServers` | Defina servidores de projeto em `.mcp.json` na raiz do repositório, ou execute `claude mcp add --scope user` para servidores com escopo de usuário. Consulte [configuração MCP](/docs/pt/mcp). |

123| Servidor MCP do projeto adicionado mas não aparece | O prompt de aprovação única foi descartado | Servidores com escopo de projeto requerem aprovação. Execute `/mcp` para ver o status e aprovar. |123| Servidor MCP do projeto adicionado mas não aparece | O prompt de aprovação única foi descartado | Servidores com escopo de projeto requerem aprovação. Execute `/mcp` para ver o status e aprovar. |

124| Servidor MCP falha ao iniciar de alguns diretórios | `command` ou `args` usa um caminho de arquivo relativo | Use caminhos absolutos para scripts locais. Executáveis em seu `PATH` como `npx` ou `uvx` funcionam como estão. |124| Servidor MCP falha ao iniciar de alguns diretórios | `command` ou `args` usa um caminho de arquivo relativo | Use caminhos absolutos para scripts locais. Executáveis em seu `PATH` como `npx` ou `uvx` funcionam como estão. |

125| Servidor MCP inicia sem variáveis de ambiente esperadas | As variáveis estão em `settings.json` `env`, que não se propaga para processos filhos MCP | Defina `env` por servidor dentro de `.mcp.json` em vez disso. |125| Servidor MCP inicia sem variáveis de ambiente esperadas | As variáveis estão em `settings.json` `env`, que não se propaga para processos filhos MCP | Defina `env` por servidor dentro de `.mcp.json` em vez disso. |

126| A regra de negação `Bash(rm *)` não bloqueia `/bin/rm` ou `find -delete` | As regras de prefixo correspondem à string de comando literal, não ao executável subjacente | Adicione padrões explícitos para cada variante, ou use um [hook PreToolUse](/pt/hooks-guide) ou o [sandbox](/pt/sandboxing) para uma garantia difícil. |126| A regra de negação `Bash(rm *)` não bloqueia `/bin/rm` ou `find -delete` | As regras de prefixo correspondem à string de comando literal, não ao executável subjacente | Adicione padrões explícitos para cada variante, ou use um [hook PreToolUse](/docs/pt/hooks-guide) ou o [sandbox](/docs/pt/sandboxing) para uma garantia difícil. |

127 127 

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

129 Recursos relacionados129 Recursos relacionados


131 131 

132Para referência completa em cada superfície de configuração, consulte a página dedicada:132Para referência completa em cada superfície de configuração, consulte a página dedicada:

133 133 

134* **[Referência do diretório `.claude`](/pt/claude-directory)**: cada localização de arquivo de configuração e o que o lê134* **[Referência do diretório `.claude`](/docs/pt/claude-directory)**: cada localização de arquivo de configuração e o que o lê

135* **[Configurações](/pt/settings)**: ordem de precedência e a lista completa de chaves135* **[Configurações](/docs/pt/settings)**: ordem de precedência e a lista completa de chaves

136* **[Referência de hooks](/pt/hooks)**: nomes de eventos, payloads e formato de saída `--debug hooks`136* **[Referência de hooks](/docs/pt/hooks)**: nomes de eventos, payloads e formato de saída `--debug hooks`

137* **[MCP](/pt/mcp)**: configuração de servidor, aprovação e saída `/mcp`137* **[MCP](/docs/pt/mcp)**: configuração de servidor, aprovação e saída `/mcp`

138* **[Solucionar problemas de instalação e login](/pt/troubleshoot-install)**: `comando não encontrado`, PATH e problemas de autenticação138* **[Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install)**: `comando não encontrado`, PATH e problemas de autenticação

139* **[Solução de problemas](/pt/troubleshooting)**: desempenho, travamentos e problemas de busca139* **[Solução de problemas](/docs/pt/troubleshooting)**: desempenho, travamentos e problemas de busca

desktop.md +72 −72

Details

17 For x64 processors17 For x64 processors

18 </Card>18 </Card>

19 19 

20 <Card title="Get Claude for Linux (beta)" icon="linux" href="/en/desktop-linux">20 <Card title="Get Claude for Linux (beta)" icon="linux" href="/docs/en/desktop-linux">

21 apt or .deb for Ubuntu and Debian21 apt or .deb for Ubuntu and Debian

22 </Card>22 </Card>

23</CardGroup>23</CardGroup>

24 24 

25For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). On Linux, install with apt; see [Claude Desktop on Linux](/en/desktop-linux).25For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). On Linux, install with apt; see [Claude Desktop on Linux](/docs/en/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](/pt/desktop-quickstart).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).

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

30 30 


36* Permitir que Claude [abra aplicativos e controle sua tela](#let-claude-use-your-computer)36* Permitir que Claude [abra aplicativos e controle sua tela](#let-claude-use-your-computer)

37* Executar em sua máquina, na [nuvem](#run-long-running-tasks-remotely), ou sobre [SSH](#ssh-sessions)37* Executar em sua máquina, na [nuvem](#run-long-running-tasks-remotely), ou sobre [SSH](#ssh-sessions)

38 38 

39Para [trabalho recorrente agendado](/pt/desktop-scheduled-tasks), [atalhos de teclado](#keyboard-shortcuts), ou [envio de tarefas do seu telefone](#sessions-from-dispatch), consulte as páginas e seções vinculadas. Se você já usa o CLI baseado em terminal, consulte a [comparação CLI](#coming-from-the-cli) para ver o que é transferido.39Para [trabalho recorrente agendado](/docs/pt/desktop-scheduled-tasks), [atalhos de teclado](#keyboard-shortcuts), ou [envio de tarefas do seu telefone](#sessions-from-dispatch), consulte as páginas e seções vinculadas. Se você já usa o CLI baseado em terminal, consulte a [comparação CLI](#coming-from-the-cli) para ver o que é transferido.

40 40 

41<h2 id="start-a-session">41<h2 id="start-a-session">

42 Iniciar uma sessão42 Iniciar uma sessão


44 44 

45Antes de enviar sua primeira mensagem, configure quatro coisas na área de prompt:45Antes de enviar sua primeira mensagem, configure quatro coisas na área de prompt:

46 46 

47* **Ambiente**: escolha onde Claude é executado. Selecione **Local** para sua máquina, **Remote** para sessões em nuvem hospedadas pela Anthropic, uma [**conexão SSH**](#ssh-sessions) para uma máquina remota que você gerencia, ou no Windows uma [**distribuição WSL**](/pt/desktop-wsl). Veja [configuração de ambiente](#environment-configuration).47* **Ambiente**: escolha onde Claude é executado. Selecione **Local** para sua máquina, **Remote** para sessões em nuvem hospedadas pela Anthropic, uma [**conexão SSH**](#ssh-sessions) para uma máquina remota que você gerencia, ou no Windows uma [**distribuição WSL**](/docs/pt/desktop-wsl). Veja [configuração de ambiente](#environment-configuration).

48* **Pasta do projeto**: selecione a pasta ou repositório em que Claude trabalha. Para sessões remotas, você pode adicionar [múltiplos repositórios](#run-long-running-tasks-remotely).48* **Pasta do projeto**: selecione a pasta ou repositório em que Claude trabalha. Para sessões remotas, você pode adicionar [múltiplos repositórios](#run-long-running-tasks-remotely).

49* **Modelo**: escolha um [modelo](/pt/model-config#available-models) no menu suspenso ao lado do botão enviar. Você pode alterar isso durante a sessão.49* **Modelo**: escolha um [modelo](/docs/pt/model-config#available-models) no menu suspenso ao lado do botão enviar. Você pode alterar isso durante a sessão.

50* **Modo de permissão**: escolha quanto de autonomia Claude tem no [seletor de modo](#choose-a-permission-mode). Você pode alterar isso durante a sessão.50* **Modo de permissão**: escolha quanto de autonomia Claude tem no [seletor de modo](#choose-a-permission-mode). Você pode alterar isso durante a sessão.

51 51 

52Digite sua tarefa e pressione **Enter** para começar. Cada sessão rastreia seu próprio contexto e alterações independentemente.52Digite sua tarefa e pressione **Enter** para começar. Cada sessão rastreia seu próprio contexto e alterações independentemente.


80 80 

81Os modos de permissão controlam quanto de autonomia Claude tem durante uma sessão: se ele pergunta antes de editar arquivos, executar comandos ou ambos. Você pode alternar modos a qualquer momento usando o seletor de modo ao lado do botão enviar. Comece com Manual para ver exatamente o que Claude faz, depois mude para Accept edits ou Plan conforme você fica confortável.81Os modos de permissão controlam quanto de autonomia Claude tem durante uma sessão: se ele pergunta antes de editar arquivos, executar comandos ou ambos. Você pode alternar modos a qualquer momento usando o seletor de modo ao lado do botão enviar. Comece com Manual para ver exatamente o que Claude faz, depois mude para Accept edits ou Plan conforme você fica confortável.

82 82 

83Para definir um modo padrão para novas sessões locais, adicione `permissions.defaultMode` ao seu [arquivo de configurações](/pt/settings#settings-files). O aplicativo desktop lê os mesmos arquivos de configurações que o CLI. Um modo que você escolhe no seletor é lembrado por pasta e tem precedência sobre `defaultMode` para essa pasta, exceto Plan, que se aplica apenas à sessão atual.83Para definir um modo padrão para novas sessões locais, adicione `permissions.defaultMode` ao seu [arquivo de configurações](/docs/pt/settings#settings-files). O aplicativo desktop lê os mesmos arquivos de configurações que o CLI. Um modo que você escolhe no seletor é lembrado por pasta e tem precedência sobre `defaultMode` para essa pasta, exceto Plan, que se aplica apenas à sessão atual.

84 84 

85| Modo | Chave de configuração | Comportamento |85| Modo | Chave de configuração | Comportamento |

86| ---------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |86| ---------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |


88| **Accept edits** | `acceptEdits` | Claude aceita automaticamente edições de arquivo e comandos comuns do sistema de arquivos como `mkdir`, `touch` e `mv`, mas ainda pergunta antes de executar outros comandos de terminal. Use isso quando você confia em alterações de arquivo e quer iteração mais rápida. |88| **Accept edits** | `acceptEdits` | Claude aceita automaticamente edições de arquivo e comandos comuns do sistema de arquivos como `mkdir`, `touch` e `mv`, mas ainda pergunta antes de executar outros comandos de terminal. Use isso quando você confia em alterações de arquivo e quer iteração mais rápida. |

89| **Plan** | `plan` | Claude lê arquivos e executa comandos para explorar, depois propõe um plano sem editar seu código-fonte. Bom para tarefas complexas onde você quer revisar a abordagem primeiro. |89| **Plan** | `plan` | Claude lê arquivos e executa comandos para explorar, depois propõe um plano sem editar seu código-fonte. Bom para tarefas complexas onde você quer revisar a abordagem primeiro. |

90| **Auto** | `auto` | Claude executa todas as ações com verificações de segurança em segundo plano que verificam o alinhamento com sua solicitação. Reduz prompts de permissão mantendo supervisão. Aparece quando sua conta atende aos [requisitos de disponibilidade](#auto-mode-availability) abaixo; não há toggle de Configurações separado para isso. |90| **Auto** | `auto` | Claude executa todas as ações com verificações de segurança em segundo plano que verificam o alinhamento com sua solicitação. Reduz prompts de permissão mantendo supervisão. Aparece quando sua conta atende aos [requisitos de disponibilidade](#auto-mode-availability) abaixo; não há toggle de Configurações separado para isso. |

91| **Bypass permissions** | `bypassPermissions` | Claude é executado sem prompts de permissão, exceto aqueles forçados por [regras de solicitação](/pt/permissions#manage-permissions) explícitas, ferramentas de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools), ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool), ou classificadores de segurança quando Claude [atua em sites externos](#browse-external-sites); equivalente a `--dangerously-skip-permissions` no CLI. Em planos Pro e Max, ative em suas Configurações → Claude Code em "Allow bypass permissions mode"; em planos Team e Enterprise não há toggle de Configurações, e a política organizacional controla isso. Use apenas em containers ou VMs sandboxed. |91| **Bypass permissions** | `bypassPermissions` | Claude é executado sem prompts de permissão, exceto aqueles forçados por [regras de solicitação](/docs/pt/permissions#manage-permissions) explícitas, ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool), ou classificadores de segurança quando Claude [atua em sites externos](#browse-external-sites); equivalente a `--dangerously-skip-permissions` no CLI. Em planos Pro e Max, ative em suas Configurações → Claude Code em "Allow bypass permissions mode"; em planos Team e Enterprise não há toggle de Configurações, e a política organizacional controla isso. Use apenas em containers ou VMs sandboxed. |

92 92 

93Versões anteriores da aba Code rotulavam esses modos como Ask permissions, Auto accept edits e Plan mode.93Versões anteriores da aba Code rotulavam esses modos como Ask permissions, Auto accept edits e Plan mode.

94 94 

95O modo de permissão `dontAsk` está disponível apenas no [CLI](/pt/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).95O modo de permissão `dontAsk` está disponível apenas no [CLI](/docs/pt/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).

96 96 

97<span id="auto-mode-availability" />97<span id="auto-mode-availability" />

98 98 

99Auto mode está disponível para todos os usuários na API Anthropic e requer Claude Opus 4.6 ou posterior, ou Sonnet 4.6 ou posterior. Em implantações Enterprise que roteiam Desktop para Google Cloud's Agent Platform, auto mode está [disponível por padrão](/pt/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), e apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8 são suportados lá. {/* min-version: 2.1.207 */}Antes de Claude Code v2.1.207, implantações Enterprise no Google Cloud's Agent Platform tinham que definir `CLAUDE_CODE_ENABLE_AUTO_MODE` para ativar auto mode.99Auto mode está disponível para todos os usuários na API Anthropic e requer Claude Opus 4.6 ou posterior, ou Sonnet 4.6 ou posterior. Em implantações Enterprise que roteiam Desktop para Google Cloud's Agent Platform, auto mode está [disponível por padrão](/docs/pt/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), e apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8 são suportados lá. Antes de Claude Code v2.1.207, implantações Enterprise no Google Cloud's Agent Platform tinham que definir `CLAUDE_CODE_ENABLE_AUTO_MODE` para ativar auto mode.

100 100 

101<Tip title="Melhor prática">101<Tip title="Melhor prática">

102 Comece tarefas complexas em Plan para que Claude mapeie uma abordagem antes de fazer alterações. Depois de aprovar o plano, mude para Accept edits ou Manual para executá-lo. Veja [explorar primeiro, depois planejar, depois codificar](/pt/best-practices#explore-first-then-plan-then-code) para mais sobre esse fluxo de trabalho.102 Comece tarefas complexas em Plan para que Claude mapeie uma abordagem antes de fazer alterações. Depois de aprovar o plano, mude para Accept edits ou Manual para executá-lo. Veja [explorar primeiro, depois planejar, depois codificar](/docs/pt/best-practices#explore-first-then-plan-then-code) para mais sobre esse fluxo de trabalho.

103</Tip>103</Tip>

104 104 

105Sessões na nuvem suportam Accept edits, Plan e Auto. Accept edits corresponde ao modo `default`: sessões na nuvem pré-aprovam edições de arquivo, então o seletor mostra Accept edits em vez de Manual. Bypass permissions não está disponível porque o ambiente na nuvem já é sandboxed.105Sessões na nuvem suportam Accept edits, Plan e Auto. Accept edits corresponde ao modo `default`: sessões na nuvem pré-aprovam edições de arquivo, então o seletor mostra Accept edits em vez de Manual. Bypass permissions não está disponível porque o ambiente na nuvem já é sandboxed.


143 143 

144A primeira vez que Claude atua em um site externo, um cartão de permissão aparece e Claude aguarda sua escolha: **Allow once**, **Always allow** ou **Deny**. **Allow once** aprova a ação sem salvar nada. **Always allow** salva a aprovação para esse site em seu dispositivo, e você pode revogá-la em Configurações. Cada site precisa de sua própria aprovação, incluindo subdomínios. Seus servidores dev locais e arquivos de projeto não precisam de aprovação, então [auto-verify](#auto-verify-changes) continua funcionando sem prompts.144A primeira vez que Claude atua em um site externo, um cartão de permissão aparece e Claude aguarda sua escolha: **Allow once**, **Always allow** ou **Deny**. **Allow once** aprova a ação sem salvar nada. **Always allow** salva a aprovação para esse site em seu dispositivo, e você pode revogá-la em Configurações. Cada site precisa de sua própria aprovação, incluindo subdomínios. Seus servidores dev locais e arquivos de projeto não precisam de aprovação, então [auto-verify](#auto-verify-changes) continua funcionando sem prompts.

145 145 

146Mesmo em um site aprovado, Claude não comprará itens, criará contas ou contornará CAPTCHAs sem sua entrada. Navegar no painel de navegador usa o mesmo modelo de segurança que a [extensão Claude no Chrome](/pt/chrome). Veja [Usando Claude no Chrome com segurança](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) para como Claude lida com sites sensíveis e ações arriscadas.146Mesmo em um site aprovado, Claude não comprará itens, criará contas ou contornará CAPTCHAs sem sua entrada. Navegar no painel de navegador usa o mesmo modelo de segurança que a [extensão Claude no Chrome](/docs/pt/chrome). Veja [Usando Claude no Chrome com segurança](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) para como Claude lida com sites sensíveis e ações arriscadas.

147 147 

148<h4 id="choose-between-the-browser-and-the-chrome-extension">148<h4 id="choose-between-the-browser-and-the-chrome-extension">

149 Escolher entre o painel de navegador e a extensão Chrome149 Escolher entre o painel de navegador e a extensão Chrome

150</h4>150</h4>

151 151 

152O painel de navegador usa um perfil de navegador limpo, separado do seu navegador pessoal, sem nenhum de seus logins salvos ou histórico. Use-o para construir e testar seu aplicativo e para sites que não precisam de sua identidade. Quando você quer que Claude aja como você em suas sessões conectadas, use a [extensão Claude no Chrome](/pt/chrome) em vez disso, que compartilha o estado de login do seu navegador.152O painel de navegador usa um perfil de navegador limpo, separado do seu navegador pessoal, sem nenhum de seus logins salvos ou histórico. Use-o para construir e testar seu aplicativo e para sites que não precisam de sua identidade. Quando você quer que Claude aja como você em suas sessões conectadas, use a [extensão Claude no Chrome](/docs/pt/chrome) em vez disso, que compartilha o estado de login do seu navegador.

153 153 

154<h4 id="restrict-external-browsing-for-your-organization">154<h4 id="restrict-external-browsing-for-your-organization">

155 Restringir navegação externa para sua organização155 Restringir navegação externa para sua organização


272| `Cmd` `Shift` `E` | Abrir menu de esforço |272| `Cmd` `Shift` `E` | Abrir menu de esforço |

273| `1`–`9` | Selecionar item em um menu aberto |273| `1`–`9` | Selecionar item em um menu aberto |

274 274 

275Esses atalhos se aplicam apenas à aba Code. Os [atalhos de modo interativo](/pt/interactive-mode#keyboard-shortcuts) baseados em terminal, como `Shift+Tab` para ciclar modos, não se aplicam em Desktop.275Esses atalhos se aplicam apenas à aba Code. Os [atalhos de modo interativo](/docs/pt/interactive-mode#keyboard-shortcuts) baseados em terminal, como `Shift+Tab` para ciclar modos, não se aplicam em Desktop.

276 276 

277<h3 id="check-usage">277<h3 id="check-usage">

278 Verificar uso278 Verificar uso


293Computer use está desativado por padrão. [Ative-o em Configurações](#enable-computer-use) antes que Claude possa controlar sua tela. No macOS, você também precisa conceder permissões de Acessibilidade e Gravação de Tela.293Computer use está desativado por padrão. [Ative-o em Configurações](#enable-computer-use) antes que Claude possa controlar sua tela. No macOS, você também precisa conceder permissões de Acessibilidade e Gravação de Tela.

294 294 

295<Warning>295<Warning>

296 Diferentemente da [ferramenta Bash sandboxed](/pt/sandboxing), computer use é executado em seu desktop real com acesso a tudo que você aprova. Claude verifica cada ação e sinaliza possível injeção de prompt do conteúdo na tela, mas o limite de confiança é diferente. Veja o [guia de segurança de computer use](https://support.claude.com/en/articles/14128542) para melhores práticas.296 Diferentemente da [ferramenta Bash sandboxed](/docs/pt/sandboxing), computer use é executado em seu desktop real com acesso a tudo que você aprova. Claude verifica cada ação e sinaliza possível injeção de prompt do conteúdo na tela, mas o limite de confiança é diferente. Veja o [guia de segurança de computer use](https://support.claude.com/en/articles/14128542) para melhores práticas.

297</Warning>297</Warning>

298 298 

299<h3 id="when-computer-use-applies">299<h3 id="when-computer-use-applies">


304 304 

305* Se você tem um [connector](#connect-external-tools) para um serviço, Claude usa o connector.305* Se você tem um [connector](#connect-external-tools) para um serviço, Claude usa o connector.

306* Se a tarefa é um comando shell, Claude usa Bash.306* Se a tarefa é um comando shell, Claude usa Bash.

307* Se a tarefa é trabalho de navegador e você tem [Claude no Chrome](/pt/chrome) configurado, Claude usa isso.307* Se a tarefa é trabalho de navegador e você tem [Claude no Chrome](/docs/pt/chrome) configurado, Claude usa isso.

308* Se nenhum desses se aplica, Claude usa computer use.308* Se nenhum desses se aplica, Claude usa computer use.

309 309 

310Os [níveis de acesso por aplicativo](#app-permissions) reforçam isso: navegadores são limitados a apenas visualização, e terminais e IDEs a apenas clique, direcionando Claude para a ferramenta dedicada mesmo quando computer use está ativo. O controle de tela é reservado para coisas que nada mais pode alcançar, como aplicativos nativos, painéis de controle de hardware, simuladores móveis ou ferramentas proprietárias sem uma API.310Os [níveis de acesso por aplicativo](#app-permissions) reforçam isso: navegadores são limitados a apenas visualização, e terminais e IDEs a apenas clique, direcionando Claude para a ferramenta dedicada mesmo quando computer use está ativo. O controle de tela é reservado para coisas que nada mais pode alcançar, como aplicativos nativos, painéis de controle de hardware, simuladores móveis ou ferramentas proprietárias sem uma API.


317 317 

318<Steps>318<Steps>

319 <Step title="Atualizar o aplicativo desktop">319 <Step title="Atualizar o aplicativo desktop">

320 Certifique-se de que você tem a versão mais recente do Claude Desktop. No macOS e Windows, baixe ou atualize em [claude.com/download](https://claude.com/download); no Linux, atualize através do seu gerenciador de pacotes ([instruções](/pt/desktop-linux)). Depois reinicie o aplicativo.320 Certifique-se de que você tem a versão mais recente do Claude Desktop. No macOS e Windows, baixe ou atualize em [claude.com/download](https://claude.com/download); no Linux, atualize através do seu gerenciador de pacotes ([instruções](/docs/pt/desktop-linux)). Depois reinicie o aplicativo.

321 </Step>321 </Step>

322 322 

323 <Step title="Ativar o toggle">323 <Step title="Ativar o toggle">


367 Trabalhar em paralelo com sessões367 Trabalhar em paralelo com sessões

368</h3>368</h3>

369 369 

370Clique 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](/pt/worktrees), para que alterações em uma sessão não afetem outras sessões até que você as faça commit.370Clique 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.

371 371 

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

373 373 

374Worktrees são armazenadas em `<project-root>/.claude/worktrees/` por padrão. Você pode alterar isso para um diretório personalizado em Configurações → Claude Code em "Worktree location". Você também pode definir um prefixo de branch que é adicionado a cada nome de branch worktree, o que é útil para manter branches criadas por Claude organizadas. Para remover um worktree quando terminar, passe o mouse sobre a sessão na barra lateral e clique no ícone de arquivo. Para ter sessões se arquivarem automaticamente quando seu pull request mescla ou fecha, ative **Auto-archive after PR merge or close** em Configurações → Claude Code. Auto-archive se aplica apenas a sessões locais que terminaram de executar.374Worktrees são armazenadas em `<project-root>/.claude/worktrees/` por padrão. Você pode alterar isso para um diretório personalizado em Configurações → Claude Code em "Worktree location". Você também pode definir um prefixo de branch que é adicionado a cada nome de branch worktree, o que é útil para manter branches criadas por Claude organizadas. Para remover um worktree quando terminar, passe o mouse sobre a sessão na barra lateral e clique no ícone de arquivo. Para ter sessões se arquivarem automaticamente quando seu pull request mescla ou fecha, ative **Auto-archive after PR merge or close** em Configurações → Claude Code. Auto-archive se aplica apenas a sessões locais que terminaram de executar.

375 375 

376Para incluir arquivos gitignored como `.env` em novos worktrees, crie um [arquivo `.worktreeinclude`](/pt/worktrees#copy-gitignored-files-into-worktrees) na raiz do seu projeto.376Para 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.

377 377 

378<Note>378<Note>

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

380</Note>380</Note>

381 381 

382Use 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. Para verificar o uso de contexto, veja [Verificar uso](#check-usage). Quando o contexto se enche, Claude automaticamente resume a conversa e continua trabalhando. Você também pode digitar `/compact` para disparar a sumarização mais cedo e liberar espaço de contexto. Veja [a janela de contexto](/pt/how-claude-code-works#the-context-window) para detalhes sobre como a compactação funciona.382Use 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. Para verificar o uso de contexto, veja [Verificar uso](#check-usage). Quando o contexto se enche, Claude automaticamente resume a conversa e continua trabalhando. Você também pode digitar `/compact` para disparar a sumarização mais cedo e liberar espaço de contexto. Veja [a janela de contexto](/docs/pt/how-claude-code-works#the-context-window) para detalhes sobre como a compactação funciona.

383 383 

384O aplicativo desktop envia uma notificação do SO quando uma sessão de Code termina uma tarefa e você não está visualizando essa sessão no momento.384O aplicativo desktop envia uma notificação do SO quando uma sessão de Code termina uma tarefa e você não está visualizando essa sessão no momento.

385 385 


395 Assistir tarefas em segundo plano395 Assistir tarefas em segundo plano

396</h3>396</h3>

397 397 

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

399 399 

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

401 401 


407 407 

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

409 409 

410Veja [Claude Code na web](/pt/claude-code-on-the-web) para mais sobre como sessões remotas funcionam.410Veja [Claude Code na web](/docs/pt/claude-code-on-the-web) para mais sobre como sessões remotas funcionam.

411 411 

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

413 Continuar em outra superfície413 Continuar em outra superfície


432 432 

433Para configuração, emparelhamento e configurações de Dispatch, veja o [artigo de ajuda do Dispatch](https://support.claude.com/en/articles/13947068). Dispatch requer um plano Pro ou Max e não está disponível em planos Team ou Enterprise.433Para configuração, emparelhamento e configurações de Dispatch, veja o [artigo de ajuda do Dispatch](https://support.claude.com/en/articles/13947068). Dispatch requer um plano Pro ou Max e não está disponível em planos Team ou Enterprise.

434 434 

435Dispatch é uma de várias maneiras de trabalhar com Claude quando você está longe de seu terminal. Veja [Plataformas e integrações](/pt/platforms#work-when-you-are-away-from-your-terminal) para compará-lo com Remote Control, Channels, Slack e tarefas agendadas.435Dispatch é uma de várias maneiras de trabalhar com Claude quando você está longe de seu terminal. Veja [Plataformas e integrações](/docs/pt/platforms#work-when-you-are-away-from-your-terminal) para compará-lo com Remote Control, Channels, Slack e tarefas agendadas.

436 436 

437<h2 id="extend-claude-code">437<h2 id="extend-claude-code">

438 Estender Claude Code438 Estender Claude Code


444 Conectar ferramentas externas444 Conectar ferramentas externas

445</h3>445</h3>

446 446 

447Para sessões locais e [SSH](#ssh-sessions), clique no botão **+** ao lado da caixa de prompt e selecione **Connectors** para adicionar integrações como Google Calendar, Slack, GitHub, Linear, Notion e muito mais. Você pode adicionar conectores antes ou durante uma sessão. O botão **+** não está disponível em sessões remotas ou WSL, mas [routines](/pt/routines) configuram conectores no momento da criação da rotina.447Para sessões locais e [SSH](#ssh-sessions), clique no botão **+** ao lado da caixa de prompt e selecione **Connectors** para adicionar integrações como Google Calendar, Slack, GitHub, Linear, Notion e muito mais. Você pode adicionar conectores antes ou durante uma sessão. O botão **+** não está disponível em sessões remotas ou WSL, mas [routines](/docs/pt/routines) configuram conectores no momento da criação da rotina.

448 448 

449Para gerenciar ou desconectar conectores, vá para Configurações → Connectors no aplicativo desktop, ou selecione **Manage connectors** no menu Connectors na caixa de prompt.449Para gerenciar ou desconectar conectores, vá para Configurações → Connectors no aplicativo desktop, ou selecione **Manage connectors** no menu Connectors na caixa de prompt.

450 450 

451Uma vez conectado, Claude pode ler seu calendário, enviar mensagens, criar problemas e interagir com suas ferramentas diretamente. Você pode perguntar a Claude quais conectores estão configurados em sua sessão.451Uma vez conectado, Claude pode ler seu calendário, enviar mensagens, criar problemas e interagir com suas ferramentas diretamente. Você pode perguntar a Claude quais conectores estão configurados em sua sessão.

452 452 

453Conectores são [MCP servers](/pt/mcp) com um fluxo de configuração gráfica. Use-os para integração rápida com serviços suportados. Para integrações não listadas em Connectors, adicione MCP servers manualmente via [arquivos de configuração](/pt/mcp#installing-mcp-servers). Você também pode [criar conectores personalizados](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).453Conectores são [MCP servers](/docs/pt/mcp) com um fluxo de configuração gráfica. Use-os para integração rápida com serviços suportados. Para integrações não listadas em Connectors, adicione MCP servers manualmente via [arquivos de configuração](/docs/pt/mcp#installing-mcp-servers). Você também pode [criar conectores personalizados](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).

454 454 

455<h3 id="use-skills">455<h3 id="use-skills">

456 Use skills456 Use skills

457</h3>457</h3>

458 458 

459[Skills](/pt/skills) estendem o que Claude pode fazer. Claude as carrega automaticamente quando relevante, ou você pode invocar uma diretamente: digite `/` na caixa de prompt ou clique no botão **+** e selecione **Slash commands** para navegar pelo que está disponível. Isso inclui [comandos integrados](/pt/commands), suas [skills personalizadas](/pt/skills#create-your-first-skill), skills de projeto de sua base de código e skills de qualquer [plugins instalados](/pt/plugins). Selecione uma e ela aparece destacada no campo de entrada. Digite sua tarefa depois dela e envie como usual.459[Skills](/docs/pt/skills) estendem o que Claude pode fazer. Claude as carrega automaticamente quando relevante, ou você pode invocar uma diretamente: digite `/` na caixa de prompt ou clique no botão **+** e selecione **Slash commands** para navegar pelo que está disponível. Isso inclui [comandos integrados](/docs/pt/commands), suas [skills personalizadas](/docs/pt/skills#create-your-first-skill), skills de projeto de sua base de código e skills de qualquer [plugins instalados](/docs/pt/plugins). Selecione uma e ela aparece destacada no campo de entrada. Digite sua tarefa depois dela e envie como usual.

460 460 

461Você pode enviar um comando enquanto Claude está trabalhando, da mesma forma que qualquer outra mensagem, e a sessão retorna ao estado ocioso uma vez que a rodada termina. Antes da v2.1.206, um comando enviado no meio da rodada poderia deixar a sessão mostrando como em execução e as mensagens que você enviou depois não eram entregues.461Você pode enviar um comando enquanto Claude está trabalhando, da mesma forma que qualquer outra mensagem, e a sessão retorna ao estado ocioso uma vez que a rodada termina. Antes da v2.1.206, um comando enviado no meio da rodada poderia deixar a sessão mostrando como em execução e as mensagens que você enviou depois não eram entregues.

462 462 


464 Instalar plugins464 Instalar plugins

465</h3>465</h3>

466 466 

467[Plugins](/pt/plugins) são pacotes reutilizáveis que adicionam skills, agents, hooks, MCP servers e configurações LSP ao Claude Code. Você pode instalar plugins do aplicativo desktop sem usar o terminal.467[Plugins](/docs/pt/plugins) são pacotes reutilizáveis que adicionam skills, agents, hooks, MCP servers e configurações LSP ao Claude Code. Você pode instalar plugins do aplicativo desktop sem usar o terminal.

468 468 

469Para sessões locais e [SSH](#ssh-sessions), clique no botão **+** ao lado da caixa de prompt e selecione **Plugins** para ver seus plugins instalados e seus skills. Para adicionar um plugin, selecione **Add plugin** no submenu para abrir o navegador de plugins, que mostra plugins disponíveis de seus [marketplaces](/pt/plugin-marketplaces) configurados incluindo o marketplace oficial da Anthropic. Selecione **Manage plugins** para ativar, desativar ou desinstalar plugins.469Para sessões locais e [SSH](#ssh-sessions), clique no botão **+** ao lado da caixa de prompt e selecione **Plugins** para ver seus plugins instalados e seus skills. Para adicionar um plugin, selecione **Add plugin** no submenu para abrir o navegador de plugins, que mostra plugins disponíveis de seus [marketplaces](/docs/pt/plugin-marketplaces) configurados incluindo o marketplace oficial da Anthropic. Selecione **Manage plugins** para ativar, desativar ou desinstalar plugins.

470 470 

471Plugins podem ser escopo para sua conta de usuário, um projeto específico ou apenas local. Se sua organização gerencia plugins centralmente, esses plugins estão disponíveis em sessões desktop da mesma forma que estão no CLI. Plugins não estão disponíveis para sessões remotas ou WSL. Para a referência completa de plugins incluindo criar seus próprios plugins, veja [plugins](/pt/plugins).471Plugins podem ser escopo para sua conta de usuário, um projeto específico ou apenas local. Se sua organização gerencia plugins centralmente, esses plugins estão disponíveis em sessões desktop da mesma forma que estão no CLI. Plugins não estão disponíveis para sessões remotas ou WSL. Para a referência completa de plugins incluindo criar seus próprios plugins, veja [plugins](/docs/pt/plugins).

472 472 

473<h3 id="configure-preview-servers">473<h3 id="configure-preview-servers">

474 Configurar servidores de visualização474 Configurar servidores de visualização


634* **Local**: é executado em sua máquina com acesso direto aos seus arquivos634* **Local**: é executado em sua máquina com acesso direto aos seus arquivos

635* **Remote**: é executado na infraestrutura em nuvem da Anthropic. Sessões continuam mesmo se você fechar o aplicativo.635* **Remote**: é executado na infraestrutura em nuvem da Anthropic. Sessões continuam mesmo se você fechar o aplicativo.

636* **SSH**: é executado em uma máquina remota à qual você se conecta via SSH, como seus próprios servidores, VMs em nuvem ou dev containers636* **SSH**: é executado em uma máquina remota à qual você se conecta via SSH, como seus próprios servidores, VMs em nuvem ou dev containers

637* **WSL** (Windows): é executado dentro de uma [distribuição WSL 2](/pt/desktop-wsl) em sua máquina, usando sua cadeia de ferramentas Linux e caminhos nativos637* **WSL** (Windows): é executado dentro de uma [distribuição WSL 2](/docs/pt/desktop-wsl) em sua máquina, usando sua cadeia de ferramentas Linux e caminhos nativos

638 638 

639<h3 id="local-sessions">639<h3 id="local-sessions">

640 Local sessions640 Local sessions


642 642 

643O aplicativo desktop nem sempre herda seu ambiente de shell completo. No macOS, quando você inicia o aplicativo do Dock ou Finder, ele lê seu perfil de shell, como `~/.zshrc` ou `~/.bashrc`, para extrair `PATH` e um conjunto fixo de variáveis Claude Code, mas outras variáveis que você exporta lá não são capturadas. No Windows, o aplicativo herda variáveis de ambiente de usuário e sistema mas não lê perfis PowerShell.643O aplicativo desktop nem sempre herda seu ambiente de shell completo. No macOS, quando você inicia o aplicativo do Dock ou Finder, ele lê seu perfil de shell, como `~/.zshrc` ou `~/.bashrc`, para extrair `PATH` e um conjunto fixo de variáveis Claude Code, mas outras variáveis que você exporta lá não são capturadas. No Windows, o aplicativo herda variáveis de ambiente de usuário e sistema mas não lê perfis PowerShell.

644 644 

645Para definir variáveis de ambiente para sessões locais e servidores de desenvolvimento em qualquer plataforma, abra o menu suspenso de ambiente na caixa de prompt, passe o mouse sobre **Local** e clique no ícone de engrenagem para abrir o editor de ambiente local. Variáveis que você salva aqui são armazenadas criptografadas em sua máquina e se aplicam a cada sessão local e servidor de visualização que você inicia. Você também pode adicionar variáveis à chave `env` em seu arquivo `~/.claude/settings.json`, embora essas alcancem apenas sessões Claude e não servidores de desenvolvimento. Veja [variáveis de ambiente](/pt/env-vars) para a lista completa de variáveis suportadas.645Para definir variáveis de ambiente para sessões locais e servidores de desenvolvimento em qualquer plataforma, abra o menu suspenso de ambiente na caixa de prompt, passe o mouse sobre **Local** e clique no ícone de engrenagem para abrir o editor de ambiente local. Variáveis que você salva aqui são armazenadas criptografadas em sua máquina e se aplicam a cada sessão local e servidor de visualização que você inicia. Você também pode adicionar variáveis à chave `env` em seu arquivo `~/.claude/settings.json`, embora essas alcancem apenas sessões Claude e não servidores de desenvolvimento. Veja [variáveis de ambiente](/docs/pt/env-vars) para a lista completa de variáveis suportadas.

646 646 

647[Extended thinking](/pt/model-config#extended-thinking) está ativado por padrão, o que melhora o desempenho em tarefas de raciocínio complexo mas usa tokens adicionais. Para desabilitar o thinking, defina `MAX_THINKING_TOKENS` para `0` no editor de ambiente local; isso não tem efeito no Fable 5, que sempre usa extended thinking. Em [provedores de terceiros](/pt/third-party-integrations), `0` omite o parâmetro `thinking` em vez disso, e modelos de adaptive-reasoning ainda podem pensar. Em modelos com [adaptive reasoning](/pt/model-config#adjust-effort-level), qualquer outro valor de `MAX_THINKING_TOKENS` é ignorado porque adaptive reasoning controla a profundidade do thinking. Em Opus 4.6 e Sonnet 4.6, defina `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` para `1` para usar um orçamento de thinking fixo; Fable 5, Sonnet 5 e Opus 4.7 e posterior sempre usam adaptive reasoning e não têm modo de orçamento fixo.647[Extended thinking](/docs/pt/model-config#extended-thinking) está ativado por padrão, o que melhora o desempenho em tarefas de raciocínio complexo mas usa tokens adicionais. Para desabilitar o thinking, defina `MAX_THINKING_TOKENS` para `0` no editor de ambiente local; isso não tem efeito no Fable 5, que sempre usa extended thinking. Em [provedores de terceiros](/docs/pt/third-party-integrations), `0` omite o parâmetro `thinking` em vez disso, e modelos de adaptive-reasoning ainda podem pensar. Em modelos com [adaptive reasoning](/docs/pt/model-config#adjust-effort-level), qualquer outro valor de `MAX_THINKING_TOKENS` é ignorado porque adaptive reasoning controla a profundidade do thinking. Em Opus 4.6 e Sonnet 4.6, defina `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` para `1` para usar um orçamento de thinking fixo; Fable 5, Sonnet 5 e Opus 4.7 e posterior sempre usam adaptive reasoning e não têm modo de orçamento fixo.

648 648 

649<h3 id="cloud-sessions">649<h3 id="cloud-sessions">

650 Cloud sessions650 Cloud sessions

651</h3>651</h3>

652 652 

653Sessões em nuvem continuam em segundo plano mesmo se você fechar o aplicativo. O uso conta para seus [limites do plano de assinatura](/pt/costs) sem cobranças de computação separadas.653Sessões em nuvem continuam em segundo plano mesmo se você fechar o aplicativo. O uso conta para seus [limites do plano de assinatura](/docs/pt/costs) sem cobranças de computação separadas.

654 654 

655Você pode criar ambientes em nuvem personalizados com diferentes níveis de acesso de rede e variáveis de ambiente. Selecione o menu suspenso de ambiente ao iniciar uma sessão em nuvem e escolha **Add environment**. Veja [o ambiente em nuvem](/pt/claude-code-on-the-web#the-cloud-environment) para detalhes sobre configuração de acesso de rede e variáveis de ambiente.655Você pode criar ambientes em nuvem personalizados com diferentes níveis de acesso de rede e variáveis de ambiente. Selecione o menu suspenso de ambiente ao iniciar uma sessão em nuvem e escolha **Add environment**. Veja [o ambiente em nuvem](/docs/pt/claude-code-on-the-web#the-cloud-environment) para detalhes sobre configuração de acesso de rede e variáveis de ambiente.

656 656 

657<h3 id="ssh-sessions">657<h3 id="ssh-sessions">

658 SSH sessions658 SSH sessions


675 Pré-configurar conexões SSH para sua equipe675 Pré-configurar conexões SSH para sua equipe

676</h4>676</h4>

677 677 

678Administradores podem distribuir conexões SSH para membros da equipe adicionando `sshConfigs` a um arquivo de [configurações gerenciadas](/pt/settings#settings-precedence). Conexões definidas desta forma aparecem no menu suspenso de ambiente de cada usuário automaticamente e são mostradas como gerenciadas, para que os usuários possam selecioná-las mas não possam editá-las ou deletá-las no aplicativo.678Administradores podem distribuir conexões SSH para membros da equipe adicionando `sshConfigs` a um arquivo de [configurações gerenciadas](/docs/pt/settings#settings-precedence). Conexões definidas desta forma aparecem no menu suspenso de ambiente de cada usuário automaticamente e são mostradas como gerenciadas, para que os usuários possam selecioná-las mas não possam editá-las ou deletá-las no aplicativo.

679 679 

680O exemplo a seguir pré-configura uma única conexão que abre em `~/projects` no host remoto:680O exemplo a seguir pré-configura uma única conexão que abre em `~/projects` no host remoto:

681 681 


700 Restringir quais hosts SSH os usuários podem se conectar700 Restringir quais hosts SSH os usuários podem se conectar

701</h4>701</h4>

702 702 

703Administradores podem limitar as sessões SSH do Desktop a um conjunto aprovado de hosts adicionando `sshHostAllowlist` a um arquivo de [configurações gerenciadas](/pt/settings#settings-precedence). Quando definido, os usuários podem se conectar apenas a hosts cujo nome de host resolvido corresponde a um dos padrões. Defina-o como um array vazio para desabilitar sessões SSH completamente.703Administradores podem limitar as sessões SSH do Desktop a um conjunto aprovado de hosts adicionando `sshHostAllowlist` a um arquivo de [configurações gerenciadas](/docs/pt/settings#settings-precedence). Quando definido, os usuários podem se conectar apenas a hosts cujo nome de host resolvido corresponde a um dos padrões. Defina-o como um array vazio para desabilitar sessões SSH completamente.

704 704 

705O exemplo a seguir permite conexões a qualquer host sob `devboxes.example.com` e a um único host bastion nomeado:705O exemplo a seguir permite conexões a qualquer host sob `devboxes.example.com` e a um único host bastion nomeado:

706 706 


727Essas configurações são configuradas através do [console de configurações de administração](https://claude.ai/admin-settings/claude-code):727Essas configurações são configuradas através do [console de configurações de administração](https://claude.ai/admin-settings/claude-code):

728 728 

729* **Code in the desktop**: controle se usuários em sua organização podem acessar Claude Code no aplicativo desktop729* **Code in the desktop**: controle se usuários em sua organização podem acessar Claude Code no aplicativo desktop

730* **Code in the web**: ative ou desative [sessões web](/pt/claude-code-on-the-web) para sua organização730* **Code in the web**: ative ou desative [sessões web](/docs/pt/claude-code-on-the-web) para sua organização

731* **Remote Control**: ative ou desative [Remote Control](/pt/remote-control) para sua organização731* **Remote Control**: ative ou desative [Remote Control](/docs/pt/remote-control) para sua organização

732* **Disable Bypass permissions mode**: impeça usuários em sua organização de ativar o modo bypass permissions732* **Disable Bypass permissions mode**: impeça usuários em sua organização de ativar o modo bypass permissions

733 733 

734<h3 id="managed-settings">734<h3 id="managed-settings">

735 Managed settings735 Managed settings

736</h3>736</h3>

737 737 

738Configurações gerenciadas sobrescrevem configurações de projeto e usuário e se aplicam a sessões Claude Code no Desktop. Você pode definir essas chaves no arquivo de [configurações gerenciadas](/pt/settings#settings-precedence) de sua organização ou enviá-las remotamente através do console de administração.738Configurações gerenciadas sobrescrevem configurações de projeto e usuário e se aplicam a sessões Claude Code no Desktop. Você pode definir essas chaves no arquivo de [configurações gerenciadas](/docs/pt/settings#settings-precedence) de sua organização ou enviá-las remotamente através do console de administração.

739 739 

740| Chave | Descrição |740| Chave | Descrição |

741| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |741| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

742| `permissions.disableBypassPermissionsMode` | defina como `"disable"` para impedir usuários de ativar o modo Bypass permissions. |742| `permissions.disableBypassPermissionsMode` | defina como `"disable"` para impedir usuários de ativar o modo Bypass permissions. |

743| `disableAutoMode` | defina como `"disable"` para impedir usuários de ativar o modo [Auto](/pt/permission-modes#eliminate-prompts-with-auto-mode). Remove Auto do seletor de modo. Também aceito em `permissions`. |743| `disableAutoMode` | defina como `"disable"` para impedir usuários de ativar o modo [Auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode). Remove Auto do seletor de modo. Também aceito em `permissions`. |

744| `autoMode` | customize o que o classificador de modo auto confia e bloqueia em sua organização. Veja [Configurar o modo auto](/pt/auto-mode-config). |744| `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). |

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

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

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

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

749| `managedMcpServers` | envie configurações de servidor MCP para todos os usuários em uma implantação de terceiros. Cada entrada especifica um transporte de `"http"`, `"sse"` ou `"stdio"`, detalhes de conexão e opcionalmente um mapa `toolPolicy` que restringe quais ferramentas nesse servidor os usuários podem invocar. Disponível apenas em implantações Desktop de terceiros (3P). Entregue essa chave através do arquivo de configurações gerenciadas ou MDM, já que implantações de terceiros não recebem configurações do console de administração. |749| `managedMcpServers` | envie configurações de servidor MCP para todos os usuários em uma implantação de terceiros. Cada entrada especifica um transporte de `"http"`, `"sse"` ou `"stdio"`, detalhes de conexão e opcionalmente um mapa `toolPolicy` que restringe quais ferramentas nesse servidor os usuários podem invocar. Disponível apenas em implantações Desktop de terceiros (3P). Entregue essa chave através do arquivo de configurações gerenciadas ou MDM, já que implantações de terceiros não recebem configurações do console de administração. |

750 750 

751Quais configurações gerenciadas alcançam uma sessão Desktop depende de onde essa sessão é executada. Restrições de modelo como [`availableModels`](/pt/model-config#restrict-model-selection) são aplicadas em sessões Claude Code do Desktop da mesma forma que na CLI do terminal; veja [cobertura de superfície](/pt/model-config#surface-coverage).751Quais configurações gerenciadas alcançam uma sessão Desktop depende de onde essa sessão é executada. Restrições de modelo como [`availableModels`](/docs/pt/model-config#restrict-model-selection) são aplicadas em sessões Claude Code do Desktop da mesma forma que na CLI do terminal; veja [cobertura de superfície](/docs/pt/model-config#surface-coverage).

752 752 

753* **Sessões locais nesta máquina**: um arquivo de configurações gerenciadas implantado em disco se aplica. Configurações gerenciadas enviadas remotamente através do console de administração também alcançam essas sessões na API da Anthropic quando a sessão se autentica com um login de organização ou uma chave de API configurada diretamente, seguindo a mesma [precedência de configurações](/pt/settings#settings-precedence) que a CLI do terminal.753* **Sessões locais nesta máquina**: um arquivo de configurações gerenciadas implantado em disco se aplica. Configurações gerenciadas enviadas remotamente através do console de administração também alcançam essas sessões na API da Anthropic quando a sessão se autentica com um login de organização ou uma chave de API configurada diretamente, seguindo a mesma [precedência de configurações](/docs/pt/settings#settings-precedence) que a CLI do terminal.

754* **[Sessões em nuvem](#cloud-sessions)**: executadas em VMs gerenciadas pela Anthropic e recebem [configurações gerenciadas pelo servidor](/pt/server-managed-settings) apenas.754* **[Sessões em nuvem](#cloud-sessions)**: executadas em VMs gerenciadas pela Anthropic e recebem [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) apenas.

755* **[Sessões SSH](#ssh-sessions)**: a sessão lê o arquivo de configurações gerenciadas do host remoto. O Desktop em si lê `sshConfigs` e `sshHostAllowlist` das configurações gerenciadas da máquina local ao criar a conexão.755* **[Sessões SSH](#ssh-sessions)**: a sessão lê o arquivo de configurações gerenciadas do host remoto. O Desktop em si lê `sshConfigs` e `sshHostAllowlist` das configurações gerenciadas da máquina local ao criar a conexão.

756 756 

757`permissions.disableBypassPermissionsMode` e `disableAutoMode` também funcionam em configurações de usuário e projeto, mas colocá-los em configurações gerenciadas impede que usuários os sobrescrevam.757`permissions.disableBypassPermissionsMode` e `disableAutoMode` também funcionam em configurações de usuário e projeto, mas colocá-los em configurações gerenciadas impede que usuários os sobrescrevam.

758 758 

759{/* min-version: 2.1.207 */}Claude Code lê `autoMode` de configurações de usuário, a flag `--settings` e configurações gerenciadas, mas não de `.claude/settings.json` ou `.claude/settings.local.json`: ambos os arquivos vivem no diretório do repo, então um repo clonado ou etapa de build não pode injetar suas próprias regras de classificador. Antes da v2.1.207, Claude Code também lia `.claude/settings.local.json`.759Claude Code lê `autoMode` de configurações de usuário, a flag `--settings` e configurações gerenciadas, mas não de `.claude/settings.json` ou `.claude/settings.local.json`: ambos os arquivos vivem no diretório do repo, então um repo clonado ou etapa de build não pode injetar suas próprias regras de classificador. Antes da v2.1.207, Claude Code também lia `.claude/settings.local.json`.

760 760 

761Para a lista completa de configurações apenas gerenciadas incluindo `allowManagedPermissionRulesOnly` e `allowManagedHooksOnly`, veja [configurações apenas gerenciadas](/pt/permissions#managed-only-settings).761Para a lista completa de configurações apenas gerenciadas incluindo `allowManagedPermissionRulesOnly` e `allowManagedHooksOnly`, veja [configurações apenas gerenciadas](/docs/pt/permissions#managed-only-settings).

762 762 

763<h3 id="device-management-policies">763<h3 id="device-management-policies">

764 Políticas de gerenciamento de dispositivos764 Políticas de gerenciamento de dispositivos


788*.claudemcpcontent.com788*.claudemcpcontent.com

789```789```

790 790 

791O tráfego é HTTPS na porta 443 a menos que você configure uma porta personalizada para [OTLP](/pt/monitoring-usage), um gateway LLM ou um servidor MCP.791O tráfego é HTTPS na porta 443 a menos que você configure uma porta personalizada para [OTLP](/docs/pt/monitoring-usage), um gateway LLM ou um servidor MCP.

792 792 

793Para servidores proxy, autoridades de certificado personalizadas, mTLS e os domínios que a CLI autônoma precisa, veja [configuração de rede](/pt/network-config).793Para servidores proxy, autoridades de certificado personalizadas, mTLS e os domínios que a CLI autônoma precisa, veja [configuração de rede](/docs/pt/network-config).

794 794 

795Para reduzir o número de wildcards de firewall, permita esses hosts da Anthropic em vez disso. Certos subdomínios são gerados dinamicamente e devem permanecer como wildcards.795Para reduzir o número de wildcards de firewall, permita esses hosts da Anthropic em vez disso. Certos subdomínios são gerados dinamicamente e devem permanecer como wildcards.

796 796 


818 Autenticação e SSO818 Autenticação e SSO

819</h3>819</h3>

820 820 

821Organizações corporativas podem exigir SSO para todos os usuários. Veja [autenticação](/pt/authentication) para detalhes de nível de plano e [Configurando SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) para configuração SAML; a configuração OIDC é coberta no [Guia do Administrador Corporativo Claude](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).821Organizações corporativas podem exigir SSO para todos os usuários. Veja [autenticação](/docs/pt/authentication) para detalhes de nível de plano e [Configurando SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) para configuração SAML; a configuração OIDC é coberta no [Guia do Administrador Corporativo Claude](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).

822 822 

823<h3 id="data-handling">823<h3 id="data-handling">

824 Manipulação de dados824 Manipulação de dados

825</h3>825</h3>

826 826 

827Claude Code processa seu código localmente em sessões locais ou na infraestrutura em nuvem da Anthropic em sessões em nuvem. Conversas e contexto de código são enviados para a API da Anthropic para processamento. Veja [manipulação de dados](/pt/data-usage) para detalhes sobre retenção de dados, privacidade e conformidade.827Claude Code processa seu código localmente em sessões locais ou na infraestrutura em nuvem da Anthropic em sessões em nuvem. Conversas e contexto de código são enviados para a API da Anthropic para processamento. Veja [manipulação de dados](/docs/pt/data-usage) para detalhes sobre retenção de dados, privacidade e conformidade.

828 828 

829<h3 id="deployment">829<h3 id="deployment">

830 Implantação830 Implantação


835* **macOS**: distribua via MDM como Jamf ou Kandji usando o instalador `.dmg`835* **macOS**: distribua via MDM como Jamf ou Kandji usando o instalador `.dmg`

836* **Windows**: implante via pacote MSIX. Veja [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) para opções de implantação corporativa incluindo instalação silenciosa836* **Windows**: implante via pacote MSIX. Veja [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) para opções de implantação corporativa incluindo instalação silenciosa

837 837 

838Para os domínios a permitir na sua firewall, veja [requisitos de acesso à rede](#network-access-requirements) acima. Para configurações de proxy, autoridades de certificado personalizadas e gateways LLM, veja [configuração de rede](/pt/network-config).838Para os domínios a permitir na sua firewall, veja [requisitos de acesso à rede](#network-access-requirements) acima. Para configurações de proxy, autoridades de certificado personalizadas e gateways LLM, veja [configuração de rede](/docs/pt/network-config).

839 839 

840Para a referência completa de configuração corporativa, veja o [guia de configuração corporativa](https://support.claude.com/en/articles/12622667-enterprise-configuration).840Para a referência completa de configuração corporativa, veja o [guia de configuração corporativa](https://support.claude.com/en/articles/12622667-enterprise-configuration).

841 841 


864| `--permission-mode` | Seletor de modo ao lado do botão enviar |864| `--permission-mode` | Seletor de modo ao lado do botão enviar |

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

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

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

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

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

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


876 876 

877Desktop e CLI leem os mesmos arquivos de configuração, então sua configuração é transferida:877Desktop e CLI leem os mesmos arquivos de configuração, então sua configuração é transferida:

878 878 

879* Arquivos **[CLAUDE.md](/pt/memory)** e `CLAUDE.local.md` em seu projeto são usados por ambos879* Arquivos **[CLAUDE.md](/docs/pt/memory)** e `CLAUDE.local.md` em seu projeto são usados por ambos

880* **[MCP servers](/pt/mcp)** configurados em `~/.claude.json` ou `.mcp.json` funcionam em ambos880* **[MCP servers](/docs/pt/mcp)** configurados em `~/.claude.json` ou `.mcp.json` funcionam em ambos

881* **[Hooks](/pt/hooks)** e **[skills](/pt/skills)** definidos em configurações se aplicam a ambos881* **[Hooks](/docs/pt/hooks)** e **[skills](/docs/pt/skills)** definidos em configurações se aplicam a ambos

882* **[Configurações](/pt/settings)** em `~/.claude.json` e `~/.claude/settings.json` são compartilhadas. Regras de permissão, ferramentas permitidas e outras configurações em `settings.json` se aplicam a sessões Desktop.882* **[Configurações](/docs/pt/settings)** em `~/.claude.json` e `~/.claude/settings.json` são compartilhadas. Regras de permissão, ferramentas permitidas e outras configurações em `settings.json` se aplicam a sessões Desktop.

883* **Modelos**: os mesmos [modelos](/pt/model-config#available-models) estão disponíveis em ambos. Em Desktop, selecione o modelo no menu suspenso ao lado do botão enviar. Você pode alterar o modelo durante a sessão a partir do mesmo menu suspenso.883* **Modelos**: os mesmos [modelos](/docs/pt/model-config#available-models) estão disponíveis em ambos. Em Desktop, selecione o modelo no menu suspenso ao lado do botão enviar. Você pode alterar o modelo durante a sessão a partir do mesmo menu suspenso.

884 884 

885<Note>885<Note>

886 **MCP servers do aplicativo de chat Claude Desktop**: o aplicativo Desktop carrega MCP servers de `claude_desktop_config.json` em sessões da aba Code, juntamente com servers de `~/.claude.json` e `.mcp.json`. Um server definido em `claude_desktop_config.json` está disponível tanto na superfície de chat Desktop quanto na aba Code.886 **MCP servers do aplicativo de chat Claude Desktop**: o aplicativo Desktop carrega MCP servers de `claude_desktop_config.json` em sessões da aba Code, juntamente com servers de `~/.claude.json` e `.mcp.json`. Um server definido em `claude_desktop_config.json` está disponível tanto na superfície de chat Desktop quanto na aba Code.

887 887 

888 O CLI autônomo não lê `claude_desktop_config.json`. Em macOS e WSL, execute `claude mcp add-from-claude-desktop` para copiar esses servers em `~/.claude.json`. Veja [Importar MCP servers do Claude Desktop](/pt/mcp#import-mcp-servers-from-claude-desktop) para o fluxo de importação e opções de escopo.888 O CLI autônomo não lê `claude_desktop_config.json`. Em macOS e WSL, execute `claude mcp add-from-claude-desktop` para copiar esses servers em `~/.claude.json`. Veja [Importar MCP servers do Claude Desktop](/docs/pt/mcp#import-mcp-servers-from-claude-desktop) para o fluxo de importação e opções de escopo.

889</Note>889</Note>

890 890 

891<h3 id="feature-comparison">891<h3 id="feature-comparison">

892 Feature comparison892 Feature comparison

893</h3>893</h3>

894 894 

895Esta tabela compara capacidades principais entre CLI e Desktop. Para uma lista completa de flags CLI, veja a [referência CLI](/pt/cli-reference).895Esta tabela compara capacidades principais entre CLI e Desktop. Para uma lista completa de flags CLI, veja a [referência CLI](/docs/pt/cli-reference).

896 896 

897| Recurso | CLI | Desktop |897| Recurso | CLI | Desktop |

898| ------------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |898| ------------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

899| Modos de permissão | Todos os modos incluindo `dontAsk` | Manual, Aceitar edições, Plan e Auto. Bypass permissions aparece no seletor de modo uma vez habilitado: através do toggle Configurações em planos Pro e Max, ou através da política organizacional em planos Team e Enterprise |899| Modos de permissão | Todos os modos incluindo `dontAsk` | Manual, Aceitar edições, Plan e Auto. Bypass permissions aparece no seletor de modo uma vez habilitado: através do toggle Configurações em planos Pro e Max, ou através da política organizacional em planos Team e Enterprise |

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

901| [Provedores de terceiros](/pt/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API da Anthropic por padrão. Para roteamento de gateway, veja [conectar o aplicativo desktop a um gateway](/pt/llm-gateway-connect#desktop-app). Para executar a aba Code em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado, veja [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |901| [Provedores de terceiros](/docs/pt/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API da Anthropic por padrão. Para roteamento de gateway, veja [conectar o aplicativo desktop a um gateway](/docs/pt/llm-gateway-connect#desktop-app). Para executar a aba Code em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado, veja [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

902| [MCP servers](/pt/mcp) | Configure em arquivos de configuração | UI de Connectors para sessões locais e SSH, ou arquivos de configuração |902| [MCP servers](/docs/pt/mcp) | Configure em arquivos de configuração | UI de Connectors para sessões locais e SSH, ou arquivos de configuração |

903| [Plugins](/pt/plugins) | Comando `/plugin` | UI do gerenciador de plugins |903| [Plugins](/docs/pt/plugins) | Comando `/plugin` | UI do gerenciador de plugins |

904| @mention de arquivos | Baseado em texto | Com autocompletar; sessões locais e SSH apenas |904| @mention de arquivos | Baseado em texto | Com autocompletar; sessões locais e SSH apenas |

905| Anexos de arquivo | Não disponível | Imagens, PDFs |905| Anexos de arquivo | Não disponível | Imagens, PDFs |

906| Isolamento de sessão | Flag [`--worktree`](/pt/cli-reference) | Worktrees automáticos |906| Isolamento de sessão | Flag [`--worktree`](/docs/pt/cli-reference) | Worktrees automáticos |

907| Múltiplas sessões | Terminais separados | Abas na barra lateral |907| Múltiplas sessões | Terminais separados | Abas na barra lateral |

908| Tarefas recorrentes | Cron jobs, pipelines CI | [Tarefas agendadas](/pt/desktop-scheduled-tasks) |908| Tarefas recorrentes | Cron jobs, pipelines CI | [Tarefas agendadas](/docs/pt/desktop-scheduled-tasks) |

909| Computer use | [Ativar via `/mcp`](/pt/computer-use) no macOS | [Controle de aplicativo e tela](#let-claude-use-your-computer) no macOS e Windows |909| Computer use | [Ativar via `/mcp`](/docs/pt/computer-use) no macOS | [Controle de aplicativo e tela](#let-claude-use-your-computer) no macOS e Windows |

910| Integração Dispatch | Não disponível | [Sessões Dispatch](#sessions-from-dispatch) na barra lateral |910| Integração Dispatch | Não disponível | [Sessões Dispatch](#sessions-from-dispatch) na barra lateral |

911| Scripting e automação | [`--print`](/pt/cli-reference), [Agent SDK](/pt/headless) | Não disponível |911| Scripting e automação | [`--print`](/docs/pt/cli-reference), [Agent SDK](/docs/pt/headless) | Não disponível |

912 912 

913<h3 id="what’s-not-available-in-desktop">913<h3 id="what’s-not-available-in-desktop">

914 What's not available in Desktop914 What's not available in Desktop


916 916 

917Os seguintes recursos estão disponíveis apenas no CLI ou extensão VS Code, exceto onde observado:917Os seguintes recursos estão disponíveis apenas no CLI ou extensão VS Code, exceto onde observado:

918 918 

919* **Provedores de terceiros**: Desktop se conecta à API da Anthropic por padrão. Para rotear Desktop através de um gateway, veja [conectar o aplicativo desktop a um gateway](/pt/llm-gateway-connect#desktop-app). Implantações corporativas podem configurar Google Cloud's Agent Platform e provedores de gateway via [configurações gerenciadas](https://claude.com/docs/third-party/claude-desktop/configuration). Para Amazon Bedrock ou Microsoft Foundry no CLI, veja o [quickstart](/pt/quickstart). Como uma exceção à seção acima, [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) executa a aba Code em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado.919* **Provedores de terceiros**: Desktop se conecta à API da Anthropic por padrão. Para rotear Desktop através de um gateway, veja [conectar o aplicativo desktop a um gateway](/docs/pt/llm-gateway-connect#desktop-app). Implantações corporativas podem configurar Google Cloud's Agent Platform e provedores de gateway via [configurações gerenciadas](https://claude.com/docs/third-party/claude-desktop/configuration). Para Amazon Bedrock ou Microsoft Foundry no CLI, veja o [quickstart](/docs/pt/quickstart). Como uma exceção à seção acima, [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) executa a aba Code em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado.

920* **Linux (beta)**: Computer Use ainda não está disponível no aplicativo desktop Linux. Veja [Claude Desktop no Linux](/pt/desktop-linux).920* **Linux (beta)**: Computer Use ainda não está disponível no aplicativo desktop Linux. Veja [Claude Desktop no Linux](/docs/pt/desktop-linux).

921* **Sugestões de código inline**: Desktop não fornece sugestões no estilo autocompletar. Funciona através de prompts conversacionais e alterações de código explícitas.921* **Sugestões de código inline**: Desktop não fornece sugestões no estilo autocompletar. Funciona através de prompts conversacionais e alterações de código explícitas.

922* **Equipes de agentes**: sessões paralelas de Claude Code que se comunicam entre si estão disponíveis no [CLI](/pt/agent-teams), não em Desktop. Para trabalho multi-agente dentro de uma sessão, use [dynamic workflows](/pt/workflows), que são executados em Desktop.922* **Equipes de agentes**: sessões paralelas de Claude Code que se comunicam entre si estão disponíveis no [CLI](/docs/pt/agent-teams), não em Desktop. Para trabalho multi-agente dentro de uma sessão, use [dynamic workflows](/docs/pt/workflows), que são executados em Desktop.

923* **Comandos terminal-dialog**: comandos integrados que abrem um painel interativo no terminal se comportam de forma diferente na aba Code. Edite [arquivos de configuração](/pt/settings) diretamente para gerenciar regras de permissão e configuração, ou execute os comandos a partir do CLI autônomo.923* **Comandos terminal-dialog**: comandos integrados que abrem um painel interativo no terminal se comportam de forma diferente na aba Code. Edite [arquivos de configuração](/docs/pt/settings) diretamente para gerenciar regras de permissão e configuração, ou execute os comandos a partir do CLI autônomo.

924 * Comandos sem forma de argumento, como `/permissions`, respondem com `isn't available in this environment`.924 * Comandos sem forma de argumento, como `/permissions`, respondem com `isn't available in this environment`.

925 * `/config` abre Configurações → Claude Code. Texto após o comando é ignorado, então `/config theme=dark` não define o tema.925 * `/config` abre Configurações → Claude Code. Texto após o comando é ignorado, então `/config theme=dark` não define o tema.

926 926 


928 Solução de problemas928 Solução de problemas

929</h2>929</h2>

930 930 

931As seções abaixo cobrem problemas específicos do aplicativo desktop. Para erros de API de tempo de execução que aparecem no chat como `API Error: 500`, `529 Overloaded`, `429` ou `Prompt is too long`, veja a [referência de erros](/pt/errors). Esses erros e suas correções são os mesmos em CLI, desktop e web.931As seções abaixo cobrem problemas específicos do aplicativo desktop. Para erros de API de tempo de execução que aparecem no chat como `API Error: 500`, `529 Overloaded`, `429` ou `Prompt is too long`, veja a [referência de erros](/docs/pt/errors). Esses erros e suas correções são os mesmos em CLI, desktop e web.

932 932 

933<h3 id="check-your-version">933<h3 id="check-your-version">

934 Verificar sua versão934 Verificar sua versão


959Se o aplicativo abre mas mostra uma tela em branco ou não responsiva:959Se o aplicativo abre mas mostra uma tela em branco ou não responsiva:

960 960 

9611. Reinicie o aplicativo.9611. Reinicie o aplicativo.

9622. Verifique se há atualizações pendentes. Em macOS e Windows, o aplicativo se atualiza automaticamente ao iniciar; em Linux, atualize através do apt conforme descrito em [Claude Desktop no Linux](/pt/desktop-linux).9622. Verifique se há atualizações pendentes. Em macOS e Windows, o aplicativo se atualiza automaticamente ao iniciar; em Linux, atualize através do apt conforme descrito em [Claude Desktop no Linux](/docs/pt/desktop-linux).

9633. Em uma rede gerenciada, confirme que seu firewall permite os hosts CDN em [requisitos de acesso à rede](#network-access-requirements).9633. Em uma rede gerenciada, confirme que seu firewall permite os hosts CDN em [requisitos de acesso à rede](#network-access-requirements).

9644. No Windows, verifique o Event Viewer para logs de crash em **Windows Logs → Application**.9644. No Windows, verifique o Event Viewer para logs de crash em **Windows Logs → Application**.

965 965 

Details

8 8 

9Plugins estendem Claude Code com skills, agentes, hooks e MCP servers. Marketplaces de plugins são catálogos que ajudam você a descobrir e instalar essas extensões sem construí-las você mesmo.9Plugins estendem Claude Code com skills, agentes, hooks e MCP servers. Marketplaces de plugins são catálogos que ajudam você a descobrir e instalar essas extensões sem construí-las você mesmo.

10 10 

11Procurando criar e distribuir seu próprio marketplace? Veja [Criar e distribuir um marketplace de plugins](/pt/plugin-marketplaces).11Procurando criar e distribuir seu próprio marketplace? Veja [Criar e distribuir um marketplace de plugins](/docs/pt/plugin-marketplaces).

12 12 

13<h2 id="how-marketplaces-work">13<h2 id="how-marketplaces-work">

14 Como os marketplaces funcionam14 Como os marketplaces funcionam


43Se Claude Code relatar que o plugin não foi encontrado em nenhum marketplace, seu marketplace está ausente ou desatualizado. Execute `/plugin marketplace update claude-plugins-official` para atualizá-lo, ou `/plugin marketplace add anthropics/claude-plugins-official` se você não o adicionou antes. Depois tente instalar novamente.43Se Claude Code relatar que o plugin não foi encontrado em nenhum marketplace, seu marketplace está ausente ou desatualizado. Execute `/plugin marketplace update claude-plugins-official` para atualizá-lo, ou `/plugin marketplace add anthropics/claude-plugins-official` se você não o adicionou antes. Depois tente instalar novamente.

44 44 

45<Note>45<Note>

46 O marketplace oficial é mantido pela Anthropic, e a inclusão é a critério da Anthropic. Os formulários de envio no aplicativo adicionam plugins ao [marketplace da comunidade](#community-marketplace), não ao oficial. Para distribuir plugins independentemente, [crie seu próprio marketplace](/pt/plugin-marketplaces) e compartilhe com usuários.46 O marketplace oficial é mantido pela Anthropic, e a inclusão é a critério da Anthropic. Os formulários de envio no aplicativo adicionam plugins ao [marketplace da comunidade](#community-marketplace), não ao oficial. Para distribuir plugins independentemente, [crie seu próprio marketplace](/docs/pt/plugin-marketplaces) e compartilhe com usuários.

47</Note>47</Note>

48 48 

49O marketplace oficial inclui várias categorias de plugins:49O marketplace oficial inclui várias categorias de plugins:


70| Swift | `swift-lsp` | `sourcekit-lsp` |70| Swift | `swift-lsp` | `sourcekit-lsp` |

71| TypeScript | `typescript-lsp` | `typescript-language-server` |71| TypeScript | `typescript-lsp` | `typescript-language-server` |

72 72 

73Você também pode [criar seu próprio plugin LSP](/pt/plugins-reference#lsp-servers) para outras linguagens.73Você também pode [criar seu próprio plugin LSP](/docs/pt/plugins-reference#lsp-servers) para outras linguagens.

74 74 

75<Note>75<Note>

76 Se você vir `Executable not found in $PATH` na aba Errors do `/plugin` após instalar um plugin, instale o binário necessário da tabela acima.76 Se você vir `Executable not found in $PATH` na aba Errors do `/plugin` após instalar um plugin, instale o binário necessário da tabela acima.


91 Integrações externas91 Integrações externas

92</h3>92</h3>

93 93 

94Esses plugins agrupam [MCP servers](/pt/mcp) pré-configurados para que você possa conectar Claude a serviços externos sem configuração manual:94Esses plugins agrupam [MCP servers](/docs/pt/mcp) pré-configurados para que você possa conectar Claude a serviços externos sem configuração manual:

95 95 

96* **Controle de fonte**: `github`, `gitlab`96* **Controle de fonte**: `github`, `gitlab`

97* **Gerenciamento de projetos**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`97* **Gerenciamento de projetos**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`


104 Revisão automática de segurança104 Revisão automática de segurança

105</h3>105</h3>

106 106 

107O plugin `security-guidance` revisa cada mudança que Claude faz em busca de vulnerabilidades comuns e instrui Claude a corrigir o que encontra na mesma sessão. Veja [Catch security issues as Claude writes code](/pt/security-guidance) para o que ele verifica e como adicionar regras específicas do projeto.107O plugin `security-guidance` revisa cada mudança que Claude faz em busca de vulnerabilidades comuns e instrui Claude a corrigir o que encontra na mesma sessão. Veja [Catch security issues as Claude writes code](/docs/pt/security-guidance) para o que ele verifica e como adicionar regras específicas do projeto.

108 108 

109<h3 id="development-workflows">109<h3 id="development-workflows">

110 Fluxos de trabalho de desenvolvimento110 Fluxos de trabalho de desenvolvimento


142/plugin install <plugin-name>@claude-community142/plugin install <plugin-name>@claude-community

143```143```

144 144 

145Para enviar seu próprio plugin para o marketplace da comunidade, veja [Envie seu plugin para o marketplace da comunidade](/pt/plugins#submit-your-plugin-to-the-community-marketplace) no guia de criação de plugins.145Para enviar seu próprio plugin para o marketplace da comunidade, veja [Envie seu plugin para o marketplace da comunidade](/docs/pt/plugins#submit-your-plugin-to-the-community-marketplace) no guia de criação de plugins.

146 146 

147<h2 id="try-it-add-the-demo-marketplace">147<h2 id="try-it-add-the-demo-marketplace">

148 Experimente: adicione o marketplace de demonstração148 Experimente: adicione o marketplace de demonstração


169 * **Marketplaces**: adicione, remova ou atualize seus marketplaces adicionados169 * **Marketplaces**: adicione, remova ou atualize seus marketplaces adicionados

170 * **Errors**: visualize quaisquer erros de carregamento de plugins170 * **Errors**: visualize quaisquer erros de carregamento de plugins

171 171 

172 Vá para a aba **Discover** para ver plugins do marketplace que você acabou de adicionar. {/* min-version: 2.1.154 */}Quando seu administrador tiver adicionado o marketplace à lista de permissões por meio da configuração gerenciada [`pluginSuggestionMarketplaces`](/pt/settings#available-settings), plugins marcados como relevantes para seu diretório de trabalho atual são fixados no topo com um rótulo **suggested for this directory**.172 Vá para a aba **Discover** para ver plugins do marketplace que você acabou de adicionar. Quando seu administrador tiver adicionado o marketplace à lista de permissões por meio da configuração gerenciada [`pluginSuggestionMarketplaces`](/docs/pt/settings#available-settings), plugins marcados como relevantes para seu diretório de trabalho atual são fixados no topo com um rótulo **suggested for this directory**.

173 </Step>173 </Step>

174 174 

175 <Step title="Instale um plugin">175 <Step title="Instale um plugin">

176 Selecione um plugin para visualizar seus detalhes. O painel de detalhes mostra o que o plugin contém e quanto custa:176 Selecione um plugin para visualizar seus detalhes. O painel de detalhes mostra o que o plugin contém e quanto custa:

177 177 

178 * {/* min-version: 2.1.143 */}Uma estimativa de **Context cost** para que você possa ver quantos tokens o plugin adicionará à sua [janela de contexto](/pt/features-overview#understand-context-costs) a cada turno (Claude Code v2.1.143 e posterior)178 * Uma estimativa de **Context cost** para que você possa ver quantos tokens o plugin adicionará à sua [janela de contexto](/docs/pt/features-overview#understand-context-costs) a cada turno (Claude Code v2.1.143 e posterior)

179 * {/* min-version: 2.1.144 */}A data de **Last updated** do plugin (v2.1.144 e posterior)179 * A data de **Last updated** do plugin (v2.1.144 e posterior)

180 * {/* min-version: 2.1.145 */}Uma seção **Will install** listando os comandos, agentes, skills, hooks e servidores MCP e LSP do plugin, para que você possa revisar exatamente o que ele adiciona antes de instalar (v2.1.145 e posterior)180 * Uma seção **Will install** listando os comandos, agentes, skills, hooks e servidores MCP e LSP do plugin, para que você possa revisar exatamente o que ele adiciona antes de instalar (v2.1.145 e posterior)

181 181 

182 Escolha um escopo de instalação:182 Escolha um escopo de instalação:

183 183 


193 /plugin install commit-commands@claude-code-plugins193 /plugin install commit-commands@claude-code-plugins

194 ```194 ```

195 195 

196 Veja [Configuration scopes](/pt/settings#configuration-scopes) para aprender mais sobre escopos.196 Veja [Configuration scopes](/docs/pt/settings#configuration-scopes) para aprender mais sobre escopos.

197 </Step>197 </Step>

198 198 

199 <Step title="Use seu novo plugin">199 <Step title="Use seu novo plugin">


293```293```

294 294 

295<Note>295<Note>

296 Marketplaces baseados em URL têm algumas limitações comparadas a marketplaces baseados em Git. Se você encontrar erros "path not found" ao instalar plugins, veja [Troubleshooting](/pt/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).296 Marketplaces baseados em URL têm algumas limitações comparadas a marketplaces baseados em Git. Se você encontrar erros "path not found" ao instalar plugins, veja [Troubleshooting](/docs/pt/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).

297</Note>297</Note>

298 298 

299<h2 id="install-plugins">299<h2 id="install-plugins">


306/plugin install plugin-name@marketplace-name306/plugin install plugin-name@marketplace-name

307```307```

308 308 

309O comando abre os detalhes desse plugin, onde você escolhe um [escopo de instalação](/pt/settings#configuration-scopes). Você vê as mesmas opções quando executa `/plugin`, vai para a aba **Discover** e pressiona **Enter** em um plugin:309O comando abre os detalhes desse plugin, onde você escolhe um [escopo de instalação](/docs/pt/settings#configuration-scopes). Você vê as mesmas opções quando executa `/plugin`, vai para a aba **Discover** e pressiona **Enter** em um plugin:

310 310 

311* **User scope** (padrão): instale para você em todos os projetos311* **User scope** (padrão): instale para você em todos os projetos

312* **Project scope**: instale para todos os colaboradores neste repositório, o que adiciona o plugin a `.claude/settings.json`312* **Project scope**: instale para todos os colaboradores neste repositório, o que adiciona o plugin a `.claude/settings.json`

313* **Local scope**: instale para você neste repositório apenas, não compartilhado com colaboradores313* **Local scope**: instale para você neste repositório apenas, não compartilhado com colaboradores

314 314 

315Para instalar sem uma etapa interativa, use o comando shell [`claude plugin install`](/pt/plugins-reference#plugin-install), que instala no escopo de usuário a menos que você passe `--scope`.315Para instalar sem uma etapa interativa, use o comando shell [`claude plugin install`](/docs/pt/plugins-reference#plugin-install), que instala no escopo de usuário a menos que você passe `--scope`.

316 316 

317Você também pode ver plugins com escopo **managed**. Esses são instalados por administradores via [managed settings](/pt/settings#settings-files) e não podem ser modificados.317Você também pode ver plugins com escopo **managed**. Esses são instalados por administradores via [managed settings](/docs/pt/settings#settings-files) e não podem ser modificados.

318 318 

319<Warning>319<Warning>

320 Certifique-se de confiar em um plugin antes de instalá-lo. Anthropic não controla quais MCP servers, arquivos ou outro software estão incluídos em plugins e não pode verificar que funcionam conforme pretendido. Verifique a página inicial de cada plugin para mais informações.320 Certifique-se de confiar em um plugin antes de instalá-lo. Anthropic não controla quais MCP servers, arquivos ou outro software estão incluídos em plugins e não pode verificar que funcionam conforme pretendido. Verifique a página inicial de cada plugin para mais informações.


343* plugins que sua organização gerencia ou que você carrega com `--plugin-dir`343* plugins que sua organização gerencia ou que você carrega com `--plugin-dir`

344* plugins que contribuem um tema, estilo de saída, monitor ou workflow, já que entregam valor sem uma invocação para rastrear344* plugins que contribuem um tema, estilo de saída, monitor ou workflow, já que entregam valor sem uma invocação para rastrear

345 345 

346O cabeçalho **Not used recently** e a linha **Last used** estão ambos ocultos quando sua organização restringe marketplaces com [`strictKnownMarketplaces`](/pt/settings#strictknownmarketplaces).346O cabeçalho **Not used recently** e a linha **Last used** estão ambos ocultos quando sua organização restringe marketplaces com [`strictKnownMarketplaces`](/docs/pt/settings#strictknownmarketplaces).

347 347 

348Um [servidor de linguagem](/pt/plugins#add-lsp-servers-to-your-plugin) de um plugin conta como usado quando entrega diagnósticos ou responde a uma solicitação de navegação de código, então um plugin LSP cujo servidor está ativo em suas sessões não é listado como não utilizado. Antes de v2.1.203, a atividade do servidor de linguagem não podia ser contada como uso, então plugins que contribuem um servidor LSP eram isentos do grupo inteiramente, da mesma forma que plugins de tema e estilo de saída ainda são.348Um [servidor de linguagem](/docs/pt/plugins#add-lsp-servers-to-your-plugin) de um plugin conta como usado quando entrega diagnósticos ou responde a uma solicitação de navegação de código, então um plugin LSP cujo servidor está ativo em suas sessões não é listado como não utilizado. Antes de v2.1.203, a atividade do servidor de linguagem não podia ser contada como uso, então plugins que contribuem um servidor LSP eram isentos do grupo inteiramente, da mesma forma que plugins de tema e estilo de saída ainda são.

349 349 

350A primeira sessão em uma versão que conta a atividade do servidor de linguagem também redefine o registro de uso de cada plugin LSP que ainda não havia registrado nenhum uso, então Claude Code não julga um plugin que você instalou anteriormente como não utilizado com base em dados registrados antes da atividade do servidor ser rastreada. Antes de v2.1.206, essa primeira sessão poderia listar um plugin LSP ativamente usado sob **Not used recently** e sugerir revisá-lo.350A primeira sessão em uma versão que conta a atividade do servidor de linguagem também redefine o registro de uso de cada plugin LSP que ainda não havia registrado nenhum uso, então Claude Code não julga um plugin que você instalou anteriormente como não utilizado com base em dados registrados antes da atividade do servidor ser rastreada. Antes de v2.1.206, essa primeira sessão poderia listar um plugin LSP ativamente usado sob **Not used recently** e sugerir revisá-lo.

351 351 


373/plugin enable plugin-name@marketplace-name373/plugin enable plugin-name@marketplace-name

374```374```

375 375 

376Nestes identificadores, `plugin-name` é o `name` do plugin na [entrada do marketplace](/pt/plugin-marketplaces#plugin-entries), que pode diferir do `name` no próprio `plugin.json` do plugin.376Nestes identificadores, `plugin-name` é o `name` do plugin na [entrada do marketplace](/docs/pt/plugin-marketplaces#plugin-entries), que pode diferir do `name` no próprio `plugin.json` do plugin.

377 377 

378A partir do Claude Code v2.1.195, **Enable** e **Disable** na interface `/plugin` funcionam para plugins cujos dois nomes diferem, e `/plugin enable` e `/plugin disable` aceitam qualquer um dos nomes. Quando você desabilita tal plugin em uma versão anterior, Claude Code relata `already disabled` e o deixa habilitado.378A partir do Claude Code v2.1.195, **Enable** e **Disable** na interface `/plugin` funcionam para plugins cujos dois nomes diferem, e `/plugin enable` e `/plugin disable` aceitam qualquer um dos nomes. Quando você desabilita tal plugin em uma versão anterior, Claude Code relata `already disabled` e o deixa habilitado.

379 379 


402 402 

403Claude Code recarrega todos os plugins ativos e mostra contagens para plugins, skills, agentes, hooks, servidores MCP de plugin e servidores LSP de plugin.403Claude Code recarrega todos os plugins ativos e mostra contagens para plugins, skills, agentes, hooks, servidores MCP de plugin e servidores LSP de plugin.

404 404 

405O recarregamento tem um custo de token na próxima solicitação: componentes recém-carregados se anunciam no conteúdo anexado à conversa, enquanto o histórico existente ainda lê do cache de prompt. Um plugin que fornece servidores MCP custa mais quando suas ferramentas não são adiadas por [busca de ferramentas MCP](/pt/mcp#scale-with-mcp-tool-search): a mudança invalida o cache e a próxima solicitação relê toda a conversa. {/* min-version: 2.1.163 */}Nesse caso `/reload-plugins` mostra um aviso e não aplica o recarregamento; passe `--force` para aplicar mesmo assim. Consulte [habilitando ou desabilitando um plugin](/pt/prompt-caching#enabling-or-disabling-a-plugin) para obter detalhes.405O recarregamento tem um custo de token na próxima solicitação: componentes recém-carregados se anunciam no conteúdo anexado à conversa, enquanto o histórico existente ainda lê do cache de prompt. Um plugin que fornece servidores MCP custa mais quando suas ferramentas não são adiadas por [busca de ferramentas MCP](/docs/pt/mcp#scale-with-mcp-tool-search): a mudança invalida o cache e a próxima solicitação relê toda a conversa. Nesse caso `/reload-plugins` mostra um aviso e não aplica o recarregamento; passe `--force` para aplicar mesmo assim. Consulte [habilitando ou desabilitando um plugin](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin) para obter detalhes.

406 406 

407<h2 id="manage-marketplaces">407<h2 id="manage-marketplaces">

408 Gerencie marketplaces408 Gerencie marketplaces


466 466 

467Marketplaces oficiais da Anthropic têm atualização automática habilitada por padrão. Marketplaces de terceiros e de desenvolvimento local têm atualização automática desabilitada por padrão.467Marketplaces oficiais da Anthropic têm atualização automática habilitada por padrão. Marketplaces de terceiros e de desenvolvimento local têm atualização automática desabilitada por padrão.

468 468 

469Os administradores também podem definir `"autoUpdate": true` em cada entrada [`extraKnownMarketplaces`](/pt/settings#extraknownmarketplaces) nas configurações gerenciadas para habilitar a atualização automática para um marketplace da organização sem exigir que cada usuário alterne.469Os administradores também podem definir `"autoUpdate": true` em cada entrada [`extraKnownMarketplaces`](/docs/pt/settings#extraknownmarketplaces) nas configurações gerenciadas para habilitar a atualização automática para um marketplace da organização sem exigir que cada usuário alterne.

470 470 

471Para desabilitar todas as atualizações automáticas inteiramente para Claude Code e todos os plugins, defina a variável de ambiente `DISABLE_AUTOUPDATER`. Veja [Auto updates](/pt/setup#auto-updates) para detalhes.471Para desabilitar todas as atualizações automáticas inteiramente para Claude Code e todos os plugins, defina a variável de ambiente `DISABLE_AUTOUPDATER`. Veja [Auto updates](/docs/pt/setup#auto-updates) para detalhes.

472 472 

473Para manter atualizações automáticas de plugins habilitadas enquanto desabilita atualizações automáticas de Claude Code, defina `FORCE_AUTOUPDATE_PLUGINS=1` junto com `DISABLE_AUTOUPDATER`:473Para manter atualizações automáticas de plugins habilitadas enquanto desabilita atualizações automáticas de Claude Code, defina `FORCE_AUTOUPDATE_PLUGINS=1` junto com `DISABLE_AUTOUPDATER`:

474 474 


502}502}

503```503```

504 504 

505Para opções de configuração completas incluindo `extraKnownMarketplaces` e `enabledPlugins`, veja [Plugin settings](/pt/settings#plugin-settings).505Para opções de configuração completas incluindo `extraKnownMarketplaces` e `enabledPlugins`, veja [Plugin settings](/docs/pt/settings#plugin-settings).

506 506 

507<h2 id="security">507<h2 id="security">

508 Segurança508 Segurança

509</h2>509</h2>

510 510 

511Plugins e marketplaces são componentes altamente confiáveis que podem executar código arbitrário em sua máquina com seus privilégios de usuário. Instale apenas plugins e adicione marketplaces de fontes que você confia. Organizações podem restringir quais marketplaces os usuários podem adicionar usando [managed marketplace restrictions](/pt/plugin-marketplaces#managed-marketplace-restrictions).511Plugins e marketplaces são componentes altamente confiáveis que podem executar código arbitrário em sua máquina com seus privilégios de usuário. Instale apenas plugins e adicione marketplaces de fontes que você confia. Organizações podem restringir quais marketplaces os usuários podem adicionar usando [managed marketplace restrictions](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions).

512 512 

513<h2 id="troubleshooting">513<h2 id="troubleshooting">

514 Troubleshooting514 Troubleshooting


5242. **Atualize Claude Code**:5242. **Atualize Claude Code**:

525 * **Homebrew**: `brew upgrade claude-code`, ou `brew upgrade claude-code@latest` se você instalou esse cask525 * **Homebrew**: `brew upgrade claude-code`, ou `brew upgrade claude-code@latest` se você instalou esse cask

526 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`526 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`

527 * **Native installer**: Re-execute o comando de instalação de [Setup](/pt/setup)527 * **Native installer**: Re-execute o comando de instalação de [Setup](/docs/pt/setup)

5283. **Reinicie Claude Code**: Após atualizar, reinicie seu terminal e execute `claude` novamente.5283. **Reinicie Claude Code**: Após atualizar, reinicie seu terminal e execute `claude` novamente.

529 529 

530<h3 id="common-issues">530<h3 id="common-issues">


536* **Arquivos não encontrados após instalação**: Plugins são copiados para um cache, então caminhos referenciando arquivos fora do diretório do plugin não funcionarão536* **Arquivos não encontrados após instalação**: Plugins são copiados para um cache, então caminhos referenciando arquivos fora do diretório do plugin não funcionarão

537* **Skills de plugin não aparecendo**: Limpe o cache com `rm -rf ~/.claude/plugins/cache`, reinicie Claude Code e reinstale o plugin.537* **Skills de plugin não aparecendo**: Limpe o cache com `rm -rf ~/.claude/plugins/cache`, reinicie Claude Code e reinstale o plugin.

538 538 

539Para troubleshooting detalhado com soluções, veja [Troubleshooting](/pt/plugin-marketplaces#troubleshooting) no guia de marketplace. Para ferramentas de debugging, veja [Debugging and development tools](/pt/plugins-reference#debugging-and-development-tools).539Para troubleshooting detalhado com soluções, veja [Troubleshooting](/docs/pt/plugin-marketplaces#troubleshooting) no guia de marketplace. Para ferramentas de debugging, veja [Debugging and development tools](/docs/pt/plugins-reference#debugging-and-development-tools).

540 540 

541<h3 id="code-intelligence-issues">541<h3 id="code-intelligence-issues">

542 Problemas de code intelligence542 Problemas de code intelligence


550 Próximos passos550 Próximos passos

551</h2>551</h2>

552 552 

553* **Construa seus próprios plugins**: Veja [Plugins](/pt/plugins) para criar skills, agentes e hooks553* **Construa seus próprios plugins**: Veja [Plugins](/docs/pt/plugins) para criar skills, agentes e hooks

554* **Crie um marketplace**: Veja [Criar um marketplace de plugins](/pt/plugin-marketplaces) para distribuir plugins para sua equipe ou comunidade554* **Crie um marketplace**: Veja [Criar um marketplace de plugins](/docs/pt/plugin-marketplaces) para distribuir plugins para sua equipe ou comunidade

555* **Referência técnica**: Veja [Plugins reference](/pt/plugins-reference) para especificações completas555* **Referência técnica**: Veja [Plugins reference](/docs/pt/plugins-reference) para especificações completas

env-vars.md +198 −198

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](/pt/settings), uma [flag CLI](/pt/cli-reference) ou um comando em sessão como `/model`.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`.

10 10 

11Esta página aborda como:11Esta página aborda como:

12 12 


79| `.claude/settings.local.json` | Você, apenas neste projeto (adicione-o ao seu gitignore se você o criar manualmente) |79| `.claude/settings.local.json` | Você, apenas neste projeto (adicione-o ao seu gitignore se você o criar manualmente) |

80| Configurações gerenciadas | Todos na sua organização, implantados por um administrador |80| Configurações gerenciadas | Todos na sua organização, implantados por um administrador |

81 81 

82Veja [Arquivos de configurações](/pt/settings#settings-files) para onde cada arquivo reside e [Precedência de configurações](/pt/settings#settings-precedence) para como eles se combinam quando mais de um define a mesma variável.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.

83 83 

84<h2 id="precedence">84<h2 id="precedence">

85 Precedência85 Precedência


87 87 

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

89 89 

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`](/pt/settings#available-settings) lista as exceções.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.

91 91 

92Entre arquivos de configurações, os valores `env` seguem a [precedência de configurações](/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.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.

93 93 

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

95 95 


100</h2>100</h2>

101 101 

102| Variável | Propósito |102| Variável | Propósito |

103| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |103| :------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

105| `ANTHROPIC_AUTH_TOKEN` | Valor personalizado para o cabeçalho `Authorization` (o valor que você definir aqui será prefixado com `Bearer `) |105| `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](/pt/claude-platform-on-aws), gerada no AWS Console. Enviada como `x-api-key` e tem precedência sobre AWS SigV4 |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 |

107| `ANTHROPIC_AWS_BASE_URL` | Substitua a URL do endpoint [Claude Platform on AWS](/pt/claude-platform-on-aws). Use para regiões personalizadas ou ao rotear através de um [gateway LLM](/pt/llm-gateway). Padrão é `https://aws-external-anthropic.{AWS_REGION}.api.aws` |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` |

108| `ANTHROPIC_AWS_WORKSPACE_ID` | Obrigatório para [Claude Platform on AWS](/pt/claude-platform-on-aws). Enviado em cada solicitação como cabeçalho `anthropic-workspace-id` |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` |

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](/pt/mcp#scale-with-mcp-tool-search) é desabilitada por padrão. Defina `ENABLE_TOOL_SEARCH=true` se seu proxy encaminha blocos `tool_reference`. {/* min-version: 2.1.196 */}A partir de v2.1.196, [Remote Control](/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 |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 |

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](/pt/llm-gateway). Veja [Amazon Bedrock](/pt/amazon-bedrock) |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) |

111| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Substitua a URL do endpoint Amazon Bedrock Mantle. Veja [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) |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) |

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](/pt/amazon-bedrock#service-tiers) |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) |

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`](/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 |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 |

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

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](/pt/model-config#add-a-custom-model-option) |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) |

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

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

118| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |118| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 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](/pt/model-config#environment-variables) |119| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Veja [Configuração de modelo](/docs/pt/model-config#environment-variables) |

120| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |120| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | 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](/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) |

122| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Veja [Configuração de modelo](/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) |

123| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Veja [Configuração de modelo](/pt/model-config#environment-variables) |123| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Veja [Configuração de modelo](/docs/pt/model-config#environment-variables) |

124| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |124| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | 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](/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) |

126| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Veja [Configuração de modelo](/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) |

127| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Veja [Configuração de modelo](/pt/model-config#environment-variables) |127| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Veja [Configuração de modelo](/docs/pt/model-config#environment-variables) |

128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/docs/pt/model-config#customize-pinned-model-display-and-capabilities) |

129| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |129| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | 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](/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) |

131| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Veja [Configuração de modelo](/pt/model-config#environment-variables) |131| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Veja [Configuração de modelo](/docs/pt/model-config#environment-variables) |

132| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/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) |

133| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |133| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | 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](/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) |

135| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação do Microsoft Foundry (veja [Microsoft Foundry](/pt/microsoft-foundry)) |135| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação do Microsoft Foundry (veja [Microsoft Foundry](/docs/pt/microsoft-foundry)) |

136| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | {/* min-version: 2.1.203 */}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](/pt/microsoft-foundry). Requer Claude Code v2.1.203 ou posterior |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 |

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](/pt/microsoft-foundry)) |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)) |

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](/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)) |

139| `ANTHROPIC_MODEL` | Nome da configuração de modelo a usar (veja [Configuração de modelo](/pt/model-config#environment-variables)) |139| `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](/pt/costs) |140| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Nome do [modelo da classe Haiku para tarefas em segundo plano](/docs/pt/costs) |

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](/pt/amazon-bedrock#4-pin-model-versions) na região da sessão |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 |

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](/pt/llm-gateway). Veja [Google Cloud's Agent Platform](/pt/google-vertex-ai) |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) |

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](/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) |

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

145| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}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](/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](/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](/pt/google-vertex-ai), [Microsoft Foundry](/pt/microsoft-foundry), [Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/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 |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 |

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

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

148| `BASH_DEFAULT_TIMEOUT_MS` | Tempo limite padrão para comandos bash de longa duração (padrão: 120000, ou 2 minutos) |148| `BASH_DEFAULT_TIMEOUT_MS` | Tempo limite padrão para comandos bash de longa duração (padrão: 120000, ou 2 minutos) |

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](/pt/tools-reference#bash-tool-behavior) |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) |

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

151| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar [`claude --cloud`](/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 |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 |

152| `CLAUDECODE` | Defina como `1` em subprocessos que Claude Code gera (ferramentas Bash e PowerShell, sessões tmux, [hook](/pt/hooks) comandos, [linha de status](/pt/statusline) comandos, subprocessos [servidor MCP](/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 |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 |

153| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Quantos milissegundos antes da auto-continuação a contagem regressiva na tela aparece em um diálogo [`AskUserQuestion`](/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`](/pt/settings#available-settings) e `CLAUDE_AFK_TIMEOUT_MS`. Requer Claude Code v2.1.198 ou posterior |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 |

154| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Quantos milissegundos de tempo ocioso antes de um diálogo [`AskUserQuestion`](/pt/tools-reference) não respondido auto-continuar sem você. {/* min-version: 2.1.200 */}Auto-continuação está desativada por padrão; opte por participar com a configuração [`askUserQuestionTimeout`](/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 |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 |

155| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desabilitar todos os tipos de [subagente](/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 |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 |

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

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

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](/pt/claude-code-on-the-web) e em Sonnet 4.6 e Opus 4.6 sem [contexto estendido](/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](/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 |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 |

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

160| `CLAUDE_AX_SCREEN_READER` | {/* min-version: 2.1.181 */}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`](/pt/settings#available-settings) é `true`. A flag [`--ax-screen-reader`](/pt/cli-reference#cli-flags) tem precedência. Requer Claude Code v2.1.181 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 |

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

162| `CLAUDE_CLIENT_PRESENCE_FILE` | {/* min-version: 2.1.181 */}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](/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 |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 |

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

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

165| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para repintar a tela inteira em cada quadro em [renderização em tela cheia](/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](/pt/agent-view) no Windows |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 |

166| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro [esforço](/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](/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 |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 |

167| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](/pt/settings#available-settings)) |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)) |

168| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para parar Claude Code de abrir o navegador automaticamente quando um novo [artefato](/pt/artifacts) é publicado. Republicar um artefato existente não abre o navegador independentemente dessa configuração |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 |

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](/pt/llm-gateway). O cache da API Anthropic não é afetado |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 |

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](/pt/model-config#extended-context), exceto em Sonnet 5, que tem seu próprio [limite padrão](/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 |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 |

171| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Substitua a [conexão IDE](/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`](/pt/settings#global-config-settings) |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) |

172| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | {/* min-version: 2.1.207 */}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`](/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](/pt/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/pt/claude-platform-on-aws) e o [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint). Requer Claude Code v2.1.207 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 |

173| `CLAUDE_CODE_BRIDGE_SESSION_ID` | {/* min-version: 2.1.199 */}Definido automaticamente em subprocessos de ferramenta Bash e [comando hook](/pt/hooks) enquanto a sessão tem uma conexão [Remote Control](/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](/pt/claude-code-on-the-web), leia `CLAUDE_CODE_REMOTE_SESSION_ID` em vez disso |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 |

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](/pt/network-config#ca-certificate-store). Padrão é `bundled,system` |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` |

175| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Defina como `1` em subprocessos que Claude Code gera via ferramentas Bash, PowerShell e Monitor, [hook](/pt/hooks) comandos e [linha de status](/pt/statusline) comandos. Não definido para subprocessos [servidor MCP](/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 |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 |

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

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

178| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase-passe para `CLAUDE_CODE_CLIENT_KEY` criptografada (opcional) |178| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase-passe para `CLAUDE_CODE_CLIENT_KEY` criptografada (opcional) |

179| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | {/* max-version: 2.1.185 */}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 |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 |

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`](/pt/cli-reference#cli-flags) faz ambos de uma vez. Padrão é `~/.claude/debug/<session-id>.txt` |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` |

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

182| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desabilitar suporte a [janela de contexto de 1M](/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](/pt/model-config#sonnet-5-context-window) são tratadas como tendo uma janela de 200K. Útil para ambientes corporativos com requisitos de conformidade |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 |

183| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Defina como `1` para desabilitar [raciocínio adaptativo](/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`. {/* min-version: 2.1.111 */}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 |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 |

184| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Defina como `1` para desabilitar a [ferramenta advisor](/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 |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 |

185| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar [agentes em segundo plano e visualização de agentes](/pt/agent-view): `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/pt/settings#available-settings) |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) |

186| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desabilitar [renderização em tela cheia](/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`](/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](/pt/agent-view), que sempre usam renderização em tela cheia |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 |

187| `CLAUDE_CODE_DISABLE_ARTIFACT` | Defina como `1` para desabilitar a ferramenta [Artifact](/pt/artifacts), que publica saída de sessão como uma página web privada em claude.ai. Equivalente à configuração [`disableArtifact`](/pt/settings#available-settings) |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) |

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

189| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Defina como `1` para desabilitar [memória automática](/pt/memory#auto-memory). Defina como `0` para forçar a memória automática mesmo quando `--bare` mode ou [`autoMemoryEnabled: false`](/pt/settings#available-settings) desabilitaria de outra forma. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática |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 |

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

191| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | {/* min-version: 2.1.208 */}Defina como `1` para pular a verificação de que uma resposta de streaming [Amazon Bedrock](/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](/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 |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 |

192| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Defina como `1` para parar os comandos de shell em segundo plano em execução de uma [sessão em segundo plano](/pt/agent-view), fluxos de trabalho dinâmicos e, {/* min-version: 2.1.198 */}a partir de v2.1.198, subagentes em segundo plano quando o [supervisor](/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`](/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 |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 |

193| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Defina como `1` para parar Claude Code de encerrar [comandos de shell em segundo plano](/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 |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 |

194| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desabilitar as [skills](/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`](/pt/settings#available-settings); `0` não a substitui |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 |

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

196| `CLAUDE_CODE_DISABLE_CRON` | Defina como `1` para desabilitar [tarefas agendadas](/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 |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 |

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](/pt/mcp#scale-with-mcp-tool-search) é desabilitada e todas as ferramentas MCP carregam antecipadamente, mesmo quando `ENABLE_TOOL_SEARCH` está definido |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 |

198| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | {/* min-version: 2.1.198 */}Defina como `1` para desabilitar os [subagentes Explore e Plan](/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](/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 |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 |

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

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`](/pt/settings#available-settings). Veja [Pesquisas de qualidade de sessão](/pt/data-usage#session-quality-surveys) |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) |

201| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Defina como `1` para desabilitar [checkpointing](/pt/checkpointing) de arquivo. O comando `/rewind` não será capaz de restaurar alterações de código |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 |

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`](/pt/settings#available-settings) quando definido |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 |

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

204| `CLAUDE_CODE_DISABLE_MOUSE` | Defina como `1` para desabilitar rastreamento de mouse em [renderização em tela cheia](/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 |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 |

205| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Defina como `1` para desabilitar clique, arrasto e manipulação de hover em [renderização em tela cheia](/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 |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 |

206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Equivalente a definir `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` e `DISABLE_TELEMETRY` |206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Equivalente a definir `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` e `DISABLE_TELEMETRY` |

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

208| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | {/* min-version: 2.1.193 */}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](/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 |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 |

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

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

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

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](/pt/third-party-integrations), `0` igualmente omite o parâmetro, então as duas variáveis se comportam da mesma forma lá |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á |

213| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Defina como `1` para desabilitar rolagem virtual em [renderização em tela cheia](/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 |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 |

214| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desabilitar [workflows](/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/pt/settings#available-settings) |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) |

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](/pt/model-config#adjust-effort-level) |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) |

216| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}Defina como `1` para habilitar a adição de texto extra ao final do prompt do sistema de cada [subagente](/pt/sub-agents). A flag [`--append-subagent-system-prompt`](/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 |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 |

217| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.207 */}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](/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](/pt/permission-modes#eliminate-prompts-with-auto-mode) nesses provedores |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 |

218| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Substitua a disponibilidade de [recapitulação de sessão](/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`](/pt/settings#available-settings) é `false`. Tem precedência sobre a configuração e toggle `/config` |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` |

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](/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](/pt/prompt-caching) para esse turno |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 |

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](/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 |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 |

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](/pt/llm-gateway) |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) |

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`](/pt/settings#available-settings) que a sessão recebe; entregue a lista através de [MDM ou um arquivo de configurações gerenciado](/pt/settings#settings-files), já que [entrega gerenciada pelo servidor não está disponível em configurações de gateway](/pt/server-managed-settings#platform-availability) |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) |

223| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Removido em v2.1.142, quando o padrão de [modo rápido](/pt/fast-mode) mudou de Opus 4.6 para Opus 4.7 |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 |

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](/pt/interactive-mode#prompt-suggestions) |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) |

225| `CLAUDE_CODE_ENABLE_TASKS` | Controla se as sessões usam as ferramentas Task estruturadas (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou a ferramenta legada `TodoWrite`. {/* min-version: 2.1.142 */}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](/pt/interactive-mode#task-list) e [Migrar para ferramentas Task](/pt/agent-sdk/todo-tracking#migrate-to-task-tools) |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) |

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](/pt/monitoring-usage) |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) |

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

228| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para habilitar [equipes de agentes](/pt/agent-teams). As equipes de agentes são experimentais e desabilitadas por padrão |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 |

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. {/* min-version: 2.1.206 */}Um valor exportado em seu shell também se aplica às [sessões em segundo plano](/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 |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 |

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

231| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}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. {/* min-version: 2.1.178 */}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 |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 |

232| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}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 |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 |

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](/pt/fullscreen), isso não altera o renderizador |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 |

234| `CLAUDE_CODE_FORK_SUBAGENT` | Defina como `1` para permitir [subagentes bifurcados](/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`](/pt/commands) explícito funciona sem essa variável. Funciona em modo interativo e via SDK ou `claude -p` |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` |

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](/pt/setup#set-up-on-windows) |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) |

236| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles dos resultados quando Claude invoca a [ferramenta Glob](/pt/tools-reference#glob-tool-behavior). Incluído por padrão. Não afeta autocomplete de arquivo `@`, `ls`, Grep ou Read |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 |

237| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](/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`](/pt/settings#available-settings) |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) |

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

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

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

241| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular a auto-instalação de extensões IDE. Equivalente a definir [`autoInstallIdeExtension`](/pt/settings#global-config-settings) como `false` |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` |

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

243| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. {/* min-version: 2.1.193 */}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 |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 |

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](/pt/costs#reduce-token-usage) seja acionada |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 |

245| `CLAUDE_CODE_MAX_RETRIES` | Substitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10). {/* min-version: 2.1.186 */}Limitado a 15 a partir de v2.1.186; {/* min-version: 2.1.199 */}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 |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 |

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

247| `CLAUDE_CODE_MAX_TURNS` | Limite o número de voltas agentes quando nenhum limite explícito é passado. Equivalente a passar [`--max-turns`](/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 |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 |

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

249| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Tempo limite de inatividade em milissegundos para chamadas de ferramentas MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou [conector claude.ai](/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. {/* min-version: 2.1.203 */}Antes de v2.1.203, servidores stdio eram isentos do tempo limite de inatividade |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 |

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

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

252| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para habilitar [renderização em tela cheia](/pt/fullscreen), uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Equivalente à configuração [`tui`](/pt/settings#available-settings); você também pode alternar com `/tui fullscreen` |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` |

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

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

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`](/pt/authentication#generate-a-long-lived-token) |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) |

256| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Removido em v2.1.160 e agora é um no-op. Anteriormente fixava [modo rápido](/pt/fast-mode) em Claude Opus 4.6 em vez do padrão atual. Opus 4.6 não suporta mais modo rápido |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 |

257| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}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](/pt/monitoring-usage) |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) |

258| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tempo limite em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja [Monitoramento](/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) |

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](/pt/monitoring-usage#dynamic-headers) |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) |

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](/pt/monitoring-usage) |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) |

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](/pt/setup#auto-updates) |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) |

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

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

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](/pt/plugin-marketplaces#git-operations-time-out) |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) |

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](/pt/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |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) |

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

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](/pt/plugin-marketplaces#pre-populate-plugins-for-containers) |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) |

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

269| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Tempo máximo em milissegundos que [modo não interativo](/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 |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 |

270| `CLAUDE_CODE_PROCESS_WRAPPER` | {/* min-version: 2.1.208 */}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](/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](/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](/pt/corporate-launcher) |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) |

271| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}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)](/pt/monitoring-usage#traces-beta) |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) |

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](/pt/data-usage#default-behaviors-by-api-provider) |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) |

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

274| `CLAUDE_CODE_REMOTE` | Definido automaticamente como `true` quando Claude Code está em execução como uma [sessão em nuvem](/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 |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 |

275| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definido automaticamente em [sessões em nuvem](/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](/pt/claude-code-on-the-web#link-output-back-to-the-session) |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) |

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

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

278| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}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. {/* min-version: 2.1.199 */}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 |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 |

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`](/pt/cli-reference#cli-flags). Processos filhos gerados diretamente herdam a variável |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 |

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

281| `CLAUDE_CODE_SCROLL_SPEED` | Defina o multiplicador de rolagem da roda do mouse em [renderização em tela cheia](/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 |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 |

282| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Substitua o orçamento de tempo em milissegundos para hooks [SessionEnd](/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 |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 |

283| `CLAUDE_CODE_SESSION_ID` | Definido automaticamente em subprocessos de ferramenta Bash e PowerShell, subprocessos de [comando hook](/pt/hooks) e subprocessos [servidor MCP](/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 |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 |

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

285| `CLAUDE_CODE_SHELL_PREFIX` | Prefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos [hook](/pt/hooks), [linha de status](/pt/statusline) comandos, e comandos de inicialização de [servidor MCP](/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 |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 |

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`](/pt/headless#start-faster-with-bare-mode) |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) |

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

288| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Pule autenticação do lado do cliente para [Claude Platform on AWS](/pt/claude-platform-on-aws), para gateways que assinam solicitações por conta própria |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 |

289| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | {/* min-version: 2.1.207 */}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](/pt/amazon-bedrock#credential-caching-and-resolution-timeout). Requer Claude Code v2.1.207 ou posterior |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 |

290| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Pule autenticação AWS para Amazon Bedrock (por exemplo, ao usar um gateway LLM) |290| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Pule autenticação AWS para Amazon Bedrock (por exemplo, ao usar um gateway LLM) |

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. {/* min-version: 2.1.203 */}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 |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 |

292| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Pule autenticação AWS para Amazon Bedrock Mantle (por exemplo, ao usar um gateway LLM) |292| `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 |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 |

294| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Pule autenticação Google para Google Cloud's Agent Platform (por exemplo, ao usar um gateway LLM) |294| `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](/pt/hooks#stop) ou [SubagentStop](/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 |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 |

296| `CLAUDE_CODE_SUBAGENT_MODEL` | Veja [Configuração de modelo](/pt/model-config). {/* min-version: 2.1.196 */}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 |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 |

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

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

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

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](/pt/claude-code-on-the-web) sessões recebem suas skills habilitadas do claude.ai automaticamente; você não precisa definir isso lá |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á |

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

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

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`](/pt/settings) |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) |

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](/pt/interactive-mode#task-list) |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) |

305| `CLAUDE_CODE_TEAM_NAME` | Nome da equipe de agentes à qual este companheiro pertence. Definido automaticamente em membros de [equipe de agentes](/pt/agent-teams) |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) |

306| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | {/* min-version: 2.1.206 */}Substitua, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para que sua [equipe de agentes](/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 |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 |

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. {/* min-version: 2.1.161 */}A partir de v2.1.161, em macOS e Linux, subprocessos Bash [sandboxed](/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 |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 |

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](/pt/terminal-config) para outras configurações de 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 |

309| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Use [Claude Platform on AWS](/pt/claude-platform-on-aws) |309| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Use [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) |

310| `CLAUDE_CODE_USE_BEDROCK` | Use [Amazon Bedrock](/pt/amazon-bedrock) |310| `CLAUDE_CODE_USE_BEDROCK` | Use [Amazon Bedrock](/docs/pt/amazon-bedrock) |

311| `CLAUDE_CODE_USE_FOUNDRY` | Use [Microsoft Foundry](/pt/microsoft-foundry) |311| `CLAUDE_CODE_USE_FOUNDRY` | Use [Microsoft Foundry](/docs/pt/microsoft-foundry) |

312| `CLAUDE_CODE_USE_MANTLE` | Use o endpoint [Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) do Amazon Bedrock |312| `CLAUDE_CODE_USE_MANTLE` | Use o endpoint [Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) do Amazon Bedrock |

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

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](/pt/tools-reference#powershell-tool) |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) |

315| `CLAUDE_CODE_USE_VERTEX` | Use [Google Cloud's Agent Platform](/pt/google-vertex-ai) |315| `CLAUDE_CODE_USE_VERTEX` | Use [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) |

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

317| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}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`](/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 |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 |

318| `CLAUDE_EFFORT` | Definido automaticamente em subprocessos de ferramenta Bash e comandos hook para o [nível de esforço](/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](/pt/hooks). Apenas definido quando o modelo atual suporta o parâmetro de esforço |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 |

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](/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 |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 |

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

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. {/* min-version: 2.1.196 */}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. {/* min-version: 2.1.169 */}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` |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` |

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](/pt/hooks#persist-environment-variables), [Setup](/pt/hooks#setup), [CwdChanged](/pt/hooks#cwdchanged) e [FileChanged](/pt/hooks#filechanged) |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) |

323| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefixo para nomes de sessão [Remote Control](/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 |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 |

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

325| `DEBUG` | Defina como `1` para habilitar modo de depuração, equivalente a iniciar com [`--debug`](/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 |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 |

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

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

328| `DISABLE_COMPACT` | Defina como `1` para desabilitar toda compactação: tanto compactação automática quanto o comando manual `/compact` |328| `DISABLE_COMPACT` | Defina como `1` para desabilitar toda compactação: tanto compactação automática quanto o comando manual `/compact` |

329| `DISABLE_COST_WARNINGS` | Defina como `1` para desabilitar mensagens de aviso de custo |329| `DISABLE_COST_WARNINGS` | Defina como `1` para desabilitar mensagens de aviso de custo |

330| `DISABLE_DOCTOR_COMMAND` | Defina como `1` para ocultar a skill de verificação de configuração [`/doctor`](/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`. {/* min-version: 2.1.205 */}Antes de v2.1.205, essa variável ocultava a tela de diagnósticos `/doctor` |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` |

331| `DISABLE_ERROR_REPORTING` | Defina como `1` para optar por não participar do relatório de erros |331| `DISABLE_ERROR_REPORTING` | Defina como `1` para optar por não participar do relatório de erros |

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

333| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desabilitar o comando `/feedback`. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito |333| `DISABLE_FEEDBACK_COMMAND` | Defina como `1` para desabilitar o comando `/feedback`. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito |


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

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

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

340| `DISABLE_PROMPT_CACHING` | Defina como `1` para desabilitar [prompt caching](/pt/prompt-caching#disable-prompt-caching) para todos os modelos (tem precedência sobre configurações por modelo) |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) |

341| `DISABLE_PROMPT_CACHING_FABLE` | Defina como `1` para desabilitar prompt caching para modelos Fable |341| `DISABLE_PROMPT_CACHING_FABLE` | Defina como `1` para desabilitar prompt caching para modelos Fable |

342| `DISABLE_PROMPT_CACHING_HAIKU` | Defina como `1` para desabilitar prompt caching para modelos Haiku |342| `DISABLE_PROMPT_CACHING_HAIKU` | Defina como `1` para desabilitar prompt caching para modelos Haiku |

343| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desabilitar prompt caching para modelos Opus |343| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desabilitar prompt caching para modelos Opus |


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

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

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

349| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para desabilitar [servidores MCP claude.ai](/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`](/pt/settings#available-settings) em configurações em vez disso |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 |

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](/pt/amazon-bedrock), [Google Cloud's Agent Platform](/pt/google-vertex-ai), [Microsoft Foundry](/pt/microsoft-foundry) e [Claude Platform on AWS](/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 |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 |

351| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuado. Use `ENABLE_PROMPT_CACHING_1H` em vez disso |351| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuado. Use `ENABLE_PROMPT_CACHING_1H` em vez disso |

352| `ENABLE_TOOL_SEARCH` | Controla [busca de ferramentas MCP](/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 |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 |

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. {/* min-version: 2.1.160 */}A partir de v2.1.160, uma [cadeia de modelo fallback](/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 |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 |

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

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

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

357| `HTTP_PROXY` | Especifique servidor proxy HTTP para conexões de rede |357| `HTTP_PROXY` | Especifique servidor proxy HTTP para conexões de rede |

358| `HTTPS_PROXY` | Especifique servidor proxy HTTPS para conexões de rede |358| `HTTPS_PROXY` | Especifique servidor proxy HTTPS para conexões de rede |

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

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`](/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) |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) |

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`](/pt/cli-reference#cli-flags) em modo não interativo (a flag `-p`). Padrão é 5 |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 |

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](/pt/third-party-integrations), `0` igualmente omite o parâmetro, e modelos com [raciocínio adaptativo](/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` |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` |

363| `MCP_CLIENT_SECRET` | Segredo do cliente OAuth para servidores MCP que requerem [credenciais pré-configuradas](/pt/mcp#use-pre-configured-oauth-credentials). Evita o prompt interativo ao adicionar um servidor com `--client-secret` |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` |

364| `MCP_CONNECTION_NONBLOCKING` | Controla se a inicialização aguarda servidores MCP se conectarem antes da primeira consulta. {/* min-version: 2.1.142 */}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`](/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 |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 |

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`](/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 |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 |

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](/pt/mcp#use-pre-configured-oauth-credentials) |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) |

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

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

369| `MCP_TIMEOUT` | Tempo limite em milissegundos para inicialização do servidor MCP (padrão: 30000, ou 30 segundos) |369| `MCP_TIMEOUT` | Tempo limite em milissegundos para inicialização do servidor MCP (padrão: 30000, ou 30 segundos) |

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. {/* min-version: 2.1.203 */}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 |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 |

371| `NO_PROXY` | Lista de domínios e IPs para os quais as solicitações serão emitidas diretamente, contornando proxy |371| `NO_PROXY` | Lista de domínios e IPs para os quais as solicitações serão emitidas diretamente, contornando proxy |

372| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}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](/pt/monitoring-usage#assistant-response-event) |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) |

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](/pt/monitoring-usage#api-request-body-event) |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) |

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](/pt/monitoring-usage) |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) |

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](/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) |

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](/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) |

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](/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) |

378| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}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](/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) |

379| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {/* min-version: 2.1.161 */}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](/pt/monitoring-usage#multi-team-organization-support) |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) |

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](/pt/monitoring-usage) |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) |

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](/pt/monitoring-usage) |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) |

382| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Substitua o orçamento de caracteres para metadados de skill mostrados à [ferramenta Skill](/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 |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 |

383| `TASK_MAX_OUTPUT_LENGTH` | Número máximo de caracteres na saída de [subagente](/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 |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 |

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

385| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Substitua região para Claude 3.5 Haiku ao usar Google Cloud's Agent Platform |385| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Substitua região para Claude 3.5 Haiku ao usar Google Cloud's Agent Platform |

386| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Substitua região para Claude 3.5 Sonnet ao usar Google Cloud's Agent Platform |386| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Substitua região para Claude 3.5 Sonnet ao usar Google Cloud's Agent Platform |


392| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Substitua região para Claude Sonnet 4.5 ao usar Google Cloud's Agent Platform |392| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Substitua região para Claude Sonnet 4.5 ao usar Google Cloud's Agent Platform |

393| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Substitua região para Claude Opus 4.6 ao usar Google Cloud's Agent Platform |393| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Substitua região para Claude Opus 4.6 ao usar Google Cloud's Agent Platform |

394| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Substitua região para Claude Sonnet 4.6 ao usar Google Cloud's Agent Platform |394| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Substitua região para Claude Sonnet 4.6 ao usar Google Cloud's Agent Platform |

395| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Substitua região para Claude Opus 4.7 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.111 |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 |

396| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Substitua região para Claude Opus 4.8 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.154 |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 |

397| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Substitua região para Claude Sonnet 5 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.197 |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 |

398| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Substitua região para Claude Fable 5 ao usar Google Cloud's Agent Platform. Adicionado em v2.1.170 |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 |

399| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Substitua região para Claude Haiku 4.5 ao usar Google Cloud's Agent Platform |399| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Substitua região para Claude Haiku 4.5 ao usar Google Cloud's Agent Platform |

400 400 

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

402 402 

403<h2 id="see-also">403<h2 id="see-also">

404 Veja também404 Veja também

405</h2>405</h2>

406 406 

407* [Configurações](/pt/settings): todas as configurações `settings.json`, incluindo a chave `env`407* [Configurações](/docs/pt/settings): todas as configurações `settings.json`, incluindo a chave `env`

408* [Referência CLI](/pt/cli-reference): flags de tempo de inicialização408* [Referência CLI](/docs/pt/cli-reference): flags de tempo de inicialização

409* [Configuração de rede](/pt/network-config): configuração de proxy e TLS409* [Configuração de rede](/docs/pt/network-config): configuração de proxy e TLS

410* [Monitoramento](/pt/monitoring-usage): configuração OpenTelemetry410* [Monitoramento](/docs/pt/monitoring-usage): configuração OpenTelemetry

errors.md +148 −148

Details

6 6 

7> Procure mensagens de erro de tempo de execução do Claude Code com o que cada uma significa e como corrigi-la.7> Procure mensagens de erro de tempo de execução do Claude Code com o que cada uma significa e como corrigi-la.

8 8 

9Esta página lista os erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem incorretas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Troubleshoot installation and login](/pt/troubleshoot-install).9Esta página lista os erros de tempo de execução que o Claude Code exibe e como se recuperar de cada um, além do que verificar quando as respostas parecem incorretas sem um erro. Para erros de instalação como `command not found` ou falhas de TLS durante a configuração, consulte [Troubleshoot installation and login](/docs/pt/troubleshoot-install).

10 10 

11Esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/pt/desktop) e no [Claude Code na web](/pt/claude-code-on-the-web), já que todos os três envolvem a mesma CLI do Claude Code. Para problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.11Esses erros e comandos de recuperação se aplicam em toda a CLI, no [aplicativo Desktop](/docs/pt/desktop) e no [Claude Code na web](/docs/pt/claude-code-on-the-web), já que todos os três envolvem a mesma CLI do Claude Code. Para problemas específicos da superfície, consulte a seção de solução de problemas na página dessa superfície.

12 12 

13<Note>13<Note>

14 O Claude Code chama a API Claude para respostas do modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da plataforma Claude](https://platform.claude.com/docs/pt/api/errors).14 O Claude Code chama a API Claude para respostas do modelo, portanto, a maioria dos erros de tempo de execução mapeia para um código de erro de API subjacente. Esta página cobre o que cada erro significa dentro do Claude Code e como se recuperar. Para as definições de código de status HTTP bruto, consulte a [referência de erro da plataforma Claude](https://platform.claude.com/docs/pt/api/errors).


97 Tentativas automáticas97 Tentativas automáticas

98</h2>98</h2>

99 99 

100O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. {/* min-version: 2.1.198 */}A partir da v2.1.198, isso cobre conexões que caem no meio de uma resposta antes de qualquer saída visível ter sido transmitida: Claude Code re-emite a solicitação com o mesmo backoff e o turno continua em vez de parar com um erro de conexão. {/* min-version: 2.1.199 */}A partir da v2.1.199, throttles 429 temporários que não carregam os cabeçalhos de cota do seu plano também são repetidos quando você está conectado com uma assinatura claude.ai; versões anteriores os repetiam apenas para autenticações de chave de API e Enterprise.100O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. A partir da v2.1.198, isso cobre conexões que caem no meio de uma resposta antes de qualquer saída visível ter sido transmitida: Claude Code re-emite a solicitação com o mesmo backoff e o turno continua em vez de parar com um erro de conexão. A partir da v2.1.199, throttles 429 temporários que não carregam os cabeçalhos de cota do seu plano também são repetidos quando você está conectado com uma assinatura claude.ai; versões anteriores os repetiam apenas para autenticações de chave de API e Enterprise.

101 101 

102Algumas classes de falha não são repetidas, porque uma tentativa não pode ter sucesso:102Algumas classes de falha não são repetidas, porque uma tentativa não pode ter sucesso:

103 103 

104* {/* min-version: 2.1.199 */}A partir da v2.1.199, uma falha de validação de certificado TLS, como um proxy que inspeciona TLS, um pacote `NODE_EXTRA_CA_CERTS` ausente ou um certificado expirado, falha na primeira tentativa para que a correção apareça imediatamente em vez de após o orçamento de tentativa completo. Consulte [Erros de certificado SSL](#ssl-certificate-errors). Condições TLS transitórias, como um tempo limite de handshake, ainda são repetidas.104* A partir da v2.1.199, uma falha de validação de certificado TLS, como um proxy que inspeciona TLS, um pacote `NODE_EXTRA_CA_CERTS` ausente ou um certificado expirado, falha na primeira tentativa para que a correção apareça imediatamente em vez de após o orçamento de tentativa completo. Consulte [Erros de certificado SSL](#ssl-certificate-errors). Condições TLS transitórias, como um tempo limite de handshake, ainda são repetidas.

105* {/* min-version: 2.1.199 */}A partir da v2.1.199, um erro de servidor que chega depois que Claude já transmitiu saída visível mantém a resposta parcial e anexa um [aviso de resposta incompleta](#the-response-above-may-be-incomplete) em vez de tentar novamente, já que re-executar a solicitação poderia executar as mesmas chamadas de ferramentas duas vezes. Versões anteriores descartavam a saída parcial e relatavam o turno como um erro.105* A partir da v2.1.199, um erro de servidor que chega depois que Claude já transmitiu saída visível mantém a resposta parcial e anexa um [aviso de resposta incompleta](#the-response-above-may-be-incomplete) em vez de tentar novamente, já que re-executar a solicitação poderia executar as mesmas chamadas de ferramentas duas vezes. Versões anteriores descartavam a saída parcial e relatavam o turno como um erro.

106* {/* min-version: 2.1.208 */}Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type) falha na primeira tentativa, porque o gateway ou proxy reescrevendo a resposta reescreveria a tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.106* Uma [resposta de streaming do Amazon Bedrock com um tipo de conteúdo inesperado](#bedrock-streaming-response-has-an-unexpected-content-type) falha na primeira tentativa, porque o gateway ou proxy reescrevendo a resposta reescreveria a tentativa da mesma forma. Requer Claude Code v2.1.208 ou posterior.

107 107 

108Enquanto tenta novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica da primeira tentativa para falhas em que você pode agir imediatamente: a rede está inativa, um handshake TLS falhou ou você atingiu um limite de taxa. Para outros erros, ele lê `API error` no início. {/* min-version: 2.1.198 */}A partir da v2.1.198, ele muda para a razão específica da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.108Enquanto tenta novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y` após um rótulo de erro. O rótulo nomeia a razão específica da primeira tentativa para falhas em que você pode agir imediatamente: a rede está inativa, um handshake TLS falhou ou você atingiu um limite de taxa. Para outros erros, ele lê `API error` no início. A partir da v2.1.198, ele muda para a razão específica da terceira tentativa, ou na tentativa final quando `CLAUDE_CODE_MAX_RETRIES` permite menos de três; versões anteriores mudam apenas na tentativa final.

109 109 

110{/* min-version: 2.1.198 */}A partir da v2.1.198, a dica de spinner usual é suprimida durante tentativas. Uma vez que a razão do erro é revelada, se a falha for uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.110A partir da v2.1.198, a dica de spinner usual é suprimida durante tentativas. Uma vez que a razão do erro é revelada, se a falha for uma sobrecarga 529, a linha abaixo da contagem regressiva também nomeia onde verificar o status do serviço: `status.claude.com` na API Anthropic, ou o host do provedor ou gateway nomeado na mensagem em outras configurações.

111 111 

112{/* min-version: 2.1.185 */}Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto em que Claude Code interrompe a conexão travada e tenta novamente, portanto o banner desaparece por conta própria assim que os dados retomam ou a tentativa é bem-sucedida. A partir da v2.1.185, o limite é de 20 segundos; versões anteriores mostram o banner após 10 segundos com uma redação diferente. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api).112Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto em que Claude Code interrompe a conexão travada e tenta novamente, portanto o banner desaparece por conta própria assim que os dados retomam ou a tentativa é bem-sucedida. A partir da v2.1.185, o limite é de 20 segundos; versões anteriores mostram o banner após 10 segundos com uma redação diferente. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api).

113 113 

114Quando você vê um dos erros nesta página, essas tentativas já foram esgotadas, a menos que pertença a uma classe que não é repetida, como uma falha de validação de certificado. Você pode ajustar o comportamento com estas variáveis de ambiente:114Quando você vê um dos erros nesta página, essas tentativas já foram esgotadas, a menos que pertença a uma classe que não é repetida, como uma falha de validação de certificado. Você pode ajustar o comportamento com estas variáveis de ambiente:

115 115 

116| Variável | Padrão | Efeito |116| Variável | Padrão | Efeito |

117| :------------------------------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |117| :------------------------------------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

118| [`CLAUDE_CODE_MAX_RETRIES`](/pt/env-vars) | 10 | Número de tentativas de repetição. {/* min-version: 2.1.186 */}Limitado a 15 a partir da v2.1.186; {/* min-version: 2.1.199 */}a partir da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Reduza-o para expor falhas mais rapidamente em scripts. |118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/pt/env-vars) | 10 | Número de tentativas de repetição. 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. Reduza-o para expor falhas mais rapidamente em scripts. |

119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/pt/env-vars) | não definido | Defina como `1` em sessões autônomas, como trabalhos de CI, para repetir erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. {/* min-version: 2.1.199 */}A partir da v2.1.199, também aumenta a contagem de tentativas padrão para outros erros transitórios, como erros de servidor, tempos limite e conexões perdidas, 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. |119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/pt/env-vars) | não definido | Defina como `1` em sessões autônomas, como trabalhos de CI, para repetir erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. A partir da v2.1.199, também aumenta a contagem de tentativas padrão para outros erros transitórios, como erros de servidor, tempos limite e conexões perdidas, 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. |

120| [`API_TIMEOUT_MS`](/pt/env-vars) | 600000 | Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. |120| [`API_TIMEOUT_MS`](/docs/pt/env-vars) | 600000 | Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. |

121 121 

122<h2 id="server-errors">122<h2 id="server-errors">

123 Erros do servidor123 Erros do servidor


196API Error: Response stalled mid-stream. The response above may be incomplete.196API Error: Response stalled mid-stream. The response above may be incomplete.

197```197```

198 198 

199* {/* min-version: 2.1.199 */}`Server error mid-response`: um erro de servidor sobrecarregado ou 5xx no meio do stream. Esta variante requer Claude Code v2.1.199 ou posterior; antes disso, esse caso descartava a saída parcial e relatava toda a vez como um erro.199* `Server error mid-response`: um erro de servidor sobrecarregado ou 5xx no meio do stream. Esta variante requer Claude Code v2.1.199 ou posterior; antes disso, esse caso descartava a saída parcial e relatava toda a vez como um erro.

200* `Connection closed mid-response`: a conexão foi interrompida.200* `Connection closed mid-response`: a conexão foi interrompida.

201* `Response stalled mid-stream`: o stream parou de enviar dados.201* `Response stalled mid-stream`: o stream parou de enviar dados.

202 202 


210 Auto mode cannot determine the safety of an action210 Auto mode cannot determine the safety of an action

211</h3>211</h3>

212 212 

213O modelo que [auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode) usa para classificar ações não conseguiu produzir uma decisão, então o auto mode não aprovou a ação automaticamente. A mensagem que você vê depende de por que o classificador falhou.213O modelo que [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) usa para classificar ações não conseguiu produzir uma decisão, então o auto mode não aprovou a ação automaticamente. A mensagem que você vê depende de por que o classificador falhou.

214 214 

215Leituras, buscas e edições dentro do seu diretório de trabalho ignoram o classificador, então elas continuam funcionando em todos esses casos.215Leituras, buscas e edições dentro do seu diretório de trabalho ignoram o classificador, então elas continuam funcionando em todos esses casos.

216 216 


224 224 

225* Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria225* Tente novamente após alguns segundos; Claude vê a mesma mensagem e geralmente tenta novamente por conta própria

226* Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde226* Se as tentativas continuarem falhando, continue com tarefas somente leitura e volte à ação bloqueada mais tarde

227* Isso é transitório e não relacionado à [auto mode eligibility](/pt/permission-modes#eliminate-prompts-with-auto-mode); você não precisa alterar as configurações227* Isso é transitório e não relacionado à [auto mode eligibility](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode); você não precisa alterar as configurações

228 228 

229Quando o classificador retornou uma resposta não analisável:229Quando o classificador retornou uma resposta não analisável:

230 230 


247 247 

248* Isso não é uma decisão sobre sua ação. O conteúdo já em sua conversa acionou um filtro de segurança na API quando o auto mode enviou a conversa para o classificador248* Isso não é uma decisão sobre sua ação. O conteúdo já em sua conversa acionou um filtro de segurança na API quando o auto mode enviou a conversa para o classificador

249* Tentar novamente não ajudará; o mesmo conteúdo da conversa acionará o filtro novamente249* Tentar novamente não ajudará; o mesmo conteúdo da conversa acionará o filtro novamente

250* Mude para um [permission mode](/pt/permission-modes) diferente para que você possa aprovar a ação quando solicitado, ou inicie uma conversa nova sem o conteúdo que acionou250* Mude para um [permission mode](/docs/pt/permission-modes) diferente para que você possa aprovar a ação quando solicitado, ou inicie uma conversa nova sem o conteúdo que acionou

251 251 

252Quando a conversa cresceu além da janela de contexto do classificador:252Quando a conversa cresceu além da janela de contexto do classificador:

253 253 


255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

256```256```

257 257 

258Em uma sessão interativa, o auto mode volta a um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente. No [non-interactive mode](/pt/headless) a execução é abortada porque a transcrição só cresce e tentar novamente não pode ter sucesso.258Em uma sessão interativa, o auto mode volta a um prompt de permissão normal para essa ação para que você possa aprová-la ou negá-la manualmente. No [non-interactive mode](/docs/pt/headless) a execução é abortada porque a transcrição só cresce e tentar novamente não pode ter sucesso.

259 259 

260**O que fazer:**260**O que fazer:**

261 261 


266 Agent terminated early due to an API error266 Agent terminated early due to an API error

267</h3>267</h3>

268 268 

269{/* min-version: 2.1.199 */}A solicitação de API de um [subagent](/pt/sub-agents) falhou terminalmente, por exemplo porque um limite de uso foi atingido ou as tentativas de um erro de servidor se esgotaram, então o subagent parou antes de terminar sua tarefa. Esta mensagem requer Claude Code v2.1.199 ou posterior; antes disso, o texto de erro da API era retornado para Claude como se fosse o resultado do subagent.269A solicitação de API de um [subagent](/docs/pt/sub-agents) falhou terminalmente, por exemplo porque um limite de uso foi atingido ou as tentativas de um erro de servidor se esgotaram, então o subagent parou antes de terminar sua tarefa. Esta mensagem requer Claude Code v2.1.199 ou posterior; antes disso, o texto de erro da API era retornado para Claude como se fosse o resultado do subagent.

270 270 

271```text theme={null}271```text theme={null}

272Agent terminated early due to an API error: <error detail>272Agent terminated early due to an API error: <error detail>


275**O que fazer:**275**O que fazer:**

276 276 

277* Corresponda o detalhe do erro após os dois pontos à sua própria seção nesta página, como [Usage limits](#usage-limits) ou [Server errors](#server-errors), e siga as etapas dessa seção277* Corresponda o detalhe do erro após os dois pontos à sua própria seção nesta página, como [Usage limits](#usage-limits) ou [Server errors](#server-errors), e siga as etapas dessa seção

278* Depois que o erro subjacente for resolvido, peça a Claude para tentar novamente a tarefa ou [resume the subagent](/pt/sub-agents#resume-subagents)278* Depois que o erro subjacente for resolvido, peça a Claude para tentar novamente a tarefa ou [resume the subagent](/docs/pt/sub-agents#resume-subagents)

279 279 

280Quando uma limitação de taxa, sobrecarga ou erro de servidor interrompe um subagent em primeiro plano que já produziu saída de texto, Claude recebe essa saída parcial marcada como incompleta em vez deste erro. {/* min-version: 2.1.200 */}Um subagent cuja única saída foram chamadas de ferramenta também recebe este erro; na v2.1.199 isso retornou um resultado parcial vazio. Consulte [API errors in subagents](/pt/sub-agents#api-errors-in-subagents).280Quando uma limitação de taxa, sobrecarga ou erro de servidor interrompe um subagent em primeiro plano que já produziu saída de texto, Claude recebe essa saída parcial marcada como incompleta em vez deste erro. Um subagent cuja única saída foram chamadas de ferramenta também recebe este erro; na v2.1.199 isso retornou um resultado parcial vazio. Consulte [API errors in subagents](/docs/pt/sub-agents#api-errors-in-subagents).

281 281 

282<h2 id="usage-limits">282<h2 id="usage-limits">

283 Limites de uso283 Limites de uso


309* Execute `/usage-credits` para comprar uso adicional em Pro e Max, ou para solicitá-lo ao seu administrador em Team e Enterprise. Consulte [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber como isso é cobrado.309* Execute `/usage-credits` para comprar uso adicional em Pro e Max, ou para solicitá-lo ao seu administrador em Team e Enterprise. Consulte [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber como isso é cobrado.

310* Para atualizar seu plano para limites base mais altos, consulte [claude.com/pricing](https://claude.com/pricing)310* Para atualizar seu plano para limites base mais altos, consulte [claude.com/pricing](https://claude.com/pricing)

311 311 

312Para monitorar sua permissão restante antes de atingir o limite, adicione os campos `rate_limits` a uma [custom status line](/pt/statusline#rate-limit-usage), ou no aplicativo Desktop clique no [usage ring](/pt/desktop#check-usage) ao lado do seletor de modelo.312Para monitorar sua permissão restante antes de atingir o limite, adicione os campos `rate_limits` a uma [custom status line](/docs/pt/statusline#rate-limit-usage), ou no aplicativo Desktop clique no [usage ring](/docs/pt/desktop#check-usage) ao lado do seletor de modelo.

313 313 

314<h3 id="usage-credits-required-for-1m-context">314<h3 id="usage-credits-required-for-1m-context">

315 Créditos de uso necessários para contexto de 1M315 Créditos de uso necessários para contexto de 1M


321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

322```322```

323 323 

324Esta é uma verificação de direito, não um esgotamento de cota. Ela é acionada mesmo quando suas permissões de sessão e semanais têm capacidade restante. Consulte [Extended context](/pt/model-config#extended-context) para saber quais planos incluem contexto de 1M diretamente e quais exigem créditos de uso.324Esta é uma verificação de direito, não um esgotamento de cota. Ela é acionada mesmo quando suas permissões de sessão e semanais têm capacidade restante. Consulte [Extended context](/docs/pt/model-config#extended-context) para saber quais planos incluem contexto de 1M diretamente e quais exigem créditos de uso.

325 325 

326{/* min-version: 2.1.172 */}Quando esse erro aparece no meio de uma conversa porque o contexto cresceu além de 200K tokens, Claude Code compacta automaticamente a conversa de volta para o limite de contexto padrão e mantém a sessão nesse limite depois, portanto nenhuma ação é necessária. Em versões anteriores à v2.1.172, o erro se repetia em cada solicitação subsequente, incluindo `/compact`; execute `/clear` nessas versões para recuperar. As etapas abaixo se aplicam quando você selecionou explicitamente um modelo `[1m]`.326Quando esse erro aparece no meio de uma conversa porque o contexto cresceu além de 200K tokens, Claude Code compacta automaticamente a conversa de volta para o limite de contexto padrão e mantém a sessão nesse limite depois, portanto nenhuma ação é necessária. Em versões anteriores à v2.1.172, o erro se repetia em cada solicitação subsequente, incluindo `/compact`; execute `/clear` nessas versões para recuperar. As etapas abaixo se aplicam quando você selecionou explicitamente um modelo `[1m]`.

327 327 

328**O que fazer:**328**O que fazer:**

329 329 

330* Execute `/model` e selecione a variante sem o sufixo `[1m]` para voltar à janela de contexto padrão330* Execute `/model` e selecione a variante sem o sufixo `[1m]` para voltar à janela de contexto padrão

331* Execute `/usage-credits` para ativar a cobrança medida para a variante 1M em Pro e Max, ou para solicitá-la ao seu administrador em Team e Enterprise331* Execute `/usage-credits` para ativar a cobrança medida para a variante 1M em Pro e Max, ou para solicitá-la ao seu administrador em Team e Enterprise

332* Se o erro persistir após `/model`, uma ID de modelo 1M pode estar definida em outro lugar. Consulte [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) para os locais de configuração a verificar em ordem de prioridade.332* Se o erro persistir após `/model`, uma ID de modelo 1M pode estar definida em outro lugar. Consulte [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) para os locais de configuração a verificar em ordem de prioridade.

333* Para remover variantes 1M do seletor de modelo completamente, defina [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/pt/env-vars)333* Para remover variantes 1M do seletor de modelo completamente, defina [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/pt/env-vars)

334 334 

335<h3 id="server-is-temporarily-limiting-requests">335<h3 id="server-is-temporarily-limiting-requests">

336 O servidor está limitando temporariamente as solicitações336 O servidor está limitando temporariamente as solicitações


342API Error: Server is temporarily limiting requests (not your usage limit)342API Error: Server is temporarily limiting requests (not your usage limit)

343```343```

344 344 

345Claude Code diferencia esses dos seus limites de plano pela ausência dos cabeçalhos de cota unificados que uma resposta de limite real carrega. {/* min-version: 2.1.199 */}A partir da v2.1.199 isso é [retentado automaticamente](#automatic-retries) com backoff antes de ser mostrado, independentemente de como você se autentica. Em versões anteriores, uma sessão conectada com uma assinatura claude.ai falhou a vez na primeira ocorrência; apenas autenticações de chave de API e Enterprise a retentaram.345Claude Code diferencia esses dos seus limites de plano pela ausência dos cabeçalhos de cota unificados que uma resposta de limite real carrega. A partir da v2.1.199 isso é [retentado automaticamente](#automatic-retries) com backoff antes de ser mostrado, independentemente de como você se autentica. Em versões anteriores, uma sessão conectada com uma assinatura claude.ai falhou a vez na primeira ocorrência; apenas autenticações de chave de API e Enterprise a retentaram.

346 346 

347**O que fazer:**347**O que fazer:**

348 348 


366* Execute `/status` e confirme que a credencial ativa é a que você espera. Um `ANTHROPIC_API_KEY` deslocado em seu ambiente pode rotear solicitações através de uma chave de nível baixo em vez de sua assinatura.366* Execute `/status` e confirme que a credencial ativa é a que você espera. Um `ANTHROPIC_API_KEY` deslocado em seu ambiente pode rotear solicitações através de uma chave de nível baixo em vez de sua assinatura.

367* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário367* Verifique seu console de provedor para os limites ativos e solicite um nível mais alto se necessário

368* Para chaves de API do Anthropic, consulte a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace368* Para chaves de API do Anthropic, consulte a [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) para saber como os níveis funcionam e como definir limites por workspace

369* Reduza a concorrência: diminua [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/pt/env-vars), evite executar muitos subagentes paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume369* Reduza a concorrência: diminua [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/pt/env-vars), evite executar muitos subagentes paralelos, ou mude para um modelo menor com `/model` para execuções de script de alto volume

370 370 

371<h3 id="credit-balance-is-too-low">371<h3 id="credit-balance-is-too-low">

372 Saldo de crédito muito baixo372 Saldo de crédito muito baixo


382 382 

383* Adicione créditos em [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considere ativar o auto-reload lá para que o saldo seja recarregado antes de chegar a zero383* Adicione créditos em [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considere ativar o auto-reload lá para que o saldo seja recarregado antes de chegar a zero

384* Mude para autenticação de assinatura com `/login` se você tiver um plano Pro, Max, Team ou Enterprise384* Mude para autenticação de assinatura com `/login` se você tiver um plano Pro, Max, Team ou Enterprise

385* Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Consulte [Manage costs effectively](/pt/costs).385* Defina limites de gastos por workspace no Console para evitar que um único projeto drene o saldo da organização. Consulte [Manage costs effectively](/docs/pt/costs).

386 386 

387<h2 id="authentication-errors">387<h2 id="authentication-errors">

388 Erros de autenticação388 Erros de autenticação


404 404 

405* Execute `/login` para autenticar com sua assinatura Claude ou conta Console405* Execute `/login` para autenticar com sua assinatura Claude ou conta Console

406* Se você esperava que uma variável de ambiente o autenticasse, confirme que `ANTHROPIC_API_KEY` está definida e exportada no shell onde você iniciou `claude`406* Se você esperava que uma variável de ambiente o autenticasse, confirme que `ANTHROPIC_API_KEY` está definida e exportada no shell onde você iniciou `claude`

407* Para CI ou automação onde login interativo não é possível, configure um script [`apiKeyHelper`](/pt/settings#available-settings) que busque uma chave na inicialização407* Para CI ou automação onde login interativo não é possível, configure um script [`apiKeyHelper`](/docs/pt/settings#available-settings) que busque uma chave na inicialização

408* Consulte [Precedência de autenticação](/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes408* Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence) para entender qual credencial Claude Code usa quando várias estão presentes

409 409 

410Se você for solicitado a fazer login repetidamente, consulte [Não conectado ou token expirado](/pt/troubleshoot-install#not-logged-in-or-token-expired) para correções de relógio do sistema e Keychain do macOS.410Se você for solicitado a fazer login repetidamente, consulte [Não conectado ou token expirado](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired) para correções de relógio do sistema e Keychain do macOS.

411 411 

412<h3 id="could-not-resolve-authentication-method">412<h3 id="could-not-resolve-authentication-method">

413 Não foi possível resolver o método de autenticação413 Não foi possível resolver o método de autenticação

414</h3>414</h3>

415 415 

416A sessão chegou ao cliente da API sem nenhuma credencial. Isso aparece em [sessões em segundo plano](/pt/agent-view), sessões em nuvem e contextos do Agent SDK onde a verificação de login interativo não é executada antes da primeira solicitação.416A sessão chegou ao cliente da API sem nenhuma credencial. Isso aparece em [sessões em segundo plano](/docs/pt/agent-view), sessões em nuvem e contextos do Agent SDK onde a verificação de login interativo não é executada antes da primeira solicitação.

417 417 

418```text theme={null}418```text theme={null}

419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

420```420```

421 421 

422{/* min-version: 2.1.174 */}Antes da v2.1.174, uma sessão em segundo plano ou em nuvem atribuída a um worker pré-inicializado ocioso poderia falhar dessa forma mesmo quando credenciais válidas foram configuradas. Atualize para recuperar. Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo do worker.422Antes da v2.1.174, uma sessão em segundo plano ou em nuvem atribuída a um worker pré-inicializado ocioso poderia falhar dessa forma mesmo quando credenciais válidas foram configuradas. Atualize para recuperar. Nas versões atuais, o erro significa que nenhuma credencial estava disponível para o processo do worker.

423 423 

424**O que fazer:**424**O que fazer:**

425 425 

426* Atualize para v2.1.174 ou posterior se isso aparecer em uma sessão em segundo plano ou em nuvem e suas credenciais já estiverem configuradas426* Atualize para v2.1.174 ou posterior se isso aparecer em uma sessão em segundo plano ou em nuvem e suas credenciais já estiverem configuradas

427* Confirme que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou suas credenciais do provedor de nuvem estão definidas no ambiente que inicia o worker, não apenas no seu shell interativo427* Confirme que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou suas credenciais do provedor de nuvem estão definidas no ambiente que inicia o worker, não apenas no seu shell interativo

428* Para o Agent SDK, consulte [configuração de autenticação](/pt/agent-sdk/overview#get-started)428* Para o Agent SDK, consulte [configuração de autenticação](/docs/pt/agent-sdk/overview#get-started)

429* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida429* Execute `/status` em uma sessão interativa no mesmo ambiente para confirmar qual fonte de credencial é resolvida

430 430 

431<h3 id="invalid-api-key">431<h3 id="invalid-api-key">


443* Verifique se há erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)443* Verifique se há erros de digitação e confirme que a chave não foi revogada no [Console](https://platform.claude.com/settings/keys)

444* Execute `env | grep ANTHROPIC` no mesmo shell. Ferramentas como direnv, plugins de shell dotenv e terminais IDE podem carregar uma chave obsoleta de um arquivo `.env` em seu projeto sem você defini-la explicitamente.444* Execute `env | grep ANTHROPIC` no mesmo shell. Ferramentas como direnv, plugins de shell dotenv e terminais IDE podem carregar uma chave obsoleta de um arquivo `.env` em seu projeto sem você defini-la explicitamente.

445* Desdefina `ANTHROPIC_API_KEY` e execute `/login` para usar autenticação de assinatura445* Desdefina `ANTHROPIC_API_KEY` e execute `/login` para usar autenticação de assinatura

446* Se a chave vem de um script [`apiKeyHelper`](/pt/settings#available-settings), execute o script diretamente para confirmar que ele imprime uma chave válida em stdout446* Se a chave vem de um script [`apiKeyHelper`](/docs/pt/settings#available-settings), execute o script diretamente para confirmar que ele imprime uma chave válida em stdout

447* Execute `/status` para confirmar qual fonte de credencial Claude Code está realmente usando447* Execute `/status` para confirmar qual fonte de credencial Claude Code está realmente usando

448 448 

449<h3 id="your-apikeyhelper-script-is-failing">449<h3 id="your-apikeyhelper-script-is-failing">

450 Seu script apiKeyHelper está falhando450 Seu script apiKeyHelper está falhando

451</h3>451</h3>

452 452 

453O comando configurado na configuração [`apiKeyHelper`](/pt/settings#available-settings) saiu com um erro, expirou ou não imprimiu nada em stdout. Sem uma chave do script, a solicitação chega à API com uma credencial de espaço reservado, e a API a rejeita com `401`.453O comando configurado na configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) saiu com um erro, expirou ou não imprimiu nada em stdout. Sem uma chave do script, a solicitação chega à API com uma credencial de espaço reservado, e a API a rejeita com `401`.

454 454 

455```text theme={null}455```text theme={null}

456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

457```457```

458 458 

459Claude Code executa novamente o script e tenta novamente a solicitação até mais duas vezes antes de mostrar esta mensagem, portanto a falha aparece dentro de três tentativas. {/* min-version: 2.1.208 */}Antes da v2.1.208, Claude Code gastava o [orçamento de tentativas](#automatic-retries) completo reenviando a solicitação com a credencial de espaço reservado e depois relatava um erro de autenticação `401` genérico em vez da falha do script.459Claude Code executa novamente o script e tenta novamente a solicitação até mais duas vezes antes de mostrar esta mensagem, portanto a falha aparece dentro de três tentativas. Antes da v2.1.208, Claude Code gastava o [orçamento de tentativas](#automatic-retries) completo reenviando a solicitação com a credencial de espaço reservado e depois relatava um erro de autenticação `401` genérico em vez da falha do script.

460 460 

461Executar `/login` não ajuda aqui: a saída do helper [tem precedência](/pt/authentication#authentication-precedence) sobre um login salvo enquanto a configuração estiver presente.461Executar `/login` não ajuda aqui: a saída do helper [tem precedência](/docs/pt/authentication#authentication-precedence) sobre um login salvo enquanto a configuração estiver presente.

462 462 

463**O que fazer:**463**O que fazer:**

464 464 

465* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha465* Execute o comando configurado em `apiKeyHelper` diretamente no seu shell para reproduzir a falha

466* Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credenciais, por exemplo, fazendo login novamente em seu SSO ou cofre de segredos466* Se o comando relatar uma sessão expirada, autentique-se novamente com seu provedor de credenciais, por exemplo, fazendo login novamente em seu SSO ou cofre de segredos

467* Corrija o comando para que ele imprima a chave em stdout e saia com código 0. Consulte [girar credenciais com apiKeyHelper](/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcionando.467* Corrija o comando para que ele imprima a chave em stdout e saia com código 0. Consulte [girar credenciais com apiKeyHelper](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para uma configuração funcionando.

468* Execute `/status` para confirmar que `apiKeyHelper` é a fonte de credencial ativa. Cada vez que o comando falha, seu código de saída e saída de erro aparecem em um painel `Cloud authentication` no terminal.468* Execute `/status` para confirmar que `apiKeyHelper` é a fonte de credencial ativa. Cada vez que o comando falha, seu código de saída e saída de erro aparecem em um painel `Cloud authentication` no terminal.

469 469 

470<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">


499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

500```500```

501 501 

502Variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto executar `/login` sozinho não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](/pt/authentication#authentication-precedence).502Variáveis de ambiente e `apiKeyHelper` têm precedência sobre `/login`, portanto executar `/login` sozinho não ajuda enquanto qualquer um deles ainda estiver fornecendo uma chave. Consulte [Precedência de autenticação](/docs/pt/authentication#authentication-precedence).

503 503 

504**O que fazer:**504**O que fazer:**

505 505 

506* Se a mensagem mencionar `ANTHROPIC_API_KEY`, desdefina-a no shell atual e remova-a do seu perfil de shell ou arquivo `.env`, depois reinicie `claude`506* Se a mensagem mencionar `ANTHROPIC_API_KEY`, desdefina-a no shell atual e remova-a do seu perfil de shell ou arquivo `.env`, depois reinicie `claude`

507* Se a mensagem mencionar `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/pt/settings#available-settings) do seu `settings.json`507* Se a mensagem mencionar `apiKeyHelper`, remova a configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) do seu `settings.json`

508* Execute `/login` para fazer login com sua conta claude.ai508* Execute `/login` para fazer login com sua conta claude.ai

509* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API509* Execute `/status` depois para confirmar que a credencial ativa é sua assinatura em vez de uma chave de API

510* Se você precisar de autenticação por chave de API para automação, peça ao administrador da sua organização para reabilitá-la no Console510* Se você precisar de autenticação por chave de API para automação, peça ao administrador da sua organização para reabilitá-la no Console


526**O que fazer:**526**O que fazer:**

527 527 

528* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização528* Peça ao seu administrador para habilitar o acesso ao Claude Code para sua organização

529* Autentique-se com uma chave de API do Console em vez de sua assinatura. Consulte [Autenticação do Claude Console](/pt/authentication#claude-console-authentication) para configuração.529* Autentique-se com uma chave de API do Console em vez de sua assinatura. Consulte [Autenticação do Claude Console](/docs/pt/authentication#claude-console-authentication) para configuração.

530* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com [suporte da Anthropic](https://support.claude.com)530* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com [suporte da Anthropic](https://support.claude.com)

531 531 

532<h3 id="routines-are-disabled-by-your-organizations-policy">532<h3 id="routines-are-disabled-by-your-organizations-policy">

533 Rotinas são desabilitadas pela política da sua organização533 Rotinas são desabilitadas pela política da sua organização

534</h3>534</h3>

535 535 

536Um Proprietário em sua organização Team ou Enterprise desabilitou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, incluindo de `/schedule` e da interface de [Rotinas](/pt/routines) em claude.ai/code.536Um Proprietário em sua organização Team ou Enterprise desabilitou rotinas no nível da organização. O erro aparece quando você tenta criar ou executar uma rotina, incluindo de `/schedule` e da interface de [Rotinas](/docs/pt/routines) em claude.ai/code.

537 537 

538```text theme={null}538```text theme={null}

539Routines are disabled by your organization's policy.539Routines are disabled by your organization's policy.


544**O que fazer:**544**O que fazer:**

545 545 

546* Peça a um Proprietário em sua organização para habilitar o botão **Routines** em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)546* Peça a um Proprietário em sua organização para habilitar o botão **Routines** em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)

547* Para trabalho agendado único que não requer rotinas no nível da organização, consulte [tarefas agendadas](/pt/scheduled-tasks)547* Para trabalho agendado único que não requer rotinas no nível da organização, consulte [tarefas agendadas](/docs/pt/scheduled-tasks)

548 548 

549<h3 id="remote-control-requires-the-anthropic-api">549<h3 id="remote-control-requires-the-anthropic-api">

550 Remote Control requer a API Anthropic550 Remote Control requer a API Anthropic

551</h3>551</h3>

552 552 

553A sessão não está se comunicando com a API Anthropic diretamente, portanto não há backend claude.ai para [Remote Control](/pt/remote-control) emparelhar.553A sessão não está se comunicando com a API Anthropic diretamente, portanto não há backend claude.ai para [Remote Control](/docs/pt/remote-control) emparelhar.

554 554 

555```text theme={null}555```text theme={null}

556Remote Control is only available when using Claude via api.anthropic.com.556Remote Control is only available when using Claude via api.anthropic.com.

557```557```

558 558 

559Isso aparece em Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry. {/* min-version: 2.1.196 */}A partir da v2.1.196, também aparece quando [`ANTHROPIC_BASE_URL`](/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/pt/llm-gateway) ou proxy, mesmo quando você faz login com claude.ai.559Isso aparece em Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry. A partir da v2.1.196, também aparece quando [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/docs/pt/llm-gateway) ou proxy, mesmo quando você faz login com claude.ai.

560 560 

561**O que fazer:**561**O que fazer:**

562 562 

563* Desdefina `ANTHROPIC_BASE_URL` e reinicie a sessão, ou inicie Remote Control de uma sessão que se comunique com a API Anthropic diretamente563* Desdefina `ANTHROPIC_BASE_URL` e reinicie a sessão, ou inicie Remote Control de uma sessão que se comunique com a API Anthropic diretamente

564* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solucionar problemas do Remote Control](/pt/remote-control#troubleshooting)564* Para esta e as outras mensagens de inicialização do Remote Control, consulte [Solucionar problemas do Remote Control](/docs/pt/remote-control#troubleshooting)

565 565 

566<h3 id="oauth-token-revoked-or-expired">566<h3 id="oauth-token-revoked-or-expired">

567 Token OAuth revogado ou expirado567 Token OAuth revogado ou expirado


581 581 

582* Execute `/login` para fazer login novamente582* Execute `/login` para fazer login novamente

583* Se o erro retornar na mesma sessão após autenticar novamente, execute `/logout` primeiro para limpar completamente o token armazenado, depois `/login`583* Se o erro retornar na mesma sessão após autenticar novamente, execute `/logout` primeiro para limpar completamente o token armazenado, depois `/login`

584* Para prompts repetidos de login entre inicializações, consulte as verificações de relógio do sistema e Keychain do macOS em [Solução de problemas](/pt/troubleshoot-install#not-logged-in-or-token-expired)584* Para prompts repetidos de login entre inicializações, consulte as verificações de relógio do sistema e Keychain do macOS em [Solução de problemas](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired)

585* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, consulte [Login e autenticação](/pt/troubleshoot-install#login-and-authentication)585* Para outras falhas, incluindo `403 Forbidden` e problemas de navegador OAuth, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)

586 586 

587<h3 id="login-expired">587<h3 id="login-expired">

588 Login expirado588 Login expirado

589</h3>589</h3>

590 590 

591Claude Code tentou renovar seu login salvo claude.ai ou Claude Console e o serviço OAuth rejeitou o token de atualização armazenado, portanto Claude Code limpou as credenciais salvas. Depois disso, cada solicitação para localmente antes de chegar à API, porque apenas `/login` pode criar novas credenciais. {/* min-version: 2.1.206 */}Antes da v2.1.206, Claude Code enviava a solicitação mesmo assim com qualquer credencial que permanecesse no ambiente, e cada modelo então falhava com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para fazer login.591Claude Code tentou renovar seu login salvo claude.ai ou Claude Console e o serviço OAuth rejeitou o token de atualização armazenado, portanto Claude Code limpou as credenciais salvas. Depois disso, cada solicitação para localmente antes de chegar à API, porque apenas `/login` pode criar novas credenciais. Antes da v2.1.206, Claude Code enviava a solicitação mesmo assim com qualquer credencial que permanecesse no ambiente, e cada modelo então falhava com [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model) ou um 401 em vez de um prompt para fazer login.

592 592 

593```text theme={null}593```text theme={null}

594Login expired · Please run /login594Login expired · Please run /login

595```595```

596 596 

597Em [modo não interativo](/pt/headless) (`-p`) e no [Agent SDK](/pt/agent-sdk/overview), a mensagem lê da seguinte forma, e o código de erro estruturado é `authentication_failed`:597Em [modo não interativo](/docs/pt/headless) (`-p`) e no [Agent SDK](/docs/pt/agent-sdk/overview), a mensagem lê da seguinte forma, e o código de erro estruturado é `authentication_failed`:

598 598 

599```text theme={null}599```text theme={null}

600Failed to authenticate: OAuth session expired and could not be refreshed600Failed to authenticate: OAuth session expired and could not be refreshed


602 602 

603Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Essas mensagens relatam um 401 que a API retornou. Claude Code em si produz `Login expired` para um login que já falhou em renovar, portanto não envia nenhuma solicitação.603Este não é o mesmo estado que [Token OAuth revogado ou expirado](#oauth-token-revoked-or-expired). Essas mensagens relatam um 401 que a API retornou. Claude Code em si produz `Login expired` para um login que já falhou em renovar, portanto não envia nenhuma solicitação.

604 604 

605Sessões autenticadas com uma chave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/pt/env-vars) ou um provedor de terceiros não usam o login salvo e nunca veem esta mensagem.605Sessões autenticadas com uma chave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/pt/env-vars) ou um provedor de terceiros não usam o login salvo e nunca veem esta mensagem.

606 606 

607**O que fazer:**607**O que fazer:**

608 608 

609* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.609* Execute `/login` para fazer login novamente. Tentar novamente sem fazer login mostra a mesma mensagem em cada solicitação.

610* Em modo não interativo, execute `claude` no mesmo ambiente, conclua `/login`, depois execute novamente seu comando. Para automação que não consegue fazer login interativamente, autentique-se com `ANTHROPIC_API_KEY` ou [gere um token de longa duração com `claude setup-token`](/pt/authentication#generate-a-long-lived-token).610* Em modo não interativo, execute `claude` no mesmo ambiente, conclua `/login`, depois execute novamente seu comando. Para automação que não consegue fazer login interativamente, autentique-se com `ANTHROPIC_API_KEY` ou [gere um token de longa duração com `claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token).

611* Se fazer login continuar falhando, consulte [Login e autenticação](/pt/troubleshoot-install#login-and-authentication)611* Se fazer login continuar falhando, consulte [Login e autenticação](/docs/pt/troubleshoot-install#login-and-authentication)

612 612 

613<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">

614 Requisito de escopo OAuth614 Requisito de escopo OAuth


628 Credenciais AWS expiradas ou inválidas628 Credenciais AWS expiradas ou inválidas

629</h3>629</h3>

630 630 

631{/* min-version: 2.1.198 */}Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu token de sessão AWS expirou ou foi rejeitado, e a atualização automática que Claude Code já executou não produziu uma credencial que a API aceita. Aparece em um 401 de [Claude Platform on AWS](/pt/claude-platform-on-aws) ou do [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint), que é como esses provedores relatam um token de segurança expirado.631Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu token de sessão AWS expirou ou foi rejeitado, e a atualização automática que Claude Code já executou não produziu uma credencial que a API aceita. Aparece em um 401 de [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) ou do [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint), que é como esses provedores relatam um token de segurança expirado.

632 632 

633A dica de ação no meio nomeia o comando `awsAuthRefresh` do seu arquivo de configurações, portanto varia. A parte estável é o `AWS credentials expired or invalid` inicial:633A dica de ação no meio nomeia o comando `awsAuthRefresh` do seu arquivo de configurações, portanto varia. A parte estável é o `AWS credentials expired or invalid` inicial:

634 634 


641**O que fazer:**641**O que fazer:**

642 642 

643* Execute o comando `awsAuthRefresh` nomeado na mensagem, como `aws sso login --profile myprofile`, em outro terminal e conclua o login do navegador, depois tente novamente643* Execute o comando `awsAuthRefresh` nomeado na mensagem, como `aws sso login --profile myprofile`, em outro terminal e conclua o login do navegador, depois tente novamente

644* Em uma sessão interativa, execute `/login`, escolha **plataforma de terceiros**, depois selecione **Claude Platform on AWS · refresh credentials** em **Usando plataformas de terceiros** para executar o mesmo comando sem reiniciar Claude Code. Consulte [Configurar credenciais AWS](/pt/claude-platform-on-aws#1-configure-aws-credentials)644* Em uma sessão interativa, execute `/login`, escolha **plataforma de terceiros**, depois selecione **Claude Platform on AWS · refresh credentials** em **Usando plataformas de terceiros** para executar o mesmo comando sem reiniciar Claude Code. Consulte [Configurar credenciais AWS](/docs/pt/claude-platform-on-aws#1-configure-aws-credentials)

645* Se o erro se repetir após o comando de atualização ter sucesso, confirme que a identidade é válida fora do Claude Code com `aws sts get-caller-identity` no mesmo shell e perfil645* Se o erro se repetir após o comando de atualização ter sucesso, confirme que a identidade é válida fora do Claude Code com `aws sts get-caller-identity` no mesmo shell e perfil

646 646 

647<h3 id="aws-authentication-failed">647<h3 id="aws-authentication-failed">

648 Falha na autenticação AWS648 Falha na autenticação AWS

649</h3>649</h3>

650 650 

651{/* min-version: 2.1.198 */}Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/pt/amazon-bedrock) retornou um 401.651Esta mensagem requer Claude Code v2.1.198 ou posterior e só aparece quando [`awsAuthRefresh`](/docs/pt/amazon-bedrock#advanced-credential-configuration) está definido no seu arquivo de configurações. Seu provedor AWS retornou um 403, ou [Amazon Bedrock](/docs/pt/amazon-bedrock) retornou um 401.

652 652 

653Claude Code não consegue dizer qual causa você atingiu. Amazon Bedrock relata um token de segurança expirado como um 403, mas um 403 também é como ele relata uma negação de autorização, como um `AccessDeniedException` de uma permissão IAM ausente ou um modelo que não está habilitado para sua conta.653Claude Code não consegue dizer qual causa você atingiu. Amazon Bedrock relata um token de segurança expirado como um 403, mas um 403 também é como ele relata uma negação de autorização, como um `AccessDeniedException` de uma permissão IAM ausente ou um modelo que não está habilitado para sua conta.

654 654 


665**O que fazer:**665**O que fazer:**

666 666 

667* Execute o comando `awsAuthRefresh` nomeado na mensagem, ou `aws sso login`, caso uma credencial expirada seja a causa667* Execute o comando `awsAuthRefresh` nomeado na mensagem, ou `aws sso login`, caso uma credencial expirada seja a causa

668* Se suas credenciais estão atuais, confirme que as permissões IAM em [Configuração IAM](/pt/amazon-bedrock#iam-configuration) estão anexadas à identidade que você está usando e que o modelo selecionado está habilitado para sua conta e região668* Se suas credenciais estão atuais, confirme que as permissões IAM em [Configuração IAM](/docs/pt/amazon-bedrock#iam-configuration) estão anexadas à identidade que você está usando e que o modelo selecionado está habilitado para sua conta e região

669* Execute `aws sts get-caller-identity` para confirmar qual identidade suas solicitações usam; um `AWS_PROFILE` obsoleto ou perfil padrão é uma causa comum de incompatibilidade de permissão669* Execute `aws sts get-caller-identity` para confirmar qual identidade suas solicitações usam; um `AWS_PROFILE` obsoleto ou perfil padrão é uma causa comum de incompatibilidade de permissão

670 670 

671<h3 id="aws-default-chain-credential-resolve-timed-out">671<h3 id="aws-default-chain-credential-resolve-timed-out">

672 Resolução de credencial da cadeia padrão AWS expirou672 Resolução de credencial da cadeia padrão AWS expirou

673</h3>673</h3>

674 674 

675O provedor de credencial padrão AWS não produziu credenciais dentro de 60 segundos, portanto Claude Code parou a resolução e falhou a solicitação. A falha é resolução de credencial local: a solicitação nunca chegou a [Amazon Bedrock](/pt/amazon-bedrock), [Claude Platform on AWS](/pt/claude-platform-on-aws) ou ao [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint). Claude Code limpa seu [cache de credenciais](/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes desta mensagem de erro aparecer, portanto no momento em que você a vê a cadeia travou em tentativas repetidas.675O provedor de credencial padrão AWS não produziu credenciais dentro de 60 segundos, portanto Claude Code parou a resolução e falhou a solicitação. A falha é resolução de credencial local: a solicitação nunca chegou a [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) ou ao [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Claude Code limpa seu [cache de credenciais](/docs/pt/amazon-bedrock#credential-caching-and-resolution-timeout) e tenta novamente antes desta mensagem de erro aparecer, portanto no momento em que você a vê a cadeia travou em tentativas repetidas.

676 676 

677```text theme={null}677```text theme={null}

678API Error: AWS default-chain credential resolve timed out678API Error: AWS default-chain credential resolve timed out

679```679```

680 680 

681As causas comuns são um comando `credential_process` no seu perfil AWS que aguarda entrada que não consegue receber, e um contêiner ou VM cujo serviço de metadados de instância (IMDS) nunca responde à sonda da cadeia. {/* min-version: 2.1.207 */}Antes da v2.1.207, uma cadeia travada deixava a solicitação aguardando indefinidamente em vez de falhar com esta mensagem.681As causas comuns são um comando `credential_process` no seu perfil AWS que aguarda entrada que não consegue receber, e um contêiner ou VM cujo serviço de metadados de instância (IMDS) nunca responde à sonda da cadeia. Antes da v2.1.207, uma cadeia travada deixava a solicitação aguardando indefinidamente em vez de falhar com esta mensagem.

682 682 

683**O que fazer:**683**O que fazer:**

684 684 

685* Execute `aws sts get-caller-identity` no mesmo shell com o mesmo `AWS_PROFILE`. Se também travar, corrija o perfil; um comando `credential_process` que solicita interativamente é uma causa comum.685* Execute `aws sts get-caller-identity` no mesmo shell com o mesmo `AWS_PROFILE`. Se também travar, corrija o perfil; um comando `credential_process` que solicita interativamente é uma causa comum.

686* Conclua a etapa de login antes de iniciar Claude Code, por exemplo `aws sso login --profile myprofile`, para que a cadeia seja resolvida do cache SSO local em vez de aguardar um fluxo de navegador686* Conclua a etapa de login antes de iniciar Claude Code, por exemplo `aws sso login --profile myprofile`, para que a cadeia seja resolvida do cache SSO local em vez de aguardar um fluxo de navegador

687* Se sua cadeia executa um login interativo que legitimamente precisa de mais de 60 segundos, como SSO com MFA através de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/pt/env-vars)687* Se sua cadeia executa um login interativo que legitimamente precisa de mais de 60 segundos, como SSO com MFA através de um wrapper como `aws-vault`, aumente o limite em milissegundos com [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/pt/env-vars)

688 688 

689<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">

690 Erros de rede e conexão690 Erros de rede e conexão


712**O que fazer:**712**O que fazer:**

713 713 

714* Confirme que você pode alcançar o host da API a partir do mesmo shell executando `curl -I https://api.anthropic.com`. No Windows PowerShell, use `curl.exe -I https://api.anthropic.com` para que o alias `Invoke-WebRequest` integrado não seja usado.714* Confirme que você pode alcançar o host da API a partir do mesmo shell executando `curl -I https://api.anthropic.com`. No Windows PowerShell, use `curl.exe -I https://api.anthropic.com` para que o alias `Invoke-WebRequest` integrado não seja usado.

715* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e consulte [Configuração de rede](/pt/network-config)715* Se você estiver atrás de um proxy corporativo, defina `HTTPS_PROXY` antes de iniciar Claude Code e consulte [Configuração de rede](/docs/pt/network-config)

716* Se você rotear através de um gateway LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/pt/env-vars) para seu endereço. Consulte [Conectar Claude Code a um gateway LLM](/pt/llm-gateway-connect) para configuração.716* Se você rotear através de um gateway LLM ou relay, defina [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) para seu endereço. Consulte [Conectar Claude Code a um gateway LLM](/docs/pt/llm-gateway-connect) para configuração.

717* Certifique-se de que seu firewall permite os hosts listados em [Requisitos de acesso à rede](/pt/network-config#network-access-requirements)717* Certifique-se de que seu firewall permite os hosts listados em [Requisitos de acesso à rede](/docs/pt/network-config#network-access-requirements)

718* Falhas intermitentes são [retentadas automaticamente](#automatic-retries); falhas persistentes apontam para um problema de rede local718* Falhas intermitentes são [retentadas automaticamente](#automatic-retries); falhas persistentes apontam para um problema de rede local

719 719 

720Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:720Se `curl` funcionar mas Claude Code ainda falhar, a causa geralmente é algo entre o runtime e a rede em vez da rede em si:


727 Resposta de streaming do Bedrock tem um content-type inesperado727 Resposta de streaming do Bedrock tem um content-type inesperado

728</h3>728</h3>

729 729 

730Um gateway ou proxy entre Claude Code e [Amazon Bedrock](/pt/amazon-bedrock) está transformando o corpo da resposta de streaming ou seu cabeçalho `Content-Type`. Amazon Bedrock transmite respostas como `application/vnd.amazon.eventstream`, e Claude Code rejeita uma resposta de streaming bem-sucedida que relata um content-type diferente em vez de decodificar um corpo que não consegue ler. A solicitação não é retentada.730Um gateway ou proxy entre Claude Code e [Amazon Bedrock](/docs/pt/amazon-bedrock) está transformando o corpo da resposta de streaming ou seu cabeçalho `Content-Type`. Amazon Bedrock transmite respostas como `application/vnd.amazon.eventstream`, e Claude Code rejeita uma resposta de streaming bem-sucedida que relata um content-type diferente em vez de decodificar um corpo que não consegue ler. A solicitação não é retentada.

731 731 

732```text theme={null}732```text theme={null}

733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

734```734```

735 735 

736{/* min-version: 2.1.208 */}Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` após toda a resposta ter sido armazenada em buffer.736Antes da v2.1.208, a mesma configuração incorreta aparecia como `API Error: Truncated event message received` após toda a resposta ter sido armazenada em buffer.

737 737 

738**O que fazer:**738**O que fazer:**

739 739 

740* Configure o gateway para passar o corpo da resposta `InvokeModelWithResponseStream` e seu cabeçalho `Content-Type` sem modificações. Um intermediário que re-emite o stream como server-sent events é uma causa comum.740* Configure o gateway para passar o corpo da resposta `InvokeModelWithResponseStream` e seu cabeçalho `Content-Type` sem modificações. Um intermediário que re-emite o stream como server-sent events é uma causa comum.

741* Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/pt/env-vars) para pular a verificação até que o gateway seja corrigido. Consulte [Erros de streaming atrás de um gateway ou proxy](/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).741* Se o gateway reescrever apenas o cabeçalho e passar o corpo binário intacto, defina [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/pt/env-vars) para pular a verificação até que o gateway seja corrigido. Consulte [Erros de streaming atrás de um gateway ou proxy](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

742 742 

743<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">

744 Erros de certificado SSL744 Erros de certificado SSL


751Unable to connect to API: Self-signed certificate detected751Unable to connect to API: Self-signed certificate detected

752```752```

753 753 

754{/* min-version: 2.1.199 */}A partir da v2.1.199, uma falha de validação de certificado não é retentada, portanto esse erro aparece na primeira tentativa em vez de após o [orçamento de retry](#automatic-retries) completo. Versões anteriores gastavam alguns minutos retentando antes de mostrá-lo. Condições TLS transitórias, como um timeout de handshake, ainda são retentadas.754A partir da v2.1.199, uma falha de validação de certificado não é retentada, portanto esse erro aparece na primeira tentativa em vez de após o [orçamento de retry](#automatic-retries) completo. Versões anteriores gastavam alguns minutos retentando antes de mostrá-lo. Condições TLS transitórias, como um timeout de handshake, ainda são retentadas.

755 755 

756Durante `/login` e a verificação de conectividade de inicialização, a mesma falha é relatada com o código OpenSSL e a correção inline:756Durante `/login` e a verificação de conectividade de inicialização, a mesma falha é relatada com o código OpenSSL e a correção inline:

757 757 


762**O que fazer:**762**O que fazer:**

763 763 

764* Exporte o pacote CA da sua organização e aponte Claude Code para ele com `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`764* Exporte o pacote CA da sua organização e aponte Claude Code para ele com `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`

765* Consulte [Configuração de rede](/pt/network-config#custom-ca-certificates) para instruções de configuração completa765* Consulte [Configuração de rede](/docs/pt/network-config#custom-ca-certificates) para instruções de configuração completa

766* Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desabilita a validação de certificado inteiramente766* Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desabilita a validação de certificado inteiramente

767 767 

768<h3 id="host-not-allowed-in-a-cloud-session">768<h3 id="host-not-allowed-in-a-cloud-session">


778 778 

779Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. O ambiente em nuvem roteia o tráfego de saída através de um proxy que aplica a política de rede, portanto um certificado incompatível significa que o proxy encerrou a conexão, não o destino.779Você também pode ver um certificado TLS que não corresponde ao certificado real do destino. O ambiente em nuvem roteia o tráfego de saída através de um proxy que aplica a política de rede, portanto um certificado incompatível significa que o proxy encerrou a conexão, não o destino.

780 780 

781Isso não é um problema de rede do lado do cliente. Sessões em nuvem e [rotinas](/pt/routines) são executadas dentro de um ambiente em sandbox cuja tráfego de saída é filtrado para a lista de permissões do ambiente. O ambiente **Default** usa acesso **Trusted**, que permite a [lista de permissões padrão](/pt/claude-code-on-the-web#default-allowed-domains) de registros de pacotes, APIs de provedores em nuvem, registros de contêiner e domínios de desenvolvimento comuns, mas bloqueia tudo o mais.781Isso não é um problema de rede do lado do cliente. Sessões em nuvem e [rotinas](/docs/pt/routines) são executadas dentro de um ambiente em sandbox cuja tráfego de saída é filtrado para a lista de permissões do ambiente. O ambiente **Default** usa acesso **Trusted**, que permite a [lista de permissões padrão](/docs/pt/claude-code-on-the-web#default-allowed-domains) de registros de pacotes, APIs de provedores em nuvem, registros de contêiner e domínios de desenvolvimento comuns, mas bloqueia tudo o mais.

782 782 

783**O que fazer:**783**O que fazer:**

784 784 

785* Abra a rotina para edição ou inicie uma sessão em nuvem. Selecione o ícone de nuvem mostrando o nome do seu ambiente, como **Default**, para abrir o seletor. Passe o mouse sobre seu ambiente e clique no ícone de configurações.785* Abra a rotina para edição ou inicie uma sessão em nuvem. Selecione o ícone de nuvem mostrando o nome do seu ambiente, como **Default**, para abrir o seletor. Passe o mouse sobre seu ambiente e clique no ícone de configurações.

786* Na caixa de diálogo **Update cloud environment**, altere **Network access** de **Trusted** para **Custom**, depois adicione o domínio bloqueado a **Allowed domains**. Digite um domínio por linha. Marque **Also include default list of common package managers** para manter a [lista de permissões padrão](/pt/claude-code-on-the-web#default-allowed-domains) junto com seus domínios personalizados. Selecione **Full** em vez disso se quiser acesso irrestrito.786* Na caixa de diálogo **Update cloud environment**, altere **Network access** de **Trusted** para **Custom**, depois adicione o domínio bloqueado a **Allowed domains**. Digite um domínio por linha. Marque **Also include default list of common package managers** para manter a [lista de permissões padrão](/docs/pt/claude-code-on-the-web#default-allowed-domains) junto com seus domínios personalizados. Selecione **Full** em vez disso se quiser acesso irrestrito.

787* Clique em **Save changes**. A próxima execução usa a lista de permissões atualizada.787* Clique em **Save changes**. A próxima execução usa a lista de permissões atualizada.

788 788 

789Consulte [Network access](/pt/claude-code-on-the-web#network-access) para níveis de acesso e a lista de permissões padrão. Sessões locais de CLI não são afetadas por essa política.789Consulte [Network access](/docs/pt/claude-code-on-the-web#network-access) para níveis de acesso e a lista de permissões padrão. Sessões locais de CLI não são afetadas por essa política.

790 790 

791<h3 id="couldnt-reconnect-to-your-remote-control-session">791<h3 id="couldnt-reconnect-to-your-remote-control-session">

792 Não foi possível reconectar à sua sessão de Remote Control792 Não foi possível reconectar à sua sessão de Remote Control


796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

797```797```

798 798 

799Retomar com `claude --resume` ou `claude --continue` reconecta à sessão [Remote Control](/pt/remote-control) registrada nessa conversa. Esta mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, portanto Claude Code não pode confirmar se a sessão remota ainda existe. Sua sessão local continua funcionando sem Remote Control.799Retomar com `claude --resume` ou `claude --continue` reconecta à sessão [Remote Control](/docs/pt/remote-control) registrada nessa conversa. Esta mensagem significa que a reconexão falhou por um motivo que pode ser temporário, como uma interrupção de rede ou um erro de servidor, portanto Claude Code não pode confirmar se a sessão remota ainda existe. Sua sessão local continua funcionando sem Remote Control.

800 800 

801**O que fazer:**801**O que fazer:**

802 802 

803* Execute `/remote-control` para tentar novamente a conexão803* Execute `/remote-control` para tentar novamente a conexão

804* Inicie Claude Code sem `--resume` para criar uma nova sessão de Remote Control804* Inicie Claude Code sem `--resume` para criar uma nova sessão de Remote Control

805* Para outras mensagens de inicialização do Remote Control, consulte [Troubleshoot Remote Control](/pt/remote-control#troubleshooting)805* Para outras mensagens de inicialização do Remote Control, consulte [Troubleshoot Remote Control](/docs/pt/remote-control#troubleshooting)

806 806 

807Você não verá esta mensagem quando o servidor confirmar que a sessão anterior não existe mais; Claude Code cria uma nova nesse caso. {/* min-version: 2.1.200 */}Antes da v2.1.200, qualquer falha de reconexão criava uma nova sessão de Remote Control, o que deixava sessões extras na lista de sessões em claude.ai/code.807Você não verá esta mensagem quando o servidor confirmar que a sessão anterior não existe mais; Claude Code cria uma nova nesse caso. Antes da v2.1.200, qualquer falha de reconexão criava uma nova sessão de Remote Control, o que deixava sessões extras na lista de sessões em claude.ai/code.

808 808 

809<h2 id="request-errors">809<h2 id="request-errors">

810 Erros de solicitação810 Erros de solicitação


827* Execute `/compact` para resumir turnos anteriores e liberar espaço, ou `/clear` para começar do zero827* Execute `/compact` para resumir turnos anteriores e liberar espaço, ou `/clear` para começar do zero

828* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens828* Execute `/context` para ver um detalhamento do que está consumindo a janela: prompt do sistema, ferramentas, arquivos de memória e mensagens

829* Desabilite servidores MCP que você não está usando com `/mcp disable <name>` para remover suas definições de ferramentas do contexto829* Desabilite servidores MCP que você não está usando com `/mcp disable <name>` para remover suas definições de ferramentas do contexto

830* Reduza arquivos de memória `CLAUDE.md` grandes, ou mova instruções para [regras com escopo de caminho](/pt/memory#path-specific-rules) que carregam apenas quando relevante830* Reduza arquivos de memória `CLAUDE.md` grandes, ou mova instruções para [regras com escopo de caminho](/docs/pt/memory#path-specific-rules) que carregam apenas quando relevante

831* Suagentes herdam todas as definições de ferramentas MCP da sessão pai, o que pode preencher sua janela de contexto antes do primeiro turno. Desabilite servidores MCP que você não está usando antes de gerar suagentes.831* Suagentes herdam todas as definições de ferramentas MCP da sessão pai, o que pode preencher sua janela de contexto antes do primeiro turno. Desabilite servidores MCP que você não está usando antes de gerar suagentes.

832* Auto-compact está ativado por padrão e normalmente previne esse erro. Se você definiu [`DISABLE_AUTO_COMPACT`](/pt/env-vars), reabilite-o ou execute `/compact` manualmente antes da janela ficar cheia.832* Auto-compact está ativado por padrão e normalmente previne esse erro. Se você definiu [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars), reabilite-o ou execute `/compact` manualmente antes da janela ficar cheia.

833 833 

834Veja [Explore the context window](/pt/context-window) para uma visualização interativa de como o contexto se preenche.834Veja [Explore the context window](/docs/pt/context-window) para uma visualização interativa de como o contexto se preenche.

835 835 

836<h3 id="error-during-compaction-conversation-too-long">836<h3 id="error-during-compaction-conversation-too-long">

837 Erro durante compactação: Conversa muito longa837 Erro durante compactação: Conversa muito longa


879API Error: 400 ... image dimensions exceed max allowed size879API Error: 400 ... image dimensions exceed max allowed size

880```880```

881 881 

882{/* min-version: 2.1.142 */}Claude Code substitui a imagem não processável por um espaço reservado de texto e tenta novamente, para que as mensagens subsequentes tenham sucesso. Em versões anteriores a 2.1.142, uma imagem colada poderia permanecer na conversa e repetir o mesmo erro em cada mensagem subsequente. Para recuperar nessas versões, pressione Esc duas vezes e volte passado o turno onde a imagem foi adicionada.882Claude Code substitui a imagem não processável por um espaço reservado de texto e tenta novamente, para que as mensagens subsequentes tenham sucesso. Em versões anteriores a 2.1.142, uma imagem colada poderia permanecer na conversa e repetir o mesmo erro em cada mensagem subsequente. Para recuperar nessas versões, pressione Esc duas vezes e volte passado o turno onde a imagem foi adicionada.

883 883 

884**O que fazer:**884**O que fazer:**

885 885 


939 939 

940**O que fazer:**940**O que fazer:**

941 941 

942* Configure seu gateway para encaminhar o cabeçalho `anthropic-beta`. Veja [feature pass-through](/pt/llm-gateway-protocol#feature-pass-through) para o que os gateways devem encaminhar.942* Configure seu gateway para encaminhar o cabeçalho `anthropic-beta`. Veja [feature pass-through](/docs/pt/llm-gateway-protocol#feature-pass-through) para o que os gateways devem encaminhar.

943* Como alternativa, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/pt/env-vars) antes de iniciar. Isso desabilita recursos que exigem o cabeçalho beta para que as solicitações tenham sucesso através de um gateway que não pode encaminhá-lo.943* Como alternativa, defina [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/env-vars) antes de iniciar. Isso desabilita recursos que exigem o cabeçalho beta para que as solicitações tenham sucesso através de um gateway que não pode encaminhá-lo.

944 944 

945<h3 id="theres-an-issue-with-the-selected-model">945<h3 id="theres-an-issue-with-the-selected-model">

946 Há um problema com o modelo selecionado946 Há um problema com o modelo selecionado


955**O que fazer:**955**O que fazer:**

956 956 

957* **CLI interativo**: execute `/model` para escolher entre modelos disponíveis para sua conta.957* **CLI interativo**: execute `/model` para escolher entre modelos disponíveis para sua conta.

958* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](/pt/env-vars). O texto de erro mostra `Run --model` nesta superfície.958* **Modo não interativo (`-p`)**: passe `--model` com um alias ou ID válido, ou defina [`ANTHROPIC_MODEL`](/docs/pt/env-vars). O texto de erro mostra `Run --model` nesta superfície.

959* **Agent SDK**: o texto de erro omite a dica porque o modelo é definido programaticamente. Defina [`model` em `Options`](/pt/agent-sdk/typescript#options) em TypeScript ou [`ClaudeAgentOptions(model=...)`](/pt/agent-sdk/python#claudeagentoptions) em Python, e trate o erro estruturado `model_not_found` para exibir sua própria tentativa ou seletor de modelo.959* **Agent SDK**: o texto de erro omite a dica porque o modelo é definido programaticamente. Defina [`model` em `Options`](/docs/pt/agent-sdk/typescript#options) em TypeScript ou [`ClaudeAgentOptions(model=...)`](/docs/pt/agent-sdk/python#claudeagentoptions) em Python, e trate o erro estruturado `model_not_found` para exibir sua própria tentativa ou seletor de modelo.

960* Use um alias como `sonnet` ou `opus` em vez de um ID versionado completo. Os aliases resolvem para um padrão mantido para que não fiquem obsoletos. Veja [Model configuration](/pt/model-config).960* Use um alias como `sonnet` ou `opus` em vez de um ID versionado completo. Os aliases resolvem para um padrão mantido para que não fiquem obsoletos. Veja [Model configuration](/docs/pt/model-config).

961* Se o modelo errado continuar voltando na CLI, um ID obsoleto está definido em algum lugar. Verifique em [ordem de prioridade](/pt/model-config#setting-your-model): a flag `--model`, a variável de ambiente `ANTHROPIC_MODEL`, depois o campo `model` em `.claude/settings.local.json`, o `.claude/settings.json` do seu projeto e `~/.claude/settings.json`. Remova o valor obsoleto e Claude Code volta para o padrão da sua conta.961* Se o modelo errado continuar voltando na CLI, um ID obsoleto está definido em algum lugar. Verifique em [ordem de prioridade](/docs/pt/model-config#setting-your-model): a flag `--model`, a variável de ambiente `ANTHROPIC_MODEL`, depois o campo `model` em `.claude/settings.local.json`, o `.claude/settings.json` do seu projeto e `~/.claude/settings.json`. Remova o valor obsoleto e Claude Code volta para o padrão da sua conta.

962* {/* min-version: 2.1.206 */}Claude Code relata um login claude.ai expirado como [Login expired](#login-expired), não como este erro. Antes de v2.1.206, um login expirado que não podia mais ser atualizado falhava em cada modelo com este erro; execute `/login` se você vir isso em uma versão mais antiga.962* Claude Code relata um login claude.ai expirado como [Login expired](#login-expired), não como este erro. Antes de v2.1.206, um login expirado que não podia mais ser atualizado falhava em cada modelo com este erro; execute `/login` se você vir isso em uma versão mais antiga.

963* Para implantações do Agent Platform do Google Cloud, veja [Troubleshooting do Agent Platform do Google Cloud](/pt/google-vertex-ai#troubleshooting).963* Para implantações do Agent Platform do Google Cloud, veja [Troubleshooting do Agent Platform do Google Cloud](/docs/pt/google-vertex-ai#troubleshooting).

964 964 

965<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">

966 Modelo não é um ID de modelo reconhecido966 Modelo não é um ID de modelo reconhecido


974 974 

975A dica à direita nomeia o alias ou ID de modelo mais próximo. Quando nada é próximo o suficiente, lê `Run /model to see available models.` em vez disso.975A dica à direita nomeia o alias ou ID de modelo mais próximo. Quando nada é próximo o suficiente, lê `Run /model to see available models.` em vez disso.

976 976 

977Claude Code produz esse erro localmente no momento em que a mudança é solicitada, antes de qualquer solicitação de API ser feita. Aplica-se quando um modelo é definido através do método [Agent SDK](/pt/agent-sdk/typescript) `setModel()` ou por um aplicativo como o [Desktop app](/pt/desktop) que executa o CLI do Claude Code para você.977Claude Code produz esse erro localmente no momento em que a mudança é solicitada, antes de qualquer solicitação de API ser feita. Aplica-se quando um modelo é definido através do método [Agent SDK](/docs/pt/agent-sdk/typescript) `setModel()` ou por um aplicativo como o [Desktop app](/docs/pt/desktop) que executa o CLI do Claude Code para você.

978 978 

979**O que fazer:**979**O que fazer:**

980 980 

981* Execute `/model` sem argumento para abrir o seletor e escolher entre os modelos disponíveis para sua conta, depois passe o alias ou ID mostrado lá981* Execute `/model` sem argumento para abrir o seletor e escolher entre os modelos disponíveis para sua conta, depois passe o alias ou ID mostrado lá

982* Se você usou um alias que uma versão mais recente do Claude Code suporta, execute `claude update`. Um ID completo que começa com `claude-` passa nesta verificação mesmo quando o modelo é mais recente que sua versão do Claude Code, então atualizar não é necessário para esses.982* Se você usou um alias que uma versão mais recente do Claude Code suporta, execute `claude update`. Um ID completo que começa com `claude-` passa nesta verificação mesmo quando o modelo é mais recente que sua versão do Claude Code, então atualizar não é necessário para esses.

983* Um modelo salvo antes de v2.1.200 não é reparado por esta verificação. Se um valor obsoleto continuar voltando, remova-o dos locais listados em [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model).983* Um modelo salvo antes de v2.1.200 não é reparado por esta verificação. Se um valor obsoleto continuar voltando, remova-o dos locais listados em [Há um problema com o modelo selecionado](#theres-an-issue-with-the-selected-model).

984* A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/pt/claude-platform-on-aws) e atrás de um [LLM gateway](/pt/llm-gateway) ou um `ANTHROPIC_BASE_URL` customizado, seu provedor ou gateway define os nomes dos modelos, então Claude Code aceita qualquer string e a passa.984* A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e atrás de um [LLM gateway](/docs/pt/llm-gateway) ou um `ANTHROPIC_BASE_URL` customizado, seu provedor ou gateway define os nomes dos modelos, então Claude Code aceita qualquer string e a passa.

985 985 

986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

987 Claude Opus não está disponível com o plano Claude Pro987 Claude Opus não está disponível com o plano Claude Pro


1003 Modelo é restringido pelas configurações da sua organização1003 Modelo é restringido pelas configurações da sua organização

1004</h3>1004</h3>

1005 1005 

1006Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou ele é excluído por uma lista de permissões [`availableModels`](/pt/model-config#restrict-model-selection) em configurações gerenciadas. Quando o modelo restringido foi definido com `--model`, `ANTHROPIC_MODEL` ou a configuração `model`, Claude Code substitui um modelo permitido e continua. Digitar `/model <name>` para um modelo restringido é rejeitado com `Run /model to choose a different model.` e a sessão mantém seu modelo atual.1006Seu administrador de organização desabilitou este modelo no console de administração claude.ai, ou ele é excluído por uma lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) em configurações gerenciadas. Quando o modelo restringido foi definido com `--model`, `ANTHROPIC_MODEL` ou a configuração `model`, Claude Code substitui um modelo permitido e continua. Digitar `/model <name>` para um modelo restringido é rejeitado com `Run /model to choose a different model.` e a sessão mantém seu modelo atual.

1007 1007 

1008```text theme={null}1008```text theme={null}

1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

1010```1010```

1011 1011 

1012Claude Code trata um alias de família de modelo, um de `opus`, `sonnet`, `haiku` ou `fable`, como uma solicitação para essa família em vez de sua versão mais recente. Na API Anthropic e em [Claude Platform on AWS](/pt/claude-platform-on-aws), um alias de família restringido resolve para a versão mais recente da família que sua organização e a lista de permissões `availableModels` permitem, e o aviso de substituição nomeia essa versão. Claude Code rejeita `/model <alias>` apenas quando cada versão da família é restringida. Antes de v2.1.205, um alias de família era substituído ou rejeitado com base em sua versão mais recente sozinha, mesmo quando uma versão mais antiga da mesma família era permitida.1012Claude Code trata um alias de família de modelo, um de `opus`, `sonnet`, `haiku` ou `fable`, como uma solicitação para essa família em vez de sua versão mais recente. Na API Anthropic e em [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), um alias de família restringido resolve para a versão mais recente da família que sua organização e a lista de permissões `availableModels` permitem, e o aviso de substituição nomeia essa versão. Claude Code rejeita `/model <alias>` apenas quando cada versão da família é restringida. Antes de v2.1.205, um alias de família era substituído ou rejeitado com base em sua versão mais recente sozinha, mesmo quando uma versão mais antiga da mesma família era permitida.

1013 1013 

1014**O que fazer:**1014**O que fazer:**

1015 1015 

1016* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restritos estão ocultos do seletor.1016* Execute `/model` para escolher entre os modelos que sua organização permite. Modelos restritos estão ocultos do seletor.

1017* Se o modelo restringido foi definido em `--model`, `ANTHROPIC_MODEL` ou o campo `model` de um arquivo de configurações, remova ou atualize esse valor para que o aviso não recorra em cada inicialização1017* Se o modelo restringido foi definido em `--model`, `ANTHROPIC_MODEL` ou o campo `model` de um arquivo de configurações, remova ou atualize esse valor para que o aviso não recorra em cada inicialização

1018* Se você precisa de acesso ao modelo restringido, peça ao administrador da sua organização para habilitá-lo. Veja [Organization model restrictions](/pt/model-config#organization-model-restrictions).1018* Se você precisa de acesso ao modelo restringido, peça ao administrador da sua organização para habilitá-lo. Veja [Organization model restrictions](/docs/pt/model-config#organization-model-restrictions).

1019 1019 

1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

1021 thinking.type.enabled não é suportado para este modelo1021 thinking.type.enabled não é suportado para este modelo


1031 1031 

1032* Execute `claude update` e reinicie Claude Code. Opus 4.7 precisa de v2.1.111 ou posterior. Opus 4.8 precisa de v2.1.154 ou posterior. Sonnet 5 precisa de v2.1.197 ou posterior1032* Execute `claude update` e reinicie Claude Code. Opus 4.7 precisa de v2.1.111 ou posterior. Opus 4.8 precisa de v2.1.154 ou posterior. Sonnet 5 precisa de v2.1.197 ou posterior

1033* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6 em vez disso1033* Se você não conseguir atualizar, execute `/model` e selecione Opus 4.6 ou Sonnet 4.6 em vez disso

1034* {/* min-version: agent-sdk@0.3.197 */}Se você encontrar isso no [Agent SDK](/pt/agent-sdk/overview), atualize o pacote SDK em vez disso. Opus 4.8 precisa do TypeScript SDK v0.3.154 ou posterior e do Python SDK v0.2.88 ou posterior. Sonnet 5 precisa do TypeScript SDK v0.3.197 ou posterior1034* Se você encontrar isso no [Agent SDK](/docs/pt/agent-sdk/overview), atualize o pacote SDK em vez disso. Opus 4.8 precisa do TypeScript SDK v0.3.154 ou posterior e do Python SDK v0.2.88 ou posterior. Sonnet 5 precisa do TypeScript SDK v0.3.197 ou posterior

1035 1035 

1036<h3 id="thinking-budget-exceeds-output-limit">1036<h3 id="thinking-budget-exceeds-output-limit">

1037 Orçamento de pensamento excede limite de saída1037 Orçamento de pensamento excede limite de saída


1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

1044```1044```

1045 1045 

1046Claude Code ajusta esses valores automaticamente na API Anthropic. Você normalmente vê esse erro no Amazon Bedrock ou Agent Platform do Google Cloud quando [`MAX_THINKING_TOKENS`](/pt/env-vars) é definido mais alto que o limite de saída do provedor, ou quando o modo de plano aumenta o orçamento de pensamento.1046Claude Code ajusta esses valores automaticamente na API Anthropic. Você normalmente vê esse erro no Amazon Bedrock ou Agent Platform do Google Cloud quando [`MAX_THINKING_TOKENS`](/docs/pt/env-vars) é definido mais alto que o limite de saída do provedor, ou quando o modo de plano aumenta o orçamento de pensamento.

1047 1047 

1048**O que fazer:**1048**O que fazer:**

1049 1049 

1050* Diminua `MAX_THINKING_TOKENS`, ou aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/pt/env-vars) acima do orçamento de pensamento1050* Diminua `MAX_THINKING_TOKENS`, ou aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/pt/env-vars) acima do orçamento de pensamento

1051* Veja [Extended thinking](/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída1051* Veja [Extended thinking](/docs/pt/model-config#extended-thinking) para como o orçamento interage com o comprimento de saída

1052 1052 

1053<h3 id="tool-use-or-thinking-block-mismatch">1053<h3 id="tool-use-or-thinking-block-mismatch">

1054 Incompatibilidade de bloco de uso de ferramenta ou pensamento1054 Incompatibilidade de bloco de uso de ferramenta ou pensamento


1066 1066 

1067**O que fazer:**1067**O que fazer:**

1068 1068 

1069* {/* max-version: 2.1.155 */}Se você está usando Opus 4.7 ou Opus 4.8, execute `claude update` primeiro. Versões anteriores a v2.1.156 podem acionar esse erro durante o uso normal de ferramentas, e `/rewind` não o limpa.1069* Se você está usando Opus 4.7 ou Opus 4.8, execute `claude update` primeiro. Versões anteriores a v2.1.156 podem acionar esse erro durante o uso normal de ferramentas, e `/rewind` não o limpa.

1070* Execute `/rewind`, ou pressione Esc duas vezes, para voltar a um checkpoint antes do turno corrompido e continuar de lá. Veja [Checkpointing](/pt/checkpointing) para como os checkpoints são criados e restaurados.1070* Execute `/rewind`, ou pressione Esc duas vezes, para voltar a um checkpoint antes do turno corrompido e continuar de lá. Veja [Checkpointing](/docs/pt/checkpointing) para como os checkpoints são criados e restaurados.

1071 1071 

1072<h3 id="usage-policy-refusal">1072<h3 id="usage-policy-refusal">

1073 Recusa de Política de Uso1073 Recusa de Política de Uso


1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

1080```1080```

1081 1081 

1082A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente re-aciona a mesma recusa. O mesmo se aplica após sair e reabrir a sessão com `--continue` ou `--resume`, já que a transcrição em disco ainda contém o conteúdo acionador. Em [Amazon Bedrock](/pt/amazon-bedrock), [Agent Platform do Google Cloud](/pt/google-vertex-ai) e [Microsoft Foundry](/pt/microsoft-foundry), esta mensagem também cobre solicitações que as medidas de segurança do modelo sinalizaram como um tópico de cibersegurança. Veja [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).1082A verificação avalia a conversa completa, não apenas seu prompt mais recente, então enviar uma nova mensagem na mesma sessão geralmente re-aciona a mesma recusa. O mesmo se aplica após sair e reabrir a sessão com `--continue` ou `--resume`, já que a transcrição em disco ainda contém o conteúdo acionador. Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), esta mensagem também cobre solicitações que as medidas de segurança do modelo sinalizaram como um tópico de cibersegurança. Veja [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).

1083 1083 

1084**O que fazer:**1084**O que fazer:**

1085 1085 

1086* Pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes do turno que acionou a recusa, depois reformule ou tome uma abordagem diferente. Veja [Checkpointing](/pt/checkpointing).1086* Pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes do turno que acionou a recusa, depois reformule ou tome uma abordagem diferente. Veja [Checkpointing](/docs/pt/checkpointing).

1087* Se você não conseguir identificar qual turno causou, execute `/clear` para iniciar uma conversa nova no mesmo projeto. Sua conversa anterior é preservada em disco e permanece disponível em `/resume`.1087* Se você não conseguir identificar qual turno causou, execute `/clear` para iniciar uma conversa nova no mesmo projeto. Sua conversa anterior é preservada em disco e permanece disponível em `/resume`.

1088* Em [modo não interativo](/pt/headless) (`-p`), onde rewind não está disponível, tente novamente com um prompt reformulado em uma nova sessão sem `--continue`. As verificações de política variam por modelo, então mudar para um modelo diferente com `--model` também pode resolver a recusa em alguns casos.1088* Em [modo não interativo](/docs/pt/headless) (`-p`), onde rewind não está disponível, tente novamente com um prompt reformulado em uma nova sessão sem `--continue`. As verificações de política variam por modelo, então mudar para um modelo diferente com `--model` também pode resolver a recusa em alguns casos.

1089 1089 

1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">

1091 Medidas de segurança sinalizaram um tópico de cibersegurança1091 Medidas de segurança sinalizaram um tópico de cibersegurança


1103 1103 

1104O que você vê depende do seu provedor e modo:1104O que você vê depende do seu provedor e modo:

1105 1105 

1106* Em [Amazon Bedrock](/pt/amazon-bedrock), [Agent Platform do Google Cloud](/pt/google-vertex-ai) e [Microsoft Foundry](/pt/microsoft-foundry), uma sinalização de cibersegurança produz a mensagem de [Recusa de Política de Uso](#usage-policy-refusal) em vez disso.1106* Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), uma sinalização de cibersegurança produz a mensagem de [Recusa de Política de Uso](#usage-policy-refusal) em vez disso.

1107* [Modo não interativo](/pt/headless) omite a sentença `/feedback`.1107* [Modo não interativo](/docs/pt/headless) omite a sentença `/feedback`.

1108 1108 

1109{/* max-version: 2.1.202 */}Antes de v2.1.203, a mensagem lia `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguida por um link de formulário de isenção.1109Antes de v2.1.203, a mensagem lia `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguida por um link de formulário de isenção.

1110 1110 

1111**O que fazer:**1111**O que fazer:**

1112 1112 

1113* Se seu trabalho exigir este conteúdo, solicite acesso através do [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)1113* Se seu trabalho exigir este conteúdo, solicite acesso através do [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

1114* Se sua solicitação não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo1114* Se sua solicitação não era sobre um tópico de cibersegurança, execute `/feedback` para relatar o falso positivo

1115* Para continuar trabalhando na mesma sessão, pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes do turno que acionou a sinalização, depois tome uma abordagem diferente. Veja [Checkpointing](/pt/checkpointing).1115* Para continuar trabalhando na mesma sessão, pressione Esc duas vezes ou execute `/rewind` para voltar a um checkpoint antes do turno que acionou a sinalização, depois tome uma abordagem diferente. Veja [Checkpointing](/docs/pt/checkpointing).

1116 1116 

1117<h2 id="installation-errors">1117<h2 id="installation-errors">

1118 Erros de instalação1118 Erros de instalação

1119</h2>1119</h2>

1120 1120 

1121Esses erros aparecem durante a instalação ou atualização do Claude Code, a partir do [script de instalação](/pt/setup#install-claude-code), `claude install`, ou `claude update`. Para problemas de `command not found`, PATH, permissão e TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/pt/troubleshoot-install).1121Esses erros aparecem durante a instalação ou atualização do Claude Code, a partir do [script de instalação](/docs/pt/setup#install-claude-code), `claude install`, ou `claude update`. Para problemas de `command not found`, PATH, permissão e TLS durante a configuração, consulte [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install).

1122 1122 

1123<h3 id="installation-was-killed-before-it-could-finish">1123<h3 id="installation-was-killed-before-it-could-finish">

1124 A instalação foi interrompida antes de ser concluída1124 A instalação foi interrompida antes de ser concluída


1136**O que fazer:**1136**O que fazer:**

1137 1137 

1138* Interrompa outros processos para liberar memória e execute novamente o instalador1138* Interrompa outros processos para liberar memória e execute novamente o instalador

1139* Adicione espaço de swap ou mude para uma instância maior. Consulte [Instalação interrompida em servidores Linux com pouca memória](/pt/troubleshoot-install#install-killed-on-low-memory-linux-servers) para os comandos de arquivo de swap.1139* Adicione espaço de swap ou mude para uma instância maior. Consulte [Instalação interrompida em servidores Linux com pouca memória](/docs/pt/troubleshoot-install#install-killed-on-low-memory-linux-servers) para os comandos de arquivo de swap.

1140 1140 

1141<h3 id="the-connection-dropped-while-downloading-the-update">1141<h3 id="the-connection-dropped-while-downloading-the-update">

1142 A conexão foi interrompida durante o download da atualização1142 A conexão foi interrompida durante o download da atualização

1143</h3>1143</h3>

1144 1144 

1145A conexão com o servidor de download foi fechada enquanto `claude install`, `claude update`, ou o [atualizador automático](/pt/setup#auto-updates) estava buscando o binário do Claude Code, e as tentativas de repetição não se recuperaram. Claude Code tenta novamente o download quando a conexão cai, a transferência trava ou o arquivo baixado falha em sua soma de verificação, até três tentativas no total. Um erro HTTP concluído, como um 404, não é repetido porque o servidor já respondeu. {/* min-version: 2.1.202 */}Antes da v2.1.202, uma única conexão interrompida falhava no download imediatamente com o erro nú `aborted` em vez de tentar novamente.1145A conexão com o servidor de download foi fechada enquanto `claude install`, `claude update`, ou o [atualizador automático](/docs/pt/setup#auto-updates) estava buscando o binário do Claude Code, e as tentativas de repetição não se recuperaram. Claude Code tenta novamente o download quando a conexão cai, a transferência trava ou o arquivo baixado falha em sua soma de verificação, até três tentativas no total. Um erro HTTP concluído, como um 404, não é repetido porque o servidor já respondeu. Antes da v2.1.202, uma única conexão interrompida falhava no download imediatamente com o erro nú `aborted` em vez de tentar novamente.

1146 1146 

1147```text theme={null}1147```text theme={null}

1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.


1157**O que fazer:**1157**O que fazer:**

1158 1158 

1159* Execute `claude update` novamente. Em uma rede caso contrário saudável, o download geralmente é bem-sucedido na próxima execução. Para a mensagem de tempo limite, execute-a novamente de uma rede mais rápida ou menos limitada.1159* Execute `claude update` novamente. Em uma rede caso contrário saudável, o download geralmente é bem-sucedido na próxima execução. Para a mensagem de tempo limite, execute-a novamente de uma rede mais rápida ou menos limitada.

1160* Se sua rede exigir um proxy, defina `HTTPS_PROXY` antes de executar o instalador ou `claude update`. Consulte [Verificar conectividade de rede](/pt/troubleshoot-install#check-network-connectivity).1160* Se sua rede exigir um proxy, defina `HTTPS_PROXY` antes de executar o instalador ou `claude update`. Consulte [Verificar conectividade de rede](/docs/pt/troubleshoot-install#check-network-connectivity).

1161* Se um proxy corporativo continuar fechando a transferência, peça à sua equipe de rede para permitir o download completo de `downloads.claude.ai`. Consulte [Requisitos de acesso à rede](/pt/network-config#network-access-requirements).1161* Se um proxy corporativo continuar fechando a transferência, peça à sua equipe de rede para permitir o download completo de `downloads.claude.ai`. Consulte [Requisitos de acesso à rede](/docs/pt/network-config#network-access-requirements).

1162* Execute `claude doctor` do seu shell para diagnósticos de instalação1162* Execute `claude doctor` do seu shell para diagnósticos de instalação

1163 1163 

1164<h2 id="command-line-errors">1164<h2 id="command-line-errors">


1171 Conflito entre --bg e --print1171 Conflito entre --bg e --print

1172</h3>1172</h3>

1173 1173 

1174Esta mensagem requer Claude Code v2.1.198 ou posterior. Você combinou `--bg` com `-p` ou `--print` na mesma invocação de `claude`. `--bg` inicia uma [sessão em background](/pt/agent-view#from-your-shell) que você depois anexa com `claude agents`, enquanto `--print` executa [não interativamente](/pt/headless) e nunca inicia a sessão interativa que `claude agents` anexa. Antes da v2.1.198, essa combinação criava silenciosamente um job em background que nunca poderia ser anexado.1174Esta mensagem requer Claude Code v2.1.198 ou posterior. Você combinou `--bg` com `-p` ou `--print` na mesma invocação de `claude`. `--bg` inicia uma [sessão em background](/docs/pt/agent-view#from-your-shell) que você depois anexa com `claude agents`, enquanto `--print` executa [não interativamente](/docs/pt/headless) e nunca inicia a sessão interativa que `claude agents` anexa. Antes da v2.1.198, essa combinação criava silenciosamente um job em background que nunca poderia ser anexado.

1175 1175 

1176```text theme={null}1176```text theme={null}

1177--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.1177--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.


1179 1179 

1180**O que fazer:**1180**O que fazer:**

1181 1181 

1182* Remova `-p` ou `--print`. `--bg` recebe o prompt como seu argumento posicional, então `claude --bg "<task>"` é o comando completo. Veja [Dispatch new agents from your shell](/pt/agent-view#from-your-shell).1182* Remova `-p` ou `--print`. `--bg` recebe o prompt como seu argumento posicional, então `claude --bg "<task>"` é o comando completo. Veja [Dispatch new agents from your shell](/docs/pt/agent-view#from-your-shell).

1183* Para executar o prompt não interativamente e imprimir o resultado em vez de criar uma sessão em background, remova `--bg` e execute `claude -p "<task>"`1183* Para executar o prompt não interativamente e imprimir o resultado em vez de criar uma sessão em background, remova `--bg` e execute `claude -p "<task>"`

1184 1184 

1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

1186 O valor de --json-schema não é um JSON Schema válido1186 O valor de --json-schema não é um JSON Schema válido

1187</h3>1187</h3>

1188 1188 

1189O schema que você passou para [`--json-schema`](/pt/cli-reference#cli-flags) no [modo não interativo](/pt/headless#get-structured-output) falhou na compilação do JSON Schema, então `claude` sai com código 1 em vez de executar o prompt. Antes da v2.1.205, um schema inválido produzia saída não estruturada sem erro, e qualquer schema que usasse a palavra-chave `format` era tratado como inválido.1189O schema que você passou para [`--json-schema`](/docs/pt/cli-reference#cli-flags) no [modo não interativo](/docs/pt/headless#get-structured-output) falhou na compilação do JSON Schema, então `claude` sai com código 1 em vez de executar o prompt. Antes da v2.1.205, um schema inválido produzia saída não estruturada sem erro, e qualquer schema que usasse a palavra-chave `format` era tratado como inválido.

1190 1190 

1191```text theme={null}1191```text theme={null}

1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values


1200 1200 

1201* Corrija a parte do schema que o diagnóstico nomeia, depois execute o comando novamente1201* Corrija a parte do schema que o diagnóstico nomeia, depois execute o comando novamente

1202* Se o diagnóstico for `schema too large`, reduza o aninhamento do schema e a reutilização de `$ref`1202* Se o diagnóstico for `schema too large`, reduza o aninhamento do schema e a reutilização de `$ref`

1203* Veja [Get structured output](/pt/headless#get-structured-output) para um schema e comando funcionando1203* Veja [Get structured output](/docs/pt/headless#get-structured-output) para um schema e comando funcionando

1204 1204 

1205<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">

1206 Não foi possível importar um servidor do Claude Desktop1206 Não foi possível importar um servidor do Claude Desktop


1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1213```1213```

1214 1214 

1215O texto após o nome do servidor é o motivo. O mais comum é a verificação de nome: Claude Desktop permite caracteres em nomes de servidores, como espaços e pontos, que `claude mcp` restringe a letras, números, hífens e sublinhados. Outros motivos incluem uma configuração de servidor que falha na validação e um servidor bloqueado pela [política MCP](/pt/managed-mcp) da sua organização.1215O texto após o nome do servidor é o motivo. O mais comum é a verificação de nome: Claude Desktop permite caracteres em nomes de servidores, como espaços e pontos, que `claude mcp` restringe a letras, números, hífens e sublinhados. Outros motivos incluem uma configuração de servidor que falha na validação e um servidor bloqueado pela [política MCP](/docs/pt/managed-mcp) da sua organização.

1216 1216 

1217**O que fazer:**1217**O que fazer:**

1218 1218 

1219* Renomeie o servidor em `claude_desktop_config.json` para usar apenas letras, números, hífens e sublinhados, depois execute `claude mcp add-from-claude-desktop` novamente1219* Renomeie o servidor em `claude_desktop_config.json` para usar apenas letras, números, hífens e sublinhados, depois execute `claude mcp add-from-claude-desktop` novamente

1220* Adicione esse servidor diretamente com `claude mcp add` ou `claude mcp add-json` sob um nome válido. Veja [Import MCP servers from Claude Desktop](/pt/mcp#import-mcp-servers-from-claude-desktop).1220* Adicione esse servidor diretamente com `claude mcp add` ou `claude mcp add-json` sob um nome válido. Veja [Import MCP servers from Claude Desktop](/docs/pt/mcp#import-mcp-servers-from-claude-desktop).

1221 1221 

1222<h3 id="mcp-permission-prompt-tool-not-found">1222<h3 id="mcp-permission-prompt-tool-not-found">

1223 Ferramenta de prompt de permissão MCP não encontrada1223 Ferramenta de prompt de permissão MCP não encontrada

1224</h3>1224</h3>

1225 1225 

1226A ferramenta que você passou para [`--permission-prompt-tool`](/pt/cli-reference#cli-flags) não estava entre as ferramentas MCP conectadas quando a execução primeiro precisou de uma decisão de permissão, seja porque seu servidor nunca se conectou ou porque nenhum servidor conectado expõe uma ferramenta com esse nome. Claude Code ainda envia seu prompt: a execução [não interativa](/pt/headless) sai com esse erro, e código de saída 1, na primeira chamada de ferramenta que precisa de aprovação, então não produz resposta mesmo que a solicitação tenha sido feita. Antes do primeiro prompt, Claude Code aguarda até o tempo limite de conexão por servidor de 30 segundos definido por [`MCP_TIMEOUT`](/pt/env-vars) para que esse servidor se conecte. {/* min-version: 2.1.206 */}Antes da v2.1.206, a inicialização não aguardava o servidor terminar de se conectar, então um servidor que iniciava lentamente mas estava saudável também produzia esse erro.1226A ferramenta que você passou para [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) não estava entre as ferramentas MCP conectadas quando a execução primeiro precisou de uma decisão de permissão, seja porque seu servidor nunca se conectou ou porque nenhum servidor conectado expõe uma ferramenta com esse nome. Claude Code ainda envia seu prompt: a execução [não interativa](/docs/pt/headless) sai com esse erro, e código de saída 1, na primeira chamada de ferramenta que precisa de aprovação, então não produz resposta mesmo que a solicitação tenha sido feita. Antes do primeiro prompt, Claude Code aguarda até o tempo limite de conexão por servidor de 30 segundos definido por [`MCP_TIMEOUT`](/docs/pt/env-vars) para que esse servidor se conecte. Antes da v2.1.206, a inicialização não aguardava o servidor terminar de se conectar, então um servidor que iniciava lentamente mas estava saudável também produzia esse erro.

1227 1227 

1228```text theme={null}1228```text theme={null}

1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none


1235 1235 

1236* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme se o servidor está listado como conectado1236* Verifique se o servidor inicia e permanece conectado: execute `claude mcp list` no mesmo diretório e confirme se o servidor está listado como conectado

1237* Confirme se o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe1237* Confirme se o nome da ferramenta corresponde ao nome `mcp__<server>__<tool>` que o servidor expõe

1238* Se o servidor precisar de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/pt/env-vars)1238* Se o servidor precisar de mais de 30 segundos para iniciar, aumente [`MCP_TIMEOUT`](/docs/pt/env-vars)

1239 1239 

1240<h2 id="plugin-errors">1240<h2 id="plugin-errors">

1241 Erros de plugin1241 Erros de plugin

1242</h2>1242</h2>

1243 1243 

1244Esses erros vêm da configuração de [plugin](/pt/plugins) e [marketplace](/pt/plugin-marketplaces). Para problemas de plugin que não produzem uma das mensagens nesta página, como uma URL de marketplace que não carrega ou um plugin que é instalado mas não aparece, consulte [Solução de problemas de plugin](/pt/discover-plugins#troubleshooting).1244Esses erros vêm da configuração de [plugin](/docs/pt/plugins) e [marketplace](/docs/pt/plugin-marketplaces). Para problemas de plugin que não produzem uma das mensagens nesta página, como uma URL de marketplace que não carrega ou um plugin que é instalado mas não aparece, consulte [Solução de problemas de plugin](/docs/pt/discover-plugins#troubleshooting).

1245 1245 

1246<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">

1247 Marketplace registrado de uma fonte não confiável1247 Marketplace registrado de uma fonte não confiável

1248</h3>1248</h3>

1249 1249 

1250O marketplace é registrado sob um nome que é [reservado para marketplaces oficiais da Anthropic](/pt/plugin-marketplaces#marketplace-schema), mas sua fonte registrada não é um repositório GitHub `anthropics`. Claude Code verifica novamente os nomes reservados toda vez que carrega ou atualiza um marketplace, portanto o marketplace e os plugins instalados a partir dele param de carregar. Antes da v2.1.205, o nome era verificado apenas quando o marketplace era adicionado, então uma entrada registrada antes de seu nome ficar reservado continuava carregando.1250O marketplace é registrado sob um nome que é [reservado para marketplaces oficiais da Anthropic](/docs/pt/plugin-marketplaces#marketplace-schema), mas sua fonte registrada não é um repositório GitHub `anthropics`. Claude Code verifica novamente os nomes reservados toda vez que carrega ou atualiza um marketplace, portanto o marketplace e os plugins instalados a partir dele param de carregar. Antes da v2.1.205, o nome era verificado apenas quando o marketplace era adicionado, então uma entrada registrada antes de seu nome ficar reservado continuava carregando.

1251 1251 

1252```text theme={null}1252```text theme={null}

1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.


1257 1257 

1258* Execute `claude plugin marketplace remove <name>`, depois adicione o marketplace novamente do repositório oficial `github.com/anthropics`1258* Execute `claude plugin marketplace remove <name>`, depois adicione o marketplace novamente do repositório oficial `github.com/anthropics`

1259* Se você publicar um marketplace de terceiros que usou o nome antes de ele ficar reservado, renomeie-o e peça aos usuários para adicioná-lo novamente de sua fonte1259* Se você publicar um marketplace de terceiros que usou o nome antes de ele ficar reservado, renomeie-o e peça aos usuários para adicioná-lo novamente de sua fonte

1260* Consulte a lista de nomes reservados em [Marketplace schema](/pt/plugin-marketplaces#marketplace-schema)1260* Consulte a lista de nomes reservados em [Marketplace schema](/docs/pt/plugin-marketplaces#marketplace-schema)

1261 1261 

1262<h3 id="plugin-command-references-user-config">1262<h3 id="plugin-command-references-user-config">

1263 Plugin command references user\_config in a shell command1263 Plugin command references user\_config in a shell command

1264</h3>1264</h3>

1265 1265 

1266Um hook de plugin, [monitor](/pt/plugins-reference#monitors), ou comando MCP [`headersHelper`](/pt/mcp#use-dynamic-headers-for-custom-authentication) referencia uma [opção de plugin](/pt/plugins-reference#user-configuration) `${user_config.KEY}`, e a string substituída seria passada para um shell. Um valor configurado contendo `$(...)`, backticks ou `;` seria executado como código lá, então Claude Code recusa iniciar o componente em vez de substituir o valor. A verificação é executada no modelo de comando, então o erro aparece mesmo quando nenhum valor está configurado ainda. Antes da v2.1.207, o valor era substituído no comando shell.1266Um hook de plugin, [monitor](/docs/pt/plugins-reference#monitors), ou comando MCP [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) referencia uma [opção de plugin](/docs/pt/plugins-reference#user-configuration) `${user_config.KEY}`, e a string substituída seria passada para um shell. Um valor configurado contendo `$(...)`, backticks ou `;` seria executado como código lá, então Claude Code recusa iniciar o componente em vez de substituir o valor. A verificação é executada no modelo de comando, então o erro aparece mesmo quando nenhum valor está configurado ainda. Antes da v2.1.207, o valor era substituído no comando shell.

1267 1267 

1268A redação depende de qual superfície referenciou a opção. Um hook em forma de shell relata:1268A redação depende de qual superfície referenciou a opção. Um hook em forma de shell relata:

1269 1269 


1285 1285 

1286**O que fazer:**1286**O que fazer:**

1287 1287 

1288* Para um hook, adicione um array `args` para que ele seja executado em [exec form](/pt/hooks#exec-form-and-shell-form), onde cada `${user_config.KEY}` se torna um argumento sem shell no meio. Ou remova a referência e leia a variável de ambiente `$CLAUDE_PLUGIN_OPTION_<KEY>` dentro do script1288* Para um hook, adicione um array `args` para que ele seja executado em [exec form](/docs/pt/hooks#exec-form-and-shell-form), onde cada `${user_config.KEY}` se torna um argumento sem shell no meio. Ou remova a referência e leia a variável de ambiente `$CLAUDE_PLUGIN_OPTION_<KEY>` dentro do script

1289* Para um monitor, remova a referência e faça o script do monitor ler o valor de um arquivo de configuração1289* Para um monitor, remova a referência e faça o script do monitor ler o valor de um arquivo de configuração

1290* Para um `headersHelper`, mova `${user_config.KEY}` para o campo `headers` do servidor, que não é analisado por shell, ou leia o valor dentro do script helper1290* Para um `headersHelper`, mova `${user_config.KEY}` para o campo `headers` do servidor, que não é analisado por shell, ou leia o valor dentro do script helper

1291 1291 


1299 Agent seria gerado com zero ferramentas1299 Agent seria gerado com zero ferramentas

1300</h3>1300</h3>

1301 1301 

1302Nada na [lista de `tools` de um subagente](/pt/sub-agents#supported-frontmatter-fields) foi resolvido para uma ferramenta, então Claude Code recusa iniciar o subagente em vez de iniciar um que não possa agir. A mensagem agrupa as entradas pelo motivo pelo qual não foram resolvidas: não é uma ferramenta reconhecida, uma ferramenta que não está disponível para subagentes, ou reconhecida mas não corresponde a nenhuma ferramenta na sessão atual. Omitir o campo `tools` nunca dispara essa recusa. Um padrão de servidor MCP como `mcp__github__*` não é isento: quando nenhuma ferramenta conectada vem desse servidor, o lançamento é recusado com o padrão no grupo de não correspondência. Antes da v2.1.208, o subagente era lançado sem ferramentas e retornava um resultado vazio ou confuso.1302Nada na [lista de `tools` de um subagente](/docs/pt/sub-agents#supported-frontmatter-fields) foi resolvido para uma ferramenta, então Claude Code recusa iniciar o subagente em vez de iniciar um que não possa agir. A mensagem agrupa as entradas pelo motivo pelo qual não foram resolvidas: não é uma ferramenta reconhecida, uma ferramenta que não está disponível para subagentes, ou reconhecida mas não corresponde a nenhuma ferramenta na sessão atual. Omitir o campo `tools` nunca dispara essa recusa. Um padrão de servidor MCP como `mcp__github__*` não é isento: quando nenhuma ferramenta conectada vem desse servidor, o lançamento é recusado com o padrão no grupo de não correspondência. Antes da v2.1.208, o subagente era lançado sem ferramentas e retornava um resultado vazio ou confuso.

1303 1303 

1304```text theme={null}1304```text theme={null}

1305Agent 'code-reviewer' seria gerado com zero ferramentas — recusando. Sua lista de ferramentas foi resolvida para nada: não reconhecido [Grpe]. Corrija o frontmatter de ferramentas do agente ou passe um subagent_type diferente.1305Agent 'code-reviewer' seria gerado com zero ferramentas — recusando. Sua lista de ferramentas foi resolvida para nada: não reconhecido [Grpe]. Corrija o frontmatter de ferramentas do agente ou passe um subagent_type diferente.


1307 1307 

1308**O que fazer:**1308**O que fazer:**

1309 1309 

1310* Corrija cada entrada que o erro nomeia contra as [ferramentas disponíveis para subagentes](/pt/sub-agents#available-tools)1310* Corrija cada entrada que o erro nomeia contra as [ferramentas disponíveis para subagentes](/docs/pt/sub-agents#available-tools)

1311* Remova entradas para ferramentas que a sessão não possui, como ferramentas MCP de um servidor que não está conectado1311* Remova entradas para ferramentas que a sessão não possui, como ferramentas MCP de um servidor que não está conectado

1312* Para dar ao subagente todas as ferramentas que o pai tem, delete o campo `tools` em vez de listar ferramentas1312* Para dar ao subagente todas as ferramentas que o pai tem, delete o campo `tools` em vez de listar ferramentas

1313 1313 


1315 Arquivo é coberto por uma regra de negação Read1315 Arquivo é coberto por uma regra de negação Read

1316</h3>1316</h3>

1317 1317 

1318A ferramenta Edit foi chamada em um caminho correspondido por uma [regra de negação `Read`](/pt/permissions#read-and-edit), incluindo criar um novo arquivo nesse caminho. Editar reescreve conteúdo que Claude tem que ser capaz de ler novamente, então a chamada é recusada antes de qualquer acesso ao arquivo. A regra bloqueia apenas a ferramenta Edit: Write e NotebookEdit não são cobertos por regras de negação `Read`. Antes da v2.1.208, apenas uma regra de negação `Edit` bloqueava edições, e uma regra de negação `Read` sozinha não.1318A ferramenta Edit foi chamada em um caminho correspondido por uma [regra de negação `Read`](/docs/pt/permissions#read-and-edit), incluindo criar um novo arquivo nesse caminho. Editar reescreve conteúdo que Claude tem que ser capaz de ler novamente, então a chamada é recusada antes de qualquer acesso ao arquivo. A regra bloqueia apenas a ferramenta Edit: Write e NotebookEdit não são cobertos por regras de negação `Read`. Antes da v2.1.208, apenas uma regra de negação `Edit` bloqueava edições, e uma regra de negação `Read` sozinha não.

1319 1319 

1320```text theme={null}1320```text theme={null}

1321Arquivo é coberto por uma regra de negação Read em suas configurações de permissão e não pode ser editado.1321Arquivo é coberto por uma regra de negação Read em suas configurações de permissão e não pode ser editado.


1323 1323 

1324**O que fazer:**1324**O que fazer:**

1325 1325 

1326* Se Claude deve ser capaz de editar o arquivo, remova ou restrinja a regra de negação `Read` em `/permissions` ou em [configurações](/pt/settings#permission-settings)1326* Se Claude deve ser capaz de editar o arquivo, remova ou restrinja a regra de negação `Read` em `/permissions` ou em [configurações](/docs/pt/settings#permission-settings)

1327* Se o arquivo deve permanecer intocado, mantenha a regra e adicione uma regra de negação `Edit` para o mesmo caminho para que as ferramentas Write e NotebookEdit também sejam bloqueadas1327* Se o arquivo deve permanecer intocado, mantenha a regra e adicione uma regra de negação `Edit` para o mesmo caminho para que as ferramentas Write e NotebookEdit também sejam bloqueadas

1328 1328 

1329<h2 id="background-session-errors">1329<h2 id="background-session-errors">

1330 Erros de sessão em background1330 Erros de sessão em background

1331</h2>1331</h2>

1332 1332 

1333[Sessões em background](/pt/agent-view) são executadas sem um terminal interativo próprio, portanto comandos que precisam de um se comportam de forma diferente lá. Essas mensagens aparecem na transcrição de uma sessão em background, na visualização do agente ou após anexar.1333[Sessões em background](/docs/pt/agent-view) são executadas sem um terminal interativo próprio, portanto comandos que precisam de um se comportam de forma diferente lá. Essas mensagens aparecem na transcrição de uma sessão em background, na visualização do agente ou após anexar.

1334 1334 

1335<h3 id="commands-refused-in-a-background-session">1335<h3 id="commands-refused-in-a-background-session">

1336 Comandos recusados em uma sessão em background1336 Comandos recusados em uma sessão em background

1337</h3>1337</h3>

1338 1338 

1339Comandos que abrem um diálogo interativo são recusados em uma sessão em background com uma mensagem nomeando um formulário que funciona lá ou dizendo para você executar o comando a partir de um terminal regular. `/install-github-app`, a lista de configurações `/mcp` e as ações de autenticação no menu do servidor MCP são todos recusados dessa forma. Antes da v2.1.208, eles abriam seu diálogo dentro da sessão em background.1339Comandos que abrem um diálogo interativo são recusados em uma sessão em background com uma mensagem nomeando um formulário que funciona lá ou dizendo para você executar o comando a partir de um terminal regular. `/install-github-app`, a lista de configurações `/mcp` e as ações de autenticação no menu do servidor MCP são todos recusados dessa forma. Antes da v2.1.208, eles abriam seu diálogo dentro da sessão em background.

1340{/* max-version: 2.1.208 */}Na v2.1.208 apenas, o seletor `/model` também foi recusado em uma sessão em background, e `/upgrade` imprimiu a URL de atualização em vez de abrir um navegador.1340Na v2.1.208 apenas, o seletor `/model` também foi recusado em uma sessão em background, e `/upgrade` imprimiu a URL de atualização em vez de abrir um navegador.

1341 1341 

1342A redação nomeia o comando que foi recusado. A lista de configurações `/mcp` relata:1342A redação nomeia o comando que foi recusado. A lista de configurações `/mcp` relata:

1343 1343 


1354 Erros do launcher CLAUDE\_CODE\_PROCESS\_WRAPPER1354 Erros do launcher CLAUDE\_CODE\_PROCESS\_WRAPPER

1355</h3>1355</h3>

1356 1356 

1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/pt/corporate-launcher) está definido e seu valor não pode ser usado, portanto Claude Code recusa iniciar o processo afetado em vez de executá-lo sem o launcher. Problemas de configuração são relatados com uma mensagem que começa com o nome da variável e declara o motivo, por exemplo:1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/pt/corporate-launcher) está definido e seu valor não pode ser usado, portanto Claude Code recusa iniciar o processo afetado em vez de executá-lo sem o launcher. Problemas de configuração são relatados com uma mensagem que começa com o nome da variável e declara o motivo, por exemplo:

1358 1358 

1359```text theme={null}1359```text theme={null}

1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file


1364 1364 

1365**O que fazer:**1365**O que fazer:**

1366 1366 

1367* Defina a variável para o caminho absoluto de um executável que termina chamando `exec "$@"`. Veja [o contrato do launcher](/pt/corporate-launcher#the-launcher-contract) para o contrato completo1367* Defina a variável para o caminho absoluto de um executável que termina chamando `exec "$@"`. Veja [o contrato do launcher](/docs/pt/corporate-launcher#the-launcher-contract) para o contrato completo

1368* Verifique `/status`, que mostra o comando de inicialização resolvido em sua entrada Self-exec e avisa quando o serviço em background em execução não corresponde a ele, ou execute `claude daemon status` a partir de um shell1368* Verifique `/status`, que mostra o comando de inicialização resolvido em sua entrada Self-exec e avisa quando o serviço em background em execução não corresponde a ele, ou execute `claude daemon status` a partir de um shell

1369* Após corrigir o valor no bloco `env` de [settings](/pt/corporate-launcher#set-up-the-launcher), reinicie o serviço em background com `claude daemon stop --any` para que o próximo dispatch inicie um envolvido1369* Após corrigir o valor no bloco `env` de [settings](/docs/pt/corporate-launcher#set-up-the-launcher), reinicie o serviço em background com `claude daemon stop --any` para que o próximo dispatch inicie um envolvido

1370 1370 

1371<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">

1372 Avisos de configuração1372 Avisos de configuração


1378 Workspace não foi confiável1378 Workspace não foi confiável

1379</h3>1379</h3>

1380 1380 

1381Claude Code encontrou regras `permissions.allow` ou entradas `permissions.additionalDirectories` no arquivo `.claude/settings.json` ou `.claude/settings.local.json` do projeto e não as aplicou, porque [as regras de permissão do projeto requerem confiança do workspace](/pt/permissions#project-allow-rules-and-workspace-trust). A contagem, o nome da configuração e o arquivo nomeado na mensagem variam com sua configuração. As regras `deny` e `ask` não são afetadas.1381Claude Code encontrou regras `permissions.allow` ou entradas `permissions.additionalDirectories` no arquivo `.claude/settings.json` ou `.claude/settings.local.json` do projeto e não as aplicou, porque [as regras de permissão do projeto requerem confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust). A contagem, o nome da configuração e o arquivo nomeado na mensagem variam com sua configuração. As regras `deny` e `ask` não são afetadas.

1382 1382 

1383```text theme={null}1383```text theme={null}

1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.


1386 1386 

1387**O que fazer:**1387**O que fazer:**

1388 1388 

1389* Execute `claude` no diretório e aceite o diálogo de confiança. {/* min-version: 2.1.200 */}O diálogo aparece mesmo quando um diretório pai já é confiável, lista as regras sendo retidas e permite que você recuse e continue trabalhando sem elas. Antes da v2.1.200, nenhum diálogo aparecia nessa situação, então essa etapa não podia ser concluída lá.1389* Execute `claude` no diretório e aceite o diálogo de confiança. O diálogo aparece mesmo quando um diretório pai já é confiável, lista as regras sendo retidas e permite que você recuse e continue trabalhando sem elas. Antes da v2.1.200, nenhum diálogo aparecia nessa situação, então essa etapa não podia ser concluída lá.

1390* No [modo não interativo](/pt/headless) com `-p` nenhum diálogo é mostrado. Defina a entrada `hasTrustDialogAccepted` em `~/.claude.json` usando a chave `projects` exata que a mensagem imprime.1390* No [modo não interativo](/docs/pt/headless) com `-p` nenhum diálogo é mostrado. Defina a entrada `hasTrustDialogAccepted` em `~/.claude.json` usando a chave `projects` exata que a mensagem imprime.

1391* {/* min-version: 2.1.200 */}Se a mensagem nomear `.claude/settings.local.json` e você iniciou Claude Code fora de um repositório git ou no seu diretório inicial, atualize para v2.1.200 ou posterior. As versões 2.1.196 a 2.1.199 trataram seu próprio `.claude/settings.local.json` como fornecido pelo repositório nesses workspaces. {/* min-version: 2.1.207 */}Na v2.1.207 e posterior, atualizar não é suficiente fora de um repositório git se você não confiou na pasta: determinar que uma pasta não está dentro de um repositório executa git, e Claude Code executa essa verificação apenas depois que você aceita o diálogo de confiança, então use a primeira etapa. Seu diretório inicial e qualquer outro [diretório inicial de configuração](/pt/permissions#project-allow-rules-and-workspace-trust) estão isentos e não esperam pelo diálogo. Veja [Regras de permissão do projeto e confiança do workspace](/pt/permissions#project-allow-rules-and-workspace-trust).1391* Se a mensagem nomear `.claude/settings.local.json` e você iniciou Claude Code fora de um repositório git ou no seu diretório inicial, atualize para v2.1.200 ou posterior. As versões 2.1.196 a 2.1.199 trataram seu próprio `.claude/settings.local.json` como fornecido pelo repositório nesses workspaces. Na v2.1.207 e posterior, atualizar não é suficiente fora de um repositório git se você não confiou na pasta: determinar que uma pasta não está dentro de um repositório executa git, e Claude Code executa essa verificação apenas depois que você aceita o diálogo de confiança, então use a primeira etapa. Seu diretório inicial e qualquer outro [diretório inicial de configuração](/docs/pt/permissions#project-allow-rules-and-workspace-trust) estão isentos e não esperam pelo diálogo. Veja [Regras de permissão do projeto e confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust).

1392 1392 

1393<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">

1394 As respostas parecem ter qualidade inferior ao usual1394 As respostas parecem ter qualidade inferior ao usual


1396 1396 

1397Se as respostas do Claude parecerem menos capazes do que você espera, mas nenhum erro for exibido, a causa geralmente é o estado da conversa em vez do modelo em si. Claude Code não muda silenciosamente versões de modelo. Ele pode mudar para um modelo de fallback em três casos específicos:1397Se as respostas do Claude parecerem menos capazes do que você espera, mas nenhum erro for exibido, a causa geralmente é o estado da conversa em vez do modelo em si. Claude Code não muda silenciosamente versões de modelo. Ele pode mudar para um modelo de fallback em três casos específicos:

1398 1398 

1399* Um [`--fallback-model`](/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição1399* Um [`--fallback-model`](/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição

1400* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível1400* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível

1401* [Fallback automático de modelo](/pt/model-config#automatic-model-fallback) no Fable 5 move a sessão para o modelo Opus padrão e mostra um aviso na transcrição1401* [Fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback) no Fable 5 move a sessão para o modelo Opus padrão e mostra um aviso na transcrição

1402 1402 

1403A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/pt/model-config) explica quando cada fallback se aplica.1403A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](/docs/pt/model-config) explica quando cada fallback se aplica.

1404 1404 

1405Verifique estes primeiro:1405Verifique estes primeiro:

1406 1406 

1407* **Seleção de modelo**: execute `/model` para confirmar que você está no modelo que espera. Uma escolha anterior de `/model` ou uma variável de ambiente `ANTHROPIC_MODEL` pode colocá-lo em um modelo menor do que pretendia.1407* **Seleção de modelo**: execute `/model` para confirmar que você está no modelo que espera. Uma escolha anterior de `/model` ou uma variável de ambiente `ANTHROPIC_MODEL` pode colocá-lo em um modelo menor do que pretendia.

1408* **Nível de esforço**: execute `/effort` para verificar o nível de raciocínio atual e aumentá-lo para depuração difícil ou trabalho de design. Os padrões variam por modelo, então verifique antes de assumir que você está abaixo do máximo. Veja [Ajustar nível de esforço](/pt/model-config#adjust-effort-level) para padrões por modelo e o atalho `ultrathink`.1408* **Nível de esforço**: execute `/effort` para verificar o nível de raciocínio atual e aumentá-lo para depuração difícil ou trabalho de design. Os padrões variam por modelo, então verifique antes de assumir que você está abaixo do máximo. Veja [Ajustar nível de esforço](/docs/pt/model-config#adjust-effort-level) para padrões por modelo e o atalho `ultrathink`.

1409* **Pressão de contexto**: execute `/context` para ver o quão cheio está a janela. Se estiver próximo da capacidade, execute `/compact` em um ponto natural ou `/clear` para começar do zero. Veja [Explorar a janela de contexto](/pt/context-window) para como auto-compact afeta turnos anteriores.1409* **Pressão de contexto**: execute `/context` para ver o quão cheio está a janela. Se estiver próximo da capacidade, execute `/compact` em um ponto natural ou `/clear` para começar do zero. Veja [Explorar a janela de contexto](/docs/pt/context-window) para como auto-compact afeta turnos anteriores.

1410* **Instruções obsoletas**: arquivos `CLAUDE.md` grandes ou desatualizados e definições de ferramentas MCP consomem contexto e podem orientar respostas. {/* min-version: 2.1.205 */}A verificação `/doctor` sinaliza arquivos de memória superdimensionados e extensões não utilizadas, e `/context` mostra o uso de tokens de ferramentas MCP. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos que sinalizava arquivos de memória superdimensionados e definições de subagente.1410* **Instruções obsoletas**: arquivos `CLAUDE.md` grandes ou desatualizados e definições de ferramentas MCP consomem contexto e podem orientar respostas. A verificação `/doctor` sinaliza arquivos de memória superdimensionados e extensões não utilizadas, e `/context` mostra o uso de tokens de ferramentas MCP. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos que sinalizava arquivos de memória superdimensionados e definições de subagente.

1411 1411 

1412Quando uma resposta sai errada, retroceder geralmente funciona melhor do que responder com correções. Pressione Esc duas vezes ou execute `/rewind` para voltar antes do turno ruim, depois reformule o prompt com mais especificidades. Corrigir na thread mantém a tentativa errada no contexto, o que pode ancorar respostas posteriores a ela. Veja [Checkpointing](/pt/checkpointing).1412Quando uma resposta sai errada, retroceder geralmente funciona melhor do que responder com correções. Pressione Esc duas vezes ou execute `/rewind` para voltar antes do turno ruim, depois reformule o prompt com mais especificidades. Corrigir na thread mantém a tentativa errada no contexto, o que pode ancorar respostas posteriores a ela. Veja [Checkpointing](/docs/pt/checkpointing).

1413 1413 

1414Se a qualidade ainda parecer inadequada após verificar o acima, execute `/feedback` e descreva o que você esperava versus o que obteve. O feedback enviado desta forma inclui a transcrição da conversa, que é a forma mais rápida para a Anthropic diagnosticar uma regressão real. Veja [Relatar um erro](#report-an-error) se `/feedback` não estiver disponível em seu ambiente.1414Se a qualidade ainda parecer inadequada após verificar o acima, execute `/feedback` e descreva o que você esperava versus o que obteve. O feedback enviado desta forma inclui a transcrição da conversa, que é a forma mais rápida para a Anthropic diagnosticar uma regressão real. Veja [Relatar um erro](#report-an-error) se `/feedback` não estiver disponível em seu ambiente.

1415 1415 

1416Se Claude avisar sobre uma injeção de prompt suspeita, ou recusar uma solicitação por causa de uma injeção suspeita, e o texto que o aviso nomeia for contexto que Claude Code adiciona à conversa automaticamente em vez de conteúdo de arquivo ou web, execute `claude update` e tente novamente. Se o aviso se repetir após atualizar, [relate-o](#report-an-error) em vez de colar o conteúdo sinalizado de volta no prompt. {/* min-version: 2.1.201 */}Antes da v2.1.201, Sonnet 5 recusava algumas solicitações da mesma forma.1416Se Claude avisar sobre uma injeção de prompt suspeita, ou recusar uma solicitação por causa de uma injeção suspeita, e o texto que o aviso nomeia for contexto que Claude Code adiciona à conversa automaticamente em vez de conteúdo de arquivo ou web, execute `claude update` e tente novamente. Se o aviso se repetir após atualizar, [relate-o](#report-an-error) em vez de colar o conteúdo sinalizado de volta no prompt. Antes da v2.1.201, Sonnet 5 recusava algumas solicitações da mesma forma.

1417 1417 

1418<h2 id="report-an-error">1418<h2 id="report-an-error">

1419 Relatar um erro1419 Relatar um erro


1421 1421 

1422Para erros de componentes que esta página não cobre, consulte o guia relevante:1422Para erros de componentes que esta página não cobre, consulte o guia relevante:

1423 1423 

1424* Servidor MCP falhou ao conectar ou autenticar: [MCP](/pt/mcp)1424* Servidor MCP falhou ao conectar ou autenticar: [MCP](/docs/pt/mcp)

1425* Script de hook falhou ou bloqueou uma ferramenta: [Debug hooks](/pt/hooks#debug-hooks)1425* Script de hook falhou ou bloqueou uma ferramenta: [Debug hooks](/docs/pt/hooks#debug-hooks)

1426* Permissão negada ou erros do sistema de arquivos durante a instalação: [Solucionar problemas de instalação e login](/pt/troubleshoot-install)1426* Permissão negada ou erros do sistema de arquivos durante a instalação: [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install)

1427 1427 

1428Se um erro não estiver listado aqui ou a correção sugerida não ajudar:1428Se um erro não estiver listado aqui ou a correção sugerida não ajudar:

1429 1429 

1430* Execute `/feedback` dentro do Claude Code para enviar a transcrição e uma descrição para a Anthropic. O comando também oferece abrir um problema do GitHub pré-preenchido. O envio para a Anthropic requer [autenticação](/pt/authentication). No Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry e em outros provedores terceirizados, ou quando nenhuma credencial da Anthropic está configurada, `/feedback` salva um arquivo local que você pode enviar para seu representante de conta da Anthropic.1430* Execute `/feedback` dentro do Claude Code para enviar a transcrição e uma descrição para a Anthropic. O comando também oferece abrir um problema do GitHub pré-preenchido. O envio para a Anthropic requer [autenticação](/docs/pt/authentication). No Amazon Bedrock, na plataforma de agentes do Google Cloud, no Microsoft Foundry e em outros provedores terceirizados, ou quando nenhuma credencial da Anthropic está configurada, `/feedback` salva um arquivo local que você pode enviar para seu representante de conta da Anthropic.

1431* Execute `claude doctor` do seu shell para um diagnóstico somente leitura da sua instalação, ou execute o checkup `/doctor` dentro do Claude Code para encontrar e corrigir problemas de configuração1431* Execute `claude doctor` do seu shell para um diagnóstico somente leitura da sua instalação, ou execute o checkup `/doctor` dentro do Claude Code para encontrar e corrigir problemas de configuração

1432* Verifique [status.claude.com](https://status.claude.com) para incidentes ativos1432* Verifique [status.claude.com](https://status.claude.com) para incidentes ativos

1433* Pesquise [problemas existentes](https://github.com/anthropics/claude-code/issues) no GitHub1433* Pesquise [problemas existentes](https://github.com/anthropics/claude-code/issues) no GitHub

fast-mode.md +11 −11

Details

32Alterne o modo rápido de uma destas formas:32Alterne o modo rápido de uma destas formas:

33 33 

34* Digite `/fast` e pressione Tab para alternar ativado ou desativado34* Digite `/fast` e pressione Tab para alternar ativado ou desativado

35* Defina `"fastMode": true` no seu [arquivo de configurações do usuário](/pt/settings)35* Defina `"fastMode": true` no seu [arquivo de configurações do usuário](/docs/pt/settings)

36 36 

37Por padrão, o modo rápido que você ativa em uma sessão interativa persiste entre sessões. {/* min-version: 2.1.205 */}No [modo não interativo](/pt/headless), com a flag `-p`, `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância então se aplica apenas a essa sessão e não é salva como seu padrão, e em qualquer outra sessão não interativa o comando relata que o modo rápido não está disponível. Você pode configurar o modo rápido para ser redefinido a cada sessão. Consulte [require per-session opt-in](#require-per-session-opt-in) para obter detalhes.37Por padrão, o modo rápido que você ativa em uma sessão interativa persiste entre sessões. No [modo não interativo](/docs/pt/headless), com a flag `-p`, `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](/docs/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância então se aplica apenas a essa sessão e não é salva como seu padrão, e em qualquer outra sessão não interativa o comando relata que o modo rápido não está disponível. Você pode configurar o modo rápido para ser redefinido a cada sessão. Consulte [require per-session opt-in](#require-per-session-opt-in) para obter detalhes.

38 38 

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

40 40 


47 47 

48Quando você desativa o modo rápido com `/fast` novamente, você permanece no Opus. O modelo não reverte para seu modelo anterior. Para alternar para um modelo diferente, use `/model`.48Quando você desativa o modo rápido com `/fast` novamente, você permanece no Opus. O modelo não reverte para seu modelo anterior. Para alternar para um modelo diferente, use `/model`.

49 49 

50Alternar para um modelo que não suporta modo rápido desativa o modo rápido. {/* min-version: 2.1.208 */}Alternar de volta para um modelo Opus suportado o ativa novamente quando sua preferência de modo rápido salva está ativada, a mesma preferência que uma nova sessão inicia por padrão. Com [per-session opt-in](#require-per-session-opt-in) configurado, alternar de volta não ativa o modo rápido novamente; execute `/fast` para reativá-lo. O modo rápido nunca é ativado para uma sessão cuja preferência salva está desativada, e o ícone `↯` e a confirmação `Fast mode ON` aparecem sempre que ele é ativado. Antes da v2.1.208, o modo rápido permanecia desativado depois que você alternava de volta até executar `/fast` novamente.50Alternar para um modelo que não suporta modo rápido desativa o modo rápido. Alternar de volta para um modelo Opus suportado o ativa novamente quando sua preferência de modo rápido salva está ativada, a mesma preferência que uma nova sessão inicia por padrão. Com [per-session opt-in](#require-per-session-opt-in) configurado, alternar de volta não ativa o modo rápido novamente; execute `/fast` para reativá-lo. O modo rápido nunca é ativado para uma sessão cuja preferência salva está desativada, e o ícone `↯` e a confirmação `Fast mode ON` aparecem sempre que ele é ativado. Antes da v2.1.208, o modo rápido permanecia desativado depois que você alternava de volta até executar `/fast` novamente.

51 51 

52O Opus 4.8 é o padrão do modo rápido no Claude Code v2.1.154 e posterior. Na v2.1.142 até v2.1.153, o modo rápido usa como padrão o Opus 4.7.52O Opus 4.8 é o padrão do modo rápido no Claude Code v2.1.154 e posterior. Na v2.1.142 até v2.1.153, o modo rápido usa como padrão o Opus 4.7.

53 53 


64 64 

65O preço do modo rápido é fixo em toda a janela de contexto de 1M token. Para a taxa padrão do Opus para comparar, consulte a [referência de preços do Claude](https://platform.claude.com/docs/pt/about-claude/pricing).65O preço do modo rápido é fixo em toda a janela de contexto de 1M token. Para a taxa padrão do Opus para comparar, consulte a [referência de preços do Claude](https://platform.claude.com/docs/pt/about-claude/pricing).

66 66 

67A primeira vez que você ativa o modo rápido em uma conversa, você paga o preço total do token de entrada não armazenado em cache do modo rápido para todo o contexto da conversa. Quanto mais profundo você estiver em uma conversa, mais isso custa, portanto ativar o modo rápido desde o início é mais barato. O custo se aplica uma vez por conversa, portanto desativar e ativar o modo rápido novamente mais tarde não o repete. Para o mecanismo, consulte [como o modo rápido interage com o cache de prompt](/pt/prompt-caching#turning-on-fast-mode).67A primeira vez que você ativa o modo rápido em uma conversa, você paga o preço total do token de entrada não armazenado em cache do modo rápido para todo o contexto da conversa. Quanto mais profundo você estiver em uma conversa, mais isso custa, portanto ativar o modo rápido desde o início é mais barato. O custo se aplica uma vez por conversa, portanto desativar e ativar o modo rápido novamente mais tarde não o repete. Para o mecanismo, consulte [como o modo rápido interage com o cache de prompt](/docs/pt/prompt-caching#turning-on-fast-mode).

68 68 

69<h2 id="decide-when-to-use-fast-mode">69<h2 id="decide-when-to-use-fast-mode">

70 Decidir quando usar o modo rápido70 Decidir quando usar o modo rápido


93| **Modo rápido** | Mesma qualidade de modelo, latência mais baixa, custo mais alto |93| **Modo rápido** | Mesma qualidade de modelo, latência mais baixa, custo mais alto |

94| **Nível de esforço mais baixo** | Menos tempo de pensamento, respostas mais rápidas, qualidade potencialmente mais baixa em tarefas complexas |94| **Nível de esforço mais baixo** | Menos tempo de pensamento, respostas mais rápidas, qualidade potencialmente mais baixa em tarefas complexas |

95 95 

96Você pode combinar ambos: use o modo rápido com um [nível de esforço](/pt/model-config#adjust-effort-level) mais baixo para máxima velocidade em tarefas diretas.96Você pode combinar ambos: use o modo rápido com um [nível de esforço](/docs/pt/model-config#adjust-effort-level) mais baixo para máxima velocidade em tarefas diretas.

97 97 

98<h2 id="requirements">98<h2 id="requirements">

99 Requisitos99 Requisitos


111* **Habilitação de proprietário para Team e Enterprise**: o modo rápido está desativado por padrão para organizações Team e Enterprise. Um proprietário deve explicitamente [ativar o modo rápido](#enable-fast-mode-for-your-organization) antes que os usuários possam acessá-lo.111* **Habilitação de proprietário para Team e Enterprise**: o modo rápido está desativado por padrão para organizações Team e Enterprise. Um proprietário deve explicitamente [ativar o modo rápido](#enable-fast-mode-for-your-organization) antes que os usuários possam acessá-lo.

112 112 

113<Note>113<Note>

114 Se o modo rápido não tiver sido ativado para sua organização, o comando `/fast` mostrará "Fast mode has been disabled by your organization." Se a lista de permissões [`availableModels`](/pt/model-config#restrict-model-selection) da sua organização excluir o modelo Opus do modo rápido, `/fast` é recusado com "is not in your organization's allowed models". A exceção é uma sessão já em execução em um modelo Opus permitido que suporte modo rápido: `/fast` ativa o modo rápido no seu modelo atual em vez de alternar modelos.114 Se o modo rápido não tiver sido ativado para sua organização, o comando `/fast` mostrará "Fast mode has been disabled by your organization." Se a lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização excluir o modelo Opus do modo rápido, `/fast` é recusado com "is not in your organization's allowed models". A exceção é uma sessão já em execução em um modelo Opus permitido que suporte modo rápido: `/fast` ativa o modo rápido no seu modelo atual em vez de alternar modelos.

115</Note>115</Note>

116 116 

117<h3 id="enable-fast-mode-for-your-organization">117<h3 id="enable-fast-mode-for-your-organization">


123* **Console** (clientes de API): um administrador o ativa em [Preferências do Claude Code](https://platform.claude.com/claude-code/preferences)123* **Console** (clientes de API): um administrador o ativa em [Preferências do Claude Code](https://platform.claude.com/claude-code/preferences)

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

125 125 

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

127 127 

128<h3 id="require-per-session-opt-in">128<h3 id="require-per-session-opt-in">

129 Exigir opt-in por sessão129 Exigir opt-in por sessão

130</h3>130</h3>

131 131 

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

133 133 

134```json theme={null}134```json theme={null}

135{135{


168 Veja também168 Veja também

169</h2>169</h2>

170 170 

171* [Configuração de modelo](/pt/model-config): alterne modelos e ajuste níveis de esforço171* [Configuração de modelo](/docs/pt/model-config): alterne modelos e ajuste níveis de esforço

172* [Gerenciar custos efetivamente](/pt/costs): rastreie o uso de tokens e reduza custos172* [Gerenciar custos efetivamente](/docs/pt/costs): rastreie o uso de tokens e reduza custos

173* [Configuração da linha de status](/pt/statusline): exiba informações de modelo e contexto173* [Configuração da linha de status](/docs/pt/statusline): exiba informações de modelo e contexto

Details

6 6 

7> Compare quais recursos do Claude Code estão disponíveis em planos de assinatura Anthropic, Anthropic Console, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry.7> Compare quais recursos do Claude Code estão disponíveis em planos de assinatura Anthropic, Anthropic Console, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry.

8 8 

9O CLI do Claude Code e tudo que é executado localmente funcionam de forma idêntica em todos os provedores. Para instruções de configuração por provedor, consulte a [visão geral de implantação empresarial](/pt/third-party-integrations). Para ir direto ao que está faltando no seu provedor, consulte as abas [resumo por provedor](#summary-by-provider).9O CLI do Claude Code e tudo que é executado localmente funcionam de forma idêntica em todos os provedores. Para instruções de configuração por provedor, consulte a [visão geral de implantação empresarial](/docs/pt/third-party-integrations). Para ir direto ao que está faltando no seu provedor, consulte as abas [resumo por provedor](#summary-by-provider).

10 10 

11Nas tabelas abaixo, ✓ significa disponível, ✗ significa não disponível, e "Ver nota" vincula a uma nota de rodapé para suporte parcial. Um qualificador após ✓ restringe a disponibilidade a esse subconjunto, e "Admin-enabled" significa que o recurso está desativado até que um administrador da organização o ative.11Nas tabelas abaixo, ✓ significa disponível, ✗ significa não disponível, e "Ver nota" vincula a uma nota de rodapé para suporte parcial. Um qualificador após ✓ restringe a disponibilidade a esse subconjunto, e "Admin-enabled" significa que o recurso está desativado até que um administrador da organização o ative.

12 12 


18 18 

19* **Assinatura Claude**: você faz login com uma conta claude.ai no plano Pro, Max, Team ou Enterprise19* **Assinatura Claude**: você faz login com uma conta claude.ai no plano Pro, Max, Team ou Enterprise

20* **Anthropic Console**: você se autentica com uma chave de API Anthropic20* **Anthropic Console**: você se autentica com uma chave de API Anthropic

21* **Amazon Bedrock**: você usa modelos Claude do catálogo de modelos Bedrock e define `CLAUDE_CODE_USE_BEDROCK`. O [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) é coberto por esta coluna21* **Amazon Bedrock**: você usa modelos Claude do catálogo de modelos Bedrock e define `CLAUDE_CODE_USE_BEDROCK`. O [endpoint Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) é coberto por esta coluna

22* **Claude Platform on AWS**: você comprou Claude através do AWS Marketplace, mas chama a API Anthropic, e define `CLAUDE_CODE_USE_ANTHROPIC_AWS`22* **Claude Platform on AWS**: você comprou Claude através do AWS Marketplace, mas chama a API Anthropic, e define `CLAUDE_CODE_USE_ANTHROPIC_AWS`

23* **Google Cloud's Agent Platform**: operado pelo Google; você define `CLAUDE_CODE_USE_VERTEX`23* **Google Cloud's Agent Platform**: operado pelo Google; você define `CLAUDE_CODE_USE_VERTEX`

24* **Microsoft Foundry**: operado pela Anthropic no Azure; você define `CLAUDE_CODE_USE_FOUNDRY`24* **Microsoft Foundry**: operado pela Anthropic no Azure; você define `CLAUDE_CODE_USE_FOUNDRY`


29 29 

30Estes funcionam em todos os provedores:30Estes funcionam em todos os provedores:

31 31 

32* [CLI](/pt/quickstart) e [Agent SDK](/pt/agent-sdk/overview)32* [CLI](/docs/pt/quickstart) e [Agent SDK](/docs/pt/agent-sdk/overview)

33* Extensões [VS Code](/pt/vs-code) e [JetBrains](/pt/jetbrains)33* Extensões [VS Code](/docs/pt/vs-code) e [JetBrains](/docs/pt/jetbrains)

34* [Subagents](/pt/sub-agents), [hooks](/pt/hooks-guide), [commands](/pt/commands) e [skills](/pt/skills)34* [Subagents](/docs/pt/sub-agents), [hooks](/docs/pt/hooks-guide), [commands](/docs/pt/commands) e [skills](/docs/pt/skills)

35* Memória [CLAUDE.md](/pt/memory), [plugins](/pt/plugins) e [servidores MCP](/pt/mcp)35* Memória [CLAUDE.md](/docs/pt/memory), [plugins](/docs/pt/plugins) e [servidores MCP](/docs/pt/mcp)

36* [Checkpoints](/pt/checkpointing), [sandboxing](/pt/sandboxing) e [Workflows](/pt/workflows)36* [Checkpoints](/docs/pt/checkpointing), [sandboxing](/docs/pt/sandboxing) e [Workflows](/docs/pt/workflows)

37* Métricas [OpenTelemetry](/pt/monitoring-usage) e o [arquivo de configurações gerenciado](/pt/settings#settings-files)37* Métricas [OpenTelemetry](/docs/pt/monitoring-usage) e o [arquivo de configurações gerenciado](/docs/pt/settings#settings-files)

38 38 

39Três destes têm diferenças específicas do provedor:39Três destes têm diferenças específicas do provedor:

40 40 

41* **Servidores MCP**: [conectores do claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) carregam apenas quando sua assinatura claude.ai é o método de autenticação ativo, e [busca de ferramentas](/pt/mcp#configure-tool-search) está desativada por padrão no Google Cloud's Agent Platform e quando `ANTHROPIC_BASE_URL` aponta para um host não-first-party41* **Servidores MCP**: [conectores do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) carregam apenas quando sua assinatura claude.ai é o método de autenticação ativo, e [busca de ferramentas](/docs/pt/mcp#configure-tool-search) está desativada por padrão no Google Cloud's Agent Platform e quando `ANTHROPIC_BASE_URL` aponta para um host não-first-party

42* **Subagents**: o [Explore subagent](/pt/sub-agents#built-in-subagents) integrado limita seu modelo herdado a Opus na Claude API, e herda o modelo da conversa principal diretamente em qualquer outro provedor, incluindo Claude Platform on AWS42* **Subagents**: o [Explore subagent](/docs/pt/sub-agents#built-in-subagents) integrado limita seu modelo herdado a Opus na Claude API, e herda o modelo da conversa principal diretamente em qualquer outro provedor, incluindo Claude Platform on AWS

43* **[Commands](/pt/commands#all-commands)**: `/design-sync` e `/radio` não estão disponíveis no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS, e `/voice` requer uma conta claude.ai43* **[Commands](/docs/pt/commands#all-commands)**: `/design-sync` e `/radio` não estão disponíveis no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS, e `/voice` requer uma conta claude.ai

44 44 

45<h3 id="features-that-require-a-claude-subscription">45<h3 id="features-that-require-a-claude-subscription">

46 Recursos que requerem uma assinatura Claude46 Recursos que requerem uma assinatura Claude


48 48 

49Estes requerem login com uma conta claude.ai e não são acessíveis com uma chave de API Anthropic Console ou de um provedor terceirizado:49Estes requerem login com uma conta claude.ai e não são acessíveis com uma chave de API Anthropic Console ou de um provedor terceirizado:

50 50 

51* [Claude Code na web](/pt/claude-code-on-the-web), Claude Code no celular e [Claude Code no Slack](/pt/slack)51* [Claude Code na web](/docs/pt/claude-code-on-the-web), Claude Code no celular e [Claude Code no Slack](/docs/pt/slack)

52* [Claude Code Desktop](/pt/desktop)52* [Claude Code Desktop](/docs/pt/desktop)

53* [Routines](/pt/routines) (`/schedule`)53* [Routines](/docs/pt/routines) (`/schedule`)

54* [Ultraplan](/pt/ultraplan) e [Ultrareview](/pt/ultrareview)54* [Ultraplan](/docs/pt/ultraplan) e [Ultrareview](/docs/pt/ultrareview)

55* [Code Review](/pt/code-review): planos Team e Enterprise55* [Code Review](/docs/pt/code-review): planos Team e Enterprise

56* [Remote Control](/pt/remote-control)56* [Remote Control](/docs/pt/remote-control)

57* [Extensão Chrome](/pt/chrome)57* [Extensão Chrome](/docs/pt/chrome)

58* [Computer use](/pt/computer-use): planos Pro e Max58* [Computer use](/docs/pt/computer-use): planos Pro e Max

59* [Artifacts](/pt/artifacts): planos Pro, Max, Team e Enterprise59* [Artifacts](/docs/pt/artifacts): planos Pro, Max, Team e Enterprise

60* [Voice dictation](/pt/voice-dictation)60* [Voice dictation](/docs/pt/voice-dictation)

61 61 

62Desktop é a exceção parcial: [roteamento de gateway pode ser configurado no aplicativo ou por um administrador](/pt/llm-gateway-connect#desktop-app), implantações Enterprise podem rotear Desktop para Google Cloud's Agent Platform ou um provedor de gateway via [configurações gerenciadas](https://claude.com/docs/third-party/claude-desktop/configuration), e [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) executa a aba Code no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado. Para disponibilidade por plano desses recursos, consulte [Disponibilidade por plano de assinatura](#availability-by-subscription-plan).62Desktop é a exceção parcial: [roteamento de gateway pode ser configurado no aplicativo ou por um administrador](/docs/pt/llm-gateway-connect#desktop-app), implantações Enterprise podem rotear Desktop para Google Cloud's Agent Platform ou um provedor de gateway via [configurações gerenciadas](https://claude.com/docs/third-party/claude-desktop/configuration), e [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) executa a aba Code no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou um gateway LLM auto-hospedado. Para disponibilidade por plano desses recursos, consulte [Disponibilidade por plano de assinatura](#availability-by-subscription-plan).

63 63 

64<h3 id="cli-capabilities-that-vary-by-provider">64<h3 id="cli-capabilities-that-vary-by-provider">

65 Recursos de CLI que variam por provedor65 Recursos de CLI que variam por provedor


82 82 

83 <tbody>83 <tbody>

84 <tr>84 <tr>

85 <td>[Web search](/pt/tools-reference#websearch-tool-behavior)</td>85 <td>[Web search](/docs/pt/tools-reference#websearch-tool-behavior)</td>

86 <td>✓</td>86 <td>✓</td>

87 <td>✓</td>87 <td>✓</td>

88 <td>✗</td>88 <td>✗</td>


92 </tr>92 </tr>

93 93 

94 <tr>94 <tr>

95 <td>[Fast mode](/pt/fast-mode)</td>95 <td>[Fast mode](/docs/pt/fast-mode)</td>

96 <td>✓</td>96 <td>✓</td>

97 <td>✓</td>97 <td>✓</td>

98 <td>✗</td>98 <td>✗</td>


102 </tr>102 </tr>

103 103 

104 <tr>104 <tr>

105 <td>[Auto mode](/pt/auto-mode-config)</td>105 <td>[Auto mode](/docs/pt/auto-mode-config)</td>

106 <td>✓</td>106 <td>✓</td>

107 <td>✓</td>107 <td>✓</td>

108 <td>Ver nota <sup><a href="#fn2">2</a></sup></td>108 <td>Ver nota <sup><a href="#fn2">2</a></sup></td>


112 </tr>112 </tr>

113 113 

114 <tr>114 <tr>

115 <td>[Advisor](/pt/advisor)</td>115 <td>[Advisor](/docs/pt/advisor)</td>

116 <td>✓</td>116 <td>✓</td>

117 <td>✓</td>117 <td>✓</td>

118 <td>✗</td>118 <td>✗</td>


122 </tr>122 </tr>

123 123 

124 <tr>124 <tr>

125 <td>[Channels](/pt/channels)</td>125 <td>[Channels](/docs/pt/channels)</td>

126 <td>✓</td>126 <td>✓</td>

127 <td>✓</td>127 <td>✓</td>

128 <td>✗</td>128 <td>✗</td>


132 </tr>132 </tr>

133 133 

134 <tr>134 <tr>

135 <td>[`/loop` scheduled tasks](/pt/scheduled-tasks)</td>135 <td>[`/loop` scheduled tasks](/docs/pt/scheduled-tasks)</td>

136 <td>✓</td>136 <td>✓</td>

137 <td>✓</td>137 <td>✓</td>

138 <td>Ver nota <sup><a href="#fn3">3</a></sup></td>138 <td>Ver nota <sup><a href="#fn3">3</a></sup></td>


142 </tr>142 </tr>

143 143 

144 <tr>144 <tr>

145 <td>[GitHub Actions](/pt/github-actions) e [GitLab CI/CD](/pt/gitlab-ci-cd)</td>145 <td>[GitHub Actions](/docs/pt/github-actions) e [GitLab CI/CD](/docs/pt/gitlab-ci-cd)</td>

146 <td>✓</td>146 <td>✓</td>

147 <td>✓</td>147 <td>✓</td>

148 <td>✓</td>148 <td>✓</td>


174 174 

175 <tbody>175 <tbody>

176 <tr>176 <tr>

177 <td>[Analytics dashboard e API](/pt/analytics)</td>177 <td>[Analytics dashboard e API](/docs/pt/analytics)</td>

178 <td>✓ (dashboard: Team e Enterprise; API: Enterprise)</td>178 <td>✓ (dashboard: Team e Enterprise; API: Enterprise)</td>

179 <td>✓ <sup><a href="#fn5">5</a></sup></td>179 <td>✓ <sup><a href="#fn5">5</a></sup></td>

180 <td>✗</td>180 <td>✗</td>


184 </tr>184 </tr>

185 185 

186 <tr>186 <tr>

187 <td>[Server-managed settings](/pt/server-managed-settings)</td>187 <td>[Server-managed settings](/docs/pt/server-managed-settings)</td>

188 <td>✓ (Team e Enterprise)</td>188 <td>✓ (Team e Enterprise)</td>

189 <td>✓ (Team e Enterprise)</td>189 <td>✓ (Team e Enterprise)</td>

190 <td>✗</td>190 <td>✗</td>


194 </tr>194 </tr>

195 195 

196 <tr>196 <tr>

197 <td>[Zero Data Retention](/pt/zero-data-retention)</td>197 <td>[Zero Data Retention](/docs/pt/zero-data-retention)</td>

198 <td>✓ (contas Enterprise qualificadas)</td>198 <td>✓ (contas Enterprise qualificadas)</td>

199 <td>✓ (contas qualificadas)</td>199 <td>✓ (contas qualificadas)</td>

200 <td>Ver nota <sup><a href="#fn4">4</a></sup></td>200 <td>Ver nota <sup><a href="#fn4">4</a></sup></td>


206</table>206</table>

207 207 

208<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> No Google Cloud's Agent Platform, web search está disponível para modelos Claude 4 e posteriores.<br />208<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> No Google Cloud's Agent Platform, web search está disponível para modelos Claude 4 e posteriores.<br />

209<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Nesses provedores, auto mode suporta apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8. Consulte [Configuração de Auto mode](/pt/auto-mode-config). {/* min-version: 2.1.207 */}Na v2.1.158 até v2.1.206, auto mode nesses provedores também exigia definir `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 removeu o requisito.<br />209<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Nesses provedores, auto mode suporta apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8. Consulte [Configuração de Auto mode](/docs/pt/auto-mode-config). Na v2.1.158 até v2.1.206, auto mode nesses provedores também exigia definir `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 removeu o requisito.<br />

210<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Intervalos explícitos como `/loop every 2 hours` funcionam em todos os provedores. No Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, `/loop` não pode escolher seu próprio intervalo ou fornecer o prompt de manutenção padrão, portanto um prompt sem intervalo é executado a cada 10 minutos, e `/loop` sem argumentos mostra a mensagem de uso. Consulte [Scheduled tasks](/pt/scheduled-tasks).<br />210<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Intervalos explícitos como `/loop every 2 hours` funcionam em todos os provedores. No Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, `/loop` não pode escolher seu próprio intervalo ou fornecer o prompt de manutenção padrão, portanto um prompt sem intervalo é executado a cada 10 minutos, e `/loop` sem argumentos mostra a mensagem de uso. Consulte [Scheduled tasks](/docs/pt/scheduled-tasks).<br />

211<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Sujeito ao seu acordo com o provedor de nuvem.<br />211<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Sujeito ao seu acordo com o provedor de nuvem.<br />

212<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Dashboard e API apenas. [Contribution metrics](/pt/analytics#enable-contribution-metrics) requer uma organização Claude.ai Team ou Enterprise.212<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Dashboard e API apenas. [Contribution metrics](/docs/pt/analytics#enable-contribution-metrics) requer uma organização Claude.ai Team ou Enterprise.

213 213 

214<Note>214<Note>

215 Se você se autenticar através de um [LLM gateway](/pt/llm-gateway), a disponibilidade de recursos corresponde ao provedor subjacente para o qual o gateway encaminha. Alguns recursos exclusivos da Anthropic, como o [Advisor](/pt/advisor), funcionam apenas se o gateway encaminha solicitações intactas para a API Anthropic.215 Se você se autenticar através de um [LLM gateway](/docs/pt/llm-gateway), a disponibilidade de recursos corresponde ao provedor subjacente para o qual o gateway encaminha. Alguns recursos exclusivos da Anthropic, como o [Advisor](/docs/pt/advisor), funcionam apenas se o gateway encaminha solicitações intactas para a API Anthropic.

216</Note>216</Note>

217 217 

218<h3 id="summary-by-provider">218<h3 id="summary-by-provider">

219 Resumo por provedor219 Resumo por provedor

220</h3>220</h3>

221 221 

222Cada aba lista o que não está disponível ou tem suporte parcial nesse provedor, com alternativas onde uma existe. Tudo não listado funciona da mesma forma que em uma assinatura Claude, além das [diferenças específicas do provedor](#features-available-on-every-provider) observadas acima. No Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS, relatório de erros e telemetria para Anthropic estão desativados por padrão. Consulte [comportamentos padrão por provedor de API](/pt/data-usage#default-behaviors-by-api-provider) para saber qual tráfego ainda chega à Anthropic e como desativar.222Cada aba lista o que não está disponível ou tem suporte parcial nesse provedor, com alternativas onde uma existe. Tudo não listado funciona da mesma forma que em uma assinatura Claude, além das [diferenças específicas do provedor](#features-available-on-every-provider) observadas acima. No Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS, relatório de erros e telemetria para Anthropic estão desativados por padrão. Consulte [comportamentos padrão por provedor de API](/docs/pt/data-usage#default-behaviors-by-api-provider) para saber qual tráfego ainda chega à Anthropic e como desativar.

223 223 

224<Tabs>224<Tabs>

225 <Tab title="Amazon Bedrock">225 <Tab title="Amazon Bedrock">

226 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [web search](/pt/tools-reference#websearch-tool-behavior), [fast mode](/pt/fast-mode), [Advisor](/pt/advisor), [Channels](/pt/channels), o [analytics dashboard](/pt/analytics), [server-managed settings](/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/pt/commands#all-commands).226 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [web search](/docs/pt/tools-reference#websearch-tool-behavior), [fast mode](/docs/pt/fast-mode), [Advisor](/docs/pt/advisor), [Channels](/docs/pt/channels), o [analytics dashboard](/docs/pt/analytics), [server-managed settings](/docs/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/docs/pt/commands#all-commands).

227 227 

228 **Suporte parcial:**228 **Suporte parcial:**

229 229 

230 * [Desktop](/pt/desktop): apenas via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)230 * [Desktop](/docs/pt/desktop): apenas via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

231 * [Auto mode](/pt/auto-mode-config): Sonnet 5, Opus 4.7 e Opus 4.8 apenas231 * [Auto mode](/docs/pt/auto-mode-config): Sonnet 5, Opus 4.7 e Opus 4.8 apenas

232 * [`/loop`](/pt/scheduled-tasks): apenas intervalos explícitos232 * [`/loop`](/docs/pt/scheduled-tasks): apenas intervalos explícitos

233 * [Zero Data Retention](/pt/zero-data-retention): sujeito ao seu acordo AWS233 * [Zero Data Retention](/docs/pt/zero-data-retention): sujeito ao seu acordo AWS

234 234 

235 **Alternativas:** para agendamento, use [`/loop`](/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`. Para sessões em nuvem, use [GitHub Actions](/pt/github-actions) ou [GitLab CI/CD](/pt/gitlab-ci-cd). Para pesquisas na web, use a [ferramenta WebFetch](/pt/tools-reference#webfetch-tool-behavior) com uma URL específica.235 **Alternativas:** para agendamento, use [`/loop`](/docs/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`. Para sessões em nuvem, use [GitHub Actions](/docs/pt/github-actions) ou [GitLab CI/CD](/docs/pt/gitlab-ci-cd). Para pesquisas na web, use a [ferramenta WebFetch](/docs/pt/tools-reference#webfetch-tool-behavior) com uma URL específica.

236 </Tab>236 </Tab>

237 237 

238 <Tab title="Claude Platform on AWS">238 <Tab title="Claude Platform on AWS">

239 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](/pt/fast-mode), [Advisor](/pt/advisor), [Channels](/pt/channels), o [analytics dashboard](/pt/analytics), [server-managed settings](/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/pt/commands#all-commands).239 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](/docs/pt/fast-mode), [Advisor](/docs/pt/advisor), [Channels](/docs/pt/channels), o [analytics dashboard](/docs/pt/analytics), [server-managed settings](/docs/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/docs/pt/commands#all-commands).

240 240 

241 **Disponível onde Amazon Bedrock não é:** [web search](/pt/tools-reference#websearch-tool-behavior).241 **Disponível onde Amazon Bedrock não é:** [web search](/docs/pt/tools-reference#websearch-tool-behavior).

242 242 

243 **Suporte parcial:**243 **Suporte parcial:**

244 244 

245 * [`/loop`](/pt/scheduled-tasks): apenas intervalos explícitos245 * [`/loop`](/docs/pt/scheduled-tasks): apenas intervalos explícitos

246 246 

247 **Alternativas:** para agendamento, use [`/loop`](/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`. Para sessões em nuvem, use [GitHub Actions](/pt/github-actions) ou [GitLab CI/CD](/pt/gitlab-ci-cd).247 **Alternativas:** para agendamento, use [`/loop`](/docs/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`. Para sessões em nuvem, use [GitHub Actions](/docs/pt/github-actions) ou [GitLab CI/CD](/docs/pt/gitlab-ci-cd).

248 </Tab>248 </Tab>

249 249 

250 <Tab title="Google Cloud's Agent Platform">250 <Tab title="Google Cloud's Agent Platform">

251 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](/pt/fast-mode), [Advisor](/pt/advisor), [Channels](/pt/channels), o [analytics dashboard](/pt/analytics), [server-managed settings](/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/pt/commands#all-commands).251 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](/docs/pt/fast-mode), [Advisor](/docs/pt/advisor), [Channels](/docs/pt/channels), o [analytics dashboard](/docs/pt/analytics), [server-managed settings](/docs/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/docs/pt/commands#all-commands).

252 252 

253 **Suporte parcial:**253 **Suporte parcial:**

254 254 

255 * [Desktop](/pt/desktop): via [configurações gerenciadas](https://claude.com/docs/third-party/claude-desktop/configuration) ou [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)255 * [Desktop](/docs/pt/desktop): via [configurações gerenciadas](https://claude.com/docs/third-party/claude-desktop/configuration) ou [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

256 * [Web search](/pt/tools-reference#websearch-tool-behavior): modelos Claude 4 e posteriores256 * [Web search](/docs/pt/tools-reference#websearch-tool-behavior): modelos Claude 4 e posteriores

257 * [Auto mode](/pt/auto-mode-config): Sonnet 5, Opus 4.7 e Opus 4.8 apenas257 * [Auto mode](/docs/pt/auto-mode-config): Sonnet 5, Opus 4.7 e Opus 4.8 apenas

258 * [`/loop`](/pt/scheduled-tasks): apenas intervalos explícitos258 * [`/loop`](/docs/pt/scheduled-tasks): apenas intervalos explícitos

259 * [Zero Data Retention](/pt/zero-data-retention): sujeito ao seu acordo Google Cloud259 * [Zero Data Retention](/docs/pt/zero-data-retention): sujeito ao seu acordo Google Cloud

260 260 

261 **Alternativas:** para agendamento, use [`/loop`](/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`. Para sessões em nuvem, use [GitHub Actions](/pt/github-actions) ou [GitLab CI/CD](/pt/gitlab-ci-cd).261 **Alternativas:** para agendamento, use [`/loop`](/docs/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`. Para sessões em nuvem, use [GitHub Actions](/docs/pt/github-actions) ou [GitLab CI/CD](/docs/pt/gitlab-ci-cd).

262 </Tab>262 </Tab>

263 263 

264 <Tab title="Microsoft Foundry">264 <Tab title="Microsoft Foundry">

265 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](/pt/fast-mode), [Advisor](/pt/advisor), [Channels](/pt/channels), [GitHub Actions](/pt/github-actions) e [GitLab CI/CD](/pt/gitlab-ci-cd), o [analytics dashboard](/pt/analytics), [server-managed settings](/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/pt/commands#all-commands).265 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription), além de [fast mode](/docs/pt/fast-mode), [Advisor](/docs/pt/advisor), [Channels](/docs/pt/channels), [GitHub Actions](/docs/pt/github-actions) e [GitLab CI/CD](/docs/pt/gitlab-ci-cd), o [analytics dashboard](/docs/pt/analytics), [server-managed settings](/docs/pt/server-managed-settings) e os [comandos `/design-sync` e `/radio`](/docs/pt/commands#all-commands).

266 266 

267 **Suporte parcial:**267 **Suporte parcial:**

268 268 

269 * [Desktop](/pt/desktop): apenas via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)269 * [Desktop](/docs/pt/desktop): apenas via [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

270 * [Auto mode](/pt/auto-mode-config): Sonnet 5, Opus 4.7 e Opus 4.8 apenas270 * [Auto mode](/docs/pt/auto-mode-config): Sonnet 5, Opus 4.7 e Opus 4.8 apenas

271 * [`/loop`](/pt/scheduled-tasks): apenas intervalos explícitos271 * [`/loop`](/docs/pt/scheduled-tasks): apenas intervalos explícitos

272 * [Zero Data Retention](/pt/zero-data-retention): sujeito ao seu acordo Azure272 * [Zero Data Retention](/docs/pt/zero-data-retention): sujeito ao seu acordo Azure

273 273 

274 **Alternativas:** para agendamento, use [`/loop`](/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`.274 **Alternativas:** para agendamento, use [`/loop`](/docs/pt/scheduled-tasks) com um intervalo explícito em vez de `/schedule`.

275 </Tab>275 </Tab>

276 276 

277 <Tab title="Anthropic Console">277 <Tab title="Anthropic Console">

278 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription).278 **Não disponível:** todos os [recursos que requerem uma assinatura Claude](#features-that-require-a-claude-subscription).

279 279 

280 Tudo em [Recursos de CLI que variam por provedor](#cli-capabilities-that-vary-by-provider) está disponível, assim como [server-managed settings](/pt/server-managed-settings) quando a chave de API pertence a uma organização Team ou Enterprise.280 Tudo em [Recursos de CLI que variam por provedor](#cli-capabilities-that-vary-by-provider) está disponível, assim como [server-managed settings](/docs/pt/server-managed-settings) quando a chave de API pertence a uma organização Team ou Enterprise.

281 </Tab>281 </Tab>

282</Tabs>282</Tabs>

283 283 


289 289 

290| Recurso | Pro | Max | Team | Enterprise |290| Recurso | Pro | Max | Team | Enterprise |

291| :-------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |291| :-------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |

292| [Claude Code na web](/pt/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |292| [Claude Code na web](/docs/pt/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

293| [Routines](/pt/routines) | ✓ | ✓ | ✓ | ✓ |293| [Routines](/docs/pt/routines) | ✓ | ✓ | ✓ | ✓ |

294| [Remote Control](/pt/remote-control) | ✓ | ✓ | Admin-enabled | Admin-enabled |294| [Remote Control](/docs/pt/remote-control) | ✓ | ✓ | Admin-enabled | Admin-enabled |

295| [Channels](/pt/channels) | ✓ | ✓ | Admin-enabled | Admin-enabled |295| [Channels](/docs/pt/channels) | ✓ | ✓ | Admin-enabled | Admin-enabled |

296| [Computer use](/pt/computer-use) | ✓ | ✓ | ✗ | ✗ |296| [Computer use](/docs/pt/computer-use) | ✓ | ✓ | ✗ | ✗ |

297| Dispatch ([Desktop](/pt/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |297| Dispatch ([Desktop](/docs/pt/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

298| [Code Review](/pt/code-review) | ✗ | ✗ | ✓ | ✓ |298| [Code Review](/docs/pt/code-review) | ✗ | ✗ | ✓ | ✓ |

299| [Artifacts](/pt/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |299| [Artifacts](/docs/pt/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |

300| [Dashboard de análises e métricas de contribuição](/pt/analytics) | ✗ | ✗ | ✓ | ✓ |300| [Dashboard de análises e métricas de contribuição](/docs/pt/analytics) | ✗ | ✗ | ✓ | ✓ |

301| [API Enterprise Analytics](/pt/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |301| [API Enterprise Analytics](/docs/pt/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

302| [Server-managed settings](/pt/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |302| [Server-managed settings](/docs/pt/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

303| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |303| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

304| SCIM | ✗ | ✗ | ✗ | ✓ |304| SCIM | ✗ | ✗ | ✗ | ✓ |

305| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |305| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |

306| [Zero Data Retention](/pt/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |306| [Zero Data Retention](/docs/pt/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |

307 307 

308<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> No Enterprise, requer um assento premium ou um assento Chat + Claude Code. Consulte [Claude Code na web](/pt/claude-code-on-the-web).<br />308<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> No Enterprise, requer um assento premium ou um assento Chat + Claude Code. Consulte [Claude Code na web](/docs/pt/claude-code-on-the-web).<br />

309<span id="fn7" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>7</sup> Não incluído no plano Enterprise padrão. Requer habilitação separada pela Anthropic para contas qualificadas. Consulte [Zero Data Retention](/pt/zero-data-retention).309<span id="fn7" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>7</sup> Não incluído no plano Enterprise padrão. Requer habilitação separada pela Anthropic para contas qualificadas. Consulte [Zero Data Retention](/docs/pt/zero-data-retention).

310 310 

311Para preços e a comparação completa de planos, consulte [Planos Team](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) e [Planos Enterprise](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).311Para preços e a comparação completa de planos, consulte [Planos Team](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) e [Planos Enterprise](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).

312 312 


314 Disponibilidade de modelo314 Disponibilidade de modelo

315</h2>315</h2>

316 316 

317Para saber quais modelos Claude e tamanhos de janela de contexto estão disponíveis por provedor e região, consulte [Configuração de modelo](/pt/model-config) e a [visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, entrada de PDF e pensamento estendido são capacidades de modelo em vez de recursos do Claude Code e funcionam em todos os provedores que oferecem o modelo. [Prompt caching](/pt/prompt-caching) funciona da mesma forma na maioria dos provedores; no Amazon Bedrock, o suporte varia por modelo.317Para saber quais modelos Claude e tamanhos de janela de contexto estão disponíveis por provedor e região, consulte [Configuração de modelo](/docs/pt/model-config) e a [visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, entrada de PDF e pensamento estendido são capacidades de modelo em vez de recursos do Claude Code e funcionam em todos os provedores que oferecem o modelo. [Prompt caching](/docs/pt/prompt-caching) funciona da mesma forma na maioria dos provedores; no Amazon Bedrock, o suporte varia por modelo.

318 318 

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

320 Recursos relacionados320 Recursos relacionados

321</h2>321</h2>

322 322 

323* [Visão geral de implantação empresarial](/pt/third-party-integrations): compare autenticação, faturamento e regiões entre provedores323* [Visão geral de implantação empresarial](/docs/pt/third-party-integrations): compare autenticação, faturamento e regiões entre provedores

324* Guias de configuração do provedor: [Amazon Bedrock](/pt/amazon-bedrock), [Claude Platform on AWS](/pt/claude-platform-on-aws), [Google Cloud's Agent Platform](/pt/google-vertex-ai), [Microsoft Foundry](/pt/microsoft-foundry)324* Guias de configuração do provedor: [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry)

325* [Plataformas e integrações](/pt/platforms): onde o Claude Code é executado, incluindo CLI, Desktop, extensões IDE, web, celular e CI/CD325* [Plataformas e integrações](/docs/pt/platforms): onde o Claude Code é executado, incluindo CLI, Desktop, extensões IDE, web, celular e CI/CD

fullscreen.md +10 −10

Details

22 Ativar renderização em tela cheia22 Ativar renderização em tela cheia

23</h2>23</h2>

24 24 

25Execute `/tui fullscreen` dentro de qualquer conversa do Claude Code. O CLI salva a configuração [`tui`](/pt/settings#available-settings) e reinicia em tela cheia com sua conversa intacta, para que você possa alternar no meio da sessão sem perder contexto. Execute `/tui default` para voltar ao renderizador clássico, ou `/tui` sem argumentos para imprimir qual renderizador está ativo.25Execute `/tui fullscreen` dentro de qualquer conversa do Claude Code. O CLI salva a configuração [`tui`](/docs/pt/settings#available-settings) e reinicia em tela cheia com sua conversa intacta, para que você possa alternar no meio da sessão sem perder contexto. Execute `/tui default` para voltar ao renderizador clássico, ou `/tui` sem argumentos para imprimir qual renderizador está ativo.

26 26 

27A sessão reiniciada mantém a conversa como aparece na tela. Se você executou [`/rewind`](/pt/checkpointing#rewind-and-summarize) anteriormente na sessão, a reinicialização retoma do ponto revertido em vez do transcript mais longo salvo no disco. Antes da v2.1.207, alternar renderizadores após um rewind restaurava a conversa que o rewind havia removido.27A sessão reiniciada mantém a conversa como aparece na tela. Se você executou [`/rewind`](/docs/pt/checkpointing#rewind-and-summarize) anteriormente na sessão, a reinicialização retoma do ponto revertido em vez do transcript mais longo salvo no disco. Antes da v2.1.207, alternar renderizadores após um rewind restaurava a conversa que o rewind havia removido.

28 28 

29Você também pode definir a variável de ambiente `CLAUDE_CODE_NO_FLICKER` antes de iniciar Claude Code:29Você também pode definir a variável de ambiente `CLAUDE_CODE_NO_FLICKER` antes de iniciar Claude Code:

30 30 


90* Role para o final com a roda do mouse para retomar o seguimento.90* Role para o final com a roda do mouse para retomar o seguimento.

91* Rebinde `scroll:bottom` para um atalho que seu teclado possa enviar.91* Rebinde `scroll:bottom` para um atalho que seu teclado possa enviar.

92 92 

93Essas ações são rebindáveis. Veja [Ações de rolagem](/pt/keybindings#scroll-actions) para a lista completa de nomes de ações, incluindo variantes de meia página e página completa que não têm vinculação padrão.93Essas ações são rebindáveis. Veja [Ações de rolagem](/docs/pt/keybindings#scroll-actions) para a lista completa de nomes de ações, incluindo variantes de meia página e página completa que não têm vinculação padrão.

94 94 

95<h3 id="auto-follow">95<h3 id="auto-follow">

96 Auto-follow96 Auto-follow


100 100 

101Enquanto o auto-follow está pausado, a visualização também permanece onde você a rolou quando uma resposta termina de transmitir. Antes da v2.1.207, a visualização poderia pular acima do início da resposta quando uma resposta longa terminava de transmitir.101Enquanto o auto-follow está pausado, a visualização também permanece onde você a rolou quando uma resposta termina de transmitir. Antes da v2.1.207, a visualização poderia pular acima do início da resposta quando uma resposta longa terminava de transmitir.

102 102 

103A dica de teclado do botão reflete o que seu teclado pode enviar. No macOS, ele sugere clicar ou `Fn+↓` para rolar, porque `Ctrl+End` não alcança Claude Code de um teclado Mac. Rebinde [`scroll:bottom`](/pt/keybindings#scroll-actions) e o botão mostra seu atalho em todas as plataformas. Antes da v2.1.206, o botão sugeria `Ctrl+End` no macOS.103A dica de teclado do botão reflete o que seu teclado pode enviar. No macOS, ele sugere clicar ou `Fn+↓` para rolar, porque `Ctrl+End` não alcança Claude Code de um teclado Mac. Rebinde [`scroll:bottom`](/docs/pt/keybindings#scroll-actions) e o botão mostra seu atalho em todas as plataformas. Antes da v2.1.206, o botão sugeria `Ctrl+End` no macOS.

104 104 

105Em um terminal muito estreito para o rótulo completo, o botão encurta a dica em vez de quebrar para a linha de transcrição abaixo. Antes da v2.1.206, um rótulo longo poderia quebrar sobre a transcrição.105Em um terminal muito estreito para o rótulo completo, o botão encurta a dica em vez de quebrar para a linha de transcrição abaixo. Antes da v2.1.206, um rótulo longo poderia quebrar sobre a transcrição.

106 106 


126 126 

127O comando escreve o mesmo valor que a variável de ambiente `CLAUDE_CODE_SCROLL_SPEED` define, persistido em `~/.claude/settings.json`. O comando não está disponível no terminal do IDE JetBrains.127O comando escreve o mesmo valor que a variável de ambiente `CLAUDE_CODE_SCROLL_SPEED` define, persistido em `~/.claude/settings.json`. O comando não está disponível no terminal do IDE JetBrains.

128 128 

129Separadamente da velocidade base, Claude Code acelera a taxa de rolagem quando você gira a roda rapidamente, portanto uma rotação rápida cobre mais distância do que o mesmo número de entalhes lentos. {/* min-version: 2.1.174 */}Para desativar a aceleração e manter uma taxa constante por entalhe, defina `wheelScrollAccelerationEnabled` como `false` em [`settings.json`](/pt/settings#available-settings). Esta configuração requer Claude Code v2.1.174 ou posterior.129Separadamente da velocidade base, Claude Code acelera a taxa de rolagem quando você gira a roda rapidamente, portanto uma rotação rápida cobre mais distância do que o mesmo número de entalhes lentos. Para desativar a aceleração e manter uma taxa constante por entalhe, defina `wheelScrollAccelerationEnabled` como `false` em [`settings.json`](/docs/pt/settings#available-settings). Esta configuração requer Claude Code v2.1.174 ou posterior.

130 130 

131<h3 id="scroll-in-the-jetbrains-ide-terminal">131<h3 id="scroll-in-the-jetbrains-ide-terminal">

132 Rolagem no terminal do IDE JetBrains132 Rolagem no terminal do IDE JetBrains


187 187 

188Nem toda versão do tmux aplica saída sincronizada de aplicações, portanto você pode ver mais cintilação durante redesenhos sob tmux do que ao executar Claude Code diretamente em seu terminal. Se a cintilação for perceptível, especialmente via SSH, atualize para o tmux mais recente ou execute Claude Code em sua própria aba de terminal fora do tmux. Verifique sua versão do tmux com `tmux -V`.188Nem toda versão do tmux aplica saída sincronizada de aplicações, portanto você pode ver mais cintilação durante redesenhos sob tmux do que ao executar Claude Code diretamente em seu terminal. Se a cintilação for perceptível, especialmente via SSH, atualize para o tmux mais recente ou execute Claude Code em sua própria aba de terminal fora do tmux. Verifique sua versão do tmux com `tmux -V`.

189 189 

190{/* min-version: 2.1.200 */}Claude Code ativa a saída sincronizada automaticamente quando detecta tmux 3.4 ou posterior a partir da variável `TERM_PROGRAM_VERSION`, e volta a consultar o terminal diretamente para suporte de saída sincronizada quando a versão não pode ser determinada. Se os redesenhos realmente se tornam atômicos depende de sua versão do tmux honrar a saída sincronizada; se você ainda vir cintilação sob tmux 3.4 ou posterior, atualize para o tmux mais recente. Esta detecção requer Claude Code v2.1.200 ou posterior.190Claude Code ativa a saída sincronizada automaticamente quando detecta tmux 3.4 ou posterior a partir da variável `TERM_PROGRAM_VERSION`, e volta a consultar o terminal diretamente para suporte de saída sincronizada quando a versão não pode ser determinada. Se os redesenhos realmente se tornam atômicos depende de sua versão do tmux honrar a saída sincronizada; se você ainda vir cintilação sob tmux 3.4 ou posterior, atualize para o tmux mais recente. Esta detecção requer Claude Code v2.1.200 ou posterior.

191 191 

192<h2 id="keep-native-text-selection">192<h2 id="keep-native-text-selection">

193 Manter seleção de texto nativa193 Manter seleção de texto nativa


203 203 

204Dentro do tmux, também escreve no buffer de colagem do tmux. Sobre SSH, volta para sequências de escape OSC 52. Claude Code imprime um toast após cada cópia informando qual caminho foi usado.204Dentro do tmux, também escreve no buffer de colagem do tmux. Sobre SSH, volta para sequências de escape OSC 52. Claude Code imprime um toast após cada cópia informando qual caminho foi usado.

205 205 

206Alguns terminais bloqueiam OSC 52 por padrão. O iTerm2 bloqueia até que você ative Configurações → Geral → Seleção → Aplicativos no terminal podem acessar a área de transferência; executar [`/terminal-setup`](/pt/terminal-config) no iTerm2 ativa isso para você.206Alguns terminais bloqueiam OSC 52 por padrão. O iTerm2 bloqueia até que você ative Configurações → Geral → Seleção → Aplicativos no terminal podem acessar a área de transferência; executar [`/terminal-setup`](/docs/pt/terminal-config) no iTerm2 ativa isso para você.

207 207 

208Para uma seleção nativa única, a tecla a usar depende do seu terminal:208Para uma seleção nativa única, a tecla a usar depende do seu terminal:

209 209 


238 238 

239A renderização em tela cheia envia apenas as células que mudaram entre quadros. Alguns terminais, mais comumente Windows Terminal e outros hosts baseados em ConPTY, coalescem essas escritas posicionadas incorretamente e deixam fragmentos de saída anterior na tela até que você redimensione a janela.239A renderização em tela cheia envia apenas as células que mudaram entre quadros. Alguns terminais, mais comumente Windows Terminal e outros hosts baseados em ConPTY, coalescem essas escritas posicionadas incorretamente e deixam fragmentos de saída anterior na tela até que você redimensione a janela.

240 240 

241Defina [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/pt/env-vars) para repintar cada célula em cada quadro em vez de enviar atualizações incrementais.241Defina [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/docs/pt/env-vars) para repintar cada célula em cada quadro em vez de enviar atualizações incrementais.

242 242 

243No Windows PowerShell:243No Windows PowerShell:

244 244 


253CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude253CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

254```254```

255 255 

256No Windows, Claude Code já ativa o repaint completo automaticamente para sessões em segundo plano e [visualização de agente](/pt/agent-view), portanto você só precisa definir a variável para uma sessão interativa em tela cheia que você iniciou diretamente.256No Windows, Claude Code já ativa o repaint completo automaticamente para sessões em segundo plano e [visualização de agente](/docs/pt/agent-view), portanto você só precisa definir a variável para uma sessão interativa em tela cheia que você iniciou diretamente.

257 257 

258<h2 id="research-preview">258<h2 id="research-preview">

259 Visualização de pesquisa259 Visualização de pesquisa


265 265 

266Para desativar a renderização em tela cheia, execute `/tui default`, ou desdefina `CLAUDE_CODE_NO_FLICKER` se você a ativou dessa forma. Para forçar o renderizador clássico independentemente da configuração `tui` salva, defina `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`. O renderizador clássico mantém a conversa no scrollback nativo do seu terminal, portanto `Cmd+f` e o modo de cópia do tmux funcionam como de costume.266Para desativar a renderização em tela cheia, execute `/tui default`, ou desdefina `CLAUDE_CODE_NO_FLICKER` se você a ativou dessa forma. Para forçar o renderizador clássico independentemente da configuração `tui` salva, defina `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`. O renderizador clássico mantém a conversa no scrollback nativo do seu terminal, portanto `Cmd+f` e o modo de cópia do tmux funcionam como de costume.

267 267 

268As sessões em segundo plano abertas a partir da [visualização de agente](/pt/agent-view) ou `claude attach` sempre usam renderização em tela cheia. O terminal anexado entra no buffer de tela alternativa para mostrar a sessão, e o renderizador clássico não tem scrollback ou manipulação de mouse lá, portanto a configuração `tui` e `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` não se aplicam a elas.268As sessões em segundo plano abertas a partir da [visualização de agente](/docs/pt/agent-view) ou `claude attach` sempre usam renderização em tela cheia. O terminal anexado entra no buffer de tela alternativa para mostrar a sessão, e o renderizador clássico não tem scrollback ou manipulação de mouse lá, portanto a configuração `tui` e `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` não se aplicam a elas.

Details

108 </Step>108 </Step>

109 109 

110 <Step title="Siga os prompts do assistente">110 <Step title="Siga os prompts do assistente">

111 Escolha como você se autentica no Google Cloud: Application Default Credentials do `gcloud`, um arquivo de chave de conta de serviço, ou credenciais já em seu ambiente. O assistente detecta seu projeto e região, verifica quais modelos Claude seu projeto pode invocar, e permite que você os fixe. Ele salva o resultado no bloco `env` do seu [arquivo de configurações do usuário](/pt/settings), para que você não precise exportar variáveis de ambiente você mesmo.111 Escolha como você se autentica no Google Cloud: Application Default Credentials do `gcloud`, um arquivo de chave de conta de serviço, ou credenciais já em seu ambiente. O assistente detecta seu projeto e região, verifica quais modelos Claude seu projeto pode invocar, e permite que você os fixe. Ele salva o resultado no bloco `env` do seu [arquivo de configurações do usuário](/docs/pt/settings), para que você não precise exportar variáveis de ambiente você mesmo.

112 </Step>112 </Step>

113</Steps>113</Steps>

114 114 

115Depois de entrar, execute `/setup-vertex` a qualquer momento para reabrir o assistente e alterar suas credenciais, projeto, região ou fixações de modelo. A etapa de fixação de modelo começa a partir de seus modelos atualmente fixados. O assistente escreve em `~/.claude/settings.json`, ou em `$CLAUDE_CONFIG_DIR/settings.json` quando [`CLAUDE_CONFIG_DIR`](/pt/env-vars#variables) está definido.115Depois de entrar, execute `/setup-vertex` a qualquer momento para reabrir o assistente e alterar suas credenciais, projeto, região ou fixações de modelo. A etapa de fixação de modelo começa a partir de seus modelos atualmente fixados. O assistente escreve em `~/.claude/settings.json`, ou em `$CLAUDE_CONFIG_DIR/settings.json` quando [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars#variables) está definido.

116 116 

117<h2 id="region-configuration">117<h2 id="region-configuration">

118 Configuração de região118 Configuração de região


212export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1212export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

213```213```

214 214 

215A maioria das versões de modelo tem uma variável `VERTEX_REGION_CLAUDE_*` correspondente. Veja a [referência de variáveis de ambiente](/pt/env-vars) para a lista completa. Verifique o [Jardim de Modelos da Plataforma de Agentes do Google Cloud](https://console.cloud.google.com/vertex-ai/model-garden) para determinar quais modelos suportam endpoints globais versus apenas regionais.215A maioria das versões de modelo tem uma variável `VERTEX_REGION_CLAUDE_*` correspondente. Veja a [referência de variáveis de ambiente](/docs/pt/env-vars) para a lista completa. Verifique o [Jardim de Modelos da Plataforma de Agentes do Google Cloud](https://console.cloud.google.com/vertex-ai/model-garden) para determinar quais modelos suportam endpoints globais versus apenas regionais.

216 216 

217[Prompt caching](/pt/prompt-caching) é ativado automaticamente. Para desativá-lo, defina `DISABLE_PROMPT_CACHING=1`. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina `ENABLE_PROMPT_CACHING_1H=1`; gravações de cache com TTL de 1 hora são cobradas a uma taxa mais alta. Para limites de taxa aumentados, entre em contato com o suporte do Google Cloud. Ao usar a Plataforma de Agentes do Google Cloud, o comando `/logout` não está disponível, pois a autenticação é tratada através das credenciais do Google Cloud.217[Prompt caching](/docs/pt/prompt-caching) é ativado automaticamente. Para desativá-lo, defina `DISABLE_PROMPT_CACHING=1`. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina `ENABLE_PROMPT_CACHING_1H=1`; gravações de cache com TTL de 1 hora são cobradas a uma taxa mais alta. Para limites de taxa aumentados, entre em contato com o suporte do Google Cloud. Ao usar a Plataforma de Agentes do Google Cloud, o comando `/logout` não está disponível, pois a autenticação é tratada através das credenciais do Google Cloud.

218 218 

219Claude Code desativa [MCP tool search](/pt/mcp#scale-with-mcp-tool-search) por padrão na Plataforma de Agentes do Google Cloud, portanto as definições de ferramenta MCP são carregadas antecipadamente. A Plataforma de Agentes do Google Cloud suporta busca de ferramentas para Claude Sonnet 4.5 e posterior e Claude Opus 4.5 e posterior. Defina `ENABLE_TOOL_SEARCH=true` para ativá-lo nesses modelos. Modelos anteriores na Plataforma de Agentes do Google Cloud não aceitam o cabeçalho beta necessário, e as solicitações falham se você ativar a busca de ferramentas com eles.219Claude Code desativa [MCP tool search](/docs/pt/mcp#scale-with-mcp-tool-search) por padrão na Plataforma de Agentes do Google Cloud, portanto as definições de ferramenta MCP são carregadas antecipadamente. A Plataforma de Agentes do Google Cloud suporta busca de ferramentas para Claude Sonnet 4.5 e posterior e Claude Opus 4.5 e posterior. Defina `ENABLE_TOOL_SEARCH=true` para ativá-lo nesses modelos. Modelos anteriores na Plataforma de Agentes do Google Cloud não aceitam o cabeçalho beta necessário, e as solicitações falham se você ativar a busca de ferramentas com eles.

220 220 

221<h3 id="5-pin-model-versions">221<h3 id="5-pin-model-versions">

222 5. Fixar versões de modelo222 5. Fixar versões de modelo


236export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'236export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

237```237```

238 238 

239Para IDs de modelo atuais e legados, veja [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Veja [Configuração de modelo](/pt/model-config#pin-models-for-third-party-deployments) para a lista completa de variáveis de ambiente.239Para IDs de modelo atuais e legados, veja [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Veja [Configuração de modelo](/docs/pt/model-config#pin-models-for-third-party-deployments) para a lista completa de variáveis de ambiente.

240 240 

241Claude Code usa estes modelos padrão quando nenhuma variável de fixação está definida:241Claude Code usa estes modelos padrão quando nenhuma variável de fixação está definida:

242 242 


254 Modelos Opus têm um preço por token mais alto do que modelos Sonnet, portanto uma implantação que não fixa um modelo primário é cobrada à taxa Opus uma vez que atualiza para v2.1.207 ou posterior. Para manter Sonnet 4.5 como o modelo primário, defina `ANTHROPIC_MODEL` para seu ID de modelo completo. Uma implantação que direciona o padrão com `ANTHROPIC_DEFAULT_SONNET_MODEL` e não define `ANTHROPIC_DEFAULT_OPUS_MODEL` mantém seu modelo Sonnet direcionado como o padrão.254 Modelos Opus têm um preço por token mais alto do que modelos Sonnet, portanto uma implantação que não fixa um modelo primário é cobrada à taxa Opus uma vez que atualiza para v2.1.207 ou posterior. Para manter Sonnet 4.5 como o modelo primário, defina `ANTHROPIC_MODEL` para seu ID de modelo completo. Uma implantação que direciona o padrão com `ANTHROPIC_DEFAULT_SONNET_MODEL` e não define `ANTHROPIC_DEFAULT_OPUS_MODEL` mantém seu modelo Sonnet direcionado como o padrão.

255</Warning>255</Warning>

256 256 

257{/* min-version: 2.1.207 */}Antes de v2.1.207, o modelo primário na Plataforma de Agentes do Google Cloud era padrão para Sonnet 4.5, o alias `opus` resolvia para Opus 4.6, e tarefas em segundo plano sempre usavam o modelo primário.257Antes de v2.1.207, o modelo primário na Plataforma de Agentes do Google Cloud era padrão para Sonnet 4.5, o alias `opus` resolvia para Opus 4.6, e tarefas em segundo plano sempre usavam o modelo primário.

258 258 

259Para personalizar modelos ainda mais:259Para personalizar modelos ainda mais:

260 260 


269 269 

270Quando Claude Code inicia com a Plataforma de Agentes do Google Cloud configurada, ele verifica que os modelos que pretende usar estão acessíveis no seu projeto.270Quando Claude Code inicia com a Plataforma de Agentes do Google Cloud configurada, ele verifica que os modelos que pretende usar estão acessíveis no seu projeto.

271 271 

272Se você fixou uma versão de modelo que é mais antiga que o padrão atual do Claude Code, e seu projeto pode invocar a versão mais recente, Claude Code o solicita a atualizar a fixação. Aceitar escreve o novo ID de modelo no seu [arquivo de configurações do usuário](/pt/settings) e reinicia Claude Code. Recusar é lembrado até a próxima mudança de versão padrão.272Se você fixou uma versão de modelo que é mais antiga que o padrão atual do Claude Code, e seu projeto pode invocar a versão mais recente, Claude Code o solicita a atualizar a fixação. Aceitar escreve o novo ID de modelo no seu [arquivo de configurações do usuário](/docs/pt/settings) e reinicia Claude Code. Recusar é lembrado até a próxima mudança de versão padrão.

273 273 

274Se você não fixou um modelo e o padrão atual não está disponível no seu projeto, Claude Code volta para a versão anterior para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, volta para o modelo Sonnet padrão. O fallback não é persistido. Ative o modelo mais recente no [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) ou [fixe uma versão](#5-pin-model-versions) para tornar a escolha permanente.274Se você não fixou um modelo e o padrão atual não está disponível no seu projeto, Claude Code volta para a versão anterior para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, volta para o modelo Sonnet padrão. O fallback não é persistido. Ative o modelo mais recente no [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) ou [fixe uma versão](#5-pin-model-versions) para tornar a escolha permanente.

275 275 


297 297 

298Claude Sonnet 5, Opus 4.6 e posteriores, e Sonnet 4.6 suportam a [janela de contexto de 1M de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) na Plataforma de Agentes do Google Cloud. Sonnet 5 sempre é executado com a janela de 1M, sem nenhuma variante `[1m]` para selecionar. Para os outros modelos, Claude Code ativa automaticamente a janela de contexto estendida quando você seleciona uma variante de modelo 1M.298Claude Sonnet 5, Opus 4.6 e posteriores, e Sonnet 4.6 suportam a [janela de contexto de 1M de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) na Plataforma de Agentes do Google Cloud. Sonnet 5 sempre é executado com a janela de 1M, sem nenhuma variante `[1m]` para selecionar. Para os outros modelos, Claude Code ativa automaticamente a janela de contexto estendida quando você seleciona uma variante de modelo 1M.

299 299 

300O [assistente de configuração](#sign-in-with-agent-platform) oferece uma opção de contexto 1M quando fixa modelos. Para ativá-lo para um modelo fixado manualmente em vez disso, acrescente `[1m]` ao ID do modelo. Veja [Fixar modelos para implantações de terceiros](/pt/model-config#pin-models-for-third-party-deployments) para detalhes.300O [assistente de configuração](#sign-in-with-agent-platform) oferece uma opção de contexto 1M quando fixa modelos. Para ativá-lo para um modelo fixado manualmente em vez disso, acrescente `[1m]` ao ID do modelo. Veja [Fixar modelos para implantações de terceiros](/docs/pt/model-config#pin-models-for-third-party-deployments) para detalhes.

301 301 

302<h2 id="troubleshooting">302<h2 id="troubleshooting">

303 Resolução de problemas303 Resolução de problemas

headless.md +23 −23

Details

6 6 

7> Use o Agent SDK para executar Claude Code programaticamente a partir da CLI, Python ou TypeScript.7> Use o Agent SDK para executar Claude Code programaticamente a partir da CLI, Python ou TypeScript.

8 8 

9O [Agent SDK](/pt/agent-sdk/overview) oferece as mesmas ferramentas, loop de agente e gerenciamento de contexto que alimentam Claude Code. Está disponível como uma CLI para scripts e CI/CD, ou como pacotes [Python](/pt/agent-sdk/python) e [TypeScript](/pt/agent-sdk/typescript) para controle programático completo.9O [Agent SDK](/docs/pt/agent-sdk/overview) oferece as mesmas ferramentas, loop de agente e gerenciamento de contexto que alimentam Claude Code. Está disponível como uma CLI para scripts e CI/CD, ou como pacotes [Python](/docs/pt/agent-sdk/python) e [TypeScript](/docs/pt/agent-sdk/typescript) para controle programático completo.

10 10 

11Para executar Claude Code em modo não interativo, passe `-p` com seu prompt e qualquer [opção de CLI](/pt/cli-reference):11Para executar Claude Code em modo não interativo, passe `-p` com seu prompt e qualquer [opção de CLI](/docs/pt/cli-reference):

12 12 

13```bash theme={null}13```bash theme={null}

14claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"14claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"

15```15```

16 16 

17Esta página aborda o uso do Agent SDK via CLI (`claude -p`). Para os pacotes SDK Python e TypeScript com saídas estruturadas, callbacks de aprovação de ferramentas e objetos de mensagem nativos, consulte a [documentação completa do Agent SDK](/pt/agent-sdk/overview).17Esta página aborda o uso do Agent SDK via CLI (`claude -p`). Para os pacotes SDK Python e TypeScript com saídas estruturadas, callbacks de aprovação de ferramentas e objetos de mensagem nativos, consulte a [documentação completa do Agent SDK](/docs/pt/agent-sdk/overview).

18 18 

19<h2 id="basic-usage">19<h2 id="basic-usage">

20 Uso básico20 Uso básico

21</h2>21</h2>

22 22 

23Adicione o sinalizador `-p` (ou `--print`) a qualquer comando `claude` para executá-lo de forma não interativa. Todas as [opções de CLI](/pt/cli-reference) funcionam com `-p`, incluindo:23Adicione o sinalizador `-p` (ou `--print`) a qualquer comando `claude` para executá-lo de forma não interativa. Todas as [opções de CLI](/docs/pt/cli-reference) funcionam com `-p`, incluindo:

24 24 

25* `--continue` para [continuar conversas](#continue-conversations)25* `--continue` para [continuar conversas](#continue-conversations)

26* `--allowedTools` para [aprovar ferramentas automaticamente](#auto-approve-tools)26* `--allowedTools` para [aprovar ferramentas automaticamente](#auto-approve-tools)


36 Comece mais rápido com modo bare36 Comece mais rápido com modo bare

37</h3>37</h3>

38 38 

39Adicione `--bare` para reduzir o tempo de inicialização pulando a descoberta automática de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. Sem ele, `claude -p` carrega o mesmo [contexto](/pt/how-claude-code-works#the-context-window) que uma sessão interativa carregaria, incluindo qualquer coisa configurada no diretório de trabalho ou `~/.claude`.39Adicione `--bare` para reduzir o tempo de inicialização pulando a descoberta automática de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. Sem ele, `claude -p` carrega o mesmo [contexto](/docs/pt/how-claude-code-works#the-context-window) que uma sessão interativa carregaria, incluindo qualquer coisa configurada no diretório de trabalho ou `~/.claude`.

40 40 

41O modo bare é útil para CI e scripts onde você precisa do mesmo resultado em cada máquina. Um hook no `~/.claude` de um colega de trabalho ou um servidor MCP no `.mcp.json` do projeto não serão executados, porque o modo bare nunca os lê. Apenas os sinalizadores que você passa explicitamente têm efeito.41O modo bare é útil para CI e scripts onde você precisa do mesmo resultado em cada máquina. Um hook no `~/.claude` de um colega de trabalho ou um servidor MCP no `.mcp.json` do projeto não serão executados, porque o modo bare nunca os lê. Apenas os sinalizadores que você passa explicitamente têm efeito.

42 42 


66 Tarefas em segundo plano ao sair66 Tarefas em segundo plano ao sair

67</h3>67</h3>

68 68 

69Se Claude iniciar uma [tarefa Bash em segundo plano](/pt/tools-reference#bash-tool-behavior) durante uma execução de `claude -p`, por exemplo um servidor de desenvolvimento ou uma compilação de observação, essa tarefa será encerrada cerca de cinco segundos após Claude retornar seu resultado final e stdin ter sido fechado. O período de carência permite que uma tarefa que termina logo após o resultado ainda entregue sua saída. Antes da v2.1.163, um processo em segundo plano que nunca sairia manteria a invocação de `claude -p` aberta indefinidamente.69Se Claude iniciar uma [tarefa Bash em segundo plano](/docs/pt/tools-reference#bash-tool-behavior) durante uma execução de `claude -p`, por exemplo um servidor de desenvolvimento ou uma compilação de observação, essa tarefa será encerrada cerca de cinco segundos após Claude retornar seu resultado final e stdin ter sido fechado. O período de carência permite que uma tarefa que termina logo após o resultado ainda entregue sua saída. Antes da v2.1.163, um processo em segundo plano que nunca sairia manteria a invocação de `claude -p` aberta indefinidamente.

70 70 

71[Subagentos](/pt/sub-agents) em segundo plano e fluxos de trabalho estão isentos do período de carência de cinco segundos porque seu resultado faz parte da saída final, então `claude -p` aguarda sua conclusão. A partir da v2.1.182, essa espera é limitada a dez minutos por padrão para que um agente em segundo plano travado não possa manter o processo aberto indefinidamente. Ajuste o limite com [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/pt/env-vars), ou defina-o como `0` para aguardar sem limite.71[Subagentos](/docs/pt/sub-agents) em segundo plano e fluxos de trabalho estão isentos do período de carência de cinco segundos porque seu resultado faz parte da saída final, então `claude -p` aguarda sua conclusão. A partir da v2.1.182, essa espera é limitada a dez minutos por padrão para que um agente em segundo plano travado não possa manter o processo aberto indefinidamente. Ajuste o limite com [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/pt/env-vars), ou defina-o como `0` para aguardar sem limite.

72 72 

73<h2 id="examples">73<h2 id="examples">

74 Exemplos74 Exemplos


88cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt88cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

89```89```

90 90 

91Com `--output-format json`, a carga de resposta inclui `total_cost_usd` e um detalhamento de custo por modelo, para que os chamadores com script possam rastrear gastos por invocação sem consultar o [painel de uso](/pt/costs).91Com `--output-format json`, a carga de resposta inclui `total_cost_usd` e um detalhamento de custo por modelo, para que os chamadores com script possam rastrear gastos por invocação sem consultar o [painel de uso](/docs/pt/costs).

92 92 

93<Note>93<Note>

94 A partir do Claude Code v2.1.128, stdin canalizado é limitado a 10MB. Se você exceder o limite, Claude Code sai com um erro claro e um status diferente de zero. Para trabalhar com entradas maiores, escreva o conteúdo em um arquivo e faça referência ao caminho do arquivo em seu prompt em vez de canalizá-lo.94 A partir do Claude Code v2.1.128, stdin canalizado é limitado a 10MB. Se você exceder o limite, Claude Code sai com um erro claro e um status diferente de zero. Para trabalhar com entradas maiores, escreva o conteúdo em um arquivo e faça referência ao caminho do arquivo em seu prompt em vez de canalizá-lo.


163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages

164```164```

165 165 

166A última linha do stream é uma mensagem `result` com o texto de resposta final, custo e metadados de sessão. {/* min-version: 2.1.208 */}Antes da v2.1.208, canalizar uma resposta grande poderia truncar a linha final e omitir a mensagem `result`.166A última linha do stream é uma mensagem `result` com o texto de resposta final, custo e metadados de sessão. Antes da v2.1.208, canalizar uma resposta grande poderia truncar a linha final e omitir a mensagem `result`.

167 167 

168O exemplo a seguir usa [jq](https://jqlang.github.io/jq/) para filtrar deltas de texto e exibir apenas o texto de streaming. O sinalizador `-r` produz strings brutas (sem aspas) e `-j` une sem quebras de linha para que os tokens façam streaming continuamente:168O exemplo a seguir usa [jq](https://jqlang.github.io/jq/) para filtrar deltas de texto e exibir apenas o texto de streaming. O sinalizador `-r` produz strings brutas (sem aspas) e `-j` une sem quebras de linha para que os tokens façam streaming continuamente:

169 169 


188 188 

189O evento `system/init` relata metadados de sessão incluindo o modelo, ferramentas, servidores MCP e plugins carregados. É o primeiro evento no stream a menos que eventos de inicialização o precedam:189O evento `system/init` relata metadados de sessão incluindo o modelo, ferramentas, servidores MCP e plugins carregados. É o primeiro evento no stream a menos que eventos de inicialização o precedam:

190 190 

191* eventos `plugin_install`, quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/pt/env-vars) está definido.191* eventos `plugin_install`, quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/pt/env-vars) está definido.

192* {/* min-version: 2.1.204 */}[eventos `hook_started`, `hook_progress` e `hook_response`](/pt/agent-sdk/typescript#sdkhookstartedmessage), enquanto um hook [`SessionStart`](/pt/hooks#sessionstart) ou [`Setup`](/pt/hooks#setup) configurado é executado. Estes fazem stream conforme o hook os produz. Claude Code v2.1.169 através v2.1.203 os entregou em um lote após o hook ser concluído, ainda à frente de `system/init`; v2.1.204 restaurou a entrega ao vivo.192* [eventos `hook_started`, `hook_progress` e `hook_response`](/docs/pt/agent-sdk/typescript#sdkhookstartedmessage), enquanto um hook [`SessionStart`](/docs/pt/hooks#sessionstart) ou [`Setup`](/docs/pt/hooks#setup) configurado é executado. Estes fazem stream conforme o hook os produz. Claude Code v2.1.169 através v2.1.203 os entregou em um lote após o hook ser concluído, ainda à frente de `system/init`; v2.1.204 restaurou a entrega ao vivo.

193 193 

194O evento também carrega uma matriz `capabilities` opcional de strings nomeando os comportamentos do protocolo que esta versão do Claude Code implementa, como `interrupt_receipt_v1`. Verifique-a para detectar recursos em vez de comparar strings de versão, e ignore valores que você não reconheça. O campo requer Claude Code v2.1.205 ou posterior e está ausente em versões anteriores. Consulte [`SDKSystemMessage`](/pt/agent-sdk/typescript#sdksystemmessage) para a lista de capacidades.194O evento também carrega uma matriz `capabilities` opcional de strings nomeando os comportamentos do protocolo que esta versão do Claude Code implementa, como `interrupt_receipt_v1`. Verifique-a para detectar recursos em vez de comparar strings de versão, e ignore valores que você não reconheça. O campo requer Claude Code v2.1.205 ou posterior e está ausente em versões anteriores. Consulte [`SDKSystemMessage`](/docs/pt/agent-sdk/typescript#sdksystemmessage) para a lista de capacidades.

195 195 

196Use os campos de plugin para falhar CI quando um plugin não foi carregado:196Use os campos de plugin para falhar CI quando um plugin não foi carregado:

197 197 


200| `plugins` | array | plugins que foram carregados com sucesso, cada um com `name` e `path` |200| `plugins` | array | plugins que foram carregados com sucesso, cada um com `name` e `path` |

201| `plugin_errors` | array | erros de tempo de carregamento de plugin, cada um com `plugin`, `type` e `message`. Inclui versões de dependência insatisfeitas e falhas de carregamento de `--plugin-dir` como um caminho ausente ou arquivo inválido. Os plugins afetados são rebaixados e ausentes de `plugins`. A chave é omitida quando não há erros |201| `plugin_errors` | array | erros de tempo de carregamento de plugin, cada um com `plugin`, `type` e `message`. Inclui versões de dependência insatisfeitas e falhas de carregamento de `--plugin-dir` como um caminho ausente ou arquivo inválido. Os plugins afetados são rebaixados e ausentes de `plugins`. A chave é omitida quando não há erros |

202 202 

203Quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/pt/env-vars) está definido, Claude Code emite eventos `system/plugin_install` enquanto plugins do marketplace instalam antes da primeira volta. Use estes para exibir o progresso de instalação em sua própria UI.203Quando [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/pt/env-vars) está definido, Claude Code emite eventos `system/plugin_install` enquanto plugins do marketplace instalam antes da primeira volta. Use estes para exibir o progresso de instalação em sua própria UI.

204 204 

205| Campo | Tipo | Descrição |205| Campo | Tipo | Descrição |

206| ------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |206| ------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |


212| `uuid` | string | identificador único do evento |212| `uuid` | string | identificador único do evento |

213| `session_id` | string | sessão à qual o evento pertence |213| `session_id` | string | sessão à qual o evento pertence |

214 214 

215Para streaming programático com callbacks e objetos de mensagem, consulte [Stream responses in real-time](/pt/agent-sdk/streaming-output) na documentação do Agent SDK.215Para streaming programático com callbacks e objetos de mensagem, consulte [Stream responses in real-time](/docs/pt/agent-sdk/streaming-output) na documentação do Agent SDK.

216 216 

217<h3 id="auto-approve-tools">217<h3 id="auto-approve-tools">

218 Aprovar ferramentas automaticamente218 Aprovar ferramentas automaticamente


225 --allowedTools "Bash,Read,Edit"225 --allowedTools "Bash,Read,Edit"

226```226```

227 227 

228Para definir uma linha de base para toda a sessão em vez de listar ferramentas individuais, passe um [modo de permissão](/pt/permission-modes). `dontAsk` nega qualquer coisa não em suas regras `permissions.allow` ou no [conjunto de comandos somente leitura](/pt/permissions#read-only-commands), o que é útil para execuções de CI bloqueadas. `AskUserQuestion`, ferramentas de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo quando uma regra de permissão corresponde.228Para definir uma linha de base para toda a sessão em vez de listar ferramentas individuais, passe um [modo de permissão](/docs/pt/permission-modes). `dontAsk` nega qualquer coisa não em suas regras `permissions.allow` ou no [conjunto de comandos somente leitura](/docs/pt/permissions#read-only-commands), o que é útil para execuções de CI bloqueadas. `AskUserQuestion`, ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo quando uma regra de permissão corresponde.

229 229 

230`acceptEdits` permite que Claude escreva arquivos sem solicitar e também aprova automaticamente comandos comuns do sistema de arquivos, como `mkdir`, `touch`, `mv` e `cp`. Outros comandos de shell e solicitações de rede ainda precisam de uma entrada `--allowedTools` ou uma regra `permissions.allow`, caso contrário a execução é abortada quando uma é tentada:230`acceptEdits` permite que Claude escreva arquivos sem solicitar e também aprova automaticamente comandos comuns do sistema de arquivos, como `mkdir`, `touch`, `mv` e `cp`. Outros comandos de shell e solicitações de rede ainda precisam de uma entrada `--allowedTools` ou uma regra `permissions.allow`, caso contrário a execução é abortada quando uma é tentada:

231 231 


244 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"244 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

245```245```

246 246 

247O sinalizador `--allowedTools` usa [sintaxe de regra de permissão](/pt/settings#permission-rule-syntax). O ` *` à direita habilita correspondência de prefixo, então `Bash(git diff *)` permite qualquer comando começando com `git diff`. O espaço antes de `*` é importante: sem ele, `Bash(git diff*)` também corresponderia a `git diff-index`.247O sinalizador `--allowedTools` usa [sintaxe de regra de permissão](/docs/pt/settings#permission-rule-syntax). O ` *` à direita habilita correspondência de prefixo, então `Bash(git diff *)` permite qualquer comando começando com `git diff`. O espaço antes de `*` é importante: sem ele, `Bash(git diff*)` também corresponderia a `git diff-index`.

248 248 

249<Note>249<Note>

250 Skills invocadas pelo usuário e comandos personalizados funcionam no modo `-p`: inclua `/skill-name` na string de prompt e Claude Code o expande antes de executar. Comandos integrados que abrem um diálogo interativo, como `/login`, não estão disponíveis no modo `-p`. {/* min-version: 2.1.205 */}`/model`, `/effort`, `/fast`, `/color` e `/rename` aceitam o valor como um argumento, por exemplo `/model sonnet`, e `/mcp` sem argumento imprime um resumo de texto do status do servidor; essas formas requerem Claude Code v2.1.205 ou posterior e seguem as notas de disponibilidade de cada comando]\(/pt/commands#all-commands). {/* min-version: 2.1.181 */}Para alterar uma configuração de uma invocação `-p`, passe `key=value` para `/config`, por exemplo `/config thinking=false`.250 Skills invocadas pelo usuário e comandos personalizados funcionam no modo `-p`: inclua `/skill-name` na string de prompt e Claude Code o expande antes de executar. Comandos integrados que abrem um diálogo interativo, como `/login`, não estão disponíveis no modo `-p`. `/model`, `/effort`, `/fast`, `/color` e `/rename` aceitam o valor como um argumento, por exemplo `/model sonnet`, e `/mcp` sem argumento imprime um resumo de texto do status do servidor; essas formas requerem Claude Code v2.1.205 ou posterior e seguem as notas de disponibilidade de cada comando]\(/pt/commands#all-commands). Para alterar uma configuração de uma invocação `-p`, passe `key=value` para `/config`, por exemplo `/config thinking=false`.

251</Note>251</Note>

252 252 

253<h3 id="customize-the-system-prompt">253<h3 id="customize-the-system-prompt">


262 --output-format json262 --output-format json

263```263```

264 264 

265Consulte [system prompt flags](/pt/cli-reference#system-prompt-flags) para mais opções, incluindo `--system-prompt` para substituir completamente o prompt padrão.265Consulte [system prompt flags](/docs/pt/cli-reference#system-prompt-flags) para mais opções, incluindo `--system-prompt` para substituir completamente o prompt padrão.

266 266 

267<h3 id="continue-conversations">267<h3 id="continue-conversations">

268 Continuar conversas268 Continuar conversas


286claude -p "Continue that review" --resume "$session_id"286claude -p "Continue that review" --resume "$session_id"

287```287```

288 288 

289Execute ambos os comandos do mesmo diretório: a busca de ID de sessão é limitada ao diretório do projeto atual e seus git worktrees. Consulte [Resume a session](/pt/sessions#resume-a-session) para as regras de escopo completas.289Execute ambos os comandos do mesmo diretório: a busca de ID de sessão é limitada ao diretório do projeto atual e seus git worktrees. Consulte [Resume a session](/docs/pt/sessions#resume-a-session) para as regras de escopo completas.

290 290 

291<h2 id="next-steps">291<h2 id="next-steps">

292 Próximas etapas292 Próximas etapas

293</h2>293</h2>

294 294 

295* [Agent SDK quickstart](/pt/agent-sdk/quickstart): construa seu primeiro agente com Python ou TypeScript295* [Agent SDK quickstart](/docs/pt/agent-sdk/quickstart): construa seu primeiro agente com Python ou TypeScript

296* [CLI reference](/pt/cli-reference): todos os sinalizadores e opções de CLI296* [CLI reference](/docs/pt/cli-reference): todos os sinalizadores e opções de CLI

297* [GitHub Actions](/pt/github-actions): use o Agent SDK em fluxos de trabalho do GitHub297* [GitHub Actions](/docs/pt/github-actions): use o Agent SDK em fluxos de trabalho do GitHub

298* [GitLab CI/CD](/pt/gitlab-ci-cd): use o Agent SDK em pipelines do GitLab298* [GitLab CI/CD](/docs/pt/gitlab-ci-cd): use o Agent SDK em pipelines do GitLab

hooks.md +9 −9

Details

326 326 

327Todos os hooks correspondentes executam em paralelo, e manipuladores idênticos são automaticamente desduplicados. Hooks de comando são desduplicados por string de comando e `args`, e hooks HTTP são desduplicados por URL.327Todos os hooks correspondentes executam em paralelo, e manipuladores idênticos são automaticamente desduplicados. Hooks de comando são desduplicados por string de comando e `args`, e hooks HTTP são desduplicados por URL.

328 328 

329Manipuladores executam no diretório atual com o ambiente do Claude Code. A variável de ambiente `$CLAUDE_CODE_REMOTE` é definida como `"true"` em ambientes web remotos e não é definida na CLI local. {/* min-version: 2.1.199 */}A partir de v2.1.199, [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/pt/env-vars) é definido para o ID de sessão [Remote Control](/docs/pt/remote-control) enquanto a sessão local tem uma conexão Remote Control ativa.329Manipuladores executam no diretório atual com o ambiente do Claude Code. A variável de ambiente `$CLAUDE_CODE_REMOTE` é definida como `"true"` em ambientes web remotos e não é definida na CLI local. A partir de v2.1.199, [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/pt/env-vars) é definido para o ID de sessão [Remote Control](/docs/pt/remote-control) enquanto a sessão local tem uma conexão Remote Control ativa.

330 330 

331<h4 id="common-fields">331<h4 id="common-fields">

332 Campos comuns332 Campos comuns


642| Campo | Descrição |642| Campo | Descrição |

643| :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |643| :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

644| `session_id` | Identificador de sessão atual |644| `session_id` | Identificador de sessão atual |

645| `prompt_id` | UUID identificando o prompt do usuário sendo processado atualmente. Corresponde ao [atributo `prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes), para que você possa correlacionar saída de hook com telemetria para um único prompt. Ausente até a primeira entrada do usuário. {/* min-version: 2.1.196 */}Requer Claude Code v2.1.196 ou posterior |645| `prompt_id` | UUID identificando o prompt do usuário sendo processado atualmente. Corresponde ao [atributo `prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes), para que você possa correlacionar saída de hook com telemetria para um único prompt. Ausente até a primeira entrada do usuário. Requer Claude Code v2.1.196 ou posterior |

646| `transcript_path` | Caminho para JSON de conversa. O arquivo de transcrição é escrito de forma assíncrona e pode ficar atrás da conversa na memória, portanto pode não incluir ainda as mensagens mais recentes da rodada atual quando um hook dispara. Hooks que precisam do texto final do assistente da rodada atual devem usar `last_assistant_message` em [Stop](#stop) e [SubagentStop](#subagentstop) em vez de ler a transcrição |646| `transcript_path` | Caminho para JSON de conversa. O arquivo de transcrição é escrito de forma assíncrona e pode ficar atrás da conversa na memória, portanto pode não incluir ainda as mensagens mais recentes da rodada atual quando um hook dispara. Hooks que precisam do texto final do assistente da rodada atual devem usar `last_assistant_message` em [Stop](#stop) e [SubagentStop](#subagentstop) em vez de ler a transcrição |

647| `cwd` | Diretório de trabalho atual quando o hook é invocado |647| `cwd` | Diretório de trabalho atual quando o hook é invocado |

648| `permission_mode` | [Modo de permissão](/docs/pt/permissions#permission-modes) atual: `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` ou `"bypassPermissions"`. O modo rotulado **Manual** chega como `"default"`, nunca como `"manual"`, portanto scripts que correspondem a `"default"` continuam funcionando. Nem todos os eventos recebem este campo. Verifique o exemplo JSON em cada seção [evento de hook](#hook-events) |648| `permission_mode` | [Modo de permissão](/docs/pt/permissions#permission-modes) atual: `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` ou `"bypassPermissions"`. O modo rotulado **Manual** chega como `"default"`, nunca como `"manual"`, portanto scripts que correspondem a `"default"` continuam funcionando. Nem todos os eventos recebem este campo. Verifique o exemplo JSON em cada seção [evento de hook](#hook-events) |


1567Em `PostToolUse`, `tool_response` para uma chamada Agent concluída carrega o texto final do subagente junto com telemetria de uso. Leia esses campos para registrar custo por subagente de um hook:1567Em `PostToolUse`, `tool_response` para uma chamada Agent concluída carrega o texto final do subagente junto com telemetria de uso. Leia esses campos para registrar custo por subagente de um hook:

1568 1568 

1569| Campo | Tipo | Exemplo | Descrição |1569| Campo | Tipo | Exemplo | Descrição |

1570| :------------------ | :----- | :---------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1570| :------------------ | :----- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1571| `status` | string | `"completed"` | `"completed"` para subagentes em primeiro plano, `"async_launched"` para subagentes em background. {/* min-version: 2.1.198 */}A partir de v2.1.198, subagentes executam em background por padrão, então um `run_in_background` omitido também produz `"async_launched"` |1571| `status` | string | `"completed"` | `"completed"` para subagentes em primeiro plano, `"async_launched"` para subagentes em background. A partir de v2.1.198, subagentes executam em background por padrão, então um `run_in_background` omitido também produz `"async_launched"` |

1572| `agentId` | string | `"a4d2c8f1e0b3a297"` | Identificador para a execução do subagente |1572| `agentId` | string | `"a4d2c8f1e0b3a297"` | Identificador para a execução do subagente |

1573| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Os blocos de texto final do subagente |1573| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Os blocos de texto final do subagente |

1574| `resolvedModel` | string | `"claude-sonnet-4-5"` | Modelo que o subagente executou, que pode diferir do modelo solicitado. {/* min-version: 2.1.174 */}Requer Claude Code v2.1.174 ou posterior |1574| `resolvedModel` | string | `"claude-sonnet-4-5"` | Modelo que o subagente executou, que pode diferir do modelo solicitado. Requer Claude Code v2.1.174 ou posterior |

1575| `totalTokens` | number | `12450` | Total de tokens cobrados através dos turnos do subagente |1575| `totalTokens` | number | `12450` | Total de tokens cobrados através dos turnos do subagente |

1576| `totalDurationMs` | number | `48211` | Duração de relógio de parede da execução do subagente |1576| `totalDurationMs` | number | `48211` | Duração de relógio de parede da execução do subagente |

1577| `totalToolUseCount` | number | `7` | Contagem de chamadas de ferramenta que o subagente fez |1577| `totalToolUseCount` | number | `7` | Contagem de chamadas de ferramenta que o subagente fez |


1601Apresenta um plano e pede ao usuário para aprová-lo antes do Claude sair do [modo de plano](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode). Claude escreve o plano em um arquivo no disco antes de chamar a ferramenta, então o `tool_input` literal do modelo é tipicamente vazio. Claude Code injeta o conteúdo do plano e o caminho do arquivo antes de passar a entrada para hooks.1601Apresenta um plano e pede ao usuário para aprová-lo antes do Claude sair do [modo de plano](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode). Claude escreve o plano em um arquivo no disco antes de chamar a ferramenta, então o `tool_input` literal do modelo é tipicamente vazio. Claude Code injeta o conteúdo do plano e o caminho do arquivo antes de passar a entrada para hooks.

1602 1602 

1603| Campo | Tipo | Exemplo | Descrição |1603| Campo | Tipo | Exemplo | Descrição |

1604| :--------------- | :----- | :------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1604| :--------------- | :----- | :------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1605| `plan` | string | `"## Refactor auth\n1. Extract..."` | Conteúdo do plano em Markdown. Injetado do arquivo de plano no disco |1605| `plan` | string | `"## Refactor auth\n1. Extract..."` | Conteúdo do plano em Markdown. Injetado do arquivo de plano no disco |

1606| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Caminho para o arquivo de plano. Injetado |1606| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Caminho para o arquivo de plano. Injetado |

1607| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | {/* min-version: 2.1.205 */}Deprecated. Claude Code aceita o campo mas o ignora. Antes de v2.1.205, ele carregava permissões baseadas em prompt que Claude estava solicitando para implementar o plano |1607| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Deprecated. Claude Code aceita o campo mas o ignora. Antes de v2.1.205, ele carregava permissões baseadas em prompt que Claude estava solicitando para implementar o plano |

1608 1608 

1609Em `PostToolUse`, `tool_response` é um objeto com campos `plan` e `filePath` contendo o plano aprovado, mais flags de status interno. Leia `tool_response.plan` para o conteúdo do plano em vez de re-ler o arquivo do disco.1609Em `PostToolUse`, `tool_response` é um objeto com campos `plan` e `filePath` contendo o plano aprovado, mais flags de status interno. Leia `tool_response.plan` para o conteúdo do plano em vez de re-ler o arquivo do disco.

1610 1610 


1762O campo de saída `updatedPermissions` e o campo de entrada [`permission_suggestions`](#permissionrequest-input) ambos usam o mesmo array de objetos de entrada. Cada entrada tem um `type` que determina seus outros campos e um `destination` que controla onde a mudança é escrita.1762O campo de saída `updatedPermissions` e o campo de entrada [`permission_suggestions`](#permissionrequest-input) ambos usam o mesmo array de objetos de entrada. Cada entrada tem um `type` que determina seus outros campos e um `destination` que controla onde a mudança é escrita.

1763 1763 

1764| `type` | Campos | Efeito |1764| `type` | Campos | Efeito |

1765| :------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1765| :------------------ | :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1766| `addRules` | `rules`, `behavior`, `destination` | Adiciona regras de permissão. `rules` é um array de objetos `{toolName, ruleContent?}`. Omita `ruleContent` para corresponder a toda a ferramenta. `behavior` é `"allow"`, `"deny"` ou `"ask"` |1766| `addRules` | `rules`, `behavior`, `destination` | Adiciona regras de permissão. `rules` é um array de objetos `{toolName, ruleContent?}`. Omita `ruleContent` para corresponder a toda a ferramenta. `behavior` é `"allow"`, `"deny"` ou `"ask"` |

1767| `replaceRules` | `rules`, `behavior`, `destination` | Substitui todas as regras do `behavior` dado no `destination` pelas `rules` fornecidas |1767| `replaceRules` | `rules`, `behavior`, `destination` | Substitui todas as regras do `behavior` dado no `destination` pelas `rules` fornecidas |

1768| `removeRules` | `rules`, `behavior`, `destination` | Remove regras correspondentes do `behavior` dado |1768| `removeRules` | `rules`, `behavior`, `destination` | Remove regras correspondentes do `behavior` dado |

1769| `setMode` | `mode`, `destination` | Muda o modo de permissão. Modos válidos são `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` e {/* min-version: 2.1.200 */}`manual` como um alias para `default`. O alias `manual` requer Claude Code v2.1.200 ou posterior |1769| `setMode` | `mode`, `destination` | Muda o modo de permissão. Modos válidos são `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` e `manual` como um alias para `default`. O alias `manual` requer Claude Code v2.1.200 ou posterior |

1770| `addDirectories` | `directories`, `destination` | Adiciona diretórios de trabalho. `directories` é um array de strings de caminho |1770| `addDirectories` | `directories`, `destination` | Adiciona diretórios de trabalho. `directories` é um array de strings de caminho |

1771| `removeDirectories` | `directories`, `destination` | Remove diretórios de trabalho |1771| `removeDirectories` | `directories`, `destination` | Remove diretórios de trabalho |

1772 1772 

hooks-guide.md +1 −1

Details

654}654}

655```655```

656 656 

657O matcher `"Edit|Write"` dispara apenas quando Claude usa a ferramenta `Edit` ou `Write`, não quando usa `Bash`, `Read` ou qualquer outra ferramenta. {/* min-version: 2.1.191 */}No Claude Code v2.1.191 ou posterior, uma vírgula separa alternativas da mesma forma, então `"Edit, Write"` é equivalente. Consulte [Padrões de matcher](/docs/pt/hooks#matcher-patterns) para como nomes simples e expressões regulares são avaliados.657O matcher `"Edit|Write"` dispara apenas quando Claude usa a ferramenta `Edit` ou `Write`, não quando usa `Bash`, `Read` ou qualquer outra ferramenta. No Claude Code v2.1.191 ou posterior, uma vírgula separa alternativas da mesma forma, então `"Edit, Write"` é equivalente. Consulte [Padrões de matcher](/docs/pt/hooks#matcher-patterns) para como nomes simples e expressões regulares são avaliados.

658 658 

659<Note>659<Note>

660 Claude também pode criar ou modificar arquivos executando comandos shell através da ferramenta `Bash`. Se seu hook deve ver cada mudança de arquivo, como para varredura de conformidade ou registro de auditoria, adicione um hook [`Stop`](/docs/pt/hooks#stop) que varre a árvore de trabalho uma vez por turno. Para cobertura por chamada em vez disso, também corresponda `Bash` e tenha seu script listar arquivos modificados e não rastreados com `git status --porcelain`.660 Claude também pode criar ou modificar arquivos executando comandos shell através da ferramenta `Bash`. Se seu hook deve ver cada mudança de arquivo, como para varredura de conformidade ou registro de auditoria, adicione um hook [`Stop`](/docs/pt/hooks#stop) que varre a árvore de trabalho uma vez por turno. Para cobertura por chamada em vez disso, também corresponda `Bash` e tenha seu script listar arquivos modificados e não rastreados com `git status --porcelain`.

Details

11</h2>11</h2>

12 12 

13<Note>13<Note>

14 Os atalhos de teclado podem variar por plataforma e terminal. Em [renderização em tela cheia](/pt/fullscreen), pressione `?` no visualizador de transcrição para ver os atalhos disponíveis lá.14 Os atalhos de teclado podem variar por plataforma e terminal. Em [renderização em tela cheia](/docs/pt/fullscreen), pressione `?` no visualizador de transcrição para ver os atalhos disponíveis lá.

15 15 

16 **Usuários de macOS**: Os atalhos da tecla Option/Alt (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+M`, `Alt+P`) exigem configurar Option como Meta no seu terminal:16 **Usuários de macOS**: Os atalhos da tecla Option/Alt (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+M`, `Alt+P`) exigem configurar Option como Meta no seu terminal:

17 17 


19 * **Apple Terminal**: Configurações → Profiles → Keyboard → marque "Use Option as Meta Key"19 * **Apple Terminal**: Configurações → Profiles → Keyboard → marque "Use Option as Meta Key"

20 * **VS Code**: defina `"terminal.integrated.macOptionIsMeta": true` nas configurações do VS Code20 * **VS Code**: defina `"terminal.integrated.macOptionIsMeta": true` nas configurações do VS Code

21 21 

22 Veja [Configuração de terminal](/pt/terminal-config) para detalhes.22 Veja [Configuração de terminal](/docs/pt/terminal-config) para detalhes.

23</Note>23</Note>

24 24 

25<h3 id="general-controls">25<h3 id="general-controls">


27</h3>27</h3>

28 28 

29| Atalho | Descrição | Contexto |29| Atalho | Descrição | Contexto |

30| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |30| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

31| `Ctrl+C` | Interromper, ou limpar entrada | Interrompe uma operação em execução. Se nada estiver em execução, o primeiro pressionamento limpa a entrada do prompt e um segundo pressionamento sai do Claude Code |31| `Ctrl+C` | Interromper, ou limpar entrada | Interrompe uma operação em execução. Se nada estiver em execução, o primeiro pressionamento limpa a entrada do prompt e um segundo pressionamento sai do Claude Code |

32| `Ctrl+X Ctrl+K` | Encerrar todos os [subagentes em segundo plano](/pt/sub-agents#run-subagents-in-foreground-or-background) nesta sessão. Pressione duas vezes em 3 segundos para confirmar | Controle de subagente |32| `Ctrl+X Ctrl+K` | Encerrar todos os [subagentes em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) nesta sessão. Pressione duas vezes em 3 segundos para confirmar | Controle de subagente |

33| `Ctrl+D` | Sair da sessão do Claude Code | Sinal EOF |33| `Ctrl+D` | Sair da sessão do Claude Code | Sinal EOF |

34| `Ctrl+G` ou `Ctrl+X Ctrl+E` | Abrir no editor de texto padrão | Edite seu prompt ou resposta personalizada no seu editor de texto padrão. `Ctrl+X Ctrl+E` é a ligação nativa do readline. Ative Mostrar última resposta em editor externo em `/config` para adicionar a resposta anterior do Claude como contexto comentado com `#` acima do seu prompt; o bloco de comentário é removido quando você salva |34| `Ctrl+G` ou `Ctrl+X Ctrl+E` | Abrir no editor de texto padrão | Edite seu prompt ou resposta personalizada no seu editor de texto padrão. `Ctrl+X Ctrl+E` é a ligação nativa do readline. Ative Mostrar última resposta em editor externo em `/config` para adicionar a resposta anterior do Claude como contexto comentado com `#` acima do seu prompt; o bloco de comentário é removido quando você salva |

35| `Ctrl+L` | Redesenhar tela | Força um redesenho completo do terminal. A entrada e o histórico de conversa são mantidos. Use isto para recuperar se a exibição ficar corrompida ou parcialmente em branco |35| `Ctrl+L` | Redesenhar tela | Força um redesenho completo do terminal. A entrada e o histórico de conversa são mantidos. Use isto para recuperar se a exibição ficar corrompida ou parcialmente em branco |


37| `Ctrl+R` | Pesquisa reversa no histórico de comandos | Pesquise através de comandos anteriores interativamente |37| `Ctrl+R` | Pesquisa reversa no histórico de comandos | Pesquise através de comandos anteriores interativamente |

38| `Ctrl+V` ou `Cmd+V` (iTerm2) ou `Alt+V` (Windows e WSL) | Colar imagem da área de transferência | Insere um chip `[Image #N]` no cursor para que você possa referenciá-lo posicionalmente no seu prompt. No WSL, tanto `Ctrl+V` quanto `Alt+V` estão vinculados; use `Alt+V` se seu terminal interceptar `Ctrl+V` |38| `Ctrl+V` ou `Cmd+V` (iTerm2) ou `Alt+V` (Windows e WSL) | Colar imagem da área de transferência | Insere um chip `[Image #N]` no cursor para que você possa referenciá-lo posicionalmente no seu prompt. No WSL, tanto `Ctrl+V` quanto `Alt+V` estão vinculados; use `Alt+V` se seu terminal interceptar `Ctrl+V` |

39| `Ctrl+B` | Tarefas em execução em segundo plano | Coloca comandos bash e agentes em segundo plano. Usuários de Tmux pressione duas vezes |39| `Ctrl+B` | Tarefas em execução em segundo plano | Coloca comandos bash e agentes em segundo plano. Usuários de Tmux pressione duas vezes |

40| `Ctrl+T` | Alternar lista de tarefas do Claude | Mostrar ou ocultar a [lista de tarefas do Claude](#task-list) na área de status. Isto não é a visualização de tarefa em segundo plano; use [`/tasks`](/pt/commands) para ver shells e subagentes em execução |40| `Ctrl+T` | Alternar lista de tarefas do Claude | Mostrar ou ocultar a [lista de tarefas do Claude](#task-list) na área de status. Isto não é a visualização de tarefa em segundo plano; use [`/tasks`](/docs/pt/commands) para ver shells e subagentes em execução |

41| `Left/Right arrows` | Ciclar através de abas de diálogo | Navegue entre abas em diálogos de permissão e menus |41| `Left/Right arrows` | Ciclar através de abas de diálogo | Navegue entre abas em diálogos de permissão e menus |

42| `Up/Down arrows` ou `Ctrl+P`/`Ctrl+N` | Mover cursor ou navegar histórico de comandos | Quando a entrada abrange mais de uma linha visual, seja envolvida ou multilinha, primeiro move o cursor dentro do prompt. Uma vez que o cursor está na primeira ou última linha visual, pressionar novamente navega pelo histórico de comandos. {/* min-version: 2.1.169 */}A partir da v2.1.169, entrada de linha única envolvida se comporta da mesma forma que multilinha |42| `Up/Down arrows` ou `Ctrl+P`/`Ctrl+N` | Mover cursor ou navegar histórico de comandos | Quando a entrada abrange mais de uma linha visual, seja envolvida ou multilinha, primeiro move o cursor dentro do prompt. Uma vez que o cursor está na primeira ou última linha visual, pressionar novamente navega pelo histórico de comandos. A partir da v2.1.169, entrada de linha única envolvida se comporta da mesma forma que multilinha |

43| `Esc` | Interromper Claude, ou fechar um diálogo | Pare a resposta atual ou chamada de ferramenta no meio da vez para que você possa redirecionar. Claude mantém o trabalho realizado até agora. Quando um diálogo como um prompt de permissão está aberto, `Esc` fecha o diálogo em vez de interromper Claude. {/* min-version: 2.1.202 */}Antes da v2.1.202, `Esc` em alguns diálogos interrompia Claude e deixava o diálogo aberto |43| `Esc` | Interromper Claude, ou fechar um diálogo | Pare a resposta atual ou chamada de ferramenta no meio da vez para que você possa redirecionar. Claude mantém o trabalho realizado até agora. Quando um diálogo como um prompt de permissão está aberto, `Esc` fecha o diálogo em vez de interromper Claude. Antes da v2.1.202, `Esc` em alguns diálogos interrompia Claude e deixava o diálogo aberto |

44| `Esc` + `Esc` | Limpar rascunho de entrada, ou retroceder | Quando a entrada do prompt contém texto, duplo `Esc` limpa e salva o rascunho no histórico para que `Up` o recupere. Quando a entrada está vazia, duplo `Esc` abre o [menu de retrocesso](/pt/checkpointing) para restaurar ou resumir código e conversa de um ponto anterior |44| `Esc` + `Esc` | Limpar rascunho de entrada, ou retroceder | Quando a entrada do prompt contém texto, duplo `Esc` limpa e salva o rascunho no histórico para que `Up` o recupere. Quando a entrada está vazia, duplo `Esc` abre o [menu de retrocesso](/docs/pt/checkpointing) para restaurar ou resumir código e conversa de um ponto anterior |

45| `Shift+Tab` ou `Alt+M` (algumas configurações) | Alternar modos de permissão | Alternar entre `default` (rotulado Manual no indicador de modo), `acceptEdits`, `plan` e qualquer modo que você tenha ativado, como `auto` ou `bypassPermissions`. Veja [modos de permissão](/pt/permission-modes). |45| `Shift+Tab` ou `Alt+M` (algumas configurações) | Alternar modos de permissão | Alternar entre `default` (rotulado Manual no indicador de modo), `acceptEdits`, `plan` e qualquer modo que você tenha ativado, como `auto` ou `bypassPermissions`. Veja [modos de permissão](/docs/pt/permission-modes). |

46| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Alternar modelo | Alternar modelos sem limpar seu prompt |46| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Alternar modelo | Alternar modelos sem limpar seu prompt |

47| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Alternar pensamento estendido | Ativar ou desativar modo de pensamento estendido. Não tem efeito no Fable 5, que sempre usa pensamento estendido. {/* min-version: 2.1.132 */}A partir da v2.1.132 este atalho funciona no macOS sem configurar Option como Meta |47| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Alternar pensamento estendido | Ativar ou desativar modo de pensamento estendido. Não tem efeito no Fable 5, que sempre usa pensamento estendido. A partir da v2.1.132 este atalho funciona no macOS sem configurar Option como Meta |

48| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Alternar modo rápido | Ativar ou desativar [modo rápido](/pt/fast-mode) |48| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Alternar modo rápido | Ativar ou desativar [modo rápido](/docs/pt/fast-mode) |

49 49 

50<h3 id="text-editing">50<h3 id="text-editing">

51 Edição de texto51 Edição de texto


78| Método | Atalho | Contexto |78| Método | Atalho | Contexto |

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

80| Escape rápido | `\` + `Enter` | Funciona em todos os terminais |80| Escape rápido | `\` + `Enter` | Funciona em todos os terminais |

81| Tecla Option | `Option+Enter` | Após ativar [Option como Meta](/pt/terminal-config#enable-option-key-shortcuts-on-macos) no macOS |81| Tecla Option | `Option+Enter` | Após ativar [Option como Meta](/docs/pt/terminal-config#enable-option-key-shortcuts-on-macos) no macOS |

82| Shift+Enter | `Shift+Enter` | Nativo em iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal |82| Shift+Enter | `Shift+Enter` | Nativo em iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal |

83| Sequência de controle | `Ctrl+J` | Funciona em qualquer terminal sem configuração |83| Sequência de controle | `Ctrl+J` | Funciona em qualquer terminal sem configuração |

84| Modo de cola | Colar diretamente | Para blocos de código, logs |84| Modo de cola | Colar diretamente | Para blocos de código, logs |


93 93 

94| Atalho | Descrição | Notas |94| Atalho | Descrição | Notas |

95| :------------ | :--------------------------- | :----------------------------------------------------------------- |95| :------------ | :--------------------------- | :----------------------------------------------------------------- |

96| `/` no início | Comando ou skill | Veja [comandos](#commands) e [skills](/pt/skills) |96| `/` no início | Comando ou skill | Veja [comandos](#commands) e [skills](/docs/pt/skills) |

97| `!` no início | Modo Bash | Execute comandos diretamente e adicione saída de execução à sessão |97| `!` no início | Modo Bash | Execute comandos diretamente e adicione saída de execução à sessão |

98| `@` | Menção de caminho de arquivo | Ativar preenchimento automático de caminho de arquivo |98| `@` | Menção de caminho de arquivo | Ativar preenchimento automático de caminho de arquivo |

99 99 


101 Visualizador de transcrição101 Visualizador de transcrição

102</h3>102</h3>

103 103 

104Quando o visualizador de transcrição está aberto (alternado com `Ctrl+O`), estes atalhos estão disponíveis. Em [renderização em tela cheia](/pt/fullscreen), pressione `?` para mostrar o painel de referência de atalho de teclado completo dentro do visualizador. `Ctrl+E` pode ser reatribuído via [`transcript:toggleShowAll`](/pt/keybindings).104Quando o visualizador de transcrição está aberto (alternado com `Ctrl+O`), estes atalhos estão disponíveis. Em [renderização em tela cheia](/docs/pt/fullscreen), pressione `?` para mostrar o painel de referência de atalho de teclado completo dentro do visualizador. `Ctrl+E` pode ser reatribuído via [`transcript:toggleShowAll`](/docs/pt/keybindings).

105 105 

106| Atalho | Descrição |106| Atalho | Descrição |

107| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |107| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

108| `?` | Alternar o painel de ajuda de atalho de teclado. Requer [renderização em tela cheia](/pt/fullscreen) |108| `?` | Alternar o painel de ajuda de atalho de teclado. Requer [renderização em tela cheia](/docs/pt/fullscreen) |

109| `{` / `}` | Pular para o prompt do usuário anterior ou próximo, como movimento de parágrafo vim. Requer [renderização em tela cheia](/pt/fullscreen) |109| `{` / `}` | Pular para o prompt do usuário anterior ou próximo, como movimento de parágrafo vim. Requer [renderização em tela cheia](/docs/pt/fullscreen) |

110| `Ctrl+E` | Alternar mostrar todo o conteúdo |110| `Ctrl+E` | Alternar mostrar todo o conteúdo |

111| `[` | Escrever a conversa completa no scrollback nativo do seu terminal para que `Cmd+F`, modo de cópia do tmux e outras ferramentas nativas possam pesquisá-lo. Requer [renderização em tela cheia](/pt/fullscreen#search-and-review-the-conversation) |111| `[` | Escrever a conversa completa no scrollback nativo do seu terminal para que `Cmd+F`, modo de cópia do tmux e outras ferramentas nativas possam pesquisá-lo. Requer [renderização em tela cheia](/docs/pt/fullscreen#search-and-review-the-conversation) |

112| `v` | Escrever a conversa em um arquivo temporário e abri-lo em `$VISUAL` ou `$EDITOR`. Requer [renderização em tela cheia](/pt/fullscreen) |112| `v` | Escrever a conversa em um arquivo temporário e abri-lo em `$VISUAL` ou `$EDITOR`. Requer [renderização em tela cheia](/docs/pt/fullscreen) |

113| `q`, `Ctrl+C`, `Esc` | Sair da visualização de transcrição. Todos os três podem ser reatribuídos via [`transcript:exit`](/pt/keybindings) |113| `q`, `Ctrl+C`, `Esc` | Sair da visualização de transcrição. Todos os três podem ser reatribuídos via [`transcript:exit`](/docs/pt/keybindings) |

114 114 

115<h3 id="voice-input">115<h3 id="voice-input">

116 Entrada de voz116 Entrada de voz


118 118 

119| Atalho | Descrição | Notas |119| Atalho | Descrição | Notas |

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

121| Manter ou tocar `Space` | Ditação de voz | Requer que [ditação de voz](/pt/voice-dictation) esteja ativada. Mantenha pressionado para gravar, ou execute `/voice tap` para alternância por toque. [Reatribuível](/pt/voice-dictation#rebind-the-dictation-key) |121| Manter ou tocar `Space` | Ditação de voz | Requer que [ditação de voz](/docs/pt/voice-dictation) esteja ativada. Mantenha pressionado para gravar, ou execute `/voice tap` para alternância por toque. [Reatribuível](/docs/pt/voice-dictation#rebind-the-dictation-key) |

122 122 

123<h2 id="commands">123<h2 id="commands">

124 Comandos124 Comandos

125</h2>125</h2>

126 126 

127Digite `/` no Claude Code para ver todos os comandos disponíveis, ou digite `/` seguido de qualquer letra para filtrar. O menu `/` mostra tudo que você pode invocar: comandos integrados, [skills](/pt/skills) agrupados e criados por usuários, e comandos contribuídos por [plugins](/pt/plugins) e [servidores MCP](/pt/mcp#use-mcp-prompts-as-commands). Nem todos os comandos integrados são visíveis para todos os usuários, pois alguns dependem de sua plataforma ou plano.127Digite `/` no Claude Code para ver todos os comandos disponíveis, ou digite `/` seguido de qualquer letra para filtrar. O menu `/` mostra tudo que você pode invocar: comandos integrados, [skills](/docs/pt/skills) agrupados e criados por usuários, e comandos contribuídos por [plugins](/docs/pt/plugins) e [servidores MCP](/docs/pt/mcp#use-mcp-prompts-as-commands). Nem todos os comandos integrados são visíveis para todos os usuários, pois alguns dependem de sua plataforma ou plano.

128 128 

129Na [renderização em tela cheia](/pt/fullscreen#use-the-mouse), o comando `/` e as listas de sugestão de arquivo `@` também respondem ao mouse: passar o mouse destaca uma linha e clicar a aceita.129Na [renderização em tela cheia](/docs/pt/fullscreen#use-the-mouse), o comando `/` e as listas de sugestão de arquivo `@` também respondem ao mouse: passar o mouse destaca uma linha e clicar a aceita.

130 130 

131Veja a [referência de comandos](/pt/commands) para a lista completa de comandos incluídos no Claude Code.131Veja a [referência de comandos](/docs/pt/commands) para a lista completa de comandos incluídos no Claude Code.

132 132 

133<h2 id="vim-editor-mode">133<h2 id="vim-editor-mode">

134 Modo editor Vim134 Modo editor Vim


156 Remapear sequências de teclas no modo INSERT156 Remapear sequências de teclas no modo INSERT

157</h3>157</h3>

158 158 

159A configuração [`vimInsertModeRemaps`](/pt/settings#available-settings) mapeia uma sequência de duas teclas no modo INSERT para Escape, então um mapeamento como `jj` o retorna ao modo NORMAL. {/* min-version: 2.1.208 */}Requer Claude Code v2.1.208 ou posterior.159A configuração [`vimInsertModeRemaps`](/docs/pt/settings#available-settings) mapeia uma sequência de duas teclas no modo INSERT para Escape, então um mapeamento como `jj` o retorna ao modo NORMAL. Requer Claude Code v2.1.208 ou posterior.

160 160 

161O seguinte exemplo de `~/.claude/settings.json` ativa o modo vim e mapeia `jj` para Escape:161O seguinte exemplo de `~/.claude/settings.json` ativa o modo vim e mapeia `jj` para Escape:

162 162 


171 171 

172Digitar o primeiro caractere de uma sequência o insere normalmente. Pressionar o segundo caractere dentro de um segundo remove esse caractere pendente e muda para o modo NORMAL, deixando nenhum caractere em sua entrada. Após a janela de um segundo, ou se uma chave diferente seguir, ambos os caracteres permanecem como texto literal, então você ainda pode digitar uma palavra contendo a sequência pausando entre as duas teclas.172Digitar o primeiro caractere de uma sequência o insere normalmente. Pressionar o segundo caractere dentro de um segundo remove esse caractere pendente e muda para o modo NORMAL, deixando nenhum caractere em sua entrada. Após a janela de um segundo, ou se uma chave diferente seguir, ambos os caracteres permanecem como texto literal, então você ainda pode digitar uma palavra contendo a sequência pausando entre as duas teclas.

173 173 

174Claude Code lê essa configuração do seu arquivo de configurações do usuário, da flag `--settings` e de [configurações gerenciadas](/pt/permissions#managed-settings) apenas. Entradas no `.claude/settings.json` ou `.claude/settings.local.json` de um projeto são ignoradas, então um repositório verificado não pode remapear seus pressionamentos de tecla.174Claude Code lê essa configuração do seu arquivo de configurações do usuário, da flag `--settings` e de [configurações gerenciadas](/docs/pt/permissions#managed-settings) apenas. Entradas no `.claude/settings.json` ou `.claude/settings.local.json` de um projeto são ignoradas, então um repositório verificado não pode remapear seus pressionamentos de tecla.

175 175 

176<h3 id="navigation-normal-mode">176<h3 id="navigation-normal-mode">

177 Navegação (modo NORMAL)177 Navegação (modo NORMAL)

178</h3>178</h3>

179 179 

180| Comando | Ação |180| Comando | Ação |

181| :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |181| :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

182| `h`/`j`/`k`/`l` | Mover esquerda/baixo/cima/direita |182| `h`/`j`/`k`/`l` | Mover esquerda/baixo/cima/direita |

183| `Space` | Mover para a direita |183| `Space` | Mover para a direita |

184| `w` | Próxima palavra |184| `w` | Próxima palavra |


195| `T{char}` | Pular para logo após a ocorrência anterior do caractere |195| `T{char}` | Pular para logo após a ocorrência anterior do caractere |

196| `;` | Repetir último movimento f/F/t/T |196| `;` | Repetir último movimento f/F/t/T |

197| `,` | Repetir último movimento f/F/t/T em reverso |197| `,` | Repetir último movimento f/F/t/T em reverso |

198| `/` | Abrir busca de histórico reverso, igual a `Ctrl+R`. {/* min-version: 2.1.191 */}A partir da v2.1.191, o prompt de busca vazio mostra uma dica: pressione `Esc` depois `i` depois `/` para abrir o menu de comandos |198| `/` | Abrir busca de histórico reverso, igual a `Ctrl+R`. A partir da v2.1.191, o prompt de busca vazio mostra uma dica: pressione `Esc` depois `i` depois `/` para abrir o menu de comandos |

199 199 

200<Note>200<Note>

201 No modo normal vim, se o cursor estiver no início ou final da entrada e não puder se mover mais, `j`/`k` e as setas de navegação navegam pelo histórico de comandos.201 No modo normal vim, se o cursor estiver no início ou final da entrada e não puder se mover mais, `j`/`k` e as setas de navegação navegam pelo histórico de comandos.


316 316 

317* A saída é escrita em um arquivo e Claude pode recuperá-la usando a ferramenta Read317* A saída é escrita em um arquivo e Claude pode recuperá-la usando a ferramenta Read

318* Tarefas em segundo plano têm IDs únicos para rastreamento e recuperação de saída318* Tarefas em segundo plano têm IDs únicos para rastreamento e recuperação de saída

319* Tarefas em segundo plano são limpas automaticamente quando Claude Code sai. Colocar a sessão em segundo plano em vez de sair entrega-as à sessão em segundo plano, onde continuam sendo executadas. Veja [colocar uma sessão em execução em segundo plano](/pt/agent-view#from-inside-a-session)319* Tarefas em segundo plano são limpas automaticamente quando Claude Code sai. Colocar a sessão em segundo plano em vez de sair entrega-as à sessão em segundo plano, onde continuam sendo executadas. Veja [colocar uma sessão em execução em segundo plano](/docs/pt/agent-view#from-inside-a-session)

320* Tarefas em segundo plano são automaticamente encerradas se a saída exceder 5GB, com uma nota em stderr explicando o motivo320* Tarefas em segundo plano são automaticamente encerradas se a saída exceder 5GB, com uma nota em stderr explicando o motivo

321* {/* min-version: 2.1.193 */}A partir da v2.1.193, em macOS e Linux, tarefas em segundo plano em execução são encerradas quando o sistema operacional sinaliza pressão de memória, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos sem nenhuma volta ou subagente em execução. Defina [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/pt/env-vars) para `1` para desativar isso321* A partir da v2.1.193, em macOS e Linux, tarefas em segundo plano em execução são encerradas quando o sistema operacional sinaliza pressão de memória, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos sem nenhuma volta ou subagente em execução. Defina [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/pt/env-vars) para `1` para desativar isso

322 322 

323Para desabilitar toda a funcionalidade de tarefa em segundo plano, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` para `1`. Veja [Variáveis de ambiente](/pt/env-vars) para detalhes.323Para desabilitar toda a funcionalidade de tarefa em segundo plano, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` para `1`. Veja [Variáveis de ambiente](/docs/pt/env-vars) para detalhes.

324 324 

325**Comandos comuns em segundo plano:**325**Comandos comuns em segundo plano:**

326 326 


349* Suporta o mesmo segundo plano `Ctrl+B` para comandos de longa duração349* Suporta o mesmo segundo plano `Ctrl+B` para comandos de longa duração

350* Não requer que Claude interprete ou aprove o comando350* Não requer que Claude interprete ou aprove o comando

351* Suporta preenchimento automático baseado em histórico: digite um comando parcial e pressione `Tab` para completar a partir de comandos `!` anteriores no projeto atual351* Suporta preenchimento automático baseado em histórico: digite um comando parcial e pressione `Tab` para completar a partir de comandos `!` anteriores no projeto atual

352* {/* min-version: 2.1.193 */}Suporta preenchimento automático de caminho de arquivo ao vivo a partir da v2.1.193 em todas as plataformas: digite um token contendo uma barra invertida, como `./src/` ou `~/`, para ver uma lista suspensa de arquivos e diretórios correspondentes, depois pressione `Tab` para aceitar. Use barras invertidas no Windows também; a lista suspensa é acionada por `/`, não `\`352* Suporta preenchimento automático de caminho de arquivo ao vivo a partir da v2.1.193 em todas as plataformas: digite um token contendo uma barra invertida, como `./src/` ou `~/`, para ver uma lista suspensa de arquivos e diretórios correspondentes, depois pressione `Tab` para aceitar. Use barras invertidas no Windows também; a lista suspensa é acionada por `/`, não `\`

353* Saia com `Escape`, `Backspace` ou `Ctrl+U` em um prompt vazio353* Saia com `Escape`, `Backspace` ou `Ctrl+U` em um prompt vazio

354* Colar texto que começa com `!` em um prompt vazio entra no modo shell automaticamente, correspondendo ao comportamento digitado `!`354* Colar texto que começa com `!` em um prompt vazio entra no modo shell automaticamente, correspondendo ao comportamento digitado `!`

355 355 

356A partir da v2.1.186, Claude responde à saída do comando automaticamente assim que ela chega à transcrição, para que você possa executar `! npm test` e obter uma explicação das falhas sem um segundo prompt. A resposta custa o mesmo que enviar um prompt normal. Para restaurar o comportamento anterior onde a saída é adicionada ao contexto sem uma resposta, defina [`respondToBashCommands`](/pt/settings#available-settings) para `false` em `settings.json`. Antes da v2.1.186, o modo shell sempre adicionava saída ao contexto sem uma resposta.356A partir da v2.1.186, Claude responde à saída do comando automaticamente assim que ela chega à transcrição, para que você possa executar `! npm test` e obter uma explicação das falhas sem um segundo prompt. A resposta custa o mesmo que enviar um prompt normal. Para restaurar o comportamento anterior onde a saída é adicionada ao contexto sem uma resposta, defina [`respondToBashCommands`](/docs/pt/settings#available-settings) para `false` em `settings.json`. Antes da v2.1.186, o modo shell sempre adicionava saída ao contexto sem uma resposta.

357 357 

358Isto é útil para operações rápidas de shell mantendo contexto de conversa.358Isto é útil para operações rápidas de shell mantendo contexto de conversa.

359 359 


370 370 

371A sugestão é executada como uma solicitação em segundo plano que reutiliza o cache de prompt da conversa pai, então o custo adicional é mínimo. Claude Code pula a geração de sugestão quando o cache está frio para evitar custo desnecessário.371A sugestão é executada como uma solicitação em segundo plano que reutiliza o cache de prompt da conversa pai, então o custo adicional é mínimo. Claude Code pula a geração de sugestão quando o cache está frio para evitar custo desnecessário.

372 372 

373As sugestões são automaticamente puladas após a primeira volta de uma conversa e em plan mode. No modo de impressão, elas estão desativadas por padrão. Passe [`--prompt-suggestions`](/pt/cli-reference#cli-flags) com `--output-format stream-json --verbose` para emitir uma mensagem `prompt_suggestion` após cada volta.373As sugestões são automaticamente puladas após a primeira volta de uma conversa e em plan mode. No modo de impressão, elas estão desativadas por padrão. Passe [`--prompt-suggestions`](/docs/pt/cli-reference#cli-flags) com `--output-format stream-json --verbose` para emitir uma mensagem `prompt_suggestion` após cada volta.

374 374 

375Para desabilitar sugestões de prompt inteiramente, defina a variável de ambiente ou alterne a configuração em `/config`:375Para desabilitar sugestões de prompt inteiramente, defina a variável de ambiente ou alterne a configuração em `/config`:

376 376 


403| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |403| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

404| `Space`, `Enter`, `Escape` | Descartar a resposta e retornar ao prompt |404| `Space`, `Enter`, `Escape` | Descartar a resposta e retornar ao prompt |

405| `Up` / `Down` | Rolar a resposta |405| `Up` / `Down` | Rolar a resposta |

406| `Left` / `Right` | {/* min-version: 2.1.187 */}Alternar entre esta resposta e suas respostas anteriores de `/btw` da sessão. `Left` move para respostas mais antigas e `Right` retorna para a atual. Requer Claude Code v2.1.187 ou posterior |406| `Left` / `Right` | Alternar entre esta resposta e suas respostas anteriores de `/btw` da sessão. `Left` move para respostas mais antigas e `Right` retorna para a atual. Requer Claude Code v2.1.187 ou posterior |

407| `c` | Copiar a resposta para sua área de transferência como Markdown bruto. Use isto em vez de seleção com mouse, que captura a renderização do terminal com quebra de linha rígida em vez do texto de origem |407| `c` | Copiar a resposta para sua área de transferência como Markdown bruto. Use isto em vez de seleção com mouse, que captura a renderização do terminal com quebra de linha rígida em vez do texto de origem |

408| `f` | Dividir em uma nova sessão. A divisão herda a conversa pai mais esta pergunta e resposta como voltas de transcrição reais, então você pode continuar com acesso completo a ferramentas. A sessão original é preservada em [`/resume`](/pt/commands). Disponível apenas em sessões locais |408| `f` | Dividir em uma nova sessão. A divisão herda a conversa pai mais esta pergunta e resposta como voltas de transcrição reais, então você pode continuar com acesso completo a ferramentas. A sessão original é preservada em [`/resume`](/docs/pt/commands). Disponível apenas em sessões locais |

409| `x` | Limpar a lista de trocas `/btw` anteriores mostradas acima da resposta atual |409| `x` | Limpar a lista de trocas `/btw` anteriores mostradas acima da resposta atual |

410 410 

411`/btw` é o inverso de um [subagent](/pt/sub-agents): vê sua conversa completa mas não tem ferramentas, enquanto um subagent tem ferramentas completas mas começa com contexto vazio. Use `/btw` para perguntar sobre o que Claude já sabe desta sessão; use um subagent para descobrir algo novo.411`/btw` é o inverso de um [subagent](/docs/pt/sub-agents): vê sua conversa completa mas não tem ferramentas, enquanto um subagent tem ferramentas completas mas começa com contexto vazio. Use `/btw` para perguntar sobre o que Claude já sabe desta sessão; use um subagent para descobrir algo novo.

412 412 

413<h2 id="task-list">413<h2 id="task-list">

414 Lista de tarefas414 Lista de tarefas

415</h2>415</h2>

416 416 

417A lista de tarefas é a lista de verificação de Claude: itens que Claude criou para planejar trabalho em várias etapas, com indicadores mostrando o que está pendente, em progresso ou completo. É separada da visualização de tarefa em segundo plano. Para ver shells em execução e subagentes, use [`/tasks`](/pt/commands) em vez disso.417A lista de tarefas é a lista de verificação de Claude: itens que Claude criou para planejar trabalho em várias etapas, com indicadores mostrando o que está pendente, em progresso ou completo. É separada da visualização de tarefa em segundo plano. Para ver shells em execução e subagentes, use [`/tasks`](/docs/pt/commands) em vez disso.

418 418 

419* Pressione `Ctrl+T` para alternar a visualização da lista de tarefas. A exibição mostra até cinco tarefas por vez. Quando Claude ainda não criou nenhum item de lista de verificação, o alternador não tem efeito visível porque não há nada para exibir419* Pressione `Ctrl+T` para alternar a visualização da lista de tarefas. A exibição mostra até cinco tarefas por vez. Quando Claude ainda não criou nenhum item de lista de verificação, o alternador não tem efeito visível porque não há nada para exibir

420* Para ver todas as tarefas ou limpá-las, peça ao Claude diretamente: "show me all tasks" ou "clear all tasks"420* Para ver todas as tarefas ou limpá-las, peça ao Claude diretamente: "show me all tasks" ou "clear all tasks"


452 Veja também452 Veja também

453</h2>453</h2>

454 454 

455* [Skills](/pt/skills) - Prompts e fluxos de trabalho personalizados455* [Skills](/docs/pt/skills) - Prompts e fluxos de trabalho personalizados

456* [Checkpointing](/pt/checkpointing) - Retroceder edições do Claude e restaurar estados anteriores456* [Checkpointing](/docs/pt/checkpointing) - Retroceder edições do Claude e restaurar estados anteriores

457* [Referência CLI](/pt/cli-reference) - Sinalizadores e opções de linha de comando457* [Referência CLI](/docs/pt/cli-reference) - Sinalizadores e opções de linha de comando

458* [Configurações](/pt/settings) - Opções de configuração458* [Configurações](/docs/pt/settings) - Opções de configuração

459* [Gerenciamento de memória](/pt/memory) - Gerenciando arquivos CLAUDE.md459* [Gerenciamento de memória](/docs/pt/memory) - Gerenciando arquivos CLAUDE.md

keybindings.md +12 −12

Details

68| `Plugin` | Diálogo de plugin (procurar, descobrir, gerenciar) |68| `Plugin` | Diálogo de plugin (procurar, descobrir, gerenciar) |

69| `Scroll` | Rolagem de conversa e seleção de texto em modo tela cheia |69| `Scroll` | Rolagem de conversa e seleção de texto em modo tela cheia |

70 70 

71{/* max-version: 2.1.204 */}Antes da v2.1.205, um contexto `Doctor` e uma ação `doctor:fix` existiam para a tela de diagnósticos `/doctor`.71Antes da v2.1.205, um contexto `Doctor` e uma ação `doctor:fix` existiam para a tela de diagnósticos `/doctor`.

72 72 

73<h2 id="available-actions">73<h2 id="available-actions">

74 Ações disponíveis74 Ações disponíveis


87| `app:interrupt` | Ctrl+C | Cancelar operação atual |87| `app:interrupt` | Ctrl+C | Cancelar operação atual |

88| `app:exit` | Ctrl+D | Sair do Claude Code |88| `app:exit` | Ctrl+D | Sair do Claude Code |

89| `app:redraw` | (desvinculado) | Forçar redesenho do terminal |89| `app:redraw` | (desvinculado) | Forçar redesenho do terminal |

90| `app:toggleTodos` | Ctrl+T | Alternar visibilidade da lista de tarefas do Claude. Esta não é a visualização de tarefa em segundo plano [`/tasks`](/pt/commands) |90| `app:toggleTodos` | Ctrl+T | Alternar visibilidade da lista de tarefas do Claude. Esta não é a visualização de tarefa em segundo plano [`/tasks`](/docs/pt/commands) |

91| `app:toggleTranscript` | Ctrl+O | Alternar transcrição detalhada |91| `app:toggleTranscript` | Ctrl+O | Alternar transcrição detalhada |

92 92 

93<h3 id="history-actions">93<h3 id="history-actions">


111| Ação | Padrão | Descrição |111| Ação | Padrão | Descrição |

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

113| `chat:cancel` | Escape | Cancelar entrada atual |113| `chat:cancel` | Escape | Cancelar entrada atual |

114| `chat:clearInput` | Ctrl+L | Forçar um redesenho de tela cheia, preservando a entrada. Na [renderização em tela cheia](/pt/fullscreen#clear-the-conversation), pressione duas vezes em dois segundos para executar `/clear` |114| `chat:clearInput` | Ctrl+L | Forçar um redesenho de tela cheia, preservando a entrada. Na [renderização em tela cheia](/docs/pt/fullscreen#clear-the-conversation), pressione duas vezes em dois segundos para executar `/clear` |

115| `chat:clearScreen` | Cmd+K | Na [renderização em tela cheia](/pt/fullscreen#clear-the-conversation), pressione duas vezes em dois segundos para executar `/clear` |115| `chat:clearScreen` | Cmd+K | Na [renderização em tela cheia](/docs/pt/fullscreen#clear-the-conversation), pressione duas vezes em dois segundos para executar `/clear` |

116| `chat:killAgents` | Ctrl+X Ctrl+K | Encerrar todos os [subagentes em segundo plano](/pt/sub-agents#run-subagents-in-foreground-or-background) nesta sessão |116| `chat:killAgents` | Ctrl+X Ctrl+K | Encerrar todos os [subagentes em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) nesta sessão |

117| `chat:cycleMode` | Shift+Tab\* | Ciclar modos de permissão |117| `chat:cycleMode` | Shift+Tab\* | Ciclar modos de permissão |

118| `chat:modelPicker` | Meta+P | Abrir seletor de modelo |118| `chat:modelPicker` | Meta+P | Abrir seletor de modelo |

119| `chat:fastMode` | Meta+O | Alternar modo rápido |119| `chat:fastMode` | Meta+O | Alternar modo rápido |


156| `confirm:previousField` | (desvinculado) | Campo anterior |156| `confirm:previousField` | (desvinculado) | Campo anterior |

157| `confirm:toggle` | Space | Alternar seleção |157| `confirm:toggle` | Space | Alternar seleção |

158| `confirm:cycleMode` | Shift+Tab | Ciclar modos de permissão |158| `confirm:cycleMode` | Shift+Tab | Ciclar modos de permissão |

159| `confirm:toggleExplanation` | Ctrl+E | Alternar uma [explicação gerada por modelo do comando](/pt/permissions#permission-system) em prompts de permissão Bash e PowerShell |159| `confirm:toggleExplanation` | Ctrl+E | Alternar uma [explicação gerada por modelo do comando](/docs/pt/permissions#permission-system) em prompts de permissão Bash e PowerShell |

160 160 

161<h3 id="permission-actions">161<h3 id="permission-actions">

162 Ações de permissão162 Ações de permissão


200Ações disponíveis no contexto `Task`:200Ações disponíveis no contexto `Task`:

201 201 

202| Ação | Padrão | Descrição |202| Ação | Padrão | Descrição |

203| :---------------- | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |203| :---------------- | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

204| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Colocar tarefa atual em segundo plano. {/* min-version: 2.1.169 */}O acorde Ctrl+X Ctrl+B requer v2.1.169 ou posterior e evita o conflito de prefixo do tmux |204| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Colocar tarefa atual em segundo plano. O acorde Ctrl+X Ctrl+B requer v2.1.169 ou posterior e evita o conflito de prefixo do tmux |

205 205 

206<h3 id="theme-actions">206<h3 id="theme-actions">

207 Ações de tema207 Ações de tema


357 Ações de voz357 Ações de voz

358</h3>358</h3>

359 359 

360Ações disponíveis no contexto `Chat` quando a [ditação por voz](/pt/voice-dictation) está ativada:360Ações disponíveis no contexto `Chat` quando a [ditação por voz](/docs/pt/voice-dictation) está ativada:

361 361 

362| Ação | Padrão | Descrição |362| Ação | Padrão | Descrição |

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


367 Ações de rolagem367 Ações de rolagem

368</h3>368</h3>

369 369 

370Ações disponíveis no contexto `Scroll` quando a [renderização em tela cheia](/pt/fullscreen) está ativada:370Ações disponíveis no contexto `Scroll` quando a [renderização em tela cheia](/docs/pt/fullscreen) está ativada:

371 371 

372| Ação | Padrão | Descrição |372| Ação | Padrão | Descrição |

373| :-------------------------- | :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |373| :-------------------------- | :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |


526* **Atalhos de teclado** manipulam ações no nível de componente (alternar tarefas, enviar, etc.)526* **Atalhos de teclado** manipulam ações no nível de componente (alternar tarefas, enviar, etc.)

527* A tecla Escape no modo vim muda INSERT para NORMAL; ela não dispara `chat:cancel`527* A tecla Escape no modo vim muda INSERT para NORMAL; ela não dispara `chat:cancel`

528* A maioria dos atalhos Ctrl+key passam pelo modo vim para o sistema de atalhos de teclado528* A maioria dos atalhos Ctrl+key passam pelo modo vim para o sistema de atalhos de teclado

529* As chaves vim não são remapeáveis através do arquivo de atalhos de teclado. Para mapear uma sequência de dois-key no modo INSERT como `jj` para Escape, use a configuração [`vimInsertModeRemaps`](/pt/interactive-mode#remap-insert-mode-key-sequences)529* As chaves vim não são remapeáveis através do arquivo de atalhos de teclado. Para mapear uma sequência de dois-key no modo INSERT como `jj` para Escape, use a configuração [`vimInsertModeRemaps`](/docs/pt/interactive-mode#remap-insert-mode-key-sequences)

530* No modo NORMAL do vim, `?` mostra o menu de ajuda (comportamento vim)530* No modo NORMAL do vim, `?` mostra o menu de ajuda (comportamento vim)

531* No modo NORMAL do vim, `/` abre a busca de histórico, o mesmo que Ctrl+R no modo padrão531* No modo NORMAL do vim, `/` abre a busca de histórico, o mesmo que Ctrl+R no modo padrão

532 532 


542* Conflitos de multiplexador de terminal542* Conflitos de multiplexador de terminal

543* Vinculações duplicadas no mesmo contexto543* Vinculações duplicadas no mesmo contexto

544 544 

545Claude Code relata avisos quando o arquivo é carregado e escreve cada um no log de depuração. Inicie Claude Code com [`--debug`](/pt/cli-reference#cli-flags) para ver os detalhes.545Claude Code relata avisos quando o arquivo é carregado e escreve cada um no log de depuração. Inicie Claude Code com [`--debug`](/docs/pt/cli-reference#cli-flags) para ver os detalhes.

Details

6 6 

7> Aponte Claude Code para o gateway LLM da sua organização. Verifique se seu administrador já o configurou ou defina a URL base e a credencial você mesmo, depois verifique a conexão e corrija erros do gateway.7> Aponte Claude Code para o gateway LLM da sua organização. Verifique se seu administrador já o configurou ou defina a URL base e a credencial você mesmo, depois verifique a conexão e corrija erros do gateway.

8 8 

9Um [gateway LLM](/pt/llm-gateway) é um proxy que sua organização executa entre Claude Code e o provedor de modelo. Quando sua organização usa um, Claude Code se autentica no gateway com uma credencial que sua organização emite em vez de seu login pessoal claude.ai.9Um [gateway LLM](/docs/pt/llm-gateway) é um proxy que sua organização executa entre Claude Code e o provedor de modelo. Quando sua organização usa um, Claude Code se autentica no gateway com uma credencial que sua organização emite em vez de seu login pessoal claude.ai.

10 10 

11Esta página é para desenvolvedores que executam Claude Code através de um gateway que sua organização opera. Ela cobre dois caminhos: [verificar se seu administrador já o configurou para você](#check-for-an-existing-configuration) e [configurá-lo você mesmo](#configure-claude-code-yourself) quando não tiverem.11Esta página é para desenvolvedores que executam Claude Code através de um gateway que sua organização opera. Ela cobre dois caminhos: [verificar se seu administrador já o configurou para você](#check-for-an-existing-configuration) e [configurá-lo você mesmo](#configure-claude-code-yourself) quando não tiverem.

12 12 

13<Note>13<Note>

14 * Para implantar um gateway para sua organização, consulte [Implementar um gateway LLM](/pt/llm-gateway-rollout)14 * Para implantar um gateway para sua organização, consulte [Implementar um gateway LLM](/docs/pt/llm-gateway-rollout)

15 * Para saber o que Claude Code envia para um gateway, consulte a [referência do protocolo do gateway](/pt/llm-gateway-protocol)15 * Para saber o que Claude Code envia para um gateway, consulte a [referência do protocolo do gateway](/docs/pt/llm-gateway-protocol)

16</Note>16</Note>

17 17 

18<h2 id="check-for-an-existing-configuration">18<h2 id="check-for-an-existing-configuration">

19 Verificar uma configuração existente19 Verificar uma configuração existente

20</h2>20</h2>

21 21 

22Os administradores podem distribuir o endereço do gateway e a credencial através de [configurações gerenciadas](/pt/settings#settings-files), gerenciamento de dispositivos ou um [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper), para que Claude Code os pegue na inicialização sem nada para você configurar. Para verificar se sua organização já fez isso:22Os administradores podem distribuir o endereço do gateway e a credencial através de [configurações gerenciadas](/docs/pt/settings#settings-files), gerenciamento de dispositivos ou um [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper), para que Claude Code os pegue na inicialização sem nada para você configurar. Para verificar se sua organização já fez isso:

23 23 

24<Steps>24<Steps>

25 <Step title="Iniciar Claude Code">25 <Step title="Iniciar Claude Code">


107 Definir em um arquivo de configurações107 Definir em um arquivo de configurações

108</h4>108</h4>

109 109 

110Para fazer a configuração se aplicar em todos os lugares onde Claude Code é executado sem depender do seu shell, defina as variáveis no bloco `env` de um [arquivo de configurações](/pt/settings). Os arquivos de configurações têm escopos diferentes:110Para fazer a configuração se aplicar em todos os lugares onde Claude Code é executado sem depender do seu shell, defina as variáveis no bloco `env` de um [arquivo de configurações](/docs/pt/settings). Os arquivos de configurações têm escopos diferentes:

111 111 

112* `~/.claude/settings.json` se aplica a todos os seus projetos. No Windows, o caminho é `%USERPROFILE%\.claude\settings.json`112* `~/.claude/settings.json` se aplica a todos os seus projetos. No Windows, o caminho é `%USERPROFILE%\.claude\settings.json`

113* `.claude/settings.local.json` se aplica a um projeto. Claude Code o adiciona ao seu gitignore quando cria o arquivo; se você o criar você mesmo, adicione-o ao seu gitignore manualmente primeiro para não cometer acidentalmente sua credencial113* `.claude/settings.local.json` se aplica a um projeto. Claude Code o adiciona ao seu gitignore quando cria o arquivo; se você o criar você mesmo, adicione-o ao seu gitignore manualmente primeiro para não cometer acidentalmente sua credencial


194 Extensão VS Code194 Extensão VS Code

195</h3>195</h3>

196 196 

197Defina as variáveis de gateway para a [extensão VS Code](/pt/vs-code) em `claudeCode.environmentVariables`, nas próprias configurações do usuário do VS Code abertas com o comando **Preferences: Open User Settings (JSON)**. A extensão verifica credenciais dessa configuração antes de iniciar, então é o lugar confiável para a credencial de gateway; valores em `~/.claude/settings.json` chegam ao processo gerado, mas não à verificação de login da própria extensão.197Defina as variáveis de gateway para a [extensão VS Code](/docs/pt/vs-code) em `claudeCode.environmentVariables`, nas próprias configurações do usuário do VS Code abertas com o comando **Preferences: Open User Settings (JSON)**. A extensão verifica credenciais dessa configuração antes de iniciar, então é o lugar confiável para a credencial de gateway; valores em `~/.claude/settings.json` chegam ao processo gerado, mas não à verificação de login da própria extensão.

198 198 

199```json theme={null}199```json theme={null}

200{200{


211 211 

212O aplicativo desktop lê o roteamento de gateway de sua [configuração de inferência de terceiros](https://claude.com/docs/third-party/claude-desktop/gateway), não de `ANTHROPIC_BASE_URL` ou `settings.json`. Essa configuração pode vir de sua organização ou de um formulário no próprio aplicativo:212O aplicativo desktop lê o roteamento de gateway de sua [configuração de inferência de terceiros](https://claude.com/docs/third-party/claude-desktop/gateway), não de `ANTHROPIC_BASE_URL` ou `settings.json`. Essa configuração pode vir de sua organização ou de um formulário no próprio aplicativo:

213 213 

214* **Distribuído por um administrador**: se sua organização [implantou a configuração](/pt/llm-gateway-rollout#distribute-through-managed-settings), o aplicativo desktop roteia através do gateway sem nenhuma configuração de sua parte214* **Distribuído por um administrador**: se sua organização [implantou a configuração](/docs/pt/llm-gateway-rollout#distribute-through-managed-settings), o aplicativo desktop roteia através do gateway sem nenhuma configuração de sua parte

215* **Configurado localmente**: para dispositivos sem uma configuração distribuída por administrador, abra Help → Troubleshooting → Enable Developer Mode, que reinicia o aplicativo com um menu Developer. Em seguida, abra Developer → Configure Third-Party Inference e insira a URL base do seu gateway. Uma configuração distribuída por administrador tem precedência e torna esse formulário somente leitura215* **Configurado localmente**: para dispositivos sem uma configuração distribuída por administrador, abra Help → Troubleshooting → Enable Developer Mode, que reinicia o aplicativo com um menu Developer. Em seguida, abra Developer → Configure Third-Party Inference e insira a URL base do seu gateway. Uma configuração distribuída por administrador tem precedência e torna esse formulário somente leitura

216 216 

217Com a configuração de gateway ativa, o aplicativo desktop executa sessões apenas em sua máquina local: o seletor de ambiente não oferece sessões SSH ou ambientes em nuvem hospedados pela Anthropic, e [Remote Control](/pt/remote-control) não está disponível. Para usar Claude Code em um host remoto através do gateway, execute o CLI nesse host com [`ANTHROPIC_BASE_URL` e a credencial de gateway](#set-the-base-url-and-credential) definidos lá.217Com a configuração de gateway ativa, o aplicativo desktop executa sessões apenas em sua máquina local: o seletor de ambiente não oferece sessões SSH ou ambientes em nuvem hospedados pela Anthropic, e [Remote Control](/docs/pt/remote-control) não está disponível. Para usar Claude Code em um host remoto através do gateway, execute o CLI nesse host com [`ANTHROPIC_BASE_URL` e a credencial de gateway](#set-the-base-url-and-credential) definidos lá.

218 218 

219Se o aplicativo desktop mostrar `Gateway was unreachable`, o aplicativo não conseguiu alcançar a URL base configurada na inicialização; verifique a URL e o caminho de rede com o [teste curl acima](#verify-the-connection).219Se o aplicativo desktop mostrar `Gateway was unreachable`, o aplicativo não conseguiu alcançar a URL base configurada na inicialização; verifique a URL e o caminho de rede com o [teste curl acima](#verify-the-connection).

220 220 


222 GitHub Actions222 GitHub Actions

223</h3>223</h3>

224 224 

225[Claude Code GitHub Actions](/pt/github-actions) lê `ANTHROPIC_BASE_URL` e `ANTHROPIC_CUSTOM_HEADERS` do bloco `env` do workflow. Passe a credencial como a entrada `anthropic_api_key` da ação; a ação a define como `ANTHROPIC_API_KEY`, para que chegue ao gateway no cabeçalho `x-api-key`.225[Claude Code GitHub Actions](/docs/pt/github-actions) lê `ANTHROPIC_BASE_URL` e `ANTHROPIC_CUSTOM_HEADERS` do bloco `env` do workflow. Passe a credencial como a entrada `anthropic_api_key` da ação; a ação a define como `ANTHROPIC_API_KEY`, para que chegue ao gateway no cabeçalho `x-api-key`.

226 226 

227Para um gateway `x-api-key`, defina a URL base em `env` e passe a chave de gateway como a entrada:227Para um gateway `x-api-key`, defina a URL base em `env` e passe a chave de gateway como a entrada:

228 228 


249 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}249 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

250```250```

251 251 

252Para as outras opções de autenticação da ação, incluindo `CLAUDE_CODE_OAUTH_TOKEN` e federação de identidade de carga de trabalho, consulte [Claude Code GitHub Actions](/pt/github-actions) e o [README](https://github.com/anthropics/claude-code-action#readme) da ação.252Para as outras opções de autenticação da ação, incluindo `CLAUDE_CODE_OAUTH_TOKEN` e federação de identidade de carga de trabalho, consulte [Claude Code GitHub Actions](/docs/pt/github-actions) e o [README](https://github.com/anthropics/claude-code-action#readme) da ação.

253 253 

254<h3 id="agent-sdk">254<h3 id="agent-sdk">

255 Agent SDK255 Agent SDK

256</h3>256</h3>

257 257 

258O [Agent SDK](/pt/agent-sdk/overview) não tem opções específicas de gateway; ele passa variáveis de ambiente para o processo Claude Code que gera. Cada SDK aceita uma opção `env` que define o ambiente do processo gerado, e os SDKs TypeScript e Python o tratam de forma diferente:258O [Agent SDK](/docs/pt/agent-sdk/overview) não tem opções específicas de gateway; ele passa variáveis de ambiente para o processo Claude Code que gera. Cada SDK aceita uma opção `env` que define o ambiente do processo gerado, e os SDKs TypeScript e Python o tratam de forma diferente:

259 259 

260* TypeScript: o processo gerado herda o ambiente pai por padrão, mas definir `options.env` substitui o ambiente inteiramente. Espalhe `process.env` nele para manter suas variáveis de gateway.260* TypeScript: o processo gerado herda o ambiente pai por padrão, mas definir `options.env` substitui o ambiente inteiramente. Espalhe `process.env` nele para manter suas variáveis de gateway.

261* Python: `ClaudeAgentOptions(env=...)` mescla no topo do ambiente herdado, para que variáveis de gateway definidas no processo pai passem sem espalhar.261* Python: `ClaudeAgentOptions(env=...)` mescla no topo do ambiente herdado, para que variáveis de gateway definidas no processo pai passem sem espalhar.


288 Slack, web e Remote Control288 Slack, web e Remote Control

289</h3>289</h3>

290 290 

291[Claude Code no Slack](/pt/slack) e [Claude Code na web](/pt/claude-code-on-the-web) são produtos hospedados pela Anthropic que sempre usam a API da Anthropic; eles não fazem parte de uma implantação de gateway. Variáveis de gateway definidas na configuração de ambiente de uma sessão em nuvem não são aplicadas. Se seu tráfego deve permanecer no gateway, não ative essas superfícies para esses usuários.291[Claude Code no Slack](/docs/pt/slack) e [Claude Code na web](/docs/pt/claude-code-on-the-web) são produtos hospedados pela Anthropic que sempre usam a API da Anthropic; eles não fazem parte de uma implantação de gateway. Variáveis de gateway definidas na configuração de ambiente de uma sessão em nuvem não são aplicadas. Se seu tráfego deve permanecer no gateway, não ative essas superfícies para esses usuários.

292 292 

293[Remote Control](/pt/remote-control) e [ditado por voz](/pt/voice-dictation) ambos dependem de uma identidade claude.ai: Remote Control para emparelhar uma sessão ao vivo com sua conta e ditado por voz para alcançar o endpoint de transcrição claude.ai. Eles não estão disponíveis enquanto `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou um `apiKeyHelper` está ativo. {/* min-version: 2.1.196 */}A partir da v2.1.196, Remote Control também está desabilitado enquanto `ANTHROPIC_BASE_URL` aponta para um host não-Anthropic, então fazer login com claude.ai não é suficiente por si só.293[Remote Control](/docs/pt/remote-control) e [ditado por voz](/docs/pt/voice-dictation) ambos dependem de uma identidade claude.ai: Remote Control para emparelhar uma sessão ao vivo com sua conta e ditado por voz para alcançar o endpoint de transcrição claude.ai. Eles não estão disponíveis enquanto `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou um `apiKeyHelper` está ativo. A partir da v2.1.196, Remote Control também está desabilitado enquanto `ANTHROPIC_BASE_URL` aponta para um host não-Anthropic, então fazer login com claude.ai não é suficiente por si só.

294 294 

295Para restaurar qualquer um dos recursos, faça login com claude.ai e desdefina as variáveis de gateway que ele verifica. A seção Remote Control de `claude doctor` nomeia a variável de credencial a desdefir.295Para restaurar qualquer um dos recursos, faça login com claude.ai e desdefina as variáveis de gateway que ele verifica. A seção Remote Control de `claude doctor` nomeia a variável de credencial a desdefir.

296 296 


307 Enviar cabeçalhos adicionais307 Enviar cabeçalhos adicionais

308</h3>308</h3>

309 309 

310Alguns gateways roteiam ou marcam solicitações usando um cabeçalho personalizado além da credencial, por exemplo um identificador de locatário ou uma chave de roteamento. Para enviar um, defina [`ANTHROPIC_CUSTOM_HEADERS`](/pt/env-vars) com um par `Name: Value` por linha. O exemplo abaixo adiciona um cabeçalho de roteamento nomeado `X-Org-Route`:310Alguns gateways roteiam ou marcam solicitações usando um cabeçalho personalizado além da credencial, por exemplo um identificador de locatário ou uma chave de roteamento. Para enviar um, defina [`ANTHROPIC_CUSTOM_HEADERS`](/docs/pt/env-vars) com um par `Name: Value` por linha. O exemplo abaixo adiciona um cabeçalho de roteamento nomeado `X-Org-Route`:

311 311 

312<Tabs>312<Tabs>

313 <Tab title="Bash ou Zsh">313 <Tab title="Bash ou Zsh">


341 341 

342Ative-a se seu gateway serve nomes de modelo que não estão na lista integrada de Claude Code e você quer selecioná-los do seletor. Se os modelos integrados são o que você usa, você não precisa de descoberta; seu administrador também pode já ter ativado através de configurações gerenciadas.342Ative-a se seu gateway serve nomes de modelo que não estão na lista integrada de Claude Code e você quer selecioná-los do seletor. Se os modelos integrados são o que você usa, você não precisa de descoberta; seu administrador também pode já ter ativado através de configurações gerenciadas.

343 343 

344Para ativá-la, defina `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` em seu shell ou no bloco `env` de `~/.claude/settings.json`. A descoberta requer Claude Code v2.1.129 ou posterior. {/* min-version: 2.1.129 */}344Para ativá-la, defina `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` em seu shell ou no bloco `env` de `~/.claude/settings.json`. A descoberta requer Claude Code v2.1.129 ou posterior.&#x20;

345 345 

346Os modelos descobertos aparecem como entradas `/model` adicionais rotuladas `From gateway`. Para confirmar que a descoberta foi executada, inicie `claude --debug` e procure pelas linhas `[gatewayDiscovery]`: um sucesso registra quantos modelos foram armazenados em cache, e um `404`, timeout ou redirecionamento é registrado lá também. Para quando a descoberta é executada, o que ela filtra e o formato de resposta que os gateways servem, consulte a [referência de descoberta de modelo](/pt/llm-gateway-protocol#model-discovery).346Os modelos descobertos aparecem como entradas `/model` adicionais rotuladas `From gateway`. Para confirmar que a descoberta foi executada, inicie `claude --debug` e procure pelas linhas `[gatewayDiscovery]`: um sucesso registra quantos modelos foram armazenados em cache, e um `404`, timeout ou redirecionamento é registrado lá também. Para quando a descoberta é executada, o que ela filtra e o formato de resposta que os gateways servem, consulte a [referência de descoberta de modelo](/docs/pt/llm-gateway-protocol#model-discovery).

347 347 

348<h3 id="rotate-credentials-with-apikeyhelper">348<h3 id="rotate-credentials-with-apikeyhelper">

349 Rotacionar credenciais com apiKeyHelper349 Rotacionar credenciais com apiKeyHelper


353 353 

354Use um auxiliar quando a credencial expira em um cronograma, vem de um vault ou comando SSO, ou seu administrador disse para você configurar um. Se sua credencial é uma string fixa que você define uma vez, a [variável de credencial](#set-the-credential-variable) é tudo que você precisa e você pode pular esta seção.354Use um auxiliar quando a credencial expira em um cronograma, vem de um vault ou comando SSO, ou seu administrador disse para você configurar um. Se sua credencial é uma string fixa que você define uma vez, a [variável de credencial](#set-the-credential-variable) é tudo que você precisa e você pode pular esta seção.

355 355 

356O auxiliar é qualquer comando de shell que imprime a credencial atual para stdout. Claude Code o executa através do seu shell do sistema, então no Windows pode ser um executável ou uma invocação do PowerShell. Escreva o script, torne-o executável e referencie-o de `apiKeyHelper` em seu [arquivo de configurações](/pt/settings):356O auxiliar é qualquer comando de shell que imprime a credencial atual para stdout. Claude Code o executa através do seu shell do sistema, então no Windows pode ser um executável ou uma invocação do PowerShell. Escreva o script, torne-o executável e referencie-o de `apiKeyHelper` em seu [arquivo de configurações](/docs/pt/settings):

357 357 

358<Tabs>358<Tabs>

359 <Tab title="Bash ou Zsh">359 <Tab title="Bash ou Zsh">


419Definir a variável tem esses efeitos e limitações:419Definir a variável tem esses efeitos e limitações:

420 420 

421* Desativa atualizações automáticas, então planeje outro caminho de atualização, como seu gerenciador de pacotes ou distribuição gerenciada.421* Desativa atualizações automáticas, então planeje outro caminho de atualização, como seu gerenciador de pacotes ou distribuição gerenciada.

422* Suprime a verificação de disponibilidade do [modo rápido](/pt/fast-mode). A menos que uma verificação anterior já tenha ativado o modo rápido na máquina, `/fast` relata que o modo rápido está indisponível.422* Suprime a verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode). A menos que uma verificação anterior já tenha ativado o modo rápido na máquina, `/fast` relata que o modo rápido está indisponível.

423* Desativa a [descoberta de modelo de gateway](#add-gateway-models-to-the-model-picker), mesmo que a descoberta consulte o próprio gateway. Os modelos descobertos anteriormente permanecem disponíveis do cache local, mas a lista não é atualizada.423* Desativa a [descoberta de modelo de gateway](#add-gateway-models-to-the-model-picker), mesmo que a descoberta consulte o próprio gateway. Os modelos descobertos anteriormente permanecem disponíveis do cache local, mas a lista não é atualizada.

424* A verificação de segurança de domínio da ferramenta WebFetch]\(/pt/data-usage#webfetch-domain-safety-check) não é afetada e ainda chama `api.anthropic.com`. Desative-a separadamente com `skipWebFetchPreflight: true` em [configurações](/pt/settings) se sua rede bloquear esse host.424* A verificação de segurança de domínio da ferramenta WebFetch]\(/pt/data-usage#webfetch-domain-safety-check) não é afetada e ainda chama `api.anthropic.com`. Desative-a separadamente com `skipWebFetchPreflight: true` em [configurações](/docs/pt/settings) se sua rede bloquear esse host.

425* Para cada fluxo de telemetria e a variável que a controla, consulte [serviços de telemetria](/pt/data-usage#telemetry-services).425* Para cada fluxo de telemetria e a variável que a controla, consulte [serviços de telemetria](/docs/pt/data-usage#telemetry-services).

426 426 

427<h3 id="route-to-a-cloud-provider-through-a-gateway">427<h3 id="route-to-a-cloud-provider-through-a-gateway">

428 Rotear para um provedor em nuvem através de um gateway428 Rotear para um provedor em nuvem através de um gateway


432 432 

433Use uma apenas se sua equipe de gateway nomeou especificamente Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform on AWS. Se a [solicitação de verificação](#verify-the-connection) acima retornou JSON, você pode pular esta seção.433Use uma apenas se sua equipe de gateway nomeou especificamente Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform on AWS. Se a [solicitação de verificação](#verify-the-connection) acima retornou JSON, você pode pular esta seção.

434 434 

435Defina o bloco para o provedor que sua equipe de gateway nomeou. As variáveis skip-auth dizem a Claude Code para não assinar solicitações com credenciais de provedor, já que o gateway as mantém. Se o gateway precisa de seu próprio token, adicione `ANTHROPIC_AUTH_TOKEN` após o bloco, exceto para Microsoft Foundry, que usa `ANTHROPIC_FOUNDRY_API_KEY` conforme mostrado. {/* min-version: 2.1.203 */}Um gateway Microsoft Foundry que espera um token bearer pode usar [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/pt/env-vars) em vez disso; ele tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` quando ambos estão definidos. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` requer Claude Code v2.1.203 ou posterior.435Defina o bloco para o provedor que sua equipe de gateway nomeou. As variáveis skip-auth dizem a Claude Code para não assinar solicitações com credenciais de provedor, já que o gateway as mantém. Se o gateway precisa de seu próprio token, adicione `ANTHROPIC_AUTH_TOKEN` após o bloco, exceto para Microsoft Foundry, que usa `ANTHROPIC_FOUNDRY_API_KEY` conforme mostrado. Um gateway Microsoft Foundry que espera um token bearer pode usar [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/pt/env-vars) em vez disso; ele tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` quando ambos estão definidos. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` requer Claude Code v2.1.203 ou posterior.

436 436 

437<h4 id="amazon-bedrock">437<h4 id="amazon-bedrock">

438 Amazon Bedrock438 Amazon Bedrock


486 Microsoft Foundry486 Microsoft Foundry

487</h4>487</h4>

488 488 

489Coloque a credencial do gateway em `ANTHROPIC_FOUNDRY_API_KEY`; ela é enviada para o gateway como o cabeçalho `x-api-key`. {/* min-version: 2.1.203 */}Um gateway que espera um token bearer pode usar [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/pt/env-vars) em vez disso. Claude Code envia esse valor como o cabeçalho `Authorization: Bearer`, e ele tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` quando ambos estão definidos. Requer Claude Code v2.1.203 ou posterior.489Coloque a credencial do gateway em `ANTHROPIC_FOUNDRY_API_KEY`; ela é enviada para o gateway como o cabeçalho `x-api-key`. Um gateway que espera um token bearer pode usar [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/pt/env-vars) em vez disso. Claude Code envia esse valor como o cabeçalho `Authorization: Bearer`, e ele tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` quando ambos estão definidos. Requer Claude Code v2.1.203 ou posterior.

490 490 

491Para um gateway que injeta seu próprio cabeçalho `Authorization`, defina `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` e deixe ambas as variáveis de credencial indefinidas. Claude Code então 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`. {/* min-version: 2.1.203 */}Antes de v2.1.203, `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` sem uma chave de API deixava o cliente Microsoft Foundry incapaz de enviar solicitações.491Para um gateway que injeta seu próprio cabeçalho `Authorization`, defina `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` e deixe ambas as variáveis de credencial indefinidas. Claude Code então 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`. Antes de v2.1.203, `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` sem uma chave de API deixava o cliente Microsoft Foundry incapaz de enviar solicitações.

492 492 

493<Tabs>493<Tabs>

494 <Tab title="Bash ou Zsh">494 <Tab title="Bash ou Zsh">


512 Claude Platform on AWS512 Claude Platform on AWS

513</h4>513</h4>

514 514 

515Consulte [Claude Platform on AWS](/pt/claude-platform-on-aws) para o ID do workspace.515Consulte [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) para o ID do workspace.

516 516 

517<Tabs>517<Tabs>

518 <Tab title="Bash ou Zsh">518 <Tab title="Bash ou Zsh">


544| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |544| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

545| Um aviso de inicialização nomeando duas fontes de credencial e terminando em `auth may not work as expected`. Versões mais antigas mostram `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` em vez disso. | Uma credencial de gateway e um login salvo estão ambos ativos; a variável é usada para solicitações, mas o login obsoleto pode causar comportamento de autenticação inesperado | Desdefina a variável para usar o login salvo, ou execute `/logout` para usar a credencial de gateway |545| Um aviso de inicialização nomeando duas fontes de credencial e terminando em `auth may not work as expected`. Versões mais antigas mostram `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` em vez disso. | Uma credencial de gateway e um login salvo estão ambos ativos; a variável é usada para solicitações, mas o login obsoleto pode causar comportamento de autenticação inesperado | Desdefina a variável para usar o login salvo, ou execute `/logout` para usar a credencial de gateway |

546| Erros `401` nomeando um token inválido ou não reconhecido | A credencial não é uma que o gateway emitiu, ou está em um cabeçalho que o gateway não lê | Confirme que a variável corresponde ao seu tipo de credencial na [tabela de credencial](#set-the-credential-variable) e regenere a chave no gateway se ela foi revogada |546| Erros `401` nomeando um token inválido ou não reconhecido | A credencial não é uma que o gateway emitiu, ou está em um cabeçalho que o gateway não lê | Confirme que a variável corresponde ao seu tipo de credencial na [tabela de credencial](#set-the-credential-variable) e regenere a chave no gateway se ela foi revogada |

547| `Your apiKeyHelper script is failing` | O comando na configuração [`apiKeyHelper`](/pt/settings#available-settings) saiu com um erro, expirou ou não imprimiu nada, portanto as solicitações carregam uma chave de espaço reservado | Execute o comando diretamente para ver por que falha e autentique-se novamente com seu provedor de credencial se ele relatar uma sessão expirada; consulte [a referência de erro](/pt/errors#your-apikeyhelper-script-is-failing) |547| `Your apiKeyHelper script is failing` | O comando na configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) saiu com um erro, expirou ou não imprimiu nada, portanto as solicitações carregam uma chave de espaço reservado | Execute o comando diretamente para ver por que falha e autentique-se novamente com seu provedor de credencial se ele relatar uma sessão expirada; consulte [a referência de erro](/docs/pt/errors#your-apikeyhelper-script-is-failing) |

548| `Unable to connect to API (ConnectionRefused)` ou `(ECONNREFUSED)` de instalações npm, frequentemente após uma pausa silenciosa enquanto Claude Code [tenta novamente com backoff](/pt/errors#automatic-retries) | Nada respondeu na URL base: o endereço está errado ou uma VPN ou firewall bloqueia o caminho para o gateway | Execute o [teste curl acima](#verify-the-connection), que falha imediatamente com a mesma causa, e confirme a URL e o caminho de rede com sua equipe de gateway |548| `Unable to connect to API (ConnectionRefused)` ou `(ECONNREFUSED)` de instalações npm, frequentemente após uma pausa silenciosa enquanto Claude Code [tenta novamente com backoff](/docs/pt/errors#automatic-retries) | Nada respondeu na URL base: o endereço está errado ou uma VPN ou firewall bloqueia o caminho para o gateway | Execute o [teste curl acima](#verify-the-connection), que falha imediatamente com a mesma causa, e confirme a URL e o caminho de rede com sua equipe de gateway |

549| `API returned an empty or malformed response (HTTP 200)` | O gateway ou um proxy intermediário retornou uma resposta não-API, frequentemente uma página de erro HTML ou login | Teste com a [solicitação curl acima](#verify-the-connection); corrija a rota do gateway que retorna não-JSON |549| `API returned an empty or malformed response (HTTP 200)` | O gateway ou um proxy intermediário retornou uma resposta não-API, frequentemente uma página de erro HTML ou login | Teste com a [solicitação curl acima](#verify-the-connection); corrija a rota do gateway que retorna não-JSON |

550| Erros `400` nomeando `context_management`, `Extra inputs are not permitted` ou outros campos não reconhecidos | O gateway encaminha solicitações para um upstream que rejeita campos que Claude Code envia para endpoints em formato Anthropic | Defina `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, que suprime a maioria dos campos de pré-lançamento; consulte [passagem de recurso](/pt/llm-gateway-protocol#feature-pass-through). Alguns betas não são controlados por este sinalizador; para esses, defina a variável de provedor `CLAUDE_CODE_USE_*` correspondente para que Claude Code envie apenas o que esse provedor aceita |550| Erros `400` nomeando `context_management`, `Extra inputs are not permitted` ou outros campos não reconhecidos | O gateway encaminha solicitações para um upstream que rejeita campos que Claude Code envia para endpoints em formato Anthropic | Defina `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, que suprime a maioria dos campos de pré-lançamento; consulte [passagem de recurso](/docs/pt/llm-gateway-protocol#feature-pass-through). Alguns betas não são controlados por este sinalizador; para esses, defina a variável de provedor `CLAUDE_CODE_USE_*` correspondente para que Claude Code envie apenas o que esse provedor aceita |

551| Erros `400` nomeando `thinking` ou `adaptive`, como `Input tag 'adaptive' found` | A compilação do modelo upstream não aceita raciocínio adaptativo, que Claude Code solicita para modelos Claude 4.6 e posteriores | Atualize o upstream do gateway. Em Opus 4.6 e Sonnet 4.6, `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` funciona em vez disso. As variáveis de capacidade de [configuração de modelo](/pt/model-config) se aplicam apenas às configurações de provedor, como `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, não atrás de um gateway `ANTHROPIC_BASE_URL` |551| Erros `400` nomeando `thinking` ou `adaptive`, como `Input tag 'adaptive' found` | A compilação do modelo upstream não aceita raciocínio adaptativo, que Claude Code solicita para modelos Claude 4.6 e posteriores | Atualize o upstream do gateway. Em Opus 4.6 e Sonnet 4.6, `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` funciona em vez disso. As variáveis de capacidade de [configuração de modelo](/docs/pt/model-config) se aplicam apenas às configurações de provedor, como `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, não atrás de um gateway `ANTHROPIC_BASE_URL` |

552| Erros `400` indicando um contexto ou limite de token nas próprias palavras do gateway, como `ContextWindowExceededError` ou `prompt token count of N exceeds the limit of M` | O gateway impõe um contexto menor que a janela nativa do modelo e reescreve o erro upstream, para que a compactação automática e repetição, que corresponde à redação `prompt is too long` da Anthropic, não dispare | Execute `/compact` para recuperar a sessão. Para evitar, defina `CLAUDE_CODE_AUTO_COMPACT_WINDOW` para o limite do gateway; o valor é fixado em pelo menos 100.000 tokens e no máximo a janela de contexto do modelo, para que um limite de gateway abaixo de 100.000 não possa ser correspondido e `/compact` permaneça a recuperação lá. Também defina `CLAUDE_CODE_MAX_OUTPUT_TOKENS` abaixo do limite de saída do modelo de gateway |552| Erros `400` indicando um contexto ou limite de token nas próprias palavras do gateway, como `ContextWindowExceededError` ou `prompt token count of N exceeds the limit of M` | O gateway impõe um contexto menor que a janela nativa do modelo e reescreve o erro upstream, para que a compactação automática e repetição, que corresponde à redação `prompt is too long` da Anthropic, não dispare | Execute `/compact` para recuperar a sessão. Para evitar, defina `CLAUDE_CODE_AUTO_COMPACT_WINDOW` para o limite do gateway; o valor é fixado em pelo menos 100.000 tokens e no máximo a janela de contexto do modelo, para que um limite de gateway abaixo de 100.000 não possa ser correspondido e `/compact` permaneça a recuperação lá. Também defina `CLAUDE_CODE_MAX_OUTPUT_TOKENS` abaixo do limite de saída do modelo de gateway |

553| Modelos faltando do seletor `/model` | Nomes de modelo de gateway não estão na lista integrada de Claude Code | Ative [descoberta de modelo de gateway](#add-gateway-models-to-the-model-picker) ou adicione nomes com as variáveis de [configuração de modelo](/pt/model-config) |553| Modelos faltando do seletor `/model` | Nomes de modelo de gateway não estão na lista integrada de Claude Code | Ative [descoberta de modelo de gateway](#add-gateway-models-to-the-model-picker) ou adicione nomes com as variáveis de [configuração de modelo](/docs/pt/model-config) |

554| Claude Code pede para você fazer login mesmo que o [teste curl](#verify-the-connection) tenha sucesso | O CLI não tem credencial própria: uma URL base alcançável não é uma, e um bloco `env` no `.claude/settings.json` ou `.claude/settings.local.json` de um projeto se aplica apenas após o assistente de primeira execução e prompt de confiança | Defina `ANTHROPIC_AUTH_TOKEN` em algum lugar que Claude Code leia antes da configuração de primeira execução: uma exportação de shell, o bloco `env` em `~/.claude/settings.json` ou configurações gerenciadas |554| Claude Code pede para você fazer login mesmo que o [teste curl](#verify-the-connection) tenha sucesso | O CLI não tem credencial própria: uma URL base alcançável não é uma, e um bloco `env` no `.claude/settings.json` ou `.claude/settings.local.json` de um projeto se aplica apenas após o assistente de primeira execução e prompt de confiança | Defina `ANTHROPIC_AUTH_TOKEN` em algum lugar que Claude Code leia antes da configuração de primeira execução: uma exportação de shell, o bloco `env` em `~/.claude/settings.json` ou configurações gerenciadas |

555| `ANTHROPIC_API_KEY` está definido mas ignorado, sem prompt | A chave precisa de uma aprovação única em sessões interativas, e uma chave previamente recusada é ignorada sem perguntar novamente | Ative-a em `/config` com a opção `Use custom API key` |555| `ANTHROPIC_API_KEY` está definido mas ignorado, sem prompt | A chave precisa de uma aprovação única em sessões interativas, e uma chave previamente recusada é ignorada sem perguntar novamente | Ative-a em `/config` com a opção `Use custom API key` |

556| `This machine's managed settings require a first-party login` | Configurações gerenciadas incluem `forceLoginMethod` ou `forceLoginOrgUUID`, que em Claude Code v2.1.146 e posterior não podem coexistir com `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` | Seu administrador deve remover `forceLoginMethod` e `forceLoginOrgUUID` das configurações gerenciadas para usar credenciais de gateway, ou remover a credencial de gateway para usar login de primeira parte. Os dois não podem ser combinados |556| `This machine's managed settings require a first-party login` | Configurações gerenciadas incluem `forceLoginMethod` ou `forceLoginOrgUUID`, que em Claude Code v2.1.146 e posterior não podem coexistir com `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` | Seu administrador deve remover `forceLoginMethod` e `forceLoginOrgUUID` das configurações gerenciadas para usar credenciais de gateway, ou remover a credencial de gateway para usar login de primeira parte. Os dois não podem ser combinados |

557| `403` com um corpo HTML como `403 Forbidden`, quando os próprios logs do gateway não mostram nenhuma solicitação recebida | Um firewall de aplicativo web ou proxy reverso na frente do gateway bloqueou o corpo da solicitação antes de chegar ao gateway. Os prompts de Claude Code incluem tags de estilo XML e código-fonte que correspondem a regras de corpo de cross-site-scripting, para que um teste curl curto passe enquanto uma sessão real não | Isente o caminho `/v1/messages` do gateway da inspeção de corpo de solicitação. No AWS WAF esta é a regra gerenciada `CrossSiteScripting_Body`; no nginx com ModSecurity é a regra de corpo OWASP CRS equivalente |557| `403` com um corpo HTML como `403 Forbidden`, quando os próprios logs do gateway não mostram nenhuma solicitação recebida | Um firewall de aplicativo web ou proxy reverso na frente do gateway bloqueou o corpo da solicitação antes de chegar ao gateway. Os prompts de Claude Code incluem tags de estilo XML e código-fonte que correspondem a regras de corpo de cross-site-scripting, para que um teste curl curto passe enquanto uma sessão real não | Isente o caminho `/v1/messages` do gateway da inspeção de corpo de solicitação. No AWS WAF esta é a regra gerenciada `CrossSiteScripting_Body`; no nginx com ModSecurity é a regra de corpo OWASP CRS equivalente |

558| Erros de certificado ou TLS como `SSL certificate verification failed` ou `Self-signed certificate detected`, quando o [teste curl](#verify-the-connection) tem sucesso | O runtime de Claude Code não está confiando na mesma autoridade de certificação que `curl` usa. Comum atrás de proxies de inspeção TLS corporativa | Defina `NODE_EXTRA_CA_CERTS` para o caminho do pacote CA; consulte [armazenamento de certificado CA](/pt/network-config#ca-certificate-store) |558| Erros de certificado ou TLS como `SSL certificate verification failed` ou `Self-signed certificate detected`, quando o [teste curl](#verify-the-connection) tem sucesso | O runtime de Claude Code não está confiando na mesma autoridade de certificação que `curl` usa. Comum atrás de proxies de inspeção TLS corporativa | Defina `NODE_EXTRA_CA_CERTS` para o caminho do pacote CA; consulte [armazenamento de certificado CA](/docs/pt/network-config#ca-certificate-store) |

559 559 

560Se Claude Code solicitar que você faça login repetidamente após remover a configuração de gateway, a causa é geralmente armazenamento de credencial em vez do gateway; consulte [erros de autenticação](/pt/errors#authentication-errors).560Se Claude Code solicitar que você faça login repetidamente após remover a configuração de gateway, a causa é geralmente armazenamento de credencial em vez do gateway; consulte [erros de autenticação](/docs/pt/errors#authentication-errors).

561 561 

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

563 Recursos relacionados563 Recursos relacionados

564</h2>564</h2>

565 565 

566* [Visão geral de gateways LLM](/pt/llm-gateway): o que é um gateway e como ele interage com assinaturas claude.ai566* [Visão geral de gateways LLM](/docs/pt/llm-gateway): o que é um gateway e como ele interage com assinaturas claude.ai

567* [Implementar um gateway LLM para sua organização](/pt/llm-gateway-rollout): a lista de verificação voltada para o administrador para implantar e distribuir configuração de gateway567* [Implementar um gateway LLM para sua organização](/docs/pt/llm-gateway-rollout): a lista de verificação voltada para o administrador para implantar e distribuir configuração de gateway

568* [Referência do protocolo de gateway](/pt/llm-gateway-protocol): o que Claude Code envia para um gateway, incluindo os cabeçalhos e campos que o gateway deve encaminhar568* [Referência do protocolo de gateway](/docs/pt/llm-gateway-protocol): o que Claude Code envia para um gateway, incluindo os cabeçalhos e campos que o gateway deve encaminhar

569* [Configurações](/pt/settings): onde os arquivos de configurações vivem e como o bloco `env` é lido569* [Configurações](/docs/pt/settings): onde os arquivos de configurações vivem e como o bloco `env` é lido

570* [Autenticação](/pt/authentication): como variáveis de credencial, `apiKeyHelper` e login OAuth interagem570* [Autenticação](/docs/pt/authentication): como variáveis de credencial, `apiKeyHelper` e login OAuth interagem

Details

8 8 

9Esta página documenta as solicitações que Claude Code envia para um gateway, incluindo os endpoints que ele chama, os headers e campos de corpo que o gateway deve encaminhar, e quais recursos deixam de funcionar quando não o faz. É escrita para operadores que configuram um produto gateway para funcionar com Claude Code.9Esta página documenta as solicitações que Claude Code envia para um gateway, incluindo os endpoints que ele chama, os headers e campos de corpo que o gateway deve encaminhar, e quais recursos deixam de funcionar quando não o faz. É escrita para operadores que configuram um produto gateway para funcionar com Claude Code.

10 10 

11Um [gateway de aplicativos Claude](/pt/claude-apps-gateway) em execução fornece uma versão legível por máquina deste contrato em `GET /protocol`, cobrindo os mesmos requisitos de encaminhamento mais os endpoints específicos do gateway de aplicativos Claude para login SSO, entrega de configurações gerenciadas e telemetria. O gateway de aplicativos Claude é executado a partir do mesmo binário `claude` que a CLI, portanto o [guia de início rápido do gateway de aplicativos Claude](/pt/claude-apps-gateway#quickstart) é o caminho mais curto para uma instância em execução da qual você pode buscar a especificação.11Um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) em execução fornece uma versão legível por máquina deste contrato em `GET /protocol`, cobrindo os mesmos requisitos de encaminhamento mais os endpoints específicos do gateway de aplicativos Claude para login SSO, entrega de configurações gerenciadas e telemetria. O gateway de aplicativos Claude é executado a partir do mesmo binário `claude` que a CLI, portanto o [guia de início rápido do gateway de aplicativos Claude](/docs/pt/claude-apps-gateway#quickstart) é o caminho mais curto para uma instância em execução da qual você pode buscar a especificação.

12 12 

13<Note>13<Note>

14 * Para implantar um gateway existente ou de terceiros para sua organização, consulte [Implantar um gateway LLM](/pt/llm-gateway-rollout)14 * Para implantar um gateway existente ou de terceiros para sua organização, consulte [Implantar um gateway LLM](/docs/pt/llm-gateway-rollout)

15 * Se você é um desenvolvedor individual autenticando Claude Code em um gateway com uma credencial que lhe foi fornecida, consulte [Conectar Claude Code a um gateway LLM](/pt/llm-gateway-connect)15 * Se você é um desenvolvedor individual autenticando Claude Code em um gateway com uma credencial que lhe foi fornecida, consulte [Conectar Claude Code a um gateway LLM](/docs/pt/llm-gateway-connect)

16</Note>16</Note>

17 17 

18Esta página cobre:18Esta página cobre:


46 Foundry e Claude Platform on AWS46 Foundry e Claude Platform on AWS

47</h3>47</h3>

48 48 

49Microsoft Foundry e a [Claude Platform on AWS](/pt/claude-platform-on-aws) implementam o formato Anthropic Messages. Claude Code roteia para eles através de suas próprias variáveis, `ANTHROPIC_FOUNDRY_BASE_URL` e `ANTHROPIC_AWS_BASE_URL`, mas um gateway fronteando qualquer um deles implementa a linha Anthropic Messages acima. Um gateway fronteando a Claude Platform on AWS também deve encaminhar o header `anthropic-workspace-id`, que [essa plataforma requer em cada solicitação](/pt/claude-platform-on-aws).49Microsoft Foundry e a [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) implementam o formato Anthropic Messages. Claude Code roteia para eles através de suas próprias variáveis, `ANTHROPIC_FOUNDRY_BASE_URL` e `ANTHROPIC_AWS_BASE_URL`, mas um gateway fronteando qualquer um deles implementa a linha Anthropic Messages acima. Um gateway fronteando a Claude Platform on AWS também deve encaminhar o header `anthropic-workspace-id`, que [essa plataforma requer em cada solicitação](/docs/pt/claude-platform-on-aws).

50 50 

51<h3 id="optional-endpoints-and-startup-traffic">51<h3 id="optional-endpoints-and-startup-traffic">

52 Endpoints opcionais e tráfego de inicialização52 Endpoints opcionais e tráfego de inicialização


77 Headers de solicitação77 Headers de solicitação

78</h2>78</h2>

79 79 

80Claude Code inclui esses headers em solicitações de API. Nomes de headers não diferenciam maiúsculas de minúsculas no fio. Encaminhe `anthropic-version` e `anthropic-beta` inalterados, mais `anthropic-workspace-id` quando o upstream é a [Claude Platform on AWS](/pt/claude-platform-on-aws); o resto o gateway pode consumir para roteamento, atribuição e rastreamento, e não precisa encaminhar.80Claude Code inclui esses headers em solicitações de API. Nomes de headers não diferenciam maiúsculas de minúsculas no fio. Encaminhe `anthropic-version` e `anthropic-beta` inalterados, mais `anthropic-workspace-id` quando o upstream é a [Claude Platform on AWS](/docs/pt/claude-platform-on-aws); o resto o gateway pode consumir para roteamento, atribuição e rastreamento, e não precisa encaminhar.

81 81 

82| Header | Descrição |82| Header | Descrição |

83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84| `Authorization`, `x-api-key` | A credencial do gateway do desenvolvedor, em um ou ambos os headers dependendo de qual [variável de credencial](/pt/llm-gateway-connect#set-the-credential-variable) eles definiram |84| `Authorization`, `x-api-key` | A credencial do gateway do desenvolvedor, em um ou ambos os headers dependendo de qual [variável de credencial](/docs/pt/llm-gateway-connect#set-the-credential-variable) eles definiram |

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

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

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

88| `x-claude-code-agent-id` | Identificador do [subagente](/pt/sub-agents) que emitiu a solicitação, presente apenas em solicitações de um agente que Claude Code gerou dentro da sessão. Use-o com o ID da sessão para atribuir custo a agentes paralelos |88| `x-claude-code-agent-id` | Identificador do [subagente](/docs/pt/sub-agents) que emitiu a solicitação, presente apenas em solicitações de um agente que Claude Code gerou dentro da sessão. Use-o com o ID da sessão para atribuir custo a agentes paralelos |

89| `x-claude-code-parent-agent-id` | Identificador do agente que gerou o agente solicitante, presente apenas para agentes aninhados |89| `x-claude-code-parent-agent-id` | Identificador do agente que gerou o agente solicitante, presente apenas para agentes aninhados |

90 90 

91IDs de subagentes são gerados novamente para cada geração. Agentes companheiros, os membros nomeados de uma [equipe de agentes](/pt/agent-teams), reutilizam um ID estável baseado em nome entre reconexões. Em ambos os casos, o ID identifica um agente, não uma pessoa ou dispositivo, então não trate o header de ID de agente como um identificador de usuário.91IDs de subagentes são gerados novamente para cada geração. Agentes companheiros, os membros nomeados de uma [equipe de agentes](/docs/pt/agent-teams), reutilizam um ID estável baseado em nome entre reconexões. Em ambos os casos, o ID identifica um agente, não uma pessoa ou dispositivo, então não trate o header de ID de agente como um identificador de usuário.

92 92 

93Se seus desenvolvedores definirem `ANTHROPIC_CUSTOM_HEADERS`, esses headers também aparecem em solicitações.93Se seus desenvolvedores definirem `ANTHROPIC_CUSTOM_HEADERS`, esses headers também aparecem em solicitações.

94 94 


112 112 

113* Encaminhe o array `system` exatamente como recebido, mantendo o bloco primeiro: adicionar outro bloco do sistema, reordenar o array ou convertê-lo em uma única string derrota a remoção, e o bloco então chega ao modelo e à chave do cache de prompt.113* Encaminhe o array `system` exatamente como recebido, mantendo o bloco primeiro: adicionar outro bloco do sistema, reordenar o array ou convertê-lo em uma única string derrota a remoção, e o bloco então chega ao modelo e à chave do cache de prompt.

114* Mantenha o bloco em sua própria entrada de array: o endpoint trata um bloco mesclado que começa com o cabeçalho de atribuição como atribuição em sua totalidade e descarta tudo mesclado nele, incluindo o resto do prompt do sistema.114* Mantenha o bloco em sua própria entrada de array: o endpoint trata um bloco mesclado que começa com o cabeçalho de atribuição como atribuição em sua totalidade e descarta tudo mesclado nele, incluindo o resto do prompt do sistema.

115* Se seu gateway deve reformular o conteúdo do sistema, defina [`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/pt/env-vars) para que Claude Code omita o bloco. Anthropic e os endpoints Claude dos provedores de nuvem leem o bloco para atribuição, portanto omita-o no cliente em vez de removê-lo ou movê-lo no gateway.115* Se seu gateway deve reformular o conteúdo do sistema, defina [`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/docs/pt/env-vars) para que Claude Code omita o bloco. Anthropic e os endpoints Claude dos provedores de nuvem leem o bloco para atribuição, portanto omita-o no cliente em vez de removê-lo ou movê-lo no gateway.

116 116 

117Solicitações que chegam ao endpoint inalteradas não são afetadas.117Solicitações que chegam ao endpoint inalteradas não são afetadas.

118 118 

119{/* min-version: 2.1.181 */}A partir de Claude Code v2.1.181, o bloco é estável pela vida útil de uma conversa quando solicitações são roteadas através de uma URL base personalizada, então um cache de prompt do lado do gateway com chave no corpo completo da solicitação funciona sem desabilitá-lo. Antes de v2.1.181, o bloco incluía um token por solicitação; nessas versões, defina `CLAUDE_CODE_ATTRIBUTION_HEADER=0` se seu gateway implementar tal cache.119A partir de Claude Code v2.1.181, o bloco é estável pela vida útil de uma conversa quando solicitações são roteadas através de uma URL base personalizada, então um cache de prompt do lado do gateway com chave no corpo completo da solicitação funciona sem desabilitá-lo. Antes de v2.1.181, o bloco incluía um token por solicitação; nessas versões, defina `CLAUDE_CODE_ATTRIBUTION_HEADER=0` se seu gateway implementar tal cache.

120 120 

121<h2 id="feature-pass-through">121<h2 id="feature-pass-through">

122 Passagem de recursos122 Passagem de recursos


126 126 

127Capacidades que adicionam campos de corpo os emparelham com um header beta, e o par viaja junto. Um gateway que remove o header enquanto passa o corpo, ou encaminha um corpo no formato Anthropic para um upstream com um schema diferente, produz erros `400` difíceis; apenas quando ambas as metades estão ausentes juntas o recurso desativa silenciosamente. Um gateway que reescreve ou redige corpos de solicitação para inspeção de conteúdo quebra o emparelhamento da mesma forma que remover o faz, então inspecione sem modificar. A tabela observa onde um recurso se desvia do emparelhamento.127Capacidades que adicionam campos de corpo os emparelham com um header beta, e o par viaja junto. Um gateway que remove o header enquanto passa o corpo, ou encaminha um corpo no formato Anthropic para um upstream com um schema diferente, produz erros `400` difíceis; apenas quando ambas as metades estão ausentes juntas o recurso desativa silenciosamente. Um gateway que reescreve ou redige corpos de solicitação para inspeção de conteúdo quebra o emparelhamento da mesma forma que remover o faz, então inspecione sem modificar. A tabela observa onde um recurso se desvia do emparelhamento.

128 128 

129Streaming de ferramenta de granulação fina é um dos padrões de conexão direta: está desativado por padrão sempre que solicitações são roteadas através de uma URL base personalizada, e um gateway o recebe quando desenvolvedores definem [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/pt/env-vars).129Streaming de ferramenta de granulação fina é um dos padrões de conexão direta: está desativado por padrão sempre que solicitações são roteadas através de uma URL base personalizada, e um gateway o recebe quando desenvolvedores definem [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/pt/env-vars).

130 130 

131| Recurso | Header e par de corpo | Sintoma quando quebrado | Remediação |131| Recurso | Header e par de corpo | Sintoma quando quebrado | Remediação |

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

133| [Raciocínio adaptativo](/pt/model-config#adjust-effort-level) | Sem header beta. Claude Code envia `thinking: {"type": "adaptive"}` para Claude 4.6 e posterior, e trata nomes de modelos que não reconhece, como aliases de gateway, como modelos atuais que recebem o campo | `400` nomeando o campo `thinking` ou a tag `adaptive` quando a compilação do modelo upstream não a aceita | Atualize o upstream. Em Opus 4.6 e Sonnet 4.6, desenvolvedores podem definir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` em vez disso |133| [Raciocínio adaptativo](/docs/pt/model-config#adjust-effort-level) | Sem header beta. Claude Code envia `thinking: {"type": "adaptive"}` para Claude 4.6 e posterior, e trata nomes de modelos que não reconhece, como aliases de gateway, como modelos atuais que recebem o campo | `400` nomeando o campo `thinking` ou a tag `adaptive` quando a compilação do modelo upstream não a aceita | Atualize o upstream. Em Opus 4.6 e Sonnet 4.6, desenvolvedores podem definir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` em vez disso |

134| [Gerenciamento de contexto](https://platform.claude.com/docs/en/build-with-claude/context-management) | Header beta de gerenciamento de contexto emparelhado com o campo de corpo `context_management` | `400` com `Extra inputs are not permitted`. Comum quando um gateway aceita solicitações no formato Anthropic mas as encaminha para Amazon Bedrock | Encaminhe ambos, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/pt/env-vars) |134| [Gerenciamento de contexto](https://platform.claude.com/docs/en/build-with-claude/context-management) | Header beta de gerenciamento de contexto emparelhado com o campo de corpo `context_management` | `400` com `Extra inputs are not permitted`. Comum quando um gateway aceita solicitações no formato Anthropic mas as encaminha para Amazon Bedrock | Encaminhe ambos, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/env-vars) |

135| [Contexto estendido](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) e [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Apenas headers beta, sem campo de corpo | Silenciosamente indisponível quando o header é removido; o upstream nunca vê a solicitação de capacidade | Encaminhe `anthropic-beta` verbatim |135| [Contexto estendido](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) e [pensamento intercalado](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Apenas headers beta, sem campo de corpo | Silenciosamente indisponível quando o header é removido; o upstream nunca vê a solicitação de capacidade | Encaminhe `anthropic-beta` verbatim |

136| Campos de [ferramenta](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) beta | Headers beta relacionados a ferramentas emparelhados com campos de schema de ferramenta como `strict` e `defer_loading` | `400` nomeando o campo de schema de ferramenta não reconhecido quando o corpo passa sem seu header | Encaminhe ambos, ou `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |136| Campos de [ferramenta](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) beta | Headers beta relacionados a ferramentas emparelhados com campos de schema de ferramenta como `strict` e `defer_loading` | `400` nomeando o campo de schema de ferramenta não reconhecido quando o corpo passa sem seu header | Encaminhe ambos, ou `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |

137| [Esforço](https://platform.claude.com/docs/en/build-with-claude/effort) e [saídas estruturadas](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | O campo de corpo `output_config` carrega esforço, formato de saída estruturada e configurações de orçamento de tarefa; cada um emparelhado com seu próprio header beta | `400` nomeando `output_config`, frequentemente `Extra inputs are not permitted`, em upstreams Bedrock e Agent Platform | Encaminhe o campo e seus headers juntos |137| [Esforço](https://platform.claude.com/docs/en/build-with-claude/effort) e [saídas estruturadas](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | O campo de corpo `output_config` carrega esforço, formato de saída estruturada e configurações de orçamento de tarefa; cada um emparelhado com seu próprio header beta | `400` nomeando `output_config`, frequentemente `Extra inputs are not permitted`, em upstreams Bedrock e Agent Platform | Encaminhe o campo e seus headers juntos |

138| [Contagem de tokens](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Sem emparelhamento beta; usa o endpoint `count_tokens` | Claude Code volta a estimar o uso de contexto localmente | Exponha o endpoint se quiser contagens exatas |138| [Contagem de tokens](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Sem emparelhamento beta; usa o endpoint `count_tokens` | Claude Code volta a estimar o uso de contexto localmente | Exponha o endpoint se quiser contagens exatas |

139 139 

140As [variáveis](/pt/model-config) `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` declaram capacidades de modelo apenas nas configurações do provedor: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, e [`CLAUDE_CODE_USE_MANTLE`](/pt/amazon-bedrock#use-the-mantle-endpoint). Elas não têm efeito atrás de um gateway `ANTHROPIC_BASE_URL`.140As [variáveis](/docs/pt/model-config) `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` declaram capacidades de modelo apenas nas configurações do provedor: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, e [`CLAUDE_CODE_USE_MANTLE`](/docs/pt/amazon-bedrock#use-the-mantle-endpoint). Elas não têm efeito atrás de um gateway `ANTHROPIC_BASE_URL`.

141 141 

142<h3 id="automatic-retry-and-error-forwarding">142<h3 id="automatic-retry-and-error-forwarding">

143 Retry automático e encaminhamento de erro143 Retry automático e encaminhamento de erro


161 161 

162Quando `ANTHROPIC_BASE_URL` aponta para um gateway que expõe o formato Anthropic Messages, Claude Code pode consultar o endpoint `/v1/models` do gateway na inicialização e adicionar os modelos retornados ao seletor `/model`.162Quando `ANTHROPIC_BASE_URL` aponta para um gateway que expõe o formato Anthropic Messages, Claude Code pode consultar o endpoint `/v1/models` do gateway na inicialização e adicionar os modelos retornados ao seletor `/model`.

163 163 

164Desenvolvedores o habilitam definindo [`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`](/pt/env-vars), em seu próprio ambiente ou através de configurações gerenciadas. A descoberta está desativada por padrão para que gateways apoiados por uma chave de API compartilhada não exponham cada modelo que a chave pode acessar a cada usuário. Isso requer Claude Code v2.1.129 ou posterior.164Desenvolvedores o habilitam definindo [`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`](/docs/pt/env-vars), em seu próprio ambiente ou através de configurações gerenciadas. A descoberta está desativada por padrão para que gateways apoiados por uma chave de API compartilhada não exponham cada modelo que a chave pode acessar a cada usuário. Isso requer Claude Code v2.1.129 ou posterior.

165 165 

166<h3 id="when-discovery-runs">166<h3 id="when-discovery-runs">

167 Quando a descoberta é executada167 Quando a descoberta é executada


171 171 

172* Qualquer variável de provedor `CLAUDE_CODE_USE_*` é definida, mesmo se `ANTHROPIC_BASE_URL` também for definido172* Qualquer variável de provedor `CLAUDE_CODE_USE_*` é definida, mesmo se `ANTHROPIC_BASE_URL` também for definido

173* `ANTHROPIC_BASE_URL` não está definido ou aponta para `api.anthropic.com`173* `ANTHROPIC_BASE_URL` não está definido ou aponta para `api.anthropic.com`

174* Tráfego não essencial está desabilitado, através de [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/pt/env-vars) ou política organizacional174* Tráfego não essencial está desabilitado, através de [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars) ou política organizacional

175 175 

176<h3 id="request-and-response">176<h3 id="request-and-response">

177 Solicitação e resposta177 Solicitação e resposta


182A solicitação de descoberta envia exatamente um header de credencial:182A solicitação de descoberta envia exatamente um header de credencial:

183 183 

184* `ANTHROPIC_AUTH_TOKEN` como um token bearer, quando definido184* `ANTHROPIC_AUTH_TOKEN` como um token bearer, quando definido

185* Caso contrário, a chave de API resolvida, incluindo um valor [`apiKeyHelper`](/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper), no header `x-api-key`185* Caso contrário, a chave de API resolvida, incluindo um valor [`apiKeyHelper`](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper), no header `x-api-key`

186 186 

187Isso difere de solicitações de inferência, que enviam um valor helper em ambos os headers. Um gateway que autentica `/v1/models` deve aceitar `x-api-key` para implantações helper. Qualquer header de `ANTHROPIC_CUSTOM_HEADERS` também é incluído.187Isso difere de solicitações de inferência, que enviam um valor helper em ambos os headers. Um gateway que autentica `/v1/models` deve aceitar `x-api-key` para implantações helper. Qualquer header de `ANTHROPIC_CUSTOM_HEADERS` também é incluído.

188 188 


201 Entradas do seletor e cache201 Entradas do seletor e cache

202</h3>202</h3>

203 203 

204O seletor é a lista de modelos interativa que abre quando um desenvolvedor executa `/model` em Claude Code. Cada entrada descoberta é rotulada "Do gateway" e usa `display_name` quando fornecido. A [configuração gerenciada `availableModels`](/pt/settings#available-settings) limita o que a descoberta pode adicionar.204O seletor é a lista de modelos interativa que abre quando um desenvolvedor executa `/model` em Claude Code. Cada entrada descoberta é rotulada "Do gateway" e usa `display_name` quando fornecido. A [configuração gerenciada `availableModels`](/docs/pt/settings#available-settings) limita o que a descoberta pode adicionar.

205 205 

206Um ID descoberto é ignorado quando corresponde exatamente a uma linha já no seletor, ou quando tanto o ID descoberto quanto o existente se resolvem para [Fable](/pt/model-config#work-with-fable-5). {/* min-version: 2.1.197 */}A partir de Claude Code v2.1.197, um ID explícito descoberto também é incorporado em uma entrada integrada quando ambos se resolvem para o mesmo modelo. Linhas integradas são chaveadas em aliases como `sonnet`, então um ID descoberto explícito do modelo para o qual o alias atualmente se resolve, como `claude-sonnet-5`, colapsa na linha `sonnet`, enquanto um ID para o qual o alias não se resolve, como `claude-sonnet-4-6`, ainda adiciona sua própria linha "Do gateway" ao lado da entrada integrada.206Um ID descoberto é ignorado quando corresponde exatamente a uma linha já no seletor, ou quando tanto o ID descoberto quanto o existente se resolvem para [Fable](/docs/pt/model-config#work-with-fable-5). A partir de Claude Code v2.1.197, um ID explícito descoberto também é incorporado em uma entrada integrada quando ambos se resolvem para o mesmo modelo. Linhas integradas são chaveadas em aliases como `sonnet`, então um ID descoberto explícito do modelo para o qual o alias atualmente se resolve, como `claude-sonnet-5`, colapsa na linha `sonnet`, enquanto um ID para o qual o alias não se resolve, como `claude-sonnet-4-6`, ainda adiciona sua própria linha "Do gateway" ao lado da entrada integrada.

207 207 

208Os resultados são armazenados em cache em `~/.claude/cache/gateway-models.json`, ou `%USERPROFILE%\.claude\cache\gateway-models.json` no Windows, e atualizados em cada inicialização. Se a solicitação falhar ou o gateway não implementar `/v1/models`, o seletor volta para a lista em cache da inicialização anterior ou para a lista de modelos integrada. Se seu gateway serve modelos Claude sob aliases que não correspondem ao filtro de descoberta, desenvolvedores podem adicionar esses aliases manualmente com as [variáveis de configuração de modelo](/pt/model-config).208Os resultados são armazenados em cache em `~/.claude/cache/gateway-models.json`, ou `%USERPROFILE%\.claude\cache\gateway-models.json` no Windows, e atualizados em cada inicialização. Se a solicitação falhar ou o gateway não implementar `/v1/models`, o seletor volta para a lista em cache da inicialização anterior ou para a lista de modelos integrada. Se seu gateway serve modelos Claude sob aliases que não correspondem ao filtro de descoberta, desenvolvedores podem adicionar esses aliases manualmente com as [variáveis de configuração de modelo](/docs/pt/model-config).

209 209 

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

211 Recursos relacionados211 Recursos relacionados


213 213 

214Para o resto do conjunto de documentação do gateway e as referências de API subjacentes:214Para o resto do conjunto de documentação do gateway e as referências de API subjacentes:

215 215 

216* [Visão geral de gateway](/pt/gateways): o que é um gateway e como escolher entre o gateway de aplicativos Claude e outro produto216* [Visão geral de gateway](/docs/pt/gateways): o que é um gateway e como escolher entre o gateway de aplicativos Claude e outro produto

217* [Outros gateways LLM](/pt/llm-gateway): como implantar um gateway que sua organização executa e como ele interage com assinaturas claude.ai217* [Outros gateways LLM](/docs/pt/llm-gateway): como implantar um gateway que sua organização executa e como ele interage com assinaturas claude.ai

218* [Implantar um gateway LLM para sua organização](/pt/llm-gateway-rollout): a lista de verificação do administrador que usa este contrato218* [Implantar um gateway LLM para sua organização](/docs/pt/llm-gateway-rollout): a lista de verificação do administrador que usa este contrato

219* [Conectar Claude Code a um gateway LLM](/pt/llm-gateway-connect): configuração por desenvolvedor e a tabela de solução de problemas219* [Conectar Claude Code a um gateway LLM](/docs/pt/llm-gateway-connect): configuração por desenvolvedor e a tabela de solução de problemas

220* [Referência de headers beta](https://platform.claude.com/docs/en/api/beta-headers): o conjunto atual de valores `anthropic-beta`220* [Referência de headers beta](https://platform.claude.com/docs/en/api/beta-headers): o conjunto atual de valores `anthropic-beta`

221* [Messages API](https://platform.claude.com/docs/en/api/messages): o formato de API que um gateway no formato Anthropic implementa221* [Messages API](https://platform.claude.com/docs/en/api/messages): o formato de API que um gateway no formato Anthropic implementa

Details

9Esta página orienta um administrador através da implantação de um gateway LLM para Claude Code. Ela assume que você tem um produto de gateway implantado que atende aos [requisitos do gateway](#gateway-requirements). A implantação ou operação de qualquer produto específico não é abordada aqui; implante o seu seguindo a documentação do seu fornecedor.9Esta página orienta um administrador através da implantação de um gateway LLM para Claude Code. Ela assume que você tem um produto de gateway implantado que atende aos [requisitos do gateway](#gateway-requirements). A implantação ou operação de qualquer produto específico não é abordada aqui; implante o seu seguindo a documentação do seu fornecedor.

10 10 

11<Note>11<Note>

12 * Para conectar Claude Code em sua própria máquina a um gateway existente, consulte [Conectar Claude Code a um gateway LLM](/pt/llm-gateway-connect)12 * Para conectar Claude Code em sua própria máquina a um gateway existente, consulte [Conectar Claude Code a um gateway LLM](/docs/pt/llm-gateway-connect)

13 * Para saber o que Claude Code envia a um gateway e o que encaminhar, consulte a [referência do protocolo do gateway](/pt/llm-gateway-protocol)13 * Para saber o que Claude Code envia a um gateway e o que encaminhar, consulte a [referência do protocolo do gateway](/docs/pt/llm-gateway-protocol)

14</Note>14</Note>

15 15 

16<h2 id="prerequisites">16<h2 id="prerequisites">


22* Um gateway implantado em sua infraestrutura, servindo HTTPS no endereço exato que você distribuirá aos desenvolvedores, não em um endereço que redireciona para ele, e configurado para rotear nomes de modelos Claude para seu provedor22* Um gateway implantado em sua infraestrutura, servindo HTTPS no endereço exato que você distribuirá aos desenvolvedores, não em um endereço que redireciona para ele, e configurado para rotear nomes de modelos Claude para seu provedor

23* Uma credencial de provedor para o gateway encaminhar com:23* Uma credencial de provedor para o gateway encaminhar com:

24 * Para a API Anthropic: uma chave de API do [Claude Console](https://platform.claude.com/settings/keys)24 * Para a API Anthropic: uma chave de API do [Claude Console](https://platform.claude.com/settings/keys)

25 * Para um provedor de nuvem: credenciais de nuvem com acesso ao modelo. Consulte os pré-requisitos na página [Amazon Bedrock](/pt/amazon-bedrock#prerequisites), [Google Cloud's Agent Platform](/pt/google-vertex-ai#prerequisites) ou [Microsoft Foundry](/pt/microsoft-foundry#prerequisites)25 * Para um provedor de nuvem: credenciais de nuvem com acesso ao modelo. Consulte os pré-requisitos na página [Amazon Bedrock](/docs/pt/amazon-bedrock#prerequisites), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai#prerequisites) ou [Microsoft Foundry](/docs/pt/microsoft-foundry#prerequisites)

26* Uma maneira de entregar arquivos de configurações para máquinas de desenvolvedores, como MDM ou gerenciamento de configuração26* Uma maneira de entregar arquivos de configurações para máquinas de desenvolvedores, como MDM ou gerenciamento de configuração

27 * Se você ainda não tiver uma, [como as configurações chegam aos dispositivos](/pt/admin-setup#decide-how-settings-reach-devices) compara as opções27 * Se você ainda não tiver uma, [como as configurações chegam aos dispositivos](/docs/pt/admin-setup#decide-how-settings-reach-devices) compara as opções

28 28 

29<h3 id="gateway-requirements">29<h3 id="gateway-requirements">

30 Requisitos do gateway30 Requisitos do gateway


32 32 

33Qualquer que seja o produto que fornece o gateway, ele deve:33Qualquer que seja o produto que fornece o gateway, ele deve:

34 34 

35* **Aceitar um formato de API suportado**: um dos formatos na [tabela de formatos de API](/pt/llm-gateway-protocol#api-formats). As etapas de implantação abaixo assumem a API de Mensagens Anthropic em `POST /v1/messages`, que a maioria dos gateways serve35* **Aceitar um formato de API suportado**: um dos formatos na [tabela de formatos de API](/docs/pt/llm-gateway-protocol#api-formats). As etapas de implantação abaixo assumem a API de Mensagens Anthropic em `POST /v1/messages`, que a maioria dos gateways serve

36* **Transmitir respostas**: passar eventos enviados pelo servidor conforme chegam em vez de armazenar em buffer a resposta inteira36* **Transmitir respostas**: passar eventos enviados pelo servidor conforme chegam em vez de armazenar em buffer a resposta inteira

37* **Rotear nomes de modelos Claude**: mapear cada nome que os desenvolvedores usam para um modelo upstream. Claude Code envia um nome de modelo como `claude-sonnet-4-6` em cada solicitação; na maioria dos produtos de gateway o mapeamento é uma lista de modelos ou tabela de roteamento na própria configuração do gateway37* **Rotear nomes de modelos Claude**: mapear cada nome que os desenvolvedores usam para um modelo upstream. Claude Code envia um nome de modelo como `claude-sonnet-4-6` em cada solicitação; na maioria dos produtos de gateway o mapeamento é uma lista de modelos ou tabela de roteamento na própria configuração do gateway

38* **Encaminhar cabeçalhos e corpo sem alterações**: passar `anthropic-beta`, `anthropic-version` e o corpo da solicitação em ambas as direções; a [tabela de passagem de recursos](/pt/llm-gateway-protocol#feature-pass-through) mapeia cada um para o recurso que quebra sem ele38* **Encaminhar cabeçalhos e corpo sem alterações**: passar `anthropic-beta`, `anthropic-version` e o corpo da solicitação em ambas as direções; a [tabela de passagem de recursos](/docs/pt/llm-gateway-protocol#feature-pass-through) mapeia cada um para o recurso que quebra sem ele

39* **Retornar erros upstream não modificados**: a recuperação automática do Claude Code corresponde à redação do erro, portanto envolver erros no próprio envelope do gateway quebra isso39* **Retornar erros upstream não modificados**: a recuperação automática do Claude Code corresponde à redação do erro, portanto envolver erros no próprio envelope do gateway quebra isso

40* **Isentar o caminho da inspeção WAF do corpo da solicitação**: os prompts do Claude Code carregam código-fonte e tags de estilo XML que correspondem às regras do corpo de cross-site-scripting; um WAF na frente do gateway retorna `403` em sessões reais enquanto solicitações de teste curtas passam40* **Isentar o caminho da inspeção WAF do corpo da solicitação**: os prompts do Claude Code carregam código-fonte e tags de estilo XML que correspondem às regras do corpo de cross-site-scripting; um WAF na frente do gateway retorna `403` em sessões reais enquanto solicitações de teste curtas passam

41 41 

42Opcionalmente, sirva `GET /v1/models` para que Claude Code possa preencher o seletor de modelo do seu gateway com [descoberta de modelo](/pt/llm-gateway-protocol#model-discovery). {/* min-version: 2.1.129 */}42Opcionalmente, sirva `GET /v1/models` para que Claude Code possa preencher o seletor de modelo do seu gateway com [descoberta de modelo](/docs/pt/llm-gateway-protocol#model-discovery).&#x20;

43 43 

44<h2 id="rollout-steps">44<h2 id="rollout-steps">

45 Etapas de implantação45 Etapas de implantação


96Repita a solicitação uma vez por nome de modelo Claude na configuração de roteamento do seu gateway. Um nome que o gateway não roteia retorna `404` para qualquer desenvolvedor que o selecione, portanto teste cada nome antes da implantação.96Repita a solicitação uma vez por nome de modelo Claude na configuração de roteamento do seu gateway. Um nome que o gateway não roteia retorna `404` para qualquer desenvolvedor que o selecione, portanto teste cada nome antes da implantação.

97 97 

98<Note>98<Note>

99 Evite servir o gateway atrás de um redirecionamento. Um redirecionamento pode descartar o corpo da solicitação ou remover o cabeçalho de credencial em solicitações de inferência, e [descoberta de modelo](/pt/llm-gateway-protocol#model-discovery) trata qualquer redirecionamento como uma falha para que a credencial não possa vazar para um alvo de redirecionamento.99 Evite servir o gateway atrás de um redirecionamento. Um redirecionamento pode descartar o corpo da solicitação ou remover o cabeçalho de credencial em solicitações de inferência, e [descoberta de modelo](/docs/pt/llm-gateway-protocol#model-discovery) trata qualquer redirecionamento como uma falha para que a credencial não possa vazar para um alvo de redirecionamento.

100</Note>100</Note>

101 101 

102<h3 id="issue-developer-credentials">102<h3 id="issue-developer-credentials">


130 130 

131**Ponto de verificação**: um `200` com um campo `content` significa que a chave do desenvolvedor alcança o gateway e o gateway a encaminha. Um `401` aqui, quando [a etapa anterior](#confirm-the-gateway-routes-your-models) foi bem-sucedida, significa que a chave do desenvolvedor está errada ou ainda não entrou em vigor no gateway.131**Ponto de verificação**: um `200` com um campo `content` significa que a chave do desenvolvedor alcança o gateway e o gateway a encaminha. Um `401` aqui, quando [a etapa anterior](#confirm-the-gateway-routes-your-models) foi bem-sucedida, significa que a chave do desenvolvedor está errada ou ainda não entrou em vigor no gateway.

132 132 

133Emitir uma chave por desenvolvedor em vez de uma chave compartilhada é o que torna a atribuição de uso por desenvolvedor e o offboarding individual funcionarem. A variável de ambiente que contém a chave depende de qual cabeçalho o gateway lê. Para um gateway que verifica credenciais no cabeçalho `Authorization: Bearer`, os desenvolvedores definem sua chave em `ANTHROPIC_AUTH_TOKEN`. Para um gateway que lê chaves do cabeçalho `x-api-key`, os desenvolvedores definem `ANTHROPIC_API_KEY` em vez disso; a [tabela de credenciais](/pt/llm-gateway-connect#set-the-credential-variable) cobre o mapeamento.133Emitir uma chave por desenvolvedor em vez de uma chave compartilhada é o que torna a atribuição de uso por desenvolvedor e o offboarding individual funcionarem. A variável de ambiente que contém a chave depende de qual cabeçalho o gateway lê. Para um gateway que verifica credenciais no cabeçalho `Authorization: Bearer`, os desenvolvedores definem sua chave em `ANTHROPIC_AUTH_TOKEN`. Para um gateway que lê chaves do cabeçalho `x-api-key`, os desenvolvedores definem `ANTHROPIC_API_KEY` em vez disso; a [tabela de credenciais](/docs/pt/llm-gateway-connect#set-the-credential-variable) cobre o mapeamento.

134 134 

135<h3 id="test-claude-code-against-the-gateway">135<h3 id="test-claude-code-against-the-gateway">

136 Teste Claude Code contra o gateway136 Teste Claude Code contra o gateway


165* `Not logged in`: verifique o log do gateway para distinguir as duas causas. Se estiver vazio, nenhuma credencial alcançou a sessão e nenhuma solicitação saiu da máquina; re-execute as exportações no shell que você está testando. Se mostrar uma solicitação rejeitada com `x-api-key` no corpo `401`, o gateway espera chaves nesse cabeçalho em vez disso; mude para `ANTHROPIC_API_KEY`165* `Not logged in`: verifique o log do gateway para distinguir as duas causas. Se estiver vazio, nenhuma credencial alcançou a sessão e nenhuma solicitação saiu da máquina; re-execute as exportações no shell que você está testando. Se mostrar uma solicitação rejeitada com `x-api-key` no corpo `401`, o gateway espera chaves nesse cabeçalho em vez disso; mude para `ANTHROPIC_API_KEY`

166* `Failed to authenticate. API Error: 401` significa que uma credencial foi enviada e rejeitada, e o log do gateway diz onde: um `401` nomeando `api.anthropic.com` ou o endpoint do seu provedor significa que o gateway alcançou o upstream mas sua credencial de provedor foi rejeitada, portanto a chave do desenvolvedor funcionou e a credencial do provedor que o gateway detém está errada ou é um espaço reservado166* `Failed to authenticate. API Error: 401` significa que uma credencial foi enviada e rejeitada, e o log do gateway diz onde: um `401` nomeando `api.anthropic.com` ou o endpoint do seu provedor significa que o gateway alcançou o upstream mas sua credencial de provedor foi rejeitada, portanto a chave do desenvolvedor funcionou e a credencial do provedor que o gateway detém está errada ou é um espaço reservado

167 167 

168Uma URL base errada ou inacessível produz um sintoma diferente: Claude Code [tenta novamente a conexão com backoff](/pt/errors#automatic-retries) e pode ficar sem saída por vários minutos antes de relatar um erro. Se o comando parecer travar, verifique o log do gateway em vez de esperar; nenhuma solicitação chegando significa que `ANTHROPIC_BASE_URL` não aponta para o gateway.168Uma URL base errada ou inacessível produz um sintoma diferente: Claude Code [tenta novamente a conexão com backoff](/docs/pt/errors#automatic-retries) e pode ficar sem saída por vários minutos antes de relatar um erro. Se o comando parecer travar, verifique o log do gateway em vez de esperar; nenhuma solicitação chegando significa que `ANTHROPIC_BASE_URL` não aponta para o gateway.

169 169 

170<h3 id="distribute-the-configuration">170<h3 id="distribute-the-configuration">

171 Distribua a configuração171 Distribua a configuração

172</h3>172</h3>

173 173 

174Cada máquina de desenvolvedor precisa do endereço do gateway e de uma credencial. Você pode distribuí-los centralmente através de [configurações gerenciadas](/pt/settings#settings-files), para que os desenvolvedores não configurem nada, ou entregue aos desenvolvedores os valores para definir eles mesmos.174Cada máquina de desenvolvedor precisa do endereço do gateway e de uma credencial. Você pode distribuí-los centralmente através de [configurações gerenciadas](/docs/pt/settings#settings-files), para que os desenvolvedores não configurem nada, ou entregue aos desenvolvedores os valores para definir eles mesmos.

175 175 

176<h4 id="what-to-distribute">176<h4 id="what-to-distribute">

177 O que distribuir177 O que distribuir


186| `ANTHROPIC_CUSTOM_HEADERS` | Adiciona cabeçalhos HTTP extras a cada solicitação de API | Seu gateway requer um cabeçalho de locatário ou roteamento em cada solicitação |186| `ANTHROPIC_CUSTOM_HEADERS` | Adiciona cabeçalhos HTTP extras a cada solicitação de API | Seu gateway requer um cabeçalho de locatário ou roteamento em cada solicitação |

187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Consulta `/v1/models` do gateway na inicialização e adiciona os nomes retornados ao seletor `/model` | Seu gateway serve `/v1/models` e você quer que os seletores dos desenvolvedores sejam preenchidos a partir dele |187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Consulta `/v1/models` do gateway na inicialização e adiciona os nomes retornados ao seletor `/model` | Seu gateway serve `/v1/models` e você quer que os seletores dos desenvolvedores sejam preenchidos a partir dele |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Para Claude Code de enviar cabeçalhos de capacidade pré-lançamento e campos de corpo | Seu gateway encaminha para um upstream Bedrock ou Vertex que rejeita campos beta; consulte [Requisitos do gateway](#gateway-requirements) |188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Para Claude Code de enviar cabeçalhos de capacidade pré-lançamento e campos de corpo | Seu gateway encaminha para um upstream Bedrock ou Vertex que rejeita campos beta; consulte [Requisitos do gateway](#gateway-requirements) |

189| `ANTHROPIC_MODEL` ou [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/pt/model-config) | Define qual nome de modelo Claude Code solicita para a sessão principal e para tráfego de fundo | Seu gateway roteia nomes de modelos que não correspondem aos padrões do Claude Code, ou você roteia [funcionalidade de fundo](/pt/costs#background-token-usage) para um modelo diferente. Rotear tanto os nomes de substituição quanto os nomes padrão do Claude Code no gateway, já que algumas sub-chamadas podem solicitar o nome padrão independentemente da substituição |189| `ANTHROPIC_MODEL` ou [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/pt/model-config) | Define qual nome de modelo Claude Code solicita para a sessão principal e para tráfego de fundo | Seu gateway roteia nomes de modelos que não correspondem aos padrões do Claude Code, ou você roteia [funcionalidade de fundo](/docs/pt/costs#background-token-usage) para um modelo diferente. Rotear tanto os nomes de substituição quanto os nomes padrão do Claude Code no gateway, já que algumas sub-chamadas podem solicitar o nome padrão independentemente da substituição |

190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` com as [variáveis para esse provedor](/pt/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Aponte Claude Code para o gateway através de uma URL base específica do provedor. Bedrock e Vertex também mudam para o formato de solicitação nativo desses provedores | Seu gateway está na frente de Bedrock, Vertex, Foundry ou da Plataforma Claude no AWS; consulte [Formatos de API](/pt/llm-gateway-protocol#api-formats) |190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL` com as [variáveis para esse provedor](/docs/pt/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Aponte Claude Code para o gateway através de uma URL base específica do provedor. Bedrock e Vertex também mudam para o formato de solicitação nativo desses provedores | Seu gateway está na frente de Bedrock, Vertex, Foundry ou da Plataforma Claude no AWS; consulte [Formatos de API](/docs/pt/llm-gateway-protocol#api-formats) |

191 191 

192<h4 id="distribute-through-managed-settings">192<h4 id="distribute-through-managed-settings">

193 Distribua através de configurações gerenciadas193 Distribua através de configurações gerenciadas

194</h4>194</h4>

195 195 

196Entregue as variáveis através do bloco `env` de um [arquivo de configurações gerenciadas](/pt/settings#settings-files), enviado por MDM, política de registro ou gerenciamento de configuração:196Entregue as variáveis através do bloco `env` de um [arquivo de configurações gerenciadas](/docs/pt/settings#settings-files), enviado por MDM, política de registro ou gerenciamento de configuração:

197 197 

198```json theme={null}198```json theme={null}

199{199{


206 206 

207Adicione as variáveis condicionais da tabela ao mesmo bloco `env`. Um `ANTHROPIC_BASE_URL` gerenciado é imposto e não pode ser substituído pela exportação de shell de um desenvolvedor, já que Claude Code o aplica sobre o ambiente do processo e configurações de precedência inferior.207Adicione as variáveis condicionais da tabela ao mesmo bloco `env`. Um `ANTHROPIC_BASE_URL` gerenciado é imposto e não pode ser substituído pela exportação de shell de um desenvolvedor, já que Claude Code o aplica sobre o ambiente do processo e configurações de precedência inferior.

208 208 

209Não inclua `forceLoginMethod` ou `forceLoginOrgUUID` em configurações gerenciadas junto com uma credencial de gateway. No Claude Code v2.1.146 e posterior, qualquer chave bloqueia `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` e `apiKeyHelper` na inicialização, portanto os desenvolvedores veem `This machine's managed settings require a first-party login` e não podem prosseguir. {/* min-version: 2.1.146 */}209Não inclua `forceLoginMethod` ou `forceLoginOrgUUID` em configurações gerenciadas junto com uma credencial de gateway. No Claude Code v2.1.146 e posterior, qualquer chave bloqueia `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` e `apiKeyHelper` na inicialização, portanto os desenvolvedores veem `This machine's managed settings require a first-party login` e não podem prosseguir.&#x20;

210 210 

211A entrega de [configurações gerenciadas pelo servidor](/pt/server-managed-settings#platform-availability) requer uma conexão direta com `api.anthropic.com`, portanto não alcança sessões roteadas por gateway. As implantações de gateway usam este caminho de configurações gerenciadas baseado em arquivo, que impõe as mesmas chaves.211A entrega de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings#platform-availability) requer uma conexão direta com `api.anthropic.com`, portanto não alcança sessões roteadas por gateway. As implantações de gateway usam este caminho de configurações gerenciadas baseado em arquivo, que impõe as mesmas chaves.

212 212 

213Para a credencial, distribua um comando [`apiKeyHelper`](/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) no arquivo de configurações gerenciadas conforme mostrado acima; o comando autentica seu armazenamento de segredos como o desenvolvedor local, portanto cada máquina recebe sua própria chave. Alternativamente, entregue a cada desenvolvedor sua chave através do seu processo de segredos existente e peça-lhes para definir `ANTHROPIC_AUTH_TOKEN` eles mesmos.213Para a credencial, distribua um comando [`apiKeyHelper`](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) no arquivo de configurações gerenciadas conforme mostrado acima; o comando autentica seu armazenamento de segredos como o desenvolvedor local, portanto cada máquina recebe sua própria chave. Alternativamente, entregue a cada desenvolvedor sua chave através do seu processo de segredos existente e peça-lhes para definir `ANTHROPIC_AUTH_TOKEN` eles mesmos.

214 214 

215Alguns ambientes precisam de entrega separada:215Alguns ambientes precisam de entrega separada:

216 216 

217* O aplicativo de desktop lê o roteamento do gateway apenas de sua configuração de inferência de terceiros entregue por MDM; implante esse arquivo junto com configurações gerenciadas para que as sessões de desktop também roteiem através do gateway. Consulte a [documentação de configuração de terceiros do desktop](https://claude.com/docs/third-party/claude-desktop/configuration) e a [documentação de gateway do desktop](https://claude.com/docs/third-party/claude-desktop/gateway)217* O aplicativo de desktop lê o roteamento do gateway apenas de sua configuração de inferência de terceiros entregue por MDM; implante esse arquivo junto com configurações gerenciadas para que as sessões de desktop também roteiem através do gateway. Consulte a [documentação de configuração de terceiros do desktop](https://claude.com/docs/third-party/claude-desktop/configuration) e a [documentação de gateway do desktop](https://claude.com/docs/third-party/claude-desktop/gateway)

218* Os executores de CI precisam de `ANTHROPIC_BASE_URL` e a credencial definida no [ambiente do executor](/pt/llm-gateway-connect#configure-each-surface)218* Os executores de CI precisam de `ANTHROPIC_BASE_URL` e a credencial definida no [ambiente do executor](/docs/pt/llm-gateway-connect#configure-each-surface)

219* WSL em máquinas Windows gerenciadas lê as configurações gerenciadas do Windows apenas quando [`wslInheritsWindowsSettings`](/pt/settings#available-settings) é `true`219* WSL em máquinas Windows gerenciadas lê as configurações gerenciadas do Windows apenas quando [`wslInheritsWindowsSettings`](/docs/pt/settings#available-settings) é `true`

220 220 

221<h4 id="hand-developers-the-values-to-set-themselves">221<h4 id="hand-developers-the-values-to-set-themselves">

222 Entregue aos desenvolvedores os valores para definir eles mesmos222 Entregue aos desenvolvedores os valores para definir eles mesmos

223</h4>223</h4>

224 224 

225Se você não tiver distribuição de configurações gerenciadas em vigor, envie a cada desenvolvedor o que ele precisa para seguir a [página de conexão](/pt/llm-gateway-connect#configure-claude-code-yourself):225Se você não tiver distribuição de configurações gerenciadas em vigor, envie a cada desenvolvedor o que ele precisa para seguir a [página de conexão](/docs/pt/llm-gateway-connect#configure-claude-code-yourself):

226 226 

227* A URL do gateway227* A URL do gateway

228* Sua credencial pessoal228* Sua credencial pessoal

229* **Qual variável colocar a credencial em**: `ANTHROPIC_AUTH_TOKEN` para um gateway de token portador, ou `ANTHROPIC_API_KEY` para um gateway `x-api-key`. Dizer aos desenvolvedores qual economiza o trial-and-error descrito na [página de conexão](/pt/llm-gateway-connect#set-the-credential-variable)229* **Qual variável colocar a credencial em**: `ANTHROPIC_AUTH_TOKEN` para um gateway de token portador, ou `ANTHROPIC_API_KEY` para um gateway `x-api-key`. Dizer aos desenvolvedores qual economiza o trial-and-error descrito na [página de conexão](/docs/pt/llm-gateway-connect#set-the-credential-variable)

230* Quaisquer variáveis condicionais da [tabela O que distribuir](#what-to-distribute), com seus valores230* Quaisquer variáveis condicionais da [tabela O que distribuir](#what-to-distribute), com seus valores

231 231 

232A [página de conexão](/pt/llm-gateway-connect#configure-claude-code-yourself) orienta os desenvolvedores através da definição de cada uma.232A [página de conexão](/docs/pt/llm-gateway-connect#configure-claude-code-yourself) orienta os desenvolvedores através da definição de cada uma.

233 233 

234**Ponto de verificação**: em uma máquina de desenvolvedor, `claude` inicia uma sessão sem mostrar a tela de login, já que a credencial distribuída satisfaz a autenticação. Em seguida, execute `/status` e abra a aba **Status**: a linha `Anthropic base URL` mostra o endereço do gateway, e para distribuição gerenciada a linha `Setting sources` inclui configurações gerenciadas. Uma tela de login, ou uma linha `Anthropic base URL` ausente, significa que a configuração não alcançou a máquina.234**Ponto de verificação**: em uma máquina de desenvolvedor, `claude` inicia uma sessão sem mostrar a tela de login, já que a credencial distribuída satisfaz a autenticação. Em seguida, execute `/status` e abra a aba **Status**: a linha `Anthropic base URL` mostra o endereço do gateway, e para distribuição gerenciada a linha `Setting sources` inclui configurações gerenciadas. Uma tela de login, ou uma linha `Anthropic base URL` ausente, significa que a configuração não alcançou a máquina.

235 235 


270* Erros `Failed to authenticate` significam que o gateway está rejeitando solicitações; seu log diz qual credencial falhou. Uma rejeição que o gateway registra em si nomeia a chave do desenvolvedor, enquanto um `401` de `api.anthropic.com` ou do endpoint do seu provedor significa que a credencial do provedor que o gateway detém foi rejeitada270* Erros `Failed to authenticate` significam que o gateway está rejeitando solicitações; seu log diz qual credencial falhou. Uma rejeição que o gateway registra em si nomeia a chave do desenvolvedor, enquanto um `401` de `api.anthropic.com` ou do endpoint do seu provedor significa que a credencial do provedor que o gateway detém foi rejeitada

271* Um prompt de aprovação única para a chave é esperado no primeiro uso quando o gateway espera chaves no cabeçalho `x-api-key`, definido como `ANTHROPIC_API_KEY`. Com `ANTHROPIC_AUTH_TOKEN`, nenhum prompt aparece e a variável assume silenciosamente; um login claude.ai previamente salvo está inativo para essa sessão271* Um prompt de aprovação única para a chave é esperado no primeiro uso quando o gateway espera chaves no cabeçalho `x-api-key`, definido como `ANTHROPIC_API_KEY`. Com `ANTHROPIC_AUTH_TOKEN`, nenhum prompt aparece e a variável assume silenciosamente; um login claude.ai previamente salvo está inativo para essa sessão

272 272 

273Finalmente, verifique os logs do gateway para a mensagem que você enviou: a credencial identifica o desenvolvedor, e o [cabeçalho `x-claude-code-session-id`](/pt/llm-gateway-protocol#request-headers) agrupa solicitações por sessão. Se os recursos falharem com os [sintomas de solução de problemas](/pt/llm-gateway-connect#troubleshoot-gateway-errors), o gateway está removendo cabeçalhos ou reescrevendo erros; consulte os [requisitos do gateway](#gateway-requirements) acima.273Finalmente, verifique os logs do gateway para a mensagem que você enviou: a credencial identifica o desenvolvedor, e o [cabeçalho `x-claude-code-session-id`](/docs/pt/llm-gateway-protocol#request-headers) agrupa solicitações por sessão. Se os recursos falharem com os [sintomas de solução de problemas](/docs/pt/llm-gateway-connect#troubleshoot-gateway-errors), o gateway está removendo cabeçalhos ou reescrevendo erros; consulte os [requisitos do gateway](#gateway-requirements) acima.

274 274 

275<h2 id="maintain-the-gateway">275<h2 id="maintain-the-gateway">

276 Mantenha o gateway276 Mantenha o gateway


280 280 

281| Mudança | Sintoma quando o gateway não acompanhou | Ação |281| Mudança | Sintoma quando o gateway não acompanhou | Ação |

282| :--------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |282| :--------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

283| Novos lançamentos do Claude Code adicionam valores `anthropic-beta` e campos de corpo de solicitação | Os desenvolvedores relatam erros `400` nomeando um novo campo depois que atualizam Claude Code; consulte [passagem de recursos](/pt/llm-gateway-protocol#feature-pass-through) | Encaminhe cabeçalhos `anthropic-*` e corpos de solicitação verbatim em vez de usar lista de permissões; teste novos lançamentos do Claude Code contra o gateway antes de alcançarem os desenvolvedores |283| Novos lançamentos do Claude Code adicionam valores `anthropic-beta` e campos de corpo de solicitação | Os desenvolvedores relatam erros `400` nomeando um novo campo depois que atualizam Claude Code; consulte [passagem de recursos](/docs/pt/llm-gateway-protocol#feature-pass-through) | Encaminhe cabeçalhos `anthropic-*` e corpos de solicitação verbatim em vez de usar lista de permissões; teste novos lançamentos do Claude Code contra o gateway antes de alcançarem os desenvolvedores |

284| Novos modelos Claude ficam disponíveis | Os desenvolvedores selecionando um novo nome de modelo obtêm `404`; o seletor `/model` não o lista | Adicione o nome do modelo à configuração de roteamento do gateway, em seguida, re-execute a [verificação de roteamento](#confirm-the-gateway-routes-your-models). Se você distribuir `ANTHROPIC_MODEL` ou as variáveis de modelo padrão, atualize as configurações gerenciadas |284| Novos modelos Claude ficam disponíveis | Os desenvolvedores selecionando um novo nome de modelo obtêm `404`; o seletor `/model` não o lista | Adicione o nome do modelo à configuração de roteamento do gateway, em seguida, re-execute a [verificação de roteamento](#confirm-the-gateway-routes-your-models). Se você distribuir `ANTHROPIC_MODEL` ou as variáveis de modelo padrão, atualize as configurações gerenciadas |

285| Credenciais expiram ou precisam de rotação | Todas as solicitações de desenvolvedor começam a falhar com `401` do upstream | Rotacione a credencial do provedor do gateway em seu próprio cronograma; as chaves do desenvolvedor giram no gateway, e um [`apiKeyHelper`](/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) lida com rotação por desenvolvedor sem redistribuir configurações |285| Credenciais expiram ou precisam de rotação | Todas as solicitações de desenvolvedor começam a falhar com `401` do upstream | Rotacione a credencial do provedor do gateway em seu próprio cronograma; as chaves do desenvolvedor giram no gateway, e um [`apiKeyHelper`](/docs/pt/llm-gateway-connect#rotate-credentials-with-apikeyhelper) lida com rotação por desenvolvedor sem redistribuir configurações |

286 286 

287Ao dimensionar limites de taxa por chave, leve em conta o cliente [tentando novamente falhas transitórias](/pt/errors#automatic-retries), incluindo respostas `429`, até 10 vezes com backoff, honrando `Retry-After`. Mantenha a [referência do protocolo](/pt/llm-gateway-protocol) como o contrato para o que cada lançamento do Claude Code envia.287Ao dimensionar limites de taxa por chave, leve em conta o cliente [tentando novamente falhas transitórias](/docs/pt/errors#automatic-retries), incluindo respostas `429`, até 10 vezes com backoff, honrando `Retry-After`. Mantenha a [referência do protocolo](/docs/pt/llm-gateway-protocol) como o contrato para o que cada lançamento do Claude Code envia.

288 288 

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

290 Recursos relacionados290 Recursos relacionados

291</h2>291</h2>

292 292 

293* [Conectar Claude Code a um gateway LLM](/pt/llm-gateway-connect): as etapas de configuração voltadas para o desenvolvedor, com configuração por superfície e uma tabela de solução de problemas que você pode entregar aos desenvolvedores293* [Conectar Claude Code a um gateway LLM](/docs/pt/llm-gateway-connect): as etapas de configuração voltadas para o desenvolvedor, com configuração por superfície e uma tabela de solução de problemas que você pode entregar aos desenvolvedores

294* [Referência do protocolo do gateway](/pt/llm-gateway-protocol): o contrato de fio para operadores de gateway, cobrindo endpoints, cabeçalhos para encaminhar e a tabela de passagem de recursos294* [Referência do protocolo do gateway](/docs/pt/llm-gateway-protocol): o contrato de fio para operadores de gateway, cobrindo endpoints, cabeçalhos para encaminhar e a tabela de passagem de recursos

295* [Arquivos de configurações e precedência](/pt/settings#settings-files): como configurações gerenciadas, de projeto e de usuário se combinam, e onde o arquivo gerenciado vai em cada plataforma295* [Arquivos de configurações e precedência](/docs/pt/settings#settings-files): como configurações gerenciadas, de projeto e de usuário se combinam, e onde o arquivo gerenciado vai em cada plataforma

296* [Configure Claude Code para sua organização](/pt/admin-setup): a implantação mais ampla da qual este gateway é uma parte, incluindo imposição de política, visibilidade de uso e tratamento de dados296* [Configure Claude Code para sua organização](/docs/pt/admin-setup): a implantação mais ampla da qual este gateway é uma parte, incluindo imposição de política, visibilidade de uso e tratamento de dados

managed-mcp.md +24 −24

Details

6 6 

7> Restrinja quais servidores MCP os usuários podem adicionar ou conectar com arquivos de configuração gerenciados, listas de permissão e listas de bloqueio.7> Restrinja quais servidores MCP os usuários podem adicionar ou conectar com arquivos de configuração gerenciados, listas de permissão e listas de bloqueio.

8 8 

9Por padrão, qualquer pessoa que execute Claude Code pode conectar qualquer [servidor MCP](/pt/mcp) que escolher. A Anthropic analisa conectores em relação aos seus [critérios de listagem](https://claude.com/docs/connectors/building/review-criteria) antes de adicioná-los ao [Diretório Anthropic](https://claude.ai/directory), mas não realiza auditoria de segurança ou gerencia nenhum servidor MCP. Como administrador, você pode restringir quais servidores são executados em sua organização, desde a implantação de um conjunto fixo aprovado até a desabilitação completa do MCP.9Por padrão, qualquer pessoa que execute Claude Code pode conectar qualquer [servidor MCP](/docs/pt/mcp) que escolher. A Anthropic analisa conectores em relação aos seus [critérios de listagem](https://claude.com/docs/connectors/building/review-criteria) antes de adicioná-los ao [Diretório Anthropic](https://claude.ai/directory), mas não realiza auditoria de segurança ou gerencia nenhum servidor MCP. Como administrador, você pode restringir quais servidores são executados em sua organização, desde a implantação de um conjunto fixo aprovado até a desabilitação completa do MCP.

10 10 

11Esta página aborda como:11Esta página aborda como:

12 12 


17* [Monitorar quais servidores sua organização realmente usa](#monitor-mcp-usage)17* [Monitorar quais servidores sua organização realmente usa](#monitor-mcp-usage)

18 18 

19<Note>19<Note>

20 A página [Segurança](/pt/security) aborda o modelo de ameaça do MCP e como avaliar um servidor antes de aprová-lo. [Decidir o que aplicar](/pt/admin-setup#decide-what-to-enforce) aborda restrições de MCP junto com os outros controles administrativos.20 A página [Segurança](/docs/pt/security) aborda o modelo de ameaça do MCP e como avaliar um servidor antes de aprová-lo. [Decidir o que aplicar](/docs/pt/admin-setup#decide-what-to-enforce) aborda restrições de MCP junto com os outros controles administrativos.

21</Note>21</Note>

22 22 

23<h2 id="choose-a-pattern">23<h2 id="choose-a-pattern">


31| **Desabilitar MCP** | Nenhum servidor é carregado em lugar nenhum | `managed-mcp.json` com um mapa de servidor vazio |31| **Desabilitar MCP** | Nenhum servidor é carregado em lugar nenhum | `managed-mcp.json` com um mapa de servidor vazio |

32| **Implantação fixa** | Cada usuário obtém os mesmos servidores e não pode adicionar outros | `managed-mcp.json` com os servidores que você deseja |32| **Implantação fixa** | Cada usuário obtém os mesmos servidores e não pode adicionar outros | `managed-mcp.json` com os servidores que você deseja |

33| **Catálogo aprovado** | Publique uma lista de servidores aprovados; os usuários adicionam os que desejam, qualquer outro é bloqueado | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |33| **Catálogo aprovado** | Publique uma lista de servidores aprovados; os usuários adicionam os que desejam, qualquer outro é bloqueado | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |

34| **Apenas servidores de plugins** | Os servidores podem vir apenas de plugins; os usuários não podem adicionar os seus próprios | [`strictPluginOnlyCustomization`](/pt/settings#strictpluginonlycustomization) com `mcp` na lista |34| **Apenas servidores de plugins** | Os servidores podem vir apenas de plugins; os usuários não podem adicionar os seus próprios | [`strictPluginOnlyCustomization`](/docs/pt/settings#strictpluginonlycustomization) com `mcp` na lista |

35| **Lista de permissão suave** | Aplicar uma lista de permissão que os usuários podem ampliar em suas próprias configurações | `allowedMcpServers` sem `allowManagedMcpServersOnly` |35| **Lista de permissão suave** | Aplicar uma lista de permissão que os usuários podem ampliar em suas próprias configurações | `allowedMcpServers` sem `allowManagedMcpServersOnly` |

36| **Apenas lista de bloqueio** | Bloqueie servidores conhecidos como ruins, permita tudo o mais | `deniedMcpServers` |36| **Apenas lista de bloqueio** | Bloqueie servidores conhecidos como ruins, permita tudo o mais | `deniedMcpServers` |

37| **Sem restrições** | Os usuários adicionam qualquer coisa | Não implante nenhuma configuração gerenciada de MCP |37| **Sem restrições** | Os usuários adicionam qualquer coisa | Não implante nenhuma configuração gerenciada de MCP |

38 38 

39<Note>39<Note>

40 Claude Code não possui um registro de servidor MCP integrado que os usuários possam procurar e instalar. Para o padrão de catálogo aprovado, compartilhe a lista aprovada e seus comandos `claude mcp add` em algum lugar onde seus usuários a encontrem, como um wiki interno, ou distribua os servidores como plugins através de um [marketplace de plugins gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) para que os usuários possam procurar e instalá-los em `/plugin`.40 Claude Code não possui um registro de servidor MCP integrado que os usuários possam procurar e instalar. Para o padrão de catálogo aprovado, compartilhe a lista aprovada e seus comandos `claude mcp add` em algum lugar onde seus usuários a encontrem, como um wiki interno, ou distribua os servidores como plugins através de um [marketplace de plugins gerenciado](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) para que os usuários possam procurar e instalá-los em `/plugin`.

41</Note>41</Note>

42 42 

43<h2 id="exclusive-control-with-managed-mcp-json">43<h2 id="exclusive-control-with-managed-mcp-json">


53 53 

54Consulte [Como um servidor é avaliado](#how-a-server-is-evaluated) para a ordem completa de verificações.54Consulte [Como um servidor é avaliado](#how-a-server-is-evaluated) para a ordem completa de verificações.

55 55 

56`managed-mcp.json` é um arquivo autônomo, portanto não pode ser entregue através de [configurações gerenciadas pelo servidor](/pt/server-managed-settings). Qualquer processo que possa escrever em um caminho do sistema com privilégios de administrador pode implantá-lo. Em escala, isso geralmente é feito através de ferramentas de gerenciamento de dispositivos, como Jamf ou um perfil de configuração no macOS, Política de Grupo ou Intune no Windows, ou seu gerenciamento de frota de escolha no Linux. Claude Code procura o arquivo em um destes caminhos:56`managed-mcp.json` é um arquivo autônomo, portanto não pode ser entregue através de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings). Qualquer processo que possa escrever em um caminho do sistema com privilégios de administrador pode implantá-lo. Em escala, isso geralmente é feito através de ferramentas de gerenciamento de dispositivos, como Jamf ou um perfil de configuração no macOS, Política de Grupo ou Intune no Windows, ou seu gerenciamento de frota de escolha no Linux. Claude Code procura o arquivo em um destes caminhos:

57 57 

58| Plataforma | Caminho |58| Plataforma | Caminho |

59| :---------- | :--------------------------------------------------------- |59| :---------- | :--------------------------------------------------------- |


61| Linux e WSL | `/etc/claude-code/managed-mcp.json` |61| Linux e WSL | `/etc/claude-code/managed-mcp.json` |

62| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |62| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |

63 63 

64O arquivo usa o mesmo formato que um arquivo de projeto [`.mcp.json`](/pt/mcp#project-scope):64O arquivo usa o mesmo formato que um arquivo de projeto [`.mcp.json`](/docs/pt/mcp#project-scope):

65 65 

66```json theme={null}66```json theme={null}

67{67{


92 92 

93Qualquer usuário na máquina pode ler este arquivo, portanto não armazene chaves de API ou outras credenciais em blocos `env`. Passe credenciais por usuário com uma destas alternativas:93Qualquer usuário na máquina pode ler este arquivo, portanto não armazene chaves de API ou outras credenciais em blocos `env`. Passe credenciais por usuário com uma destas alternativas:

94 94 

95* [Expansão `${VAR}`](/pt/mcp#environment-variable-expansion-in-mcp-json) para ler segredos do ambiente de cada usuário.95* [Expansão `${VAR}`](/docs/pt/mcp#environment-variable-expansion-in-mcp-json) para ler segredos do ambiente de cada usuário.

96* [OAuth ou cabeçalhos por usuário](/pt/mcp#authenticate-with-remote-mcp-servers) para que cada usuário se autentique como si mesmo.96* [OAuth ou cabeçalhos por usuário](/docs/pt/mcp#authenticate-with-remote-mcp-servers) para que cada usuário se autentique como si mesmo.

97* [`headersHelper`](/pt/mcp#use-dynamic-headers-for-custom-authentication) para gerar credenciais no momento da conexão.97* [`headersHelper`](/docs/pt/mcp#use-dynamic-headers-for-custom-authentication) para gerar credenciais no momento da conexão.

98 98 

99<h3 id="validate-the-configuration">99<h3 id="validate-the-configuration">

100 Validar a configuração100 Validar a configuração


123 Permitir conectores do claude.ai junto com o conjunto gerenciado123 Permitir conectores do claude.ai junto com o conjunto gerenciado

124</h3>124</h3>

125 125 

126Implantar `managed-mcp.json` suprime [conectores do claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) por padrão, incluindo conectores que um administrador configurou para a organização no console de administração do claude.ai. Para carregar esses conectores junto com os servidores em `managed-mcp.json`, defina `"allowAllClaudeAiMcps": true` em uma [fonte de configurações gerenciadas](/pt/admin-setup#decide-how-settings-reach-devices). Requer Claude Code v2.1.149 ou posterior.126Implantar `managed-mcp.json` suprime [conectores do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) por padrão, incluindo conectores que um administrador configurou para a organização no console de administração do claude.ai. Para carregar esses conectores junto com os servidores em `managed-mcp.json`, defina `"allowAllClaudeAiMcps": true` em uma [fonte de configurações gerenciadas](/docs/pt/admin-setup#decide-how-settings-reach-devices). Requer Claude Code v2.1.149 ou posterior.

127 127 

128Com a configuração ativada, Claude Code carrega os mesmos conectores do claude.ai que carregaria se `managed-mcp.json` não fosse implantado. [Listas de permissão e listas de negação](#policy-based-control-with-allowlists-and-denylists) ainda se aplicam a esses conectores, portanto você pode bloquear específicos com `deniedMcpServers`. A configuração afeta apenas conectores do claude.ai; servidores fornecidos por plugins permanecem suprimidos.128Com a configuração ativada, Claude Code carrega os mesmos conectores do claude.ai que carregaria se `managed-mcp.json` não fosse implantado. [Listas de permissão e listas de negação](#policy-based-control-with-allowlists-and-denylists) ainda se aplicam a esses conectores, portanto você pode bloquear específicos com `deniedMcpServers`. A configuração afeta apenas conectores do claude.ai; servidores fornecidos por plugins permanecem suprimidos.

129 129 


133 Controle baseado em política com listas de permissão e listas de bloqueio133 Controle baseado em política com listas de permissão e listas de bloqueio

134</h2>134</h2>

135 135 

136Listas de permissão e listas de bloqueio filtram quais servidores configurados podem ser carregados. Elas não são um registro: um servidor ainda precisa ser adicionado por um usuário, um plugin ou `managed-mcp.json` antes que a lista de permissão ou lista de bloqueio se aplique a ele. Para implantar servidores para usuários, use [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json). Ambas as listas também filtram servidores passados com o sinalizador CLI [`--mcp-config`](/pt/cli-reference#cli-flags); `--strict-mcp-config` limita quais arquivos de configuração são carregados e não contorna nenhuma das duas listas.136Listas de permissão e listas de bloqueio filtram quais servidores configurados podem ser carregados. Elas não são um registro: um servidor ainda precisa ser adicionado por um usuário, um plugin ou `managed-mcp.json` antes que a lista de permissão ou lista de bloqueio se aplique a ele. Para implantar servidores para usuários, use [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json). Ambas as listas também filtram servidores passados com o sinalizador CLI [`--mcp-config`](/docs/pt/cli-reference#cli-flags); `--strict-mcp-config` limita quais arquivos de configuração são carregados e não contorna nenhuma das duas listas.

137 137 

138Para tornar a lista de permissão autoritária, defina `allowedMcpServers` e `allowManagedMcpServersOnly: true` juntos em uma [fonte de configurações gerenciadas](/pt/admin-setup#decide-how-settings-reach-devices), como configurações gerenciadas pelo servidor ou um arquivo `managed-settings.json` implantado. [Restringir a lista de permissão apenas a configurações gerenciadas](#restrict-the-allowlist-to-managed-settings-only) mostra a configuração. Sem `allowManagedMcpServersOnly`, listas de permissão de todas as fontes de configurações são mescladas, incluindo o próprio `~/.claude/settings.json` de um usuário, portanto um usuário pode ampliar o que sua lista de permissão permite. Listas de bloqueio são mescladas de todas as fontes independentemente.138Para tornar a lista de permissão autoritária, defina `allowedMcpServers` e `allowManagedMcpServersOnly: true` juntos em uma [fonte de configurações gerenciadas](/docs/pt/admin-setup#decide-how-settings-reach-devices), como configurações gerenciadas pelo servidor ou um arquivo `managed-settings.json` implantado. [Restringir a lista de permissão apenas a configurações gerenciadas](#restrict-the-allowlist-to-managed-settings-only) mostra a configuração. Sem `allowManagedMcpServersOnly`, listas de permissão de todas as fontes de configurações são mescladas, incluindo o próprio `~/.claude/settings.json` de um usuário, portanto um usuário pode ampliar o que sua lista de permissão permite. Listas de bloqueio são mescladas de todas as fontes independentemente.

139 139 

140<Note>140<Note>

141 `allowManagedMcpServersOnly` é separado de `allowManagedPermissionRulesOnly`, que bloqueia apenas [regras de permissão](/pt/permissions#managed-settings). Definir esse sinalizador não aplica a lista de permissão de MCP.141 `allowManagedMcpServersOnly` é separado de `allowManagedPermissionRulesOnly`, que bloqueia apenas [regras de permissão](/docs/pt/permissions#managed-settings). Definir esse sinalizador não aplica a lista de permissão de MCP.

142</Note>142</Note>

143 143 

144<h3 id="match-servers-by-url-command-or-name">144<h3 id="match-servers-by-url-command-or-name">


160| `allowedMcpServers` | Todos os servidores permitidos | Nenhum servidor permitido | Apenas servidores correspondentes permitidos |160| `allowedMcpServers` | Todos os servidores permitidos | Nenhum servidor permitido | Apenas servidores correspondentes permitidos |

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

162 162 

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

164 164 

165<Warning>165<Warning>

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


168 168 

169A validação de `serverName` difere entre as duas listas:169A validação de `serverName` difere entre as duas listas:

170 170 

171* {/* min-version: 2.1.182 */}Em `deniedMcpServers`, `serverName` aceita qualquer string não vazia, portanto você pode bloquear [conectores claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) por seu nome de exibição. Por exemplo, `{ "serverName": "claude.ai Slack" }` bloqueia o conector Slack. Prefira uma entrada `serverUrl` quando você precisar que a negação seja robusta a renomeações, ou quando um nome de conector colide e ganha um sufixo ` (N)`.171* Em `deniedMcpServers`, `serverName` aceita qualquer string não vazia, portanto você pode bloquear [conectores claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) por seu nome de exibição. Por exemplo, `{ "serverName": "claude.ai Slack" }` bloqueia o conector Slack. Prefira uma entrada `serverUrl` quando você precisar que a negação seja robusta a renomeações, ou quando um nome de conector colide e ganha um sufixo ` (N)`.

172* Em `allowedMcpServers`, `serverName` é limitado a letras, números, hífens e sublinhados. Use `serverUrl` para adicionar um conector claude.ai à lista de permissão.172* Em `allowedMcpServers`, `serverName` é limitado a letras, números, hífens e sublinhados. Use `serverUrl` para adicionar um conector claude.ai à lista de permissão.

173 173 

174Para desativar todos os conectores claude.ai, veja [`disableClaudeAiConnectors`](/pt/mcp#disable-claude-ai-connectors).174Para desativar todos os conectores claude.ai, veja [`disableClaudeAiConnectors`](/docs/pt/mcp#disable-claude-ai-connectors).

175 175 

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

177 Como um servidor é avaliado177 Como um servidor é avaliado


191Três regras de correspondência se aplicam dentro dessas verificações:191Três regras de correspondência se aplicam dentro dessas verificações:

192 192 

193* **Comandos correspondem exatamente.** Cada argumento, em ordem. `["npx", "-y", "server"]` não corresponde a `["npx", "server"]` ou `["npx", "-y", "server", "--flag"]`.193* **Comandos correspondem exatamente.** Cada argumento, em ordem. `["npx", "-y", "server"]` não corresponde a `["npx", "server"]` ou `["npx", "-y", "server", "--flag"]`.

194* **`serverCommand` e `serverUrl` valores se expandem antes de corresponder.** Tanto a entrada de política quanto o valor configurado do servidor passam pela mesma [expansão `${VAR}` e `${VAR:-default}`](/pt/mcp#environment-variable-expansion-in-mcp-json) que `.mcp.json`, portanto uma entrada escrita como `["${HOME}/bin/server"]` corresponde a uma configuração de servidor que usa a mesma referência ou o caminho expandido. No Windows, faça referência a uma variável de ambiente que está definida lá, como `${USERPROFILE}` em vez de `${HOME}`. Os valores de `serverName` correspondem literalmente e nunca se expandem.194* **`serverCommand` e `serverUrl` valores se expandem antes de corresponder.** Tanto a entrada de política quanto o valor configurado do servidor passam pela mesma [expansão `${VAR}` e `${VAR:-default}`](/docs/pt/mcp#environment-variable-expansion-in-mcp-json) que `.mcp.json`, portanto uma entrada escrita como `["${HOME}/bin/server"]` corresponde a uma configuração de servidor que usa a mesma referência ou o caminho expandido. No Windows, faça referência a uma variável de ambiente que está definida lá, como `${USERPROFILE}` em vez de `${HOME}`. Os valores de `serverName` correspondem literalmente e nunca se expandem.

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

196 196 

197| Padrão | Permite |197| Padrão | Permite |


363 Monitorar o uso de MCP363 Monitorar o uso de MCP

364</h2>364</h2>

365 365 

366Quando [exportação OpenTelemetry](/pt/monitoring-usage) está configurada, Claude Code pode registrar quais servidores MCP e ferramentas os usuários invocam. Defina `OTEL_LOG_TOOL_DETAILS=1` para incluir nomes de servidor MCP e ferramentas em eventos de ferramentas, depois agregue-os em seu coletor para ver quais servidores seus usuários realmente conectam. Consulte [Monitoramento](/pt/monitoring-usage) para configurar o exportador e para o esquema de evento completo.366Quando [exportação OpenTelemetry](/docs/pt/monitoring-usage) está configurada, Claude Code pode registrar quais servidores MCP e ferramentas os usuários invocam. Defina `OTEL_LOG_TOOL_DETAILS=1` para incluir nomes de servidor MCP e ferramentas em eventos de ferramentas, depois agregue-os em seu coletor para ver quais servidores seus usuários realmente conectam. Consulte [Monitoramento](/docs/pt/monitoring-usage) para configurar o exportador e para o esquema de evento completo.

367 367 

368<h2 id="configuration-summary">368<h2 id="configuration-summary">

369 Resumo de configuração369 Resumo de configuração


374| Superfície | O que controla | Onde fica | Como entregar |374| Superfície | O que controla | Onde fica | Como entregar |

375| :--------------------------- | :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |375| :--------------------------- | :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

376| `managed-mcp.json` | Conjunto de servidor fixo, controle exclusivo | Caminho do sistema: `/Library/Application Support/ClaudeCode/`, `/etc/claude-code/`, ou `C:\Program Files\ClaudeCode\` | MDM, GPO, gerenciamento de frota ou qualquer processo com privilégios de administrador. Não pode ser definido através de configurações gerenciadas pelo servidor |376| `managed-mcp.json` | Conjunto de servidor fixo, controle exclusivo | Caminho do sistema: `/Library/Application Support/ClaudeCode/`, `/etc/claude-code/`, ou `C:\Program Files\ClaudeCode\` | MDM, GPO, gerenciamento de frota ou qualquer processo com privilégios de administrador. Não pode ser definido através de configurações gerenciadas pelo servidor |

377| `allowedMcpServers` | Lista de permissão de servidores permitidos | Qualquer [arquivo de configurações](/pt/settings#settings-files); entradas de todas as fontes são mescladas a menos que `allowManagedMcpServersOnly` esteja definido | Para aplicação, uma [fonte de configurações gerenciadas](/pt/admin-setup#decide-how-settings-reach-devices): configurações gerenciadas pelo servidor, `managed-settings.json`, perfil MDM ou registro |377| `allowedMcpServers` | Lista de permissão de servidores permitidos | Qualquer [arquivo de configurações](/docs/pt/settings#settings-files); entradas de todas as fontes são mescladas a menos que `allowManagedMcpServersOnly` esteja definido | Para aplicação, uma [fonte de configurações gerenciadas](/docs/pt/admin-setup#decide-how-settings-reach-devices): configurações gerenciadas pelo servidor, `managed-settings.json`, perfil MDM ou registro |

378| `deniedMcpServers` | Lista de bloqueio de servidores bloqueados | Qualquer arquivo de configurações; entradas de todas as fontes são mescladas | Mesmo que `allowedMcpServers` |378| `deniedMcpServers` | Lista de bloqueio de servidores bloqueados | Qualquer arquivo de configurações; entradas de todas as fontes são mescladas | Mesmo que `allowedMcpServers` |

379| `allowManagedMcpServersOnly` | Bloqueia a lista de permissão apenas para fontes gerenciadas | Apenas fontes de configurações gerenciadas; a configuração não tem efeito em outro lugar | Mesmo que `allowedMcpServers` |379| `allowManagedMcpServersOnly` | Bloqueia a lista de permissão apenas para fontes gerenciadas | Apenas fontes de configurações gerenciadas; a configuração não tem efeito em outro lugar | Mesmo que `allowedMcpServers` |

380| `allowAllClaudeAiMcps` | Carrega conectores claude.ai junto com `managed-mcp.json` em vez de suprimi-los | Apenas fontes de configurações gerenciadas; a configuração não tem efeito em outro lugar | Mesmo que `allowedMcpServers` |380| `allowAllClaudeAiMcps` | Carrega conectores claude.ai junto com `managed-mcp.json` em vez de suprimi-los | Apenas fontes de configurações gerenciadas; a configuração não tem efeito em outro lugar | Mesmo que `allowedMcpServers` |


383 Recursos relacionados383 Recursos relacionados

384</h2>384</h2>

385 385 

386* [Decidir o que aplicar](/pt/admin-setup#decide-what-to-enforce): restrições de MCP junto com regras de permissão, sandboxing e os outros controles de administrador386* [Decidir o que aplicar](/docs/pt/admin-setup#decide-what-to-enforce): restrições de MCP junto com regras de permissão, sandboxing e os outros controles de administrador

387* [Conectar Claude Code a ferramentas via MCP](/pt/mcp): a referência completa de MCP, incluindo transportes, escopos e autenticação387* [Conectar Claude Code a ferramentas via MCP](/docs/pt/mcp): a referência completa de MCP, incluindo transportes, escopos e autenticação

388* [Configurações](/pt/settings): a hierarquia de configurações e como as configurações gerenciadas têm precedência388* [Configurações](/docs/pt/settings): a hierarquia de configurações e como as configurações gerenciadas têm precedência

389* [Configurações gerenciadas pelo servidor](/pt/server-managed-settings): entregar `allowedMcpServers` e `deniedMcpServers` do console de administrador do Claude.ai389* [Configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings): entregar `allowedMcpServers` e `deniedMcpServers` do console de administrador do Claude.ai

390* [Segurança](/pt/security): o modelo de ameaça que esses controles defendem390* [Segurança](/docs/pt/security): o modelo de ameaça que esses controles defendem

391* [Guia do Administrador Empresarial Claude](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, gerenciamento de assentos e playbook de implementação391* [Guia do Administrador Empresarial Claude](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, gerenciamento de assentos e playbook de implementação

mcp.md +36 −36

Details

10 10 

11Conecte um servidor quando você se encontrar copiando dados para o chat de outra ferramenta, como um rastreador de problemas ou um painel de monitoramento. Uma vez conectado, Claude pode ler e agir nesse sistema diretamente em vez de trabalhar com o que você cola.11Conecte um servidor quando você se encontrar copiando dados para o chat de outra ferramenta, como um rastreador de problemas ou um painel de monitoramento. Uma vez conectado, Claude pode ler e agir nesse sistema diretamente em vez de trabalhar com o que você cola.

12 12 

13Se você está conectando seu primeiro servidor, comece com o [guia de início rápido do MCP](/pt/mcp-quickstart) para um passo a passo detalhado. Esta página é a referência completa.13Se você está conectando seu primeiro servidor, comece com o [guia de início rápido do MCP](/docs/pt/mcp-quickstart) para um passo a passo detalhado. Esta página é a referência completa.

14 14 

15<h2 id="what-you-can-do-with-mcp">15<h2 id="what-you-can-do-with-mcp">

16 O que você pode fazer com MCP16 O que você pode fazer com MCP


23* **Consultar bancos de dados**: "Encontre emails de 10 usuários aleatórios que usaram o recurso ENG-4521, com base no nosso banco de dados PostgreSQL."23* **Consultar bancos de dados**: "Encontre emails de 10 usuários aleatórios que usaram o recurso ENG-4521, com base no nosso banco de dados PostgreSQL."

24* **Integrar designs**: "Atualize nosso modelo de email padrão com base nos novos designs do Figma que foram postados no Slack"24* **Integrar designs**: "Atualize nosso modelo de email padrão com base nos novos designs do Figma que foram postados no Slack"

25* **Automatizar fluxos de trabalho**: "Crie rascunhos do Gmail convidando esses 10 usuários para uma sessão de feedback sobre o novo recurso."25* **Automatizar fluxos de trabalho**: "Crie rascunhos do Gmail convidando esses 10 usuários para uma sessão de feedback sobre o novo recurso."

26* **Reagir a eventos externos**: Um servidor MCP também pode atuar como um [canal](/pt/channels) que envia mensagens para sua sessão, para que Claude reaja a mensagens do Telegram, chats do Discord ou eventos de webhook enquanto você está ausente.26* **Reagir a eventos externos**: Um servidor MCP também pode atuar como um [canal](/docs/pt/channels) que envia mensagens para sua sessão, para que Claude reaja a mensagens do Telegram, chats do Discord ou eventos de webhook enquanto você está ausente.

27 27 

28<h2 id="find-and-build-mcp-servers">28<h2 id="find-and-build-mcp-servers">

29 Encontre e crie servidores MCP29 Encontre e crie servidores MCP


32Navegue por conectores revisados no [Diretório Anthropic](https://claude.ai/directory). Os conectores do Diretório usam a mesma infraestrutura MCP que Claude Code, então você pode adicionar qualquer servidor remoto listado lá com `claude mcp add`.32Navegue por conectores revisados no [Diretório Anthropic](https://claude.ai/directory). Os conectores do Diretório usam a mesma infraestrutura MCP que Claude Code, então você pode adicionar qualquer servidor remoto listado lá com `claude mcp add`.

33 33 

34<Warning>34<Warning>

35 Verifique se você confia em cada servidor antes de conectá-lo. Servidores que buscam conteúdo externo podem expô-lo ao [risco de injeção de prompt](/pt/security#protect-against-prompt-injection).35 Verifique se você confia em cada servidor antes de conectá-lo. Servidores que buscam conteúdo externo podem expô-lo ao [risco de injeção de prompt](/docs/pt/security#protect-against-prompt-injection).

36</Warning>36</Warning>

37 37 

38Para criar seu próprio servidor, consulte o [guia do servidor MCP](https://modelcontextprotocol.io/docs/develop/build-server) para os fundamentos do protocolo e a [documentação de construção de conectores Claude](https://claude.com/docs/connectors/building) para autenticação, testes e envio ao Diretório.38Para criar seu próprio servidor, consulte o [guia do servidor MCP](https://modelcontextprotocol.io/docs/develop/build-server) para os fundamentos do protocolo e a [documentação de construção de conectores Claude](https://claude.com/docs/connectors/building) para autenticação, testes e envio ao Diretório.


115 115 

116Claude Code define `CLAUDE_PROJECT_DIR` no ambiente do servidor gerado para a raiz do projeto, para que seu servidor possa resolver caminhos relativos ao projeto sem depender do diretório de trabalho. Este é o mesmo diretório que hooks recebem em sua variável `CLAUDE_PROJECT_DIR`. Leia-o de dentro do seu processo de servidor, por exemplo `process.env.CLAUDE_PROJECT_DIR` em Node ou `os.environ["CLAUDE_PROJECT_DIR"]` em Python.116Claude Code define `CLAUDE_PROJECT_DIR` no ambiente do servidor gerado para a raiz do projeto, para que seu servidor possa resolver caminhos relativos ao projeto sem depender do diretório de trabalho. Este é o mesmo diretório que hooks recebem em sua variável `CLAUDE_PROJECT_DIR`. Leia-o de dentro do seu processo de servidor, por exemplo `process.env.CLAUDE_PROJECT_DIR` em Node ou `os.environ["CLAUDE_PROJECT_DIR"]` em Python.

117 117 

118`CLAUDE_PROJECT_DIR` é a raiz do projeto estável e não muda quando você adiciona ou remove diretórios de trabalho durante a sessão. Um servidor que limita seu próprio acesso ao sistema de arquivos a um conjunto de diretórios permitidos deve implementar a solicitação MCP `roots/list` em vez disso. Claude Code responde a `roots/list` com o diretório de inicialização da sessão mais cada [diretório de trabalho adicional](/pt/permissions#working-directories) que você concedeu com `--add-dir`, `/add-dir`, ou a configuração `additionalDirectories`. Claude Code envia `notifications/roots/list_changed` quando esse conjunto muda. Antes da v2.1.203, `roots/list` retornava apenas o diretório de inicialização e Claude Code não enviava `notifications/roots/list_changed`.118`CLAUDE_PROJECT_DIR` é a raiz do projeto estável e não muda quando você adiciona ou remove diretórios de trabalho durante a sessão. Um servidor que limita seu próprio acesso ao sistema de arquivos a um conjunto de diretórios permitidos deve implementar a solicitação MCP `roots/list` em vez disso. Claude Code responde a `roots/list` com o diretório de inicialização da sessão mais cada [diretório de trabalho adicional](/docs/pt/permissions#working-directories) que você concedeu com `--add-dir`, `/add-dir`, ou a configuração `additionalDirectories`. Claude Code envia `notifications/roots/list_changed` quando esse conjunto muda. Antes da v2.1.203, `roots/list` retornava apenas o diretório de inicialização e Claude Code não enviava `notifications/roots/list_changed`.

119 119 

120Esta variável é definida no ambiente do servidor, não no ambiente do próprio Claude Code, portanto referenciá-la via expansão `${VAR}` em um `.mcp.json` com escopo de projeto ou usuário `command` ou `args` requer um padrão como `${CLAUDE_PROJECT_DIR:-.}`. As configurações MCP fornecidas por plugins substituem `${CLAUDE_PROJECT_DIR}` diretamente e não precisam do padrão.120Esta variável é definida no ambiente do servidor, não no ambiente do próprio Claude Code, portanto referenciá-la via expansão `${VAR}` em um `.mcp.json` com escopo de projeto ou usuário `command` ou `args` requer um padrão como `${CLAUDE_PROJECT_DIR:-.}`. As configurações MCP fornecidas por plugins substituem `${CLAUDE_PROJECT_DIR}` diretamente e não precisam do padrão.

121 121 


180 180 

181Servidores com escopo de projeto de `.mcp.json` que estão aguardando sua aprovação aparecem em `claude mcp list` como `⏸ Pending approval`. Execute `claude` interativamente para revisar e aprovar. `claude mcp get <name>` mostra servidores pendentes como `⏸ Pending approval` e servidores rejeitados como `✗ Rejected`.181Servidores com escopo de projeto de `.mcp.json` que estão aguardando sua aprovação aparecem em `claude mcp list` como `⏸ Pending approval`. Execute `claude` interativamente para revisar e aprovar. `claude mcp get <name>` mostra servidores pendentes como `⏸ Pending approval` e servidores rejeitados como `✗ Rejected`.

182 182 

183A partir da v2.1.196, `claude mcp list` e `claude mcp get` leem aprovações `.mcp.json` apenas de arquivos de configurações que não estão verificados no repositório até que você confie no workspace executando `claude` nele e aceitando a caixa de diálogo de confiança do workspace. Um repositório clonado não pode aprovar seus próprios servidores: [`enableAllProjectMcpServers` ou `enabledMcpjsonServers`](/pt/settings#available-settings) confirmado no `.claude/settings.json` do projeto é ignorado em uma pasta não confiável, e o servidor permanece em `⏸ Pending approval` em vez de estar conectado e verificado de saúde.183A partir da v2.1.196, `claude mcp list` e `claude mcp get` leem aprovações `.mcp.json` apenas de arquivos de configurações que não estão verificados no repositório até que você confie no workspace executando `claude` nele e aceitando a caixa de diálogo de confiança do workspace. Um repositório clonado não pode aprovar seus próprios servidores: [`enableAllProjectMcpServers` ou `enabledMcpjsonServers`](/docs/pt/settings#available-settings) confirmado no `.claude/settings.json` do projeto é ignorado em uma pasta não confiável, e o servidor permanece em `⏸ Pending approval` em vez de estar conectado e verificado de saúde.

184 184 

185As aprovações dessas fontes ainda se aplicam em uma pasta não confiável:185As aprovações dessas fontes ainda se aplicam em uma pasta não confiável:

186 186 


188* configurações gerenciadas188* configurações gerenciadas

189* configurações passadas com `--settings`189* configurações passadas com `--settings`

190 190 

191As aprovações em um `.claude/settings.local.json` não rastreado também se aplicam, mas apenas depois que você aceita uma caixa de diálogo de confiança para essa pasta ou um de seus diretórios pai: Claude Code executa git para verificar se o arquivo é rastreado, e executa essa verificação apenas em uma pasta confiável. Em uma pasta que você nunca confiou, as aprovações do arquivo aguardam a caixa de diálogo de confiança a menos que a pasta seja seu diretório de configuração pessoal: seu diretório inicial, ou um diretório cujo `.claude` você definiu como [`CLAUDE_CONFIG_DIR`](/pt/env-vars). Antes da v2.1.207, um `.claude/settings.local.json` não rastreado aprovava servidores em uma pasta que você nunca tinha confiado.191As aprovações em um `.claude/settings.local.json` não rastreado também se aplicam, mas apenas depois que você aceita uma caixa de diálogo de confiança para essa pasta ou um de seus diretórios pai: Claude Code executa git para verificar se o arquivo é rastreado, e executa essa verificação apenas em uma pasta confiável. Em uma pasta que você nunca confiou, as aprovações do arquivo aguardam a caixa de diálogo de confiança a menos que a pasta seja seu diretório de configuração pessoal: seu diretório inicial, ou um diretório cujo `.claude` você definiu como [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars). Antes da v2.1.207, um `.claude/settings.local.json` não rastreado aprovava servidores em uma pasta que você nunca tinha confiado.

192 192 

193Uma entrada `disabledMcpjsonServers` em qualquer arquivo de configurações ainda rejeita o servidor.193Uma entrada `disabledMcpjsonServers` em qualquer arquivo de configurações ainda rejeita o servidor.

194 194 

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

196 196 

197Um servidor remoto cuja configuração tem uma `url` vazia aparece como `not configured` em `/mcp`, em `claude mcp list` e no gerenciador [`/plugin`](/pt/plugins), e Claude Code não tenta se conectar a ele. Um plugin pode incluir uma entrada de espaço reservado como esta para um conector que você configura depois, para que Claude Code não o relate como um erro ou um problema de configuração. A visualização de detalhes do servidor em `/mcp` lê `No URL configured for this server`; defina a `url` da entrada para se conectar. Antes da v2.1.208, Claude Code relatava uma `url` vazia como um problema de configuração com um prompt para reconectar.197Um servidor remoto cuja configuração tem uma `url` vazia aparece como `not configured` em `/mcp`, em `claude mcp list` e no gerenciador [`/plugin`](/docs/pt/plugins), e Claude Code não tenta se conectar a ele. Um plugin pode incluir uma entrada de espaço reservado como esta para um conector que você configura depois, para que Claude Code não o relate como um erro ou um problema de configuração. A visualização de detalhes do servidor em `/mcp` lê `No URL configured for this server`; defina a `url` da entrada para se conectar. Antes da v2.1.208, Claude Code relatava uma `url` vazia como um problema de configuração com um prompt para reconectar.

198 198 

199Se sua solicitação precisar de ferramentas de um servidor que ainda está se conectando em segundo plano, Claude aguarda esse servidor antes de continuar. Com [pesquisa de ferramentas](#scale-with-mcp-tool-search) habilitada, que é o padrão, a espera acontece dentro da chamada `ToolSearch`. Em configurações sem pesquisa de ferramentas, como Plataforma de Agente do Google Cloud, um `ANTHROPIC_BASE_URL` personalizado, ou `ENABLE_TOOL_SEARCH=false`, Claude usa a ferramenta `WaitForMcpServers` em vez disso.199Se sua solicitação precisar de ferramentas de um servidor que ainda está se conectando em segundo plano, Claude aguarda esse servidor antes de continuar. Com [pesquisa de ferramentas](#scale-with-mcp-tool-search) habilitada, que é o padrão, a espera acontece dentro da chamada `ToolSearch`. Em configurações sem pesquisa de ferramentas, como Plataforma de Agente do Google Cloud, um `ANTHROPIC_BASE_URL` personalizado, ou `ENABLE_TOOL_SEARCH=false`, Claude usa a ferramenta `WaitForMcpServers` em vez disso.

200 200 

201Alguns nomes de servidor são reservados para os servidores integrados do Claude Code: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` e `Claude Browser`. Se sua configuração define um servidor com um nome reservado, Claude Code o ignora no tempo de carregamento e mostra um aviso pedindo que você o renomeie. `claude mcp add` rejeita um nome reservado com um erro.201Alguns nomes de servidor são reservados para os servidores integrados do Claude Code: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` e `Claude Browser`. Se sua configuração define um servidor com um nome reservado, Claude Code o ignora no tempo de carregamento e mostra um aviso pedindo que você o renomeie. `claude mcp add` rejeita um nome reservado com um erro.

202 202 

203`Claude Preview` e `Claude Browser` nomeiam o servidor integrado que o [painel de visualização do aplicativo desktop Claude Code](/pt/desktop#preview-your-app) usa. Antes da v2.1.205, `Claude Browser` não era reservado, portanto um servidor configurado pelo usuário poderia se registrar sob esse nome.203`Claude Preview` e `Claude Browser` nomeiam o servidor integrado que o [painel de visualização do aplicativo desktop Claude Code](/docs/pt/desktop#preview-your-app) usa. Antes da v2.1.205, `Claude Browser` não era reservado, portanto um servidor configurado pelo usuário poderia se registrar sob esse nome.

204 204 

205<h3 id="dynamic-tool-updates">205<h3 id="dynamic-tool-updates">

206 Atualizações dinâmicas de ferramentas206 Atualizações dinâmicas de ferramentas


224 Enviar mensagens com canais224 Enviar mensagens com canais

225</h3>225</h3>

226 226 

227Um servidor MCP também pode enviar mensagens diretamente para sua sessão para que Claude possa reagir a eventos externos como resultados de CI, alertas de monitoramento ou mensagens de chat. Para habilitar isso, seu servidor declara a capacidade `claude/channel` e você a ativa com a flag `--channels` na inicialização. Veja [Canais](/pt/channels) para usar um canal oficialmente suportado, ou [Referência de canais](/pt/channels-reference) para construir o seu próprio.227Um servidor MCP também pode enviar mensagens diretamente para sua sessão para que Claude possa reagir a eventos externos como resultados de CI, alertas de monitoramento ou mensagens de chat. Para habilitar isso, seu servidor declara a capacidade `claude/channel` e você a ativa com a flag `--channels` na inicialização. Veja [Canais](/docs/pt/channels) para usar um canal oficialmente suportado, ou [Referência de canais](/docs/pt/channels-reference) para construir o seu próprio.

228 228 

229<Tip>229<Tip>

230 Dicas:230 Dicas:


241 * Use `/mcp` para autenticar com servidores remotos que exigem autenticação OAuth 2.0241 * Use `/mcp` para autenticar com servidores remotos que exigem autenticação OAuth 2.0

242</Tip>242</Tip>

243 243 

244O `timeout` por servidor é um limite de tempo de parede rígido por chamada de ferramenta, e notificações de progresso do servidor não o estendem. Valores abaixo de 1000 são ignorados e caem para `MCP_TOOL_TIMEOUT`, ou para seu padrão de cerca de 28 horas quando essa variável não está definida. Para um servidor HTTP, SSE ou [conector claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) também há um segundo temporizador por solicitação que cobre cada solicitação até o primeiro byte de resposta do servidor. Esse temporizador é de 60 segundos a menos que você defina o `timeout` por servidor ou `MCP_TOOL_TIMEOUT`; definir um para 60 segundos ou superior aumenta o temporizador por solicitação para esse valor, um valor inferior não o encurta, e o padrão de 28 horas de um `MCP_TOOL_TIMEOUT` não definido nunca o alimenta. Servidores Stdio e WebSocket não têm temporizador por solicitação. {/* min-version: 2.1.162 */}Antes da v2.1.162, valores abaixo de 1000 eram arredondados para um segundo.244O `timeout` por servidor é um limite de tempo de parede rígido por chamada de ferramenta, e notificações de progresso do servidor não o estendem. Valores abaixo de 1000 são ignorados e caem para `MCP_TOOL_TIMEOUT`, ou para seu padrão de cerca de 28 horas quando essa variável não está definida. Para um servidor HTTP, SSE ou [conector claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) também há um segundo temporizador por solicitação que cobre cada solicitação até o primeiro byte de resposta do servidor. Esse temporizador é de 60 segundos a menos que você defina o `timeout` por servidor ou `MCP_TOOL_TIMEOUT`; definir um para 60 segundos ou superior aumenta o temporizador por solicitação para esse valor, um valor inferior não o encurta, e o padrão de 28 horas de um `MCP_TOOL_TIMEOUT` não definido nunca o alimenta. Servidores Stdio e WebSocket não têm temporizador por solicitação. Antes da v2.1.162, valores abaixo de 1000 eram arredondados para um segundo.

245 245 

246Um `timeout` por servidor de pelo menos 1000 também atua como um piso no tempo limite de inatividade descrito abaixo: Claude Code nunca aborta as chamadas de ferramenta desse servidor por inatividade mais cedo do que o `timeout` por servidor. Requer Claude Code v2.1.203 ou posterior.246Um `timeout` por servidor de pelo menos 1000 também atua como um piso no tempo limite de inatividade descrito abaixo: Claude Code nunca aborta as chamadas de ferramenta desse servidor por inatividade mais cedo do que o `timeout` por servidor. Requer Claude Code v2.1.203 ou posterior.

247 247 

248Uma chamada de ferramenta para um servidor MCP que não envia resposta e nenhuma notificação de progresso pela janela de inatividade é abortada com um erro em vez de aguardar o limite de tempo de parede. O tempo limite de inatividade requer Claude Code v2.1.187 ou posterior. {/* min-version: 2.1.203 */}Aplica-se a todos os tipos de servidor, exceto servidores IDE e servidores em processo do SDK. A janela de inatividade padrão é de cinco minutos para servidores HTTP, SSE, WebSocket e [conector claude.ai](#use-mcp-servers-from-claude-ai), e de 30 minutos para servidores stdio. Antes da v2.1.203, servidores stdio eram isentos do tempo limite de inatividade.248Uma chamada de ferramenta para um servidor MCP que não envia resposta e nenhuma notificação de progresso pela janela de inatividade é abortada com um erro em vez de aguardar o limite de tempo de parede. O tempo limite de inatividade requer Claude Code v2.1.187 ou posterior. Aplica-se a todos os tipos de servidor, exceto servidores IDE e servidores em processo do SDK. A janela de inatividade padrão é de cinco minutos para servidores HTTP, SSE, WebSocket e [conector claude.ai](#use-mcp-servers-from-claude-ai), e de 30 minutos para servidores stdio. Antes da v2.1.203, servidores stdio eram isentos do tempo limite de inatividade.

249 249 

250Defina a variável de ambiente [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/pt/env-vars) em milissegundos para alterar a janela de inatividade, ou defina-a como `0` para desabilitar a verificação.250Defina a variável de ambiente [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/pt/env-vars) em milissegundos para alterar a janela de inatividade, ou defina-a como `0` para desabilitar a verificação.

251 251 

252<h3 id="plugin-provided-mcp-servers">252<h3 id="plugin-provided-mcp-servers">

253 Servidores MCP fornecidos por plugins253 Servidores MCP fornecidos por plugins

254</h3>254</h3>

255 255 

256[Plugins](/pt/plugins) podem agrupar servidores MCP, fornecendo automaticamente ferramentas e integrações quando o plugin está habilitado. Os servidores MCP de plugins funcionam de forma idêntica aos servidores configurados pelo usuário.256[Plugins](/docs/pt/plugins) podem agrupar servidores MCP, fornecendo automaticamente ferramentas e integrações quando o plugin está habilitado. Os servidores MCP de plugins funcionam de forma idêntica aos servidores configurados pelo usuário.

257 257 

258**Como funcionam os servidores MCP de plugins**:258**Como funcionam os servidores MCP de plugins**:

259 259 


297**Recursos de MCP de plugin**:297**Recursos de MCP de plugin**:

298 298 

299* **Ciclo de vida automático**: Na inicialização da sessão, os servidores para plugins habilitados se conectam automaticamente. Se você habilitar ou desabilitar um plugin durante uma sessão, execute `/reload-plugins` para conectar ou desconectar seus servidores MCP299* **Ciclo de vida automático**: Na inicialização da sessão, os servidores para plugins habilitados se conectam automaticamente. Se você habilitar ou desabilitar um plugin durante uma sessão, execute `/reload-plugins` para conectar ou desconectar seus servidores MCP

300* **Variáveis de caminho**: `${CLAUDE_PLUGIN_ROOT}` resolve para o diretório de instalação do plugin, `${CLAUDE_PLUGIN_DATA}` para seu diretório de [estado persistente](/pt/plugins-reference#persistent-data-directory), e `${CLAUDE_PROJECT_DIR}` para a raiz do projeto estável. A substituição se aplica a:300* **Variáveis de caminho**: `${CLAUDE_PLUGIN_ROOT}` resolve para o diretório de instalação do plugin, `${CLAUDE_PLUGIN_DATA}` para seu diretório de [estado persistente](/docs/pt/plugins-reference#persistent-data-directory), e `${CLAUDE_PROJECT_DIR}` para a raiz do projeto estável. A substituição se aplica a:

301 * servidores `stdio`: `command`, `args`, `env`301 * servidores `stdio`: `command`, `args`, `env`

302 * servidores `http`, `sse` e `ws`: `url`, `headers` e `headersHelper`. {/* min-version: 2.1.195 */}Antes da v2.1.195, `headersHelper` passava o espaço reservado como uma string literal302 * servidores `http`, `sse` e `ws`: `url`, `headers` e `headersHelper`. Antes da v2.1.195, `headersHelper` passava o espaço reservado como uma string literal

303* **Acesso a variáveis de ambiente do usuário**: Acesso às mesmas variáveis de ambiente que servidores configurados manualmente303* **Acesso a variáveis de ambiente do usuário**: Acesso às mesmas variáveis de ambiente que servidores configurados manualmente

304* **Múltiplos tipos de transporte**: Suporte para transportes stdio, SSE, HTTP e WebSocket, embora o suporte de transporte possa variar por servidor304* **Múltiplos tipos de transporte**: Suporte para transportes stdio, SSE, HTTP e WebSocket, embora o suporte de transporte possa variar por servidor

305 305 


320mcp__plugin_my-plugin_database-tools__query320mcp__plugin_my-plugin_database-tools__query

321```321```

322 322 

323Use este nome completo ao referenciar a ferramenta em [regras de permissão](/pt/permissions), na lista `allowed-tools` de uma skill, em um [campo `tools` de um subagente](/pt/sub-agents#available-tools), ou em um [matcher de hook](/pt/hooks#match-mcp-tools). Um matcher de hook escrito contra a chave do servidor simples, como `mcp__database-tools__.*`, nunca dispara para um servidor agrupado em um plugin.323Use este nome completo ao referenciar a ferramenta em [regras de permissão](/docs/pt/permissions), na lista `allowed-tools` de uma skill, em um [campo `tools` de um subagente](/docs/pt/sub-agents#available-tools), ou em um [matcher de hook](/docs/pt/hooks#match-mcp-tools). Um matcher de hook escrito contra a chave do servidor simples, como `mcp__database-tools__.*`, nunca dispara para um servidor agrupado em um plugin.

324 324 

325O servidor em si se registra sob o nome com escopo `plugin:<plugin-name>:<server-name>`, como `plugin:my-plugin:database-tools`. Use esse nome onde um nome de servidor configurado é esperado, como em um [campo `server` de um hook `mcp_tool`](/pt/hooks#mcp-tool-hook-fields).325O servidor em si se registra sob o nome com escopo `plugin:<plugin-name>:<server-name>`, como `plugin:my-plugin:database-tools`. Use esse nome onde um nome de servidor configurado é esperado, como em um [campo `server` de um hook `mcp_tool`](/docs/pt/hooks#mcp-tool-hook-fields).

326 326 

327**Benefícios dos servidores MCP de plugins**:327**Benefícios dos servidores MCP de plugins**:

328 328 


330* **Configuração automática**: Nenhuma configuração MCP manual necessária330* **Configuração automática**: Nenhuma configuração MCP manual necessária

331* **Consistência da equipe**: Todos obtêm as mesmas ferramentas quando o plugin está instalado331* **Consistência da equipe**: Todos obtêm as mesmas ferramentas quando o plugin está instalado

332 332 

333Veja a [referência de componentes de plugins](/pt/plugins-reference#mcp-servers) para detalhes sobre como agrupar servidores MCP com plugins.333Veja a [referência de componentes de plugins](/docs/pt/plugins-reference#mcp-servers) para detalhes sobre como agrupar servidores MCP com plugins.

334 334 

335<h2 id="mcp-installation-scopes">335<h2 id="mcp-installation-scopes">

336 Escopos de instalação de MCP336 Escopos de instalação de MCP


351O escopo local é o padrão. Um servidor com escopo local carrega apenas no projeto onde você o adicionou e permanece privado para você. Claude Code o armazena em `~/.claude.json` sob o caminho desse projeto, então o mesmo servidor não aparecerá em seus outros projetos. Use o escopo local para servidores de desenvolvimento pessoal, configurações experimentais ou servidores com credenciais que você não deseja no controle de versão.351O escopo local é o padrão. Um servidor com escopo local carrega apenas no projeto onde você o adicionou e permanece privado para você. Claude Code o armazena em `~/.claude.json` sob o caminho desse projeto, então o mesmo servidor não aparecerá em seus outros projetos. Use o escopo local para servidores de desenvolvimento pessoal, configurações experimentais ou servidores com credenciais que você não deseja no controle de versão.

352 352 

353<Note>353<Note>

354 O termo "escopo local" para servidores MCP difere das configurações locais gerais. Os servidores MCP com escopo local são armazenados em `~/.claude.json` (seu diretório inicial), enquanto as configurações locais gerais usam `.claude/settings.local.json` (no diretório do projeto). Veja [Configurações](/pt/settings#settings-files) para detalhes sobre localizações de arquivos de configuração.354 O termo "escopo local" para servidores MCP difere das configurações locais gerais. Os servidores MCP com escopo local são armazenados em `~/.claude.json` (seu diretório inicial), enquanto as configurações locais gerais usam `.claude/settings.local.json` (no diretório do projeto). Veja [Configurações](/docs/pt/settings#settings-files) para detalhes sobre localizações de arquivos de configuração.

355</Note>355</Note>

356 356 

357```bash theme={null}357```bash theme={null}


4261. Escopo local4261. Escopo local

4272. Escopo de projeto4272. Escopo de projeto

4283. Escopo de usuário4283. Escopo de usuário

4294. [Servidores fornecidos por plugins](/pt/plugins)4294. [Servidores fornecidos por plugins](/docs/pt/plugins)

4305. [Conectores claude.ai](#use-mcp-servers-from-claude-ai)4305. [Conectores claude.ai](#use-mcp-servers-from-claude-ai)

431 431 

432Os três escopos correspondem duplicatas por nome. Plugins e conectores correspondem por endpoint, então um que aponta para a mesma URL ou comando que um servidor acima é tratado como uma duplicata.432Os três escopos correspondem duplicatas por nome. Plugins e conectores correspondem por endpoint, então um que aponta para a mesma URL ou comando que um servidor acima é tratado como uma duplicata.


805| :---------------------------- | :------------------------------------------------------------------------------------------------------------------- |805| :---------------------------- | :------------------------------------------------------------------------------------------------------------------- |

806| `CLAUDE_CODE_MCP_SERVER_NAME` | o nome do servidor MCP |806| `CLAUDE_CODE_MCP_SERVER_NAME` | o nome do servidor MCP |

807| `CLAUDE_CODE_MCP_SERVER_URL` | a URL do servidor MCP |807| `CLAUDE_CODE_MCP_SERVER_URL` | a URL do servidor MCP |

808| `CLAUDE_PLUGIN_ROOT` | o diretório raiz do plugin. Definido apenas quando um [plugin](/pt/plugins-reference#mcp-servers) fornece o servidor |808| `CLAUDE_PLUGIN_ROOT` | o diretório raiz do plugin. Definido apenas quando um [plugin](/docs/pt/plugins-reference#mcp-servers) fornece o servidor |

809 809 

810Use essas para escrever um único script auxiliar que serve múltiplos servidores MCP.810Use essas para escrever um único script auxiliar que serve múltiplos servidores MCP.

811 811 

812Para um servidor fornecido por plugin, o auxiliar também é executado com seu diretório de trabalho definido para a raiz do plugin, para que um caminho `headersHelper` relativo seja resolvido dentro do diretório do plugin em vez de contra o diretório de trabalho da sessão. Requer Claude Code v2.1.195 ou posterior.812Para um servidor fornecido por plugin, o auxiliar também é executado com seu diretório de trabalho definido para a raiz do plugin, para que um caminho `headersHelper` relativo seja resolvido dentro do diretório do plugin em vez de contra o diretório de trabalho da sessão. Requer Claude Code v2.1.195 ou posterior.

813 813 

814Um `headersHelper` fornecido por plugin não pode referenciar os valores [`${user_config.*}`](/pt/plugins-reference#user-configuration) do plugin, porque o comando é executado através de um shell. Claude Code relata o servidor como mal configurado com um [erro](/pt/errors#plugin-command-references-user-config) e não substitui o valor. Coloque `${user_config.KEY}` no campo `headers` do servidor, que não é analisado por shell, ou faça o script auxiliar ler o valor de seu próprio ambiente ou de um arquivo de configuração. Antes da v2.1.207, `headersHelper` substituía valores `${user_config.*}`.814Um `headersHelper` fornecido por plugin não pode referenciar os valores [`${user_config.*}`](/docs/pt/plugins-reference#user-configuration) do plugin, porque o comando é executado através de um shell. Claude Code relata o servidor como mal configurado com um [erro](/docs/pt/errors#plugin-command-references-user-config) e não substitui o valor. Coloque `${user_config.KEY}` no campo `headers` do servidor, que não é analisado por shell, ou faça o script auxiliar ler o valor de seu próprio ambiente ou de um arquivo de configuração. Antes da v2.1.207, `headersHelper` substituía valores `${user_config.*}`.

815 815 

816<Note>816<Note>

817 `headersHelper` executa comandos shell arbitrários. Quando definido no escopo de projeto ou local, ele só é executado após você aceitar o diálogo de confiança do espaço de trabalho.817 `headersHelper` executa comandos shell arbitrários. Quando definido no escopo de projeto ou local, ele só é executado após você aceitar o diálogo de confiança do espaço de trabalho.


920 920 

921A partir da v2.1.161, conectores aos quais você nunca fez login estão recolhidos atrás de uma linha `Show unused connectors` no final da seção claude.ai, para que uma lista provisionada pela organização não preencha o painel. Selecione a linha para expandi-los. Um conector ao qual você fez login antes permanece visível mesmo quando atualmente precisa de re-autenticação.921A partir da v2.1.161, conectores aos quais você nunca fez login estão recolhidos atrás de uma linha `Show unused connectors` no final da seção claude.ai, para que uma lista provisionada pela organização não preencha o painel. Selecione a linha para expandi-los. Um conector ao qual você fez login antes permanece visível mesmo quando atualmente precisa de re-autenticação.

922 922 

923Os conectores do claude.ai são buscados apenas quando seu [método de autenticação](/pt/authentication#authentication-precedence) ativo é sua assinatura do claude.ai. Eles não são carregados quando `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper`, ou um provedor de terceiros como Amazon Bedrock ou Google Cloud's Agent Platform está ativo, mesmo que você tenha executado `/login` anteriormente.923Os conectores do claude.ai são buscados apenas quando seu [método de autenticação](/docs/pt/authentication#authentication-precedence) ativo é sua assinatura do claude.ai. Eles não são carregados quando `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper`, ou um provedor de terceiros como Amazon Bedrock ou Google Cloud's Agent Platform está ativo, mesmo que você tenha executado `/login` anteriormente.

924 924 

925Se `/mcp` não listar um conector que você adicionou, execute `/status` para confirmar qual método de autenticação está ativo, desdefina essa variável de ambiente ou remova a configuração `apiKeyHelper`, depois execute `/login` para selecionar sua conta do claude.ai.925Se `/mcp` não listar um conector que você adicionou, execute `/status` para confirmar qual método de autenticação está ativo, desdefina essa variável de ambiente ou remova a configuração `apiKeyHelper`, depois execute `/login` para selecionar sua conta do claude.ai.

926 926 


934 934 

935Sua organização pode definir controles por ferramenta em [conectores do claude.ai](https://claude.com/docs/connectors). O Claude Code lê essas configurações na inicialização e as aplica localmente. Execute `/mcp` para ver qual configuração se aplica a cada ferramenta em um conector.935Sua organização pode definir controles por ferramenta em [conectores do claude.ai](https://claude.com/docs/connectors). O Claude Code lê essas configurações na inicialização e as aplica localmente. Execute `/mcp` para ver qual configuração se aplica a cada ferramenta em um conector.

936 936 

937* **Ferramenta definida como `ask`**: O Claude Code solicita em cada chamada com o motivo `Your organization requires approval for this tool`. O prompt aparece mesmo em [modos de permissão](/pt/permissions#permission-modes) `acceptEdits`, `auto` e `bypassPermissions`, e nunca oferece uma opção para lembrar sua escolha. [Regras de permissão](/pt/permissions) que correspondem à ferramenta também não pulam o prompt. No modo `dontAsk`, que nunca solicita, o Claude Code nega a chamada.937* **Ferramenta definida como `ask`**: O Claude Code solicita em cada chamada com o motivo `Your organization requires approval for this tool`. O prompt aparece mesmo em [modos de permissão](/docs/pt/permissions#permission-modes) `acceptEdits`, `auto` e `bypassPermissions`, e nunca oferece uma opção para lembrar sua escolha. [Regras de permissão](/docs/pt/permissions) que correspondem à ferramenta também não pulam o prompt. No modo `dontAsk`, que nunca solicita, o Claude Code nega a chamada.

938* **Ferramenta definida como `blocked`**: O Claude Code filtra a ferramenta antes do Claude vê-la, então ela nunca aparece na lista de ferramentas.938* **Ferramenta definida como `blocked`**: O Claude Code filtra a ferramenta antes do Claude vê-la, então ela nunca aparece na lista de ferramentas.

939 939 

940Aplicar esses controles requer Claude Code v2.1.129 ou posterior. Versões anteriores ignoram as configurações e aplicam o fluxo de permissão padrão.940Aplicar esses controles requer Claude Code v2.1.129 ou posterior. Versões anteriores ignoram as configurações e aplicam o fluxo de permissão padrão.


943 Desabilitar conectores do claude.ai943 Desabilitar conectores do claude.ai

944</h3>944</h3>

945 945 

946Para desabilitar servidores MCP do claude.ai no Claude Code, defina [`disableClaudeAiConnectors`](/pt/settings#available-settings) como `true` em qualquer escopo de configurações:946Para desabilitar servidores MCP do claude.ai no Claude Code, defina [`disableClaudeAiConnectors`](/docs/pt/settings#available-settings) como `true` em qualquer escopo de configurações:

947 947 

948```json theme={null}948```json theme={null}

949{949{


959ENABLE_CLAUDEAI_MCP_SERVERS=false claude959ENABLE_CLAUDEAI_MCP_SERVERS=false claude

960```960```

961 961 

962Para bloquear conectores individuais do claude.ai em vez de todos eles, adicione-os a [`deniedMcpServers`](/pt/managed-mcp) por nome ou por padrão de URL. Por exemplo, uma entrada `serverName` de `"claude.ai Slack"` bloqueia o conector Slack. Para alternar um conector ligado ou desligado apenas para o projeto atual, use o painel `/mcp`.962Para bloquear conectores individuais do claude.ai em vez de todos eles, adicione-os a [`deniedMcpServers`](/docs/pt/managed-mcp) por nome ou por padrão de URL. Por exemplo, uma entrada `serverName` de `"claude.ai Slack"` bloqueia o conector Slack. Para alternar um conector ligado ou desligado apenas para o projeto atual, use o painel `/mcp`.

963 963 

964<Note>964<Note>

965 Estas configurações do lado do cliente governam sessões locais do Claude Code. Em sessões do [Claude Code na web](/pt/claude-code-on-the-web), conectores do claude.ai são provisionados pelo host remoto e chegam como entradas explícitas `--mcp-config`, então `disableClaudeAiConnectors` não se aplica lá. URLs de conectores também são reescritas através do proxy de sessão, então um padrão `serverUrl` de `deniedMcpServers` direcionado à URL do fornecedor não corresponderá. Gerencie quais conectores uma sessão em nuvem pode usar a partir das configurações da sua organização no claude.ai.965 Estas configurações do lado do cliente governam sessões locais do Claude Code. Em sessões do [Claude Code na web](/docs/pt/claude-code-on-the-web), conectores do claude.ai são provisionados pelo host remoto e chegam como entradas explícitas `--mcp-config`, então `disableClaudeAiConnectors` não se aplica lá. URLs de conectores também são reescritas através do proxy de sessão, então um padrão `serverUrl` de `deniedMcpServers` direcionado à URL do fornecedor não corresponderá. Gerencie quais conectores uma sessão em nuvem pode usar a partir das configurações da sua organização no claude.ai.

966</Note>966</Note>

967 967 

968<h2 id="use-claude-code-as-an-mcp-server">968<h2 id="use-claude-code-as-an-mcp-server">


1095 1095 

1096Se você está construindo um servidor MCP, você pode marcar uma ferramenta como exigindo aprovação explícita a cada chamada definindo `_meta["anthropic/requiresUserInteraction"]` como `true` na entrada da ferramenta em resposta `tools/list`. O valor deve ser o booleano JSON `true`; qualquer outro valor é ignorado.1096Se você está construindo um servidor MCP, você pode marcar uma ferramenta como exigindo aprovação explícita a cada chamada definindo `_meta["anthropic/requiresUserInteraction"]` como `true` na entrada da ferramenta em resposta `tools/list`. O valor deve ser o booleano JSON `true`; qualquer outro valor é ignorado.

1097 1097 

1098Claude Code mostra o prompt de permissão dessa ferramenta a cada chamada, mesmo em modos de permissão `acceptEdits`, `auto` e `bypassPermissions` [permission modes](/pt/permissions#permission-modes), e não oferece uma opção "não pergunte novamente" para ela. [Regras de permissão](/pt/permissions#permission-rule-syntax) que correspondem à ferramenta também não pulam o prompt. No modo `dontAsk`, que nunca solicita, Claude Code nega a chamada em vez disso.1098Claude Code mostra o prompt de permissão dessa ferramenta a cada chamada, mesmo em modos de permissão `acceptEdits`, `auto` e `bypassPermissions` [permission modes](/docs/pt/permissions#permission-modes), e não oferece uma opção "não pergunte novamente" para ela. [Regras de permissão](/docs/pt/permissions#permission-rule-syntax) que correspondem à ferramenta também não pulam o prompt. No modo `dontAsk`, que nunca solicita, Claude Code nega a chamada em vez disso.

1099 1099 

1100O prompt tem que alcançar uma pessoa. No modo não interativo com [`--permission-prompt-tool`](/pt/cli-reference#cli-flags), um resultado `allow` da ferramenta de prompt para uma ferramenta sinalizada é convertido em uma negação com a mensagem `MCP tool requires user interaction; not supported via --permission-prompt-tool`. O callback [`canUseTool`](/pt/agent-sdk/permissions) do Agent SDK recebe essas chamadas e pode aprová-las, porque o host do SDK deve mostrá-las a um usuário.1100O prompt tem que alcançar uma pessoa. No modo não interativo com [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags), um resultado `allow` da ferramenta de prompt para uma ferramenta sinalizada é convertido em uma negação com a mensagem `MCP tool requires user interaction; not supported via --permission-prompt-tool`. O callback [`canUseTool`](/docs/pt/agent-sdk/permissions) do Agent SDK recebe essas chamadas e pode aprová-las, porque o host do SDK deve mostrá-las a um usuário.

1101 1101 

1102Use isso para ferramentas cujo prompt de permissão é em si o ponto, como uma etapa de consentimento ou concessão de acesso onde aprovação automática significaria que nenhum humano nunca concordou. Outras ferramentas do mesmo servidor mantêm seu comportamento de permissão normal.1102Use isso para ferramentas cujo prompt de permissão é em si o ponto, como uma etapa de consentimento ou concessão de acesso onde aprovação automática significaria que nenhum humano nunca concordou. Outras ferramentas do mesmo servidor mantêm seu comportamento de permissão normal.

1103 1103 


1115 1115 

1116A anotação `anthropic/requiresUserInteraction` requer Claude Code v2.1.199 ou posterior. Versões anteriores a ignoram e aplicam o fluxo de permissão padrão.1116A anotação `anthropic/requiresUserInteraction` requer Claude Code v2.1.199 ou posterior. Versões anteriores a ignoram e aplicam o fluxo de permissão padrão.

1117 1117 

1118Quando uma sessão está conectada ao [Remote Control](/pt/remote-control) ou a um host SDK, Claude Code marca a solicitação de permissão como exigindo interação do usuário, para que o cliente mostre o prompt de permissão da ferramenta para você responder em vez de uma ação de aprovação com um toque.1118Quando uma sessão está conectada ao [Remote Control](/docs/pt/remote-control) ou a um host SDK, Claude Code marca a solicitação de permissão como exigindo interação do usuário, para que o cliente mostre o prompt de permissão da ferramenta para você responder em vez de uma ação de aprovação com um toque.

1119 1119 

1120<h2 id="respond-to-mcp-elicitation-requests">1120<h2 id="respond-to-mcp-elicitation-requests">

1121 Responder a solicitações de elicitação MCP1121 Responder a solicitações de elicitação MCP


1128* **Modo de formulário**: Claude Code mostra um diálogo com campos de formulário definidos pelo servidor (por exemplo, um prompt de nome de usuário e senha). Preencha os campos e envie.1128* **Modo de formulário**: Claude Code mostra um diálogo com campos de formulário definidos pelo servidor (por exemplo, um prompt de nome de usuário e senha). Preencha os campos e envie.

1129* **Modo de URL**: Claude Code abre uma URL do navegador para autenticação ou aprovação. Complete o fluxo no navegador, depois confirme no CLI.1129* **Modo de URL**: Claude Code abre uma URL do navegador para autenticação ou aprovação. Complete o fluxo no navegador, depois confirme no CLI.

1130 1130 

1131Para responder automaticamente a solicitações de elicitação sem mostrar um diálogo, use o [hook `Elicitation`](/pt/hooks#elicitation).1131Para responder automaticamente a solicitações de elicitação sem mostrar um diálogo, use o [hook `Elicitation`](/docs/pt/hooks#elicitation).

1132 1132 

1133Se você está construindo um servidor MCP que usa elicitação, veja a [especificação de elicitação MCP](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) para detalhes de protocolo e exemplos de esquema.1133Se você está construindo um servidor MCP que usa elicitação, veja a [especificação de elicitação MCP](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) para detalhes de protocolo e exemplos de esquema.

1134 1134 


1195 Para autores de servidores MCP1195 Para autores de servidores MCP

1196</h3>1196</h3>

1197 1197 

1198Se você está construindo um servidor MCP, o campo de instruções do servidor se torna mais útil com Tool Search habilitado. As instruções do servidor ajudam Claude a entender quando pesquisar suas ferramentas, semelhante a como [skills](/pt/skills) funcionam.1198Se você está construindo um servidor MCP, o campo de instruções do servidor se torna mais útil com Tool Search habilitado. As instruções do servidor ajudam Claude a entender quando pesquisar suas ferramentas, semelhante a como [skills](/docs/pt/skills) funcionam.

1199 1199 

1200Adicione instruções de servidor claras e descritivas que expliquem:1200Adicione instruções de servidor claras e descritivas que expliquem:

1201 1201 


1211 1211 

1212Tool Search é ativado por padrão: as ferramentas MCP são adiadas e descobertas sob demanda. Claude Code desabilita-o por padrão na Plataforma de Agentes do Google Cloud. Também é desabilitado quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte, já que a maioria dos proxies não encaminha blocos `tool_reference`. Defina `ENABLE_TOOL_SEARCH` explicitamente para substituir qualquer fallback.1212Tool Search é ativado por padrão: as ferramentas MCP são adiadas e descobertas sob demanda. Claude Code desabilita-o por padrão na Plataforma de Agentes do Google Cloud. Também é desabilitado quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte, já que a maioria dos proxies não encaminha blocos `tool_reference`. Defina `ENABLE_TOOL_SEARCH` explicitamente para substituir qualquer fallback.

1213 1213 

1214Definir [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/pt/env-vars) mantém tool search desativado, e `ENABLE_TOOL_SEARCH` não pode substituí-lo. A variável remove o cabeçalho beta que as definições de ferramentas `defer_loading` e blocos de conteúdo `tool_reference` exigem.1214Definir [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/pt/env-vars) mantém tool search desativado, e `ENABLE_TOOL_SEARCH` não pode substituí-lo. A variável remove o cabeçalho beta que as definições de ferramentas `defer_loading` e blocos de conteúdo `tool_reference` exigem.

1215 1215 

1216Tool Search requer um modelo que suporte blocos `tool_reference`: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 e modelos posteriores. Veja [compatibilidade de modelo na documentação da API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) para a lista atual. Na Plataforma de Agentes do Google Cloud, tool search é suportado para Claude Sonnet 4.5 e posterior e Claude Opus 4.5 e posterior.1216Tool Search requer um modelo que suporte blocos `tool_reference`: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 e modelos posteriores. Veja [compatibilidade de modelo na documentação da API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) para a lista atual. Na Plataforma de Agentes do Google Cloud, tool search é suportado para Claude Sonnet 4.5 e posterior e Claude Opus 4.5 e posterior.

1217 1217 


1233ENABLE_TOOL_SEARCH=false claude1233ENABLE_TOOL_SEARCH=false claude

1234```1234```

1235 1235 

1236Ou defina o valor no seu [campo `env` de settings.json](/pt/settings#available-settings).1236Ou defina o valor no seu [campo `env` de settings.json](/docs/pt/settings#available-settings).

1237 1237 

1238Você também pode desabilitar a ferramenta `ToolSearch` especificamente:1238Você também pode desabilitar a ferramenta `ToolSearch` especificamente:

1239 1239 


1267 1267 

1268O campo `alwaysLoad` está disponível em todos os tipos de servidor e requer Claude Code v2.1.121 ou posterior. Um servidor MCP também pode marcar ferramentas individuais como sempre carregadas incluindo `"anthropic/alwaysLoad": true` no objeto `_meta` da ferramenta, que tem o mesmo efeito apenas para essa ferramenta.1268O campo `alwaysLoad` está disponível em todos os tipos de servidor e requer Claude Code v2.1.121 ou posterior. Um servidor MCP também pode marcar ferramentas individuais como sempre carregadas incluindo `"anthropic/alwaysLoad": true` no objeto `_meta` da ferramenta, que tem o mesmo efeito apenas para essa ferramenta.

1269 1269 

1270Definir `alwaysLoad: true` também bloqueia a inicialização até que o servidor se conecte, limitado ao tempo limite de conexão padrão de 5 segundos. Isso se aplica mesmo que a inicialização MCP seja [não bloqueante por padrão](/pt/env-vars), já que as ferramentas devem estar presentes quando o primeiro prompt é construído. Outros servidores continuam a se conectar em segundo plano.1270Definir `alwaysLoad: true` também bloqueia a inicialização até que o servidor se conecte, limitado ao tempo limite de conexão padrão de 5 segundos. Isso se aplica mesmo que a inicialização MCP seja [não bloqueante por padrão](/docs/pt/env-vars), já que as ferramentas devem estar presentes quando o primeiro prompt é construído. Outros servidores continuam a se conectar em segundo plano.

1271 1271 

1272<h2 id="use-mcp-prompts-as-commands">1272<h2 id="use-mcp-prompts-as-commands">

1273 Usar prompts MCP como comandos1273 Usar prompts MCP como comandos


1316 Configuração MCP gerenciada1316 Configuração MCP gerenciada

1317</h2>1317</h2>

1318 1318 

1319Para organizações que precisam de controle centralizado sobre quais servidores MCP os usuários podem se conectar, consulte [Configuração MCP gerenciada](/pt/managed-mcp). Ela aborda a implantação de um conjunto fixo de servidores com `managed-mcp.json`, restrição de servidores com `allowedMcpServers` e `deniedMcpServers`, e o que os usuários veem quando um servidor é bloqueado.1319Para organizações que precisam de controle centralizado sobre quais servidores MCP os usuários podem se conectar, consulte [Configuração MCP gerenciada](/docs/pt/managed-mcp). Ela aborda a implantação de um conjunto fixo de servidores com `managed-mcp.json`, restrição de servidores com `allowedMcpServers` e `deniedMcpServers`, e o que os usuários veem quando um servidor é bloqueado.

memory.md +23 −23

Details

22 CLAUDE.md vs memória automática22 CLAUDE.md vs memória automática

23</h2>23</h2>

24 24 

25Claude Code tem dois sistemas de memória complementares. Ambos são carregados no início de cada conversa. Claude os trata como contexto, não como configuração imposta. Para bloquear uma ação independentemente do que Claude decidir, use um [hook PreToolUse](/pt/hooks-guide) em vez disso. Quanto mais específicas e concisas forem suas instruções, mais consistentemente Claude as seguirá.25Claude Code tem dois sistemas de memória complementares. Ambos são carregados no início de cada conversa. Claude os trata como contexto, não como configuração imposta. Para bloquear uma ação independentemente do que Claude decidir, use um [hook PreToolUse](/docs/pt/hooks-guide) em vez disso. Quanto mais específicas e concisas forem suas instruções, mais consistentemente Claude as seguirá.

26 26 

27| | Arquivos CLAUDE.md | Memória automática |27| | Arquivos CLAUDE.md | Memória automática |

28| :--------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------ |28| :--------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------ |


34 34 

35Use arquivos CLAUDE.md quando quiser guiar o comportamento de Claude. A memória automática permite que Claude aprenda com suas correções sem esforço manual.35Use arquivos CLAUDE.md quando quiser guiar o comportamento de Claude. A memória automática permite que Claude aprenda com suas correções sem esforço manual.

36 36 

37Subagents também podem manter sua própria memória automática. Veja [configuração de subagent](/pt/sub-agents#enable-persistent-memory) para detalhes.37Subagents também podem manter sua própria memória automática. Veja [configuração de subagent](/docs/pt/sub-agents#enable-persistent-memory) para detalhes.

38 38 

39<h2 id="claude-md-files">39<h2 id="claude-md-files">

40 Arquivos CLAUDE.md40 Arquivos CLAUDE.md


53* Você digita a mesma correção ou esclarecimento no chat que digitou na sessão anterior53* Você digita a mesma correção ou esclarecimento no chat que digitou na sessão anterior

54* Um novo colega de equipe precisaria do mesmo contexto para ser produtivo54* Um novo colega de equipe precisaria do mesmo contexto para ser produtivo

55 55 

56Mantenha-o com fatos que Claude deve manter em cada sessão: comandos de compilação, convenções, layout do projeto, regras "sempre faça X". Se uma entrada é um procedimento de múltiplas etapas ou só importa para uma parte da base de código, mova-a para uma [skill](/pt/skills) ou uma [regra com escopo de caminho](#organize-rules-with-claude/rules/) em vez disso. A [visão geral da extensão](/pt/features-overview#build-your-setup-over-time) cobre quando usar cada mecanismo.56Mantenha-o com fatos que Claude deve manter em cada sessão: comandos de compilação, convenções, layout do projeto, regras "sempre faça X". Se uma entrada é um procedimento de múltiplas etapas ou só importa para uma parte da base de código, mova-a para uma [skill](/docs/pt/skills) ou uma [regra com escopo de caminho](#organize-rules-with-claude/rules/) em vez disso. A [visão geral da extensão](/docs/pt/features-overview#build-your-setup-over-time) cobre quando usar cada mecanismo.

57 57 

58<h3 id="choose-where-to-put-claude-md-files">58<h3 id="choose-where-to-put-claude-md-files">

59 Escolha onde colocar arquivos CLAUDE.md59 Escolha onde colocar arquivos CLAUDE.md


88 Escreva instruções eficazes88 Escreva instruções eficazes

89</h3>89</h3>

90 90 

91Arquivos CLAUDE.md são carregados na janela de contexto no início de cada sessão, consumindo tokens junto com sua conversa. A [visualização da janela de contexto](/pt/context-window) mostra onde CLAUDE.md é carregado em relação ao resto do contexto de inicialização. Como são contexto em vez de configuração imposta, como você escreve as instruções afeta o quão confiável Claude as segue. Instruções específicas, concisas e bem estruturadas funcionam melhor.91Arquivos CLAUDE.md são carregados na janela de contexto no início de cada sessão, consumindo tokens junto com sua conversa. A [visualização da janela de contexto](/docs/pt/context-window) mostra onde CLAUDE.md é carregado em relação ao resto do contexto de inicialização. Como são contexto em vez de configuração imposta, como você escreve as instruções afeta o quão confiável Claude as segue. Instruções específicas, concisas e bem estruturadas funcionam melhor.

92 92 

93**Tamanho**: alvo de menos de 200 linhas por arquivo CLAUDE.md. Arquivos mais longos consomem mais contexto e reduzem a aderência. Se suas instruções estão crescendo muito, use [regras com escopo de caminho](#path-specific-rules) para que as instruções sejam carregadas apenas quando Claude trabalha com arquivos correspondentes. Você também pode dividir conteúdo em [importações](#import-additional-files) para organização, embora arquivos importados ainda sejam carregados e entrem na janela de contexto no lançamento.93**Tamanho**: alvo de menos de 200 linhas por arquivo CLAUDE.md. Arquivos mais longos consomem mais contexto e reduzem a aderência. Se suas instruções estão crescendo muito, use [regras com escopo de caminho](#path-specific-rules) para que as instruções sejam carregadas apenas quando Claude trabalha com arquivos correspondentes. Você também pode dividir conteúdo em [importações](#import-additional-files) para organização, embora arquivos importados ainda sejam carregados e entrem na janela de contexto no lançamento.

94 94 


158 158 

159No Windows, criar um symlink requer privilégios de Administrador ou Modo de Desenvolvedor, então use a importação `@AGENTS.md` em vez disso.159No Windows, criar um symlink requer privilégios de Administrador ou Modo de Desenvolvedor, então use a importação `@AGENTS.md` em vez disso.

160 160 

161Executar [`/init`](/pt/commands) em um repositório que já tem um `AGENTS.md` o lê e incorpora as partes relevantes no `CLAUDE.md` gerado. Ele também lê outras configurações de ferramentas como `.cursorrules`, `.devin/rules/` e `.windsurfrules`.161Executar [`/init`](/docs/pt/commands) em um repositório que já tem um `AGENTS.md` o lê e incorpora as partes relevantes no `CLAUDE.md` gerado. Ele também lê outras configurações de ferramentas como `.cursorrules`, `.devin/rules/` e `.windsurfrules`.

162 162 

163<h3 id="how-claude-md-files-load">163<h3 id="how-claude-md-files-load">

164 Como arquivos CLAUDE.md são carregados164 Como arquivos CLAUDE.md são carregados


170 170 

171Claude também descobre arquivos `CLAUDE.md` e `CLAUDE.local.md` em subdiretórios sob seu diretório de trabalho atual. Em vez de carregá-los no lançamento, eles são incluídos quando Claude lê arquivos nesses subdiretórios.171Claude também descobre arquivos `CLAUDE.md` e `CLAUDE.local.md` em subdiretórios sob seu diretório de trabalho atual. Em vez de carregá-los no lançamento, eles são incluídos quando Claude lê arquivos nesses subdiretórios.

172 172 

173Se você trabalha em um grande monorepo onde arquivos CLAUDE.md de outras equipes são capturados, use [`claudeMdExcludes`](#exclude-specific-claude-md-files) para pular. Para o layout completo de arquivos CLAUDE.md de raiz e por diretório e regras, veja [Monorepos e repositórios grandes](/pt/large-codebases).173Se você trabalha em um grande monorepo onde arquivos CLAUDE.md de outras equipes são capturados, use [`claudeMdExcludes`](#exclude-specific-claude-md-files) para pular. Para o layout completo de arquivos CLAUDE.md de raiz e por diretório e regras, veja [Monorepos e repositórios grandes](/docs/pt/large-codebases).

174 174 

175Comentários HTML em nível de bloco (`<!-- notas do mantenedor -->`) em arquivos CLAUDE.md são removidos antes do conteúdo ser injetado no contexto de Claude. Use-os para deixar notas para mantenedores humanos sem gastar tokens de contexto neles. Comentários dentro de blocos de código são preservados. Quando você abre um arquivo CLAUDE.md diretamente com a ferramenta Read, os comentários permanecem visíveis.175Comentários HTML em nível de bloco (`<!-- notas do mantenedor -->`) em arquivos CLAUDE.md são removidos antes do conteúdo ser injetado no contexto de Claude. Use-os para deixar notas para mantenedores humanos sem gastar tokens de contexto neles. Comentários dentro de blocos de código são preservados. Quando você abre um arquivo CLAUDE.md diretamente com a ferramenta Read, os comentários permanecem visíveis.

176 176 


186CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config186CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

187```187```

188 188 

189Isso carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md` do diretório adicional. `CLAUDE.local.md` é ignorado se você excluir `local` de [`--setting-sources`](/pt/cli-reference).189Isso carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md` do diretório adicional. `CLAUDE.local.md` é ignorado se você excluir `local` de [`--setting-sources`](/docs/pt/cli-reference).

190 190 

191<h3 id="organize-rules-with-claude/rules/">191<h3 id="organize-rules-with-claude/rules/">

192 Organize regras com `.claude/rules/`192 Organize regras com `.claude/rules/`


195Para projetos maiores, você pode organizar instruções em múltiplos arquivos usando o diretório `.claude/rules/`. Isso mantém as instruções modulares e mais fáceis para as equipes manterem. As regras também podem ser [escopadas para caminhos de arquivo específicos](#path-specific-rules), então elas só são carregadas em contexto quando Claude trabalha com arquivos correspondentes, reduzindo ruído e economizando espaço de contexto.195Para projetos maiores, você pode organizar instruções em múltiplos arquivos usando o diretório `.claude/rules/`. Isso mantém as instruções modulares e mais fáceis para as equipes manterem. As regras também podem ser [escopadas para caminhos de arquivo específicos](#path-specific-rules), então elas só são carregadas em contexto quando Claude trabalha com arquivos correspondentes, reduzindo ruído e economizando espaço de contexto.

196 196 

197<Note>197<Note>

198 As regras são carregadas em contexto a cada sessão ou quando arquivos correspondentes são abertos. Para instruções específicas de tarefa que não precisam estar em contexto o tempo todo, use [skills](/pt/skills) em vez disso, que só são carregadas quando você as invoca ou quando Claude determina que são relevantes para seu prompt.198 As regras são carregadas em contexto a cada sessão ou quando arquivos correspondentes são abertos. Para instruções específicas de tarefa que não precisam estar em contexto o tempo todo, use [skills](/docs/pt/skills) em vez disso, que só são carregadas quando você as invoca ou quando Claude determina que são relevantes para seu prompt.

199</Note>199</Note>

200 200 

201<h4 id="set-up-rules">201<h4 id="set-up-rules">


235- Inclua comentários de documentação OpenAPI235- Inclua comentários de documentação OpenAPI

236```236```

237 237 

238Regras sem um campo `paths` são carregadas incondicionalmente e se aplicam a todos os arquivos. Regras com escopo de caminho são acionadas quando Claude lê arquivos correspondentes ao padrão, não em cada uso de ferramenta. {/* min-version: 2.1.198 */}A partir da v2.1.198, a correspondência também funciona quando Claude alcança um arquivo através de um caminho vinculado simbolicamente para o diretório do projeto, por exemplo em um checkout vinculado simbolicamente.238Regras sem um campo `paths` são carregadas incondicionalmente e se aplicam a todos os arquivos. Regras com escopo de caminho são acionadas quando Claude lê arquivos correspondentes ao padrão, não em cada uso de ferramenta. A partir da v2.1.198, a correspondência também funciona quando Claude alcança um arquivo através de um caminho vinculado simbolicamente para o diretório do projeto, por exemplo em um checkout vinculado simbolicamente.

239 239 

240Use padrões glob no campo `paths` para corresponder arquivos por extensão, diretório ou qualquer combinação:240Use padrões glob no campo `paths` para corresponder arquivos por extensão, diretório ou qualquer combinação:

241 241 


257---257---

258```258```

259 259 

260Sintaxe glob trata `[` como o início de uma expressão de colchete como `[abc]`. Um padrão com um `[` que não pode ser lido como uma expressão de colchete, como `photos [2024/**`, é inválido: ele não corresponde a nada, e os outros padrões da regra continuam funcionando. Para corresponder um `[` literal em um nome de arquivo, escape-o como `photos \[2024/**`. {/* min-version: 2.1.207 */}Antes da v2.1.207, um padrão inválido fazia a ferramenta Read falhar para cada arquivo em que a regra era avaliada, em vez de não corresponder a nada.260Sintaxe glob trata `[` como o início de uma expressão de colchete como `[abc]`. Um padrão com um `[` que não pode ser lido como uma expressão de colchete, como `photos [2024/**`, é inválido: ele não corresponde a nada, e os outros padrões da regra continuam funcionando. Para corresponder um `[` literal em um nome de arquivo, escape-o como `photos \[2024/**`. Antes da v2.1.207, um padrão inválido fazia a ferramenta Read falhar para cada arquivo em que a regra era avaliada, em vez de não corresponder a nada.

261 261 

262<h4 id="share-rules-across-projects-with-symlinks">262<h4 id="share-rules-across-projects-with-symlinks">

263 Compartilhe regras entre projetos com symlinks263 Compartilhe regras entre projetos com symlinks


306 </Step>306 </Step>

307 307 

308 <Step title="Implante com seu sistema de gerenciamento de configuração">308 <Step title="Implante com seu sistema de gerenciamento de configuração">

309 Use MDM, Group Policy, Ansible ou ferramentas similares para distribuir o arquivo entre máquinas de desenvolvedores. Veja [configurações gerenciadas](/pt/permissions#managed-settings) para outras opções de configuração em toda a organização.309 Use MDM, Group Policy, Ansible ou ferramentas similares para distribuir o arquivo entre máquinas de desenvolvedores. Veja [configurações gerenciadas](/docs/pt/permissions#managed-settings) para outras opções de configuração em toda a organização.

310 </Step>310 </Step>

311</Steps>311</Steps>

312 312 


326}326}

327```327```

328 328 

329Um CLAUDE.md gerenciado e [configurações gerenciadas](/pt/settings#settings-files) servem a propósitos diferentes. Use configurações para imposição técnica e CLAUDE.md para orientação comportamental:329Um CLAUDE.md gerenciado e [configurações gerenciadas](/docs/pt/settings#settings-files) servem a propósitos diferentes. Use configurações para imposição técnica e CLAUDE.md para orientação comportamental:

330 330 

331| Preocupação | Configure em |331| Preocupação | Configure em |

332| :---------------------------------------------------------------- | :----------------------------------------------------------------- |332| :---------------------------------------------------------------- | :----------------------------------------------------------------- |


357}357}

358```358```

359 359 

360Padrões são correspondidos contra caminhos de arquivo absolutos usando sintaxe glob. Você pode configurar `claudeMdExcludes` em qualquer [camada de configurações](/pt/settings#settings-files): usuário, projeto, local ou política gerenciada. Arrays são mesclados entre camadas.360Padrões são correspondidos contra caminhos de arquivo absolutos usando sintaxe glob. Você pode configurar `claudeMdExcludes` em qualquer [camada de configurações](/docs/pt/settings#settings-files): usuário, projeto, local ou política gerenciada. Arrays são mesclados entre camadas.

361 361 

362Arquivos CLAUDE.md de política gerenciada não podem ser excluídos. Isso garante que as instruções em toda a organização sempre se apliquem independentemente das configurações individuais.362Arquivos CLAUDE.md de política gerenciada não podem ser excluídos. Isso garante que as instruções em toda a organização sempre se apliquem independentemente das configurações individuais.

363 363 


387 387 

388Cada projeto obtém seu próprio diretório de memória em `~/.claude/projects/<project>/memory/`. O caminho `<project>` é derivado do repositório git, então todos os worktrees e subdiretórios dentro do mesmo repositório compartilham um diretório de memória automática. Fora de um repositório git, a raiz do projeto é usada em vez disso.388Cada projeto obtém seu próprio diretório de memória em `~/.claude/projects/<project>/memory/`. O caminho `<project>` é derivado do repositório git, então todos os worktrees e subdiretórios dentro do mesmo repositório compartilham um diretório de memória automática. Fora de um repositório git, a raiz do projeto é usada em vez disso.

389 389 

390Para armazenar memória automática em um local diferente, defina `autoMemoryDirectory` em seu `settings.json`. Ele é lido de qualquer [escopo de configurações](/pt/settings#settings-precedence): usuário, projeto, local, política, ou `--settings`.390Para armazenar memória automática em um local diferente, defina `autoMemoryDirectory` em seu `settings.json`. Ele é lido de qualquer [escopo de configurações](/docs/pt/settings#settings-precedence): usuário, projeto, local, política, ou `--settings`.

391 391 

392```json theme={null}392```json theme={null}

393{393{


456* Torne as instruções mais específicas. "Use indentação de 2 espaços" funciona melhor do que "formate o código adequadamente."456* Torne as instruções mais específicas. "Use indentação de 2 espaços" funciona melhor do que "formate o código adequadamente."

457* Procure por instruções conflitantes entre arquivos CLAUDE.md. Se dois arquivos dão orientação diferente para o mesmo comportamento, Claude pode escolher um arbitrariamente.457* Procure por instruções conflitantes entre arquivos CLAUDE.md. Se dois arquivos dão orientação diferente para o mesmo comportamento, Claude pode escolher um arbitrariamente.

458 458 

459Se a instrução é algo que deve ser executado em um ponto específico, como antes de cada commit ou após cada edição de arquivo, escreva-a como um [hook](/pt/hooks-guide) em vez disso. Hooks são executados como comandos shell em eventos de ciclo de vida fixos e se aplicam independentemente do que Claude decidir fazer.459Se a instrução é algo que deve ser executado em um ponto específico, como antes de cada commit ou após cada edição de arquivo, escreva-a como um [hook](/docs/pt/hooks-guide) em vez disso. Hooks são executados como comandos shell em eventos de ciclo de vida fixos e se aplicam independentemente do que Claude decidir fazer.

460 460 

461Para instruções que você quer no nível do prompt do sistema, use [`--append-system-prompt`](/pt/cli-reference#system-prompt-flags). Isso deve ser passado a cada invocação, então é mais adequado para scripts e automação do que para uso interativo.461Para instruções que você quer no nível do prompt do sistema, use [`--append-system-prompt`](/docs/pt/cli-reference#system-prompt-flags). Isso deve ser passado a cada invocação, então é mais adequado para scripts e automação do que para uso interativo.

462 462 

463<Tip>463<Tip>

464 Use o hook [`InstructionsLoaded`](/pt/hooks#instructionsloaded) para registrar exatamente quais arquivos de instrução são carregados, quando são carregados e por quê. Isso é útil para depurar regras específicas de caminho ou arquivos carregados preguiçosamente em subdiretórios.464 Use o hook [`InstructionsLoaded`](/docs/pt/hooks#instructionsloaded) para registrar exatamente quais arquivos de instrução são carregados, quando são carregados e por quê. Isso é útil para depurar regras específicas de caminho ou arquivos carregados preguiçosamente em subdiretórios.

465</Tip>465</Tip>

466 466 

467<h3 id="i-don’t-know-what-auto-memory-saved">467<h3 id="i-don’t-know-what-auto-memory-saved">


476 476 

477Arquivos com mais de 200 linhas consomem mais contexto e podem reduzir a aderência. Use [regras com escopo de caminho](#path-specific-rules) para carregar instruções apenas quando Claude trabalha com arquivos correspondentes, ou reduza conteúdo que não é necessário em cada sessão. Dividir em [importações `@path`](#import-additional-files) ajuda na organização, mas não reduz contexto, já que arquivos importados são carregados no lançamento.477Arquivos com mais de 200 linhas consomem mais contexto e podem reduzir a aderência. Use [regras com escopo de caminho](#path-specific-rules) para carregar instruções apenas quando Claude trabalha com arquivos correspondentes, ou reduza conteúdo que não é necessário em cada sessão. Dividir em [importações `@path`](#import-additional-files) ajuda na organização, mas não reduz contexto, já que arquivos importados são carregados no lançamento.

478 478 

479{/* min-version: 2.1.206 */}O checkup [`/doctor`](/pt/commands#all-commands) propõe cortes para um CLAUDE.md verificado: ele corta conteúdo que Claude pode derivar da base de código, como layouts de diretório, listas de dependências e visões gerais de arquitetura, e mantém armadilhas, justificativa e convenções que diferem dos padrões de ferramentas. A verificação de corte requer Claude Code v2.1.206 ou posterior.479O checkup [`/doctor`](/docs/pt/commands#all-commands) propõe cortes para um CLAUDE.md verificado: ele corta conteúdo que Claude pode derivar da base de código, como layouts de diretório, listas de dependências e visões gerais de arquitetura, e mantém armadilhas, justificativa e convenções que diferem dos padrões de ferramentas. A verificação de corte requer Claude Code v2.1.206 ou posterior.

480 480 

481<h3 id="instructions-seem-lost-after-/compact">481<h3 id="instructions-seem-lost-after-/compact">

482 Instruções parecem perdidas após `/compact`482 Instruções parecem perdidas após `/compact`


484 484 

485CLAUDE.md de raiz de projeto sobrevive à compactação: após `/compact`, Claude relê do disco e reinjecta no contexto. Arquivos CLAUDE.md aninhados em subdiretórios não são reinjetados automaticamente; eles recarregam na próxima vez que Claude lê um arquivo naquele subdiretório.485CLAUDE.md de raiz de projeto sobrevive à compactação: após `/compact`, Claude relê do disco e reinjecta no contexto. Arquivos CLAUDE.md aninhados em subdiretórios não são reinjetados automaticamente; eles recarregam na próxima vez que Claude lê um arquivo naquele subdiretório.

486 486 

487Se uma instrução desapareceu após compactação, ela foi dada apenas em conversa ou vive em um CLAUDE.md aninhado que ainda não recarregou. Adicione instruções apenas de conversa a CLAUDE.md para torná-las persistir. Veja [O que sobrevive à compactação](/pt/context-window#what-survives-compaction) para o detalhamento completo.487Se uma instrução desapareceu após compactação, ela foi dada apenas em conversa ou vive em um CLAUDE.md aninhado que ainda não recarregou. Adicione instruções apenas de conversa a CLAUDE.md para torná-las persistir. Veja [O que sobrevive à compactação](/docs/pt/context-window#what-survives-compaction) para o detalhamento completo.

488 488 

489Veja [Escreva instruções eficazes](#write-effective-instructions) para orientação sobre tamanho, estrutura e especificidade.489Veja [Escreva instruções eficazes](#write-effective-instructions) para orientação sobre tamanho, estrutura e especificidade.

490 490 


492 Recursos relacionados492 Recursos relacionados

493</h2>493</h2>

494 494 

495* [Debug sua configuração](/pt/debug-your-config): diagnostique por que CLAUDE.md ou configurações não estão tendo efeito495* [Debug sua configuração](/docs/pt/debug-your-config): diagnostique por que CLAUDE.md ou configurações não estão tendo efeito

496* [Skills](/pt/skills): empacote fluxos de trabalho repetíveis que carregam sob demanda496* [Skills](/docs/pt/skills): empacote fluxos de trabalho repetíveis que carregam sob demanda

497* [Settings](/pt/settings): configure o comportamento do Claude Code com arquivos de configurações497* [Settings](/docs/pt/settings): configure o comportamento do Claude Code com arquivos de configurações

498* [Memória de subagent](/pt/sub-agents#enable-persistent-memory): deixe subagents manter sua própria memória automática498* [Memória de subagent](/docs/pt/sub-agents#enable-persistent-memory): deixe subagents manter sua própria memória automática

Details

139 139 

140**Opção C: Autenticação por token de portador**140**Opção C: Autenticação por token de portador**

141 141 

142{/* min-version: 2.1.203 */}Claude Code envia o valor de `ANTHROPIC_FOUNDRY_AUTH_TOKEN` em cada solicitação como o cabeçalho `Authorization: Bearer`. Use esta opção quando outro processo, como um aplicativo host ou um script de login, já tiver obtido um token de acesso para você. Requer Claude Code v2.1.203 ou posterior.142Claude Code envia o valor de `ANTHROPIC_FOUNDRY_AUTH_TOKEN` em cada solicitação como o cabeçalho `Authorization: Bearer`. Use esta opção quando outro processo, como um aplicativo host ou um script de login, já tiver obtido um token de acesso para você. Requer Claude Code v2.1.203 ou posterior.

143 143 

144Defina a variável para um token de portador que o Microsoft Entra ID emitiu para seu recurso:144Defina a variável para um token de portador que o Microsoft Entra ID emitiu para seu recurso:

145 145 


189 189 

190As tarefas em segundo plano, como geração de título de sessão, usam o modelo pequeno/rápido, normalmente um modelo da classe Haiku. No Microsoft Foundry, Claude Code usa como padrão o modelo primário porque nem toda conta tem uma implantação Haiku. Para usar Haiku para tarefas em segundo plano, defina `ANTHROPIC_DEFAULT_HAIKU_MODEL` para uma implantação Haiku que esteja disponível em sua conta, conforme mostrado acima.190As tarefas em segundo plano, como geração de título de sessão, usam o modelo pequeno/rápido, normalmente um modelo da classe Haiku. No Microsoft Foundry, Claude Code usa como padrão o modelo primário porque nem toda conta tem uma implantação Haiku. Para usar Haiku para tarefas em segundo plano, defina `ANTHROPIC_DEFAULT_HAIKU_MODEL` para uma implantação Haiku que esteja disponível em sua conta, conforme mostrado acima.

191 191 

192Para IDs de modelo atuais e legados, consulte [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Consulte [Configuração de modelo](/pt/model-config#pin-models-for-third-party-deployments) para a lista completa de variáveis de ambiente.192Para IDs de modelo atuais e legados, consulte [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Consulte [Configuração de modelo](/docs/pt/model-config#pin-models-for-third-party-deployments) para a lista completa de variáveis de ambiente.

193 193 

194[Prompt caching](/pt/prompt-caching) está ativado automaticamente. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina a seguinte variável; gravações de cache com TTL de 1 hora são cobradas a uma taxa mais alta:194[Prompt caching](/docs/pt/prompt-caching) está ativado automaticamente. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina a seguinte variável; gravações de cache com TTL de 1 hora são cobradas a uma taxa mais alta:

195 195 

196```bash theme={null}196```bash theme={null}

197export ENABLE_PROMPT_CACHING_1H=1197export ENABLE_PROMPT_CACHING_1H=1

model-config.md +72 −76

Details

22Para orientação sobre qual modelo e nível de esforço se adequam a diferentes tipos de trabalho, consulte [Escolhendo um modelo Claude e nível de esforço no Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) no blog.22Para orientação sobre qual modelo e nível de esforço se adequam a diferentes tipos de trabalho, consulte [Escolhendo um modelo Claude e nível de esforço no Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) no blog.

23 23 

24<Note>24<Note>

25 `ANTHROPIC_BASE_URL` altera para onde as solicitações são enviadas, não qual modelo as responde. Para rotear Claude através de um gateway LLM, consulte [gateways LLM](/pt/llm-gateway).25 `ANTHROPIC_BASE_URL` altera para onde as solicitações são enviadas, não qual modelo as responde. Para rotear Claude através de um gateway LLM, consulte [gateways LLM](/docs/pt/llm-gateway).

26</Note>26</Note>

27 27 

28<h3 id="model-aliases">28<h3 id="model-aliases">


39| **`sonnet`** | Usa o modelo Sonnet mais recente para tarefas de codificação diária |39| **`sonnet`** | Usa o modelo Sonnet mais recente para tarefas de codificação diária |

40| **`opus`** | Usa o modelo Opus mais recente para tarefas de raciocínio complexo |40| **`opus`** | Usa o modelo Opus mais recente para tarefas de raciocínio complexo |

41| **`haiku`** | Usa o modelo Haiku rápido e eficiente para tarefas simples |41| **`haiku`** | Usa o modelo Haiku rápido e eficiente para tarefas simples |

42| **`sonnet[1m]`** | Usa Sonnet com uma [janela de contexto de 1 milhão de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) para sessões longas. Sem efeito quando `sonnet` já se resolve para Sonnet 5 com sua janela 1M nativa; atrás de um [gateway LLM](/pt/llm-gateway), seleciona a janela 1M para Sonnet 5 |42| **`sonnet[1m]`** | Usa Sonnet com uma [janela de contexto de 1 milhão de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) para sessões longas. Sem efeito quando `sonnet` já se resolve para Sonnet 5 com sua janela 1M nativa; atrás de um [gateway LLM](/docs/pt/llm-gateway), seleciona a janela 1M para Sonnet 5 |

43| **`opus[1m]`** | Usa Opus com uma [janela de contexto de 1 milhão de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) para sessões longas |43| **`opus[1m]`** | Usa Opus com uma [janela de contexto de 1 milhão de tokens](https://platform.claude.com/docs/pt/build-with-claude/context-windows#context-window-sizes-by-model) para sessões longas |

44| **`opusplan`** | Modo especial que usa `opus` durante Plan Mode, depois muda para `sonnet` para execução |44| **`opusplan`** | Modo especial que usa `opus` durante Plan Mode, depois muda para `sonnet` para execução |

45 45 


48| Provedor | `opus` | `sonnet` |48| Provedor | `opus` | `sonnet` |

49| :--------------------------------------------------- | :------- | :--------- |49| :--------------------------------------------------- | :------- | :--------- |

50| API Anthropic | Opus 4.8 | Sonnet 5 |50| API Anthropic | Opus 4.8 | Sonnet 5 |

51| [Claude Platform on AWS](/pt/claude-platform-on-aws) | Opus 4.8 | Sonnet 4.6 |51| [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) | Opus 4.8 | Sonnet 4.6 |

52| Amazon Bedrock, Google Cloud's Agent Platform | Opus 4.8 | Sonnet 4.5 |52| Amazon Bedrock, Google Cloud's Agent Platform | Opus 4.8 | Sonnet 4.5 |

53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |

54 54 

55Onde um alias se resolve para um modelo mais antigo, modelos mais recentes estão disponíveis selecionando o nome completo do modelo explicitamente ou definindo `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.55Onde um alias se resolve para um modelo mais antigo, modelos mais recentes estão disponíveis selecionando o nome completo do modelo explicitamente ou definindo `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.

56 56 

57{/* min-version: 2.1.207 */}Antes da v2.1.207, `opus` se resolvia para Opus 4.7 no Claude Platform on AWS e para Opus 4.6 no Amazon Bedrock e Google Cloud's Agent Platform.57Antes da v2.1.207, `opus` se resolvia para Opus 4.7 no Claude Platform on AWS e para Opus 4.6 no Amazon Bedrock e Google Cloud's Agent Platform.

58 58 

59Os aliases apontam para a versão recomendada para seu provedor e são atualizados ao longo do tempo. Para fixar uma versão específica, use o nome completo do modelo, por exemplo `claude-opus-4-8`, ou defina a variável de ambiente correspondente como `ANTHROPIC_DEFAULT_OPUS_MODEL`.59Os aliases apontam para a versão recomendada para seu provedor e são atualizados ao longo do tempo. Para fixar uma versão específica, use o nome completo do modelo, por exemplo `claude-opus-4-8`, ou defina a variável de ambiente correspondente como `ANTHROPIC_DEFAULT_OPUS_MODEL`.

60 60 


72 72 

73Para aproveitar ao máximo o Fable 5:73Para aproveitar ao máximo o Fable 5:

74 74 

75* **Descreva o resultado, não as etapas**: entregue-lhe o resultado que você deseja e deixe-o planejar o caminho. Para mantê-lo funcionando até que esse resultado se mantenha, [defina uma meta](/pt/goal).75* **Descreva o resultado, não as etapas**: entregue-lhe o resultado que você deseja e deixe-o planejar o caminho. Para mantê-lo funcionando até que esse resultado se mantenha, [defina uma meta](/docs/pt/goal).

76* **Entregue-lhe problemas ambíguos**: investigações de causa raiz, depuração de interrupções e decisões de arquitetura são onde a investigação e verificação extras compensam.76* **Entregue-lhe problemas ambíguos**: investigações de causa raiz, depuração de interrupções e decisões de arquitetura são onde a investigação e verificação extras compensam.

77* **Pule os lembretes de verificação**: ele verifica seu próprio trabalho com menos solicitação, portanto lembretes para testar ou verificar geralmente são desnecessários.77* **Pule os lembretes de verificação**: ele verifica seu próprio trabalho com menos solicitação, portanto lembretes para testar ou verificar geralmente são desnecessários.

78* **Dimensione tarefas maiores**: dê-lhe trabalho que você normalmente dividiria em pedaços. Ele mantém sessões longas sem perder o fio.78* **Dimensione tarefas maiores**: dê-lhe trabalho que você normalmente dividiria em pedaços. Ele mantém sessões longas sem perder o fio.

79 79 

80<Note>80<Note>

81 Fable 5 requer Claude Code v2.1.170 ou posterior. Versões mais antigas não mostram Fable 5 no seletor de modelo e não podem selecioná-lo. Execute `claude update` para atualizar. Fable 5 não está disponível sob [retenção zero de dados](/pt/zero-data-retention), onde o seletor `/model` o omite ou o mostra desabilitado.81 Fable 5 requer Claude Code v2.1.170 ou posterior. Versões mais antigas não mostram Fable 5 no seletor de modelo e não podem selecioná-lo. Execute `claude update` para atualizar. Fable 5 não está disponível sob [retenção zero de dados](/docs/pt/zero-data-retention), onde o seletor `/model` o omite ou o mostra desabilitado.

82</Note>82</Note>

83 83 

84<h3 id="setting-your-model">84<h3 id="setting-your-model">


97* `Enter`: alternar modelo e salvar como seu padrão97* `Enter`: alternar modelo e salvar como seu padrão

98* `s`: alternar modelo apenas para esta sessão98* `s`: alternar modelo apenas para esta sessão

99 99 

100Digitar `/model <name>` diretamente se comporta como `Enter`. {/* min-version: 2.1.205 */}Um modelo definido com `/model` em [modo não interativo](/pt/headless), com o sinalizador `-p`, se aplica apenas à sessão atual e não é salvo como seu padrão. As configurações de projeto e gerenciadas ainda têm precedência e são reaplicadas no próximo lançamento. {/* min-version: 2.1.196 */}Um [modelo padrão da organização](#organization-default-model) que seu administrador configurou para substituir a seleção do usuário também é reaplicado no próximo lançamento.100Digitar `/model <name>` diretamente se comporta como `Enter`. Um modelo definido com `/model` em [modo não interativo](/docs/pt/headless), com o sinalizador `-p`, se aplica apenas à sessão atual e não é salvo como seu padrão. As configurações de projeto e gerenciadas ainda têm precedência e são reaplicadas no próximo lançamento. Um [modelo padrão da organização](#organization-default-model) que seu administrador configurou para substituir a seleção do usuário também é reaplicado no próximo lançamento.

101 101 

102Na v2.1.144 até v2.1.152, `/model` se aplicava apenas à sessão atual e `d` no seletor salvava um padrão.102Na v2.1.144 até v2.1.152, `/model` se aplicava apenas à sessão atual e `d` no seletor salvava um padrão.

103 103 

104O sinalizador `--model` e a variável de ambiente `ANTHROPIC_MODEL` se aplicam apenas à sessão que você inicia com eles. Para executar modelos diferentes em terminais diferentes ao mesmo tempo, inicie cada um com seu próprio sinalizador `--model` em vez de alternar com `/model`.104O sinalizador `--model` e a variável de ambiente `ANTHROPIC_MODEL` se aplicam apenas à sessão que você inicia com eles. Para executar modelos diferentes em terminais diferentes ao mesmo tempo, inicie cada um com seu próprio sinalizador `--model` em vez de alternar com `/model`.

105 105 

106Os preços no seletor `/model` aparecem quando Claude Code fala com a API Anthropic, diretamente ou através de um [gateway LLM](/pt/llm-gateway) que a proxeia, e o preço em uma linha é o preço do modelo que essa linha seleciona. Em [provedores de terceiros](/pt/third-party-integrations) como Amazon Bedrock e no [gateway de aplicativos Claude](/pt/claude-apps-gateway), seu provedor ou gateway determina o que você paga, portanto as linhas do seletor não mostram preço. O preço é apenas um rótulo de exibição; não afeta qual modelo uma linha seleciona ou o que seu provedor cobra. Antes da v2.1.206, [Claude Platform on AWS](/pt/claude-platform-on-aws) e sessões de gateway mostravam preços de lista da Anthropic, e uma linha poderia mostrar o preço de um modelo diferente daquele que selecionava.106Os preços no seletor `/model` aparecem quando Claude Code fala com a API Anthropic, diretamente ou através de um [gateway LLM](/docs/pt/llm-gateway) que a proxeia, e o preço em uma linha é o preço do modelo que essa linha seleciona. Em [provedores de terceiros](/docs/pt/third-party-integrations) como Amazon Bedrock e no [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), seu provedor ou gateway determina o que você paga, portanto as linhas do seletor não mostram preço. O preço é apenas um rótulo de exibição; não afeta qual modelo uma linha seleciona ou o que seu provedor cobra. Antes da v2.1.206, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e sessões de gateway mostravam preços de lista da Anthropic, e uma linha poderia mostrar o preço de um modelo diferente daquele que selecionava.

107 107 

108As sessões retomadas iniciadas com `claude --resume`, `--continue` ou o seletor `/resume` mantêm o modelo que estavam usando quando a transcrição foi salva, independentemente da configuração `model` atual. Se esse modelo foi descontinuado ou é excluído por [`availableModels`](#restrict-model-selection), a sessão cai para a ordem de precedência normal. Isso evita que a escolha `/model` de outra sessão altere o modelo ao retomar.108As sessões retomadas iniciadas com `claude --resume`, `--continue` ou o seletor `/resume` mantêm o modelo que estavam usando quando a transcrição foi salva, independentemente da configuração `model` atual. Se esse modelo foi descontinuado ou é excluído por [`availableModels`](#restrict-model-selection), a sessão cai para a ordem de precedência normal. Isso evita que a escolha `/model` de outra sessão altere o modelo ao retomar.

109 109 

110Um modelo que você escolhe para o novo lançamento com `--model` ou `ANTHROPIC_MODEL` ainda tem precedência sobre o modelo restaurado. {/* min-version: 2.1.195 */}A partir da v2.1.195, também tem uma variável da família [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables).110Um modelo que você escolhe para o novo lançamento com `--model` ou `ANTHROPIC_MODEL` ainda tem precedência sobre o modelo restaurado. A partir da v2.1.195, também tem uma variável da família [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables).

111 111 

112Quando o modelo ativo na inicialização vem das configurações do projeto ou gerenciadas em vez de sua própria seleção, o cabeçalho de inicialização mostra qual arquivo de configurações o definiu. Execute `/model` para substituir; a configuração do projeto ou gerenciada reaplicada no próximo lançamento.112Quando o modelo ativo na inicialização vem das configurações do projeto ou gerenciadas em vez de sua própria seleção, o cabeçalho de inicialização mostra qual arquivo de configurações o definiu. Execute `/model` para substituir; a configuração do projeto ou gerenciada reaplicada no próximo lançamento.

113 113 

114Quando uma mudança de modelo é solicitada através do método `setModel()` do [Agent SDK](/pt/agent-sdk/overview) ou por um aplicativo como o [Desktop app](/pt/desktop) que executa o Claude Code CLI para você, Claude Code verifica se a string é uma que ele reconhece antes de salvá-la. Esta verificação requer Claude Code v2.1.200 ou posterior. Na API Anthropic, Claude Code reconhece:114Quando uma mudança de modelo é solicitada através do método `setModel()` do [Agent SDK](/docs/pt/agent-sdk/overview) ou por um aplicativo como o [Desktop app](/docs/pt/desktop) que executa o Claude Code CLI para você, Claude Code verifica se a string é uma que ele reconhece antes de salvá-la. Esta verificação requer Claude Code v2.1.200 ou posterior. Na API Anthropic, Claude Code reconhece:

115 115 

116* um alias de modelo116* um alias de modelo

117* uma entrada do seletor `/model`117* uma entrada do seletor `/model`

118* qualquer nome que comece com `claude-`118* qualquer nome que comece com `claude-`

119* um valor que você configurou como uma [opção de modelo personalizado](#add-a-custom-model-option) ou em [`modelOverrides`](#override-model-ids-per-version)119* um valor que você configurou como uma [opção de modelo personalizado](#add-a-custom-model-option) ou em [`modelOverrides`](#override-model-ids-per-version)

120 120 

121Claude Code rejeita uma string não reconhecida com `Model "<name>" is not a recognized model id.` e a sessão mantém seu modelo atual, em vez de salvar a string e falhar na próxima solicitação. Consulte [a referência de erro](/pt/errors#model-is-not-a-recognized-model-id) para etapas de recuperação.121Claude Code rejeita uma string não reconhecida com `Model "<name>" is not a recognized model id.` e a sessão mantém seu modelo atual, em vez de salvar a string e falhar na próxima solicitação. Consulte [a referência de erro](/docs/pt/errors#model-is-not-a-recognized-model-id) para etapas de recuperação.

122 122 

123A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/pt/claude-platform-on-aws) e atrás de um [gateway LLM](/pt/llm-gateway) ou um `ANTHROPIC_BASE_URL` personalizado, seu provedor ou gateway define os nomes dos modelos, portanto Claude Code passa qualquer string sem verificá-la. A verificação também não cobre o sinalizador `--model`, a variável de ambiente `ANTHROPIC_MODEL` ou a configuração `model`; um valor digitado incorretamente lá produz [There's an issue with the selected model](/pt/errors#theres-an-issue-with-the-selected-model) na primeira solicitação em vez disso.123A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) e atrás de um [gateway LLM](/docs/pt/llm-gateway) ou um `ANTHROPIC_BASE_URL` personalizado, seu provedor ou gateway define os nomes dos modelos, portanto Claude Code passa qualquer string sem verificá-la. A verificação também não cobre o sinalizador `--model`, a variável de ambiente `ANTHROPIC_MODEL` ou a configuração `model`; um valor digitado incorretamente lá produz [There's an issue with the selected model](/docs/pt/errors#theres-an-issue-with-the-selected-model) na primeira solicitação em vez disso.

124 124 

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

126 126 

127Exemplo de uso:127Exemplo de uso:

128 128 


149 Restringir seleção de modelo149 Restringir seleção de modelo

150</h2>150</h2>

151 151 

152Os administradores corporativos podem usar `availableModels` em [configurações gerenciadas ou de política](/pt/settings#settings-files) para restringir quais modelos os usuários podem selecionar. As entradas correspondem a uma família de modelo como `sonnet`, um prefixo de versão como `claude-sonnet-4-5`, ou um ID de modelo completo como `claude-sonnet-4-5-20250929`.152Os administradores corporativos podem usar `availableModels` em [configurações gerenciadas ou de política](/docs/pt/settings#settings-files) para restringir quais modelos os usuários podem selecionar. As entradas correspondem a uma família de modelo como `sonnet`, um prefixo de versão como `claude-sonnet-4-5`, ou um ID de modelo completo como `claude-sonnet-4-5-20250929`.

153 153 

154Quando `availableModels` é definido, a lista de permissões se aplica em todos os lugares onde um usuário pode especificar um modelo:154Quando `availableModels` é definido, a lista de permissões se aplica em todos os lugares onde um usuário pode especificar um modelo:

155 155 

156* **Modelo de sessão principal**: `/model`, o sinalizador `--model`, a variável de ambiente `ANTHROPIC_MODEL`, a configuração `model` e o modelo restaurado ao [retomar uma sessão](#setting-your-model)156* **Modelo de sessão principal**: `/model`, o sinalizador `--model`, a variável de ambiente `ANTHROPIC_MODEL`, a configuração `model` e o modelo restaurado ao [retomar uma sessão](#setting-your-model)

157* **Resolução de alias**: {/* min-version: 2.1.176 */}as variáveis de ambiente `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` e `ANTHROPIC_DEFAULT_FABLE_MODEL` não podem redirecionar um alias permitido para um modelo fora da lista157* **Resolução de alias**: as variáveis de ambiente `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` e `ANTHROPIC_DEFAULT_FABLE_MODEL` não podem redirecionar um alias permitido para um modelo fora da lista

158* **Modo rápido**: {/* min-version: 2.1.176 */}`/fast` recusa alternar quando isso implicaria mudar implicitamente para um modelo Opus fora da lista, com a mensagem "não está nos modelos permitidos da sua organização"158* **Modo rápido**: `/fast` recusa alternar quando isso implicaria mudar implicitamente para um modelo Opus fora da lista, com a mensagem "não está nos modelos permitidos da sua organização"

159* **Modelos de subagente**: o campo `model` em [subagente](/pt/sub-agents#choose-a-model) frontmatter, o parâmetro `model` da ferramenta Agent, `CLAUDE_CODE_SUBAGENT_MODEL` e, na v2.1.197 e anterior, o seletor de modelo no assistente `/agents` {/* max-version: 2.1.197 */}159* **Modelos de subagente**: o campo `model` em [subagente](/docs/pt/sub-agents#choose-a-model) frontmatter, o parâmetro `model` da ferramenta Agent, `CLAUDE_CODE_SUBAGENT_MODEL` e, na v2.1.197 e anterior, o seletor de modelo no assistente `/agents`&#x20;

160* **Modelo de skill e comando**: o frontmatter `model` em [skills e comandos](/pt/skills)160* **Modelo de skill e comando**: o frontmatter `model` em [skills e comandos](/docs/pt/skills)

161* **Modelo de advisor**: a configuração [`advisorModel`](/pt/advisor) configurada e o sinalizador `--advisor`161* **Modelo de advisor**: a configuração [`advisorModel`](/docs/pt/advisor) configurada e o sinalizador `--advisor`

162* **Modelo de agente de fundo**: o modelo selecionado no [seletor de dispatch](/pt/agent-view)162* **Modelo de agente de fundo**: o modelo selecionado no [seletor de dispatch](/docs/pt/agent-view)

163 163 

164Na API Anthropic e [Claude Platform on AWS](/pt/claude-platform-on-aws), um alias de família de modelo, `opus`, `sonnet`, `haiku` ou `fable`, se resolve para a versão mais recente de sua família que a lista de permissões permite. Quando a lista de permissões fixa versões específicas, por exemplo `["sonnet", "claude-opus-4-6"]`, tanto `/model opus` quanto `--model opus` selecionam Claude Opus 4.6, o Opus mais recente permitido, e mostram um aviso nomeando tanto os modelos solicitados quanto os substituídos. Antes da v2.1.205, um alias cuja versão mais recente lançada estava fora da lista era rejeitado ou substituído como qualquer outra seleção bloqueada, mesmo quando a lista permitia uma versão mais antiga.164Na API Anthropic e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), um alias de família de modelo, `opus`, `sonnet`, `haiku` ou `fable`, se resolve para a versão mais recente de sua família que a lista de permissões permite. Quando a lista de permissões fixa versões específicas, por exemplo `["sonnet", "claude-opus-4-6"]`, tanto `/model opus` quanto `--model opus` selecionam Claude Opus 4.6, o Opus mais recente permitido, e mostram um aviso nomeando tanto os modelos solicitados quanto os substituídos. Antes da v2.1.205, um alias cuja versão mais recente lançada estava fora da lista era rejeitado ou substituído como qualquer outra seleção bloqueada, mesmo quando a lista permitia uma versão mais antiga.

165 165 

166Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e [Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) usam IDs de implantação específicos do provedor em vez de IDs de modelo Anthropic, portanto um alias bloqueado lá segue o comportamento de rejeição e substituição abaixo.166Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e [Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) usam IDs de implantação específicos do provedor em vez de IDs de modelo Anthropic, portanto um alias bloqueado lá segue o comportamento de rejeição e substituição abaixo.

167 167 

168Claude Code trata qualquer outra seleção bloqueada de acordo com onde o modelo foi definido:168Claude Code trata qualquer outra seleção bloqueada de acordo com onde o modelo foi definido:

169 169 


173* **configuração `advisorModel`**: o advisor é desabilitado para a sessão173* **configuração `advisorModel`**: o advisor é desabilitado para a sessão

174* **sinalizador `--advisor`**: Claude Code sai com um erro no lançamento174* **sinalizador `--advisor`**: Claude Code sai com um erro no lançamento

175 175 

176Os modelos excluídos são ocultados do seletor `/model`. {/* min-version: 2.1.199 */}Um ID de modelo completo na lista que não tem uma linha de seletor integrada, como uma versão mais antiga que a lista fixa, aparece no seletor `/model` como sua própria linha rotulada. Antes da v2.1.199, tal ID era selecionável apenas digitando `/model <id>`.176Os modelos excluídos são ocultados do seletor `/model`. Um ID de modelo completo na lista que não tem uma linha de seletor integrada, como uma versão mais antiga que a lista fixa, aparece no seletor `/model` como sua própria linha rotulada. Antes da v2.1.199, tal ID era selecionável apenas digitando `/model <id>`.

177 177 

178As mudanças de modelo que Claude Code faz em seu nome são verificadas da mesma forma:178As mudanças de modelo que Claude Code faz em seu nome são verificadas da mesma forma:

179 179 

180* **[Cadeias de modelo de fallback](#fallback-model-chains)**: elementos fora da lista de permissões são descartados180* **[Cadeias de modelo de fallback](#fallback-model-chains)**: elementos fora da lista de permissões são descartados

181* **Atualizações de modo de plano**: na API Anthropic e Claude Platform on AWS, uma atualização como [`opusplan`](#opusplan-model-setting) para um modelo excluído usa a versão mais recente permitida da família de atualização. Em provedores com IDs de modelo específicos do provedor, e quando nenhuma versão é permitida, a atualização é ignorada e o planejamento continua no modelo da sessão181* **Atualizações de modo de plano**: na API Anthropic e Claude Platform on AWS, uma atualização como [`opusplan`](#opusplan-model-setting) para um modelo excluído usa a versão mais recente permitida da família de atualização. Em provedores com IDs de modelo específicos do provedor, e quando nenhuma versão é permitida, a atualização é ignorada e o planejamento continua no modelo da sessão

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

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

184 184 

185```json theme={null}185```json theme={null}

186{186{


196 196 

197| Mecanismo de entrega | CLI e IDE | Sessões locais do Desktop | Sessões web, mobile e cloud | Agent SDK e não-interativo | Cowork |197| Mecanismo de entrega | CLI e IDE | Sessões locais do Desktop | Sessões web, mobile e cloud | Agent SDK e não-interativo | Cowork |

198| :------------------------------------------------------------------------------------------------- | :-------- | :------------------------ | :-------------------------- | :------------------------- | :---------------------- |198| :------------------------------------------------------------------------------------------------- | :-------- | :------------------------ | :-------------------------- | :------------------------- | :---------------------- |

199| [Configurações gerenciadas pelo servidor](/pt/server-managed-settings) do console de administração | Imposto | Imposto | Imposto | Imposto | Não entregue |199| [Configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) do console de administração | Imposto | Imposto | Imposto | Imposto | Não entregue |

200| [Arquivos de configurações gerenciadas ou MDM](/pt/settings#settings-files) | Imposto | Imposto | Não entregue | Imposto | Imposto onde implantado |200| [Arquivos de configurações gerenciadas ou MDM](/docs/pt/settings#settings-files) | Imposto | Imposto | Não entregue | Imposto | Imposto onde implantado |

201 201 

202* Sessões em nuvem, em [Claude Code na web](/pt/claude-code-on-the-web) ou no aplicativo Desktop, são executadas em VMs gerenciadas pela Anthropic: as configurações implantadas no seu dispositivo não as alcançam, portanto entregue a lista de permissões através de configurações gerenciadas pelo servidor. Uma mudança de modelo no meio da sessão em uma sessão em nuvem é rejeitada quando o modelo solicitado é excluído pela lista de permissões. A rejeição do lado do servidor na criação da sessão se aplica a [restrições de modelo da organização](#organization-model-restrictions), não à chave de configurações `availableModels`.202* Sessões em nuvem, em [Claude Code na web](/docs/pt/claude-code-on-the-web) ou no aplicativo Desktop, são executadas em VMs gerenciadas pela Anthropic: as configurações implantadas no seu dispositivo não as alcançam, portanto entregue a lista de permissões através de configurações gerenciadas pelo servidor. Uma mudança de modelo no meio da sessão em uma sessão em nuvem é rejeitada quando o modelo solicitado é excluído pela lista de permissões. A rejeição do lado do servidor na criação da sessão se aplica a [restrições de modelo da organização](#organization-model-restrictions), não à chave de configurações `availableModels`.

203* Cowork, a aba de trabalho agentic no aplicativo Claude Desktop, não é uma superfície Claude Code e não recebe configurações gerenciadas pelo servidor por design. Um arquivo de configurações gerenciadas se aplica a sessões Cowork quando está presente onde a sessão é executada; sessões Cowork remotas são executadas em VMs gerenciadas pela Anthropic, onde um arquivo implantado no dispositivo não está presente.203* Cowork, a aba de trabalho agentic no aplicativo Claude Desktop, não é uma superfície Claude Code e não recebe configurações gerenciadas pelo servidor por design. Um arquivo de configurações gerenciadas se aplica a sessões Cowork quando está presente onde a sessão é executada; sessões Cowork remotas são executadas em VMs gerenciadas pela Anthropic, onde um arquivo implantado no dispositivo não está presente.

204* Sessões em [provedores de terceiros](/pt/server-managed-settings#platform-availability) como Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e [Claude Platform on AWS](/pt/claude-platform-on-aws) não recebem configurações gerenciadas pelo servidor, portanto entregue a lista de permissões através de arquivos de configurações gerenciadas ou MDM lá.204* Sessões em [provedores de terceiros](/docs/pt/server-managed-settings#platform-availability) como Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws) não recebem configurações gerenciadas pelo servidor, portanto entregue a lista de permissões através de arquivos de configurações gerenciadas ou MDM lá.

205* A entrega gerenciada pelo servidor também requer que a sessão se autentique com um login de organização ou uma chave de API configurada diretamente. Frotas que geram chaves apenas através de um script [`apiKeyHelper`](/pt/settings#available-settings) devem entregar a lista de permissões através de arquivos de configurações gerenciadas ou MDM.205* A entrega gerenciada pelo servidor também requer que a sessão se autentique com um login de organização ou uma chave de API configurada diretamente. Frotas que geram chaves apenas através de um script [`apiKeyHelper`](/docs/pt/settings#available-settings) devem entregar a lista de permissões através de arquivos de configurações gerenciadas ou MDM.

206* A aba Desktop Code também hospeda [sessões SSH](/pt/desktop#ssh-sessions), que leem o arquivo de configurações gerenciadas do host remoto em que são executadas. Veja [Configurações gerenciadas do Desktop](/pt/desktop#managed-settings).206* A aba Desktop Code também hospeda [sessões SSH](/docs/pt/desktop#ssh-sessions), que leem o arquivo de configurações gerenciadas do host remoto em que são executadas. Veja [Configurações gerenciadas do Desktop](/docs/pt/desktop#managed-settings).

207* Os seletores de modelo em claude.ai e no aplicativo Desktop ocultam ou desabilitam modelos excluídos pela lista de permissões da sua organização. O estado do seletor é uma conveniência para os usuários; a imposição acontece na sessão.207* Os seletores de modelo em claude.ai e no aplicativo Desktop ocultam ou desabilitam modelos excluídos pela lista de permissões da sua organização. O estado do seletor é uma conveniência para os usuários; a imposição acontece na sessão.

208 208 

209<h3 id="default-model-behavior">209<h3 id="default-model-behavior">


231 231 

232`enforceAvailableModels` não tem efeito quando `availableModels` não está definido ou está vazio: com `availableModels: []`, o modelo Padrão para o tipo de conta permanece utilizável, portanto a configuração não pode bloquear os usuários de cada modelo. Quando `availableModels` é não vazio, mas nenhuma entrada se resolve para um modelo permitido e disponível, a imposição se degrada e Padrão cai para o padrão do tipo de conta, com um aviso visível apenas em `--debug`. Mantenha pelo menos uma entrada garantidamente disponível na lista para evitar isso.232`enforceAvailableModels` não tem efeito quando `availableModels` não está definido ou está vazio: com `availableModels: []`, o modelo Padrão para o tipo de conta permanece utilizável, portanto a configuração não pode bloquear os usuários de cada modelo. Quando `availableModels` é não vazio, mas nenhuma entrada se resolve para um modelo permitido e disponível, a imposição se degrada e Padrão cai para o padrão do tipo de conta, com um aviso visível apenas em `--debug`. Mantenha pelo menos uma entrada garantidamente disponível na lista para evitar isso.

233 233 

234Implante ambas as chaves na [fonte gerenciada de maior precedência](/pt/settings#settings-precedence): as fontes gerenciadas implantadas pelo administrador não se mesclam, portanto um par colocado em um arquivo de configurações gerenciadas é ignorado quando o console de administração entrega qualquer configuração.234Implante ambas as chaves na [fonte gerenciada de maior precedência](/docs/pt/settings#settings-precedence): as fontes gerenciadas implantadas pelo administrador não se mesclam, portanto um par colocado em um arquivo de configurações gerenciadas é ignorado quando o console de administração entrega qualquer configuração.

235 235 

236<h3 id="control-the-model-users-run-on">236<h3 id="control-the-model-users-run-on">

237 Controlar o modelo em que os usuários executam237 Controlar o modelo em que os usuários executam


265 Comportamento de mesclagem265 Comportamento de mesclagem

266</h3>266</h3>

267 267 

268Quando a [fonte de configurações gerenciadas de maior precedência](/pt/server-managed-settings#settings-precedence) define `availableModels`, apenas essa lista se aplica: as entradas em configurações de usuário, projeto ou local não podem estendê-la, e as fontes gerenciadas implantadas pelo administrador não se mesclam entre si, portanto uma lista implantada em um arquivo de configurações gerenciadas é ignorada quando as configurações gerenciadas pelo servidor entregam qualquer chave. Caso contrário, as listas de configurações de usuário, projeto e local são [concatenadas e desduplicadas](/pt/settings#settings-precedence) como outras configurações de array. {/* min-version: 2.1.175 */}A partir de Claude Code v2.1.175, a lista gerenciada substitui entradas de menor precedência; versões anteriores as mesclam.268Quando a [fonte de configurações gerenciadas de maior precedência](/docs/pt/server-managed-settings#settings-precedence) define `availableModels`, apenas essa lista se aplica: as entradas em configurações de usuário, projeto ou local não podem estendê-la, e as fontes gerenciadas implantadas pelo administrador não se mesclam entre si, portanto uma lista implantada em um arquivo de configurações gerenciadas é ignorada quando as configurações gerenciadas pelo servidor entregam qualquer chave. Caso contrário, as listas de configurações de usuário, projeto e local são [concatenadas e desduplicadas](/docs/pt/settings#settings-precedence) como outras configurações de array. A partir de Claude Code v2.1.175, a lista gerenciada substitui entradas de menor precedência; versões anteriores as mesclam.

269 269 

270Dentro da lista efetiva, uma entrada nomeando um modelo específico em uma família, seja um prefixo de versão ou um ID de modelo completo, desativa a entrada de wildcard dessa família: `["sonnet", "claude-sonnet-4-5"]` permite apenas versões Sonnet 4.5, não cada modelo Sonnet.270Dentro da lista efetiva, uma entrada nomeando um modelo específico em uma família, seja um prefixo de versão ou um ID de modelo completo, desativa a entrada de wildcard dessa família: `["sonnet", "claude-sonnet-4-5"]` permite apenas versões Sonnet 4.5, não cada modelo Sonnet.

271 271 


273 IDs de modelo Mantle273 IDs de modelo Mantle

274</h3>274</h3>

275 275 

276Quando o [endpoint Bedrock Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) está habilitado, as entradas em `availableModels` que começam com `anthropic.` são adicionadas ao seletor `/model` como opções personalizadas e roteadas para o endpoint Mantle. Esta é uma exceção à correspondência de alias descrita em [Fixar modelos para implantações de terceiros](#pin-models-for-third-party-deployments). A configuração ainda restringe o seletor às entradas listadas, e um ID Mantle incorpora um nome de família, portanto conta como uma entrada específica e desativa o wildcard dessa família: junto com qualquer ID Mantle, liste os prefixos de versão ou IDs completos que você deseja manter selecionáveis. Veja [Comportamento de mesclagem](#merge-behavior).276Quando o [endpoint Bedrock Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint) está habilitado, as entradas em `availableModels` que começam com `anthropic.` são adicionadas ao seletor `/model` como opções personalizadas e roteadas para o endpoint Mantle. Esta é uma exceção à correspondência de alias descrita em [Fixar modelos para implantações de terceiros](#pin-models-for-third-party-deployments). A configuração ainda restringe o seletor às entradas listadas, e um ID Mantle incorpora um nome de família, portanto conta como uma entrada específica e desativa o wildcard dessa família: junto com qualquer ID Mantle, liste os prefixos de versão ou IDs completos que você deseja manter selecionáveis. Veja [Comportamento de mesclagem](#merge-behavior).

277 277 

278<h3 id="organization-model-restrictions">278<h3 id="organization-model-restrictions">

279 Restrições de modelo da organização279 Restrições de modelo da organização


283 283 

284A restrição se aplica quando um membro faz login ou usa sua própria chave de API. Credenciais com escopo de organização, como chaves de serviço da organização, não estão vinculadas a um usuário, portanto a restrição não se aplica a elas.284A restrição se aplica quando um membro faz login ou usa sua própria chave de API. Credenciais com escopo de organização, como chaves de serviço da organização, não estão vinculadas a um usuário, portanto a restrição não se aplica a elas.

285 285 

286O Claude Console não possui controle de restrição de modelo. Organizações sem um plano Claude Enterprise, incluindo aquelas cujos membros se autenticam através da API Anthropic, restringem modelos com [`availableModels`](#restrict-model-selection) em [configurações gerenciadas](/pt/settings#settings-files), adicionando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) para cobrir a opção Padrão. Essas configurações são impostas pelo Claude Code em si, não pelo servidor.286O Claude Console não possui controle de restrição de modelo. Organizações sem um plano Claude Enterprise, incluindo aquelas cujos membros se autenticam através da API Anthropic, restringem modelos com [`availableModels`](#restrict-model-selection) em [configurações gerenciadas](/docs/pt/settings#settings-files), adicionando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) para cobrir a opção Padrão. Essas configurações são impostas pelo Claude Code em si, não pelo servidor.

287 287 

288Um modelo restrito é ocultado do seletor `/model`. Selecioná-lo pelo nome com `--model`, a variável de ambiente `ANTHROPIC_MODEL` ou a configuração `model` mostra o aviso `Model "<name>" is restricted by your organization's settings. Using <model> instead.` e a sessão é iniciada em um modelo permitido. Digitar `/model <name>` para um modelo restrito é rejeitado com `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` e a sessão mantém seu modelo atual.288Um modelo restrito é ocultado do seletor `/model`. Selecioná-lo pelo nome com `--model`, a variável de ambiente `ANTHROPIC_MODEL` ou a configuração `model` mostra o aviso `Model "<name>" is restricted by your organization's settings. Using <model> instead.` e a sessão é iniciada em um modelo permitido. Digitar `/model <name>` para um modelo restrito é rejeitado com `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` e a sessão mantém seu modelo atual.

289 289 


296* Os modelos Haiku estão sempre disponíveis e não podem ser desabilitados, portanto cada membro mantém pelo menos um modelo utilizável.296* Os modelos Haiku estão sempre disponíveis e não podem ser desabilitados, portanto cada membro mantém pelo menos um modelo utilizável.

297* Uma mudança de acesso entra em vigor em novas solicitações dentro de cerca de um minuto; o seletor `/model` reflete isso na próxima vez que uma sessão é iniciada.297* Uma mudança de acesso entra em vigor em novas solicitações dentro de cerca de um minuto; o seletor `/model` reflete isso na próxima vez que uma sessão é iniciada.

298 298 

299Ambas as restrições se aplicam juntas: um modelo é selecionável apenas quando é permitido por `availableModels` e não é restrito pela organização. As restrições da organização são entregues a sessões na API Anthropic e implantações de [gateway LLM](/pt/llm-gateway). Sessões em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS não as recebem, portanto use `availableModels` nesses provedores.299Ambas as restrições se aplicam juntas: um modelo é selecionável apenas quando é permitido por `availableModels` e não é restrito pela organização. As restrições da organização são entregues a sessões na API Anthropic e implantações de [gateway LLM](/docs/pt/llm-gateway). Sessões em Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS não as recebem, portanto use `availableModels` nesses provedores.

300 300 

301<h2 id="organization-default-model">301<h2 id="organization-default-model">

302 Modelo padrão da organização302 Modelo padrão da organização

303</h2>303</h2>

304 304 

305{/* plan-availability: feature=org-default-model plans=enterprise */}

306 

307Os administradores da organização em planos Claude Enterprise podem definir um modelo padrão para membros do Claude Code a partir do console de administração claude.ai, para toda a organização ou por função personalizada. Quando um é definido, a opção Padrão resolve para esse modelo em vez do [padrão do tipo de conta](#default-model-setting). Requer Claude Code v2.1.196 ou posterior.305Os administradores da organização em planos Claude Enterprise podem definir um modelo padrão para membros do Claude Code a partir do console de administração claude.ai, para toda a organização ou por função personalizada. Quando um é definido, a opção Padrão resolve para esse modelo em vez do [padrão do tipo de conta](#default-model-setting). Requer Claude Code v2.1.196 ou posterior.

308 306 

309A linha Padrão no seletor `/model` mostra o nome do modelo padrão da organização com o rótulo Padrão da organização. O rótulo lê Padrão da organização se o administrador definiu o padrão para toda a organização ou para sua função. Um padrão de função cobre membros dessa função personalizada e tem precedência sobre o padrão em toda a organização; quando várias de suas funções definem diferentes padrões, o modelo mais capaz se aplica.307A linha Padrão no seletor `/model` mostra o nome do modelo padrão da organização com o rótulo Padrão da organização. O rótulo lê Padrão da organização se o administrador definiu o padrão para toda a organização ou para sua função. Um padrão de função cobre membros dessa função personalizada e tem precedência sobre o padrão em toda a organização; quando várias de suas funções definem diferentes padrões, o modelo mais capaz se aplica.


311O modelo padrão da organização é um ponto de partida, não uma restrição, e qualquer outra seleção de modelo tem precedência sobre ele:309O modelo padrão da organização é um ponto de partida, não uma restrição, e qualquer outra seleção de modelo tem precedência sobre ele:

312 310 

313* o sinalizador `--model` e a variável de ambiente `ANTHROPIC_MODEL`311* o sinalizador `--model` e a variável de ambiente `ANTHROPIC_MODEL`

314* um valor `model` em [configurações gerenciadas](/pt/settings#settings-files) ou fornecido através de `--settings`312* um valor `model` em [configurações gerenciadas](/docs/pt/settings#settings-files) ou fornecido através de `--settings`

315* um valor `model` em suas configurações de usuário, projeto ou local, incluindo um modelo que você salva com `/model`313* um valor `model` em suas configurações de usuário, projeto ou local, incluindo um modelo que você salva com `/model`

316 314 

317Os administradores também podem configurar o modelo padrão da organização para substituir a seleção do usuário. Com a substituição ativada, ele tem precedência sobre o valor `model` em configurações de usuário, projeto e local, portanto um modelo que você salva com `/model` se aplica para a sessão atual e o modelo padrão da organização retorna no próximo lançamento. Quando sua seleção difere, `/model` mostra `Your organization's default (<model>) applies on restart`. O sinalizador `--model`, `ANTHROPIC_MODEL`, configurações gerenciadas e `--settings` ainda têm precedência mesmo com a substituição ativada. A substituição está disponível para um conjunto limitado de organizações; pergunte ao seu time de contas Anthropic sobre disponibilidade.315Os administradores também podem configurar o modelo padrão da organização para substituir a seleção do usuário. Com a substituição ativada, ele tem precedência sobre o valor `model` em configurações de usuário, projeto e local, portanto um modelo que você salva com `/model` se aplica para a sessão atual e o modelo padrão da organização retorna no próximo lançamento. Quando sua seleção difere, `/model` mostra `Your organization's default (<model>) applies on restart`. O sinalizador `--model`, `ANTHROPIC_MODEL`, configurações gerenciadas e `--settings` ainda têm precedência mesmo com a substituição ativada. A substituição está disponível para um conjunto limitado de organizações; pergunte ao seu time de contas Anthropic sobre disponibilidade.


326 324 

327* [`availableModels`](#restrict-model-selection) por si só nunca restringe a opção Padrão, portanto um padrão da organização fora da lista de permissões ainda se aplica. Quando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) também está definido, um padrão da organização fora da lista de permissões é remapeado para a primeira entrada da lista de permissões, como qualquer outro Padrão325* [`availableModels`](#restrict-model-selection) por si só nunca restringe a opção Padrão, portanto um padrão da organização fora da lista de permissões ainda se aplica. Quando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) também está definido, um padrão da organização fora da lista de permissões é remapeado para a primeira entrada da lista de permissões, como qualquer outro Padrão

328* um padrão da organização que [restrições de modelo da organização](#organization-model-restrictions) negam para sua conta é substituído pelo modelo mais recente permitido em sua família, ou uma família de menor custo quando cada versão dela é restrita326* um padrão da organização que [restrições de modelo da organização](#organization-model-restrictions) negam para sua conta é substituído pelo modelo mais recente permitido em sua família, ou uma família de menor custo quando cada versão dela é restrita

329* um padrão da organização que não está disponível para sua conta, como Fable 5 sob [retenção zero de dados](/pt/zero-data-retention), é ignorado, e a opção Padrão resolve para o padrão do tipo de conta327* um padrão da organização que não está disponível para sua conta, como Fable 5 sob [retenção zero de dados](/docs/pt/zero-data-retention), é ignorado, e a opção Padrão resolve para o padrão do tipo de conta

330 328 

331A partir da v2.1.199, quando o modelo padrão da organização é uma família de modelo diferente do padrão usual do tipo de conta, o seletor `/model` mantém uma linha separada para essa família usual, para que você ainda possa alternar para ela para uma sessão. Na v2.1.196 até v2.1.198, essa linha está faltando no seletor.329A partir da v2.1.199, quando o modelo padrão da organização é uma família de modelo diferente do padrão usual do tipo de conta, o seletor `/model` mantém uma linha separada para essa família usual, para que você ainda possa alternar para ela para uma sessão. Na v2.1.196 até v2.1.198, essa linha está faltando no seletor.

332 330 

333O modelo padrão da organização é entregue a sessões autenticadas com a API Anthropic. Sessões em implantações de [gateway LLM](/pt/llm-gateway), Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e Claude Platform on AWS não o recebem. Para definir um padrão nesses deployments, use a chave `model` em [configurações gerenciadas](/pt/settings#settings-files) em vez disso.331O modelo padrão da organização é entregue a sessões autenticadas com a API Anthropic. Sessões em implantações de [gateway LLM](/docs/pt/llm-gateway), Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e Claude Platform on AWS não o recebem. Para definir um padrão nesses deployments, use a chave `model` em [configurações gerenciadas](/docs/pt/settings#settings-files) em vez disso.

334 332 

335<h2 id="organization-effort-limits">333<h2 id="organization-effort-limits">

336 Limites de esforço da organização334 Limites de esforço da organização

337</h2>335</h2>

338 336 

339{/* plan-availability: feature=org-effort-limits plans=enterprise */}

340 

341Os administradores da organização em planos Claude Enterprise podem definir um [nível de esforço](#adjust-effort-level) máximo por modelo para cada função personalizada, junto com [restrições de modelo da organização](#organization-model-restrictions) no nível de função. Os níveis acima do limite não são oferecidos no seletor `/effort`, e nomear um nível mais alto com `--effort` ou `/effort` é executado no limite em vez disso. Em sessões interativas e execuções `--print` em texto simples, um aviso nomeia os níveis solicitado e aplicado; com saída `json` ou `stream-json` ou em agentes de fundo, o limite se aplica silenciosamente. Os limites são por modelo, portanto alternar modelos pode alterar quais níveis estão disponíveis. Quando várias de suas funções concedem o mesmo modelo, o limite menos restritivo se aplica. Requer Claude Code v2.1.195 ou posterior.337Os administradores da organização em planos Claude Enterprise podem definir um [nível de esforço](#adjust-effort-level) máximo por modelo para cada função personalizada, junto com [restrições de modelo da organização](#organization-model-restrictions) no nível de função. Os níveis acima do limite não são oferecidos no seletor `/effort`, e nomear um nível mais alto com `--effort` ou `/effort` é executado no limite em vez disso. Em sessões interativas e execuções `--print` em texto simples, um aviso nomeia os níveis solicitado e aplicado; com saída `json` ou `stream-json` ou em agentes de fundo, o limite se aplica silenciosamente. Os limites são por modelo, portanto alternar modelos pode alterar quais níveis estão disponíveis. Quando várias de suas funções concedem o mesmo modelo, o limite menos restritivo se aplica. Requer Claude Code v2.1.195 ou posterior.

342 338 

343Os limites de esforço são entregues junto com [restrições de modelo da organização](#organization-model-restrictions) e seguem a mesma disponibilidade de provedor: sessões em Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e Claude Platform on AWS não os recebem.339Os limites de esforço são entregues junto com [restrições de modelo da organização](#organization-model-restrictions) e seguem a mesma disponibilidade de provedor: sessões em Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e Claude Platform on AWS não os recebem.


359 355 

360Enterprise pagamento conforme o uso significa uma organização Enterprise cobrada por uso em vez de por assento de assinatura.356Enterprise pagamento conforme o uso significa uma organização Enterprise cobrada por uso em vez de por assento de assinatura.

361 357 

362{/* min-version: 2.1.207 */}Antes de v2.1.207, `default` resolvido para Opus 4.7 em Claude Platform na AWS e para Sonnet 4.5 em Amazon Bedrock e Google Cloud's Agent Platform.358Antes de v2.1.207, `default` resolvido para Opus 4.7 em Claude Platform na AWS e para Sonnet 4.5 em Amazon Bedrock e Google Cloud's Agent Platform.

363 359 

364Quando um administrador definiu um [modelo padrão da organização](#organization-default-model), `default` resolve para esse modelo em vez do padrão do tipo de conta acima. Requer Claude Code v2.1.196 ou posterior.360Quando um administrador definiu um [modelo padrão da organização](#organization-default-model), `default` resolve para esse modelo em vez do padrão do tipo de conta acima. Requer Claude Code v2.1.196 ou posterior.

365 361 


382 378 

383Quando [`availableModels`](#restrict-model-selection) exclui o Opus mais recente, mas permite uma versão mais antiga, por exemplo `["sonnet", "claude-opus-4-6"]`, `opusplan` usa o Opus mais recente permitido para planejamento e permanece apenas em Sonnet quando todo Opus é excluído. Uma sessão Haiku que normalmente seria atualizada para Sonnet em Plan Mode da mesma forma usa o Sonnet mais recente permitido e permanece em Haiku apenas quando todo Sonnet é excluído. Antes de v2.1.205, Plan Mode permanecia no modelo da sessão sempre que a versão mais recente da família de atualização era excluída, mesmo quando a lista de permissões permitia uma mais antiga.379Quando [`availableModels`](#restrict-model-selection) exclui o Opus mais recente, mas permite uma versão mais antiga, por exemplo `["sonnet", "claude-opus-4-6"]`, `opusplan` usa o Opus mais recente permitido para planejamento e permanece apenas em Sonnet quando todo Opus é excluído. Uma sessão Haiku que normalmente seria atualizada para Sonnet em Plan Mode da mesma forma usa o Sonnet mais recente permitido e permanece em Haiku apenas quando todo Sonnet é excluído. Antes de v2.1.205, Plan Mode permanecia no modelo da sessão sempre que a versão mais recente da família de atualização era excluída, mesmo quando a lista de permissões permitia uma mais antiga.

384 380 

385A substituição de uma versão mais antiga permitida se aplica na API Anthropic e [Claude Platform na AWS](/pt/claude-platform-on-aws). Na Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, cujas implantações usam IDs de modelo específicos do provedor, Plan Mode permanece no modelo da sessão sempre que o modelo de atualização é excluído.381A substituição de uma versão mais antiga permitida se aplica na API Anthropic e [Claude Platform na AWS](/docs/pt/claude-platform-on-aws). Na Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, cujas implantações usam IDs de modelo específicos do provedor, Plan Mode permanece no modelo da sessão sempre que o modelo de atualização é excluído.

386 382 

387Para uma abordagem híbrida onde Claude decide no meio da tarefa quando consultar um segundo modelo em vez de alternar no limite do plano, veja a [ferramenta advisor](/pt/advisor).383Para uma abordagem híbrida onde Claude decide no meio da tarefa quando consultar um segundo modelo em vez de alternar no limite do plano, veja a [ferramenta advisor](/docs/pt/advisor).

388 384 

389<h3 id="fallback-model-chains">385<h3 id="fallback-model-chains">

390 Cadeias de modelo de fallback386 Cadeias de modelo de fallback


400claude --fallback-model sonnet,haiku396claude --fallback-model sonnet,haiku

401```397```

402 398 

403Para persistir uma cadeia entre sessões, defina `fallbackModel` em [configurações](/pt/settings) como uma matriz:399Para persistir uma cadeia entre sessões, defina `fallbackModel` em [configurações](/docs/pt/settings) como uma matriz:

404 400 

405```json theme={null}401```json theme={null}

406{402{


421 417 

422Esta seção cobre fallback baseado em conteúdo de Fable 5. Para fallback baseado em disponibilidade quando um modelo está sobrecarregado ou indisponível, veja [Cadeias de modelo de fallback](#fallback-model-chains).418Esta seção cobre fallback baseado em conteúdo de Fable 5. Para fallback baseado em disponibilidade quando um modelo está sobrecarregado ou indisponível, veja [Cadeias de modelo de fallback](#fallback-model-chains).

423 419 

424Fable 5 é executado com classificadores de segurança para conteúdo de cibersegurança e biologia. Quando um classificador sinaliza uma solicitação, Claude Code executa novamente essa solicitação no modelo Opus padrão do seu provedor e mostra um aviso na transcrição. Na API Anthropic, implantações de [gateway LLM](/pt/llm-gateway) e [Claude Platform na AWS](/pt/claude-platform-on-aws), esse modelo é Opus 4.8. No [gateway de aplicativos Claude](/pt/claude-apps-gateway), é Opus 4.7 a menos que você aponte o alias [`opus`](#environment-variables) para outro modelo.420Fable 5 é executado com classificadores de segurança para conteúdo de cibersegurança e biologia. Quando um classificador sinaliza uma solicitação, Claude Code executa novamente essa solicitação no modelo Opus padrão do seu provedor e mostra um aviso na transcrição. Na API Anthropic, implantações de [gateway LLM](/docs/pt/llm-gateway) e [Claude Platform na AWS](/docs/pt/claude-platform-on-aws), esse modelo é Opus 4.8. No [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), é Opus 4.7 a menos que você aponte o alias [`opus`](#environment-variables) para outro modelo.

425 421 

426A sessão então continua nesse modelo Opus. Para retornar a Fable 5, execute `/model fable`.422A sessão então continua nesse modelo Opus. Para retornar a Fable 5, execute `/model fable`.

427 423 


444Alguns casos se comportam diferentemente:440Alguns casos se comportam diferentemente:

445 441 

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

447* Em sessões móveis [Claude Code na web](/pt/claude-code-on-the-web), editar e tentar novamente não é suportado. Alterne modelos ou continue a sessão de um navegador de desktop ou do aplicativo de desktop.443* Em sessões móveis [Claude Code na web](/docs/pt/claude-code-on-the-web), editar e tentar novamente não é suportado. Alterne modelos ou continue a sessão de um navegador de desktop ou do aplicativo de desktop.

448* Em [modo não interativo](/pt/cli-reference#cli-flags) e integrações SDK que não podem mostrar o prompt, uma solicitação sinalizada encerra a volta com uma recusa em vez disso.444* Em [modo não interativo](/docs/pt/cli-reference#cli-flags) e integrações SDK que não podem mostrar o prompt, uma solicitação sinalizada encerra a volta com uma recusa em vez disso.

449* Quando o alvo de fallback é bloqueado por [`availableModels`](#restrict-model-selection), o prompt não é mostrado. A solicitação sinalizada termina com a recusa, o mesmo que fallback automático quando o alvo é bloqueado.445* Quando o alvo de fallback é bloqueado por [`availableModels`](#restrict-model-selection), o prompt não é mostrado. A solicitação sinalizada termina com a recusa, o mesmo que fallback automático quando o alvo é bloqueado.

450 446 

451<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">447<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

452 Habilitar fallback em Bedrock, Agent Platform e Foundry448 Habilitar fallback em Bedrock, Agent Platform e Foundry

453</h4>449</h4>

454 450 

455Em [Amazon Bedrock](/pt/amazon-bedrock), [Google Cloud's Agent Platform](/pt/google-vertex-ai) e [Microsoft Foundry](/pt/microsoft-foundry), IDs de modelo são específicos do provedor, portanto o fallback automático opera apenas quando Claude Code pode identificar ambos os modelos envolvidos:451Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) e [Microsoft Foundry](/docs/pt/microsoft-foundry), IDs de modelo são específicos do provedor, portanto o fallback automático opera apenas quando Claude Code pode identificar ambos os modelos envolvidos:

456 452 

457* Claude Code deve reconhecer o modelo atual como Fable 5: o ID do modelo contém `claude-fable-5`, corresponde ao valor de `ANTHROPIC_DEFAULT_FABLE_MODEL` ou é mapeado com [`modelOverrides`](#override-model-ids-per-version).453* Claude Code deve reconhecer o modelo atual como Fable 5: o ID do modelo contém `claude-fable-5`, corresponde ao valor de `ANTHROPIC_DEFAULT_FABLE_MODEL` ou é mapeado com [`modelOverrides`](#override-model-ids-per-version).

458* O alvo de fallback deve resolver para um modelo Opus: o valor de `ANTHROPIC_DEFAULT_OPUS_MODEL` se definido, caso contrário uma entrada Opus 4.8 na lista de modelos do provedor.454* O alvo de fallback deve resolver para um modelo Opus: o valor de `ANTHROPIC_DEFAULT_OPUS_MODEL` se definido, caso contrário uma entrada Opus 4.8 na lista de modelos do provedor.


487 483 

488Quando você executa Fable 5, Opus 4.8 ou Opus 4.7 pela primeira vez, Claude Code aplica o esforço padrão desse modelo mesmo que você tenha definido anteriormente um nível diferente para outro modelo: `high` em Fable 5 e Opus 4.8, e `xhigh` em Opus 4.7. Execute `/effort` novamente para escolher um nível diferente após alternar. Esse padrão é mantido entre sessões até que você faça uma escolha de esforço explícita, como executar `/effort` em uma sessão interativa ou iniciar com `--effort`.484Quando você executa Fable 5, Opus 4.8 ou Opus 4.7 pela primeira vez, Claude Code aplica o esforço padrão desse modelo mesmo que você tenha definido anteriormente um nível diferente para outro modelo: `high` em Fable 5 e Opus 4.8, e `xhigh` em Opus 4.7. Execute `/effort` novamente para escolher um nível diferente após alternar. Esse padrão é mantido entre sessões até que você faça uma escolha de esforço explícita, como executar `/effort` em uma sessão interativa ou iniciar com `--effort`.

489 485 

490`low`, `medium`, `high` e `xhigh` persistem entre sessões quando você os define em uma sessão interativa. {/* min-version: 2.1.205 */}Um nível definido com `/effort` em [modo não interativo](/pt/headless), com o sinalizador `-p`, se aplica apenas à sessão atual e não é salvo como seu padrão. Um `/effort` não interativo também não pode liberar a retenção de padrão do modelo acima: em Fable 5, Opus 4.8 e Opus 4.7 ele relata `Not applied` e a sessão permanece no esforço padrão do modelo, portanto passe `--effort` na inicialização em vez disso. `max` fornece o raciocínio mais profundo sem restrição no gasto de tokens e se aplica apenas à sessão atual, exceto quando definido através da variável de ambiente `CLAUDE_CODE_EFFORT_LEVEL`.486`low`, `medium`, `high` e `xhigh` persistem entre sessões quando você os define em uma sessão interativa. Um nível definido com `/effort` em [modo não interativo](/docs/pt/headless), com o sinalizador `-p`, se aplica apenas à sessão atual e não é salvo como seu padrão. Um `/effort` não interativo também não pode liberar a retenção de padrão do modelo acima: em Fable 5, Opus 4.8 e Opus 4.7 ele relata `Not applied` e a sessão permanece no esforço padrão do modelo, portanto passe `--effort` na inicialização em vez disso. `max` fornece o raciocínio mais profundo sem restrição no gasto de tokens e se aplica apenas à sessão atual, exceto quando definido através da variável de ambiente `CLAUDE_CODE_EFFORT_LEVEL`.

491 487 

492O menu `/effort` também oferece `ultracode`. Ultracode é uma configuração de Claude Code em vez de um nível de esforço do modelo: envia `xhigh` para o modelo e adicionalmente tem Claude orquestrar [fluxos de trabalho dinâmicos](/pt/workflows) para tarefas substanciais. Se aplica apenas à sessão atual.488O menu `/effort` também oferece `ultracode`. Ultracode é uma configuração de Claude Code em vez de um nível de esforço do modelo: envia `xhigh` para o modelo e adicionalmente tem Claude orquestrar [fluxos de trabalho dinâmicos](/docs/pt/workflows) para tarefas substanciais. Se aplica apenas à sessão atual.

493 489 

494Você pode ativar ultracode através de qualquer um dos seguintes:490Você pode ativar ultracode através de qualquer um dos seguintes:

495 491 

496* **`/effort`**: execute `/effort ultracode` ou selecione-o no menu492* **`/effort`**: execute `/effort ultracode` ou selecione-o no menu

497* **Sinalizador `--effort`**: inicie com `claude --effort ultracode`, que inicia a sessão em esforço `xhigh` com ultracode ativado493* **Sinalizador `--effort`**: inicie com `claude --effort ultracode`, que inicia a sessão em esforço `xhigh` com ultracode ativado

498* **`--settings` ou uma solicitação de controle do Agent SDK**: passe `"ultracode": true`. Uma solicitação [`applyFlagSettings()`](/pt/agent-sdk/typescript#applyflagsettings) também aceita `effortLevel: "ultracode"`494* **`--settings` ou uma solicitação de controle do Agent SDK**: passe `"ultracode": true`. Uma solicitação [`applyFlagSettings()`](/docs/pt/agent-sdk/typescript#applyflagsettings) também aceita `effortLevel: "ultracode"`

499 495 

500Passar `ultracode` para o sinalizador `--effort` ou o valor `effortLevel` do Agent SDK requer Claude Code v2.1.203 ou posterior. Antes de v2.1.203, `--effort ultracode` imprimia `Unknown --effort value 'ultracode'` e a sessão começava no esforço padrão.496Passar `ultracode` para o sinalizador `--effort` ou o valor `effortLevel` do Agent SDK requer Claude Code v2.1.203 ou posterior. Antes de v2.1.203, `--effort ultracode` imprimia `Unknown --effort value 'ultracode'` e a sessão começava no esforço padrão.

501 497 

502A configuração `effortLevel` persistida e a variável de ambiente `CLAUDE_CODE_EFFORT_LEVEL` não aceitam `ultracode`.498A configuração `effortLevel` persistida e a variável de ambiente `CLAUDE_CODE_EFFORT_LEVEL` não aceitam `ultracode`.

503 499 

504Quando ultracode não está disponível, por exemplo quando [fluxos de trabalho estão desativados](/pt/workflows#turn-workflows-off), `--effort ultracode` define apenas esforço `xhigh`.500Quando ultracode não está disponível, por exemplo quando [fluxos de trabalho estão desativados](/docs/pt/workflows#turn-workflows-off), `--effort ultracode` define apenas esforço `xhigh`.

505 501 

506<h4 id="choose-an-effort-level">502<h4 id="choose-an-effort-level">

507 Escolher um nível de esforço503 Escolher um nível de esforço


516| `high` | Equilibra o uso de tokens e inteligência. Padrão em Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 e Sonnet 4.6 |512| `high` | Equilibra o uso de tokens e inteligência. Padrão em Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 e Sonnet 4.6 |

517| `xhigh` | Raciocínio mais profundo com gasto de tokens mais alto. Padrão em Opus 4.7 |513| `xhigh` | Raciocínio mais profundo com gasto de tokens mais alto. Padrão em Opus 4.7 |

518| `max` | Pode melhorar o desempenho em tarefas exigentes, mas pode mostrar retornos decrescentes e é propenso a pensar demais. Teste antes de adotar amplamente |514| `max` | Pode melhorar o desempenho em tarefas exigentes, mas pode mostrar retornos decrescentes e é propenso a pensar demais. Teste antes de adotar amplamente |

519| `ultracode` | Uma configuração de Claude Code que planeja um [fluxo de trabalho dinâmico](/pt/workflows) para cada tarefa substancial com raciocínio `xhigh` por mensagem. Apenas de sessão |515| `ultracode` | Uma configuração de Claude Code que planeja um [fluxo de trabalho dinâmico](/docs/pt/workflows) para cada tarefa substancial com raciocínio `xhigh` por mensagem. Apenas de sessão |

520 516 

521A escala de esforço é calibrada por modelo, portanto o mesmo nome de nível não representa o mesmo valor subjacente entre modelos.517A escala de esforço é calibrada por modelo, portanto o mesmo nome de nível não representa o mesmo valor subjacente entre modelos.

522 518 


537* **Sinalizador `--effort`**: passe um nome de nível para defini-lo para uma única sessão ao iniciar Claude Code533* **Sinalizador `--effort`**: passe um nome de nível para defini-lo para uma única sessão ao iniciar Claude Code

538* **Variável de ambiente**: defina `CLAUDE_CODE_EFFORT_LEVEL` para um nome de nível ou `auto`534* **Variável de ambiente**: defina `CLAUDE_CODE_EFFORT_LEVEL` para um nome de nível ou `auto`

539* **Configurações**: defina `effortLevel` para `low`, `medium`, `high` ou `xhigh` em seu arquivo de configurações. `max` e `ultracode` são [apenas de sessão](#adjust-effort-level) e não são aceitos aqui535* **Configurações**: defina `effortLevel` para `low`, `medium`, `high` ou `xhigh` em seu arquivo de configurações. `max` e `ultracode` são [apenas de sessão](#adjust-effort-level) e não são aceitos aqui

540* **Frontmatter de skill e subagent**: defina `effort` em um arquivo markdown de [skill](/pt/skills#frontmatter-reference) ou [subagent](/pt/sub-agents#supported-frontmatter-fields) para substituir o nível de esforço quando esse skill ou subagent é executado536* **Frontmatter de skill e subagent**: defina `effort` em um arquivo markdown de [skill](/docs/pt/skills#frontmatter-reference) ou [subagent](/docs/pt/sub-agents#supported-frontmatter-fields) para substituir o nível de esforço quando esse skill ou subagent é executado

541 537 

542A variável de ambiente tem precedência sobre todos os outros métodos, depois seu nível configurado, depois o padrão do modelo. O esforço de frontmatter se aplica quando esse skill ou subagent está ativo, substituindo o nível de sessão, mas não a variável de ambiente.538A variável de ambiente tem precedência sobre todos os outros métodos, depois seu nível configurado, depois o padrão do modelo. O esforço de frontmatter se aplica quando esse skill ou subagent está ativo, substituindo o nível de sessão, mas não a variável de ambiente.

543 539 


551 547 

552Fable 5, Sonnet 5 e Opus 4.7 e posterior sempre usam raciocínio adaptativo. O modo de orçamento de pensamento fixo e `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` não se aplicam a eles.548Fable 5, Sonnet 5 e Opus 4.7 e posterior sempre usam raciocínio adaptativo. O modo de orçamento de pensamento fixo e `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` não se aplicam a eles.

553 549 

554Em Opus 4.6 e Sonnet 4.6, você pode definir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` para reverter para o orçamento de pensamento fixo anterior controlado por `MAX_THINKING_TOKENS`. Veja [variáveis de ambiente](/pt/env-vars).550Em Opus 4.6 e Sonnet 4.6, você pode definir `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` para reverter para o orçamento de pensamento fixo anterior controlado por `MAX_THINKING_TOKENS`. Veja [variáveis de ambiente](/docs/pt/env-vars).

555 551 

556<h3 id="extended-thinking">552<h3 id="extended-thinking">

557 Pensamento estendido553 Pensamento estendido


563| :--------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |559| :--------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

564| Alternar para a sessão atual | Pressione `Option+T` no macOS ou `Alt+T` no Windows e Linux |560| Alternar para a sessão atual | Pressione `Option+T` no macOS ou `Alt+T` no Windows e Linux |

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

566| Desabilitar independentemente do esforço | Defina [`MAX_THINKING_TOKENS=0`](/pt/env-vars), que desativa o pensamento na API Anthropic exceto em Fable 5. Em [provedores de terceiros](/pt/third-party-integrations) isso omite o parâmetro `thinking` em vez disso, e modelos de raciocínio adaptativo ainda podem pensar. Outros valores se aplicam apenas com um [orçamento de pensamento fixo](#adaptive-reasoning-and-fixed-thinking-budgets) |562| Desabilitar independentemente do esforço | Defina [`MAX_THINKING_TOKENS=0`](/docs/pt/env-vars), que desativa o pensamento na API Anthropic exceto em Fable 5. Em [provedores de terceiros](/docs/pt/third-party-integrations) isso omite o parâmetro `thinking` em vez disso, e modelos de raciocínio adaptativo ainda podem pensar. Outros valores se aplicam apenas com um [orçamento de pensamento fixo](#adaptive-reasoning-and-fixed-thinking-budgets) |

567 563 

568O pensamento não pode ser desativado em Fable 5. O alternador de sessão, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` não têm efeito lá, e Fable 5 decide por etapa quanto pensar com base no nível de esforço.564O pensamento não pode ser desativado em Fable 5. O alternador de sessão, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` não têm efeito lá, e Fable 5 decide por etapa quanto pensar com base no nível de esforço.

569 565 

570A saída de pensamento é recolhida por padrão. Pressione `Ctrl+O` para alternar o modo verboso e ver o raciocínio como texto em itálico cinzento. Sessões interativas na API Anthropic recebem blocos de pensamento redigidos por padrão, portanto defina `showThinkingSummaries: true` em [configurações](/pt/settings) se você quiser os resumos completos disponíveis quando expandir. Você é cobrado por todos os tokens de pensamento gerados, mesmo quando recolhidos ou redigidos.566A saída de pensamento é recolhida por padrão. Pressione `Ctrl+O` para alternar o modo verboso e ver o raciocínio como texto em itálico cinzento. Sessões interativas na API Anthropic recebem blocos de pensamento redigidos por padrão, portanto defina `showThinkingSummaries: true` em [configurações](/docs/pt/settings) se você quiser os resumos completos disponíveis quando expandir. Você é cobrado por todos os tokens de pensamento gerados, mesmo quando recolhidos ou redigidos.

571 567 

572<h3 id="extended-context">568<h3 id="extended-context">

573 Contexto estendido569 Contexto estendido


583| Pro | Requer [créditos de uso](https://support.claude.com/pt/articles/12429409-extra-usage-for-paid-claude-plans) | Requer [créditos de uso](https://support.claude.com/pt/articles/12429409-extra-usage-for-paid-claude-plans) |579| Pro | Requer [créditos de uso](https://support.claude.com/pt/articles/12429409-extra-usage-for-paid-claude-plans) | Requer [créditos de uso](https://support.claude.com/pt/articles/12429409-extra-usage-for-paid-claude-plans) |

584| API e pagamento conforme o uso | Acesso completo | Acesso completo |580| API e pagamento conforme o uso | Acesso completo | Acesso completo |

585 581 

586Para desabilitar completamente o contexto 1M, defina `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Isso remove variantes de modelo 1M do seletor de modelo. Veja [variáveis de ambiente](/pt/env-vars).582Para desabilitar completamente o contexto 1M, defina `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Isso remove variantes de modelo 1M do seletor de modelo. Veja [variáveis de ambiente](/docs/pt/env-vars).

587 583 

588A janela de contexto 1M usa preços de modelo padrão sem prêmio para tokens além de 200K. Para planos onde o contexto estendido está incluído em sua assinatura, o uso permanece coberto por sua assinatura. Para planos que acessam contexto estendido através de créditos de uso, os tokens são cobrados para créditos de uso.584A janela de contexto 1M usa preços de modelo padrão sem prêmio para tokens além de 200K. Para planos onde o contexto estendido está incluído em sua assinatura, o uso permanece coberto por sua assinatura. Para planos que acessam contexto estendido através de créditos de uso, os tokens são cobrados para créditos de uso.

589 585 


604 Janela de contexto do Sonnet 5600 Janela de contexto do Sonnet 5

605</h4>601</h4>

606 602 

607Na API Anthropic, Sonnet 5 sempre é executado com a janela de contexto 1M. Não há variante de 200K, nenhum sufixo `[1m]` para selecionar e nenhum crédito de uso necessário em qualquer plano. As sessões fazem compactação automática antes que a janela encha, em cerca de 967K tokens por padrão; defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/pt/env-vars) para escolher um limite diferente.603Na API Anthropic, Sonnet 5 sempre é executado com a janela de contexto 1M. Não há variante de 200K, nenhum sufixo `[1m]` para selecionar e nenhum crédito de uso necessário em qualquer plano. As sessões fazem compactação automática antes que a janela encha, em cerca de 967K tokens por padrão; defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/pt/env-vars) para escolher um limite diferente.

608 604 

609Duas configurações orçam a janela em 200K em vez disso e fazem compactação automática nesse limite:605Duas configurações orçam a janela em 200K em vez disso e fazem compactação automática nesse limite:

610 606 

611* **Gateway LLM**: quando `ANTHROPIC_BASE_URL` aponta para um [gateway](/pt/llm-gateway), Claude Code não pode verificar o suporte a 1M. Para usar a janela completa, selecione Sonnet 5 (1M context) no seletor de modelo, que mapeia para `sonnet[1m]`.607* **Gateway LLM**: quando `ANTHROPIC_BASE_URL` aponta para um [gateway](/docs/pt/llm-gateway), Claude Code não pode verificar o suporte a 1M. Para usar a janela completa, selecione Sonnet 5 (1M context) no seletor de modelo, que mapeia para `sonnet[1m]`.

612* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: trata sessões Sonnet 5 como tendo uma janela de 200K, para implantações que precisam limitar o contexto.608* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: trata sessões Sonnet 5 como tendo uma janela de 200K, para implantações que precisam limitar o contexto.

613 609 

614<h2 id="checking-your-current-model">610<h2 id="checking-your-current-model">


617 613 

618Você pode ver qual modelo está usando atualmente em dois lugares:614Você pode ver qual modelo está usando atualmente em dois lugares:

619 615 

620* Na [linha de status](/pt/statusline), se você tiver uma configurada616* Na [linha de status](/docs/pt/statusline), se você tiver uma configurada

621* Em `/status`, que também exibe as informações de sua conta617* Em `/status`, que também exibe as informações de sua conta

622 618 

623<h2 id="add-a-custom-model-option">619<h2 id="add-a-custom-model-option">

624 Adicionar uma opção de modelo personalizado620 Adicionar uma opção de modelo personalizado

625</h2>621</h2>

626 622 

627Use `ANTHROPIC_CUSTOM_MODEL_OPTION` para adicionar uma única entrada personalizada ao seletor `/model` sem substituir os aliases integrados. Isso é útil para testar IDs de modelo que Claude Code não lista por padrão. Para implantações de gateway LLM, Claude Code pode preencher o seletor a partir do endpoint `/v1/models` do gateway quando `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` está definido, portanto essa variável é necessária apenas quando a descoberta está desabilitada ou não retorna o modelo que você deseja. Consulte [descoberta de modelo de gateway](/pt/llm-gateway-protocol#model-discovery).623Use `ANTHROPIC_CUSTOM_MODEL_OPTION` para adicionar uma única entrada personalizada ao seletor `/model` sem substituir os aliases integrados. Isso é útil para testar IDs de modelo que Claude Code não lista por padrão. Para implantações de gateway LLM, Claude Code pode preencher o seletor a partir do endpoint `/v1/models` do gateway quando `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` está definido, portanto essa variável é necessária apenas quando a descoberta está desabilitada ou não retorna o modelo que você deseja. Consulte [descoberta de modelo de gateway](/docs/pt/llm-gateway-protocol#model-discovery).

628 624 

629Este exemplo define todas as três variáveis para tornar uma implantação Opus roteada por gateway selecionável:625Este exemplo define todas as três variáveis para tornar uma implantação Opus roteada por gateway selecionável:

630 626 


649| `ANTHROPIC_DEFAULT_FABLE_MODEL` | O modelo a usar para `fable`, e o ID de modelo que Claude Code reconhece como Fable 5 para [fallback automático de modelo](#automatic-model-fallback) em provedores de terceiros |645| `ANTHROPIC_DEFAULT_FABLE_MODEL` | O modelo a usar para `fable`, e o ID de modelo que Claude Code reconhece como Fable 5 para [fallback automático de modelo](#automatic-model-fallback) em provedores de terceiros |

650| `ANTHROPIC_DEFAULT_OPUS_MODEL` | O modelo a usar para `opus`, ou para `opusplan` quando Plan Mode está ativo. |646| `ANTHROPIC_DEFAULT_OPUS_MODEL` | O modelo a usar para `opus`, ou para `opusplan` quando Plan Mode está ativo. |

651| `ANTHROPIC_DEFAULT_SONNET_MODEL` | O modelo a usar para `sonnet`, ou para `opusplan` quando Plan Mode não está ativo. |647| `ANTHROPIC_DEFAULT_SONNET_MODEL` | O modelo a usar para `sonnet`, ou para `opusplan` quando Plan Mode não está ativo. |

652| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | O modelo a usar para `haiku`, ou [funcionalidade de fundo](/pt/costs#background-token-usage) |648| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | O modelo a usar para `haiku`, ou [funcionalidade de fundo](/docs/pt/costs#background-token-usage) |

653| `CLAUDE_CODE_SUBAGENT_MODEL` | O modelo a usar para todos os [subagents](/pt/sub-agents#choose-a-model), [agent teams](/pt/agent-teams), e os agentes que um [workflow](/pt/workflows) executa. Aceita um alias como `haiku` ou um nome de modelo completo, e substitui tanto o parâmetro `model` por invocação quanto o frontmatter `model` da definição do subagent. Defina como `inherit` para usar resolução de modelo normal em vez disso |649| `CLAUDE_CODE_SUBAGENT_MODEL` | O modelo a usar para todos os [subagents](/docs/pt/sub-agents#choose-a-model), [agent teams](/docs/pt/agent-teams), e os agentes que um [workflow](/docs/pt/workflows) executa. Aceita um alias como `haiku` ou um nome de modelo completo, e substitui tanto o parâmetro `model` por invocação quanto o frontmatter `model` da definição do subagent. Defina como `inherit` para usar resolução de modelo normal em vez disso |

654 650 

655Nota: `ANTHROPIC_SMALL_FAST_MODEL` está descontinuado em favor de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.651Nota: `ANTHROPIC_SMALL_FAST_MODEL` está descontinuado em favor de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

656 652 


658 Fixar modelos para implantações de terceiros654 Fixar modelos para implantações de terceiros

659</h3>655</h3>

660 656 

661Ao implantar Claude Code através de [Amazon Bedrock](/pt/amazon-bedrock), [Google Cloud's Agent Platform](/pt/google-vertex-ai), [Microsoft Foundry](/pt/microsoft-foundry), ou [Claude Platform on AWS](/pt/claude-platform-on-aws), fixe versões de modelo antes de lançar para usuários.657Ao implantar Claude Code através de [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry), ou [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), fixe versões de modelo antes de lançar para usuários.

662 658 

663Sem fixação, Claude Code usa aliases de modelo como `fable`, `opus`, `sonnet` e `haiku` que resolvem para um ID de modelo padrão integrado para cada provedor. Esse padrão pode ficar atrás da versão mais recente do Anthropic, e o modelo para o qual aponta pode ainda não estar habilitado na conta de um usuário. Quando o padrão não está disponível, os usuários de Amazon Bedrock e Google Cloud's Agent Platform veem um aviso e a sessão volta para uma versão anterior do modelo padrão, ou para o modelo Sonnet padrão quando o padrão é um modelo Opus e nenhuma versão Opus está disponível. Os usuários de Microsoft Foundry veem erros em vez disso, porque Microsoft Foundry não tem verificação de inicialização equivalente.659Sem fixação, Claude Code usa aliases de modelo como `fable`, `opus`, `sonnet` e `haiku` que resolvem para um ID de modelo padrão integrado para cada provedor. Esse padrão pode ficar atrás da versão mais recente do Anthropic, e o modelo para o qual aponta pode ainda não estar habilitado na conta de um usuário. Quando o padrão não está disponível, os usuários de Amazon Bedrock e Google Cloud's Agent Platform veem um aviso e a sessão volta para uma versão anterior do modelo padrão, ou para o modelo Sonnet padrão quando o padrão é um modelo Opus e nenhuma versão Opus está disponível. Os usuários de Microsoft Foundry veem erros em vez disso, porque Microsoft Foundry não tem verificação de inicialização equivalente.

664 660 


689* O sufixo é lido por variável, não por modelo. No Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, um ID de modelo sem `[1m]` em uma variável usa contexto 200K mesmo se outra variável define o mesmo modelo com o sufixo. Sonnet 5 sempre é executado com a janela 1M nesses provedores e nunca precisa do sufixo.685* O sufixo é lido por variável, não por modelo. No Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, um ID de modelo sem `[1m]` em uma variável usa contexto 200K mesmo se outra variável define o mesmo modelo com o sufixo. Sonnet 5 sempre é executado com a janela 1M nesses provedores e nunca precisa do sufixo.

690 686 

691<Note>687<Note>

692 Uma lista de permissões `availableModels` entregue através de [MDM ou um arquivo de configurações gerenciado](/pt/settings#settings-files) ainda se aplica ao usar provedores de terceiros; [configurações gerenciadas pelo servidor não são entregues lá](/pt/server-managed-settings#platform-availability). A filtragem corresponde a um alias de modelo como `opus`, um prefixo de versão como `claude-opus-4-8`, ou o ID de modelo completo em forma de provedor. Prefixos específicos do provedor como `us.anthropic.` não são removidos, então para permitir um modelo específico, liste o mesmo ID em forma de provedor que o seletor mostra, ou mapeie através de [`modelOverrides`](#override-model-ids-per-version). Qualquer sufixo `[1m]` é removido tanto da entrada da lista de permissões quanto do modelo solicitado antes da correspondência.688 Uma lista de permissões `availableModels` entregue através de [MDM ou um arquivo de configurações gerenciado](/docs/pt/settings#settings-files) ainda se aplica ao usar provedores de terceiros; [configurações gerenciadas pelo servidor não são entregues lá](/docs/pt/server-managed-settings#platform-availability). A filtragem corresponde a um alias de modelo como `opus`, um prefixo de versão como `claude-opus-4-8`, ou o ID de modelo completo em forma de provedor. Prefixos específicos do provedor como `us.anthropic.` não são removidos, então para permitir um modelo específico, liste o mesmo ID em forma de provedor que o seletor mostra, ou mapeie através de [`modelOverrides`](#override-model-ids-per-version). Qualquer sufixo `[1m]` é removido tanto da entrada da lista de permissões quanto do modelo solicitado antes da correspondência.

693</Note>689</Note>

694 690 

695<h3 id="customize-pinned-model-display-and-capabilities">691<h3 id="customize-pinned-model-display-and-capabilities">


698 694 

699Quando você fixa um modelo em um provedor de terceiros, o ID específico do provedor aparece como está no seletor `/model` e Claude Code pode não reconhecer quais recursos o modelo suporta. Você pode substituir o nome de exibição e declarar capacidades com variáveis de ambiente complementares para cada modelo fixado.695Quando você fixa um modelo em um provedor de terceiros, o ID específico do provedor aparece como está no seletor `/model` e Claude Code pode não reconhecer quais recursos o modelo suporta. Você pode substituir o nome de exibição e declarar capacidades com variáveis de ambiente complementares para cada modelo fixado.

700 696 

701Essas variáveis têm efeito em provedores de terceiros, como Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. As variáveis `_NAME` e `_DESCRIPTION` também têm efeito quando `ANTHROPIC_BASE_URL` aponta para um [gateway LLM](/pt/llm-gateway). Elas não têm efeito ao conectar diretamente a `api.anthropic.com`.697Essas variáveis têm efeito em provedores de terceiros, como Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. As variáveis `_NAME` e `_DESCRIPTION` também têm efeito quando `ANTHROPIC_BASE_URL` aponta para um [gateway LLM](/docs/pt/llm-gateway). Elas não têm efeito ao conectar diretamente a `api.anthropic.com`.

702 698 

703| Variável de ambiente | Descrição |699| Variável de ambiente | Descrição |

704| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |700| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |


713| Valor de capacidade | Habilita |709| Valor de capacidade | Habilita |

714| ---------------------- | --------------------------------------------------------------------------------------------- |710| ---------------------- | --------------------------------------------------------------------------------------------- |

715| `effort` | [Níveis de esforço](#adjust-effort-level) e o comando `/effort` |711| `effort` | [Níveis de esforço](#adjust-effort-level) e o comando `/effort` |

716| `xhigh_effort` | {/* min-version: 2.1.111 */}O nível de esforço `xhigh` |712| `xhigh_effort` | O nível de esforço `xhigh` |

717| `max_effort` | O nível de esforço `max` |713| `max_effort` | O nível de esforço `max` |

718| `thinking` | [Pensamento estendido](#extended-thinking) |714| `thinking` | [Pensamento estendido](#extended-thinking) |

719| `adaptive_thinking` | Raciocínio adaptativo que aloca dinamicamente o pensamento com base na complexidade da tarefa |715| `adaptive_thinking` | Raciocínio adaptativo que aloca dinamicamente o pensamento com base na complexidade da tarefa |


740 736 

741Isso permite que administradores corporativos roteiem cada versão de modelo para um ARN de perfil de inferência Amazon Bedrock específico, nome de versão Google Cloud's Agent Platform ou nome de implantação Microsoft Foundry para governança, alocação de custos ou roteamento regional.737Isso permite que administradores corporativos roteiem cada versão de modelo para um ARN de perfil de inferência Amazon Bedrock específico, nome de versão Google Cloud's Agent Platform ou nome de implantação Microsoft Foundry para governança, alocação de custos ou roteamento regional.

742 738 

743Defina `modelOverrides` em seu [arquivo de configurações](/pt/settings#settings-files):739Defina `modelOverrides` em seu [arquivo de configurações](/docs/pt/settings#settings-files):

744 740 

745```json theme={null}741```json theme={null}

746{742{


756 752 

757As substituições substituem os IDs de modelo integrados que suportam cada entrada no seletor `/model`. No Amazon Bedrock, as entradas `modelOverrides` têm precedência sobre qualquer perfil de inferência que Claude Code descobre automaticamente na inicialização. Claude Code passa valores que já são específicos do provedor, como ARNs de perfil de inferência Amazon Bedrock ou nomes de implantação Microsoft Foundry, para o provedor como estão.753As substituições substituem os IDs de modelo integrados que suportam cada entrada no seletor `/model`. No Amazon Bedrock, as entradas `modelOverrides` têm precedência sobre qualquer perfil de inferência que Claude Code descobre automaticamente na inicialização. Claude Code passa valores que já são específicos do provedor, como ARNs de perfil de inferência Amazon Bedrock ou nomes de implantação Microsoft Foundry, para o provedor como estão.

758 754 

759{/* min-version: 2.1.200 */}As substituições também se aplicam quando você passa um ID de modelo Anthropic diretamente através de `--model`, a variável de ambiente `ANTHROPIC_MODEL`, ou uma variável de ambiente `ANTHROPIC_DEFAULT_*_MODEL`. No Amazon Bedrock, Google Cloud's Agent Platform e [Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint), um ID de modelo Anthropic sem entrada `modelOverrides` resolve para o mesmo ID específico do provedor que a linha do seletor `/model` para essa versão, quando o provedor suporta essa versão. Mantle suporta um subconjunto de versões. Para um ID de modelo Anthropic fora desse subconjunto, Claude Code envia o ID bruto para Mantle sem mapeá-lo, a menos que uma entrada `modelOverrides` o cubra. Antes da v2.1.200, `--model` e os valores de variável de ambiente chegavam ao provedor como estavam sem passar pelo mapa de substituição.755As substituições também se aplicam quando você passa um ID de modelo Anthropic diretamente através de `--model`, a variável de ambiente `ANTHROPIC_MODEL`, ou uma variável de ambiente `ANTHROPIC_DEFAULT_*_MODEL`. No Amazon Bedrock, Google Cloud's Agent Platform e [Mantle](/docs/pt/amazon-bedrock#use-the-mantle-endpoint), um ID de modelo Anthropic sem entrada `modelOverrides` resolve para o mesmo ID específico do provedor que a linha do seletor `/model` para essa versão, quando o provedor suporta essa versão. Mantle suporta um subconjunto de versões. Para um ID de modelo Anthropic fora desse subconjunto, Claude Code envia o ID bruto para Mantle sem mapeá-lo, a menos que uma entrada `modelOverrides` o cubra. Antes da v2.1.200, `--model` e os valores de variável de ambiente chegavam ao provedor como estavam sem passar pelo mapa de substituição.

760 756 

761`modelOverrides` funciona junto com `availableModels`. A lista de permissões é avaliada contra o ID de modelo Anthropic, não o valor de substituição, então uma entrada como `"opus"` em `availableModels` continua a corresponder mesmo quando versões do Opus são mapeadas para ARNs. Quando `enforceAvailableModels` é definido em configurações gerenciadas, o Padrão imposto é resolvido através de `modelOverrides` apenas da [fonte gerenciada de precedência mais alta](/pt/server-managed-settings#settings-precedence). O mapeamento de um administrador, como uma versão fixada para um ARN de perfil de inferência, é honrado no Padrão imposto. Substituições de configurações de usuário ou projeto não o afetam.757`modelOverrides` funciona junto com `availableModels`. A lista de permissões é avaliada contra o ID de modelo Anthropic, não o valor de substituição, então uma entrada como `"opus"` em `availableModels` continua a corresponder mesmo quando versões do Opus são mapeadas para ARNs. Quando `enforceAvailableModels` é definido em configurações gerenciadas, o Padrão imposto é resolvido através de `modelOverrides` apenas da [fonte gerenciada de precedência mais alta](/docs/pt/server-managed-settings#settings-precedence). O mapeamento de um administrador, como uma versão fixada para um ARN de perfil de inferência, é honrado no Padrão imposto. Substituições de configurações de usuário ou projeto não o afetam.

762 758 

763{/* min-version: 2.1.200 */}Quando `availableModels` é definido em [configurações gerenciadas](/pt/settings#settings-files), apenas `modelOverrides` dessa fonte gerenciada se aplicam a um ID de modelo Anthropic passado diretamente através de `--model` ou das variáveis de ambiente acima. Claude Code ignora substituições em configurações de usuário ou projeto para esses IDs, e nunca resolve um ID que a lista gerenciada exclui através de `modelOverrides` de qualquer fonte de configurações. Essa restrição de fonte gerenciada requer Claude Code v2.1.200 ou posterior. Veja [Restringir seleção de modelo](#restrict-model-selection) para como IDs bloqueados são tratados.759Quando `availableModels` é definido em [configurações gerenciadas](/docs/pt/settings#settings-files), apenas `modelOverrides` dessa fonte gerenciada se aplicam a um ID de modelo Anthropic passado diretamente através de `--model` ou das variáveis de ambiente acima. Claude Code ignora substituições em configurações de usuário ou projeto para esses IDs, e nunca resolve um ID que a lista gerenciada exclui através de `modelOverrides` de qualquer fonte de configurações. Essa restrição de fonte gerenciada requer Claude Code v2.1.200 ou posterior. Veja [Restringir seleção de modelo](#restrict-model-selection) para como IDs bloqueados são tratados.

764 760 

765<h3 id="prompt-caching-configuration">761<h3 id="prompt-caching-configuration">

766 Configuração de prompt caching762 Configuração de prompt caching

767</h3>763</h3>

768 764 

769Claude Code usa automaticamente [prompt caching](/pt/prompt-caching) para otimizar o desempenho e reduzir custos. Você pode desabilitar prompt caching globalmente ou para níveis de modelo específicos:765Claude Code usa automaticamente [prompt caching](/docs/pt/prompt-caching) para otimizar o desempenho e reduzir custos. Você pode desabilitar prompt caching globalmente ou para níveis de modelo específicos:

770 766 

771| Variável de ambiente | Descrição |767| Variável de ambiente | Descrição |

772| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |768| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |


776| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desabilitar prompt caching apenas para modelos Opus |772| `DISABLE_PROMPT_CACHING_OPUS` | Defina como `1` para desabilitar prompt caching apenas para modelos Opus |

777| `DISABLE_PROMPT_CACHING_FABLE` | Defina como `1` para desabilitar prompt caching apenas para modelos Fable |773| `DISABLE_PROMPT_CACHING_FABLE` | Defina como `1` para desabilitar prompt caching apenas para modelos Fable |

778 774 

779Para alterar o TTL do cache ou aprender o que dispara uma falha de cache, veja [Como Claude Code usa prompt caching](/pt/prompt-caching).775Para alterar o TTL do cache ou aprender o que dispara uma falha de cache, veja [Como Claude Code usa prompt caching](/docs/pt/prompt-caching).

Details

47 Configuração do administrador47 Configuração do administrador

48</h2>48</h2>

49 49 

50Os administradores podem configurar as definições de OpenTelemetry para todos os usuários através do [arquivo de configurações gerenciadas](/pt/settings#settings-files). Isso permite controle centralizado das configurações de telemetria em toda a organização. Consulte a [precedência de configurações](/pt/settings#settings-precedence) para obter mais informações sobre como as configurações são aplicadas.50Os administradores podem configurar as definições de OpenTelemetry para todos os usuários através do [arquivo de configurações gerenciadas](/docs/pt/settings#settings-files). Isso permite controle centralizado das configurações de telemetria em toda a organização. Consulte a [precedência de configurações](/docs/pt/settings#settings-precedence) para obter mais informações sobre como as configurações são aplicadas.

51 51 

52Exemplo de configuração de configurações gerenciadas:52Exemplo de configuração de configurações gerenciadas:

53 53 


93| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalo de exportação em milissegundos (padrão: 60000) | `5000`, `60000` |93| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalo de exportação em milissegundos (padrão: 60000) | `5000`, `60000` |

94| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalo de exportação de logs em milissegundos (padrão: 5000) | `1000`, `10000` |94| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalo de exportação de logs em milissegundos (padrão: 5000) | `1000`, `10000` |

95| `OTEL_LOG_USER_PROMPTS` | Ativar registro de conteúdo de prompt do usuário (padrão: desativado) | `1` para ativar |95| `OTEL_LOG_USER_PROMPTS` | Ativar registro de conteúdo de prompt do usuário (padrão: desativado) | `1` para ativar |

96| `OTEL_LOG_ASSISTANT_RESPONSES` | Ativar registro de texto de resposta do assistente em eventos `assistant_response` (padrão: desativado). Quando não definido, volta para o valor de `OTEL_LOG_USER_PROMPTS`. {/* min-version: 2.1.193 */}Requer Claude Code v2.1.193 ou posterior | `1` para ativar, `0` para manter reduzido |96| `OTEL_LOG_ASSISTANT_RESPONSES` | Ativar registro de texto de resposta do assistente em eventos `assistant_response` (padrão: desativado). Quando não definido, volta para o valor de `OTEL_LOG_USER_PROMPTS`. Requer Claude Code v2.1.193 ou posterior | `1` para ativar, `0` para manter reduzido |

97| `OTEL_LOG_TOOL_DETAILS` | Ativar registro de parâmetros de ferramenta e argumentos de entrada em eventos de ferramenta e atributos de span de rastreamento: comandos Bash, nomes de servidor MCP e ferramenta, nomes de skill e entrada de ferramenta. Também ativa nomes de comando customizado, plugin e MCP em eventos `user_prompt` (padrão: desativado) | `1` para ativar |97| `OTEL_LOG_TOOL_DETAILS` | Ativar registro de parâmetros de ferramenta e argumentos de entrada em eventos de ferramenta e atributos de span de rastreamento: comandos Bash, nomes de servidor MCP e ferramenta, nomes de skill e entrada de ferramenta. Também ativa nomes de comando customizado, plugin e MCP em eventos `user_prompt` (padrão: desativado) | `1` para ativar |

98| `OTEL_LOG_TOOL_CONTENT` | Ativar registro de conteúdo de entrada e saída de ferramenta em eventos de span (padrão: desativado). Requer [rastreamento](#traces-beta). O conteúdo é truncado em 60 KB | `1` para ativar |98| `OTEL_LOG_TOOL_CONTENT` | Ativar registro de conteúdo de entrada e saída de ferramenta em eventos de span (padrão: desativado). Requer [rastreamento](#traces-beta). O conteúdo é truncado em 60 KB | `1` para ativar |

99| `OTEL_LOG_RAW_API_BODIES` | Emitir o corpo JSON completo da solicitação e resposta da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body` (padrão: desativado). Os corpos incluem todo o histórico de conversa. Ativar isso implica consentimento para tudo que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` e `OTEL_LOG_TOOL_CONTENT` revelariam | `1` para corpos inline truncados em 60 KB, ou `file:<dir>` para corpos não truncados em disco com um ponteiro `body_ref` no evento |99| `OTEL_LOG_RAW_API_BODIES` | Emitir o corpo JSON completo da solicitação e resposta da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body` (padrão: desativado). Os corpos incluem todo o histórico de conversa. Ativar isso implica consentimento para tudo que `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` e `OTEL_LOG_TOOL_CONTENT` revelariam | `1` para corpos inline truncados em 60 KB, ou `file:<dir>` para corpos não truncados em disco com um ponteiro `body_ref` no evento |


108 108 

109| Protocolo | Variáveis de certificado do cliente | Confiar na CA do coletor com |109| Protocolo | Variáveis de certificado do cliente | Confiar na CA do coletor com |

110| :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------- |110| :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------- |

111| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` e opcionalmente `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Veja [Configuração de rede](/pt/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |111| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` e opcionalmente `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. Veja [Configuração de rede](/docs/pt/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |

112| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` e `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, ou as variantes por sinal como `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` para usar um certificado diferente por sinal | `OTEL_EXPORTER_OTLP_CERTIFICATE` |112| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` e `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, ou as variantes por sinal como `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` para usar um certificado diferente por sinal | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

113 113 

114Para `grpc`, o SDK OpenTelemetry lê as variáveis OTLP padrão diretamente, então as configurações existentes que definem as variáveis de métricas por sinal continuam funcionando.114Para `grpc`, o SDK OpenTelemetry lê as variáveis OTLP padrão diretamente, então as configurações existentes que definem as variáveis de métricas por sinal continuam funcionando.


198| `query_source` | Subsistema que emitiu a solicitação, como `repl_main_thread` ou um nome de subagente | |198| `query_source` | Subsistema que emitiu a solicitação, como `repl_main_thread` ou um nome de subagente | |

199| `agent_id` | Identificador do subagente ou colega que emitiu a solicitação. Ausente na sessão principal | |199| `agent_id` | Identificador do subagente ou colega que emitiu a solicitação. Ausente na sessão principal | |

200| `parent_agent_id` | Identificador do agente que gerou este. Ausente para a sessão principal e para agentes gerados diretamente a partir dela | |200| `parent_agent_id` | Identificador do agente que gerou este. Ausente para a sessão principal e para agentes gerados diretamente a partir dela | |

201| `workflow.run_id` | Identificador de execução da ferramenta [Workflow](/pt/workflows) que gerou este agente, prefixado `wf_`. Ausente para agentes não gerados por um workflow | |201| `workflow.run_id` | Identificador de execução da ferramenta [Workflow](/docs/pt/workflows) que gerou este agente, prefixado `wf_`. Ausente para agentes não gerados por um workflow | |

202| `workflow.name` | Nome do workflow que gerou este agente. Nomes criados pelo usuário são substituídos por `custom` a menos que o gate esteja definido | `OTEL_LOG_TOOL_DETAILS` |202| `workflow.name` | Nome do workflow que gerou este agente. Nomes criados pelo usuário são substituídos por `custom` a menos que o gate esteja definido | `OTEL_LOG_TOOL_DETAILS` |

203| `speed` | `fast` ou `normal` | |203| `speed` | `fast` ou `normal` | |

204| `llm_request.context` | `interaction`, `tool` ou `standalone` dependendo do span pai | |204| `llm_request.context` | `interaction`, `tool` ou `standalone` dependendo do span pai | |


314Se o auxiliar falhar ou imprimir saída que não atenda a esses requisitos, Claude Code relata o erro em:314Se o auxiliar falhar ou imprimir saída que não atenda a esses requisitos, Claude Code relata o erro em:

315 315 

316* Saída de `/status`316* Saída de `/status`

317* O log de depuração, ao executar com [`--debug`](/pt/cli-reference#cli-flags) ou após executar `/debug` na sessão317* O log de depuração, ao executar com [`--debug`](/docs/pt/cli-reference#cli-flags) ou após executar `/debug` na sessão

318* stderr, em sessões não-interativas iniciadas com `-p`318* stderr, em sessões não-interativas iniciadas com `-p`

319 319 

320<h4 id="refresh-behavior">320<h4 id="refresh-behavior">


441| `terminal.type` | Tipo de terminal, como `iTerm.app`, `vscode`, `cursor` ou `tmux` | Sempre incluído quando detectado |441| `terminal.type` | Tipo de terminal, como `iTerm.app`, `vscode`, `cursor` ou `tmux` | Sempre incluído quando detectado |

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

443 443 

444Quando Claude Code está conectado a um [gateway de aplicativos Claude](/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.444Quando 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.

445 445 

446Os eventos incluem adicionalmente os seguintes atributos. Estes nunca são anexados a métricas porque causariam cardinalidade ilimitada:446Os eventos incluem adicionalmente os seguintes atributos. Estes nunca são anexados a métricas porque causariam cardinalidade ilimitada:

447 447 

448* `prompt.id`: UUID correlacionando um prompt do usuário com todos os eventos subsequentes até o próximo prompt. Veja [Atributos de correlação de evento](#event-correlation-attributes).448* `prompt.id`: UUID correlacionando um prompt do usuário com todos os eventos subsequentes até o próximo prompt. Veja [Atributos de correlação de evento](#event-correlation-attributes).

449* `workspace.host_paths`: diretórios de workspace do host selecionados no aplicativo desktop, como um array de string449* `workspace.host_paths`: diretórios de workspace do host selecionados no aplicativo desktop, como um array de string

450* `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](/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. {/* min-version: 2.1.202 */}Requer Claude Code v2.1.202 ou posterior450* `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

451* `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. {/* min-version: 2.1.202 */}Requer Claude Code v2.1.202 ou posterior451* `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

452 452 

453<h3 id="metrics">453<h3 id="metrics">

454 Métricas454 Métricas


528* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")528* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

529* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`529* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`

530* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário530* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário

531* `effort`: [Nível de esforço](/pt/model-config#adjust-effort-level) aplicado à solicitação: `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Ausente quando o modelo não suporta esforço.531* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação: `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Ausente quando o modelo não suporta esforço.

532* `agent.name`: Tipo de subagente que emitiu a solicitação. Nomes de agente integrados e agentes de plugins do marketplace oficial aparecem verbatim. Outros nomes de agente definidos pelo usuário são substituídos por `"custom"`. Ausente quando a solicitação não foi emitida por um tipo de subagente nomeado.532* `agent.name`: Tipo de subagente que emitiu a solicitação. Nomes de agente integrados e agentes de plugins do marketplace oficial aparecem verbatim. Outros nomes de agente definidos pelo usuário são substituídos por `"custom"`. Ausente quando a solicitação não foi emitida por um tipo de subagente nomeado.

533* `skill.name`: Skill ativa para a solicitação, definida pela ferramenta Skill, um comando `/` ou herdada por um subagente gerado. Nomes de skill integrados, agrupados, definidos pelo usuário e de plugins do marketplace oficial aparecem verbatim. Nomes de skill de plugin de terceiros são substituídos por `"third-party"`. Ausente quando nenhuma skill está ativa.533* `skill.name`: Skill ativa para a solicitação, definida pela ferramenta Skill, um comando `/` ou herdada por um subagente gerado. Nomes de skill integrados, agrupados, definidos pelo usuário e de plugins do marketplace oficial aparecem verbatim. Nomes de skill de plugin de terceiros são substituídos por `"third-party"`. Ausente quando nenhuma skill está ativa.

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


549* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")549* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

550* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`550* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`

551* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário551* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário

552* `effort`: [Nível de esforço](/pt/model-config#adjust-effort-level) aplicado à solicitação. Veja [Contador de custo](#cost-counter) para detalhes.552* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação. Veja [Contador de custo](#cost-counter) para detalhes.

553* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.553* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

554 554 

555<h4 id="code-edit-tool-decision-counter">555<h4 id="code-edit-tool-decision-counter">


622 Evento de resposta do assistente622 Evento de resposta do assistente

623</h4>623</h4>

624 624 

625Registrado após cada solicitação de API que retorna conteúdo de texto do modelo. Apenas os blocos de texto da resposta são incluídos; blocos de pensamento e blocos de uso de ferramenta são excluídos. {/* min-version: 2.1.193 */}Requer Claude Code v2.1.193 ou posterior.625Registrado após cada solicitação de API que retorna conteúdo de texto do modelo. Apenas os blocos de texto da resposta são incluídos; blocos de pensamento e blocos de uso de ferramenta são excluídos. Requer Claude Code v2.1.193 ou posterior.

626 626 

627**Nome do Evento**: `claude_code.assistant_response`627**Nome do Evento**: `claude_code.assistant_response`

628 628 


695* `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.695* `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.

696* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo696* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo

697* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente697* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente

698* `effort`: [Nível de esforço](/pt/model-config#adjust-effort-level) aplicado à solicitação: `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Ausente quando o modelo não suporta esforço.698* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação: `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Ausente quando o modelo não suporta esforço.

699* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.699* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

700 700 

701<h4 id="api-error-event">701<h4 id="api-error-event">


720* `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.720* `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.

721* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo721* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo

722* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente722* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente

723* `effort`: [Nível de esforço](/pt/model-config#adjust-effort-level) aplicado à solicitação. Ausente quando o modelo não suporta esforço.723* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação. Ausente quando o modelo não suporta esforço.

724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

725 725 

726<h4 id="api-refusal-event">726<h4 id="api-refusal-event">


740* `model`: Identificador do modelo da solicitação740* `model`: Identificador do modelo da solicitação

741* `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.741* `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.

742* `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.742* `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.

743* `speed`: Ou `"fast"` quando [Fast mode](/pt/fast-mode) está ativo, ou `"normal"`743* `speed`: Ou `"fast"` quando [Fast mode](/docs/pt/fast-mode) está ativo, ou `"normal"`

744* `attempt`: Número de tentativa de repetição. A primeira tentativa é `1`.744* `attempt`: Número de tentativa de repetição. A primeira tentativa é `1`.

745* `effort`: [Nível de esforço](/pt/model-config#adjust-effort-level) aplicado à solicitação. Ausente quando o modelo não suporta esforço.745* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação. Ausente quando o modelo não suporta esforço.

746* `server_fallback_hop`: `true` quando o fallback de modelo do lado do servidor da API já tentou novamente esta recusa em um modelo diferente, então o usuário não viu esta recusa particular. `false` quando a solicitação terminou em uma recusa. Uma única rodada pode emitir tanto um evento hop `true` quanto um evento final `false` posterior quando o modelo de fallback também recusa.746* `server_fallback_hop`: `true` quando o fallback de modelo do lado do servidor da API já tentou novamente esta recusa em um modelo diferente, então o usuário não viu esta recusa particular. `false` quando a solicitação terminou em uma recusa. Uma única rodada pode emitir tanto um evento hop `true` quanto um evento final `false` posterior quando o modelo de fallback também recusa.

747* `has_category`: `true` quando a resposta da API carregava um `stop_details.category` de `"cyber"`, `"bio"`, `"frontier_llm"` ou `"reasoning_extraction"`. `false` quando a resposta não carregava categoria ou um valor fora desse conjunto. Ausente quando `server_fallback_hop` é `true`, porque blocos hop não carregam `stop_details`.747* `has_category`: `true` quando a resposta da API carregava um `stop_details.category` de `"cyber"`, `"bio"`, `"frontier_llm"` ou `"reasoning_extraction"`. `false` quando a resposta não carregava categoria ou um valor fora desse conjunto. Ausente quando `server_fallback_hop` é `true`, porque blocos hop não carregam `stop_details`.

748* `has_explanation`: `true` quando a resposta da API carregava um `stop_details.explanation`, caso contrário `false`. Ausente quando `server_fallback_hop` é `true`.748* `has_explanation`: `true` quando a resposta da API carregava um `stop_details.explanation`, caso contrário `false`. Ausente quando `server_fallback_hop` é `true`.


945* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar quantos plugins de terceiros distintos são carregados em toda a sua frota sem registrar seus nomes945* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar quantos plugins de terceiros distintos são carregados em toda a sua frota sem registrar seus nomes

946* `has_hooks`: se o plugin contribui hooks946* `has_hooks`: se o plugin contribui hooks

947* `has_mcp`: se o plugin contribui servidores MCP947* `has_mcp`: se o plugin contribui servidores MCP

948* `host_owned_mcp`: `true` quando o host SDK gerencia as conexões MCP deste plugin e Claude Code pulou a leitura da configuração do servidor MCP do plugin, `false` caso contrário. {/* min-version: 2.1.172 */}Requer Claude Code v2.1.172 ou posterior948* `host_owned_mcp`: `true` quando o host SDK gerencia as conexões MCP deste plugin e Claude Code pulou a leitura da configuração do servidor MCP do plugin, `false` caso contrário. Requer Claude Code v2.1.172 ou posterior

949* `skill_path_count`: número de diretórios de skill que o plugin declara949* `skill_path_count`: número de diretórios de skill que o plugin declara

950* `command_path_count`: número de diretórios de comando que o plugin declara950* `command_path_count`: número de diretórios de comando que o plugin declara

951* `agent_path_count`: número de diretórios de agente que o plugin declara951* `agent_path_count`: número de diretórios de agente que o plugin declara

952* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/pt/cli-reference), `"false"` caso contrário. Em modo seguro este evento relata apenas inventário configurado; os comandos, skills, hooks e servidores MCP do plugin não carregam. {/* min-version: 2.1.169 */}Requer Claude Code v2.1.169 ou posterior952* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Em modo seguro este evento relata apenas inventário configurado; os comandos, skills, hooks e servidores MCP do plugin não carregam. Requer Claude Code v2.1.169 ou posterior

953 953 

954<h4 id="skill-activated-event">954<h4 id="skill-activated-event">

955 Evento de skill ativado955 Evento de skill ativado


1027* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`1027* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`

1028* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` ou `"agent"`1028* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` ou `"agent"`

1029* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` ou `"pluginHook"`1029* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` ou `"pluginHook"`

1030* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/pt/cli-reference), `"false"` caso contrário. {/* min-version: 2.1.169 */}Requer Claude Code v2.1.169 ou posterior1030* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior

1031* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): a string matcher da configuração do hook, quando uma está definida1031* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): a string matcher da configuração do hook, quando uma está definida

1032* `plugin.name` (quando `hook_source` é `"pluginHook"`): nome do plugin contribuidor. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1032* `plugin.name` (quando `hook_source` é `"pluginHook"`): nome do plugin contribuidor. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1033* `plugin_id_hash` (quando `hook_source` é `"pluginHook"`): hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar plugins contribuidores distintos sem registrar seus nomes1033* `plugin_id_hash` (quando `hook_source` é `"pluginHook"`): hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar plugins contribuidores distintos sem registrar seus nomes


1051* `num_hooks`: Número de comandos de hook correspondentes1051* `num_hooks`: Número de comandos de hook correspondentes

1052* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos1052* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos

1053* `hook_source`: `"policySettings"` ou `"merged"`1053* `hook_source`: `"policySettings"` ou `"merged"`

1054* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/pt/cli-reference), `"false"` caso contrário. {/* min-version: 2.1.169 */}Requer Claude Code v2.1.169 ou posterior1054* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior

1055* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos ativados1055* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos ativados

1056 1056 

1057<h4 id="hook-execution-complete-event">1057<h4 id="hook-execution-complete-event">


1078* `total_duration_ms`: Duração de parede de todos os hooks correspondentes1078* `total_duration_ms`: Duração de parede de todos os hooks correspondentes

1079* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos1079* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos

1080* `hook_source`: `"policySettings"` ou `"merged"`1080* `hook_source`: `"policySettings"` ou `"merged"`

1081* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/pt/cli-reference), `"false"` caso contrário. {/* min-version: 2.1.169 */}Requer Claude Code v2.1.169 ou posterior1081* `safe_mode`: `"true"` quando a sessão foi iniciada com [`--safe-mode`](/docs/pt/cli-reference), `"false"` caso contrário. Requer Claude Code v2.1.169 ou posterior

1082* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos ativados1082* `hook_definitions`: Configuração de hook serializada em JSON. Incluído apenas quando rastreamento beta detalhado e `OTEL_LOG_TOOL_DETAILS=1` estão ambos ativados

1083 1083 

1084<h4 id="hook-plugin-metrics-event">1084<h4 id="hook-plugin-metrics-event">


1119* `pre_tokens`: Contagem aproximada de tokens antes da compactação1119* `pre_tokens`: Contagem aproximada de tokens antes da compactação

1120* `post_tokens`: Contagem aproximada de tokens após compactação1120* `post_tokens`: Contagem aproximada de tokens após compactação

1121* `error`: Mensagem de erro quando a compactação falhou1121* `error`: Mensagem de erro quando a compactação falhou

1122* `precompute_reuse`: Definido apenas quando `trigger` é `"manual"`. A compactação automática pode preparar um resumo em segundo plano antes da janela de contexto se encher, e este atributo registra se `/compact` reutilizou esse resumo preparado. `"hit"` significa que foi reutilizado; `"miss_custom_instructions"`, `"miss_hook"` e `"miss_not_ready"` dão a razão pela qual um resumo fresco foi computado em vez disso. {/* min-version: 2.1.153 */}Requer Claude Code v2.1.153 ou posterior1122* `precompute_reuse`: Definido apenas quando `trigger` é `"manual"`. A compactação automática pode preparar um resumo em segundo plano antes da janela de contexto se encher, e este atributo registra se `/compact` reutilizou esse resumo preparado. `"hit"` significa que foi reutilizado; `"miss_custom_instructions"`, `"miss_hook"` e `"miss_not_ready"` dão a razão pela qual um resumo fresco foi computado em vez disso. Requer Claude Code v2.1.153 ou posterior

1123 1123 

1124<h4 id="feedback-survey-event">1124<h4 id="feedback-survey-event">

1125 Evento de pesquisa de feedback1125 Evento de pesquisa de feedback

1126</h4>1126</h4>

1127 1127 

1128Registrado quando uma pesquisa de qualidade de sessão é mostrada ou respondida. Veja [Pesquisas de qualidade de sessão](/pt/data-usage#session-quality-surveys) para o que as pesquisas coletam e como controlá-las.1128Registrado quando uma pesquisa de qualidade de sessão é mostrada ou respondida. Veja [Pesquisas de qualidade de sessão](/docs/pt/data-usage#session-quality-surveys) para o que as pesquisas coletam e como controlá-las.

1129 1129 

1130**Nome do Evento**: `claude_code.feedback_survey`1130**Nome do Evento**: `claude_code.feedback_survey`

1131 1131 


1139* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa1139* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa

1140* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"1140* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"

1141* `response`: A seleção do usuário em eventos `responded`1141* `response`: A seleção do usuário em eventos `responded`

1142* `enabled_via_override`: `true` quando [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/pt/env-vars) está definido. Emitido como um booleano, não uma string. Presente em eventos de pesquisa `session`. Filtre neste atributo para confirmar que a substituição é aplicada em toda a frota1142* `enabled_via_override`: `true` quando [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/pt/env-vars) está definido. Emitido como um booleano, não uma string. Presente em eventos de pesquisa `session`. Filtre neste atributo para confirmar que a substituição é aplicada em toda a frota

1143 1143 

1144<h2 id="interpret-metrics-and-events-data">1144<h2 id="interpret-metrics-and-events-data">

1145 Interpretar dados de métricas e eventos1145 Interpretar dados de métricas e eventos


1192 1192 

1193Claude Code retenta solicitações de API falhadas internamente e emite um único evento `claude_code.api_error` apenas depois de desistir, então o evento em si é o sinal terminal para essa solicitação. Tentativas de repetição intermediárias não são registradas como eventos separados.1193Claude Code retenta solicitações de API falhadas internamente e emite um único evento `claude_code.api_error` apenas depois de desistir, então o evento em si é o sinal terminal para essa solicitação. Tentativas de repetição intermediárias não são registradas como eventos separados.

1194 1194 

1195O atributo `attempt` no evento registra o número total de tentativas. `CLAUDE_CODE_MAX_RETRIES` tem como padrão 10 e é limitado a 15; {/* min-version: 2.1.199 */}a partir da v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Quando a solicitação esgota todas as tentativas em um erro transitório, `attempt` é igual a um a mais do que esse limite efetivo: 11 por padrão, e nunca mais de 16 a menos que o watchdog esteja definido. Um valor menor indica um erro não retentável, como uma resposta `400`.1195O atributo `attempt` no evento registra o número total de tentativas. `CLAUDE_CODE_MAX_RETRIES` tem como padrão 10 e é limitado a 15; a partir da v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta o padrão e remove o limite. Quando a solicitação esgota todas as tentativas em um erro transitório, `attempt` é igual a um a mais do que esse limite efetivo: 11 por padrão, e nunca mais de 16 a menos que o watchdog esteja definido. Um valor menor indica um erro não retentável, como uma resposta `400`.

1196 1196 

1197Para distinguir uma sessão que se recuperou de uma que travou, agrupe eventos por `session.id` e verifique se um evento `api_request` posterior existe após o erro.1197Para distinguir uma sessão que se recuperou de uma que travou, agrupe eventos por `session.id` e verifique se um evento `api_request` posterior existe após o erro.

1198 1198 


1221 Atribuir ações a usuários1221 Atribuir ações a usuários

1222</h3>1222</h3>

1223 1223 

1224Os [atributos padrão](#standard-attributes) em cada evento incluem a identidade do usuário autenticado: `user.email`, `user.account_uuid`, `user.account_id` e `organization.id` quando conectado com uma conta Claude, mais `user.id` e o `session.id` por sessão. `user.id` é um identificador com escopo de instalação, exceto em sessões do [gateway de aplicativos Claude](/pt/claude-apps-gateway), onde é o assunto do IdP do token emitido pelo gateway.1224Os [atributos padrão](#standard-attributes) em cada evento incluem a identidade do usuário autenticado: `user.email`, `user.account_uuid`, `user.account_id` e `organization.id` quando conectado com uma conta Claude, mais `user.id` e o `session.id` por sessão. `user.id` é um identificador com escopo de instalação, exceto em sessões do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway), onde é o assunto do IdP do token emitido pelo gateway.

1225 1225 

1226Chamadas de ferramenta MCP, comandos Bash e edições de arquivo são, portanto, atribuídas ao desenvolvedor que iniciou a sessão. Claude Code não atua sob uma conta de serviço separada; a identidade registrada em cada evento é a própria conta Claude do desenvolvedor, ou a identidade do IdP do desenvolvedor em uma sessão do [gateway de aplicativos Claude](/pt/claude-apps-gateway).1226Chamadas de ferramenta MCP, comandos Bash e edições de arquivo são, portanto, atribuídas ao desenvolvedor que iniciou a sessão. Claude Code não atua sob uma conta de serviço separada; a identidade registrada em cada evento é a própria conta Claude do desenvolvedor, ou a identidade do IdP do desenvolvedor em uma sessão do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway).

1227 1227 

1228Quando Claude Code autentica com uma chave de API direta, ou contra Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, não há conta Claude na sessão e apenas `user.id` e `session.id` são preenchidos. Nessas implantações, anexe identidade do usuário você mesmo com `OTEL_RESOURCE_ATTRIBUTES`, definido por usuário através do arquivo de [configurações gerenciadas](#administrator-configuration) ou um wrapper de inicialização. Sessões do gateway de aplicativos Claude não precisam de nada disso: a CLI marca a identidade do IdP automaticamente, conforme descrito em [Atributos padrão](#standard-attributes).1228Quando Claude Code autentica com uma chave de API direta, ou contra Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, não há conta Claude na sessão e apenas `user.id` e `session.id` são preenchidos. Nessas implantações, anexe identidade do usuário você mesmo com `OTEL_RESOURCE_ATTRIBUTES`, definido por usuário através do arquivo de [configurações gerenciadas](#administrator-configuration) ou um wrapper de inicialização. Sessões do gateway de aplicativos Claude não precisam de nada disso: a CLI marca a identidade do IdP automaticamente, conforme descrito em [Atributos padrão](#standard-attributes).

1229 1229 


1343 Segurança e privacidade1343 Segurança e privacidade

1344</h2>1344</h2>

1345 1345 

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

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

1348* Quando autenticado via OAuth, `user.email` é incluído em atributos de telemetria. Se isso for uma preocupação para sua organização, trabalhe com seu backend de telemetria para filtrar ou reduzir este campo1348* Quando autenticado via OAuth, `user.email` é incluído em atributos de telemetria. Se isso for uma preocupação para sua organização, trabalhe com seu backend de telemetria para filtrar ou reduzir este campo

1349* O conteúdo do prompt do usuário não é coletado por padrão. Apenas o comprimento do prompt é registrado. Para incluir conteúdo do prompt, defina `OTEL_LOG_USER_PROMPTS=1`1349* O conteúdo do prompt do usuário não é coletado por padrão. Apenas o comprimento do prompt é registrado. Para incluir conteúdo do prompt, defina `OTEL_LOG_USER_PROMPTS=1`

network-config.md +15 −15

Details

9Claude Code suporta várias configurações de rede e segurança empresariais através de variáveis de ambiente. Isso inclui rotear o tráfego através de servidores proxy corporativos, confiar em Autoridades de Certificação (CA) personalizadas e autenticar com certificados de Transport Layer Security (mTLS) mútuo para segurança aprimorada.9Claude Code suporta várias configurações de rede e segurança empresariais através de variáveis de ambiente. Isso inclui rotear o tráfego através de servidores proxy corporativos, confiar em Autoridades de Certificação (CA) personalizadas e autenticar com certificados de Transport Layer Security (mTLS) mútuo para segurança aprimorada.

10 10 

11<Note>11<Note>

12 Todas as variáveis de ambiente mostradas nesta página também podem ser configuradas em [`settings.json`](/pt/settings).12 Todas as variáveis de ambiente mostradas nesta página também podem ser configuradas em [`settings.json`](/docs/pt/settings).

13</Note>13</Note>

14 14 

15<h2 id="proxy-configuration">15<h2 id="proxy-configuration">


123| `api.anthropic.com` | Solicitações da API Claude |123| `api.anthropic.com` | Solicitações da API Claude |

124| `claude.ai` | Autenticação de conta claude.ai |124| `claude.ai` | Autenticação de conta claude.ai |

125| `platform.claude.com` | Autenticação de conta do Anthropic Console |125| `platform.claude.com` | Autenticação de conta do Anthropic Console |

126| `mcp-proxy.anthropic.com` | [Conectores MCP do claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai), incluindo conectores que um administrador da organização configura. O tráfego do conector é roteado através deste proxy; os conectores são ativados por padrão para usuários autenticados no claude.ai. Para desabilitar, defina [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/pt/env-vars) ou a configuração [`disableClaudeAiConnectors`](/pt/settings#available-settings) |126| `mcp-proxy.anthropic.com` | [Conectores MCP do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai), incluindo conectores que um administrador da organização configura. O tráfego do conector é roteado através deste proxy; os conectores são ativados por padrão para usuários autenticados no claude.ai. Para desabilitar, defina [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/docs/pt/env-vars) ou a configuração [`disableClaudeAiConnectors`](/docs/pt/settings#available-settings) |

127| `downloads.claude.ai` | Downloads de executáveis de plugins; instalador nativo e atualizador automático nativo |127| `downloads.claude.ai` | Downloads de executáveis de plugins; instalador nativo e atualizador automático nativo |

128| `storage.googleapis.com` | Contagens de instalação e metadados de plugins mostrados em `/plugin`. Uploads de [artefatos](/pt/artifacts) assinados tentam este host primeiro; a publicação volta para `api.anthropic.com` quando ele está bloqueado |128| `storage.googleapis.com` | Contagens de instalação e metadados de plugins mostrados em `/plugin`. Uploads de [artefatos](/docs/pt/artifacts) assinados tentam este host primeiro; a publicação volta para `api.anthropic.com` quando ele está bloqueado |

129| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Instalador nativo e atualizador automático nativo em versões anteriores a 2.1.116 |129| `storage.googleapis.com` | Instalador nativo e atualizador automático nativo em versões anteriores a 2.1.116 |

130| `bridge.claudeusercontent.com` | Ponte WebSocket da extensão [Claude no Chrome](/pt/chrome) |130| `bridge.claudeusercontent.com` | Ponte WebSocket da extensão [Claude no Chrome](/docs/pt/chrome) |

131| `*.claudeusercontent.com` | Visualização de [artefatos](/pt/artifacts) no claude.ai. O visualizador carrega o conteúdo de cada artefato de um subdomínio isolado dessa origem. Necessário no navegador do visualizador, não pelo próprio CLI |131| `*.claudeusercontent.com` | Visualização de [artefatos](/docs/pt/artifacts) no claude.ai. O visualizador carrega o conteúdo de cada artefato de um subdomínio isolado dessa origem. Necessário no navegador do visualizador, não pelo próprio CLI |

132| `raw.githubusercontent.com` | Feed de changelog para [`/release-notes`](/pt/commands) e as notas de lançamento mostradas após atualizar |132| `raw.githubusercontent.com` | Feed de changelog para [`/release-notes`](/docs/pt/commands) e as notas de lançamento mostradas após atualizar |

133 133 

134Se você instalar Claude Code através do npm ou gerenciar sua própria distribuição binária, os usuários finais não precisam do instalador nativo e os usos do atualizador automático de `downloads.claude.ai`. Os outros usos na tabela se aplicam independentemente do método de instalação.134Se você instalar Claude Code através do npm ou gerenciar sua própria distribuição binária, os usuários finais não precisam do instalador nativo e os usos do atualizador automático de `downloads.claude.ai`. Os outros usos na tabela se aplicam independentemente do método de instalação.

135 135 

136Claude Code também envia telemetria operacional opcional por padrão, que você pode desabilitar com variáveis de ambiente. Consulte [Serviços de telemetria](/pt/data-usage#telemetry-services) para saber como desabilitá-la antes de finalizar sua lista de permissões.136Claude Code também envia telemetria operacional opcional por padrão, que você pode desabilitar com variáveis de ambiente. Consulte [Serviços de telemetria](/docs/pt/data-usage#telemetry-services) para saber como desabilitá-la antes de finalizar sua lista de permissões.

137 137 

138Ao usar [Amazon Bedrock](/pt/amazon-bedrock), [Google Cloud's Agent Platform](/pt/google-vertex-ai), [Microsoft Foundry](/pt/microsoft-foundry) ou uma sessão de [gateway de aplicativos Claude](/pt/claude-apps-gateway) conectada, o tráfego de modelo e autenticação vão para seu provedor ou gateway em vez de `api.anthropic.com`, `claude.ai` ou `platform.claude.com`. A ferramenta WebFetch ainda chama `api.anthropic.com` para sua [verificação de segurança de domínio](/pt/data-usage#webfetch-domain-safety-check) a menos que você defina `skipWebFetchPreflight: true` em [configurações](/pt/settings).138Ao usar [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) ou uma sessão de [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectada, o tráfego de modelo e autenticação vão para seu provedor ou gateway em vez de `api.anthropic.com`, `claude.ai` ou `platform.claude.com`. A ferramenta WebFetch ainda chama `api.anthropic.com` para sua [verificação de segurança de domínio](/docs/pt/data-usage#webfetch-domain-safety-check) a menos que você defina `skipWebFetchPreflight: true` em [configurações](/docs/pt/settings).

139 139 

140[Claude Code na web](/pt/claude-code-on-the-web) e [Code Review](/pt/code-review) se conectam aos seus repositórios a partir da infraestrutura gerenciada pela Anthropic. Se sua organização GitHub Enterprise Cloud restringe o acesso por endereço IP, ative [herança de lista de permissão de IP para GitHub Apps instalados](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). O Claude GitHub App registra seus intervalos de IP, portanto, ativar essa configuração permite acesso sem configuração manual. Para [adicionar os intervalos à sua lista de permissões manualmente](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) em vez disso, ou para configurar outros firewalls, consulte [Endereços IP da API Anthropic](https://platform.claude.com/docs/en/api/ip-addresses).140[Claude Code na web](/docs/pt/claude-code-on-the-web) e [Code Review](/docs/pt/code-review) se conectam aos seus repositórios a partir da infraestrutura gerenciada pela Anthropic. Se sua organização GitHub Enterprise Cloud restringe o acesso por endereço IP, ative [herança de lista de permissão de IP para GitHub Apps instalados](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). O Claude GitHub App registra seus intervalos de IP, portanto, ativar essa configuração permite acesso sem configuração manual. Para [adicionar os intervalos à sua lista de permissões manualmente](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) em vez disso, ou para configurar outros firewalls, consulte [Endereços IP da API Anthropic](https://platform.claude.com/docs/en/api/ip-addresses).

141 141 

142Para instâncias [GitHub Enterprise Server](/pt/github-enterprise-server) auto-hospedadas atrás de um firewall, coloque na lista de permissões os mesmos [Endereços IP da API Anthropic](https://platform.claude.com/docs/en/api/ip-addresses) para que a infraestrutura Anthropic possa alcançar seu host GHES para clonar repositórios e postar comentários de revisão.142Para instâncias [GitHub Enterprise Server](/docs/pt/github-enterprise-server) auto-hospedadas atrás de um firewall, coloque na lista de permissões os mesmos [Endereços IP da API Anthropic](https://platform.claude.com/docs/en/api/ip-addresses) para que a infraestrutura Anthropic possa alcançar seu host GHES para clonar repositórios e postar comentários de revisão.

143 143 

144<h3 id="desktop-and-claude-ai">144<h3 id="desktop-and-claude-ai">

145 Desktop e claude.ai145 Desktop e claude.ai

146</h3>146</h3>

147 147 

148A tabela anterior cobre principalmente o CLI autônomo. O aplicativo Claude Desktop e claude.ai em um navegador carregam seu código de aplicação de hosts CDN adicionais da Anthropic, incluindo `assets-proxy.anthropic.com`. Permitir `claude.ai` enquanto bloqueia esses hosts produz uma página em branco em vez de um erro. Consulte [requisitos de acesso à rede](/pt/desktop#network-access-requirements) na página Desktop.148A tabela anterior cobre principalmente o CLI autônomo. O aplicativo Claude Desktop e claude.ai em um navegador carregam seu código de aplicação de hosts CDN adicionais da Anthropic, incluindo `assets-proxy.anthropic.com`. Permitir `claude.ai` enquanto bloqueia esses hosts produz uma página em branco em vez de um erro. Consulte [requisitos de acesso à rede](/docs/pt/desktop#network-access-requirements) na página Desktop.

149 149 

150<h2 id="additional-resources">150<h2 id="additional-resources">

151 Recursos adicionais151 Recursos adicionais

152</h2>152</h2>

153 153 

154* [Configurações de Claude Code](/pt/settings)154* [Configurações de Claude Code](/docs/pt/settings)

155* [Referência de variáveis de ambiente](/pt/env-vars)155* [Referência de variáveis de ambiente](/docs/pt/env-vars)

156* [Guia de solução de problemas](/pt/troubleshooting)156* [Guia de solução de problemas](/docs/pt/troubleshooting)

output-styles.md +15 −15

Details

10 10 

11Um estilo de saída personalizado adiciona suas instruções ao prompt do sistema e permite que você escolha se deseja manter as instruções integradas de engenharia de software do Claude Code. Mantenha-as quando você está mudando como Claude se comunica, mas ainda está codificando, como sempre responder com um diagrama. Deixe-as de fora quando Claude não está fazendo engenharia de software, como um assistente de redação ou analista de dados.11Um estilo de saída personalizado adiciona suas instruções ao prompt do sistema e permite que você escolha se deseja manter as instruções integradas de engenharia de software do Claude Code. Mantenha-as quando você está mudando como Claude se comunica, mas ainda está codificando, como sempre responder com um diagrama. Deixe-as de fora quando Claude não está fazendo engenharia de software, como um assistente de redação ou analista de dados.

12 12 

13Para instruções sobre seu projeto, convenções ou base de código, use [CLAUDE.md](/pt/memory) em vez disso.13Para instruções sobre seu projeto, convenções ou base de código, use [CLAUDE.md](/docs/pt/memory) em vez disso.

14 14 

15<h2 id="built-in-output-styles">15<h2 id="built-in-output-styles">

16 Estilos de saída integrados16 Estilos de saída integrados


20 20 

21Existem três estilos de saída integrados adicionais:21Existem três estilos de saída integrados adicionais:

22 22 

23* **Proactive**: Claude executa imediatamente, faz suposições razoáveis em vez de pausar para decisões rotineiras e prefere ação ao planejamento. Isso é uma orientação de execução autônoma mais forte do que o [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) aplica, e funciona sem alterar seu modo de permissão, portanto você ainda vê prompts de permissão antes das ferramentas serem executadas.23* **Proactive**: Claude executa imediatamente, faz suposições razoáveis em vez de pausar para decisões rotineiras e prefere ação ao planejamento. Isso é uma orientação de execução autônoma mais forte do que o [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) aplica, e funciona sem alterar seu modo de permissão, portanto você ainda vê prompts de permissão antes das ferramentas serem executadas.

24 24 

25* **Explanatory**: Fornece "Insights" educacionais entre ajudá-lo a completar tarefas de engenharia de software. Ajuda você a entender as escolhas de implementação e padrões da base de código.25* **Explanatory**: Fornece "Insights" educacionais entre ajudá-lo a completar tarefas de engenharia de software. Ajuda você a entender as escolhas de implementação e padrões da base de código.

26 26 


30 Altere seu estilo de saída30 Altere seu estilo de saída

31</h2>31</h2>

32 32 

33Execute `/config` e selecione **Output style** para escolher um estilo de um menu. Sua seleção é salva em `.claude/settings.local.json` no [nível do projeto local](/pt/settings).33Execute `/config` e selecione **Output style** para escolher um estilo de um menu. Sua seleção é salva em `.claude/settings.local.json` no [nível do projeto local](/docs/pt/settings).

34 34 

35<Note>{/* max-version: 2.1.90 */}O comando `/output-style` independente foi descontinuado na v2.1.73 e removido na v2.1.91. Use `/config` ou edite a configuração `outputStyle` diretamente.</Note>35<Note>O comando `/output-style` independente foi descontinuado na v2.1.73 e removido na v2.1.91. Use `/config` ou edite a configuração `outputStyle` diretamente.</Note>

36 36 

37Para definir um estilo sem o menu, edite o campo `outputStyle` diretamente em um arquivo de configurações:37Para definir um estilo sem o menu, edite o campo `outputStyle` diretamente em um arquivo de configurações:

38 38 


42}42}

43```43```

44 44 

45O estilo de saída faz parte do prompt do sistema, que Claude Code lê uma vez no início da sessão. As alterações entram em vigor após `/clear` ou uma nova sessão. Consulte [Como Claude Code usa prompt caching](/pt/prompt-caching#changing-output-style) para saber o que uma mudança de estilo de saída faz no cache.45O estilo de saída faz parte do prompt do sistema, que Claude Code lê uma vez no início da sessão. As alterações entram em vigor após `/clear` ou uma nova sessão. Consulte [Como Claude Code usa prompt caching](/docs/pt/prompt-caching#changing-output-style) para saber o que uma mudança de estilo de saída faz no cache.

46 46 

47<h2 id="create-a-custom-output-style">47<h2 id="create-a-custom-output-style">

48 Crie um estilo de saída personalizado48 Crie um estilo de saída personalizado


56 56 

57 * Usuário: `~/.claude/output-styles`57 * Usuário: `~/.claude/output-styles`

58 * Projeto: `.claude/output-styles`58 * Projeto: `.claude/output-styles`

59 * Política gerenciada: `.claude/output-styles` dentro do [diretório de configurações gerenciadas](/pt/settings#settings-files)59 * Política gerenciada: `.claude/output-styles` dentro do [diretório de configurações gerenciadas](/docs/pt/settings#settings-files)

60 60 

61 Os estilos de saída do projeto são carregados de cada `.claude/output-styles/` entre o diretório de trabalho e a raiz do repositório. {/* min-version: 2.1.178 */}A partir da v2.1.178, quando mais de um desses diretórios aninhados define um estilo com o mesmo nome, Claude Code usa o mais próximo do diretório de trabalho.61 Os estilos de saída do projeto são carregados de cada `.claude/output-styles/` entre o diretório de trabalho e a raiz do repositório. A partir da v2.1.178, quando mais de um desses diretórios aninhados define um estilo com o mesmo nome, Claude Code usa o mais próximo do diretório de trabalho.

62 </Step>62 </Step>

63 63 

64 <Step title="Adicione frontmatter e instruções">64 <Step title="Adicione frontmatter e instruções">


86 </Step>86 </Step>

87</Steps>87</Steps>

88 88 

89[Plugins](/pt/plugins-reference) também podem enviar estilos de saída em um diretório `output-styles/`.89[Plugins](/docs/pt/plugins-reference) também podem enviar estilos de saída em um diretório `output-styles/`.

90 90 

91<h3 id="frontmatter">91<h3 id="frontmatter">

92 Frontmatter92 Frontmatter


122| Recurso | Como funciona | Use-o quando |122| Recurso | Como funciona | Use-o quando |

123| :----------------------- | :--------------------------------------------------------------------------- | :------------------------------------------------------------------------------- |123| :----------------------- | :--------------------------------------------------------------------------- | :------------------------------------------------------------------------------- |

124| Estilos de saída | Modifica o prompt do sistema | Você quer um papel, tom ou formato de resposta padrão diferente a cada turno |124| Estilos de saída | Modifica o prompt do sistema | Você quer um papel, tom ou formato de resposta padrão diferente a cada turno |

125| [CLAUDE.md](/pt/memory) | Adiciona uma mensagem do usuário após o prompt do sistema | Claude deve sempre saber suas convenções de projeto e contexto da base de código |125| [CLAUDE.md](/docs/pt/memory) | Adiciona uma mensagem do usuário após o prompt do sistema | Claude deve sempre saber suas convenções de projeto e contexto da base de código |

126| `--append-system-prompt` | Anexa ao prompt do sistema sem remover nada | Você quer uma adição única para uma única invocação |126| `--append-system-prompt` | Anexa ao prompt do sistema sem remover nada | Você quer uma adição única para uma única invocação |

127| [Agents](/pt/sub-agents) | Executa um subagente com seu próprio prompt do sistema, modelo e ferramentas | Você quer um auxiliar com escopo separado para uma tarefa focada |127| [Agents](/docs/pt/sub-agents) | Executa um subagente com seu próprio prompt do sistema, modelo e ferramentas | Você quer um auxiliar com escopo separado para uma tarefa focada |

128| [Skills](/pt/skills) | Carrega instruções específicas de tarefas quando invocadas ou relevantes | Você tem um fluxo de trabalho reutilizável |128| [Skills](/docs/pt/skills) | Carrega instruções específicas de tarefas quando invocadas ou relevantes | Você tem um fluxo de trabalho reutilizável |

129 129 

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

131 Recursos relacionados131 Recursos relacionados

132</h2>132</h2>

133 133 

134* [Settings](/pt/settings): onde o campo `outputStyle` reside e como a precedência de configurações funciona134* [Settings](/docs/pt/settings): onde o campo `outputStyle` reside e como a precedência de configurações funciona

135* [Permission modes](/pt/permission-modes): como o estilo Proactive se compara ao modo automático135* [Permission modes](/docs/pt/permission-modes): como o estilo Proactive se compara ao modo automático

136* [Plugins](/pt/plugins): empacote e distribua estilos de saída junto com skills, hooks e agents136* [Plugins](/docs/pt/plugins): empacote e distribua estilos de saída junto com skills, hooks e agents

137* [Debug your configuration](/pt/debug-your-config): diagnostique por que um estilo de saída não está entrando em vigor137* [Debug your configuration](/docs/pt/debug-your-config): diagnostique por que um estilo de saída não está entrando em vigor

Details

27 27 

28Em todos os modos, exceto `bypassPermissions`, as gravações em [caminhos protegidos](#protected-paths) nunca são auto-aprovadas, protegendo o estado do repositório e a configuração do próprio Claude contra corrupção acidental.28Em todos os modos, exceto `bypassPermissions`, as gravações em [caminhos protegidos](#protected-paths) nunca são auto-aprovadas, protegendo o estado do repositório e a configuração do próprio Claude contra corrupção acidental.

29 29 

30Os modos definem a linha de base. Sobreponha [regras de permissão](/pt/permissions#manage-permissions) no topo para pré-aprovar ou bloquear ferramentas específicas. Regras de negação, regras de solicitação explícita, a [configuração `ask` da organização em ferramentas de conector](/pt/mcp#organization-controls-on-connector-tools) e o marcador [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) se aplicam em todos os modos, incluindo `bypassPermissions`. Regras de permissão não têm efeito nesse modo porque tudo mais já está aprovado.30Os modos definem a linha de base. Sobreponha [regras de permissão](/docs/pt/permissions#manage-permissions) no topo para pré-aprovar ou bloquear ferramentas específicas. Regras de negação, regras de solicitação explícita, a [configuração `ask` da organização em ferramentas de conector](/docs/pt/mcp#organization-controls-on-connector-tools) e o marcador [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) se aplicam em todos os modos, incluindo `bypassPermissions`. Regras de permissão não têm efeito nesse modo porque tudo mais já está aprovado.

31 31 

32<h2 id="switch-permission-modes">32<h2 id="switch-permission-modes">

33 Alternar modos de permissão33 Alternar modos de permissão


37 37 

38<Tabs>38<Tabs>

39 <Tab title="CLI">39 <Tab title="CLI">

40 **Durante uma sessão**: pressione `Shift+Tab` para alternar `default` → `acceptEdits` → `plan`. O modo atual aparece na barra de status. {/* min-version: 2.1.203 */}O modo manual, `default` nesse ciclo, mostra um badge cinza `⏸ manual mode on`. Antes da v2.1.203, a barra de status não mostrava nenhum badge no modo Manual.40 **Durante uma sessão**: pressione `Shift+Tab` para alternar `default` → `acceptEdits` → `plan`. O modo atual aparece na barra de status. O modo manual, `default` nesse ciclo, mostra um badge cinza `⏸ manual mode on`. Antes da v2.1.203, a barra de status não mostrava nenhum badge no modo Manual.

41 41 

42 Nem todo modo está no ciclo padrão:42 Nem todo modo está no ciclo padrão:

43 43 


53 claude --permission-mode plan53 claude --permission-mode plan

54 ```54 ```

55 55 

56 **Como padrão**: defina `defaultMode` em [settings](/pt/settings#settings-files).56 **Como padrão**: defina `defaultMode` em [settings](/docs/pt/settings#settings-files).

57 57 

58 ```json theme={null}58 ```json theme={null}

59 {59 {


63 }63 }

64 ```64 ```

65 65 

66 A mesma flag `--permission-mode` funciona com `-p` para [execuções não-interativas](/pt/headless).66 A mesma flag `--permission-mode` funciona com `-p` para [execuções não-interativas](/docs/pt/headless).

67 </Tab>67 </Tab>

68 68 

69 <Tab title="VS Code">69 <Tab title="VS Code">


83 83 

84 Antes da v2.1.205, a extensão rotulava `plan` como Plan mode e `auto` como Auto mode.84 Antes da v2.1.205, a extensão rotulava `plan` como Plan mode e `auto` como Auto mode.

85 85 

86 O modo automático aparece no indicador de modo quando sua conta atende a todos os requisitos listados na [seção de modo automático](#eliminate-prompts-with-auto-mode). A configuração `claudeCode.initialPermissionMode` não aceita `auto`. Para iniciar no modo automático por padrão, defina `defaultMode` em suas [configurações de usuário](/pt/settings#settings-files). Claude Code ignora `defaultMode: "auto"` nas configurações de projeto e locais.86 O modo automático aparece no indicador de modo quando sua conta atende a todos os requisitos listados na [seção de modo automático](#eliminate-prompts-with-auto-mode). A configuração `claudeCode.initialPermissionMode` não aceita `auto`. Para iniciar no modo automático por padrão, defina `defaultMode` em suas [configurações de usuário](/docs/pt/settings#settings-files). Claude Code ignora `defaultMode: "auto"` nas configurações de projeto e locais.

87 87 

88 Bypass permissions requer o toggle **Allow dangerously skip permissions** nas configurações da extensão antes de aparecer no indicador de modo.88 Bypass permissions requer o toggle **Allow dangerously skip permissions** nas configurações da extensão antes de aparecer no indicador de modo.

89 89 

90 Veja o [guia do VS Code](/pt/vs-code) para detalhes específicos da extensão.90 Veja o [guia do VS Code](/docs/pt/vs-code) para detalhes específicos da extensão.

91 </Tab>91 </Tab>

92 92 

93 <Tab title="JetBrains">93 <Tab title="JetBrains">


100 * **Auto**: aparece quando sua conta atende aos [requisitos do modo automático](#eliminate-prompts-with-auto-mode)100 * **Auto**: aparece quando sua conta atende aos [requisitos do modo automático](#eliminate-prompts-with-auto-mode)

101 * **Bypass permissions**: requer o toggle **Allow bypass permissions mode** nas configurações do Desktop nos planos Pro e Max; nos planos Team e Enterprise, a política da organização controla isso101 * **Bypass permissions**: requer o toggle **Allow bypass permissions mode** nas configurações do Desktop nos planos Pro e Max; nos planos Team e Enterprise, a política da organização controla isso

102 102 

103 Para detalhes específicos do desktop, veja [Escolher um modo de permissão](/pt/desktop#choose-a-permission-mode) no guia do Desktop.103 Para detalhes específicos do desktop, veja [Escolher um modo de permissão](/docs/pt/desktop#choose-a-permission-mode) no guia do Desktop.

104 104 

105 **Como padrão**: defina `defaultMode` em [settings](/pt/settings#settings-files). O aplicativo desktop lê os mesmos arquivos de configurações que a CLI e aplica o modo a novas sessões locais.105 **Como padrão**: defina `defaultMode` em [settings](/docs/pt/settings#settings-files). O aplicativo desktop lê os mesmos arquivos de configurações que a CLI e aplica o modo a novas sessões locais.

106 106 

107 Um modo que você escolhe no seletor de modo é lembrado por pasta e tem precedência sobre `defaultMode` para essa pasta. Plan é a exceção: escolhê-lo se aplica apenas à sessão atual.107 Um modo que você escolhe no seletor de modo é lembrado por pasta e tem precedência sobre `defaultMode` para essa pasta. Plan é a exceção: escolhê-lo se aplica apenas à sessão atual.

108 108 


120 <Tab title="Web and mobile">120 <Tab title="Web and mobile">

121 Use o dropdown de modo ao lado da caixa de prompt em [claude.ai/code](https://claude.ai/code) ou no aplicativo móvel. Prompts de permissão aparecem no claude.ai para aprovação. Quais modos aparecem depende de onde a sessão é executada:121 Use o dropdown de modo ao lado da caixa de prompt em [claude.ai/code](https://claude.ai/code) ou no aplicativo móvel. Prompts de permissão aparecem no claude.ai para aprovação. Quais modos aparecem depende de onde a sessão é executada:

122 122 

123 * **Sessões em nuvem** em [Claude Code na web](/pt/claude-code-on-the-web): Accept edits, Plan e Auto. Accept edits corresponde ao modo `default`: o ambiente em nuvem pré-aprova edições de arquivo independentemente do modo, então o dropdown mostra Accept edits em vez de Manual. Sessões em nuvem ainda honram `defaultMode: "acceptEdits"` das configurações. O modo automático aparece apenas quando sua organização o permite e o modelo selecionado o suporta. Bypass permissions não está disponível.123 * **Sessões em nuvem** em [Claude Code na web](/docs/pt/claude-code-on-the-web): Accept edits, Plan e Auto. Accept edits corresponde ao modo `default`: o ambiente em nuvem pré-aprova edições de arquivo independentemente do modo, então o dropdown mostra Accept edits em vez de Manual. Sessões em nuvem ainda honram `defaultMode: "acceptEdits"` das configurações. O modo automático aparece apenas quando sua organização o permite e o modelo selecionado o suporta. Bypass permissions não está disponível.

124 * **Sessões de [Remote Control](/pt/remote-control)** em sua máquina local: Manual, Accept edits e Plan. Você não pode selecionar Auto ou Bypass permissions do aplicativo. {/* min-version: 2.1.202 */}O dropdown mostra o modo em que a sessão local está, incluindo um modo definido do terminal, e atualiza quando o modo muda no aplicativo ou no terminal. A única exceção é Bypass permissions: a sessão nunca relata esse modo ao claude.ai, então alternar para ele do terminal não muda o que o dropdown mostra. Antes da v2.1.202, sessões conectadas com `/remote-control` ou `claude --remote-control` não relatavam seu modo, então claude.ai e o aplicativo móvel poderiam mostrar um modo em que a sessão não estava. A incompatibilidade afetava apenas o rótulo: Claude Code gerou prompts de permissão a partir do modo real da sessão, e eles ainda apareciam no aplicativo para aprovação.124 * **Sessões de [Remote Control](/docs/pt/remote-control)** em sua máquina local: Manual, Accept edits e Plan. Você não pode selecionar Auto ou Bypass permissions do aplicativo. O dropdown mostra o modo em que a sessão local está, incluindo um modo definido do terminal, e atualiza quando o modo muda no aplicativo ou no terminal. A única exceção é Bypass permissions: a sessão nunca relata esse modo ao claude.ai, então alternar para ele do terminal não muda o que o dropdown mostra. Antes da v2.1.202, sessões conectadas com `/remote-control` ou `claude --remote-control` não relatavam seu modo, então claude.ai e o aplicativo móvel poderiam mostrar um modo em que a sessão não estava. A incompatibilidade afetava apenas o rótulo: Claude Code gerou prompts de permissão a partir do modo real da sessão, e eles ainda apareciam no aplicativo para aprovação.

125 125 

126 Para Remote Control, você também pode definir o modo inicial ao iniciar o host:126 Para Remote Control, você também pode definir o modo inicial ao iniciar o host:

127 127 


137 137 

138O modo `acceptEdits` permite que Claude crie e edite arquivos em seu diretório de trabalho sem solicitar confirmação. A barra de status mostra `⏵⏵ accept edits on` enquanto este modo está ativo.138O modo `acceptEdits` permite que Claude crie e edite arquivos em seu diretório de trabalho sem solicitar confirmação. A barra de status mostra `⏵⏵ accept edits on` enquanto este modo está ativo.

139 139 

140Além das edições de arquivo, o modo `acceptEdits` auto-aprova comandos Bash comuns do sistema de arquivos: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` e `sed`. Esses comandos também são auto-aprovados quando prefixados com variáveis de ambiente seguras como `LANG=C` ou `NO_COLOR=1`, ou wrappers de processo como `timeout`, `nice` ou `nohup`. Como as edições de arquivo, a auto-aprovação se aplica apenas a caminhos dentro de seu diretório de trabalho ou `additionalDirectories`. Caminhos fora desse escopo, gravações em [caminhos protegidos](#protected-paths) e todos os outros comandos Bash, exceto o [conjunto integrado somente leitura](/pt/permissions#read-only-commands), ainda solicitam confirmação.140Além das edições de arquivo, o modo `acceptEdits` auto-aprova comandos Bash comuns do sistema de arquivos: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` e `sed`. Esses comandos também são auto-aprovados quando prefixados com variáveis de ambiente seguras como `LANG=C` ou `NO_COLOR=1`, ou wrappers de processo como `timeout`, `nice` ou `nohup`. Como as edições de arquivo, a auto-aprovação se aplica apenas a caminhos dentro de seu diretório de trabalho ou `additionalDirectories`. Caminhos fora desse escopo, gravações em [caminhos protegidos](#protected-paths) e todos os outros comandos Bash, exceto o [conjunto integrado somente leitura](/docs/pt/permissions#read-only-commands), ainda solicitam confirmação.

141 141 

142Quando a [ferramenta PowerShell](/pt/tools-reference#powershell-tool) está habilitada, o modo `acceptEdits` também auto-aprova `Set-Content`, `Add-Content`, `Clear-Content` e `Remove-Item` em caminhos no escopo, junto com seus aliases comuns. As mesmas regras de escopo e caminho protegido se aplicam.142Quando a [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) está habilitada, o modo `acceptEdits` também auto-aprova `Set-Content`, `Add-Content`, `Clear-Content` e `Remove-Item` em caminhos no escopo, junto com seus aliases comuns. As mesmas regras de escopo e caminho protegido se aplicam.

143 143 

144Use `acceptEdits` quando você quiser revisar as alterações em seu editor ou via `git diff` depois, em vez de aprovar cada edição inline.144Use `acceptEdits` quando você quiser revisar as alterações em seu editor ou via `git diff` depois, em vez de aprovar cada edição inline.

145 145 


153 Analise antes de editar com o modo plan153 Analise antes de editar com o modo plan

154</h2>154</h2>

155 155 

156O modo plan instrui Claude a pesquisar e propor alterações sem realizá-las. Claude lê arquivos, executa comandos shell para explorar e escreve um plano, mas não edita sua fonte. Os prompts de permissão se aplicam como fazem no modo Manual, a menos que [modo automático](/pt/auto-mode-config) esteja disponível e `useAutoModeDuringPlan` esteja ativado, que é o padrão. Com o modo automático ativo, o classificador aprova comandos somente leitura, como pesquisas e leituras de arquivo, sem solicitar. As edições permanecem bloqueadas de qualquer forma até que você aprove o plano.156O modo plan instrui Claude a pesquisar e propor alterações sem realizá-las. Claude lê arquivos, executa comandos shell para explorar e escreve um plano, mas não edita sua fonte. Os prompts de permissão se aplicam como fazem no modo Manual, a menos que [modo automático](/docs/pt/auto-mode-config) esteja disponível e `useAutoModeDuringPlan` esteja ativado, que é o padrão. Com o modo automático ativo, o classificador aprova comandos somente leitura, como pesquisas e leituras de arquivo, sem solicitar. As edições permanecem bloqueadas de qualquer forma até que você aprove o plano.

157 157 

158Entre no modo plan pressionando `Shift+Tab` ou prefixando um único prompt com `/plan`. Você também pode iniciar no modo plan a partir da CLI:158Entre no modo plan pressionando `Shift+Tab` ou prefixando um único prompt com `/plan`. Você também pode iniciar no modo plan a partir da CLI:

159 159 


173* Aprovar e aceitar edições173* Aprovar e aceitar edições

174* Aprovar e revisar cada edição manualmente174* Aprovar e revisar cada edição manualmente

175* Continuar planejando com feedback175* Continuar planejando com feedback

176* Refinar com [Ultraplan](/pt/ultraplan) para revisão baseada em navegador176* Refinar com [Ultraplan](/docs/pt/ultraplan) para revisão baseada em navegador

177 177 

178Aprovar um plano sai do modo plan e muda a sessão para o modo de permissão que cada opção de aprovação descreve, então Claude começa a editar. Para planejar novamente, volte ao modo plan com `Shift+Tab`, ou prefixe seu próximo prompt com `/plan`.178Aprovar um plano sai do modo plan e muda a sessão para o modo de permissão que cada opção de aprovação descreve, então Claude começa a editar. Para planejar novamente, volte ao modo plan com `Shift+Tab`, ou prefixe seu próximo prompt com `/plan`.

179 179 

180Pressione `Ctrl+G` para abrir o plano proposto em seu editor de texto padrão e editá-lo diretamente antes de Claude prosseguir. Quando [`showClearContextOnPlanAccept`](/pt/settings#available-settings) está ativado, cada opção de aprovação também oferece limpar o contexto de planejamento primeiro.180Pressione `Ctrl+G` para abrir o plano proposto em seu editor de texto padrão e editá-lo diretamente antes de Claude prosseguir. Quando [`showClearContextOnPlanAccept`](/docs/pt/settings#available-settings) está ativado, cada opção de aprovação também oferece limpar o contexto de planejamento primeiro.

181 181 

182Aceitar um plano também nomeia a sessão a partir do conteúdo do plano automaticamente, a menos que você já tenha definido um nome com `--name` ou `/rename`.182Aceitar um plano também nomeia a sessão a partir do conteúdo do plano automaticamente, a menos que você já tenha definido um nome com `--name` ou `/rename`.

183 183 


199 Elimine prompts de permissão com modo automático199 Elimine prompts de permissão com modo automático

200</h2>200</h2>

201 201 

202O modo automático permite que Claude execute sem prompts de permissão rotineiros. Um modelo classificador separado revisa as ações antes de serem executadas, bloqueando qualquer coisa que ultrapasse sua solicitação, tenha como alvo infraestrutura não reconhecida ou pareça impulsionada por conteúdo hostil que Claude leu. As [regras de solicitação](/pt/permissions#manage-permissions) explícitas ainda forçam um prompt.202O modo automático permite que Claude execute sem prompts de permissão rotineiros. Um modelo classificador separado revisa as ações antes de serem executadas, bloqueando qualquer coisa que ultrapasse sua solicitação, tenha como alvo infraestrutura não reconhecida ou pareça impulsionada por conteúdo hostil que Claude leu. As [regras de solicitação](/docs/pt/permissions#manage-permissions) explícitas ainda forçam um prompt.

203 203 

204Remoções direcionadas ao diretório raiz do sistema de arquivos ou ao diretório home, como `rm -rf /` e `rm -rf ~`, solicitam aprovação em vez de ir para o classificador. {/* min-version: 2.1.208 */}Este prompt também é acionado quando o comando contém substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`, independentemente de a remoção estar dentro da substituição, como em `echo "$(rm -rf ~)"`, ou em outro lugar no mesmo comando. Antes de v2.1.208, comandos contendo essas formas iam para o classificador em vez de solicitar.204Remoções direcionadas ao diretório raiz do sistema de arquivos ou ao diretório home, como `rm -rf /` e `rm -rf ~`, solicitam aprovação em vez de ir para o classificador. Este prompt também é acionado quando o comando contém substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`, independentemente de a remoção estar dentro da substituição, como em `echo "$(rm -rf ~)"`, ou em outro lugar no mesmo comando. Antes de v2.1.208, comandos contendo essas formas iam para o classificador em vez de solicitar.

205 205 

206O modo automático também incentiva Claude a continuar trabalhando sem parar para fazer perguntas de esclarecimento, embora Claude ainda pergunte quando seu prompt ou uma skill depende explicitamente disso. Para um comportamento mais autônomo mantendo prompts de permissão, defina o [estilo de saída Proativo](/pt/output-styles) em vez disso.206O modo automático também incentiva Claude a continuar trabalhando sem parar para fazer perguntas de esclarecimento, embora Claude ainda pergunte quando seu prompt ou uma skill depende explicitamente disso. Para um comportamento mais autônomo mantendo prompts de permissão, defina o [estilo de saída Proativo](/docs/pt/output-styles) em vez disso.

207 207 

208<Warning>208<Warning>

209 O modo automático reduz prompts de permissão, mas não garante segurança. Use-o para tarefas em que você confia na direção geral, não como substituto para revisão em operações sensíveis.209 O modo automático reduz prompts de permissão, mas não garante segurança. Use-o para tarefas em que você confia na direção geral, não como substituto para revisão em operações sensíveis.


212O modo automático está disponível apenas quando sua conta atende a todos esses requisitos:212O modo automático está disponível apenas quando sua conta atende a todos esses requisitos:

213 213 

214* **Plano**: Todos os planos.214* **Plano**: Todos os planos.

215* **Proprietário**: em Team e Enterprise, um Proprietário deve habilitá-lo nas [configurações de administrador do Claude Code](https://claude.ai/admin-settings/claude-code) antes que os usuários possam ativá-lo. Os administradores também podem desativar o modo automático definindo `permissions.disableAutoMode` como `"disable"` nas [configurações gerenciadas](/pt/permissions#managed-settings). Para a aba Code do aplicativo desktop, `disableAutoMode` é o controle no nível da organização, e o toggle de configurações de administrador não se aplica.215* **Proprietário**: em Team e Enterprise, um Proprietário deve habilitá-lo nas [configurações de administrador do Claude Code](https://claude.ai/admin-settings/claude-code) antes que os usuários possam ativá-lo. Os administradores também podem desativar o modo automático definindo `permissions.disableAutoMode` como `"disable"` nas [configurações gerenciadas](/docs/pt/permissions#managed-settings). Para a aba Code do aplicativo desktop, `disableAutoMode` é o controle no nível da organização, e o toggle de configurações de administrador não se aplica.

216* **Modelo**: na API Anthropic, Claude Opus 4.6 ou posterior, ou Sonnet 4.6 ou posterior. No Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry e em sessões do [gateway de aplicativos Claude](/pt/claude-apps-gateway) conectadas, apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8. Modelos mais antigos, incluindo Sonnet 4.5, Opus 4.5, Haiku e modelos claude-3, não são suportados em nenhum provedor.216* **Modelo**: na API Anthropic, Claude Opus 4.6 ou posterior, ou Sonnet 4.6 ou posterior. No Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry e em sessões do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas, apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8. Modelos mais antigos, incluindo Sonnet 4.5, Opus 4.5, Haiku e modelos claude-3, não são suportados em nenhum provedor.

217* **Provedor**: disponível por padrão na API Anthropic, Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões do gateway de aplicativos Claude conectadas. {/* min-version: 2.1.207 */}Na v2.1.158 até v2.1.206, o modo automático estava desativado em todos esses provedores, exceto na API Anthropic, até que você definisse `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 removeu o requisito.217* **Provedor**: disponível por padrão na API Anthropic, Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões do gateway de aplicativos Claude conectadas. Na v2.1.158 até v2.1.206, o modo automático estava desativado em todos esses provedores, exceto na API Anthropic, até que você definisse `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 removeu o requisito.

218 218 

219Se Claude Code relatar o modo automático como indisponível, um desses requisitos não foi atendido; isso não é uma interrupção transitória. Uma mensagem separada que nomeia um modelo e diz que o modo automático "não consegue determinar a segurança" de uma ação é uma interrupção transitória do classificador; consulte a [referência de erros](/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action).219Se Claude Code relatar o modo automático como indisponível, um desses requisitos não foi atendido; isso não é uma interrupção transitória. Uma mensagem separada que nomeia um modelo e diz que o modo automático "não consegue determinar a segurança" de uma ação é uma interrupção transitória do classificador; consulte a [referência de erros](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action).

220 220 

221Se você definir `defaultMode: "auto"` nas [configurações](/pt/settings#available-settings) e a sessão começar no modo `default` sem erro, a configuração provavelmente está em `.claude/settings.json` ou `.claude/settings.local.json`. Claude Code v2.1.142 e posterior ignoram `auto` desses arquivos para que um repositório não possa se conceder modo automático. Mova-o para `~/.claude/settings.json`.221Se você definir `defaultMode: "auto"` nas [configurações](/docs/pt/settings#available-settings) e a sessão começar no modo `default` sem erro, a configuração provavelmente está em `.claude/settings.json` ou `.claude/settings.local.json`. Claude Code v2.1.142 e posterior ignoram `auto` desses arquivos para que um repositório não possa se conceder modo automático. Mova-o para `~/.claude/settings.json`.

222 222 

223<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">223<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

224 Modo automático no Bedrock, Agent Platform ou Foundry224 Modo automático no Bedrock, Agent Platform ou Foundry

225</h3>225</h3>

226 226 

227No [Amazon Bedrock](/pt/amazon-bedrock), na [Agent Platform do Google Cloud](/pt/google-vertex-ai), no [Microsoft Foundry](/pt/microsoft-foundry) e em sessões do [gateway de aplicativos Claude](/pt/claude-apps-gateway) conectadas, o modo automático aparece no ciclo `Shift+Tab` por padrão. Aparecer no ciclo não muda o modo em que uma sessão começa: as sessões ainda começam em seu [`defaultMode`](/pt/settings#available-settings), que é Manual a menos que você o altere. Apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8 são suportados nesses provedores.227No [Amazon Bedrock](/docs/pt/amazon-bedrock), na [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), no [Microsoft Foundry](/docs/pt/microsoft-foundry) e em sessões do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas, o modo automático aparece no ciclo `Shift+Tab` por padrão. Aparecer no ciclo não muda o modo em que uma sessão começa: as sessões ainda começam em seu [`defaultMode`](/docs/pt/settings#available-settings), que é Manual a menos que você o altere. Apenas Claude Sonnet 5, Opus 4.7 e Opus 4.8 são suportados nesses provedores.

228 228 

229Para tornar o modo automático o modo de início padrão, defina `"permissions": {"defaultMode": "auto"}` nas configurações de usuário ou gerenciadas.229Para tornar o modo automático o modo de início padrão, defina `"permissions": {"defaultMode": "auto"}` nas configurações de usuário ou gerenciadas.

230 230 

231Para impedir que desenvolvedores usem o modo automático, defina `disableAutoMode` como `"disable"` nas [configurações gerenciadas](/pt/permissions#managed-settings). Isso remove `auto` do ciclo `Shift+Tab` e rejeita `--permission-mode auto` na inicialização.231Para impedir que desenvolvedores usem o modo automático, defina `disableAutoMode` como `"disable"` nas [configurações gerenciadas](/docs/pt/permissions#managed-settings). Isso remove `auto` do ciclo `Shift+Tab` e rejeita `--permission-mode auto` na inicialização.

232 232 

233Na v2.1.158 até v2.1.206, o modo automático estava desativado nesses provedores até que você definisse `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, e Claude Code ignorava `defaultMode: "auto"` nesses provedores a menos que a variável também fosse definida. A variável ainda é aceita para compatibilidade e não tem efeito a partir de v2.1.207 em diante.233Na v2.1.158 até v2.1.206, o modo automático estava desativado nesses provedores até que você definisse `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, e Claude Code ignorava `defaultMode: "auto"` nesses provedores a menos que a variável também fosse definida. A variável ainda é aceita para compatibilidade e não tem efeito a partir de v2.1.207 em diante.

234 234 


236 O que o classificador bloqueia por padrão236 O que o classificador bloqueia por padrão

237</h3>237</h3>

238 238 

239O classificador confia em seu diretório de trabalho e nos remotes que foram configurados para ele quando a sessão começou. {/* min-version: 2.1.200 */}Um remote adicionado ou reorientado durante a sessão com `git remote add` ou `git remote set-url` não é confiável, e tudo mais é tratado como externo até que você [configure infraestrutura confiável](/pt/auto-mode-config). Antes de v2.1.200, remotes adicionados no meio da sessão também eram confiáveis.239O classificador confia em seu diretório de trabalho e nos remotes que foram configurados para ele quando a sessão começou. Um remote adicionado ou reorientado durante a sessão com `git remote add` ou `git remote set-url` não é confiável, e tudo mais é tratado como externo até que você [configure infraestrutura confiável](/docs/pt/auto-mode-config). Antes de v2.1.200, remotes adicionados no meio da sessão também eram confiáveis.

240 240 

241**Bloqueado por padrão**:241**Bloqueado por padrão**:

242 242 


248* Modificação de infraestrutura compartilhada248* Modificação de infraestrutura compartilhada

249* Destruição irreversível de arquivos que existiam antes da sessão249* Destruição irreversível de arquivos que existiam antes da sessão

250* Force push250* Force push

251* {/* min-version: 2.1.203 */}Pushing para o branch padrão do repositório quando o push contém conteúdo sensível, como segredos ou dados pessoais ou confiados, contém alterações ocultadas ou mal descritas em relação ao que você pediu, contém conteúdo portado ou lido pela primeira vez de fora do repositório, ou contorna uma pull request, revisão ou verificação que você pediu. Um push simples para o branch padrão não é bloqueado por si só, e limpar um push sinalizado requer nomear o conteúdo sinalizado ou a revisão contornada, não apenas o push. O classificador é uma camada: as [regras `permissions.deny`](/pt/permissions#manage-permissions) se aplicam em todos os modos e podem bloquear pushes para o branch padrão completamente, e a proteção de branch do próprio remote ainda se aplica. Antes de v2.1.203, qualquer push direto para o branch padrão era bloqueado251* Pushing para o branch padrão do repositório quando o push contém conteúdo sensível, como segredos ou dados pessoais ou confiados, contém alterações ocultadas ou mal descritas em relação ao que você pediu, contém conteúdo portado ou lido pela primeira vez de fora do repositório, ou contorna uma pull request, revisão ou verificação que você pediu. Um push simples para o branch padrão não é bloqueado por si só, e limpar um push sinalizado requer nomear o conteúdo sinalizado ou a revisão contornada, não apenas o push. O classificador é uma camada: as [regras `permissions.deny`](/docs/pt/permissions#manage-permissions) se aplicam em todos os modos e podem bloquear pushes para o branch padrão completamente, e a proteção de branch do próprio remote ainda se aplica. Antes de v2.1.203, qualquer push direto para o branch padrão era bloqueado

252* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` ou `git stash clear`, que o classificador presume descartaria alterações não confirmadas252* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` ou `git stash clear`, que o classificador presume descartaria alterações não confirmadas

253* `git commit --amend` quando o commit no HEAD não foi criado nesta sessão253* `git commit --amend` quando o commit no HEAD não foi criado nesta sessão

254* {/* min-version: 2.1.198 */}A partir de v2.1.198, `git commit --amend` quando o commit no HEAD já foi enviado. Uma reword apenas de mensagem não é bloqueada: `--amend -m` sem nada recém-preparado, em um commit que Claude criou durante esta sessão254* A partir de v2.1.198, `git commit --amend` quando o commit no HEAD já foi enviado. Uma reword apenas de mensagem não é bloqueada: `--amend -m` sem nada recém-preparado, em um commit que Claude criou durante esta sessão

255* `terraform destroy`, `pulumi destroy`, `cdk destroy` ou `terragrunt destroy`, e aplicação de um plano que destrói recursos255* `terraform destroy`, `pulumi destroy`, `cdk destroy` ou `terragrunt destroy`, e aplicação de um plano que destrói recursos

256 256 

257Claude Code v2.1.195 e posterior bloqueiam mais categorias por padrão. Várias dependem de entradas de [ambiente](/pt/auto-mode-config#define-trusted-infrastructure), como destinos remotos sensíveis e escopos de IaC protegidos, que você pode restringir a nomes concretos.257Claude Code v2.1.195 e posterior bloqueiam mais categorias por padrão. Várias dependem de entradas de [ambiente](/docs/pt/auto-mode-config#define-trusted-infrastructure), como destinos remotos sensíveis e escopos de IaC protegidos, que você pode restringir a nomes concretos.

258 258 

259* Escrita em um gerenciador de segredos, ou alteração de registros DNS ou certificados TLS259* Escrita em um gerenciador de segredos, ou alteração de registros DNS ou certificados TLS

260* Mesclagem de uma pull request que nenhum humano aprovou, aprovação da própria pull request do Claude ou desabilitação de verificações de CI260* Mesclagem de uma pull request que nenhum humano aprovou, aprovação da própria pull request do Claude ou desabilitação de verificações de CI


266* Shells interativos ou port-forwards em um destino remoto sensível266* Shells interativos ou port-forwards em um destino remoto sensível

267* Abertura de um túnel ou shell reverso que torna um serviço local acessível da internet pública267* Abertura de um túnel ou shell reverso que torna um serviço local acessível da internet pública

268* Impressão de uma credencial ou token ao vivo na transcrição ou em um arquivo268* Impressão de uma credencial ou token ao vivo na transcrição ou em um arquivo

269* Acesso a um local listado como local de dados sensíveis em seu [ambiente](/pt/auto-mode-config#define-trusted-infrastructure), ou cópia de dados de um. {/* min-version: 2.1.198 */}A partir de v2.1.198, isso também bloqueia o envio de dados de um para um público que a entrada exclui269* Acesso a um local listado como local de dados sensíveis em seu [ambiente](/docs/pt/auto-mode-config#define-trusted-infrastructure), ou cópia de dados de um. A partir de v2.1.198, isso também bloqueia o envio de dados de um para um público que a entrada exclui

270* Roteamento de uma instalação de pacote em torno de seu registro de pacotes interno para um registro público. {/* min-version: 2.1.198 */}A partir de v2.1.198, isso também se aplica quando você disse a Claude que um registro interno ou espelho existe na conversa, não apenas quando um está listado em seu ambiente270* Roteamento de uma instalação de pacote em torno de seu registro de pacotes interno para um registro público. A partir de v2.1.198, isso também se aplica quando você disse a Claude que um registro interno ou espelho existe na conversa, não apenas quando um está listado em seu ambiente

271* Execução de um comando com um sinalizador que desativa uma proteção de segurança, como `--insecure`271* Execução de um comando com um sinalizador que desativa uma proteção de segurança, como `--insecure`

272* Lançamento de um loop de agente autônomo que executa sem aprovação humana ou sandbox, como um iniciado com `--dangerously-skip-permissions` ou `--no-sandbox`. {/* min-version: 2.1.198 */}A partir de v2.1.198, isso também cobre a execução de um agente de terceiros ou harness de avaliação com isolamento e aprovação por ação desabilitados, como um runner iniciado com `--yes-always`272* Lançamento de um loop de agente autônomo que executa sem aprovação humana ou sandbox, como um iniciado com `--dangerously-skip-permissions` ou `--no-sandbox`. A partir de v2.1.198, isso também cobre a execução de um agente de terceiros ou harness de avaliação com isolamento e aprovação por ação desabilitados, como um runner iniciado com `--yes-always`

273* Ações do [Claude no Chrome](/pt/chrome) que poderiam enviar conteúdo da página, cookies ou credenciais fora da origem273* Ações do [Claude no Chrome](/docs/pt/chrome) que poderiam enviar conteúdo da página, cookies ou credenciais fora da origem

274 274 

275Claude Code v2.1.198 e posterior também bloqueiam estes por padrão:275Claude Code v2.1.198 e posterior também bloqueiam estes por padrão:

276 276 

277* Exclusão de arquivos em `/tmp`, `$TMPDIR` ou outro diretório compartilhado de rascunho ou cache por wildcard, glob ou filtro de idade em vez de por um caminho nomeado específico277* Exclusão de arquivos em `/tmp`, `$TMPDIR` ou outro diretório compartilhado de rascunho ou cache por wildcard, glob ou filtro de idade em vez de por um caminho nomeado específico

278* Inclusão de detalhes sensíveis em conteúdo enviado, carregado, publicado ou escrito para outras pessoas ou sistemas compartilhados, quando sua própria mensagem não autorizou esses detalhes para esse destinatário. {/* min-version: 2.1.200 */}Corpos de PR e issue, mensagens de commit e comentários contam como esse tipo de conteúdo de saída quando o repositório está fora do limite de confiança ou é público, incluindo repositórios públicos de sua própria organização; caminhos de arquivo internos, nomes de código, dados de resposta de API ao vivo, como e-mails ou identificadores de conta, e identificadores de infraestrutura contam como detalhes sensíveis. O escopo de PR, issue e mensagem de commit requer Claude Code v2.1.200 ou posterior. {/* min-version: 2.1.203 */}Dados pessoais ao vivo de uma resposta de API em um corpo de PR ou issue, como um endereço de e-mail, um identificador de conta ou organização, ou uma métrica de uso, requer que você nomeie esses detalhes e o destinatário independentemente da visibilidade ou limite de confiança do repositório. Essa verificação requer Claude Code v2.1.203 ou posterior278* Inclusão de detalhes sensíveis em conteúdo enviado, carregado, publicado ou escrito para outras pessoas ou sistemas compartilhados, quando sua própria mensagem não autorizou esses detalhes para esse destinatário. Corpos de PR e issue, mensagens de commit e comentários contam como esse tipo de conteúdo de saída quando o repositório está fora do limite de confiança ou é público, incluindo repositórios públicos de sua própria organização; caminhos de arquivo internos, nomes de código, dados de resposta de API ao vivo, como e-mails ou identificadores de conta, e identificadores de infraestrutura contam como detalhes sensíveis. O escopo de PR, issue e mensagem de commit requer Claude Code v2.1.200 ou posterior. Dados pessoais ao vivo de uma resposta de API em um corpo de PR ou issue, como um endereço de e-mail, um identificador de conta ou organização, ou uma métrica de uso, requer que você nomeie esses detalhes e o destinatário independentemente da visibilidade ou limite de confiança do repositório. Essa verificação requer Claude Code v2.1.203 ou posterior

279* Envio de pressionamentos de tecla para o próprio painel tmux do Claude Code para conduzir sua própria interface, que o classificador trata como Claude alterando suas próprias permissões ou supervisão279* Envio de pressionamentos de tecla para o próprio painel tmux do Claude Code para conduzir sua própria interface, que o classificador trata como Claude alterando suas próprias permissões ou supervisão

280 280 

281Claude Code v2.1.200 e posterior também bloqueiam estes por padrão:281Claude Code v2.1.200 e posterior também bloqueiam estes por padrão:


284* Exclusão ou desmontagem de um recurso com estado que Claude não criou na sessão, quando nenhuma regra de exclusão mais específica se aplica e você não nomeou esse recurso284* Exclusão ou desmontagem de um recurso com estado que Claude não criou na sessão, quando nenhuma regra de exclusão mais específica se aplica e você não nomeou esse recurso

285* Reorientação de uma URL de base de API, endpoint de proxy, receptor de webhook ou espelho de registro em um host de terceiros que não se encaixa na tarefa, incluindo em arquivos de exemplo como `.env.example`285* Reorientação de uma URL de base de API, endpoint de proxy, receptor de webhook ou espelho de registro em um host de terceiros que não se encaixa na tarefa, incluindo em arquivos de exemplo como `.env.example`

286* Alteração de para onde os pushes vão com `git remote set-url` ou `git remote add`, a menos que você tenha nomeado o novo remote286* Alteração de para onde os pushes vão com `git remote set-url` ou `git remote add`, a menos que você tenha nomeado o novo remote

287* Pushing de segredos ou dados pessoais ou confiados para um repositório conhecido como público, ou pushing de material confidencial lá que não faz parte do próprio trabalho desse repositório. {/* min-version: 2.1.203 */}O próprio assunto de um repositório de dotfiles é a única exceção para dados pessoais ou confiados, e conteúdo de um repositório privado chegando a qualquer superfície pública é bloqueado da mesma forma; ambos os refinamentos requerem Claude Code v2.1.203 ou posterior. Antes de v2.1.203, dados pessoais eram agrupados com material confidencial e bloqueados apenas quando não faziam parte do próprio trabalho desse repositório. Quando a visibilidade de um repositório não é estabelecida, o classificador não bloqueia apenas nisso; ele julga o conteúdo contra as outras regras em vez disso287* Pushing de segredos ou dados pessoais ou confiados para um repositório conhecido como público, ou pushing de material confidencial lá que não faz parte do próprio trabalho desse repositório. O próprio assunto de um repositório de dotfiles é a única exceção para dados pessoais ou confiados, e conteúdo de um repositório privado chegando a qualquer superfície pública é bloqueado da mesma forma; ambos os refinamentos requerem Claude Code v2.1.203 ou posterior. Antes de v2.1.203, dados pessoais eram agrupados com material confidencial e bloqueados apenas quando não faziam parte do próprio trabalho desse repositório. Quando a visibilidade de um repositório não é estabelecida, o classificador não bloqueia apenas nisso; ele julga o conteúdo contra as outras regras em vez disso

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

289 289 

290Claude Code v2.1.203 e posterior também bloqueiam estes por padrão:290Claude Code v2.1.203 e posterior também bloqueiam estes por padrão:


303* Leitura de `.env` e envio de credenciais para sua API correspondente303* Leitura de `.env` e envio de credenciais para sua API correspondente

304* Solicitações HTTP somente leitura304* Solicitações HTTP somente leitura

305* Pushing para o branch em que você começou ou um que Claude criou305* Pushing para o branch em que você começou ou um que Claude criou

306* {/* min-version: 2.1.203 */}Pushes rotineiros para o branch padrão do repositório. Antes de v2.1.203, qualquer push direto para o branch padrão era bloqueado306* Pushes rotineiros para o branch padrão do repositório. Antes de v2.1.203, qualquer push direto para o branch padrão era bloqueado

307 307 

308Claude Code v2.1.195 e posterior também permitem estes por padrão:308Claude Code v2.1.195 e posterior também permitem estes por padrão:

309 309 

310* Exclusão dos trabalhos exatos que Claude criou anteriormente na mesma sessão310* Exclusão dos trabalhos exatos que Claude criou anteriormente na mesma sessão

311* Leitura, revisão ou escrita de código, configs e modelos de ameaça relacionados à segurança como parte de sua tarefa311* Leitura, revisão ou escrita de código, configs e modelos de ameaça relacionados à segurança como parte de sua tarefa

312* Mensagens entre agentes trabalhando juntos na mesma sessão multi-agente312* Mensagens entre agentes trabalhando juntos na mesma sessão multi-agente

313* Envio de dados para os domínios confiáveis, buckets e serviços que você lista em [`environment`](/pt/auto-mode-config#define-trusted-infrastructure). Isso cobre apenas fluxo de dados, não operações destrutivas ou de credencial na mesma infraestrutura313* Envio de dados para os domínios confiáveis, buckets e serviços que você lista em [`environment`](/docs/pt/auto-mode-config#define-trusted-infrastructure). Isso cobre apenas fluxo de dados, não operações destrutivas ou de credencial na mesma infraestrutura

314* [Claude no Chrome](/pt/chrome) navegação para um domínio interno confiável, localhost ou uma URL que você nomeou314* [Claude no Chrome](/docs/pt/chrome) navegação para um domínio interno confiável, localhost ou uma URL que você nomeou

315 315 

316As solicitações de acesso à rede do sandbox são roteadas através do classificador em vez de serem permitidas por padrão. {{/* min-version: 2.1.198 */}}A partir de v2.1.198, o classificador reutiliza seu veredicto para um host e porta de rede em vez de re-executar em cada conexão:316As solicitações de acesso à rede do sandbox são roteadas através do classificador em vez de serem permitidas por padrão. {{/* min-version: 2.1.198 */}}A partir de v2.1.198, o classificador reutiliza seu veredicto para um host e porta de rede em vez de re-executar em cada conexão:

317 317 

318* Um allow é reutilizado até que novo conteúdo entre na conversa, ponto em que esse host é verificado novamente318* Um allow é reutilizado até que novo conteúdo entre na conversa, ponto em que esse host é verificado novamente

319* Na CLI interativa, um deny é descartado quando o turno termina319* Na CLI interativa, um deny é descartado quando o turno termina

320* No [modo não interativo](/pt/headless) e sessões do Agent SDK não há limite de turno, então um deny é reutilizado para o resto da execução320* No [modo não interativo](/docs/pt/headless) e sessões do Agent SDK não há limite de turno, então um deny é reutilizado para o resto da execução

321* Alterar seu modo de permissão ou regras descarta todos os veredictos em cache321* Alterar seu modo de permissão ou regras descarta todos os veredictos em cache

322 322 

323Execute `claude auto-mode defaults` para ver as listas de regras completas. Se ações rotineiras forem bloqueadas, um administrador pode adicionar repos, buckets e serviços confiáveis através da configuração `autoMode.environment`: consulte [Configurar modo automático](/pt/auto-mode-config).323Execute `claude auto-mode defaults` para ver as listas de regras completas. Se ações rotineiras forem bloqueadas, um administrador pode adicionar repos, buckets e serviços confiáveis através da configuração `autoMode.environment`: consulte [Configurar modo automático](/docs/pt/auto-mode-config).

324 324 

325Pushing para seu branch de trabalho, fazendo um push rotineiro para o branch padrão do repositório, e criando uma pull request que corresponde à sua solicitação são executados sem um prompt. O classificador bloqueia um push apenas quando ele carrega risco, como um force push ou conteúdo que contorna uma revisão que você configurou. Para exigir um checkpoint humano antes dessas ações enquanto permanece no modo automático, adicione regras `permissions.ask`: consulte [Limites comuns](/pt/auto-mode-config#common-boundaries).325Pushing para seu branch de trabalho, fazendo um push rotineiro para o branch padrão do repositório, e criando uma pull request que corresponde à sua solicitação são executados sem um prompt. O classificador bloqueia um push apenas quando ele carrega risco, como um force push ou conteúdo que contorna uma revisão que você configurou. Para exigir um checkpoint humano antes dessas ações enquanto permanece no modo automático, adicione regras `permissions.ask`: consulte [Limites comuns](/docs/pt/auto-mode-config#common-boundaries).

326 326 

327<h3 id="boundaries-you-state-in-conversation">327<h3 id="boundaries-you-state-in-conversation">

328 Limites que você declara na conversa328 Limites que você declara na conversa


330 330 

331O classificador trata os limites que você declara na conversa como um sinal de bloqueio. Se você disser a Claude "não faça push" ou "espere até que eu revise antes de implantar", o classificador bloqueia ações correspondentes mesmo quando as regras padrão as permitiriam. Um limite permanece em vigor até que você o levante em uma mensagem posterior. O próprio julgamento do Claude de que uma condição foi atendida não o levanta.331O classificador trata os limites que você declara na conversa como um sinal de bloqueio. Se você disser a Claude "não faça push" ou "espere até que eu revise antes de implantar", o classificador bloqueia ações correspondentes mesmo quando as regras padrão as permitiriam. Um limite permanece em vigor até que você o levante em uma mensagem posterior. O próprio julgamento do Claude de que uma condição foi atendida não o levanta.

332 332 

333Os limites não são armazenados como regras. O classificador os relê da transcrição em cada verificação, então um limite pode ser perdido se a [compactação de contexto](/pt/costs#reduce-token-usage) remover a mensagem que o declarou. Para uma garantia rígida, adicione uma [regra de negação](/pt/permissions#permission-rule-syntax) em vez disso.333Os limites não são armazenados como regras. O classificador os relê da transcrição em cada verificação, então um limite pode ser perdido se a [compactação de contexto](/docs/pt/costs#reduce-token-usage) remover a mensagem que o declarou. Para uma garantia rígida, adicione uma [regra de negação](/docs/pt/permissions#permission-rule-syntax) em vez disso.

334 334 

335<h3 id="when-auto-mode-falls-back">335<h3 id="when-auto-mode-falls-back">

336 Quando o modo automático volta336 Quando o modo automático volta


340 340 

341Se o classificador bloquear uma ação 3 vezes seguidas ou 20 vezes no total, o modo automático pausa e Claude Code retoma o prompt. Aprovar a ação solicitada retoma o modo automático. Esses limites não são configuráveis. Qualquer ação permitida redefine o contador consecutivo, enquanto o contador total persiste para a sessão e redefine apenas quando seu próprio limite dispara um fallback.341Se o classificador bloquear uma ação 3 vezes seguidas ou 20 vezes no total, o modo automático pausa e Claude Code retoma o prompt. Aprovar a ação solicitada retoma o modo automático. Esses limites não são configuráveis. Qualquer ação permitida redefine o contador consecutivo, enquanto o contador total persiste para a sessão e redefine apenas quando seu próprio limite dispara um fallback.

342 342 

343No [modo não interativo](/pt/headless) com a flag `-p`, bloqueios repetidos abortam a sessão, pois não há usuário para solicitar.343No [modo não interativo](/docs/pt/headless) com a flag `-p`, bloqueios repetidos abortam a sessão, pois não há usuário para solicitar.

344 344 

345Bloqueios repetidos geralmente significam que o classificador está perdendo contexto sobre sua infraestrutura. Use `/feedback` para relatar falsos positivos, ou peça a um administrador para [configurar infraestrutura confiável](/pt/auto-mode-config).345Bloqueios repetidos geralmente significam que o classificador está perdendo contexto sobre sua infraestrutura. Use `/feedback` para relatar falsos positivos, ou peça a um administrador para [configurar infraestrutura confiável](/docs/pt/auto-mode-config).

346 346 

347<AccordionGroup>347<AccordionGroup>

348 <Accordion title="Como o classificador avalia ações">348 <Accordion title="Como o classificador avalia ações">

349 Cada ação passa por uma ordem de decisão fixa. O primeiro passo correspondente vence:349 Cada ação passa por uma ordem de decisão fixa. O primeiro passo correspondente vence:

350 350 

351 1. Ações correspondentes a suas [regras de permissão, solicitação ou negação](/pt/permissions#manage-permissions) resolvem imediatamente. Escritas em [caminhos protegidos](#protected-paths) são roteadas para o classificador mesmo quando uma regra de permissão corresponde. Ferramentas de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) o solicitam diretamente mesmo quando uma regra de permissão corresponde. Regras de solicitação com escopo de conteúdo voltam para um prompt de permissão351 1. Ações correspondentes a suas [regras de permissão, solicitação ou negação](/docs/pt/permissions#manage-permissions) resolvem imediatamente. Escritas em [caminhos protegidos](#protected-paths) são roteadas para o classificador mesmo quando uma regra de permissão corresponde. Ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) o solicitam diretamente mesmo quando uma regra de permissão corresponde. Regras de solicitação com escopo de conteúdo voltam para um prompt de permissão

352 2. Ações somente leitura e edições de arquivo em seu diretório de trabalho são auto-aprovadas, exceto escritas em [caminhos protegidos](#protected-paths)352 2. Ações somente leitura e edições de arquivo em seu diretório de trabalho são auto-aprovadas, exceto escritas em [caminhos protegidos](#protected-paths)

353 3. Tudo mais vai para o classificador. Uma ferramenta de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools) pula o classificador e o solicita diretamente, então uma aprovação exigida pela organização nunca é auto-aprovada. {{/* min-version: 2.1.199 */}}A partir de v2.1.199, uma ferramenta MCP marcada com [`_meta["anthropic/requiresUserInteraction"]`](/pt/mcp#require-approval-for-a-specific-tool) também pula o classificador e o solicita diretamente, então uma etapa de consentimento nunca é auto-aprovada em nome do autor da ferramenta353 3. Tudo mais vai para o classificador. Uma ferramenta de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) pula o classificador e o solicita diretamente, então uma aprovação exigida pela organização nunca é auto-aprovada. {{/* min-version: 2.1.199 */}}A partir de v2.1.199, uma ferramenta MCP marcada com [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool) também pula o classificador e o solicita diretamente, então uma etapa de consentimento nunca é auto-aprovada em nome do autor da ferramenta

354 4. Se o classificador bloquear, Claude recebe o motivo e tenta uma alternativa354 4. Se o classificador bloquear, Claude recebe o motivo e tenta uma alternativa

355 355 

356 Ao entrar no modo automático, regras de permissão amplas que concedem execução de código arbitrária são descartadas:356 Ao entrar no modo automático, regras de permissão amplas que concedem execução de código arbitrária são descartadas:


366 </Accordion>366 </Accordion>

367 367 

368 <Accordion title="Como o modo automático lida com subagentes">368 <Accordion title="Como o modo automático lida com subagentes">

369 O classificador verifica o trabalho do [subagente](/pt/sub-agents) em três pontos:369 O classificador verifica o trabalho do [subagente](/docs/pt/sub-agents) em três pontos:

370 370 

371 1. Antes de um subagente começar, a descrição da tarefa delegada é avaliada, então uma tarefa que parece perigosa é bloqueada no tempo de spawn.371 1. Antes de um subagente começar, a descrição da tarefa delegada é avaliada, então uma tarefa que parece perigosa é bloqueada no tempo de spawn.

372 2. Enquanto o subagente executa, cada uma de suas ações passa pelo classificador com as mesmas regras que a sessão pai, e qualquer `permissionMode` no frontmatter do subagente é ignorado.372 2. Enquanto o subagente executa, cada uma de suas ações passa pelo classificador com as mesmas regras que a sessão pai, e qualquer `permissionMode` no frontmatter do subagente é ignorado.


386 Permitir apenas ferramentas pré-aprovadas com modo dontAsk386 Permitir apenas ferramentas pré-aprovadas com modo dontAsk

387</h2>387</h2>

388 388 

389Se você definir o modo `dontAsk`, Claude Code nega automaticamente toda chamada de ferramenta que de outra forma solicitaria confirmação. Claude executa apenas ações que correspondem às suas regras `permissions.allow`, [comandos Bash somente leitura](/pt/permissions#read-only-commands) e chamadas aprovadas por um [hook PreToolUse](/pt/permissions#extend-permissions-with-hooks). Use este modo para pipelines de CI ou ambientes restritos onde você pré-define exatamente o que Claude pode fazer; a sessão nunca aguarda entrada. A barra de status mostra `⏵⏵ don't ask on` enquanto este modo está ativo.389Se você definir o modo `dontAsk`, Claude Code nega automaticamente toda chamada de ferramenta que de outra forma solicitaria confirmação. Claude executa apenas ações que correspondem às suas regras `permissions.allow`, [comandos Bash somente leitura](/docs/pt/permissions#read-only-commands) e chamadas aprovadas por um [hook PreToolUse](/docs/pt/permissions#extend-permissions-with-hooks). Use este modo para pipelines de CI ou ambientes restritos onde você pré-define exatamente o que Claude pode fazer; a sessão nunca aguarda entrada. A barra de status mostra `⏵⏵ don't ask on` enquanto este modo está ativo.

390 390 

391Claude Code nega chamadas que correspondem às suas regras explícitas de [`ask`](/pt/permissions#manage-permissions) em vez de solicitar confirmação. Também nega a ferramenta integrada `AskUserQuestion` e ferramentas de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools), mesmo que suas regras de permissão correspondam a elas. {/* min-version: 2.1.199 */}Nega ferramentas MCP marcadas com [`_meta["anthropic/requiresUserInteraction"]`](/pt/mcp#require-approval-for-a-specific-tool) da mesma forma, porque seu cartão de aprovação precisa de uma resposta que este modo nunca coleta; isso requer Claude Code v2.1.199 ou posterior.391Claude Code nega chamadas que correspondem às suas regras explícitas de [`ask`](/docs/pt/permissions#manage-permissions) em vez de solicitar confirmação. Também nega a ferramenta integrada `AskUserQuestion` e ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), mesmo que suas regras de permissão correspondam a elas. Nega ferramentas MCP marcadas com [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool) da mesma forma, porque seu cartão de aprovação precisa de uma resposta que este modo nunca coleta; isso requer Claude Code v2.1.199 ou posterior.

392 392 

393Sessões em nuvem no [Claude Code na web](/pt/claude-code-on-the-web) ignoram `defaultMode: "dontAsk"`; consulte [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) para detalhes.393Sessões em nuvem no [Claude Code na web](/docs/pt/claude-code-on-the-web) ignoram `defaultMode: "dontAsk"`; consulte [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) para detalhes.

394 394 

395Defina-o na inicialização com a flag:395Defina-o na inicialização com a flag:

396 396 


404 404 

405O modo `bypassPermissions` desativa prompts de permissão e verificações de segurança para que as chamadas de ferramentas sejam executadas imediatamente, incluindo escritas em [caminhos protegidos](#protected-paths). Antes da v2.1.126, escritas em caminhos protegidos ainda solicitavam neste modo.405O modo `bypassPermissions` desativa prompts de permissão e verificações de segurança para que as chamadas de ferramentas sejam executadas imediatamente, incluindo escritas em [caminhos protegidos](#protected-paths). Antes da v2.1.126, escritas em caminhos protegidos ainda solicitavam neste modo.

406 406 

407As [regras ask](/pt/permissions#manage-permissions) explícitas e ferramentas de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools) ainda forçam um prompt neste modo. {/* min-version: 2.1.199 */}Ferramentas MCP marcadas com [`_meta["anthropic/requiresUserInteraction"]`](/pt/mcp#require-approval-for-a-specific-tool) também ainda solicitam; isso requer Claude Code v2.1.199 ou posterior.407As [regras ask](/docs/pt/permissions#manage-permissions) explícitas e ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) ainda forçam um prompt neste modo. Ferramentas MCP marcadas com [`_meta["anthropic/requiresUserInteraction"]`](/docs/pt/mcp#require-approval-for-a-specific-tool) também ainda solicitam; isso requer Claude Code v2.1.199 ou posterior.

408 408 

409Remoções direcionadas à raiz do sistema de arquivos ou diretório inicial, como `rm -rf /` e `rm -rf ~`, ainda solicitam como um disjuntor contra erros do modelo. {/* min-version: 2.1.208 */}O disjuntor também é acionado quando o comando contém substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`, independentemente de a remoção estar dentro da substituição, como em `echo "$(rm -rf ~)"`, ou em outro lugar no mesmo comando. A forma simples, digitada como seu próprio comando, solicitou neste modo desde que o disjuntor foi introduzido; antes da v2.1.208, comandos contendo essas formas não solicitavam.409Remoções direcionadas à raiz do sistema de arquivos ou diretório inicial, como `rm -rf /` e `rm -rf ~`, ainda solicitam como um disjuntor contra erros do modelo. O disjuntor também é acionado quando o comando contém substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`, independentemente de a remoção estar dentro da substituição, como em `echo "$(rm -rf ~)"`, ou em outro lugar no mesmo comando. A forma simples, digitada como seu próprio comando, solicitou neste modo desde que o disjuntor foi introduzido; antes da v2.1.208, comandos contendo essas formas não solicitavam.

410 410 

411<Warning>411<Warning>

412 Use este modo apenas em ambientes isolados como contêineres, VMs ou dev containers sem acesso à internet, onde Claude Code não pode danificar seu sistema host.412 Use este modo apenas em ambientes isolados como contêineres, VMs ou dev containers sem acesso à internet, onde Claude Code não pode danificar seu sistema host.


426--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons426--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

427```427```

428 428 

429A verificação é ignorada automaticamente dentro de uma sandbox reconhecida. Para executar autonomamente em um contêiner, use a configuração [dev container](/pt/devcontainer), que executa Claude Code como um usuário não-root.429A verificação é ignorada automaticamente dentro de uma sandbox reconhecida. Para executar autonomamente em um contêiner, use a configuração [dev container](/docs/pt/devcontainer), que executa Claude Code como um usuário não-root.

430 430 

431[Claude Code na web](/pt/claude-code-on-the-web) não honra `defaultMode: "bypassPermissions"` ou `"dontAsk"` de seus arquivos de configuração, portanto as configurações verificadas de um repositório não podem iniciar uma sessão na nuvem no modo bypass-permissions. A configuração é ignorada silenciosamente e a sessão inicia no modo mostrado no dropdown de modo. Consulte [Alternar modos de permissão](#switch-permission-modes) para saber quais modos as sessões na nuvem oferecem.431[Claude Code na web](/docs/pt/claude-code-on-the-web) não honra `defaultMode: "bypassPermissions"` ou `"dontAsk"` de seus arquivos de configuração, portanto as configurações verificadas de um repositório não podem iniciar uma sessão na nuvem no modo bypass-permissions. A configuração é ignorada silenciosamente e a sessão inicia no modo mostrado no dropdown de modo. Consulte [Alternar modos de permissão](#switch-permission-modes) para saber quais modos as sessões na nuvem oferecem.

432 432 

433<Warning>433<Warning>

434 `bypassPermissions` não oferece proteção contra injeção de prompt ou ações não intencionais. Para verificações de segurança em segundo plano com muito menos prompts de permissão, use [modo automático](#eliminate-prompts-with-auto-mode) em vez disso. Administradores podem bloquear este modo definindo `permissions.disableBypassPermissionsMode` como `"disable"` em [configurações gerenciadas](/pt/permissions#managed-settings).434 `bypassPermissions` não oferece proteção contra injeção de prompt ou ações não intencionais. Para verificações de segurança em segundo plano com muito menos prompts de permissão, use [modo automático](#eliminate-prompts-with-auto-mode) em vez disso. Administradores podem bloquear este modo definindo `permissions.disableBypassPermissionsMode` como `"disable"` em [configurações gerenciadas](/docs/pt/permissions#managed-settings).

435</Warning>435</Warning>

436 436 

437<h2 id="protected-paths">437<h2 id="protected-paths">


447| `dontAsk` | Negado |447| `dontAsk` | Negado |

448| `bypassPermissions` | Permitido |448| `bypassPermissions` | Permitido |

449 449 

450As regras [`permissions.allow`](/pt/permissions#manage-permissions) em arquivos de configuração não pré-aprovam gravações em caminhos protegidos. A verificação de segurança é executada antes de Claude Code avaliar as regras de permissão dos arquivos de configuração, portanto, uma entrada como `Edit(.claude/**)` em `~/.claude/settings.json` ou `.claude/settings.json` não altera o resultado por modo na tabela acima. Nos modos que solicitam, o prompt para uma gravação em `.claude/` oferece **Sim, e permitir que Claude edite suas próprias configurações para esta sessão**, o que aprova gravações posteriores em `.claude/` nessa sessão sem solicitar novamente.450As regras [`permissions.allow`](/docs/pt/permissions#manage-permissions) em arquivos de configuração não pré-aprovam gravações em caminhos protegidos. A verificação de segurança é executada antes de Claude Code avaliar as regras de permissão dos arquivos de configuração, portanto, uma entrada como `Edit(.claude/**)` em `~/.claude/settings.json` ou `.claude/settings.json` não altera o resultado por modo na tabela acima. Nos modos que solicitam, o prompt para uma gravação em `.claude/` oferece **Sim, e permitir que Claude edite suas próprias configurações para esta sessão**, o que aprova gravações posteriores em `.claude/` nessa sessão sem solicitar novamente.

451 451 

452Diretórios protegidos:452Diretórios protegidos:

453 453 


478 Veja também478 Veja também

479</h2>479</h2>

480 480 

481* [Permissões](/pt/permissions): regras de permitir, perguntar e negar; políticas gerenciadas481* [Permissões](/docs/pt/permissions): regras de permitir, perguntar e negar; políticas gerenciadas

482* [Configurar modo automático](/pt/auto-mode-config): informe ao classificador qual infraestrutura sua organização confia482* [Configurar modo automático](/docs/pt/auto-mode-config): informe ao classificador qual infraestrutura sua organização confia

483* [Hooks](/pt/hooks): lógica de permissão personalizada via hooks `PreToolUse` e `PermissionRequest`483* [Hooks](/docs/pt/hooks): lógica de permissão personalizada via hooks `PreToolUse` e `PermissionRequest`

484* [Ultraplan](/pt/ultraplan): execute o modo plan em uma sessão Claude Code na web com revisão baseada em navegador484* [Ultraplan](/docs/pt/ultraplan): execute o modo plan em uma sessão Claude Code na web com revisão baseada em navegador

485* [Segurança](/pt/security): salvaguardas e melhores práticas485* [Segurança](/docs/pt/security): salvaguardas e melhores práticas

486* [Sandboxing](/pt/sandboxing): isolamento de sistema de arquivos e rede para comandos Bash486* [Sandboxing](/docs/pt/sandboxing): isolamento de sistema de arquivos e rede para comandos Bash

487* [Modo não interativo](/pt/headless): execute Claude Code com a flag `-p`487* [Modo não interativo](/docs/pt/headless): execute Claude Code com a flag `-p`

permissions.md +56 −56

Details

22 22 

23Em um prompt de permissão do Bash ou PowerShell, pressione `Ctrl+E` para mostrar uma explicação do comando: o que ele faz, por que Claude está executando-o e o que pode dar errado, rotulado como **Risco baixo**, **Risco médio** ou **Risco alto**. Claude Code envia o comando e a própria descrição de Claude da chamada para o modelo gerar a explicação apenas quando você pressiona `Ctrl+E`, não em cada prompt. Mostrar a explicação não executa o comando; pressione `Ctrl+E` novamente para ocultá-la.23Em um prompt de permissão do Bash ou PowerShell, pressione `Ctrl+E` para mostrar uma explicação do comando: o que ele faz, por que Claude está executando-o e o que pode dar errado, rotulado como **Risco baixo**, **Risco médio** ou **Risco alto**. Claude Code envia o comando e a própria descrição de Claude da chamada para o modelo gerar a explicação apenas quando você pressiona `Ctrl+E`, não em cada prompt. Mostrar a explicação não executa o comando; pressione `Ctrl+E` novamente para ocultá-la.

24 24 

25Para desativar o atalho, defina [`permissionExplainerEnabled`](/pt/settings#global-config-settings) como `false` em `~/.claude.json`.25Para desativar o atalho, defina [`permissionExplainerEnabled`](/docs/pt/settings#global-config-settings) como `false` em `~/.claude.json`.

26 26 

27<h2 id="manage-permissions">27<h2 id="manage-permissions">

28 Gerenciar permissões28 Gerenciar permissões


41As 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ê. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e bloqueia chamadas correspondentes quando Claude tenta usá-las.41As 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ê. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e bloqueia chamadas correspondentes quando Claude tenta usá-las.

42 42 

43<Note>43<Note>

44 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](/pt/permission-modes), ou um [hook PreToolUse](#extend-permissions-with-hooks).44 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).

45</Note>45</Note>

46 46 

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

48 Modos de permissão48 Modos de permissão

49</h2>49</h2>

50 50 

51Claude Code suporta vários modos de permissão que controlam como ele aprova chamadas de ferramentas. Veja [Modos de permissão](/pt/permission-modes) para quando usar cada um. Defina o `defaultMode` em seus [arquivos de configuração](/pt/settings#settings-files):51Claude Code suporta vários modos de permissão que controlam como ele aprova chamadas de ferramentas. Veja [Modos de permissão](/docs/pt/permission-modes) para quando usar cada um. Defina o `defaultMode` em seus [arquivos de configuração](/docs/pt/settings#settings-files):

52 52 

53| Modo | Descrição |53| Modo | Descrição |

54| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |54| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

55| `default` | Comportamento padrão: solicita permissão no primeiro uso de cada ferramenta. {/* min-version: 2.1.200 */}Rotulado como Manual na CLI, nas extensões VS Code e JetBrains, e no aplicativo desktop, e Claude Code aceita `manual` como um alias. O rótulo e o alias requerem Claude Code v2.1.200 ou posterior. O rótulo do aplicativo desktop não depende da sua versão da CLI |55| `default` | Comportamento padrão: solicita permissão no primeiro uso de cada ferramenta. Rotulado como Manual na CLI, nas extensões VS Code e JetBrains, e no aplicativo desktop, e Claude Code aceita `manual` como um alias. O rótulo e o alias requerem Claude Code v2.1.200 ou posterior. O rótulo do aplicativo desktop não depende da sua versão da CLI |

56| `acceptEdits` | Aceita automaticamente edições de arquivo e comandos comuns do sistema de arquivos como `mkdir`, `touch`, `mv` e `cp` para caminhos no diretório de trabalho ou `additionalDirectories` |56| `acceptEdits` | Aceita automaticamente edições de arquivo e comandos comuns do sistema de arquivos como `mkdir`, `touch`, `mv` e `cp` para caminhos no diretório de trabalho ou `additionalDirectories` |

57| `plan` | Claude lê arquivos e executa comandos shell somente leitura para explorar, mas não edita seus arquivos de origem. Rotulado como Plan na CLI e na extensão VS Code |57| `plan` | Claude lê arquivos e executa comandos shell somente leitura para explorar, mas não edita seus arquivos de origem. Rotulado como Plan na CLI e na extensão VS Code |

58| `auto` | Aprova automaticamente chamadas de ferramentas com verificações de segurança em segundo plano que verificam se as ações se alinham com sua solicitação |58| `auto` | Aprova automaticamente chamadas de ferramentas com verificações de segurança em segundo plano que verificam se as ações se alinham com sua solicitação |

59| `dontAsk` | Nega automaticamente ferramentas a menos que pré-aprovadas via `/permissions` ou regras `permissions.allow`. `AskUserQuestion`, ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo se você as permitiu |59| `dontAsk` | Nega automaticamente ferramentas a menos que pré-aprovadas via `/permissions` ou regras `permissions.allow`. `AskUserQuestion`, ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo se você as permitiu |

60| `bypassPermissions` | Ignora prompts de permissão, exceto aqueles forçados por regras `ask` explícitas, ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool). Remoções de diretório raiz e diretório inicial como `rm -rf /` também ainda solicitam como um disjuntor |60| `bypassPermissions` | Ignora prompts de permissão, exceto aqueles forçados por regras `ask` explícitas, ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool). Remoções de diretório raiz e diretório inicial como `rm -rf /` também ainda solicitam como um disjuntor |

61 61 

62<Warning>62<Warning>

63 O modo `bypassPermissions` ignora prompts de permissão, incluindo escritas em `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` e `.mvn`. Use este modo apenas em ambientes isolados como contêineres ou VMs onde Claude Code não pode causar danos.63 O modo `bypassPermissions` ignora prompts de permissão, incluindo escritas em `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` e `.mvn`. Use este modo apenas em ambientes isolados como contêineres ou VMs onde Claude Code não pode causar danos.

64 64 

65 Alguns prompts ainda são acionados neste modo. Regras `ask` explícitas, ferramentas de conector [sua organização definida como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) ainda solicitam. Remoções direcionadas ao diretório raiz do sistema de arquivos ou diretório inicial, como `rm -rf /` e `rm -rf ~`, também solicitam como um disjuntor contra erro do modelo, {/* min-version: 2.1.208 */}incluindo quando o comando contém substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`. Antes da v2.1.208, apenas a forma simples, como `rm -rf ~` digitado como seu próprio comando, solicitava; comandos que chegavam à remoção através de uma substituição não solicitavam.65 Alguns prompts ainda são acionados neste modo. Regras `ask` explícitas, ferramentas de conector [sua organização definida como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) ainda solicitam. Remoções direcionadas ao diretório raiz do sistema de arquivos ou diretório inicial, como `rm -rf /` e `rm -rf ~`, também solicitam como um disjuntor contra erro do modelo, incluindo quando o comando contém substituição de comando com `$(...)` ou backticks, ou substituição de processo com `<(...)`. Antes da v2.1.208, apenas a forma simples, como `rm -rf ~` digitado como seu próprio comando, solicitava; comandos que chegavam à remoção através de uma substituição não solicitavam.

66</Warning>66</Warning>

67 67 

68Para evitar que o modo `bypassPermissions` ou `auto` seja usado, defina `permissions.disableBypassPermissionsMode` ou `permissions.disableAutoMode` como `"disable"` em qualquer [arquivo de configuração](/pt/settings#settings-files). Estes são mais úteis em [configurações gerenciadas](#managed-settings) onde não podem ser substituídos.68Para evitar que o modo `bypassPermissions` ou `auto` seja usado, defina `permissions.disableBypassPermissionsMode` ou `permissions.disableAutoMode` como `"disable"` em qualquer [arquivo de configuração](/docs/pt/settings#settings-files). Estes são mais úteis em [configurações gerenciadas](#managed-settings) onde não podem ser substituídos.

69 69 

70<h2 id="permission-rule-syntax">70<h2 id="permission-rule-syntax">

71 Sintaxe de regra de permissão71 Sintaxe de regra de permissão


117* Cada regra nomeia um parâmetro. Para controlar tanto `model` quanto `isolation`, escreva duas regras, `Agent(model:opus)` e `Agent(isolation:worktree)`, em vez de combiná-las em uma regra117* Cada regra nomeia um parâmetro. Para controlar tanto `model` quanto `isolation`, escreva duas regras, `Agent(model:opus)` e `Agent(isolation:worktree)`, em vez de combiná-las em uma regra

118* O valor suporta `*` como um caractere curinga que corresponde a qualquer sequência de caracteres, portanto `Agent(isolation:*)` corresponde a qualquer valor de isolamento explícito. Sem `*` a correspondência é exata118* O valor suporta `*` como um caractere curinga que corresponde a qualquer sequência de caracteres, portanto `Agent(isolation:*)` corresponde a qualquer valor de isolamento explícito. Sem `*` a correspondência é exata

119* Um parâmetro que o modelo omite nunca é correspondido, portanto `Agent(model:*)` não corresponde a uma chamada que deixa `model` não definido119* Um parâmetro que o modelo omite nunca é correspondido, portanto `Agent(model:*)` não corresponde a uma chamada que deixa `model` não definido

120* O valor é comparado com a entrada literal que Claude envia, antes de qualquer normalização. `Agent(model:opus)` corresponde ao alias `opus` mas não a um ID de modelo completo. Execute com [`--verbose`](/pt/cli-reference) para ver os nomes e valores exatos dos parâmetros em cada chamada de ferramenta120* O valor é comparado com a entrada literal que Claude envia, antes de qualquer normalização. `Agent(model:opus)` corresponde ao alias `opus` mas não a um ID de modelo completo. Execute com [`--verbose`](/docs/pt/cli-reference) para ver os nomes e valores exatos dos parâmetros em cada chamada de ferramenta

121* O espaço em branco ao redor do dois-pontos é ignorado121* O espaço em branco ao redor do dois-pontos é ignorado

122 122 

123Campos que uma ferramenta já corresponde com suas próprias regras de canonicalização não são correspondíveis desta forma: `command` para Bash e PowerShell, `file_path` para Read, Edit e Write, `path` para Grep e Glob, `notebook_path` para NotebookEdit, e `url` para WebFetch. Uma regra como `Bash(command:rm *)` seria contornável por um comando composto, portanto Claude Code a ignora e emite um aviso de inicialização. Use `Bash(rm *)`, `Read(./path)` ou `WebFetch(domain:host)` em vez disso.123Campos que uma ferramenta já corresponde com suas próprias regras de canonicalização não são correspondíveis desta forma: `command` para Bash e PowerShell, `file_path` para Read, Edit e Write, `path` para Grep e Glob, `notebook_path` para NotebookEdit, e `url` para WebFetch. Uma regra como `Bash(command:rm *)` seria contornável por um comando composto, portanto Claude Code a ignora e emite um aviso de inicialização. Use `Bash(rm *)`, `Read(./path)` ou `WebFetch(domain:host)` em vez disso.


169 169 

170Uma regra de negação ou pergunta cujo nome de ferramenta não corresponde a nenhuma ferramenta conhecida produz um aviso de inicialização para detectar erros de digitação. Nomes de ferramentas contendo `_` ou `*` estão isentos da verificação.170Uma regra de negação ou pergunta cujo nome de ferramenta não corresponde a nenhuma ferramenta conhecida produz um aviso de inicialização para detectar erros de digitação. Nomes de ferramentas contendo `_` ou `*` estão isentos da verificação.

171 171 

172O rótulo mostrado para uma ferramenta na transcrição e diálogo de permissão pode diferir do seu nome canônico. Por exemplo, a ferramenta rotulada `Stop Task` na transcrição tem o nome canônico `TaskStop`. As regras de permissão e [correspondências de hook](/pt/hooks) correspondem apenas ao nome canônico, portanto uma regra escrita como `Stop Task` não corresponde. Para regras de negação e pergunta, o aviso de inicialização acima detecta a incompatibilidade. Use os nomes canônicos listados na [referência de ferramentas](/pt/tools-reference).172O rótulo mostrado para uma ferramenta na transcrição e diálogo de permissão pode diferir do seu nome canônico. Por exemplo, a ferramenta rotulada `Stop Task` na transcrição tem o nome canônico `TaskStop`. As regras de permissão e [correspondências de hook](/docs/pt/hooks) correspondem apenas ao nome canônico, portanto uma regra escrita como `Stop Task` não corresponde. Para regras de negação e pergunta, o aviso de inicialização acima detecta a incompatibilidade. Use os nomes canônicos listados na [referência de ferramentas](/docs/pt/tools-reference).

173 173 

174<h2 id="tool-specific-permission-rules">174<h2 id="tool-specific-permission-rules">

175 Regras de permissão específicas da ferramenta175 Regras de permissão específicas da ferramenta


271 Read e Edit271 Read e Edit

272</h3>272</h3>

273 273 

274As regras `Edit` se aplicam a todas as ferramentas integradas que editam arquivos. Claude faz uma tentativa de melhor esforço para aplicar regras `Read` a todas as ferramentas integradas que leem arquivos como Grep e Glob, a menções `@file` em seus prompts, e à seleção e contexto de arquivo aberto que um [IDE](/pt/vs-code#the-built-in-ide-mcp-server) conectado compartilha com Claude.274As regras `Edit` se aplicam a todas as ferramentas integradas que editam arquivos. Claude faz uma tentativa de melhor esforço para aplicar regras `Read` a todas as ferramentas integradas que leem arquivos como Grep e Glob, a menções `@file` em seus prompts, e à seleção e contexto de arquivo aberto que um [IDE](/docs/pt/vs-code#the-built-in-ide-mcp-server) conectado compartilha com Claude.

275 275 

276Uma regra deny `Read` também bloqueia a [ferramenta Edit](/pt/errors#file-is-covered-by-a-read-deny-rule) no mesmo caminho, incluindo criar um novo arquivo lá. Write e NotebookEdit não são cobertos, portanto adicione uma regra deny `Edit` para caminhos que nenhuma ferramenta pode alterar. Requer Claude Code v2.1.208 ou posterior.276Uma regra deny `Read` também bloqueia a [ferramenta Edit](/docs/pt/errors#file-is-covered-by-a-read-deny-rule) no mesmo caminho, incluindo criar um novo arquivo lá. Write e NotebookEdit não são cobertos, portanto adicione uma regra deny `Edit` para caminhos que nenhuma ferramenta pode alterar. Requer Claude Code v2.1.208 ou posterior.

277 277 

278<Warning>278<Warning>

279 As regras deny de Read e Edit se aplicam às ferramentas de arquivo integradas do Claude e aos comandos de arquivo que Claude Code reconhece em Bash, como `cat`, `head`, `tail` e `sed`. Elas não se aplicam a subprocessos arbitrários que leem ou escrevem arquivos indiretamente, como um script Python ou Node que abre arquivos por conta própria. Para imposição em nível de SO que bloqueia todos os processos de acessar um caminho, [ative o sandbox](/pt/sandboxing).279 As regras deny de Read e Edit se aplicam às ferramentas de arquivo integradas do Claude e aos comandos de arquivo que Claude Code reconhece em Bash, como `cat`, `head`, `tail` e `sed`. Elas não se aplicam a subprocessos arbitrários que leem ou escrevem arquivos indiretamente, como um script Python ou Node que abre arquivos por conta própria. Para imposição em nível de SO que bloqueia todos os processos de acessar um caminho, [ative o sandbox](/docs/pt/sandboxing).

280</Warning>280</Warning>

281 281 

282As regras Read e Edit seguem a especificação [gitignore](https://git-scm.com/docs/gitignore) com quatro tipos de padrão distintos:282As regras Read e Edit seguem a especificação [gitignore](https://git-scm.com/docs/gitignore) com quatro tipos de padrão distintos:


352* `mcp__puppeteer__*` usa sintaxe com caracteres curinga e também corresponde a todas as ferramentas do servidor `puppeteer`352* `mcp__puppeteer__*` usa sintaxe com caracteres curinga e também corresponde a todas as ferramentas do servidor `puppeteer`

353* `mcp__puppeteer__puppeteer_navigate` corresponde à ferramenta `puppeteer_navigate` fornecida pelo servidor `puppeteer`353* `mcp__puppeteer__puppeteer_navigate` corresponde à ferramenta `puppeteer_navigate` fornecida pelo servidor `puppeteer`

354 354 

355Se sua organização definiu uma ferramenta [conector claude.ai](/pt/mcp#organization-controls-on-connector-tools) como `ask`, as regras allow para essa ferramenta não entram em vigor: Claude Code solicita em cada chamada, mesmo em modos `auto` e `bypassPermissions`. No modo `dontAsk`, que nunca solicita, Claude Code nega a chamada em vez disso. As ferramentas de conector aparecem como `mcp__claude_ai_<server>__<tool>`.355Se sua organização definiu uma ferramenta [conector claude.ai](/docs/pt/mcp#organization-controls-on-connector-tools) como `ask`, as regras allow para essa ferramenta não entram em vigor: Claude Code solicita em cada chamada, mesmo em modos `auto` e `bypassPermissions`. No modo `dontAsk`, que nunca solicita, Claude Code nega a chamada em vez disso. As ferramentas de conector aparecem como `mcp__claude_ai_<server>__<tool>`.

356 356 

357<h3 id="agent-subagents">357<h3 id="agent-subagents">

358 Agent (subagents)358 Agent (subagents)

359</h3>359</h3>

360 360 

361Use regras `Agent(AgentName)` para controlar quais [subagents](/pt/sub-agents) Claude pode usar:361Use regras `Agent(AgentName)` para controlar quais [subagents](/docs/pt/sub-agents) Claude pode usar:

362 362 

363* `Agent(Explore)` corresponde ao subagent Explore363* `Agent(Explore)` corresponde ao subagent Explore

364* `Agent(Plan)` corresponde ao subagent Plan364* `Agent(Plan)` corresponde ao subagent Plan


378 Cd378 Cd

379</h3>379</h3>

380 380 

381As regras `Cd` controlam para quais diretórios o [comando `/cd`](/pt/commands) pode mover a sessão. `Cd` não é uma ferramenta invocável pelo modelo: Claude não pode chamá-la, e as regras se aplicam apenas quando você executa `/cd` você mesmo.381As regras `Cd` controlam para quais diretórios o [comando `/cd`](/docs/pt/commands) pode mover a sessão. `Cd` não é uma ferramenta invocável pelo modelo: Claude não pode chamá-la, e as regras se aplicam apenas quando você executa `/cd` você mesmo.

382 382 

383Uma regra deny `Cd` simples desabilita `/cd` inteiramente. Uma regra deny `Cd(<path-pattern>)` bloqueia alvos correspondentes. As regras deny verificam cada grafia do alvo, incluindo cada salto de symlink que ele se resolve através, portanto uma regra escrita para um caminho também bloqueia alvos que se resolvem para ele.383Uma regra deny `Cd` simples desabilita `/cd` inteiramente. Uma regra deny `Cd(<path-pattern>)` bloqueia alvos correspondentes. As regras deny verificam cada grafia do alvo, incluindo cada salto de symlink que ele se resolve através, portanto uma regra escrita para um caminho também bloqueia alvos que se resolvem para ele.

384 384 


396 Estender permissões com hooks396 Estender permissões com hooks

397</h2>397</h2>

398 398 

399Os [hooks do Claude Code](/pt/hooks-guide) fornecem uma maneira de registrar comandos de shell personalizados para realizar avaliação de permissão em tempo de execução. Quando Claude Code faz uma chamada de ferramenta, os hooks PreToolUse são executados antes do prompt de permissão. A saída do hook pode negar a chamada de ferramenta, forçar um prompt ou pular o prompt para deixar a chamada prosseguir.399Os [hooks do Claude Code](/docs/pt/hooks-guide) fornecem uma maneira de registrar comandos de shell personalizados para realizar avaliação de permissão em tempo de execução. Quando Claude Code faz uma chamada de ferramenta, os hooks PreToolUse são executados antes do prompt de permissão. A saída do hook pode negar a chamada de ferramenta, forçar um prompt ou pular o prompt para deixar a chamada prosseguir.

400 400 

401As decisões do hook não contornam as regras de permissão. Claude Code avalia regras deny e ask independentemente do que um hook PreToolUse retorna: uma regra deny correspondente bloqueia a chamada, e uma regra ask correspondente ainda solicita mesmo quando o hook retornou `"allow"` ou `"ask"`. Isto preserva a precedência deny-first descrita em [Gerenciar permissões](#manage-permissions), incluindo regras deny definidas em configurações gerenciadas.401As decisões do hook não contornam as regras de permissão. Claude Code avalia regras deny e ask independentemente do que um hook PreToolUse retorna: uma regra deny correspondente bloqueia a chamada, e uma regra ask correspondente ainda solicita mesmo quando o hook retornou `"allow"` ou `"ask"`. Isto preserva a precedência deny-first descrita em [Gerenciar permissões](#manage-permissions), incluindo regras deny definidas em configurações gerenciadas.

402 402 

403As ferramentas Connector que [sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas como [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) também ainda solicitam quando um hook retorna `"allow"`.403As ferramentas Connector que [sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e ferramentas MCP marcadas como [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) também ainda solicitam quando um hook retorna `"allow"`.

404 404 

405Um hook de bloqueio também tem precedência sobre regras allow. Um hook que sai com código 2 interrompe a chamada de ferramenta antes das regras de permissão serem avaliadas, portanto o bloqueio se aplica mesmo quando uma regra allow permitiria a chamada. Para executar todos os comandos Bash sem prompts exceto por alguns que você quer bloqueados, adicione `"Bash"` à sua lista allow e registre um hook PreToolUse que rejeita esses comandos específicos. Veja [Bloquear edições em arquivos protegidos](/pt/hooks-guide#block-edits-to-protected-files) para um script de hook que você pode adaptar.405Um hook de bloqueio também tem precedência sobre regras allow. Um hook que sai com código 2 interrompe a chamada de ferramenta antes das regras de permissão serem avaliadas, portanto o bloqueio se aplica mesmo quando uma regra allow permitiria a chamada. Para executar todos os comandos Bash sem prompts exceto por alguns que você quer bloqueados, adicione `"Bash"` à sua lista allow e registre um hook PreToolUse que rejeita esses comandos específicos. Veja [Bloquear edições em arquivos protegidos](/docs/pt/hooks-guide#block-edits-to-protected-files) para um script de hook que você pode adaptar.

406 406 

407<h2 id="working-directories">407<h2 id="working-directories">

408 Diretórios de trabalho408 Diretórios de trabalho


412 412 

413* **Durante a inicialização**: use o argumento CLI `--add-dir <path>`413* **Durante a inicialização**: use o argumento CLI `--add-dir <path>`

414* **Durante a sessão**: use o comando `/add-dir`414* **Durante a sessão**: use o comando `/add-dir`

415* **Configuração persistente**: adicione a `additionalDirectories` em [arquivos de configuração](/pt/settings#settings-files)415* **Configuração persistente**: adicione a `additionalDirectories` em [arquivos de configuração](/docs/pt/settings#settings-files)

416 416 

417Arquivos em diretórios adicionais seguem as mesmas regras de permissão do diretório de trabalho original: eles se tornam legíveis sem prompts, e as permissões de edição de arquivo seguem o modo de permissão atual.417Arquivos em diretórios adicionais seguem as mesmas regras de permissão do diretório de trabalho original: eles se tornam legíveis sem prompts, e as permissões de edição de arquivo seguem o modo de permissão atual.

418 418 

419Em sessões em segundo plano no macOS, o host da sessão solicita acesso a pastas protegidas como `~/Desktop`, `~/Documents` e `~/Downloads` separadamente do seu terminal quando Claude precisa ler ou escrever arquivos lá; se as leituras falharem com `Operation not permitted`, consulte [como conceder acesso a pastas para sessões em segundo plano](/pt/agent-view#background-sessions-can't-read-desktop-documents-or-downloads-on-macos).419Em sessões em segundo plano no macOS, o host da sessão solicita acesso a pastas protegidas como `~/Desktop`, `~/Documents` e `~/Downloads` separadamente do seu terminal quando Claude precisa ler ou escrever arquivos lá; se as leituras falharem com `Operation not permitted`, consulte [como conceder acesso a pastas para sessões em segundo plano](/docs/pt/agent-view#background-sessions-can't-read-desktop-documents-or-downloads-on-macos).

420 420 

421Para alterar o diretório de trabalho primário da sessão em vez de adicionar outro, use [`/cd`](/pt/commands). O comando `/cd` requer Claude Code v2.1.169 ou posterior. Diferentemente de `/add-dir`, ele realoca a sessão: o `CLAUDE.md` do novo diretório é carregado e `--resume` encontra a sessão a partir daí.421Para alterar o diretório de trabalho primário da sessão em vez de adicionar outro, use [`/cd`](/docs/pt/commands). O comando `/cd` requer Claude Code v2.1.169 ou posterior. Diferentemente de `/add-dir`, ele realoca a sessão: o `CLAUDE.md` do novo diretório é carregado e `--resume` encontra a sessão a partir daí.

422 422 

423<h3 id="additional-directories-grant-file-access-not-configuration">423<h3 id="additional-directories-grant-file-access-not-configuration">

424 Diretórios adicionais concedem acesso a arquivos, não configuração424 Diretórios adicionais concedem acesso a arquivos, não configuração


432 432 

433| Configuração | Carregado de `--add-dir` |433| Configuração | Carregado de `--add-dir` |

434| :--------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |434| :--------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

435| [Skills](/pt/skills) em `.claude/skills/` | Sim, com recarga ao vivo |435| [Skills](/docs/pt/skills) em `.claude/skills/` | Sim, com recarga ao vivo |

436| [Subagentes](/pt/sub-agents) em `.claude/agents/` | Sim |436| [Subagentes](/docs/pt/sub-agents) em `.claude/agents/` | Sim |

437| [Configurações](/pt/settings) em `.claude/settings.json` e `.claude/settings.local.json` | Apenas chaves `enabledPlugins` e `extraKnownMarketplaces` |437| [Configurações](/docs/pt/settings) em `.claude/settings.json` e `.claude/settings.local.json` | Apenas chaves `enabledPlugins` e `extraKnownMarketplaces` |

438| Arquivos [CLAUDE.md](/pt/memory), `.claude/rules/` e `CLAUDE.local.md` | Apenas quando `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` está definido. `CLAUDE.local.md` adicionalmente requer a fonte de configuração `local`, que é ativada por padrão |438| Arquivos [CLAUDE.md](/docs/pt/memory), `.claude/rules/` e `CLAUDE.local.md` | Apenas quando `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` está definido. `CLAUDE.local.md` adicionalmente requer a fonte de configuração `local`, que é ativada por padrão |

439 439 

440Comandos e estilos de saída são descobertos do diretório de trabalho atual e seus pais, seu diretório de usuário em `~/.claude/` e configurações gerenciadas. Hooks e outras chaves `settings.json` são carregadas da pasta `.claude/` do diretório de trabalho atual sem fallback de diretório pai, juntamente com seu `~/.claude/settings.json` de usuário e configurações gerenciadas. Para compartilhar essa configuração entre projetos, use uma destas abordagens:440Comandos e estilos de saída são descobertos do diretório de trabalho atual e seus pais, seu diretório de usuário em `~/.claude/` e configurações gerenciadas. Hooks e outras chaves `settings.json` são carregadas da pasta `.claude/` do diretório de trabalho atual sem fallback de diretório pai, juntamente com seu `~/.claude/settings.json` de usuário e configurações gerenciadas. Para compartilhar essa configuração entre projetos, use uma destas abordagens:

441 441 

442* **Configuração em nível de usuário**: coloque arquivos em `~/.claude/agents/`, `~/.claude/output-styles/` ou `~/.claude/settings.json` para torná-los disponíveis em cada projeto442* **Configuração em nível de usuário**: coloque arquivos em `~/.claude/agents/`, `~/.claude/output-styles/` ou `~/.claude/settings.json` para torná-los disponíveis em cada projeto

443* **Plugins**: empacote e distribua configuração como um [plugin](/pt/plugins) que as equipes podem instalar443* **Plugins**: empacote e distribua configuração como um [plugin](/docs/pt/plugins) que as equipes podem instalar

444* **Inicie do diretório de configuração**: execute Claude Code do diretório contendo a configuração `.claude/` que você deseja444* **Inicie do diretório de configuração**: execute Claude Code do diretório contendo a configuração `.claude/` que você deseja

445 445 

446<h2 id="how-permissions-interact-with-sandboxing">446<h2 id="how-permissions-interact-with-sandboxing">

447 Como as permissões interagem com sandboxing447 Como as permissões interagem com sandboxing

448</h2>448</h2>

449 449 

450Permissões e [sandboxing](/pt/sandboxing) são camadas de segurança complementares:450Permissões e [sandboxing](/docs/pt/sandboxing) são camadas de segurança complementares:

451 451 

452* **Permissões** controlam quais ferramentas Claude Code pode usar e quais arquivos ou domínios pode acessar. Elas se aplicam a todas as ferramentas, incluindo Bash, Read, Edit, WebFetch e MCP.452* **Permissões** controlam quais ferramentas Claude Code pode usar e quais arquivos ou domínios pode acessar. Elas se aplicam a todas as ferramentas, incluindo Bash, Read, Edit, WebFetch e MCP.

453* **Sandboxing** fornece imposição em nível de SO que restringe o acesso do Bash à rede e sistema de arquivos. Aplica-se apenas a comandos Bash e seus processos filhos.453* **Sandboxing** fornece imposição em nível de SO que restringe o acesso do Bash à rede e sistema de arquivos. Aplica-se apenas a comandos Bash e seus processos filhos.


456 456 

457* As regras deny de permissão bloqueiam Claude de até tentar acessar recursos restritos457* As regras deny de permissão bloqueiam Claude de até tentar acessar recursos restritos

458* As restrições de sandbox impedem que comandos Bash alcancem recursos fora dos limites definidos, mesmo se uma injeção de prompt contornar a tomada de decisão de Claude458* As restrições de sandbox impedem que comandos Bash alcancem recursos fora dos limites definidos, mesmo se uma injeção de prompt contornar a tomada de decisão de Claude

459* As restrições de sistema de arquivos no sandbox combinam as configurações [`sandbox.filesystem`](/pt/sandboxing) com regras deny de Read e Edit; ambas são mescladas no limite final do sandbox459* As restrições de sistema de arquivos no sandbox combinam as configurações [`sandbox.filesystem`](/docs/pt/sandboxing) com regras deny de Read e Edit; ambas são mescladas no limite final do sandbox

460* As restrições de rede combinam regras de permissão WebFetch com as listas `allowedDomains` e `deniedDomains` do sandbox460* As restrições de rede combinam regras de permissão WebFetch com as listas `allowedDomains` e `deniedDomains` do sandbox

461 461 

462Quando o sandboxing é ativado com `autoAllowBashIfSandboxed: true`, que é o padrão, comandos Bash em sandbox são executados sem solicitar mesmo se suas permissões incluem uma regra ask simples `Bash`, ou o [formulário equivalente `Bash(*)`](#match-all-uses-of-a-tool): o limite do sandbox substitui esse prompt de ferramenta inteira. Estas verificações ainda se aplicam:462Quando o sandboxing é ativado com `autoAllowBashIfSandboxed: true`, que é o padrão, comandos Bash em sandbox são executados sem solicitar mesmo se suas permissões incluem uma regra ask simples `Bash`, ou o [formulário equivalente `Bash(*)`](#match-all-uses-of-a-tool): o limite do sandbox substitui esse prompt de ferramenta inteira. Estas verificações ainda se aplicam:


465* Regras deny explícitas ainda se aplicam465* Regras deny explícitas ainda se aplicam

466* Comandos `rm` ou `rmdir` que visam `/`, seu diretório inicial ou outros caminhos críticos do sistema ainda acionam um prompt466* Comandos `rm` ou `rmdir` que visam `/`, seu diretório inicial ou outros caminhos críticos do sistema ainda acionam um prompt

467 467 

468Comandos que não serão executados em sandbox, como comandos excluídos, respeitam a regra ask simples `Bash` como de costume. Veja [modos de sandbox](/pt/sandboxing#sandbox-modes) para alterar este comportamento.468Comandos que não serão executados em sandbox, como comandos excluídos, respeitam a regra ask simples `Bash` como de costume. Veja [modos de sandbox](/docs/pt/sandboxing#sandbox-modes) para alterar este comportamento.

469 469 

470<h2 id="managed-settings">470<h2 id="managed-settings">

471 Configurações gerenciadas471 Configurações gerenciadas

472</h2>472</h2>

473 473 

474Para organizações que precisam de controle centralizado sobre a configuração do Claude Code, administradores podem implantar configurações gerenciadas que não podem ser substituídas por configurações de usuário ou projeto. Estas configurações de política seguem o mesmo formato que arquivos de configuração regulares e podem ser entregues através de políticas MDM/nível de SO, arquivos de configuração gerenciados, [configurações gerenciadas por servidor](/pt/server-managed-settings), ou um [gateway de aplicativos Claude](/pt/claude-apps-gateway) auto-hospedado. Veja [arquivos de configuração](/pt/settings#settings-files) para mecanismos de entrega e locais de arquivo.474Para organizações que precisam de controle centralizado sobre a configuração do Claude Code, administradores podem implantar configurações gerenciadas que não podem ser substituídas por configurações de usuário ou projeto. Estas configurações de política seguem o mesmo formato que arquivos de configuração regulares e podem ser entregues através de políticas MDM/nível de SO, arquivos de configuração gerenciados, [configurações gerenciadas por servidor](/docs/pt/server-managed-settings), ou um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado. Veja [arquivos de configuração](/docs/pt/settings#settings-files) para mecanismos de entrega e locais de arquivo.

475 475 

476<h3 id="managed-only-settings">476<h3 id="managed-only-settings">

477 Configurações apenas gerenciadas477 Configurações apenas gerenciadas


480As seguintes configurações são lidas apenas de configurações gerenciadas. Colocá-las em arquivos de configuração de usuário ou projeto não tem efeito.480As seguintes configurações são lidas apenas de configurações gerenciadas. Colocá-las em arquivos de configuração de usuário ou projeto não tem efeito.

481 481 

482| Configuração | Descrição |482| Configuração | Descrição |

483| :--------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |483| :--------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

484| `allowAllClaudeAiMcps` | Quando `true`, conectores claude.ai carregam junto com um `managed-mcp.json` implantado em vez de serem suprimidos por seu controle exclusivo. Veja [Configuração MCP gerenciada](/pt/managed-mcp) |484| `allowAllClaudeAiMcps` | Quando `true`, conectores claude.ai carregam junto com um `managed-mcp.json` implantado em vez de serem suprimidos por seu controle exclusivo. Veja [Configuração MCP gerenciada](/docs/pt/managed-mcp) |

485| `allowedChannelPlugins` | Lista de permissão de plugins de canal que podem enviar mensagens. Substitui a lista de permissão padrão da Anthropic quando definida. Requer `channelsEnabled: true`. Veja [Restringir quais plugins de canal podem ser executados](/pt/channels#restrict-which-channel-plugins-can-run) |485| `allowedChannelPlugins` | Lista de permissão de plugins de canal que podem enviar mensagens. Substitui a lista de permissão padrão da Anthropic quando definida. Requer `channelsEnabled: true`. Veja [Restringir quais plugins de canal podem ser executados](/docs/pt/channels#restrict-which-channel-plugins-can-run) |

486| `allowManagedHooksOnly` | Quando `true`, apenas hooks gerenciados, hooks SDK e hooks de plugins força-ativados em configurações gerenciadas `enabledPlugins` são carregados. Hooks de usuário, projeto e todos os outros plugins são bloqueados |486| `allowManagedHooksOnly` | Quando `true`, apenas hooks gerenciados, hooks SDK e hooks de plugins força-ativados em configurações gerenciadas `enabledPlugins` são carregados. Hooks de usuário, projeto e todos os outros plugins são bloqueados |

487| `allowManagedMcpServersOnly` | Quando `true`, apenas `allowedMcpServers` de configurações gerenciadas são respeitados. `deniedMcpServers` ainda se mescla de todas as fontes. Veja [Configuração MCP gerenciada](/pt/managed-mcp) |487| `allowManagedMcpServersOnly` | Quando `true`, apenas `allowedMcpServers` de configurações gerenciadas são respeitados. `deniedMcpServers` ainda se mescla de todas as fontes. Veja [Configuração MCP gerenciada](/docs/pt/managed-mcp) |

488| `allowManagedPermissionRulesOnly` | Quando `true`, impede que configurações de usuário e projeto definam regras de permissão `allow`, `ask` ou `deny`. Apenas regras em configurações gerenciadas se aplicam. Não afeta a lista de permissão do servidor MCP; para isso, defina `allowManagedMcpServersOnly` |488| `allowManagedPermissionRulesOnly` | Quando `true`, impede que configurações de usuário e projeto definam regras de permissão `allow`, `ask` ou `deny`. Apenas regras em configurações gerenciadas se aplicam. Não afeta a lista de permissão do servidor MCP; para isso, defina `allowManagedMcpServersOnly` |

489| `blockedMarketplaces` | Lista de bloqueio de fontes de marketplace. Fontes bloqueadas são verificadas antes do download, portanto nunca tocam o sistema de arquivos. Veja [restrições de marketplace gerenciadas](/pt/plugin-marketplaces#managed-marketplace-restrictions) |489| `blockedMarketplaces` | Lista de bloqueio de fontes de marketplace. Fontes bloqueadas são verificadas antes do download, portanto nunca tocam o sistema de arquivos. Veja [restrições de marketplace gerenciadas](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) |

490| `channelsEnabled` | Permitir [channels](/pt/channels) para a organização. Veja [controles empresariais](/pt/channels#enterprise-controls) para o padrão em cada plano |490| `channelsEnabled` | Permitir [channels](/docs/pt/channels) para a organização. Veja [controles empresariais](/docs/pt/channels#enterprise-controls) para o padrão em cada plano |

491| `disableSideloadFlags` | {/* min-version: 2.1.193 */}Rejeitar os sinalizadores CLI `--plugin-dir`, `--plugin-url`, `--agents` e `--mcp-config` na inicialização. Sem isso, os usuários podem contornar `strictKnownMarketplaces` para uma única execução passando esses sinalizadores. Veja [`disableSideloadFlags`](/pt/settings#available-settings). Requer Claude Code v2.1.193 ou posterior |491| `disableSideloadFlags` | Rejeitar os sinalizadores CLI `--plugin-dir`, `--plugin-url`, `--agents` e `--mcp-config` na inicialização. Sem isso, os usuários podem contornar `strictKnownMarketplaces` para uma única execução passando esses sinalizadores. Veja [`disableSideloadFlags`](/docs/pt/settings#available-settings). Requer Claude Code v2.1.193 ou posterior |

492| `forceRemoteSettingsRefresh` | Quando `true`, bloqueia a inicialização da CLI até que as configurações gerenciadas remotas sejam buscadas recentemente e sai se a busca falhar. Veja [imposição fail-closed](/pt/server-managed-settings#enforce-fail-closed-startup) |492| `forceRemoteSettingsRefresh` | Quando `true`, bloqueia a inicialização da CLI até que as configurações gerenciadas remotas sejam buscadas recentemente e sai se a busca falhar. Veja [imposição fail-closed](/docs/pt/server-managed-settings#enforce-fail-closed-startup) |

493| `pluginTrustMessage` | Mensagem personalizada anexada ao aviso de confiança de plugin mostrado antes da instalação |493| `pluginTrustMessage` | Mensagem personalizada anexada ao aviso de confiança de plugin mostrado antes da instalação |

494| `sandbox.filesystem.allowManagedReadPathsOnly` | Quando `true`, apenas caminhos `filesystem.allowRead` de configurações gerenciadas são respeitados. `denyRead` ainda se mescla de todas as fontes |494| `sandbox.filesystem.allowManagedReadPathsOnly` | Quando `true`, apenas caminhos `filesystem.allowRead` de configurações gerenciadas são respeitados. `denyRead` ainda se mescla de todas as fontes |

495| `sandbox.network.allowManagedDomainsOnly` | Quando `true`, apenas `allowedDomains` e regras allow `WebFetch(domain:...)` de configurações gerenciadas são respeitados. Domínios não permitidos são bloqueados automaticamente sem solicitar ao usuário. Domínios negados ainda se mesclam de todas as fontes |495| `sandbox.network.allowManagedDomainsOnly` | Quando `true`, apenas `allowedDomains` e regras allow `WebFetch(domain:...)` de configurações gerenciadas são respeitados. Domínios não permitidos são bloqueados automaticamente sem solicitar ao usuário. Domínios negados ainda se mesclam de todas as fontes |

496| `strictKnownMarketplaces` | Controla quais marketplaces de plugin os usuários podem adicionar e instalar plugins. Veja [restrições de marketplace gerenciadas](/pt/plugin-marketplaces#managed-marketplace-restrictions) |496| `strictKnownMarketplaces` | Controla quais marketplaces de plugin os usuários podem adicionar e instalar plugins. Veja [restrições de marketplace gerenciadas](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) |

497| `strictPluginOnlyCustomization` | Bloqueia skills, agents, hooks e servidores MCP de fontes de usuário e projeto, para que possam vir apenas de plugins ou configurações gerenciadas. `true` bloqueia todas as quatro superfícies; um array como `["skills", "hooks"]` bloqueia apenas as nomeadas. Veja [`strictPluginOnlyCustomization`](/pt/settings#strictpluginonlycustomization) |497| `strictPluginOnlyCustomization` | Bloqueia skills, agents, hooks e servidores MCP de fontes de usuário e projeto, para que possam vir apenas de plugins ou configurações gerenciadas. `true` bloqueia todas as quatro superfícies; um array como `["skills", "hooks"]` bloqueia apenas as nomeadas. Veja [`strictPluginOnlyCustomization`](/docs/pt/settings#strictpluginonlycustomization) |

498| `wslInheritsWindowsSettings` | Quando `true` na chave de registro HKLM do Windows ou `C:\Program Files\ClaudeCode\managed-settings.json`, WSL lê configurações gerenciadas da cadeia de política do Windows além de `/etc/claude-code`. Veja [Arquivos de configuração](/pt/settings#settings-files) |498| `wslInheritsWindowsSettings` | Quando `true` na chave de registro HKLM do Windows ou `C:\Program Files\ClaudeCode\managed-settings.json`, WSL lê configurações gerenciadas da cadeia de política do Windows além de `/etc/claude-code`. Veja [Arquivos de configuração](/docs/pt/settings#settings-files) |

499 499 

500`disableBypassPermissionsMode` é tipicamente colocado em configurações gerenciadas para impor política organizacional, mas funciona de qualquer escopo. Um usuário pode defini-lo em suas próprias configurações para se bloquear do modo bypass.500`disableBypassPermissionsMode` é tipicamente colocado em configurações gerenciadas para impor política organizacional, mas funciona de qualquer escopo. Um usuário pode defini-lo em suas próprias configurações para se bloquear do modo bypass.

501 501 

502<Note>502<Note>

503 Em planos Team e Enterprise, um Owner ativa ou desativa [Remote Control](/pt/remote-control) e [sessões web](/pt/claude-code-on-the-web) em toda a organização em [configurações de admin do Claude Code](https://claude.ai/admin-settings/claude-code). Remote Control pode ser adicionalmente desativado por dispositivo com a configuração [`disableRemoteControl`](/pt/settings#available-settings). Sessões web não têm chave de configurações gerenciadas por dispositivo.503 Em planos Team e Enterprise, um Owner ativa ou desativa [Remote Control](/docs/pt/remote-control) e [sessões web](/docs/pt/claude-code-on-the-web) em toda a organização em [configurações de admin do Claude Code](https://claude.ai/admin-settings/claude-code). Remote Control pode ser adicionalmente desativado por dispositivo com a configuração [`disableRemoteControl`](/docs/pt/settings#available-settings). Sessões web não têm chave de configurações gerenciadas por dispositivo.

504</Note>504</Note>

505 505 

506<h2 id="settings-precedence">506<h2 id="settings-precedence">

507 Precedência de configurações507 Precedência de configurações

508</h2>508</h2>

509 509 

510As regras de permissão seguem a mesma [precedência de configurações](/pt/settings#settings-precedence) que todas as outras configurações do Claude Code:510As regras de permissão seguem a mesma [precedência de configurações](/docs/pt/settings#settings-precedence) que todas as outras configurações do Claude Code:

511 511 

5121. **Configurações gerenciadas**: não podem ser substituídas por nenhum outro nível, incluindo argumentos de linha de comando5121. **Configurações gerenciadas**: não podem ser substituídas por nenhum outro nível, incluindo argumentos de linha de comando

5132. **Argumentos de linha de comando**: substituições de sessão temporária5132. **Argumentos de linha de comando**: substituições de sessão temporária


519 519 

520O mesmo se aplica entre escopos de configurações: se as configurações de usuário permitirem uma permissão e as configurações de projeto a negarem, a regra de negação a bloqueia. O inverso também é verdadeiro: uma negação no nível de usuário bloqueia uma permissão no nível de projeto, porque as regras de negação de qualquer escopo são avaliadas antes das regras de permissão.520O mesmo se aplica entre escopos de configurações: se as configurações de usuário permitirem uma permissão e as configurações de projeto a negarem, a regra de negação a bloqueia. O inverso também é verdadeiro: uma negação no nível de usuário bloqueia uma permissão no nível de projeto, porque as regras de negação de qualquer escopo são avaliadas antes das regras de permissão.

521 521 

522Os hosts de incorporação podem fornecer política gerenciada adicional por meio da opção `managedSettings` do SDK quando [`parentSettingsBehavior`](/pt/settings#settings-precedence) está definido como `"merge"`; os valores do incorporador podem apertar a política, mas não afrouxá-la.522Os hosts de incorporação podem fornecer política gerenciada adicional por meio da opção `managedSettings` do SDK quando [`parentSettingsBehavior`](/docs/pt/settings#settings-precedence) está definido como `"merge"`; os valores do incorporador podem apertar a política, mas não afrouxá-la.

523 523 

524<h2 id="project-allow-rules-and-workspace-trust">524<h2 id="project-allow-rules-and-workspace-trust">

525 Regras de permissão do projeto e confiança do workspace525 Regras de permissão do projeto e confiança do workspace

526</h2>526</h2>

527 527 

528As regras `permissions.allow` e as entradas `permissions.additionalDirectories` no `.claude/settings.json` de um projeto concedem capacidade, portanto Claude Code as aplica apenas após você aceitar o [diálogo de confiança do workspace](/pt/security#additional-safeguards) para esse workspace. Até então, Claude Code lê as regras mas não as aplica. O diálogo de confiança lista as regras de permissão e diretórios adicionais que a pasta concederia para que você possa revisá-los antes de aceitar. As regras `deny` e `ask` não são afetadas, pois apenas restringem.528As regras `permissions.allow` e as entradas `permissions.additionalDirectories` no `.claude/settings.json` de um projeto concedem capacidade, portanto Claude Code as aplica apenas após você aceitar o [diálogo de confiança do workspace](/docs/pt/security#additional-safeguards) para esse workspace. Até então, Claude Code lê as regras mas não as aplica. O diálogo de confiança lista as regras de permissão e diretórios adicionais que a pasta concederia para que você possa revisá-los antes de aceitar. As regras `deny` e `ask` não são afetadas, pois apenas restringem.

529 529 

530Claude Code salva a confiança por workspace, usando como chave a raiz do repositório git ou, fora de um repositório, o diretório a partir do qual você iniciou Claude Code. Quando você inicia no seu diretório inicial, a confiança é mantida apenas para a sessão atual e não é gravada em disco; consulte a nota sobre [salvaguardas adicionais](/pt/security#additional-safeguards). Confiar em um diretório pai não aplica as regras de permissão de um projeto aninhado.530Claude Code salva a confiança por workspace, usando como chave a raiz do repositório git ou, fora de um repositório, o diretório a partir do qual você iniciou Claude Code. Quando você inicia no seu diretório inicial, a confiança é mantida apenas para a sessão atual e não é gravada em disco; consulte a nota sobre [salvaguardas adicionais](/docs/pt/security#additional-safeguards). Confiar em um diretório pai não aplica as regras de permissão de um projeto aninhado.

531 531 

532`.claude/settings.local.json` é seu próprio arquivo, portanto a verificação de confiança do workspace geralmente não se aplica a ele. Quando um repositório poderia ter fornecido o arquivo, como quando ele é confirmado no git ou `.claude` é um symlink, suas regras de permissão e diretórios adicionais passam pela verificação de confiança como as configurações do projeto.532`.claude/settings.local.json` é seu próprio arquivo, portanto a verificação de confiança do workspace geralmente não se aplica a ele. Quando um repositório poderia ter fornecido o arquivo, como quando ele é confirmado no git ou `.claude` é um symlink, suas regras de permissão e diretórios adicionais passam pela verificação de confiança como as configurações do projeto.

533 533 


536As regras de permissão e diretórios adicionais em `.claude/settings.local.json` também se aplicam sem confiança do workspace em dois casos:536As regras de permissão e diretórios adicionais em `.claude/settings.local.json` também se aplicam sem confiança do workspace em dois casos:

537 537 

538* O diretório a partir do qual você iniciou Claude Code não está dentro de um repositório git.538* O diretório a partir do qual você iniciou Claude Code não está dentro de um repositório git.

539* A sessão é executada no seu diretório de configuração pessoal: seu diretório inicial ou qualquer diretório cujo subdiretório `.claude` você tenha definido como [`CLAUDE_CONFIG_DIR`](/pt/env-vars).539* A sessão é executada no seu diretório de configuração pessoal: seu diretório inicial ou qualquer diretório cujo subdiretório `.claude` você tenha definido como [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars).

540 540 

541Em ambos os casos, o arquivo é um que você criou em vez de um que um repositório poderia ter fornecido, e um `.claude/settings.local.json` confirmado no repositório ainda requer confiança do workspace. As versões 2.1.196 a 2.1.199 tratavam o arquivo como fornecido pelo repositório nesses workspaces, ignoravam suas regras de permissão e imprimiam um aviso [`this workspace has not been trusted`](/pt/errors#workspace-has-not-been-trusted) para stderr. As duas exceções acima correspondem à v2.1.195 e anteriores e foram restauradas na v2.1.200.541Em ambos os casos, o arquivo é um que você criou em vez de um que um repositório poderia ter fornecido, e um `.claude/settings.local.json` confirmado no repositório ainda requer confiança do workspace. As versões 2.1.196 a 2.1.199 tratavam o arquivo como fornecido pelo repositório nesses workspaces, ignoravam suas regras de permissão e imprimiam um aviso [`this workspace has not been trusted`](/docs/pt/errors#workspace-has-not-been-trusted) para stderr. As duas exceções acima correspondem à v2.1.195 e anteriores e foram restauradas na v2.1.200.

542 542 

543Também a partir da v2.1.200, um workspace cujas regras de permissão ou diretórios adicionais ainda não são aplicados, mas que nunca mostrou o diálogo de confiança porque um diretório pai já era confiável, mostra o diálogo na próxima vez que você inicia Claude Code lá interativamente. O diálogo oferece duas opções:543Também a partir da v2.1.200, um workspace cujas regras de permissão ou diretórios adicionais ainda não são aplicados, mas que nunca mostrou o diálogo de confiança porque um diretório pai já era confiável, mostra o diálogo na próxima vez que você inicia Claude Code lá interativamente. O diálogo oferece duas opções:

544 544 

545* **Yes, I trust this folder**: salva a confiança para esse workspace e aplica as regras na mesma sessão.545* **Yes, I trust this folder**: salva a confiança para esse workspace e aplica as regras na mesma sessão.

546* **No, continue without these permissions**: continua funcionando com essas regras ignoradas. O diálogo aparece novamente na próxima sessão.546* **No, continue without these permissions**: continua funcionando com essas regras ignoradas. O diálogo aparece novamente na próxima sessão.

547 547 

548No [modo não interativo](/pt/headless) com `-p`, nenhum diálogo aparece e as regras permanecem ignoradas.548No [modo não interativo](/docs/pt/headless) com `-p`, nenhum diálogo aparece e as regras permanecem ignoradas.

549 549 

550<h2 id="example-configurations">550<h2 id="example-configurations">

551 Configurações de exemplo551 Configurações de exemplo


557 Veja também557 Veja também

558</h2>558</h2>

559 559 

560* [Settings](/pt/settings): referência de configuração completa incluindo a tabela de configurações de permissão560* [Settings](/docs/pt/settings): referência de configuração completa incluindo a tabela de configurações de permissão

561* [Configure auto mode](/pt/auto-mode-config): diga ao classificador do modo auto qual infraestrutura sua organização confia561* [Configure auto mode](/docs/pt/auto-mode-config): diga ao classificador do modo auto qual infraestrutura sua organização confia

562* [Sandboxing](/pt/sandboxing): isolamento de rede e sistema de arquivos em nível de SO para comandos Bash562* [Sandboxing](/docs/pt/sandboxing): isolamento de rede e sistema de arquivos em nível de SO para comandos Bash

563* [Authentication](/pt/authentication): configure o acesso do usuário ao Claude Code563* [Authentication](/docs/pt/authentication): configure o acesso do usuário ao Claude Code

564* [Security](/pt/security): salvaguardas de segurança e melhores práticas564* [Security](/docs/pt/security): salvaguardas de segurança e melhores práticas

565* [Hooks](/pt/hooks-guide): automatize fluxos de trabalho e estenda avaliação de permissão565* [Hooks](/docs/pt/hooks-guide): automatize fluxos de trabalho e estenda avaliação de permissão

plugin-hints.md +7 −7

Details

10 10 

11Claude Code remove a linha de dica da saída do comando antes de enviá-la ao modelo, portanto o marcador nunca aparece na conversa e não é contado para o uso de tokens. O protocolo não requer comandos extras e não altera o que sua CLI imprime para usuários fora do Claude Code.11Claude Code remove a linha de dica da saída do comando antes de enviá-la ao modelo, portanto o marcador nunca aparece na conversa e não é contado para o uso de tokens. O protocolo não requer comandos extras e não altera o que sua CLI imprime para usuários fora do Claude Code.

12 12 

13Esta página é para mantenedores de CLI e SDK. Se você está procurando instalar plugins, consulte [Descobrir e instalar plugins](/pt/discover-plugins).13Esta página é para mantenedores de CLI e SDK. Se você está procurando instalar plugins, consulte [Descobrir e instalar plugins](/docs/pt/discover-plugins).

14 14 

15<h2 id="how-it-works">15<h2 id="how-it-works">

16 Como funciona16 Como funciona

17</h2>17</h2>

18 18 

19Claude Code define a variável de ambiente [`CLAUDECODE`](/pt/env-vars) como `1` para cada comando que executa através das ferramentas Bash e PowerShell, e para comandos de [hook](/pt/hooks). {/* min-version: 2.1.172 */}A partir da v2.1.172, também define [`CLAUDE_CODE_CHILD_SESSION`](/pt/env-vars) como `1` nesses mesmos subprocessos. Quando sua CLI vê uma dessas variáveis, ela escreve uma tag auto-fechável `<claude-code-hint />` para stderr. Em comandos de hook, a tag de dica é removida e ignorada. Apenas a saída das ferramentas Bash e PowerShell dispara o prompt de instalação.19Claude Code define a variável de ambiente [`CLAUDECODE`](/docs/pt/env-vars) como `1` para cada comando que executa através das ferramentas Bash e PowerShell, e para comandos de [hook](/docs/pt/hooks). A partir da v2.1.172, também define [`CLAUDE_CODE_CHILD_SESSION`](/docs/pt/env-vars) como `1` nesses mesmos subprocessos. Quando sua CLI vê uma dessas variáveis, ela escreve uma tag auto-fechável `<claude-code-hint />` para stderr. Em comandos de hook, a tag de dica é removida e ignorada. Apenas a saída das ferramentas Bash e PowerShell dispara o prompt de instalação.

20 20 

21Quando Claude Code recebe a saída do comando, ele:21Quando Claude Code recebe a saída do comando, ele:

22 22 


36Gate a emissão em uma variável de ambiente para que o marcador seja improvável de aparecer quando um humano executa seu CLI diretamente, depois escreva a tag para stderr em sua própria linha. Escolha qual variável verificar:36Gate a emissão em uma variável de ambiente para que o marcador seja improvável de aparecer quando um humano executa seu CLI diretamente, depois escreva a tag para stderr em sua própria linha. Escolha qual variável verificar:

37 37 

38* `CLAUDECODE`: definida em todas as versões do Claude Code, portanto atinge a maioria das sessões. Também é definida em sessões tmux e subprocessos do servidor MCP stdio que Claude Code inicia. Extensões IDE também a definem em seus terminais integrados, onde um humano pode estar executando seu CLI diretamente.38* `CLAUDECODE`: definida em todas as versões do Claude Code, portanto atinge a maioria das sessões. Também é definida em sessões tmux e subprocessos do servidor MCP stdio que Claude Code inicia. Extensões IDE também a definem em seus terminais integrados, onde um humano pode estar executando seu CLI diretamente.

39* {/* min-version: 2.1.172 */}`CLAUDE_CODE_CHILD_SESSION`: definida apenas em subprocessos que o próprio Claude Code gera, como chamadas de ferramenta, comandos hook e comandos da [linha de status](/pt/statusline), portanto a tag normalmente não atinge um terminal humano. Um processo de longa duração que foi iniciado dentro de uma sessão, como um servidor tmux, captura a variável, portanto shells iniciados posteriormente a partir desse processo ainda mostram a tag bruta. Requer Claude Code v2.1.172 ou posterior, portanto sessões em versões mais antigas perdem a dica.39* `CLAUDE_CODE_CHILD_SESSION`: definida apenas em subprocessos que o próprio Claude Code gera, como chamadas de ferramenta, comandos hook e comandos da [linha de status](/docs/pt/statusline), portanto a tag normalmente não atinge um terminal humano. Um processo de longa duração que foi iniciado dentro de uma sessão, como um servidor tmux, captura a variável, portanto shells iniciados posteriormente a partir desse processo ainda mostram a tag bruta. Requer Claude Code v2.1.172 ou posterior, portanto sessões em versões mais antigas perdem a dica.

40 40 

41Os exemplos a seguir fazem gate em `CLAUDECODE` para máximo alcance e emitem uma dica para um plugin chamado `example-cli` no marketplace oficial:41Os exemplos a seguir fazem gate em `CLAUDECODE` para máximo alcance e emitem uma dica para um plugin chamado `example-cli` no marketplace oficial:

42 42 


158 Coloque seu plugin no marketplace oficial158 Coloque seu plugin no marketplace oficial

159</h2>159</h2>

160 160 

161O protocolo de dica só entra em vigor para plugins listados no marketplace oficial da Anthropic, `claude-plugins-official`. A Anthropic cura esse marketplace a seu critério, e os formulários de envio no aplicativo adicionam plugins ao [marketplace da comunidade](/pt/plugins#submit-your-plugin-to-the-community-marketplace), que o protocolo de dica não verifica. Se você está trabalhando com um contato de parceiro da Anthropic, entre em contato com ele para coordenar uma listagem no marketplace oficial.161O protocolo de dica só entra em vigor para plugins listados no marketplace oficial da Anthropic, `claude-plugins-official`. A Anthropic cura esse marketplace a seu critério, e os formulários de envio no aplicativo adicionam plugins ao [marketplace da comunidade](/docs/pt/plugins#submit-your-plugin-to-the-community-marketplace), que o protocolo de dica não verifica. Se você está trabalhando com um contato de parceiro da Anthropic, entre em contato com ele para coordenar uma listagem no marketplace oficial.

162 162 

163<h2 id="see-also">163<h2 id="see-also">

164 Veja também164 Veja também

165</h2>165</h2>

166 166 

167* [Criar plugins](/pt/plugins): construa o plugin que sua CLI recomenda167* [Criar plugins](/docs/pt/plugins): construa o plugin que sua CLI recomenda

168* [Criar e distribuir um marketplace de plugins](/pt/plugin-marketplaces): hospede plugins fora do marketplace oficial168* [Criar e distribuir um marketplace de plugins](/docs/pt/plugin-marketplaces): hospede plugins fora do marketplace oficial

169* [Variáveis de ambiente](/pt/env-vars): referência completa para `CLAUDECODE` e variáveis relacionadas169* [Variáveis de ambiente](/docs/pt/env-vars): referência completa para `CLAUDECODE` e variáveis relacionadas

Details

8 8 

9Um **marketplace de plugins** é um catálogo que permite distribuir plugins para outros. Os marketplaces fornecem descoberta centralizada, rastreamento de versão, atualizações automáticas e suporte para múltiplos tipos de fonte, incluindo repositórios git e caminhos locais. Este guia mostra como criar seu próprio marketplace para compartilhar plugins com sua equipe ou comunidade.9Um **marketplace de plugins** é um catálogo que permite distribuir plugins para outros. Os marketplaces fornecem descoberta centralizada, rastreamento de versão, atualizações automáticas e suporte para múltiplos tipos de fonte, incluindo repositórios git e caminhos locais. Este guia mostra como criar seu próprio marketplace para compartilhar plugins com sua equipe ou comunidade.

10 10 

11Procurando instalar plugins de um marketplace existente? Veja [Descobrir e instalar plugins pré-construídos](/pt/discover-plugins).11Procurando instalar plugins de um marketplace existente? Veja [Descobrir e instalar plugins pré-construídos](/docs/pt/discover-plugins).

12 12 

13<h2 id="overview">13<h2 id="overview">

14 Visão geral14 Visão geral


16 16 

17Criar e distribuir um marketplace envolve:17Criar e distribuir um marketplace envolve:

18 18 

191. **Criar plugins**: construir um ou mais plugins com skills, agents, hooks, MCP servers ou LSP servers. Este guia assume que você já tem plugins para distribuir; veja [Criar plugins](/pt/plugins) para detalhes sobre como criá-los.191. **Criar plugins**: construir um ou mais plugins com skills, agents, hooks, MCP servers ou LSP servers. Este guia assume que você já tem plugins para distribuir; veja [Criar plugins](/docs/pt/plugins) para detalhes sobre como criá-los.

202. **Criar o arquivo de marketplace**: definir um `marketplace.json` que lista seus plugins e onde encontrá-los. Veja [Criar o arquivo de marketplace](#create-the-marketplace-file).202. **Criar o arquivo de marketplace**: definir um `marketplace.json` que lista seus plugins e onde encontrá-los. Veja [Criar o arquivo de marketplace](#create-the-marketplace-file).

213. **Hospedar o marketplace**: fazer push para GitHub, GitLab ou outro host git. Veja [Hospedar e distribuir marketplaces](#host-and-distribute-marketplaces).213. **Hospedar o marketplace**: fazer push para GitHub, GitLab ou outro host git. Veja [Hospedar e distribuir marketplaces](#host-and-distribute-marketplaces).

224. **Compartilhar com usuários**: usuários adicionam seu marketplace com `/plugin marketplace add` e instalam plugins individuais. Veja [Descobrir e instalar plugins](/pt/discover-plugins).224. **Compartilhar com usuários**: usuários adicionam seu marketplace com `/plugin marketplace add` e instalam plugins individuais. Veja [Descobrir e instalar plugins](/docs/pt/discover-plugins).

23 23 

24Depois que seu marketplace estiver ativo, você pode atualizá-lo fazendo push de alterações para seu repositório. Os usuários atualizam sua cópia local com `/plugin marketplace update`.24Depois que seu marketplace estiver ativo, você pode atualizá-lo fazendo push de alterações para seu repositório. Os usuários atualizam sua cópia local com `/plugin marketplace update`.

25 25 


110 </Step>110 </Step>

111</Steps>111</Steps>

112 112 

113Para saber mais sobre o que os plugins podem fazer, incluindo hooks, agents, MCP servers e LSP servers, veja [Plugins](/pt/plugins).113Para saber mais sobre o que os plugins podem fazer, incluindo hooks, agents, MCP servers e LSP servers, veja [Plugins](/docs/pt/plugins).

114 114 

115<Note>115<Note>

116 **Como os plugins são instalados**: Quando os usuários instalam um plugin, Claude Code copia o diretório do plugin para um local de cache. Isso significa que os plugins não podem referenciar arquivos fora de seu diretório usando caminhos como `../shared-utils`, porque esses arquivos não serão copiados.116 **Como os plugins são instalados**: Quando os usuários instalam um plugin, Claude Code copia o diretório do plugin para um local de cache. Isso significa que os plugins não podem referenciar arquivos fora de seu diretório usando caminhos como `../shared-utils`, porque esses arquivos não serão copiados.

117 117 

118 Se você precisar compartilhar arquivos entre plugins, use symlinks. Veja [Plugin caching and file resolution](/pt/plugins-reference#plugin-caching-and-file-resolution) para detalhes.118 Se você precisar compartilhar arquivos entre plugins, use symlinks. Veja [Plugin caching and file resolution](/docs/pt/plugins-reference#plugin-caching-and-file-resolution) para detalhes.

119</Note>119</Note>

120 120 

121<h2 id="create-the-marketplace-file">121<h2 id="create-the-marketplace-file">


172<Note>172<Note>

173 **Nomes reservados**: os seguintes nomes de marketplace são reservados para uso oficial da Anthropic e não podem ser usados por marketplaces de terceiros: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Nomes que imitam marketplaces oficiais, como `official-claude-plugins` ou `anthropic-plugins-v2`, também são bloqueados. Reservar esses nomes impede que um marketplace de terceiros se apresente como uma fonte publicada pela Anthropic.173 **Nomes reservados**: os seguintes nomes de marketplace são reservados para uso oficial da Anthropic e não podem ser usados por marketplaces de terceiros: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Nomes que imitam marketplaces oficiais, como `official-claude-plugins` ou `anthropic-plugins-v2`, também são bloqueados. Reservar esses nomes impede que um marketplace de terceiros se apresente como uma fonte publicada pela Anthropic.

174 174 

175 Claude Code verifica novamente os nomes reservados toda vez que carrega um marketplace, não apenas quando você adiciona um. Um marketplace que foi registrado sob um desses nomes antes do nome se tornar reservado para de carregar e relata que está [registrado de uma fonte não confiável](/pt/errors#marketplace-is-registered-from-an-untrusted-source). Remova esse marketplace e adicione-o novamente da fonte oficial da Anthropic. Um marketplace de terceiros afetado por um nome recém-reservado carrega novamente assim que você o adiciona novamente sob um nome diferente. Antes da v2.1.205, `first-party-plugins` e `healthcare` não eram reservados, e um marketplace já registrado sob um nome reservado continuava carregando.175 Claude Code verifica novamente os nomes reservados toda vez que carrega um marketplace, não apenas quando você adiciona um. Um marketplace que foi registrado sob um desses nomes antes do nome se tornar reservado para de carregar e relata que está [registrado de uma fonte não confiável](/docs/pt/errors#marketplace-is-registered-from-an-untrusted-source). Remova esse marketplace e adicione-o novamente da fonte oficial da Anthropic. Um marketplace de terceiros afetado por um nome recém-reservado carrega novamente assim que você o adiciona novamente sob um nome diferente. Antes da v2.1.205, `first-party-plugins` e `healthcare` não eram reservados, e um marketplace já registrado sob um nome reservado continuava carregando.

176</Note>176</Note>

177 177 

178<h3 id="owner-fields">178<h3 id="owner-fields">


189</h3>189</h3>

190 190 

191| Campo | Tipo | Descrição |191| Campo | Tipo | Descrição |

192| :------------------------------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |192| :------------------------------------ | :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

193| `$schema` | string | URL do JSON Schema para autocompletar e validação do editor. Claude Code ignora este campo no momento do carregamento. |193| `$schema` | string | URL do JSON Schema para autocompletar e validação do editor. Claude Code ignora este campo no momento do carregamento. |

194| `description` | string | Breve descrição do marketplace |194| `description` | string | Breve descrição do marketplace |

195| `version` | string | Versão do manifesto do marketplace |195| `version` | string | Versão do manifesto do marketplace |

196| `metadata.pluginRoot` | string | Diretório base adicionado aos caminhos de fonte de plugin relativos (por exemplo, `"./plugins"` permite escrever `"source": "formatter"` em vez de `"source": "./plugins/formatter"`) |196| `metadata.pluginRoot` | string | Diretório base adicionado aos caminhos de fonte de plugin relativos (por exemplo, `"./plugins"` permite escrever `"source": "formatter"` em vez de `"source": "./plugins/formatter"`) |

197| `allowCrossMarketplaceDependenciesOn` | array | Outros marketplaces que plugins neste marketplace podem depender. Dependências de um marketplace não listado aqui são bloqueadas na instalação. Veja [Depender de um plugin de outro marketplace](/pt/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |197| `allowCrossMarketplaceDependenciesOn` | array | Outros marketplaces que plugins neste marketplace podem depender. Dependências de um marketplace não listado aqui são bloqueadas na instalação. Veja [Depender de um plugin de outro marketplace](/docs/pt/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |

198| `renames` | object | {/* min-version: 2.1.193 */}Mapa de um antigo `name` de plugin para seu nome atual, ou para `null` se o plugin foi removido. Permite que usuários existentes migrem automaticamente quando você renomeia ou remove uma entrada em `plugins`. Veja [Renomear ou remover um plugin](#rename-or-remove-a-plugin). Requer Claude Code v2.1.193 ou posterior. |198| `renames` | object | Mapa de um antigo `name` de plugin para seu nome atual, ou para `null` se o plugin foi removido. Permite que usuários existentes migrem automaticamente quando você renomeia ou remove uma entrada em `plugins`. Veja [Renomear ou remover um plugin](#rename-or-remove-a-plugin). Requer Claude Code v2.1.193 ou posterior. |

199 199 

200`description` e `version` também são aceitos sob `metadata` para compatibilidade com versões anteriores.200`description` e `version` também são aceitos sob `metadata` para compatibilidade com versões anteriores.

201 201 


203 Entradas de plugin203 Entradas de plugin

204</h2>204</h2>

205 205 

206Cada entrada de plugin no array `plugins` descreve um plugin e onde encontrá-lo. Você pode incluir qualquer campo do [esquema de manifesto de plugin](/pt/plugins-reference#plugin-manifest-schema), como `description`, `version`, `author`, `commands` e `hooks`, além destes campos específicos do marketplace: `source`, `category`, `tags`, `strict` e `relevance`.206Cada entrada de plugin no array `plugins` descreve um plugin e onde encontrá-lo. Você pode incluir qualquer campo do [esquema de manifesto de plugin](/docs/pt/plugins-reference#plugin-manifest-schema), como `description`, `version`, `author`, `commands` e `hooks`, além destes campos específicos do marketplace: `source`, `category`, `tags`, `strict` e `relevance`.

207 207 

208<h3 id="required-fields-2">208<h3 id="required-fields-2">

209 Campos obrigatórios209 Campos obrigatórios


221**Campos de metadados padrão:**221**Campos de metadados padrão:**

222 222 

223| Campo | Tipo | Descrição |223| Campo | Tipo | Descrição |

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

225| `displayName` | string | {/* min-version: 2.1.143 */}Nome legível por humanos exibido em superfícies de UI. Volta para `name` quando omitido. Pode conter espaços e qualquer capitalização. Não é usado para namespacing ou lookup. Requer Claude Code v2.1.143 ou posterior. |225| `displayName` | string | Nome legível por humanos exibido em superfícies de UI. Volta para `name` quando omitido. Pode conter espaços e qualquer capitalização. Não é usado para namespacing ou lookup. Requer Claude Code v2.1.143 ou posterior. |

226| `description` | string | Breve descrição do plugin |226| `description` | string | Breve descrição do plugin |

227| `version` | string | Versão do plugin. Se definido (aqui ou em `plugin.json`), o plugin é fixado a esta string e os usuários recebem atualizações apenas quando ela muda. Omita para usar o SHA do commit do git. Veja [Resolução de versão](#version-resolution-and-release-channels). |227| `version` | string | Versão do plugin. Se definido (aqui ou em `plugin.json`), o plugin é fixado a esta string e os usuários recebem atualizações apenas quando ela muda. Omita para usar o SHA do commit do git. Veja [Resolução de versão](#version-resolution-and-release-channels). |

228| `author` | object | Informações do autor do plugin (`name` obrigatório, `email` opcional) |228| `author` | object | Informações do autor do plugin (`name` obrigatório, `email` opcional) |


233| `category` | string | Categoria do plugin para organização |233| `category` | string | Categoria do plugin para organização |

234| `tags` | array | Tags para pesquisabilidade |234| `tags` | array | Tags para pesquisabilidade |

235| `strict` | boolean | Controla se `plugin.json` é a autoridade para definições de componentes (padrão: true). Veja [Strict mode](#strict-mode) abaixo. |235| `strict` | boolean | Controla se `plugin.json` é a autoridade para definições de componentes (padrão: true). Veja [Strict mode](#strict-mode) abaixo. |

236| `relevance` | object | {/* min-version: 2.1.152 */}Sinais que informam ao Claude Code quando sugerir este plugin aos usuários. Tem efeito apenas para marketplaces que um administrador coloca na lista de permissões em configurações gerenciadas. Veja [Recomendar plugins para sua organização](/pt/plugin-relevance). Requer Claude Code v2.1.152 ou posterior. |236| `relevance` | object | Sinais que informam ao Claude Code quando sugerir este plugin aos usuários. Tem efeito apenas para marketplaces que um administrador coloca na lista de permissões em configurações gerenciadas. Veja [Recomendar plugins para sua organização](/docs/pt/plugin-relevance). Requer Claude Code v2.1.152 ou posterior. |

237| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Se o plugin está habilitado após a instalação (padrão: true). Defina como `false` para instalar o plugin desabilitado até que o usuário opte por ativá-lo. Tem precedência sobre o mesmo campo no `plugin.json` do plugin. Veja [Default enablement](/pt/plugins-reference#default-enablement). Requer Claude Code v2.1.154 ou posterior. |237| `defaultEnabled` | boolean | Se o plugin está habilitado após a instalação (padrão: true). Defina como `false` para instalar o plugin desabilitado até que o usuário opte por ativá-lo. Tem precedência sobre o mesmo campo no `plugin.json` do plugin. Veja [Default enablement](/docs/pt/plugins-reference#default-enablement). Requer Claude Code v2.1.154 ou posterior. |

238 238 

239**Campos de configuração de componentes:**239**Campos de configuração de componentes:**

240 240 


510 510 

511* **`commands` e `agents`**: você pode especificar múltiplos diretórios ou arquivos individuais. Os caminhos são relativos à raiz do plugin.511* **`commands` e `agents`**: você pode especificar múltiplos diretórios ou arquivos individuais. Os caminhos são relativos à raiz do plugin.

512* **`${CLAUDE_PLUGIN_ROOT}`**: use esta variável em hooks e configurações de MCP server para referenciar arquivos dentro do diretório de instalação do plugin. Isso é necessário porque os plugins são copiados para um local de cache quando instalados.512* **`${CLAUDE_PLUGIN_ROOT}`**: use esta variável em hooks e configurações de MCP server para referenciar arquivos dentro do diretório de instalação do plugin. Isso é necessário porque os plugins são copiados para um local de cache quando instalados.

513 * Veja a [tabela de substituição](/pt/plugins-reference#environment-variables) para quais campos de configuração a substituem por tipo de servidor513 * Veja a [tabela de substituição](/docs/pt/plugins-reference#environment-variables) para quais campos de configuração a substituem por tipo de servidor

514 * Para dependências ou estado que devem sobreviver a atualizações de plugin, use [`${CLAUDE_PLUGIN_DATA}`](/pt/plugins-reference#persistent-data-directory) em vez disso514 * Para dependências ou estado que devem sobreviver a atualizações de plugin, use [`${CLAUDE_PLUGIN_DATA}`](/docs/pt/plugins-reference#persistent-data-directory) em vez disso

515* **`strict: false`**: como isso está definido como false, o plugin não precisa de seu próprio `plugin.json`. A entrada de marketplace define tudo. Veja [Strict mode](#strict-mode) abaixo.515* **`strict: false`**: como isso está definido como false, o plugin não precisa de seu próprio `plugin.json`. A entrada de marketplace define tudo. Veja [Strict mode](#strict-mode) abaixo.

516 516 

517Por padrão, as skills de um plugin são carregadas do diretório `skills/` sob sua `source`. Os caminhos listados no campo `skills` adicionam a essa varredura:517Por padrão, as skills de um plugin são carregadas do diretório `skills/` sob sua `source`. Os caminhos listados no campo `skills` adicionam a essa varredura:


575 Repositórios privados575 Repositórios privados

576</h3>576</h3>

577 577 

578Claude Code suporta instalar plugins de repositórios privados. Para instalação manual e atualizações, Claude Code usa seus ajudantes de credencial git existentes, então acesso HTTPS via `gh auth login`, Keychain do macOS ou `git-credential-store` funciona da mesma forma que em seu terminal. Acesso SSH funciona desde que o host já esteja em seu arquivo `known_hosts` e a chave esteja carregada em `ssh-agent`, já que Claude Code suprime prompts SSH interativos para a impressão digital do host e passphrase da chave. O atalho `owner/repo` do GitHub clona por SSH por padrão; defina [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/pt/env-vars#variables) para cloná-los via HTTPS em vez disso.578Claude Code suporta instalar plugins de repositórios privados. Para instalação manual e atualizações, Claude Code usa seus ajudantes de credencial git existentes, então acesso HTTPS via `gh auth login`, Keychain do macOS ou `git-credential-store` funciona da mesma forma que em seu terminal. Acesso SSH funciona desde que o host já esteja em seu arquivo `known_hosts` e a chave esteja carregada em `ssh-agent`, já que Claude Code suprime prompts SSH interativos para a impressão digital do host e passphrase da chave. O atalho `owner/repo` do GitHub clona por SSH por padrão; defina [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/pt/env-vars#variables) para cloná-los via HTTPS em vez disso.

579 579 

580As atualizações automáticas em segundo plano funcionam de forma diferente. Por padrão, a atualização em segundo plano desabilita ajudantes de credencial git para seu `git pull`, então o pull não consegue autenticar em repositórios privados via HTTPS mesmo quando um ajudante está configurado. Remotos SSH não são afetados: uma chave carregada em `ssh-agent` autentica pulls em segundo plano da mesma forma que operações manuais. Quando o pull em segundo plano falha, Claude Code volta a re-clonar o marketplace do zero. O re-clone usa suas credenciais git armazenadas, mas pode [expirar em repositórios grandes](#git-operations-time-out), então atualizações automáticas de marketplace privado podem falhar intermitentemente.580As atualizações automáticas em segundo plano funcionam de forma diferente. Por padrão, a atualização em segundo plano desabilita ajudantes de credencial git para seu `git pull`, então o pull não consegue autenticar em repositórios privados via HTTPS mesmo quando um ajudante está configurado. Remotos SSH não são afetados: uma chave carregada em `ssh-agent` autentica pulls em segundo plano da mesma forma que operações manuais. Quando o pull em segundo plano falha, Claude Code volta a re-clonar o marketplace do zero. O re-clone usa suas credenciais git armazenadas, mas pode [expirar em repositórios grandes](#git-operations-time-out), então atualizações automáticas de marketplace privado podem falhar intermitentemente.

581 581 


619/plugin install quality-review-plugin@my-plugins619/plugin install quality-review-plugin@my-plugins

620```620```

621 621 

622Para a gama completa de comandos add (GitHub, URLs Git, caminhos locais, URLs remotas), veja [Adicionar marketplaces](/pt/discover-plugins#add-marketplaces).622Para a gama completa de comandos add (GitHub, URLs Git, caminhos locais, URLs remotas), veja [Adicionar marketplaces](/docs/pt/discover-plugins#add-marketplaces).

623 623 

624<h3 id="require-marketplaces-for-your-team">624<h3 id="require-marketplaces-for-your-team">

625 Exigir marketplaces para sua equipe625 Exigir marketplaces para sua equipe


651}651}

652```652```

653 653 

654Para opções de configuração completas, veja [Plugin settings](/pt/settings#plugin-settings).654Para opções de configuração completas, veja [Plugin settings](/docs/pt/settings#plugin-settings).

655 655 

656<Note>656<Note>

657 Se você usar uma fonte local `directory` ou `file` com um caminho relativo, o caminho é resolvido contra o checkout principal do seu repositório. Quando você executa Claude Code de um git worktree, o caminho ainda aponta para o checkout principal, então todos os worktrees compartilham o mesmo local de marketplace. O estado do marketplace é armazenado uma vez por usuário em `~/.claude/plugins/known_marketplaces.json`, não por projeto.657 Se você usar uma fonte local `directory` ou `file` com um caminho relativo, o caminho é resolvido contra o checkout principal do seu repositório. Quando você executa Claude Code de um git worktree, o caminho ainda aponta para o checkout principal, então todos os worktrees compartilham o mesmo local de marketplace. O estado do marketplace é armazenado uma vez por usuário em `~/.claude/plugins/known_marketplaces.json`, não por projeto.


699 Restrições de marketplace gerenciado699 Restrições de marketplace gerenciado

700</h3>700</h3>

701 701 

702Para organizações que exigem controle rigoroso sobre fontes de plugin, administradores podem restringir quais marketplaces de plugin os usuários podem adicionar usando a configuração [`strictKnownMarketplaces`](/pt/settings#strictknownmarketplaces) em configurações gerenciadas. Para também rejeitar as flags CLI que carregam plugins, agentes e servidores MCP para uma única execução, combine com [`disableSideloadFlags`](/pt/settings#available-settings). Para criar uma lista de permissões de quais plugins de marketplaces podem aparecer como sugestões de instalação contextual, defina [`pluginSuggestionMarketplaces`](/pt/settings#available-settings).702Para organizações que exigem controle rigoroso sobre fontes de plugin, administradores podem restringir quais marketplaces de plugin os usuários podem adicionar usando a configuração [`strictKnownMarketplaces`](/docs/pt/settings#strictknownmarketplaces) em configurações gerenciadas. Para também rejeitar as flags CLI que carregam plugins, agentes e servidores MCP para uma única execução, combine com [`disableSideloadFlags`](/docs/pt/settings#available-settings). Para criar uma lista de permissões de quais plugins de marketplaces podem aparecer como sugestões de instalação contextual, defina [`pluginSuggestionMarketplaces`](/docs/pt/settings#available-settings).

703 703 

704Quando `strictKnownMarketplaces` é configurado em configurações gerenciadas, o comportamento de restrição depende do valor:704Quando `strictKnownMarketplaces` é configurado em configurações gerenciadas, o comportamento de restrição depende do valor:

705 705 


743}743}

744```744```

745 745 

746Permitir todos os marketplaces de um servidor git interno usando correspondência de padrão regex no host. Esta é a abordagem recomendada para [GitHub Enterprise Server](/pt/github-enterprise-server#plugin-marketplaces-on-ghes) ou instâncias GitLab auto-hospedadas:746Permitir todos os marketplaces de um servidor git interno usando correspondência de padrão regex no host. Esta é a abordagem recomendada para [GitHub Enterprise Server](/docs/pt/github-enterprise-server#plugin-marketplaces-on-ghes) ou instâncias GitLab auto-hospedadas:

747 747 

748```json theme={null}748```json theme={null}

749{749{


772Use `".*"` como `pathPattern` para permitir qualquer caminho de sistema de arquivos enquanto ainda controla fontes de rede com `hostPattern`.772Use `".*"` como `pathPattern` para permitir qualquer caminho de sistema de arquivos enquanto ainda controla fontes de rede com `hostPattern`.

773 773 

774<Note>774<Note>

775 `strictKnownMarketplaces` restringe o que os usuários podem adicionar, mas não registra marketplaces por conta própria. Para tornar marketplaces permitidos disponíveis automaticamente sem usuários executarem `/plugin marketplace add`, combine com [`extraKnownMarketplaces`](/pt/settings#extraknownmarketplaces) no mesmo `managed-settings.json`. Veja [Usando ambos juntos](/pt/settings#strictknownmarketplaces).775 `strictKnownMarketplaces` restringe o que os usuários podem adicionar, mas não registra marketplaces por conta própria. Para tornar marketplaces permitidos disponíveis automaticamente sem usuários executarem `/plugin marketplace add`, combine com [`extraKnownMarketplaces`](/docs/pt/settings#extraknownmarketplaces) no mesmo `managed-settings.json`. Veja [Usando ambos juntos](/docs/pt/settings#strictknownmarketplaces).

776</Note>776</Note>

777 777 

778<h4 id="how-restrictions-work">778<h4 id="how-restrictions-work">


790 790 

791A correspondência exata não normaliza URLs: uma barra à direita, sufixo `.git` ou forma `ssh://` versus `https://` são tratados como valores diferentes. Se o marketplace da sua organização pode ser clonado por mais de uma forma de URL, prefira uma entrada `hostPattern` em vez de uma URL literal para que todas as formas correspondam.791A correspondência exata não normaliza URLs: uma barra à direita, sufixo `.git` ou forma `ssh://` versus `https://` são tratados como valores diferentes. Se o marketplace da sua organização pode ser clonado por mais de uma forma de URL, prefira uma entrada `hostPattern` em vez de uma URL literal para que todas as formas correspondam.

792 792 

793Como `strictKnownMarketplaces` é definido em [configurações gerenciadas](/pt/settings#settings-files), configurações individuais de usuários e projetos não podem substituir essas restrições.793Como `strictKnownMarketplaces` é definido em [configurações gerenciadas](/docs/pt/settings#settings-files), configurações individuais de usuários e projetos não podem substituir essas restrições.

794 794 

795Para detalhes de configuração completos incluindo todos os tipos de fonte suportados e comparação com `extraKnownMarketplaces`, veja a [referência strictKnownMarketplaces](/pt/settings#strictknownmarketplaces).795Para detalhes de configuração completos incluindo todos os tipos de fonte suportados e comparação com `extraKnownMarketplaces`, veja a [referência strictKnownMarketplaces](/docs/pt/settings#strictknownmarketplaces).

796 796 

797<h3 id="version-resolution-and-release-channels">797<h3 id="version-resolution-and-release-channels">

798 Resolução de versão e canais de lançamento798 Resolução de versão e canais de lançamento


818 Configurar canais de lançamento818 Configurar canais de lançamento

819</h4>819</h4>

820 820 

821Para suportar canais de lançamento "stable" e "latest" para seus plugins, você pode configurar dois marketplaces que apontam para diferentes refs ou SHAs do mesmo repositório. Você pode então atribuir os dois marketplaces a diferentes grupos de usuários através de [configurações gerenciadas](/pt/settings#settings-files).821Para suportar canais de lançamento "stable" e "latest" para seus plugins, você pode configurar dois marketplaces que apontam para diferentes refs ou SHAs do mesmo repositório. Você pode então atribuir os dois marketplaces a diferentes grupos de usuários através de [configurações gerenciadas](/docs/pt/settings#settings-files).

822 822 

823<Warning>823<Warning>

824 Cada canal deve resolver para uma versão diferente. Se você usar versões explícitas, `plugin.json` deve declarar uma `version` diferente em cada ref fixado. Se você omitir `version`, os SHAs de commit distintos já distinguem os canais. Se dois refs resolverem para a mesma string de versão, Claude Code os trata como idênticos e pula a atualização.824 Cada canal deve resolver para uma versão diferente. Se você usar versões explícitas, `plugin.json` deve declarar uma `version` diferente em cada ref fixado. Se você omitir `version`, os SHAs de commit distintos já distinguem os canais. Se dois refs resolverem para a mesma string de versão, Claude Code os trata como idênticos e pula a atualização.


898 Fixar versões de dependência898 Fixar versões de dependência

899</h4>899</h4>

900 900 

901Um plugin pode restringir suas dependências a um intervalo semver para que atualizações de uma dependência não quebrem o plugin dependente. Veja [Restringir versões de dependência de plugin](/pt/plugin-dependencies) para a convenção de git-tag `{plugin-name}--v{version}`, sintaxe de intervalo e como múltiplas restrições na mesma dependência são combinadas.901Um plugin pode restringir suas dependências a um intervalo semver para que atualizações de uma dependência não quebrem o plugin dependente. Veja [Restringir versões de dependência de plugin](/docs/pt/plugin-dependencies) para a convenção de git-tag `{plugin-name}--v{version}`, sintaxe de intervalo e como múltiplas restrições na mesma dependência são combinadas.

902 902 

903<h3 id="rename-or-remove-a-plugin">903<h3 id="rename-or-remove-a-plugin">

904 Renomear ou remover um plugin904 Renomear ou remover um plugin


968/plugin install test-plugin@marketplace-name968/plugin install test-plugin@marketplace-name

969```969```

970 970 

971Para fluxos de trabalho completos de testes de plugin, veja [Testar seus plugins localmente](/pt/plugins#test-your-plugins-locally). Para troubleshooting técnico, veja [Plugins reference](/pt/plugins-reference).971Para fluxos de trabalho completos de testes de plugin, veja [Testar seus plugins localmente](/docs/pt/plugins#test-your-plugins-locally). Para troubleshooting técnico, veja [Plugins reference](/docs/pt/plugins-reference).

972 972 

973<h2 id="manage-marketplaces-from-the-cli">973<h2 id="manage-marketplaces-from-the-cli">

974 Gerenciar marketplaces a partir da CLI974 Gerenciar marketplaces a partir da CLI


996 996 

997| Opção | Descrição | Padrão |997| Opção | Descrição | Padrão |

998| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :----- |998| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :----- |

999| `--scope <scope>` | Onde declarar o marketplace: `user`, `project` ou `local`. Veja [Plugin installation scopes](/pt/plugins-reference#plugin-installation-scopes) | `user` |999| `--scope <scope>` | Onde declarar o marketplace: `user`, `project` ou `local`. Veja [Plugin installation scopes](/docs/pt/plugins-reference#plugin-installation-scopes) | `user` |

1000| `--sparse <paths...>` | Limitar checkout a diretórios específicos via git sparse-checkout. Útil para monorepos | |1000| `--sparse <paths...>` | Limitar checkout a diretórios específicos via git sparse-checkout. Útil para monorepos | |

1001 1001 

1002Adicione um marketplace do GitHub usando atalho `owner/repo`:1002Adicione um marketplace do GitHub usando atalho `owner/repo`:


1077 1077 

1078| Opção | Descrição | Padrão |1078| Opção | Descrição | Padrão |

1079| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- |1079| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- |

1080| `--scope <scope>` | Restringir remoção a um único escopo de configurações: `user`, `project` ou `local`. Veja [Plugin installation scopes](/pt/plugins-reference#plugin-installation-scopes). Quando omitido, a declaração é removida de cada escopo editável. Quando fornecido, apenas a declaração desse escopo é removida; o estado compartilhado, cache e dados de plugin instalado são preservados quando o marketplace ainda está declarado em outro escopo | (todos os escopos) |1080| `--scope <scope>` | Restringir remoção a um único escopo de configurações: `user`, `project` ou `local`. Veja [Plugin installation scopes](/docs/pt/plugins-reference#plugin-installation-scopes). Quando omitido, a declaração é removida de cada escopo editável. Quando fornecido, apenas a declaração desse escopo é removida; o estado compartilhado, cache e dados de plugin instalado são preservados quando o marketplace ainda está declarado em outro escopo | (todos os escopos) |

1081 1081 

1082<Warning>1082<Warning>

1083 Remover um marketplace de seu último escopo restante também desinstala qualquer plugin que você instalou dele. Para atualizar um marketplace sem perder plugins instalados, use `claude plugin marketplace update` em vez disso.1083 Remover um marketplace de seu último escopo restante também desinstala qualquer plugin que você instalou dele. Para atualizar um marketplace sem perder plugins instalados, use `claude plugin marketplace update` em vez disso.


1238 1238 

1239**Causa**: Plugins são copiados para um diretório de cache em vez de serem usados no local. Caminhos que referenciam arquivos fora do diretório do plugin (como `../shared-utils`) não funcionarão porque esses arquivos não são copiados.1239**Causa**: Plugins são copiados para um diretório de cache em vez de serem usados no local. Caminhos que referenciam arquivos fora do diretório do plugin (como `../shared-utils`) não funcionarão porque esses arquivos não são copiados.

1240 1240 

1241**Soluções**: Veja [Plugin caching and file resolution](/pt/plugins-reference#plugin-caching-and-file-resolution) para workarounds incluindo symlinks e reestruturação de diretório.1241**Soluções**: Veja [Plugin caching and file resolution](/docs/pt/plugins-reference#plugin-caching-and-file-resolution) para workarounds incluindo symlinks e reestruturação de diretório.

1242 1242 

1243Para ferramentas de debugging adicionais e problemas comuns, veja [Debugging and development tools](/pt/plugins-reference#debugging-and-development-tools).1243Para ferramentas de debugging adicionais e problemas comuns, veja [Debugging and development tools](/docs/pt/plugins-reference#debugging-and-development-tools).

1244 1244 

1245<h2 id="see-also">1245<h2 id="see-also">

1246 Veja também1246 Veja também

1247</h2>1247</h2>

1248 1248 

1249* [Descobrir e instalar plugins pré-construídos](/pt/discover-plugins) - Instalando plugins de marketplaces existentes1249* [Descobrir e instalar plugins pré-construídos](/docs/pt/discover-plugins) - Instalando plugins de marketplaces existentes

1250* [Plugins](/pt/plugins) - Criando seus próprios plugins1250* [Plugins](/docs/pt/plugins) - Criando seus próprios plugins

1251* [Plugins reference](/pt/plugins-reference) - Especificações técnicas completas e esquemas1251* [Plugins reference](/docs/pt/plugins-reference) - Especificações técnicas completas e esquemas

1252* [Plugin settings](/pt/settings#plugin-settings) - Opções de configuração de plugin1252* [Plugin settings](/docs/pt/settings#plugin-settings) - Opções de configuração de plugin

1253* [strictKnownMarketplaces reference](/pt/settings#strictknownmarketplaces) - Restrições de marketplace gerenciado1253* [strictKnownMarketplaces reference](/docs/pt/settings#strictknownmarketplaces) - Restrições de marketplace gerenciado

Details

8 8 

9Se você opera um marketplace de plugins para sua organização, pode fazer com que Claude Code sugira plugins específicos aos usuários com base no que estão trabalhando. Adicione um bloco `relevance` à entrada de um plugin em `marketplace.json`, depois coloque o marketplace na lista de permissões nas configurações gerenciadas. Quando a sessão de um usuário corresponder a um dos sinais declarados, Claude Code exibe uma sugestão de instalação para esse plugin.9Se você opera um marketplace de plugins para sua organização, pode fazer com que Claude Code sugira plugins específicos aos usuários com base no que estão trabalhando. Adicione um bloco `relevance` à entrada de um plugin em `marketplace.json`, depois coloque o marketplace na lista de permissões nas configurações gerenciadas. Quando a sessão de um usuário corresponder a um dos sinais declarados, Claude Code exibe uma sugestão de instalação para esse plugin.

10 10 

11As sugestões declaradas pelo marketplace são opcionais por marketplace através das [configurações gerenciadas](/pt/settings#settings-files). Nenhuma declaração de `relevance` de um marketplace produz sugestões até que um administrador a adicione à lista de permissões, incluindo o marketplace oficial da Anthropic. Claude Code também inclui uma sugestão integrada que é independente dessa lista de permissões; essa dica e todas as dicas declaradas pelo marketplace são desabilitadas quando [`spinnerTipsEnabled`](/pt/settings#available-settings) é definido como `false`.11As sugestões declaradas pelo marketplace são opcionais por marketplace através das [configurações gerenciadas](/docs/pt/settings#settings-files). Nenhuma declaração de `relevance` de um marketplace produz sugestões até que um administrador a adicione à lista de permissões, incluindo o marketplace oficial da Anthropic. Claude Code também inclui uma sugestão integrada que é independente dessa lista de permissões; essa dica e todas as dicas declaradas pelo marketplace são desabilitadas quando [`spinnerTipsEnabled`](/docs/pt/settings#available-settings) é definido como `false`.

12 12 

13{/* min-version: 2.1.152 */}Este recurso requer Claude Code v2.1.152 ou posterior. Clientes mais antigos ignoram o campo `relevance`.13Este recurso requer Claude Code v2.1.152 ou posterior. Clientes mais antigos ignoram o campo `relevance`.

14 14 

15Esta página é para operadores de marketplace e administradores corporativos. Se você está procurando instalar plugins, consulte [Descobrir e instalar plugins](/pt/discover-plugins).15Esta página é para operadores de marketplace e administradores corporativos. Se você está procurando instalar plugins, consulte [Descobrir e instalar plugins](/docs/pt/discover-plugins).

16 16 

17<h2 id="how-it-works">17<h2 id="how-it-works">

18 Como funciona18 Como funciona


25Quando um sinal corresponde e o plugin ainda não está instalado, Claude Code mostra o plugin em três lugares:25Quando um sinal corresponde e o plugin ainda não está instalado, Claude Code mostra o plugin em três lugares:

26 26 

27* **Dica do spinner**: uma mensagem "Trabalhando com *tópico*? Instale o plugin *plugin*" com o comando `/plugin install` aparece abaixo do spinner enquanto Claude está respondendo.27* **Dica do spinner**: uma mensagem "Trabalhando com *tópico*? Instale o plugin *plugin*" com o comando `/plugin install` aparece abaixo do spinner enquanto Claude está respondendo.

28* **Sugestão de início de sessão**: {/* min-version: 2.1.153 */}se o sinal `cwd` corresponder ao diretório de trabalho, uma notificação de uma linha `plugin suggestion: <name>@<marketplace> · /plugin` aparece antes do primeiro turno. Esta superfície requer Claude Code v2.1.153 ou posterior.28* **Sugestão de início de sessão**: se o sinal `cwd` corresponder ao diretório de trabalho, uma notificação de uma linha `plugin suggestion: <name>@<marketplace> · /plugin` aparece antes do primeiro turno. Esta superfície requer Claude Code v2.1.153 ou posterior.

29* **Aba Discover do `/plugin`**: {/* min-version: 2.1.154 */}o plugin é fixado no topo da lista Discover com uma anotação como "sugerido para este diretório" ou "sugerido para comandos stripe". Esta superfície requer Claude Code v2.1.154 ou posterior.29* **Aba Discover do `/plugin`**: o plugin é fixado no topo da lista Discover com uma anotação como "sugerido para este diretório" ou "sugerido para comandos stripe". Esta superfície requer Claude Code v2.1.154 ou posterior.

30 30 

31A dica do spinner e a notificação de início de sessão fazem parte do sistema de dicas do spinner. Ambas são desabilitadas quando o usuário ou projeto define `spinnerTipsEnabled` como `false`, ou quando um `spinnerTipsOverride` personalizado é configurado com `excludeDefault`. O pino da aba Discover é independente das configurações de dicas.31A dica do spinner e a notificação de início de sessão fazem parte do sistema de dicas do spinner. Ambas são desabilitadas quando o usuário ou projeto define `spinnerTipsEnabled` como `false`, ou quando um `spinnerTipsOverride` personalizado é configurado com `excludeDefault`. O pino da aba Discover é independente das configurações de dicas.

32 32 


80 80 

81| Campo | Tipo | Descrição |81| Campo | Tipo | Descrição |

82| :------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |82| :------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

83| `cwd` | array of strings | {/* min-version: 2.1.153 */}Padrões Glob correspondidos contra o diretório de trabalho da sessão. Correspondido como um caminho absoluto e, quando dentro de um repositório git, como um caminho relativo à raiz do repositório. Normalizado com barra invertida e insensível a maiúsculas/minúsculas. Cada padrão corresponde ao diretório em si e a tudo sob ele, então `infra`, `infra/`, e `infra/**` se comportam de forma idêntica. Este é o único sinal que pode corresponder no início da sessão, antes do primeiro turno. Máximo 10 padrões de 256 caracteres cada. |83| `cwd` | array of strings | Padrões Glob correspondidos contra o diretório de trabalho da sessão. Correspondido como um caminho absoluto e, quando dentro de um repositório git, como um caminho relativo à raiz do repositório. Normalizado com barra invertida e insensível a maiúsculas/minúsculas. Cada padrão corresponde ao diretório em si e a tudo sob ele, então `infra`, `infra/`, e `infra/**` se comportam de forma idêntica. Este é o único sinal que pode corresponder no início da sessão, antes do primeiro turno. Máximo 10 padrões de 256 caracteres cada. |

84| `cli` | array of strings | Nomes de comando de comandos shell que Claude executou nesta sessão, por exemplo `["stripe"]`. Aplica-se em todas as plataformas: comandos executados no Windows através do PowerShell ou Git Bash são registrados da mesma forma. Claude Code registra um nome de comando por invocação de ferramenta shell: o primeiro token após qualquer atribuição de variável de ambiente inicial e `sudo`. Comandos compostos contribuem apenas com seu comando inicial, então `cd infra && terraform plan` registra `cd`, não `terraform`. Correspondência exata. Máximo 10 entradas de 64 caracteres cada. |84| `cli` | array of strings | Nomes de comando de comandos shell que Claude executou nesta sessão, por exemplo `["stripe"]`. Aplica-se em todas as plataformas: comandos executados no Windows através do PowerShell ou Git Bash são registrados da mesma forma. Claude Code registra um nome de comando por invocação de ferramenta shell: o primeiro token após qualquer atribuição de variável de ambiente inicial e `sudo`. Comandos compostos contribuem apenas com seu comando inicial, então `cd infra && terraform plan` registra `cd`, não `terraform`. Correspondência exata. Máximo 10 entradas de 64 caracteres cada. |

85| `hosts` | array of strings | Nomes de host vistos em URLs `http://` ou `https://` em comandos Bash nesta sessão, por exemplo `["api.stripe.com"]`. Apenas nome de host em minúsculas: sem esquema, porta ou caminho. Correspondência exata insensível a maiúsculas/minúsculas. Máximo 20 entradas de 128 caracteres cada. |85| `hosts` | array of strings | Nomes de host vistos em URLs `http://` ou `https://` em comandos Bash nesta sessão, por exemplo `["api.stripe.com"]`. Apenas nome de host em minúsculas: sem esquema, porta ou caminho. Correspondência exata insensível a maiúsculas/minúsculas. Máximo 20 entradas de 128 caracteres cada. |

86| `filesRead` | array of strings | {/* min-version: 2.1.153 */}Padrões Glob correspondidos contra os caminhos de arquivos que Claude leu nesta sessão, por exemplo `["**/*.tf"]`. Normalizado com barra invertida e insensível a maiúsculas/minúsculas. Máximo 10 padrões de 256 caracteres cada. |86| `filesRead` | array of strings | Padrões Glob correspondidos contra os caminhos de arquivos que Claude leu nesta sessão, por exemplo `["**/*.tf"]`. Normalizado com barra invertida e insensível a maiúsculas/minúsculas. Máximo 10 padrões de 256 caracteres cada. |

87| `manifestDeps` | array of objects | Dependências declaradas em manifestos de pacote que Claude leu nesta sessão. Cada entrada é `{ "file": "...", "pattern": "..." }`, onde `file` é uma expressão regular correspondida contra o caminho do arquivo de manifesto conforme registrado no estado da sessão, normalmente um caminho absoluto, e `pattern` é uma expressão regular correspondida contra o conteúdo desse arquivo. Âncora `file` no final, por exemplo `[/\\\\]package\\.json$` em forma com escape JSON, porque um padrão ancorado no início nunca corresponde a um caminho absoluto. Os caminhos não são normalizados por separador para este sinal, então os caminhos do Windows usam barras invertidas. Arquivos de manifesto maiores que 512 KB são ignorados. Ambos os valores são strings de origem `RegExp` do JavaScript de no máximo 256 caracteres. `file` corresponde insensível a maiúsculas/minúsculas. `pattern` é sensível a maiúsculas/minúsculas. Máximo 10 entradas. |87| `manifestDeps` | array of objects | Dependências declaradas em manifestos de pacote que Claude leu nesta sessão. Cada entrada é `{ "file": "...", "pattern": "..." }`, onde `file` é uma expressão regular correspondida contra o caminho do arquivo de manifesto conforme registrado no estado da sessão, normalmente um caminho absoluto, e `pattern` é uma expressão regular correspondida contra o conteúdo desse arquivo. Âncora `file` no final, por exemplo `[/\\\\]package\\.json$` em forma com escape JSON, porque um padrão ancorado no início nunca corresponde a um caminho absoluto. Os caminhos não são normalizados por separador para este sinal, então os caminhos do Windows usam barras invertidas. Arquivos de manifesto maiores que 512 KB são ignorados. Ambos os valores são strings de origem `RegExp` do JavaScript de no máximo 256 caracteres. `file` corresponde insensível a maiúsculas/minúsculas. `pattern` é sensível a maiúsculas/minúsculas. Máximo 10 entradas. |

88 88 

89Os sinais `cli`, `hosts`, `filesRead` e `manifestDeps` precisam de histórico de sessão, então eles só podem corresponder na dica do spinner e na aba Discover. Apenas `cwd` pode corresponder no início da sessão. Os sinais `filesRead` e `manifestDeps` testam o estado de arquivo registrado da sessão, que também inclui arquivos que Claude escreveu ou editou e arquivos de memória `CLAUDE.md` carregados automaticamente.89Os sinais `cli`, `hosts`, `filesRead` e `manifestDeps` precisam de histórico de sessão, então eles só podem corresponder na dica do spinner e na aba Discover. Apenas `cwd` pode corresponder no início da sessão. Os sinais `filesRead` e `manifestDeps` testam o estado de arquivo registrado da sessão, que também inclui arquivos que Claude escreveu ou editou e arquivos de memória `CLAUDE.md` carregados automaticamente.


116 Ative sugestões nas configurações gerenciadas116 Ative sugestões nas configurações gerenciadas

117</h2>117</h2>

118 118 

119Declarar `relevance` em `marketplace.json` não é suficiente por si só. Um administrador deve colocar o marketplace na lista de permissões nas [configurações gerenciadas](/pt/settings#settings-files) antes que suas sugestões apareçam aos usuários.119Declarar `relevance` em `marketplace.json` não é suficiente por si só. Um administrador deve colocar o marketplace na lista de permissões nas [configurações gerenciadas](/docs/pt/settings#settings-files) antes que suas sugestões apareçam aos usuários.

120 120 

121Adicione o nome do marketplace a `pluginSuggestionMarketplaces`. Para qualquer marketplace que não seja o marketplace oficial da Anthropic, também declare a fonte do marketplace nas mesmas configurações gerenciadas, seja como entrada desse nome em `extraKnownMarketplaces` ou como entrada em `strictKnownMarketplaces`. O nome colocado na lista de permissões é ignorado se o marketplace registrado na máquina veio de uma fonte diferente. Isso impede que uma fonte não relacionada se registre sob um nome colocado na lista de permissões para ter seus plugins sugeridos em toda sua organização.121Adicione o nome do marketplace a `pluginSuggestionMarketplaces`. Para qualquer marketplace que não seja o marketplace oficial da Anthropic, também declare a fonte do marketplace nas mesmas configurações gerenciadas, seja como entrada desse nome em `extraKnownMarketplaces` ou como entrada em `strictKnownMarketplaces`. O nome colocado na lista de permissões é ignorado se o marketplace registrado na máquina veio de uma fonte diferente. Isso impede que uma fonte não relacionada se registre sob um nome colocado na lista de permissões para ter seus plugins sugeridos em toda sua organização.

122 122 


144}144}

145```145```

146 146 

147Consulte a [referência de configurações](/pt/settings) para `pluginSuggestionMarketplaces` e [`extraKnownMarketplaces`](/pt/settings#extraknownmarketplaces) para detalhes completos de configuração.147Consulte a [referência de configurações](/docs/pt/settings) para `pluginSuggestionMarketplaces` e [`extraKnownMarketplaces`](/docs/pt/settings#extraknownmarketplaces) para detalhes completos de configuração.

148 148 

149<h2 id="what-the-user-sees">149<h2 id="what-the-user-sees">

150 O que o usuário vê150 O que o usuário vê


165 165 

166A sugestão de um determinado plugin aparece no máximo uma vez a cada três sessões entre a dica do spinner e a notificação de início de sessão combinadas, e nenhuma se repete uma vez que o plugin está instalado. A notificação de início de sessão também para de aparecer após a sugestão ter sido mostrada duas vezes.166A sugestão de um determinado plugin aparece no máximo uma vez a cada três sessões entre a dica do spinner e a notificação de início de sessão combinadas, e nenhuma se repete uma vez que o plugin está instalado. A notificação de início de sessão também para de aparecer após a sugestão ter sido mostrada duas vezes.

167 167 

168{/* min-version: 2.1.154 */}Na aba Discover do `/plugin`, o plugin é fixado acima dos outros resultados com uma anotação que nomeia o sinal correspondente, como `suggested for this directory` ou `suggested for terraform commands`. A aba Discover fixa um determinado plugin uma vez; visitas posteriores o listam em ordem normal. O pino da aba Discover requer Claude Code v2.1.154 ou posterior. Na v2.1.152 apenas a dica do spinner aparece; a notificação de início de sessão é adicionada na v2.1.153.168Na aba Discover do `/plugin`, o plugin é fixado acima dos outros resultados com uma anotação que nomeia o sinal correspondente, como `suggested for this directory` ou `suggested for terraform commands`. A aba Discover fixa um determinado plugin uma vez; visitas posteriores o listam em ordem normal. O pino da aba Discover requer Claude Code v2.1.154 ou posterior. Na v2.1.152 apenas a dica do spinner aparece; a notificação de início de sessão é adicionada na v2.1.153.

169 169 

170<h2 id="validate-your-marketplace">170<h2 id="validate-your-marketplace">

171 Valide seu marketplace171 Valide seu marketplace


183 Veja também183 Veja também

184</h2>184</h2>

185 185 

186* [Crie e distribua um marketplace de plugins](/pt/plugin-marketplaces): construa o marketplace que hospeda seus plugins186* [Crie e distribua um marketplace de plugins](/docs/pt/plugin-marketplaces): construa o marketplace que hospeda seus plugins

187* [Recomende seu plugin a partir de sua CLI](/pt/plugin-hints): solicite aos usuários a partir de sua própria CLI em vez de dos sinais de sessão do Claude Code187* [Recomende seu plugin a partir de sua CLI](/docs/pt/plugin-hints): solicite aos usuários a partir de sua própria CLI em vez de dos sinais de sessão do Claude Code

188* [Configurações](/pt/settings): referência completa para `pluginSuggestionMarketplaces` e `extraKnownMarketplaces`188* [Configurações](/docs/pt/settings): referência completa para `pluginSuggestionMarketplaces` e `extraKnownMarketplaces`

Details

515| Campo | Tipo | Descrição | Exemplo |515| Campo | Tipo | Descrição | Exemplo |

516| :--------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |516| :--------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

517| `$schema` | string | URL do JSON Schema para autocomplete e validação do editor. Claude Code ignora este campo no momento do carregamento. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |517| `$schema` | string | URL do JSON Schema para autocomplete e validação do editor. Claude Code ignora este campo no momento do carregamento. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

518| `displayName` | string | {/* min-version: 2.1.143 */}Nome legível por humanos mostrado no seletor `/plugin` e outras superfícies de UI. Volta para `name` quando omitido. Ao contrário de `name`, pode conter espaços e qualquer capitalização. Não é usado para namespacing ou busca. Requer Claude Code v2.1.143 ou posterior. | `"Deployment Tools"` |518| `displayName` | string | Nome legível por humanos mostrado no seletor `/plugin` e outras superfícies de UI. Volta para `name` quando omitido. Ao contrário de `name`, pode conter espaços e qualquer capitalização. Não é usado para namespacing ou busca. Requer Claude Code v2.1.143 ou posterior. | `"Deployment Tools"` |

519| `version` | string | Opcional. Versão semântica. Definir isso fixa o plugin para essa string de versão, então os usuários só recebem atualizações quando você a incrementa. Se omitido, Claude Code volta para o SHA do commit git, então cada commit é tratado como uma nova versão. Se também definido na entrada do marketplace, `plugin.json` vence. Veja [Gerenciamento de versão](#version-management). | `"2.1.0"` |519| `version` | string | Opcional. Versão semântica. Definir isso fixa o plugin para essa string de versão, então os usuários só recebem atualizações quando você a incrementa. Se omitido, Claude Code volta para o SHA do commit git, então cada commit é tratado como uma nova versão. Se também definido na entrada do marketplace, `plugin.json` vence. Veja [Gerenciamento de versão](#version-management). | `"2.1.0"` |

520| `description` | string | Explicação breve do propósito do plugin | `"Deployment automation tools"` |520| `description` | string | Explicação breve do propósito do plugin | `"Deployment automation tools"` |

521| `author` | object | Informações do autor | `{"name": "Dev Team", "email": "dev@company.com"}` |521| `author` | object | Informações do autor | `{"name": "Dev Team", "email": "dev@company.com"}` |


523| `repository` | string | URL do código-fonte | `"https://github.com/user/plugin"` |523| `repository` | string | URL do código-fonte | `"https://github.com/user/plugin"` |

524| `license` | string | Identificador de licença | `"MIT"`, `"Apache-2.0"` |524| `license` | string | Identificador de licença | `"MIT"`, `"Apache-2.0"` |

525| `keywords` | array | Tags de descoberta | `["deployment", "ci-cd"]` |525| `keywords` | array | Tags de descoberta | `["deployment", "ci-cd"]` |

526| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Se o plugin inicia em um estado habilitado quando o usuário não definiu um. Padrão é `true`. Veja [Habilitação padrão](#default-enablement). Requer Claude Code v2.1.154 ou posterior. | `false` |526| `defaultEnabled` | boolean | Se o plugin inicia em um estado habilitado quando o usuário não definiu um. Padrão é `true`. Veja [Habilitação padrão](#default-enablement). Requer Claude Code v2.1.154 ou posterior. | `false` |

527 527 

528<h3 id="default-enablement">528<h3 id="default-enablement">

529 Habilitação padrão529 Habilitação padrão


612 612 

613Antes de v2.1.207, esses campos substituíam valores `${user_config.KEY}`; atualize plugins que dependiam disso.613Antes de v2.1.207, esses campos substituíam valores `${user_config.KEY}`; atualize plugins que dependiam disso.

614 614 

615Valores não sensíveis são armazenados sob a chave [`pluginConfigs`](/docs/pt/settings#pluginconfigs) em `settings.json` como `pluginConfigs[<plugin-id>].options`. {/* min-version: 2.1.207 */}Claude Code escreve a chave para configurações do usuário e a lê de volta de configurações do usuário, a flag `--settings` e configurações gerenciadas apenas; entradas em `.claude/settings.json` ou `.claude/settings.local.json` de um projeto são ignoradas. Antes de v2.1.207, Claude Code também lia configurações de projeto e local.615Valores não sensíveis são armazenados sob a chave [`pluginConfigs`](/docs/pt/settings#pluginconfigs) em `settings.json` como `pluginConfigs[<plugin-id>].options`. Claude Code escreve a chave para configurações do usuário e a lê de volta de configurações do usuário, a flag `--settings` e configurações gerenciadas apenas; entradas em `.claude/settings.json` ou `.claude/settings.local.json` de um projeto são ignoradas. Antes de v2.1.207, Claude Code também lia configurações de projeto e local.

616 616 

617Valores sensíveis vão para o Keychain do macOS, ou para `~/.claude/.credentials.json` em plataformas onde nenhum keychain suportado está disponível. O armazenamento em keychain é compartilhado com tokens OAuth e tem um limite total aproximado de 2 KB, então mantenha valores sensíveis pequenos.617Valores sensíveis vão para o Keychain do macOS, ou para `~/.claude/.credentials.json` em plataformas onde nenhum keychain suportado está disponível. O armazenamento em keychain é compartilhado com tokens OAuth e tem um limite total aproximado de 2 KB, então mantenha valores sensíveis pequenos.

618 618 

Details

116 116 

117A exceção é um plugin que fornece [servidores MCP](/docs/pt/plugins-reference#mcp-servers). Ativar ou desativar um segue as mesmas regras que [conectar ou desconectar um servidor MCP](#connecting-or-disconnecting-an-mcp-server): o cache sobrevive quando as ferramentas do servidor são adiadas, e a próxima solicitação relê toda a conversa quando elas carregam no prefixo.117A exceção é um plugin que fornece [servidores MCP](/docs/pt/plugins-reference#mcp-servers). Ativar ou desativar um segue as mesmas regras que [conectar ou desconectar um servidor MCP](#connecting-or-disconnecting-an-mcp-server): o cache sobrevive quando as ferramentas do servidor são adiadas, e a próxima solicitação relê toda a conversa quando elas carregam no prefixo.

118 118 

119As mudanças de plugin se aplicam quando você executa [`/reload-plugins`](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) ou inicia uma nova sessão. O custo, seja anúncios anexados ou uma releitura completa, aparece no primeiro turno após o recarregamento, não quando você executa `/plugin install`, `/plugin enable` ou `/plugin disable`. {/* min-version: 2.1.163 */}A partir da v2.1.163, quando um recarregamento acionaria a releitura completa, `/reload-plugins` mostra um aviso e não aplica o recarregamento. Passe `--force` para aplicar mesmo assim.119As mudanças de plugin se aplicam quando você executa [`/reload-plugins`](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) ou inicia uma nova sessão. O custo, seja anúncios anexados ou uma releitura completa, aparece no primeiro turno após o recarregamento, não quando você executa `/plugin install`, `/plugin enable` ou `/plugin disable`. A partir da v2.1.163, quando um recarregamento acionaria a releitura completa, `/reload-plugins` mostra um aviso e não aplica o recarregamento. Passe `--force` para aplicar mesmo assim.

120 120 

121Desativar um plugin que você ativou anteriormente na sessão restaura a forma de solicitação anterior. Se esse prefixo ainda estiver dentro de seu [tempo de vida do cache](#cache-lifetime), a próxima solicitação lê a entrada de cache mais antiga em vez de reconstruir.121Desativar um plugin que você ativou anteriormente na sessão restaura a forma de solicitação anterior. Se esse prefixo ainda estiver dentro de seu [tempo de vida do cache](#cache-lifetime), a próxima solicitação lê a entrada de cache mais antiga em vez de reconstruir.

122 122 

remote-control.md +38 −38

Details

14 14 

15Quando você inicia uma sessão de Remote Control na sua máquina, Claude continua executando localmente o tempo todo, portanto seu código e acesso ao sistema de arquivos permanecem na sua máquina. Com Remote Control você pode:15Quando você inicia uma sessão de Remote Control na sua máquina, Claude continua executando localmente o tempo todo, portanto seu código e acesso ao sistema de arquivos permanecem na sua máquina. Com Remote Control você pode:

16 16 

17* **Usar seu ambiente local completo remotamente**: seu sistema de arquivos, [MCP servers](/pt/mcp), ferramentas e configuração do projeto permanecem disponíveis, e digitar `@` autocompleta caminhos de arquivo do seu projeto local17* **Usar seu ambiente local completo remotamente**: seu sistema de arquivos, [MCP servers](/docs/pt/mcp), ferramentas e configuração do projeto permanecem disponíveis, e digitar `@` autocompleta caminhos de arquivo do seu projeto local

18* **Trabalhar em ambas as superfícies ao mesmo tempo**: a conversa e o progresso de [subagentes](/pt/sub-agents) e [fluxos de trabalho dinâmicos](/pt/workflows) permanecem sincronizados em todos os dispositivos conectados, para que você possa enviar mensagens do seu terminal, navegador e telefone de forma intercambiável. {/* min-version: 2.1.207 */}Antes da v2.1.207, as sessões hospedadas pelo [aplicativo Desktop](/pt/desktop) não enviavam progresso de subagentes ou fluxos de trabalho para dispositivos conectados.18* **Trabalhar em ambas as superfícies ao mesmo tempo**: a conversa e o progresso de [subagentes](/docs/pt/sub-agents) e [fluxos de trabalho dinâmicos](/docs/pt/workflows) permanecem sincronizados em todos os dispositivos conectados, para que você possa enviar mensagens do seu terminal, navegador e telefone de forma intercambiável. Antes da v2.1.207, as sessões hospedadas pelo [aplicativo Desktop](/docs/pt/desktop) não enviavam progresso de subagentes ou fluxos de trabalho para dispositivos conectados.

19* **Enviar imagens e arquivos do seu telefone ou navegador**: quando você adiciona um anexo no aplicativo Claude ou em claude.ai/code, Claude Code faz o download para sua máquina e o passa para Claude como uma referência de arquivo `@`, com ou sem legenda. {/* min-version: 2.1.202 */}Antes da v2.1.202, Claude Code podia descartar um anexo enviado sem legenda antes de chegar à sessão.19* **Enviar imagens e arquivos do seu telefone ou navegador**: quando você adiciona um anexo no aplicativo Claude ou em claude.ai/code, Claude Code faz o download para sua máquina e o passa para Claude como uma referência de arquivo `@`, com ou sem legenda. Antes da v2.1.202, Claude Code podia descartar um anexo enviado sem legenda antes de chegar à sessão.

20* **Sobreviver a interrupções**: se seu laptop dormir ou sua rede cair, a sessão se reconecta automaticamente quando sua máquina voltar a ficar online. Claude Code enfileira atualizações de status de subagentes e fluxos de trabalho enquanto a conexão está sendo reconstruída e as entrega assim que se recupera. {/* min-version: 2.1.207 */}Antes da v2.1.207, uma atualização enviada durante uma reconexão ou atualização de credenciais podia ser perdida, portanto o dispositivo conectado continuava mostrando uma tarefa concluída como em execução.20* **Sobreviver a interrupções**: se seu laptop dormir ou sua rede cair, a sessão se reconecta automaticamente quando sua máquina voltar a ficar online. Claude Code enfileira atualizações de status de subagentes e fluxos de trabalho enquanto a conexão está sendo reconstruída e as entrega assim que se recupera. Antes da v2.1.207, uma atualização enviada durante uma reconexão ou atualização de credenciais podia ser perdida, portanto o dispositivo conectado continuava mostrando uma tarefa concluída como em execução.

21 21 

22Diferentemente do [Claude Code na web](/pt/claude-code-on-the-web), que é executado em infraestrutura em nuvem, as sessões de Remote Control são executadas diretamente na sua máquina e interagem com seu sistema de arquivos local. As interfaces web e móvel são apenas uma janela para essa sessão local.22Diferentemente do [Claude Code na web](/docs/pt/claude-code-on-the-web), que é executado em infraestrutura em nuvem, as sessões de Remote Control são executadas diretamente na sua máquina e interagem com seu sistema de arquivos local. As interfaces web e móvel são apenas uma janela para essa sessão local.

23 23 

24Esta página aborda a configuração, como iniciar e conectar a sessões, e como Remote Control se compara ao Claude Code na web.24Esta página aborda a configuração, como iniciar e conectar a sessões, e como Remote Control se compara ao Claude Code na web.

25 25 


31 31 

32* **Assinatura**: disponível nos planos Pro, Max, Team e Enterprise. Chaves de API não são suportadas. Em Team e Enterprise, um Owner deve primeiro ativar o toggle Remote Control nas [configurações de administrador do Claude Code](https://claude.ai/admin-settings/claude-code).32* **Assinatura**: disponível nos planos Pro, Max, Team e Enterprise. Chaves de API não são suportadas. Em Team e Enterprise, um Owner deve primeiro ativar o toggle Remote Control nas [configurações de administrador do Claude Code](https://claude.ai/admin-settings/claude-code).

33* **Autenticação**: execute `claude` e use `/login` para fazer login através de claude.ai se você ainda não fez isso.33* **Autenticação**: execute `claude` e use `/login` para fazer login através de claude.ai se você ainda não fez isso.

34* **Endpoint de API**: não disponível no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. {/* min-version: 2.1.196 */}A partir da v2.1.196, Remote Control também é desabilitado quando [`ANTHROPIC_BASE_URL`](/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/pt/llm-gateway) ou proxy. Desative a variável para usar Remote Control.34* **Endpoint de API**: não disponível no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. A partir da v2.1.196, Remote Control também é desabilitado quando [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/docs/pt/llm-gateway) ou proxy. Desative a variável para usar Remote Control.

35* **Confiança do workspace**: execute `claude` no diretório do seu projeto pelo menos uma vez para aceitar o diálogo de confiança do workspace.35* **Confiança do workspace**: execute `claude` no diretório do seu projeto pelo menos uma vez para aceitar o diálogo de confiança do workspace.

36 36 

37<h2 id="start-a-remote-control-session">37<h2 id="start-a-remote-control-session">


56 | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |56 | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

57 | `--name "My Project"` | Define um título de sessão personalizado visível na lista de sessões em claude.ai/code. |57 | `--name "My Project"` | Define um título de sessão personalizado visível na lista de sessões em claude.ai/code. |

58 | `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão gerados automaticamente quando nenhum nome explícito é definido. O padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito. |58 | `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão gerados automaticamente quando nenhum nome explícito é definido. O padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito. |

59 | `-c`, `--continue` | {/* min-version: 2.1.200 */}Retome a sessão de Remote Control mais recente iniciada a partir deste diretório em vez de criar uma nova. Não pode ser combinado com `--session-id`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior; versões anteriores rejeitam o sinalizador como um argumento desconhecido. |59 | `-c`, `--continue` | Retome a sessão de Remote Control mais recente iniciada a partir deste diretório em vez de criar uma nova. Não pode ser combinado com `--session-id`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior; versões anteriores rejeitam o sinalizador como um argumento desconhecido. |

60 | `--session-id <id>` | {/* min-version: 2.1.200 */}Retome uma sessão de Remote Control específica pelo seu ID. Não pode ser combinado com `--continue`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior; versões anteriores rejeitam o sinalizador como um argumento desconhecido. |60 | `--session-id <id>` | Retome uma sessão de Remote Control específica pelo seu ID. Não pode ser combinado com `--continue`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior; versões anteriores rejeitam o sinalizador como um argumento desconhecido. |

61 | `--spawn <mode>` | Como o servidor cria sessões.<br />• `same-dir` (padrão): todas as sessões compartilham o diretório de trabalho atual, portanto podem entrar em conflito se editarem os mesmos arquivos.<br />• `worktree`: cada sessão sob demanda obtém seu próprio [git worktree](/pt/worktrees). Requer um repositório git.<br />• `session`: modo de sessão única. Serve exatamente uma sessão e rejeita conexões adicionais. Definido apenas na inicialização.<br />Pressione `w` em tempo de execução para alternar entre `same-dir` e `worktree`. |61 | `--spawn <mode>` | Como o servidor cria sessões.<br />• `same-dir` (padrão): todas as sessões compartilham o diretório de trabalho atual, portanto podem entrar em conflito se editarem os mesmos arquivos.<br />• `worktree`: cada sessão sob demanda obtém seu próprio [git worktree](/docs/pt/worktrees). Requer um repositório git.<br />• `session`: modo de sessão única. Serve exatamente uma sessão e rejeita conexões adicionais. Definido apenas na inicialização.<br />Pressione `w` em tempo de execução para alternar entre `same-dir` e `worktree`. |

62 | `--capacity <N>` | Número máximo de sessões simultâneas. O padrão é 32. Não pode ser usado com `--spawn=session`. |62 | `--capacity <N>` | Número máximo de sessões simultâneas. O padrão é 32. Não pode ser usado com `--spawn=session`. |

63 | `--[no-]create-session-in-dir` | Pré-crie uma sessão no diretório atual quando o servidor inicia, para que você tenha um lugar para digitar imediatamente. Em modo `worktree`, essa sessão permanece no diretório atual enquanto as sessões sob demanda obtêm worktrees isoladas. Ativado por padrão; passe `--no-create-session-in-dir` para iniciar sem nenhuma. |63 | `--[no-]create-session-in-dir` | Pré-crie uma sessão no diretório atual quando o servidor inicia, para que você tenha um lugar para digitar imediatamente. Em modo `worktree`, essa sessão permanece no diretório atual enquanto as sessões sob demanda obtêm worktrees isoladas. Ativado por padrão; passe `--no-create-session-in-dir` para iniciar sem nenhuma. |

64 | `--verbose` | Mostra logs detalhados de conexão e sessão. |64 | `--verbose` | Mostra logs detalhados de conexão e sessão. |

65 | `--sandbox` / `--no-sandbox` | Ativa ou desativa [sandboxing](/pt/sandboxing) para isolamento de sistema de arquivos e rede. Desativado por padrão. |65 | `--sandbox` / `--no-sandbox` | Ativa ou desativa [sandboxing](/docs/pt/sandboxing) para isolamento de sistema de arquivos e rede. Desativado por padrão. |

66 </Tab>66 </Tab>

67 67 

68 <Tab title="Sessão interativa">68 <Tab title="Sessão interativa">


100 </Tab>100 </Tab>

101 101 

102 <Tab title="VS Code">102 <Tab title="VS Code">

103 Na [extensão VS Code do Claude Code](/pt/vs-code), digite `/remote-control` ou `/rc` na caixa de prompt, ou abra o menu de comandos com `/` e selecione-o.103 Na [extensão VS Code do Claude Code](/docs/pt/vs-code), digite `/remote-control` ou `/rc` na caixa de prompt, ou abra o menu de comandos com `/` e selecione-o.

104 104 

105 ```text theme={null}105 ```text theme={null}

106 /remote-control106 /remote-control


132* **Escaneie o código QR** mostrado ao lado da URL da sessão para abri-lo diretamente no aplicativo Claude. Com `claude remote-control`, pressione a barra de espaço para alternar a exibição do código QR.132* **Escaneie o código QR** mostrado ao lado da URL da sessão para abri-lo diretamente no aplicativo Claude. Com `claude remote-control`, pressione a barra de espaço para alternar a exibição do código QR.

133* **Abra [claude.ai/code](https://claude.ai/code) ou o aplicativo Claude** e encontre a sessão pelo nome na lista de sessões. No aplicativo móvel Claude, toque em **Code** na navegação para acessar a lista de sessões. As sessões de Remote Control mostram um ícone de computador com um ponto de status verde quando online.133* **Abra [claude.ai/code](https://claude.ai/code) ou o aplicativo Claude** e encontre a sessão pelo nome na lista de sessões. No aplicativo móvel Claude, toque em **Code** na navegação para acessar a lista de sessões. As sessões de Remote Control mostram um ícone de computador com um ponto de status verde quando online.

134 134 

135Quando você se conecta, o dispositivo mostra quaisquer subagentes e fluxos de trabalho que a sessão já tem em execução em segundo plano. {/* min-version: 2.1.208 */}Antes da v2.1.208, um dispositivo conectado a uma sessão hospedada em um terminal interativo não mostrava subagentes e fluxos de trabalho que já estavam em execução até que um deles iniciasse ou parasse.135Quando você se conecta, o dispositivo mostra quaisquer subagentes e fluxos de trabalho que a sessão já tem em execução em segundo plano. Antes da v2.1.208, um dispositivo conectado a uma sessão hospedada em um terminal interativo não mostrava subagentes e fluxos de trabalho que já estavam em execução até que um deles iniciasse ou parasse.

136 136 

137O título da sessão remota é escolhido nesta ordem:137O título da sessão remota é escolhido nesta ordem:

138 138 


1413. A última mensagem significativa no histórico de conversa existente1413. A última mensagem significativa no histórico de conversa existente

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

143 143 

144Se você não definir um nome explícito, o título será atualizado para refletir seu prompt assim que você enviar um. {/* min-version: 2.1.176 */}A partir da Claude Code v2.1.176, títulos gerados automaticamente correspondem ao idioma da sua conversa, ou à configuração [`language`](/pt/settings#available-settings) se uma estiver configurada. Renomear uma sessão a partir de claude.ai ou do aplicativo Claude também atualiza o título local mostrado em `claude --resume`.144Se você não definir um nome explícito, o título será atualizado para refletir seu prompt assim que você enviar um. A partir da Claude Code v2.1.176, títulos gerados automaticamente correspondem ao idioma da sua conversa, ou à configuração [`language`](/docs/pt/settings#available-settings) se uma estiver configurada. Renomear uma sessão a partir de claude.ai ou do aplicativo Claude também atualiza o título local mostrado em `claude --resume`.

145 145 

146Se o ambiente já tiver uma sessão ativa, você será perguntado se deseja continuá-la ou iniciar uma nova.146Se o ambiente já tiver uma sessão ativa, você será perguntado se deseja continuá-la ou iniciar uma nova.

147 147 


151 Ativar Remote Control para todas as sessões151 Ativar Remote Control para todas as sessões

152</h3>152</h3>

153 153 

154Remote Control só é ativado quando você executa explicitamente `claude remote-control`, `claude --remote-control` ou `/remote-control`, a menos que a conexão automática esteja ativada. Para ativá-lo automaticamente para cada sessão interativa, execute `/config` dentro do Claude Code e defina **Enable Remote Control for all sessions** como `true`. Defina-o como `false` para nunca conectar automaticamente, ou deixe-o não definido para seguir o padrão da sua organização. No aplicativo Desktop, você também pode alternar isso em **Settings → Claude Code → Enable remote control by default**. {/* min-version: 2.1.203 */}Na [extensão VS Code](/pt/vs-code#use-the-prompt-box), o mesmo botão de alternância aparece como **Enable Remote Control for all sessions** na seção Configurações do menu de comandos; requer Claude Code v2.1.203 ou posterior.154Remote Control só é ativado quando você executa explicitamente `claude remote-control`, `claude --remote-control` ou `/remote-control`, a menos que a conexão automática esteja ativada. Para ativá-lo automaticamente para cada sessão interativa, execute `/config` dentro do Claude Code e defina **Enable Remote Control for all sessions** como `true`. Defina-o como `false` para nunca conectar automaticamente, ou deixe-o não definido para seguir o padrão da sua organização. No aplicativo Desktop, você também pode alternar isso em **Settings → Claude Code → Enable remote control by default**. Na [extensão VS Code](/docs/pt/vs-code#use-the-prompt-box), o mesmo botão de alternância aparece como **Enable Remote Control for all sessions** na seção Configurações do menu de comandos; requer Claude Code v2.1.203 ou posterior.

155 155 

156Com essa configuração ativada, cada processo interativo do Claude Code registra uma sessão remota. Se você executar várias instâncias, cada uma obtém seu próprio ambiente e sessão. Para executar várias sessões simultâneas a partir de um único processo, use o [modo servidor](#start-a-remote-control-session) em vez disso.156Com essa configuração ativada, cada processo interativo do Claude Code registra uma sessão remota. Se você executar várias instâncias, cada uma obtém seu próprio ambiente e sessão. Para executar várias sessões simultâneas a partir de um único processo, use o [modo servidor](#start-a-remote-control-session) em vez disso.

157 157 


163 163 

164Todo o tráfego viaja através da API Anthropic sobre TLS, o mesmo transporte de segurança que qualquer sessão do Claude Code. A conexão usa múltiplas credenciais de curta duração, cada uma com escopo para um único propósito e expirando independentemente.164Todo o tráfego viaja através da API Anthropic sobre TLS, o mesmo transporte de segurança que qualquer sessão do Claude Code. A conexão usa múltiplas credenciais de curta duração, cada uma com escopo para um único propósito e expirando independentemente.

165 165 

166Enquanto Remote Control está conectado, a transcrição da sessão, incluindo suas mensagens, respostas do Claude e atividade de ferramentas, é armazenada nos servidores Anthropic. A transcrição armazenada mantém a conversa sincronizada em seus dispositivos e permite que a sessão se reconecte após uma queda de rede. A execução e o acesso ao sistema de arquivos permanecem na sua máquina, e as transcrições armazenadas são retidas sob a política de [Uso de dados](/pt/data-usage).166Enquanto Remote Control está conectado, a transcrição da sessão, incluindo suas mensagens, respostas do Claude e atividade de ferramentas, é armazenada nos servidores Anthropic. A transcrição armazenada mantém a conversa sincronizada em seus dispositivos e permite que a sessão se reconecte após uma queda de rede. A execução e o acesso ao sistema de arquivos permanecem na sua máquina, e as transcrições armazenadas são retidas sob a política de [Uso de dados](/docs/pt/data-usage).

167 167 

168Para desativar Remote Control completamente, use a configuração [`disableRemoteControl`](/pt/settings#available-settings). Organizações com requisitos de conformidade, como Zero Data Retention, não podem ativar Remote Control.168Para desativar Remote Control completamente, use a configuração [`disableRemoteControl`](/docs/pt/settings#available-settings). Organizações com requisitos de conformidade, como Zero Data Retention, não podem ativar Remote Control.

169 169 

170<h2 id="trusted-devices">170<h2 id="trusted-devices">

171 Dispositivos Confiáveis171 Dispositivos Confiáveis


234 Remote Control vs Claude Code na web234 Remote Control vs Claude Code na web

235</h2>235</h2>

236 236 

237Remote Control e [Claude Code na web](/pt/claude-code-on-the-web) usam a interface claude.ai/code. A diferença fundamental é onde a sessão é executada: Remote Control é executado na sua máquina, portanto seus MCP servers locais, ferramentas e configuração do projeto permanecem disponíveis. Claude Code na web é executado em infraestrutura em nuvem gerenciada pela Anthropic.237Remote Control e [Claude Code na web](/docs/pt/claude-code-on-the-web) usam a interface claude.ai/code. A diferença fundamental é onde a sessão é executada: Remote Control é executado na sua máquina, portanto seus MCP servers locais, ferramentas e configuração do projeto permanecem disponíveis. Claude Code na web é executado em infraestrutura em nuvem gerenciada pela Anthropic.

238 238 

239Use Remote Control quando você está no meio do trabalho local e deseja continuar de outro dispositivo. Use Claude Code na web quando você deseja iniciar uma tarefa sem nenhuma configuração local, trabalhar em um repositório que você não tem clonado ou executar várias tarefas em paralelo.239Use Remote Control quando você está no meio do trabalho local e deseja continuar de outro dispositivo. Use Claude Code na web quando você deseja iniciar uma tarefa sem nenhuma configuração local, trabalhar em um repositório que você não tem clonado ou executar várias tarefas em paralelo.

240 240 


272* No iOS, os modos Focus e resumos de notificações podem suprimir ou atrasar pushes. Verifique Configurações → Notificações → Claude.272* No iOS, os modos Focus e resumos de notificações podem suprimir ou atrasar pushes. Verifique Configurações → Notificações → Claude.

273* No Android, a otimização agressiva de bateria pode atrasar a entrega. Isente o aplicativo Claude da otimização de bateria nas configurações do sistema.273* No Android, a otimização agressiva de bateria pode atrasar a entrega. Isente o aplicativo Claude da otimização de bateria nas configurações do sistema.

274 274 

275Claude Code pula notificações push móveis enquanto você está digitando ou focado no terminal conectado. {/* min-version: 2.1.181 */}A partir da v2.1.181, você pode definir [`CLAUDE_CLIENT_PRESENCE_FILE`](/pt/env-vars) para um caminho de arquivo marcador para estender isso para qualquer momento em que você esteja na máquina, mesmo em outra janela: notificações são puladas enquanto o arquivo existe. Configure um ouvinte de bloqueio de tela ou ferramenta similar para criar o arquivo quando sua tela desbloqueia e deletá-lo quando sua tela bloqueia.275Claude Code pula notificações push móveis enquanto você está digitando ou focado no terminal conectado. A partir da v2.1.181, você pode definir [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/pt/env-vars) para um caminho de arquivo marcador para estender isso para qualquer momento em que você esteja na máquina, mesmo em outra janela: notificações são puladas enquanto o arquivo existe. Configure um ouvinte de bloqueio de tela ou ferramenta similar para criar o arquivo quando sua tela desbloqueia e deletá-lo quando sua tela bloqueia.

276 276 

277<h2 id="limitations">277<h2 id="limitations">

278 Limitações278 Limitações


281* **Uma sessão remota por processo interativo**: fora do modo servidor, cada instância do Claude Code suporta uma sessão remota por vez. Use o [modo servidor](#start-a-remote-control-session) para executar várias sessões simultâneas a partir de um único processo.281* **Uma sessão remota por processo interativo**: fora do modo servidor, cada instância do Claude Code suporta uma sessão remota por vez. Use o [modo servidor](#start-a-remote-control-session) para executar várias sessões simultâneas a partir de um único processo.

282* **O processo local deve continuar em execução**: Remote Control é executado como um processo local. Se você fechar o terminal, sair do VS Code ou parar o processo `claude`, a sessão termina.282* **O processo local deve continuar em execução**: Remote Control é executado como um processo local. Se você fechar o terminal, sair do VS Code ou parar o processo `claude`, a sessão termina.

283* **Interrupção de rede estendida**: se sua máquina estiver ligada mas não conseguir alcançar a rede por mais de aproximadamente 10 minutos, a sessão expira e o processo sai. Execute `claude remote-control` novamente para iniciar uma nova sessão.283* **Interrupção de rede estendida**: se sua máquina estiver ligada mas não conseguir alcançar a rede por mais de aproximadamente 10 minutos, a sessão expira e o processo sai. Execute `claude remote-control` novamente para iniciar uma nova sessão.

284* **Ultraplan desconecta Remote Control**: iniciar uma sessão [ultraplan](/pt/ultraplan) desconecta qualquer sessão de Remote Control ativa porque ambos os recursos ocupam a interface claude.ai/code e apenas um pode estar conectado por vez.284* **Ultraplan desconecta Remote Control**: iniciar uma sessão [ultraplan](/docs/pt/ultraplan) desconecta qualquer sessão de Remote Control ativa porque ambos os recursos ocupam a interface claude.ai/code e apenas um pode estar conectado por vez.

285* **Alguns comandos são apenas locais**: comandos que funcionam apenas na interface do terminal, como `/plugin` ou `/resume`, funcionam apenas a partir da CLI local, independentemente de você passar um argumento ou não. Os seguintes funcionam a partir de dispositivos móveis e web:285* **Alguns comandos são apenas locais**: comandos que funcionam apenas na interface do terminal, como `/plugin` ou `/resume`, funcionam apenas a partir da CLI local, independentemente de você passar um argumento ou não. Os seguintes funcionam a partir de dispositivos móveis e web:

286 * Comandos de saída de texto: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits` (executa o formulário de texto em vez de abrir o diálogo na CLI), `/recap`, `/reload-plugins`286 * Comandos de saída de texto: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits` (executa o formulário de texto em vez de abrir o diálogo na CLI), `/recap`, `/reload-plugins`

287 * `/model`, `/effort`, `/fast`, `/color` e `/rename`: passe o valor como um argumento, por exemplo `/model sonnet` ou `/effort high`. A partir de dispositivos móveis e web, `/model` e `/effort` recebem o argumento no lugar do seletor do terminal ou controle deslizante.287 * `/model`, `/effort`, `/fast`, `/color` e `/rename`: passe o valor como um argumento, por exemplo `/model sonnet` ou `/effort high`. A partir de dispositivos móveis e web, `/model` e `/effort` recebem o argumento no lugar do seletor do terminal ou controle deslizante.

288 * {/* min-version: 2.1.166 */}`/mcp`, a partir da v2.1.166: a partir do aplicativo móvel, retorna um resumo de texto do status do servidor em vez de abrir o seletor. Na web, `/mcp` sozinho abre um diretório de [conectores claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) em vez de retornar o resumo. Os [subcomandos](/pt/commands#all-commands) `reconnect`, `enable` e `disable` funcionam em ambos. Diferentemente da CLI local, `/mcp reconnect` sem um nome de servidor reconecta todos os servidores que falharam ou precisam de autenticação.288 * `/mcp`, a partir da v2.1.166: a partir do aplicativo móvel, retorna um resumo de texto do status do servidor em vez de abrir o seletor. Na web, `/mcp` sozinho abre um diretório de [conectores claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) em vez de retornar o resumo. Os [subcomandos](/docs/pt/commands#all-commands) `reconnect`, `enable` e `disable` funcionam em ambos. Diferentemente da CLI local, `/mcp reconnect` sem um nome de servidor reconecta todos os servidores que falharam ou precisam de autenticação.

289 * {/* min-version: 2.1.181 */}`/config`, a partir da v2.1.181: a partir do aplicativo móvel, passe `key=value` para definir uma configuração, ou execute sem argumentos para listar as chaves que você pode definir. Na web, `/config` abre a seção Claude Code das suas configurações, e ignora o texto após o comando.289 * `/config`, a partir da v2.1.181: a partir do aplicativo móvel, passe `key=value` para definir uma configuração, ou execute sem argumentos para listar as chaves que você pode definir. Na web, `/config` abre a seção Claude Code das suas configurações, e ignora o texto após o comando.

290 290 

291<h2 id="troubleshooting">291<h2 id="troubleshooting">

292 Solução de problemas292 Solução de problemas


298 298 

299Você não está autenticado com uma conta claude.ai. Execute `claude auth login` e escolha a opção claude.ai. Se `ANTHROPIC_API_KEY` estiver definida em seu ambiente, desative-a primeiro.299Você não está autenticado com uma conta claude.ai. Execute `claude auth login` e escolha a opção claude.ai. Se `ANTHROPIC_API_KEY` estiver definida em seu ambiente, desative-a primeiro.

300 300 

301{/* min-version: 2.1.206 */}Antes da v2.1.206, executar `/remote-control` enquanto desconectado relatava `Unknown command: /remote-control` em vez desta mensagem.301Antes da v2.1.206, executar `/remote-control` enquanto desconectado relatava `Unknown command: /remote-control` em vez desta mensagem.

302 302 

303<h3 id="remote-control-requires-a-full-scope-login-token">303<h3 id="remote-control-requires-a-full-scope-login-token">

304 "Remote Control requires a full-scope login token"304 "Remote Control requires a full-scope login token"


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

329</h3>329</h3>

330 330 

331A sessão não está se comunicando diretamente com a API Anthropic, portanto não há backend claude.ai para emparelhar. Isso acontece no Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. {/* min-version: 2.1.196 */}A partir da v2.1.196, também acontece quando [`ANTHROPIC_BASE_URL`](/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/pt/llm-gateway) ou proxy, mesmo se você entrar com claude.ai. Desative `ANTHROPIC_BASE_URL` e reinicie a sessão para usar Remote Control.331A sessão não está se comunicando diretamente com a API Anthropic, portanto não há backend claude.ai para emparelhar. Isso acontece no Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. A partir da v2.1.196, também acontece quando [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) aponta para um host diferente de `api.anthropic.com`, como um [gateway LLM](/docs/pt/llm-gateway) ou proxy, mesmo se você entrar com claude.ai. Desative `ANTHROPIC_BASE_URL` e reinicie a sessão para usar Remote Control.

332 332 

333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

334 "Remote Control is disabled by your organization's policy"334 "Remote Control is disabled by your organization's policy"


339* **Você está autenticado com uma chave de API ou conta Console**: Remote Control requer OAuth claude.ai. Execute `/login` e escolha a opção claude.ai. Se `ANTHROPIC_API_KEY` estiver definida em seu ambiente, desative-a.339* **Você está autenticado com uma chave de API ou conta Console**: Remote Control requer OAuth claude.ai. Execute `/login` e escolha a opção claude.ai. Se `ANTHROPIC_API_KEY` estiver definida em seu ambiente, desative-a.

340* **Um Proprietário não ativou para sua organização**: Remote Control fica desativado por padrão nos planos Team e Enterprise. Um Proprietário pode ativá-lo em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) ativando o toggle **Remote Control**. Este toggle é uma configuração de organização no lado do servidor.340* **Um Proprietário não ativou para sua organização**: Remote Control fica desativado por padrão nos planos Team e Enterprise. Um Proprietário pode ativá-lo em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) ativando o toggle **Remote Control**. Este toggle é uma configuração de organização no lado do servidor.

341* **O toggle do administrador está acinzentado**: sua organização tem uma configuração de retenção de dados ou conformidade que é incompatível com Remote Control. Isso não pode ser alterado no painel de administração. Entre em contato com o suporte da Anthropic para discutir opções.341* **O toggle do administrador está acinzentado**: sua organização tem uma configuração de retenção de dados ou conformidade que é incompatível com Remote Control. Isso não pode ser alterado no painel de administração. Entre em contato com o suporte da Anthropic para discutir opções.

342* **O erro menciona `disableRemoteControl`**: seu administrador de TI desativou Remote Control neste dispositivo através de [configurações gerenciadas](/pt/settings#settings-files), independentemente do toggle em toda a organização.342* **O erro menciona `disableRemoteControl`**: seu administrador de TI desativou Remote Control neste dispositivo através de [configurações gerenciadas](/docs/pt/settings#settings-files), independentemente do toggle em toda a organização.

343 343 

344<h3 id="remote-credentials-fetch-failed">344<h3 id="remote-credentials-fetch-failed">

345 "Remote credentials fetch failed"345 "Remote credentials fetch failed"


365 365 

366Sua sessão local continua funcionando sem Remote Control. Execute `/remote-control` para tentar novamente a conexão, ou inicie Claude Code sem `--resume` para criar uma nova sessão de Remote Control.366Sua sessão local continua funcionando sem Remote Control. Execute `/remote-control` para tentar novamente a conexão, ou inicie Claude Code sem `--resume` para criar uma nova sessão de Remote Control.

367 367 

368{/* min-version: 2.1.200 */}Antes da v2.1.200, uma falha de reconexão criava uma nova sessão de Remote Control em vez de mostrar esta mensagem, o que deixava sessões extras na lista de sessões em claude.ai/code.368Antes da v2.1.200, uma falha de reconexão criava uma nova sessão de Remote Control em vez de mostrar esta mensagem, o que deixava sessões extras na lista de sessões em claude.ai/code.

369 369 

370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

371 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"371 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"


387 387 

388| | Trigger | Claude runs on | Setup | Best for |388| | Trigger | Claude runs on | Setup | Best for |

389| :--------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |389| :--------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |

390| [Dispatch](/en/desktop#sessions-from-dispatch) | Message a task from the Claude mobile app | Your machine (Desktop) | [Pair the mobile app with Desktop](https://support.claude.com/en/articles/13947068) | Delegating work while you're away, minimal setup |390| [Dispatch](/docs/en/desktop#sessions-from-dispatch) | Message a task from the Claude mobile app | Your machine (Desktop) | [Pair the mobile app with Desktop](https://support.claude.com/en/articles/13947068) | Delegating work while you're away, minimal setup |

391| [Remote Control](/en/remote-control) | Drive a running session from [claude.ai/code](https://claude.ai/code) or the Claude mobile app | Your machine (CLI or VS Code) | Run `claude remote-control` | Steering in-progress work from another device |391| [Remote Control](/docs/en/remote-control) | Drive a running session from [claude.ai/code](https://claude.ai/code) or the Claude mobile app | Your machine (CLI or VS Code) | Run `claude remote-control` | Steering in-progress work from another device |

392| [Channels](/en/channels) | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | [Install a channel plugin](/en/channels#quickstart) or [build your own](/en/channels-reference) | Reacting to external events like CI failures or chat messages |392| [Channels](/docs/en/channels) | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | [Install a channel plugin](/docs/en/channels#quickstart) or [build your own](/docs/en/channels-reference) | Reacting to external events like CI failures or chat messages |

393| [Slack](/en/slack) | Mention `@Claude` in a team channel | Anthropic cloud | [Install the Slack app](/en/slack#setting-up-claude-code-in-slack) with [Claude Code on the web](/en/claude-code-on-the-web) enabled | PRs and reviews from team chat |393| [Slack](/docs/en/slack) | Mention `@Claude` in a team channel | Anthropic cloud | [Install the Slack app](/docs/en/slack#setting-up-claude-code-in-slack) with [Claude Code on the web](/docs/en/claude-code-on-the-web) enabled | PRs and reviews from team chat |

394| [Scheduled tasks](/en/scheduled-tasks) | Set a schedule | [CLI](/en/scheduled-tasks), [Desktop](/en/desktop-scheduled-tasks), or [cloud](/en/routines) | Pick a frequency | Recurring automation like daily reviews |394| [Scheduled tasks](/docs/en/scheduled-tasks) | Set a schedule | [CLI](/docs/en/scheduled-tasks), [Desktop](/docs/en/desktop-scheduled-tasks), or [cloud](/docs/en/routines) | Pick a frequency | Recurring automation like daily reviews |

395 395 

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

397 Recursos relacionados397 Recursos relacionados

398</h2>398</h2>

399 399 

400* [Claude Code na web](/pt/claude-code-on-the-web): execute sessões em ambientes em nuvem gerenciados pela Anthropic em vez de na sua máquina400* [Claude Code na web](/docs/pt/claude-code-on-the-web): execute sessões em ambientes em nuvem gerenciados pela Anthropic em vez de na sua máquina

401* [Ultraplan](/pt/ultraplan): inicie uma sessão de planejamento em nuvem a partir do seu terminal e revise o plano no seu navegador401* [Ultraplan](/docs/pt/ultraplan): inicie uma sessão de planejamento em nuvem a partir do seu terminal e revise o plano no seu navegador

402* [Channels](/pt/channels): encaminhe Telegram, Discord ou iMessage para uma sessão para que Claude reaja a mensagens enquanto você está ausente402* [Channels](/docs/pt/channels): encaminhe Telegram, Discord ou iMessage para uma sessão para que Claude reaja a mensagens enquanto você está ausente

403* [Dispatch](/pt/desktop#sessions-from-dispatch): envie uma mensagem com uma tarefa do seu telefone e ela pode gerar uma sessão Desktop para lidar com isso403* [Dispatch](/docs/pt/desktop#sessions-from-dispatch): envie uma mensagem com uma tarefa do seu telefone e ela pode gerar uma sessão Desktop para lidar com isso

404* [Autenticação](/pt/authentication): configure `/login` e gerencie credenciais para claude.ai404* [Autenticação](/docs/pt/authentication): configure `/login` e gerencie credenciais para claude.ai

405* [Referência de CLI](/pt/cli-reference): lista completa de flags e comandos incluindo `claude remote-control`405* [Referência de CLI](/docs/pt/cli-reference): lista completa de flags e comandos incluindo `claude remote-control`

406* [Segurança](/pt/security): como as sessões de Remote Control se encaixam no modelo de segurança do Claude Code406* [Segurança](/docs/pt/security): como as sessões de Remote Control se encaixam no modelo de segurança do Claude Code

407* [Uso de dados](/pt/data-usage): quais dados fluem através da API Anthropic durante sessões locais e remotas407* [Uso de dados](/docs/pt/data-usage): quais dados fluem através da API Anthropic durante sessões locais e remotas

sandboxing.md +44 −44

Details

9O sandbox Bash permite que Claude execute a maioria dos comandos shell sem parar para pedir permissão. Em vez de aprovar cada comando, você define quais arquivos e domínios de rede os comandos podem acessar, e o sistema operacional impõe esse limite para cada comando Bash e seus processos filhos.9O sandbox Bash permite que Claude execute a maioria dos comandos shell sem parar para pedir permissão. Em vez de aprovar cada comando, você define quais arquivos e domínios de rede os comandos podem acessar, e o sistema operacional impõe esse limite para cada comando Bash e seus processos filhos.

10 10 

11<Note>11<Note>

12 Para comparar outras abordagens de isolamento, como dev containers, containers personalizados e máquinas virtuais, consulte [Sandbox environments](/pt/sandbox-environments). Para reduzir prompts de permissão para ferramentas diferentes de Bash, consulte [permission modes](/pt/permission-modes).12 Para comparar outras abordagens de isolamento, como dev containers, containers personalizados e máquinas virtuais, consulte [Sandbox environments](/docs/pt/sandbox-environments). Para reduzir prompts de permissão para ferramentas diferentes de Bash, consulte [permission modes](/docs/pt/permission-modes).

13</Note>13</Note>

14 14 

15<h2 id="get-started">15<h2 id="get-started">


31 Isso abre o painel de sandbox com três abas:31 Isso abre o painel de sandbox com três abas:

32 32 

33 * **Mode**: escolha como os comandos em sandbox são aprovados, abordado na próxima etapa33 * **Mode**: escolha como os comandos em sandbox são aprovados, abordado na próxima etapa

34 * **Overrides**: escolha se os comandos que falham sob o sandbox podem voltar a ser executados sem sandbox. Esta é a configuração [`allowUnsandboxedCommands`](/pt/settings#sandbox-settings)34 * **Overrides**: escolha se os comandos que falham sob o sandbox podem voltar a ser executados sem sandbox. Esta é a configuração [`allowUnsandboxedCommands`](/docs/pt/settings#sandbox-settings)

35 * **Config**: visualize as configurações de sandbox resolvidas35 * **Config**: visualize as configurações de sandbox resolvidas

36 36 

37 Se o painel mostrar apenas uma aba Dependencies, um pacote necessário está faltando. Instale-o conforme descrito em [Set up Linux and WSL2](#set-up-linux-and-wsl2), reinicie Claude Code e execute `/sandbox` novamente.37 Se o painel mostrar apenas uma aba Dependencies, um pacote necessário está faltando. Instale-o conforme descrito em [Set up Linux and WSL2](#set-up-linux-and-wsl2), reinicie Claude Code e execute `/sandbox` novamente.


48 </Step>48 </Step>

49</Steps>49</Steps>

50 50 

51Selecionar um modo no painel escreve nas configurações locais do seu projeto em `.claude/settings.local.json`, que se aplicam ao projeto atual e não são verificadas no git. Para habilitar o sandbox em todos os seus projetos, defina [`sandbox.enabled`](/pt/settings#sandbox-settings) como `true` em suas configurações de usuário em `~/.claude/settings.json`. Para impor sandboxing para cada desenvolvedor em uma organização, use [managed settings](#enforce-sandboxing-with-managed-settings).51Selecionar um modo no painel escreve nas configurações locais do seu projeto em `.claude/settings.local.json`, que se aplicam ao projeto atual e não são verificadas no git. Para habilitar o sandbox em todos os seus projetos, defina [`sandbox.enabled`](/docs/pt/settings#sandbox-settings) como `true` em suas configurações de usuário em `~/.claude/settings.json`. Para impor sandboxing para cada desenvolvedor em uma organização, use [managed settings](#enforce-sandboxing-with-managed-settings).

52 52 

53<Warning>53<Warning>

54 Por padrão, se o sandbox não conseguir iniciar porque as dependências estão faltando ou a plataforma não é suportada, Claude Code mostra um aviso e executa comandos sem sandboxing. Para tornar isso uma falha difícil em vez disso, defina [`sandbox.failIfUnavailable`](/pt/settings#sandbox-settings) como `true`. Isso é destinado a implantações gerenciadas que exigem sandboxing como um portão de segurança.54 Por padrão, se o sandbox não conseguir iniciar porque as dependências estão faltando ou a plataforma não é suportada, Claude Code mostra um aviso e executa comandos sem sandboxing. Para tornar isso uma falha difícil em vez disso, defina [`sandbox.failIfUnavailable`](/docs/pt/settings#sandbox-settings) como `true`. Isso é destinado a implantações gerenciadas que exigem sandboxing como um portão de segurança.

55</Warning>55</Warning>

56 56 

57<h3 id="set-up-linux-and-wsl2">57<h3 id="set-up-linux-and-wsl2">


111 <Accordion title="Notas do WSL2">111 <Accordion title="Notas do WSL2">

112 Verifique sua versão do WSL com `wsl -l -v` do PowerShell. Se você vir `Sandboxing requires WSL2`, sua distribuição está executando WSL1. Atualize-a para WSL2 ou execute Claude Code sem sandboxing.112 Verifique sua versão do WSL com `wsl -l -v` do PowerShell. Se você vir `Sandboxing requires WSL2`, sua distribuição está executando WSL1. Atualize-a para WSL2 ou execute Claude Code sem sandboxing.

113 113 

114 No WSL2, comandos em sandbox não podem iniciar binários do Windows como `cmd.exe`, `powershell.exe` ou qualquer coisa em `/mnt/c/`. WSL entrega esses para o host do Windows através de um socket Unix, que o sandbox bloqueia. Se um comando precisar invocar um binário do Windows, adicione-o a [`excludedCommands`](/pt/settings#sandbox-settings) para que seja executado fora do sandbox.114 No WSL2, comandos em sandbox não podem iniciar binários do Windows como `cmd.exe`, `powershell.exe` ou qualquer coisa em `/mnt/c/`. WSL entrega esses para o host do Windows através de um socket Unix, que o sandbox bloqueia. Se um comando precisar invocar um binário do Windows, adicione-o a [`excludedCommands`](/docs/pt/settings#sandbox-settings) para que seja executado fora do sandbox.

115 </Accordion>115 </Accordion>

116</AccordionGroup>116</AccordionGroup>

117 117 


121 121 

122Claude Code oferece dois modos de sandbox:122Claude Code oferece dois modos de sandbox:

123 123 

124**Modo auto-allow**: Comandos Bash tentarão ser executados dentro do sandbox e são automaticamente permitidos sem exigir permissão. Comandos que não podem ser colocados em sandbox, como aqueles que precisam de acesso à rede para hosts não permitidos, voltam ao fluxo de permissão regular, onde Claude Code verifica suas [permission rules](/pt/permissions) e solicita sua aprovação para qualquer comando que essas regras não permitam.124**Modo auto-allow**: Comandos Bash tentarão ser executados dentro do sandbox e são automaticamente permitidos sem exigir permissão. Comandos que não podem ser colocados em sandbox, como aqueles que precisam de acesso à rede para hosts não permitidos, voltam ao fluxo de permissão regular, onde Claude Code verifica suas [permission rules](/docs/pt/permissions) e solicita sua aprovação para qualquer comando que essas regras não permitam.

125 125 

126Mesmo no modo auto-allow, o seguinte ainda se aplica:126Mesmo no modo auto-allow, o seguinte ainda se aplica:

127 127 

128* [Deny rules](/pt/permissions) explícitas são sempre respeitadas128* [Deny rules](/docs/pt/permissions) explícitas são sempre respeitadas

129* Comandos `rm` ou `rmdir` que visam `/`, seu diretório home ou outros caminhos críticos do sistema ainda acionam um prompt de permissão129* Comandos `rm` ou `rmdir` que visam `/`, seu diretório home ou outros caminhos críticos do sistema ainda acionam um prompt de permissão

130* [Ask rules](/pt/permissions) com escopo de conteúdo como `Bash(git push *)` ainda forçam um prompt mesmo para comandos em sandbox130* [Ask rules](/docs/pt/permissions) com escopo de conteúdo como `Bash(git push *)` ainda forçam um prompt mesmo para comandos em sandbox

131* Uma regra ask `Bash` simples, ou o formulário equivalente `Bash(*)`, é ignorada para comandos executados em sandbox; ainda se aplica a comandos que voltam ao fluxo de permissão regular131* Uma regra ask `Bash` simples, ou o formulário equivalente `Bash(*)`, é ignorada para comandos executados em sandbox; ainda se aplica a comandos que voltam ao fluxo de permissão regular

132 132 

133**Modo regular permissions**: Todos os comandos Bash passam pelo fluxo de permissão regular, mesmo quando em sandbox. Isso fornece mais controle, mas requer mais aprovações.133**Modo regular permissions**: Todos os comandos Bash passam pelo fluxo de permissão regular, mesmo quando em sandbox. Isso fornece mais controle, mas requer mais aprovações.


136 136 

137O diretório temporário da sessão é gravável dentro do sandbox por padrão, junto com o diretório de trabalho. Claude Code define `$TMPDIR` para este diretório para comandos em sandbox, portanto ferramentas que escrevem arquivos temporários funcionam sem configuração extra. Comandos não em sandbox herdam o `$TMPDIR` do seu shell inalterado, o que significa que comandos em sandbox e não em sandbox resolvem `$TMPDIR` para diretórios diferentes. Para passar arquivos temporários entre os dois, escreva-os no diretório de trabalho em vez disso.137O diretório temporário da sessão é gravável dentro do sandbox por padrão, junto com o diretório de trabalho. Claude Code define `$TMPDIR` para este diretório para comandos em sandbox, portanto ferramentas que escrevem arquivos temporários funcionam sem configuração extra. Comandos não em sandbox herdam o `$TMPDIR` do seu shell inalterado, o que significa que comandos em sandbox e não em sandbox resolvem `$TMPDIR` para diretórios diferentes. Para passar arquivos temporários entre os dois, escreva-os no diretório de trabalho em vez disso.

138 138 

139Alguns comandos não podem ser executados dentro do sandbox, como ferramentas que são incompatíveis com ele ou que precisam de um host que você não permitiu. Em vez de falhar na tarefa ou exigir que você desative o sandboxing, Claude Code inclui um escape hatch: quando um comando falha por causa de restrições de sandbox, Claude analisa a falha e pode tentar novamente o comando com o parâmetro `dangerouslyDisableSandbox`. O comando retentado é executado fora do sandbox, portanto passa pelo fluxo de permissão regular: no modo padrão você recebe um prompt de confirmação; no [auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode) o classificador avalia o comando subjacente em vez de solicitar sua aprovação. Para ser solicitado em cada retentativa sem sandbox mesmo no modo auto, adicione uma [ask rule](/pt/permissions#match-by-input-parameter) para `Bash(dangerouslyDisableSandbox:true)`.139Alguns comandos não podem ser executados dentro do sandbox, como ferramentas que são incompatíveis com ele ou que precisam de um host que você não permitiu. Em vez de falhar na tarefa ou exigir que você desative o sandboxing, Claude Code inclui um escape hatch: quando um comando falha por causa de restrições de sandbox, Claude analisa a falha e pode tentar novamente o comando com o parâmetro `dangerouslyDisableSandbox`. O comando retentado é executado fora do sandbox, portanto passa pelo fluxo de permissão regular: no modo padrão você recebe um prompt de confirmação; no [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) o classificador avalia o comando subjacente em vez de solicitar sua aprovação. Para ser solicitado em cada retentativa sem sandbox mesmo no modo auto, adicione uma [ask rule](/docs/pt/permissions#match-by-input-parameter) para `Bash(dangerouslyDisableSandbox:true)`.

140 140 

141Você pode desabilitar esse escape hatch definindo `"allowUnsandboxedCommands": false` em suas [sandbox settings](/pt/settings#sandbox-settings). Quando desabilitado, que a aba Overrides do `/sandbox` mostra como **Strict sandbox mode**, o parâmetro `dangerouslyDisableSandbox` é completamente ignorado e todos os comandos devem ser executados em sandbox ou estar explicitamente listados em `excludedCommands`.141Você pode desabilitar esse escape hatch definindo `"allowUnsandboxedCommands": false` em suas [sandbox settings](/docs/pt/settings#sandbox-settings). Quando desabilitado, que a aba Overrides do `/sandbox` mostra como **Strict sandbox mode**, o parâmetro `dangerouslyDisableSandbox` é completamente ignorado e todos os comandos devem ser executados em sandbox ou estar explicitamente listados em `excludedCommands`.

142 142 

143<Info>143<Info>

144 O modo auto-allow funciona independentemente de sua configuração de permission mode. Mesmo que você não esteja no modo "accept edits", comandos Bash em sandbox serão executados automaticamente quando auto-allow estiver habilitado. Isso significa que comandos Bash que modificam arquivos dentro dos limites do sandbox serão executados sem avisar, mesmo quando ferramentas de edição de arquivo normalmente exigiriam aprovação.144 O modo auto-allow funciona independentemente de sua configuração de permission mode. Mesmo que você não esteja no modo "accept edits", comandos Bash em sandbox serão executados automaticamente quando auto-allow estiver habilitado. Isso significa que comandos Bash que modificam arquivos dentro dos limites do sandbox serão executados sem avisar, mesmo quando ferramentas de edição de arquivo normalmente exigiriam aprovação.


148 Configure sandboxing148 Configure sandboxing

149</h2>149</h2>

150 150 

151Personalize o comportamento do sandbox através de seu arquivo `settings.json`. Consulte [Settings](/pt/settings#sandbox-settings) para a referência de configuração completa.151Personalize o comportamento do sandbox através de seu arquivo `settings.json`. Consulte [Settings](/docs/pt/settings#sandbox-settings) para a referência de configuração completa.

152 152 

153Por padrão, comandos em sandbox podem escrever apenas no diretório de trabalho atual e no diretório temporário da sessão. Se comandos de subprocesso como `kubectl`, `terraform` ou `npm` precisarem escrever fora desses diretórios, use `sandbox.filesystem.allowWrite` para conceder acesso a caminhos específicos:153Por padrão, comandos em sandbox podem escrever apenas no diretório de trabalho atual e no diretório temporário da sessão. Se comandos de subprocesso como `kubectl`, `terraform` ou `npm` precisarem escrever fora desses diretórios, use `sandbox.filesystem.allowWrite` para conceder acesso a caminhos específicos:

154 154 


165 165 

166Esses caminhos são impostos no nível do SO, portanto todos os comandos executados dentro do sandbox, incluindo seus processos filhos, os respeitam. Esta é a abordagem recomendada quando uma ferramenta precisa de acesso de escrita a um local específico, em vez de excluir a ferramenta do sandbox inteiramente com `excludedCommands`.166Esses caminhos são impostos no nível do SO, portanto todos os comandos executados dentro do sandbox, incluindo seus processos filhos, os respeitam. Esta é a abordagem recomendada quando uma ferramenta precisa de acesso de escrita a um local específico, em vez de excluir a ferramenta do sandbox inteiramente com `excludedCommands`.

167 167 

168Quando o mesmo array de sistema de arquivos é definido em múltiplos [settings scopes](/pt/settings#settings-precedence), os arrays são mesclados: caminhos de cada escopo são combinados, não substituídos.168Quando o mesmo array de sistema de arquivos é definido em múltiplos [settings scopes](/docs/pt/settings#settings-precedence), os arrays são mesclados: caminhos de cada escopo são combinados, não substituídos.

169 169 

170Prefixos de caminho controlam como os caminhos são resolvidos:170Prefixos de caminho controlam como os caminhos são resolvidos:

171 171 


175| `~/` | Relativo ao diretório home | `~/.kube` torna-se `$HOME/.kube` |175| `~/` | Relativo ao diretório home | `~/.kube` torna-se `$HOME/.kube` |

176| `./` ou sem prefixo | Relativo à raiz do projeto para configurações de projeto, ou a `~/.claude` para configurações de usuário | `./output` em `.claude/settings.json` resolve para `<project-root>/output` |176| `./` ou sem prefixo | Relativo à raiz do projeto para configurações de projeto, ou a `~/.claude` para configurações de usuário | `./output` em `.claude/settings.json` resolve para `<project-root>/output` |

177 177 

178Esta sintaxe difere das [Read and Edit permission rules](/pt/permissions#read-and-edit), que usam `//path` para absoluto e `/path` para relativo ao projeto. Os caminhos do sistema de arquivos do sandbox usam convenções padrão: `/tmp/build` é absoluto.178Esta sintaxe difere das [Read and Edit permission rules](/docs/pt/permissions#read-and-edit), que usam `//path` para absoluto e `/path` para relativo ao projeto. Os caminhos do sistema de arquivos do sandbox usam convenções padrão: `/tmp/build` é absoluto.

179 179 

180Você também pode negar acesso de escrita ou leitura usando `sandbox.filesystem.denyWrite` e `sandbox.filesystem.denyRead`, e permitir novamente caminhos específicos dentro de uma região negada usando `sandbox.filesystem.allowRead`. Quando as regras de leitura se sobrepõem, o caminho mais específico vence:180Você também pode negar acesso de escrita ou leitura usando `sandbox.filesystem.denyWrite` e `sandbox.filesystem.denyRead`, e permitir novamente caminhos específicos dentro de uma região negada usando `sandbox.filesystem.allowRead`. Quando as regras de leitura se sobrepõem, o caminho mais específico vence:

181 181 


230 230 

231Entradas de arquivo suportam apenas `"mode": "deny"`. Entradas de variáveis de ambiente também aceitam `"mode": "mask"`, descrito abaixo.231Entradas de arquivo suportam apenas `"mode": "deny"`. Entradas de variáveis de ambiente também aceitam `"mode": "mask"`, descrito abaixo.

232 232 

233Os caminhos de arquivo seguem as mesmas [regras de prefixo](/pt/settings#sandbox-path-prefixes) que as configurações `sandbox.filesystem.*`, e as entradas `deny` de cada [settings scope](/pt/settings#settings-precedence) são mescladas. Uma entrada `deny` apenas restringe o acesso, portanto qualquer escopo pode adicionar uma, mas nenhum escopo pode remover uma que outro escopo adicionou.233Os caminhos de arquivo seguem as mesmas [regras de prefixo](/docs/pt/settings#sandbox-path-prefixes) que as configurações `sandbox.filesystem.*`, e as entradas `deny` de cada [settings scope](/docs/pt/settings#settings-precedence) são mescladas. Uma entrada `deny` apenas restringe o acesso, portanto qualquer escopo pode adicionar uma, mas nenhum escopo pode remover uma que outro escopo adicionou.

234 234 

235Não há uma lista de negação de credenciais integrada, portanto apenas os arquivos e variáveis que você listar são restritos. A configuração afeta apenas comandos Bash em sandbox. Para remover credenciais da Anthropic e de provedores de nuvem de todos os subprocessos independentemente do sandboxing, defina [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/pt/env-vars).235Não há uma lista de negação de credenciais integrada, portanto apenas os arquivos e variáveis que você listar são restritos. A configuração afeta apenas comandos Bash em sandbox. Para remover credenciais da Anthropic e de provedores de nuvem de todos os subprocessos independentemente do sandboxing, defina [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/pt/env-vars).

236 236 

237<h4 id="mask-environment-variables">237<h4 id="mask-environment-variables">

238 Mask environment variables238 Mask environment variables


242 242 

243Com `mask`, o comando em sandbox vê um valor sentinela por sessão em vez do real. Quando uma solicitação sai do sandbox para um dos `injectHosts` da credencial, o [sandbox proxy](#network-isolation) substitui o sentinela pelo valor real. O comando e tudo que ele registra nunca mantêm a credencial real, mas suas solicitações ainda se autenticam.243Com `mask`, o comando em sandbox vê um valor sentinela por sessão em vez do real. Quando uma solicitação sai do sandbox para um dos `injectHosts` da credencial, o [sandbox proxy](#network-isolation) substitui o sentinela pelo valor real. O comando e tudo que ele registra nunca mantêm a credencial real, mas suas solicitações ainda se autenticam.

244 244 

245O proxy substitui a credencial dentro do conteúdo da solicitação, portanto tem que vê-lo. Defina [`network.tlsTerminate`](/pt/settings#sandbox-settings) para que o proxy termine TLS em si. Sem isso, o mascaramento falha fechado: o comando ainda vê apenas o sentinela, mas o sentinela chega ao servidor inalterado e a autenticação falha. Claude Code relata essa configuração incorreta na inicialização.245O proxy substitui a credencial dentro do conteúdo da solicitação, portanto tem que vê-lo. Defina [`network.tlsTerminate`](/docs/pt/settings#sandbox-settings) para que o proxy termine TLS em si. Sem isso, o mascaramento falha fechado: o comando ainda vê apenas o sentinela, mas o sentinela chega ao servidor inalterado e a autenticação falha. Claude Code relata essa configuração incorreta na inicialização.

246 246 

247O exemplo abaixo mascara dois tokens. `GH_TOKEN` é substituído apenas em solicitações para `api.github.com`, enquanto `NPM_TOKEN` não tem `injectHosts` e é substituído em solicitações para cada host em `network.allowedDomains`. Cada entrada `injectHosts` deve ser coberta por `network.allowedDomains`.247O exemplo abaixo mascara dois tokens. `GH_TOKEN` é substituído apenas em solicitações para `api.github.com`, enquanto `NPM_TOKEN` não tem `injectHosts` e é substituído em solicitações para cada host em `network.allowedDomains`. Cada entrada `injectHosts` deve ser coberta por `network.allowedDomains`.

248 248 


264}264}

265```265```

266 266 

267Diferentemente de `deny`, o mascaramento autoriza o proxy a enviar sua credencial real para os hosts listados, portanto é honrado apenas a partir de configurações que você ou seu administrador controlam: configurações de usuário, configurações gerenciadas e o sinalizador CLI `--settings`. Entradas `mask`, `network.tlsTerminate` e [`credentials.allowPlaintextInject`](/pt/settings#sandbox-settings) no `.claude/settings.json` ou `.claude/settings.local.json` de um repositório são ignoradas.267Diferentemente de `deny`, o mascaramento autoriza o proxy a enviar sua credencial real para os hosts listados, portanto é honrado apenas a partir de configurações que você ou seu administrador controlam: configurações de usuário, configurações gerenciadas e o sinalizador CLI `--settings`. Entradas `mask`, `network.tlsTerminate` e [`credentials.allowPlaintextInject`](/docs/pt/settings#sandbox-settings) no `.claude/settings.json` ou `.claude/settings.local.json` de um repositório são ignoradas.

268 268 

269Quando a mesma variável é listada com `deny` em qualquer escopo, `deny` tem precedência.269Quando a mesma variável é listada com `deny` em qualquer escopo, `deny` tem precedência.

270 270 


281* **Comportamento padrão de escrita**: acesso de leitura e escrita ao diretório de trabalho atual e seus subdiretórios, além do diretório temporário da sessão para o qual `$TMPDIR` aponta281* **Comportamento padrão de escrita**: acesso de leitura e escrita ao diretório de trabalho atual e seus subdiretórios, além do diretório temporário da sessão para o qual `$TMPDIR` aponta

282* **Comportamento padrão de leitura**: acesso de leitura a todo o computador, exceto certos diretórios negados. Observe que esse padrão ainda permite ler arquivos de credenciais como `~/.aws/credentials` e `~/.ssh/`. Use [`sandbox.credentials`](#protect-credentials) para bloquear leituras desses arquivos e desconfigurar variáveis de ambiente secretas, ou adicione os caminhos a `denyRead`.282* **Comportamento padrão de leitura**: acesso de leitura a todo o computador, exceto certos diretórios negados. Observe que esse padrão ainda permite ler arquivos de credenciais como `~/.aws/credentials` e `~/.ssh/`. Use [`sandbox.credentials`](#protect-credentials) para bloquear leituras desses arquivos e desconfigurar variáveis de ambiente secretas, ou adicione os caminhos a `denyRead`.

283* **Acesso bloqueado**: não é possível modificar arquivos fora do diretório de trabalho atual e do diretório temporário da sessão sem permissão explícita, incluindo arquivos de configuração de shell como `~/.bashrc` e binários do sistema em `/bin/`283* **Acesso bloqueado**: não é possível modificar arquivos fora do diretório de trabalho atual e do diretório temporário da sessão sem permissão explícita, incluindo arquivos de configuração de shell como `~/.bashrc` e binários do sistema em `/bin/`

284* **Git worktrees**: quando o diretório de trabalho é um [git worktree vinculado](/pt/worktrees), o sandbox também permite escritas no diretório `.git` compartilhado do repositório principal para que comandos como `git commit` possam atualizar refs e o índice. As escritas em `hooks/` e `config` dentro desse diretório permanecem negadas.284* **Git worktrees**: quando o diretório de trabalho é um [git worktree vinculado](/docs/pt/worktrees), o sandbox também permite escritas no diretório `.git` compartilhado do repositório principal para que comandos como `git commit` possam atualizar refs e o índice. As escritas em `hooks/` e `config` dentro desse diretório permanecem negadas.

285* **Configurável**: defina caminhos permitidos e negados personalizados através de configurações285* **Configurável**: defina caminhos permitidos e negados personalizados através de configurações

286 286 

287Você pode conceder acesso de escrita a caminhos adicionais usando `sandbox.filesystem.allowWrite` em suas configurações. Essas restrições são impostas no nível do SO, portanto se aplicam a todos os comandos de subprocesso, incluindo ferramentas como `kubectl`, `terraform` e `npm`, não apenas às ferramentas de arquivo do Claude.287Você pode conceder acesso de escrita a caminhos adicionais usando `sandbox.filesystem.allowWrite` em suas configurações. Essas restrições são impostas no nível do SO, portanto se aplicam a todos os comandos de subprocesso, incluindo ferramentas como `kubectl`, `terraform` e `npm`, não apenas às ferramentas de arquivo do Claude.


292 292 

293O acesso à rede é controlado através de um servidor proxy executado fora do sandbox:293O acesso à rede é controlado através de um servidor proxy executado fora do sandbox:

294 294 

295* **Restrições de domínio**: nenhum domínio é pré-permitido. Na primeira vez que um comando precisa de um novo domínio, Claude Code solicita aprovação. {/* min-version: 2.1.191 */}A partir da v2.1.191, escolher Sim permite o host para o resto da sessão atual, portanto conexões posteriores ao mesmo host não solicitam novamente. Pré-permita domínios com [`allowedDomains`](/pt/settings#sandbox-settings) para evitar o prompt inteiramente.295* **Restrições de domínio**: nenhum domínio é pré-permitido. Na primeira vez que um comando precisa de um novo domínio, Claude Code solicita aprovação. A partir da v2.1.191, escolher Sim permite o host para o resto da sessão atual, portanto conexões posteriores ao mesmo host não solicitam novamente. Pré-permita domínios com [`allowedDomains`](/docs/pt/settings#sandbox-settings) para evitar o prompt inteiramente.

296* **Managed lockdown**: se [`allowManagedDomainsOnly`](/pt/settings#sandbox-settings) estiver definido em configurações gerenciadas, domínios não permitidos são bloqueados automaticamente em vez de solicitar, e apenas `allowedDomains` de configurações gerenciadas são honrados.296* **Managed lockdown**: se [`allowManagedDomainsOnly`](/docs/pt/settings#sandbox-settings) estiver definido em configurações gerenciadas, domínios não permitidos são bloqueados automaticamente em vez de solicitar, e apenas `allowedDomains` de configurações gerenciadas são honrados.

297* **Suporte a proxy personalizado**: usuários avançados podem implementar regras personalizadas no tráfego de saída297* **Suporte a proxy personalizado**: usuários avançados podem implementar regras personalizadas no tráfego de saída

298* **Cobertura abrangente**: as restrições se aplicam a todos os scripts, programas e subprocessos gerados por comandos298* **Cobertura abrangente**: as restrições se aplicam a todos os scripts, programas e subprocessos gerados por comandos

299 299 

300<Note>300<Note>

301 O proxy integrado impõe a allowlist com base no nome de host solicitado e, por padrão, não termina ou inspeciona tráfego TLS. {/* min-version: 2.1.199 */}A configuração experimental [`network.tlsTerminate`](/pt/settings#sandbox-settings), disponível no Claude Code v2.1.199 e posterior, faz com que o proxy integrado termine TLS em si mesmo, o que as entradas de credenciais [`mask`](#protect-credentials) exigem. Consulte [Limitações de segurança](#security-limitations) para as implicações do padrão, e [Configuração de proxy personalizado](#custom-proxy-configuration) se seu modelo de ameaça exigir inspeção TLS.301 O proxy integrado impõe a allowlist com base no nome de host solicitado e, por padrão, não termina ou inspeciona tráfego TLS. A configuração experimental [`network.tlsTerminate`](/docs/pt/settings#sandbox-settings), disponível no Claude Code v2.1.199 e posterior, faz com que o proxy integrado termine TLS em si mesmo, o que as entradas de credenciais [`mask`](#protect-credentials) exigem. Consulte [Limitações de segurança](#security-limitations) para as implicações do padrão, e [Configuração de proxy personalizado](#custom-proxy-configuration) se seu modelo de ameaça exigir inspeção TLS.

302</Note>302</Note>

303 303 

304<h3 id="os-level-enforcement">304<h3 id="os-level-enforcement">


313 313 

314WSL1 não é suportado porque bubblewrap requer recursos de kernel disponíveis apenas no WSL2. Essas restrições no nível do SO garantem que todos os processos filhos gerados pelos comandos do Claude Code herdem os mesmos limites de segurança.314WSL1 não é suportado porque bubblewrap requer recursos de kernel disponíveis apenas no WSL2. Essas restrições no nível do SO garantem que todos os processos filhos gerados pelos comandos do Claude Code herdem os mesmos limites de segurança.

315 315 

316Esses mesmos primitivos estão disponíveis como o pacote autônomo [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime), que a página [Sandbox environments](/pt/sandbox-environments#sandbox-runtime) aborda como uma abordagem separada para envolver todo o processo do Claude Code.316Esses mesmos primitivos estão disponíveis como o pacote autônomo [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime), que a página [Sandbox environments](/docs/pt/sandbox-environments#sandbox-runtime) aborda como uma abordagem separada para envolver todo o processo do Claude Code.

317 317 

318<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">318<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">

319 Como sandboxing se relaciona com permissões e modos de permissão319 Como sandboxing se relaciona com permissões e modos de permissão

320</h2>320</h2>

321 321 

322Sandboxing, [regras de permissão](/pt/permissions) e [modos de permissão](/pt/permission-modes) são camadas complementares. As seções abaixo abrangem como o sandbox interage com cada uma.322Sandboxing, [regras de permissão](/docs/pt/permissions) e [modos de permissão](/docs/pt/permission-modes) são camadas complementares. As seções abaixo abrangem como o sandbox interage com cada uma.

323 323 

324<h3 id="permission-rules">324<h3 id="permission-rules">

325 Regras de permissão325 Regras de permissão


353 Modos de permissão353 Modos de permissão

354</h3>354</h3>

355 355 

356`/sandbox` não é um [modo de permissão](/pt/permission-modes). Modos de permissão decidem se uma chamada de ferramenta é executada e se você é solicitado primeiro, enquanto o sandbox restringe o que um comando Bash pode acessar uma vez que é executado. Eles diferem no que controlam e o que substitui o prompt por ação:356`/sandbox` não é um [modo de permissão](/docs/pt/permission-modes). Modos de permissão decidem se uma chamada de ferramenta é executada e se você é solicitado primeiro, enquanto o sandbox restringe o que um comando Bash pode acessar uma vez que é executado. Eles diferem no que controlam e o que substitui o prompt por ação:

357 357 

358| | O que controla | O que substitui o prompt |358| | O que controla | O que substitui o prompt |

359| :----------------------------------------------------------------- | :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |359| :----------------------------------------------------------------- | :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

360| `/sandbox` | O que um comando Bash pode acessar uma vez que é executado | O limite do sandbox em si, no [modo auto-allow](#sandbox-modes) |360| `/sandbox` | O que um comando Bash pode acessar uma vez que é executado | O limite do sandbox em si, no [modo auto-allow](#sandbox-modes) |

361| [Modo auto](/pt/permission-modes#eliminate-prompts-with-auto-mode) | Se cada chamada de ferramenta é executada | Um classificador que revisa ações |361| [Modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) | Se cada chamada de ferramenta é executada | Um classificador que revisa ações |

362| `--dangerously-skip-permissions` | Se cada chamada de ferramenta é executada | Nada. Verificações de [caminho protegido](/pt/permission-modes#protected-paths) também são ignoradas; apenas [regras ask](/pt/permissions#manage-permissions) explícitas, ferramentas de conector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools), ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) e remover `/` ou seu diretório home ainda solicitam |362| `--dangerously-skip-permissions` | Se cada chamada de ferramenta é executada | Nada. Verificações de [caminho protegido](/docs/pt/permission-modes#protected-paths) também são ignoradas; apenas [regras ask](/docs/pt/permissions#manage-permissions) explícitas, ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) e remover `/` ou seu diretório home ainda solicitam |

363 363 

364O [modo auto-allow](#sandbox-modes) do sandbox é separado do [modo auto](/pt/permission-modes#eliminate-prompts-with-auto-mode): auto-allow aprova comandos Bash porque o limite do sandbox os contém, enquanto modo auto usa um classificador para revisar ações. Os dois funcionam independentemente e podem ser combinados. Para escolher um limite de isolamento para execuções autônomas, consulte [Ambientes de sandbox](/pt/sandbox-environments#how-isolation-relates-to-permission-modes).364O [modo auto-allow](#sandbox-modes) do sandbox é separado do [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode): auto-allow aprova comandos Bash porque o limite do sandbox os contém, enquanto modo auto usa um classificador para revisar ações. Os dois funcionam independentemente e podem ser combinados. Para escolher um limite de isolamento para execuções autônomas, consulte [Ambientes de sandbox](/docs/pt/sandbox-environments#how-isolation-relates-to-permission-modes).

365 365 

366<h2 id="configure-the-sandbox-for-your-organization">366<h2 id="configure-the-sandbox-for-your-organization">

367 Configure the sandbox for your organization367 Configure the sandbox for your organization


373 Enforce sandboxing with managed settings373 Enforce sandboxing with managed settings

374</h3>374</h3>

375 375 

376Para exigir o sandbox para cada desenvolvedor, entregue as chaves `sandbox` através de [managed settings](/pt/settings#settings-files), seja como um arquivo gerenciado pelo seu MDM ou através de [server-managed settings](/pt/server-managed-settings) no Claude.ai.376Para exigir o sandbox para cada desenvolvedor, entregue as chaves `sandbox` através de [managed settings](/docs/pt/settings#settings-files), seja como um arquivo gerenciado pelo seu MDM ou através de [server-managed settings](/docs/pt/server-managed-settings) no Claude.ai.

377 377 

378A seguinte configuração de managed settings habilita o sandbox, recusa iniciar Claude Code se o sandbox não conseguir inicializar e impede que o modelo tente novamente comandos fora do sandbox:378A seguinte configuração de managed settings habilita o sandbox, recusa iniciar Claude Code se o sandbox não conseguir inicializar e impede que o modelo tente novamente comandos fora do sandbox:

379 379 


402 402 

403Para chaves booleanas como `enabled` e `failIfUnavailable`, Claude Code usa o valor gerenciado e ignora qualquer coisa que um desenvolvedor defina localmente. Para chaves de array como `excludedCommands` e `allowRead`, Claude Code mescla entradas de cada escopo, portanto um desenvolvedor pode anexar entradas que ampliem a política.403Para chaves booleanas como `enabled` e `failIfUnavailable`, Claude Code usa o valor gerenciado e ignora qualquer coisa que um desenvolvedor defina localmente. Para chaves de array como `excludedCommands` e `allowRead`, Claude Code mescla entradas de cada escopo, portanto um desenvolvedor pode anexar entradas que ampliem a política.

404 404 

405Defina `allowManagedReadPathsOnly` como `true` em configurações gerenciadas para que apenas entradas `allowRead` de configurações gerenciadas sejam honradas. Entradas `allowRead` de usuário, projeto e local são ignoradas. Isso impede que desenvolvedores ampliem o acesso de leitura além dos caminhos aprovados pela organização. Para bloquear domínios de rede para os valores gerenciados da mesma forma, defina [`allowManagedDomainsOnly`](/pt/settings#sandbox-settings).405Defina `allowManagedReadPathsOnly` como `true` em configurações gerenciadas para que apenas entradas `allowRead` de configurações gerenciadas sejam honradas. Entradas `allowRead` de usuário, projeto e local são ignoradas. Isso impede que desenvolvedores ampliem o acesso de leitura além dos caminhos aprovados pela organização. Para bloquear domínios de rede para os valores gerenciados da mesma forma, defina [`allowManagedDomainsOnly`](/docs/pt/settings#sandbox-settings).

406 406 

407`excludedCommands` não tem um equivalente de lockdown apenas gerenciado, portanto um desenvolvedor sempre pode anexar entradas que executem comandos adicionais fora do sandbox. Mantenha a lista gerenciada estreita.407`excludedCommands` não tem um equivalente de lockdown apenas gerenciado, portanto um desenvolvedor sempre pode anexar entradas que executem comandos adicionais fora do sandbox. Mantenha a lista gerenciada estreita.

408 408 


417* Registrar todas as solicitações de rede417* Registrar todas as solicitações de rede

418* Integrar com infraestrutura de segurança existente418* Integrar com infraestrutura de segurança existente

419 419 

420Para apontar Claude Code para seu proxy, defina as portas de proxy em [sandbox settings](/pt/settings#sandbox-settings):420Para apontar Claude Code para seu proxy, defina as portas de proxy em [sandbox settings](/docs/pt/settings#sandbox-settings):

421 421 

422```json theme={null}422```json theme={null}

423{423{


438 438 

439* **Comandos falham com um erro host-not-allowed**: muitas ferramentas CLI precisam alcançar hosts específicos. Conceder permissão quando solicitado adiciona o host à sua lista de permitidos para que a ferramenta seja executada dentro do sandbox no futuro.439* **Comandos falham com um erro host-not-allowed**: muitas ferramentas CLI precisam alcançar hosts específicos. Conceder permissão quando solicitado adiciona o host à sua lista de permitidos para que a ferramenta seja executada dentro do sandbox no futuro.

440* **`jest` trava ou falha**: `watchman` é incompatível com o sandbox. Execute `jest --no-watchman` em vez disso.440* **`jest` trava ou falha**: `watchman` é incompatível com o sandbox. Execute `jest --no-watchman` em vez disso.

441* **CLIs baseadas em Go falham na verificação TLS no macOS**: ferramentas como `gh`, `gcloud` e `terraform` podem falhar na verificação TLS sob Seatbelt. Liste essas ferramentas em `excludedCommands` para executá-las fora do sandbox. Se você estiver usando `httpProxyPort` com um proxy MITM e CA personalizado, defina [`enableWeakerNetworkIsolation`](/pt/settings#sandbox-settings) como `true` em vez disso.441* **CLIs baseadas em Go falham na verificação TLS no macOS**: ferramentas como `gh`, `gcloud` e `terraform` podem falhar na verificação TLS sob Seatbelt. Liste essas ferramentas em `excludedCommands` para executá-las fora do sandbox. Se você estiver usando `httpProxyPort` com um proxy MITM e CA personalizado, defina [`enableWeakerNetworkIsolation`](/docs/pt/settings#sandbox-settings) como `true` em vez disso.

442* **`open`, `osascript`, ou fluxos de autenticação baseados em navegador falham com erro `-600` no macOS**: o sandbox bloqueia Apple Events por padrão. Defina [`allowAppleEvents`](/pt/settings#sandbox-settings) como `true` em suas configurações de usuário, gerenciadas ou CLI para permitir. As configurações do projeto são ignoradas para esta chave. Habilitá-lo remove o isolamento de execução de código, pois comandos em sandbox podem então iniciar outras aplicações sem sandbox sem prompt do usuário e enviar comandos AppleScript para aplicações em execução, sujeito ao prompt de consentimento de automação do macOS (TCC). Alternativamente, adicione o comando a `excludedCommands` para executá-lo fora do sandbox.442* **`open`, `osascript`, ou fluxos de autenticação baseados em navegador falham com erro `-600` no macOS**: o sandbox bloqueia Apple Events por padrão. Defina [`allowAppleEvents`](/docs/pt/settings#sandbox-settings) como `true` em suas configurações de usuário, gerenciadas ou CLI para permitir. As configurações do projeto são ignoradas para esta chave. Habilitá-lo remove o isolamento de execução de código, pois comandos em sandbox podem então iniciar outras aplicações sem sandbox sem prompt do usuário e enviar comandos AppleScript para aplicações em execução, sujeito ao prompt de consentimento de automação do macOS (TCC). Alternativamente, adicione o comando a `excludedCommands` para executá-lo fora do sandbox.

443* **Comandos `docker` falham**: `docker` é incompatível com o sandbox. Adicione `docker *` a `excludedCommands` para executá-lo fora do sandbox.443* **Comandos `docker` falham**: `docker` é incompatível com o sandbox. Adicione `docker *` a `excludedCommands` para executá-lo fora do sandbox.

444* **Bubblewrap falha ao iniciar dentro de um container**: em um container sem privilégios, bubblewrap não consegue montar um sistema de arquivos `/proc` fresco. Defina [`enableWeakerNestedSandbox`](/pt/settings#sandbox-settings) como `true` para que o sandbox interno faça bind-mount do `/proc` existente do container em vez disso. Use esta configuração apenas quando o container externo já fornece o limite de isolamento que você precisa, pois expõe informações de processo a comandos em sandbox que uma montagem `/proc` fresca ocultaria.444* **Bubblewrap falha ao iniciar dentro de um container**: em um container sem privilégios, bubblewrap não consegue montar um sistema de arquivos `/proc` fresco. Defina [`enableWeakerNestedSandbox`](/docs/pt/settings#sandbox-settings) como `true` para que o sandbox interno faça bind-mount do `/proc` existente do container em vez disso. Use esta configuração apenas quando o container externo já fornece o limite de isolamento que você precisa, pois expõe informações de processo a comandos em sandbox que uma montagem `/proc` fresca ocultaria.

445* **Filtro seccomp no Linux**: o filtro seccomp é necessário para bloquear sockets de domínio Unix. A aba Dependencies em `/sandbox` mostra se está disponível. Se estiver faltando, execute `npm install -g @anthropic-ai/sandbox-runtime` para instalar o helper.445* **Filtro seccomp no Linux**: o filtro seccomp é necessário para bloquear sockets de domínio Unix. A aba Dependencies em `/sandbox` mostra se está disponível. Se estiver faltando, execute `npm install -g @anthropic-ai/sandbox-runtime` para instalar o helper.

446* **`--dangerously-skip-permissions` falha como root**: este sinalizador é bloqueado ao executar como root ou via sudo no Linux e macOS, porque acesso root combinado com nenhum prompt de permissão pode modificar qualquer arquivo ou serviço no sistema. A verificação é ignorada automaticamente dentro de um sandbox reconhecido. Para executar autonomamente em um container, use a configuração [dev container](/pt/devcontainer), que executa Claude Code como um usuário não-root.446* **`--dangerously-skip-permissions` falha como root**: este sinalizador é bloqueado ao executar como root ou via sudo no Linux e macOS, porque acesso root combinado com nenhum prompt de permissão pode modificar qualquer arquivo ou serviço no sistema. A verificação é ignorada automaticamente dentro de um sandbox reconhecido. Para executar autonomamente em um container, use a configuração [dev container](/docs/pt/devcontainer), que executa Claude Code como um usuário não-root.

447 447 

448<h2 id="limitations">448<h2 id="limitations">

449 Limitações449 Limitações


455 Limitações de segurança455 Limitações de segurança

456</h3>456</h3>

457 457 

458* **Filtragem de rede**: o sandbox restringe quais domínios os processos podem se conectar. Por padrão, o proxy integrado não termina ou inspeciona TLS no tráfego de saída, portanto o conteúdo de conexões criptografadas não é examinado. A configuração experimental [`network.tlsTerminate`](/pt/settings#sandbox-settings) termina TLS no proxy para [substituição de credenciais `mask`](#protect-credentials), mas não adiciona filtragem de conteúdo. Você é responsável por garantir que apenas domínios confiáveis sejam permitidos em sua política.458* **Filtragem de rede**: o sandbox restringe quais domínios os processos podem se conectar. Por padrão, o proxy integrado não termina ou inspeciona TLS no tráfego de saída, portanto o conteúdo de conexões criptografadas não é examinado. A configuração experimental [`network.tlsTerminate`](/docs/pt/settings#sandbox-settings) termina TLS no proxy para [substituição de credenciais `mask`](#protect-credentials), mas não adiciona filtragem de conteúdo. Você é responsável por garantir que apenas domínios confiáveis sejam permitidos em sua política.

459 459 

460<Warning>460<Warning>

461 Permitir domínios amplos como `github.com` pode criar caminhos para exfiltração de dados. Como o proxy toma sua decisão de permissão do nome de host fornecido pelo cliente sem inspecionar TLS, código executado dentro do sandbox pode potencialmente usar [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) ou técnicas similares para alcançar hosts fora da allowlist. Se seu modelo de ameaça exigir garantias mais fortes, configure um [custom proxy](#custom-proxy-configuration) que termine TLS e inspecione tráfego, e instale seu certificado CA dentro do sandbox. Isolamento de rede mais forte e consciente de TLS é uma área ativa de desenvolvimento.461 Permitir domínios amplos como `github.com` pode criar caminhos para exfiltração de dados. Como o proxy toma sua decisão de permissão do nome de host fornecido pelo cliente sem inspecionar TLS, código executado dentro do sandbox pode potencialmente usar [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) ou técnicas similares para alcançar hosts fora da allowlist. Se seu modelo de ameaça exigir garantias mais fortes, configure um [custom proxy](#custom-proxy-configuration) que termine TLS e inspecione tráfego, e instale seu certificado CA dentro do sandbox. Isolamento de rede mais forte e consciente de TLS é uma área ativa de desenvolvimento.


481 481 

482O sandbox isola subprocessos Bash. Outras ferramentas operam sob limites diferentes:482O sandbox isola subprocessos Bash. Outras ferramentas operam sob limites diferentes:

483 483 

484* **Ferramentas de arquivo integradas**: Read, Edit e Write usam o sistema de permissão diretamente em vez de serem executadas através do sandbox. Consulte [permissions](/pt/permissions).484* **Ferramentas de arquivo integradas**: Read, Edit e Write usam o sistema de permissão diretamente em vez de serem executadas através do sandbox. Consulte [permissions](/docs/pt/permissions).

485* **Computer use**: quando Claude abre aplicativos e controla sua tela, ele é executado em seu desktop real em vez de em um ambiente isolado. Prompts de permissão por aplicativo controlam cada aplicativo. Consulte [computer use in the CLI](/pt/computer-use) ou [computer use in Desktop](/pt/desktop#let-claude-use-your-computer).485* **Computer use**: quando Claude abre aplicativos e controla sua tela, ele é executado em seu desktop real em vez de em um ambiente isolado. Prompts de permissão por aplicativo controlam cada aplicativo. Consulte [computer use in the CLI](/docs/pt/computer-use) ou [computer use in Desktop](/docs/pt/desktop#let-claude-use-your-computer).

486* **Variáveis de ambiente**: comandos Bash em sandbox herdam o ambiente do processo pai por padrão, incluindo quaisquer credenciais definidas lá. Use [`sandbox.credentials`](#protect-credentials) para remover ou mascarar variáveis específicas para comandos em sandbox, ou defina [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/pt/env-vars) para remover credenciais do Anthropic e do provedor de nuvem de todos os subprocessos.486* **Variáveis de ambiente**: comandos Bash em sandbox herdam o ambiente do processo pai por padrão, incluindo quaisquer credenciais definidas lá. Use [`sandbox.credentials`](#protect-credentials) para remover ou mascarar variáveis específicas para comandos em sandbox, ou defina [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/pt/env-vars) para remover credenciais do Anthropic e do provedor de nuvem de todos os subprocessos.

487* **Subagents**: [subagents](/pt/sub-agents) são executados no mesmo processo que a sessão pai e usam a mesma configuração de sandbox. Comandos Bash dentro de um subagent são colocados em sandbox quando sandboxing está habilitado na sessão pai.487* **Subagents**: [subagents](/docs/pt/sub-agents) são executados no mesmo processo que a sessão pai e usam a mesma configuração de sandbox. Comandos Bash dentro de um subagent são colocados em sandbox quando sandboxing está habilitado na sessão pai.

488 488 

489<Warning>489<Warning>

490 Sandboxing eficaz requer isolamento tanto de sistema de arquivos quanto de rede. Sem isolamento de rede, um agente comprometido poderia exfiltrar arquivos sensíveis como chaves SSH. Sem isolamento de sistema de arquivos, um agente comprometido poderia fazer backdoor de recursos do sistema para obter acesso à rede. Quando você amplia os padrões, verifique que um caminho `allowWrite`, uma entrada `allowedDomains` ampla ou uma exceção `excludedCommands` não desfaz uma restrição no outro lado.490 Sandboxing eficaz requer isolamento tanto de sistema de arquivos quanto de rede. Sem isolamento de rede, um agente comprometido poderia exfiltrar arquivos sensíveis como chaves SSH. Sem isolamento de sistema de arquivos, um agente comprometido poderia fazer backdoor de recursos do sistema para obter acesso à rede. Quando você amplia os padrões, verifique que um caminho `allowWrite`, uma entrada `allowedDomains` ampla ou uma exceção `excludedCommands` não desfaz uma restrição no outro lado.


494 Veja também494 Veja também

495</h2>495</h2>

496 496 

497* [Sandbox environments](/pt/sandbox-environments): compare o sandbox integrado com dev containers, containers e VMs497* [Sandbox environments](/docs/pt/sandbox-environments): compare o sandbox integrado com dev containers, containers e VMs

498* [Security](/pt/security): recursos de segurança abrangentes e melhores práticas498* [Security](/docs/pt/security): recursos de segurança abrangentes e melhores práticas

499* [Permissions](/pt/permissions): configuração de permissão e controle de acesso499* [Permissions](/docs/pt/permissions): configuração de permissão e controle de acesso

500* [Settings](/pt/settings): referência de configuração completa500* [Settings](/docs/pt/settings): referência de configuração completa

501* [CLI reference](/pt/cli-reference): opções de linha de comando501* [CLI reference](/docs/pt/cli-reference): opções de linha de comando

scheduled-tasks.md +17 −17

Details

6 6 

7> Use /loop e as ferramentas de agendamento cron para executar prompts repetidamente, pesquisar status ou definir lembretes únicos em uma sessão do Claude Code.7> Use /loop e as ferramentas de agendamento cron para executar prompts repetidamente, pesquisar status ou definir lembretes únicos em uma sessão do Claude Code.

8 8 

9Tarefas agendadas permitem que Claude execute novamente um prompt automaticamente em um intervalo. Use-as para pesquisar uma implantação, cuidar de um PR, verificar uma compilação de longa duração ou lembrar-se de fazer algo mais tarde na sessão. Para reagir a eventos conforme eles acontecem em vez de pesquisar, consulte [Channels](/pt/channels): seu CI pode enviar a falha para a sessão diretamente. Para manter a sessão funcionando turno após turno até que uma condição seja atendida em vez de em um intervalo, consulte [`/goal`](/pt/goal).9Tarefas agendadas permitem que Claude execute novamente um prompt automaticamente em um intervalo. Use-as para pesquisar uma implantação, cuidar de um PR, verificar uma compilação de longa duração ou lembrar-se de fazer algo mais tarde na sessão. Para reagir a eventos conforme eles acontecem em vez de pesquisar, consulte [Channels](/docs/pt/channels): seu CI pode enviar a falha para a sessão diretamente. Para manter a sessão funcionando turno após turno até que uma condição seja atendida em vez de em um intervalo, consulte [`/goal`](/docs/pt/goal).

10 10 

11As tarefas têm escopo de sessão: elas vivem na conversa atual e param quando você inicia uma nova. Retomar com `--resume` ou `--continue` traz de volta qualquer tarefa que não tenha [expirado](#seven-day-expiry): uma tarefa recorrente criada nos últimos 7 dias, ou uma única cujo tempo agendado ainda não passou. Para agendamento que sobreviva independentemente de qualquer sessão, use [Routines](/pt/routines) para criar uma rotina na infraestrutura gerenciada pela Anthropic, configure uma [tarefa agendada do Desktop](/pt/desktop-scheduled-tasks) ou use [GitHub Actions](/pt/github-actions).11As tarefas têm escopo de sessão: elas vivem na conversa atual e param quando você inicia uma nova. Retomar com `--resume` ou `--continue` traz de volta qualquer tarefa que não tenha [expirado](#seven-day-expiry): uma tarefa recorrente criada nos últimos 7 dias, ou uma única cujo tempo agendado ainda não passou. Para agendamento que sobreviva independentemente de qualquer sessão, use [Routines](/docs/pt/routines) para criar uma rotina na infraestrutura gerenciada pela Anthropic, configure uma [tarefa agendada do Desktop](/docs/pt/desktop-scheduled-tasks) ou use [GitHub Actions](/docs/pt/github-actions).

12 12 

13<h2 id="compare-scheduling-options">13<h2 id="compare-scheduling-options">

14 Comparar opções de agendamento14 Comparar opções de agendamento


16 16 

17Claude Code offers three ways to schedule recurring or one-off work:17Claude Code offers three ways to schedule recurring or one-off work:

18 18 

19| | [Cloud](/en/routines) | [Desktop](/en/desktop-scheduled-tasks) | [`/loop`](/en/scheduled-tasks) |19| | [Cloud](/docs/en/routines) | [Desktop](/docs/en/desktop-scheduled-tasks) | [`/loop`](/docs/en/scheduled-tasks) |

20| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- |20| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- |

21| Runs on | Anthropic cloud | Your machine | Your machine |21| Runs on | Anthropic cloud | Your machine | Your machine |

22| Requires machine on | No | Yes | Yes |22| Requires machine on | No | Yes | Yes |

23| Requires open session | No | No | Yes |23| Requires open session | No | No | Yes |

24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |

25| Access to local files | No (fresh clone) | Yes | Yes |25| Access to local files | No (fresh clone) | Yes | Yes |

26| MCP servers | Connectors configured per task | [Config files](/en/mcp) and connectors | Inherits from session |26| MCP servers | Connectors configured per task | [Config files](/docs/en/mcp) and connectors | Inherits from session |

27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |

28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |

29| Minimum interval | 1 hour | 1 minute | 1 minute |29| Minimum interval | 1 hour | 1 minute | 1 minute |


36 Execute um prompt repetidamente com /loop36 Execute um prompt repetidamente com /loop

37</h2>37</h2>

38 38 

39A skill agrupada `/loop` [bundled skill](/pt/commands) é a maneira mais rápida de executar um prompt repetidamente enquanto a sessão permanece aberta. Tanto o intervalo quanto o prompt são opcionais, e o que você fornece determina como o loop se comporta.39A skill agrupada `/loop` [bundled skill](/docs/pt/commands) é a maneira mais rápida de executar um prompt repetidamente enquanto a sessão permanece aberta. Tanto o intervalo quanto o prompt são opcionais, e o que você fornece determina como o loop se comporta.

40 40 

41| O que você fornece | Exemplo | O que acontece |41| O que você fornece | Exemplo | O que acontece |

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


44| Apenas prompt | `/loop check the deploy` | Seu prompt é executado em um [intervalo que Claude escolhe](#let-claude-choose-the-interval) a cada iteração |44| Apenas prompt | `/loop check the deploy` | Seu prompt é executado em um [intervalo que Claude escolhe](#let-claude-choose-the-interval) a cada iteração |

45| Apenas intervalo, ou nada | `/loop` | O [prompt de manutenção integrado](#run-the-built-in-maintenance-prompt) é executado, ou seu `loop.md` se existir |45| Apenas intervalo, ou nada | `/loop` | O [prompt de manutenção integrado](#run-the-built-in-maintenance-prompt) é executado, ou seu `loop.md` se existir |

46 46 

47Você também pode passar uma skill como o prompt, por exemplo `/loop 20m /review-pr 1234`, para re-executar essa skill a cada iteração. {/* min-version: 2.1.196 */}A partir da v2.1.196, um disparo agendado executa apenas skills que Claude [tem permissão para invocar por conta própria](/pt/skills#control-who-invokes-a-skill). Os seguintes chegam a Claude como texto simples em vez de executar:47Você também pode passar uma skill como o prompt, por exemplo `/loop 20m /review-pr 1234`, para re-executar essa skill a cada iteração. A partir da v2.1.196, um disparo agendado executa apenas skills que Claude [tem permissão para invocar por conta própria](/docs/pt/skills#control-who-invokes-a-skill). Os seguintes chegam a Claude como texto simples em vez de executar:

48 48 

49* comandos integrados como `/permissions`, `/model`, ou `/clear`49* comandos integrados como `/permissions`, `/model`, ou `/clear`

50* skills marcadas [`disable-model-invocation: true`](/pt/skills#frontmatter-reference)50* skills marcadas [`disable-model-invocation: true`](/docs/pt/skills#frontmatter-reference)

51* skills retidas de Claude por uma configuração [`skillOverrides`](/pt/skills#override-skill-visibility-from-settings) ou uma regra de [negação](/pt/skills#restrict-claude’s-skill-access) de `Skill`51* skills retidas de Claude por uma configuração [`skillOverrides`](/docs/pt/skills#override-skill-visibility-from-settings) ou uma regra de [negação](/docs/pt/skills#restrict-claude’s-skill-access) de `Skill`

52* [prompts MCP](/pt/mcp#use-mcp-prompts-as-commands) como `/mcp__github__list_prs`; skills que um servidor MCP expõe ainda são executadas52* [prompts MCP](/docs/pt/mcp#use-mcp-prompts-as-commands) como `/mcp__github__list_prs`; skills que um servidor MCP expõe ainda são executadas

53 53 

54<h3 id="run-on-a-fixed-interval">54<h3 id="run-on-a-fixed-interval">

55 Execute em um intervalo fixo55 Execute em um intervalo fixo


77/loop check whether CI passed and address any review comments77/loop check whether CI passed and address any review comments

78```78```

79 79 

80Quando você pede um cronograma `/loop` dinâmico, Claude pode usar a [ferramenta Monitor](/pt/tools-reference#monitor-tool) diretamente. Monitor executa um script em segundo plano e transmite cada linha de saída de volta, o que evita pesquisa completamente e geralmente é mais eficiente em tokens e responsivo do que re-executar um prompt em um intervalo.80Quando você pede um cronograma `/loop` dinâmico, Claude pode usar a [ferramenta Monitor](/docs/pt/tools-reference#monitor-tool) diretamente. Monitor executa um script em segundo plano e transmite cada linha de saída de volta, o que evita pesquisa completamente e geralmente é mais eficiente em tokens e responsivo do que re-executar um prompt em um intervalo.

81 81 

82Um loop agendado dinamicamente aparece em sua [lista de tarefas agendadas](#manage-scheduled-tasks) como qualquer outra tarefa, portanto você pode listá-lo ou cancelá-lo da mesma forma. As [regras de jitter](#jitter) não se aplicam a ele, mas a [expiração de sete dias](#seven-day-expiry) se aplica: o loop termina automaticamente sete dias após você iniciá-lo.82Um loop agendado dinamicamente aparece em sua [lista de tarefas agendadas](#manage-scheduled-tasks) como qualquer outra tarefa, portanto você pode listá-lo ou cancelá-lo da mesma forma. As [regras de jitter](#jitter) não se aplicam a ele, mas a [expiração de sete dias](#seven-day-expiry) se aplica: o loop termina automaticamente sete dias após você iniciá-lo.

83 83 


141 141 

142Para parar um `/loop` enquanto ele está aguardando a próxima iteração, pressione `Esc`. Isso limpa o despertar pendente para que o loop não dispare novamente. As tarefas que você agendou [pedindo a Claude diretamente](#manage-scheduled-tasks) não são afetadas por `Esc` e permanecem no lugar até que você as delete.142Para parar um `/loop` enquanto ele está aguardando a próxima iteração, pressione `Esc`. Isso limpa o despertar pendente para que o loop não dispare novamente. As tarefas que você agendou [pedindo a Claude diretamente](#manage-scheduled-tasks) não são afetadas por `Esc` e permanecem no lugar até que você as delete.

143 143 

144Em [modo de ritmo próprio](#let-claude-choose-the-interval), Claude também pode encerrar o loop por conta própria uma vez que a tarefa está completa. Claude chama a [ferramenta `ScheduleWakeup`](/pt/tools-reference) com `stop: true`, o que cancela o despertar pendente imediatamente. Se uma iteração terminar sem reagendar ou parar, Claude Code agenda um despertar de fallback cerca de 20 minutos depois e encerra o loop quando essa iteração também não reagendar. Antes da v2.1.202, não reagendar era a única maneira de Claude poder encerrar um loop por conta própria.144Em [modo de ritmo próprio](#let-claude-choose-the-interval), Claude também pode encerrar o loop por conta própria uma vez que a tarefa está completa. Claude chama a [ferramenta `ScheduleWakeup`](/docs/pt/tools-reference) com `stop: true`, o que cancela o despertar pendente imediatamente. Se uma iteração terminar sem reagendar ou parar, Claude Code agenda um despertar de fallback cerca de 20 minutos depois e encerra o loop quando essa iteração também não reagendar. Antes da v2.1.202, não reagendar era a única maneira de Claude poder encerrar um loop por conta própria.

145 145 

146Loops em um intervalo fixo continuam em execução até que você os pare ou [sete dias se passem](#seven-day-expiry).146Loops em um intervalo fixo continuam em execução até que você os pare ou [sete dias se passem](#seven-day-expiry).

147 147 


208 Expiração de sete dias208 Expiração de sete dias

209</h3>209</h3>

210 210 

211Tarefas recorrentes expiram automaticamente 7 dias após a criação. A tarefa é acionada uma última vez e depois se deleta. Isso limita quanto tempo um loop esquecido pode ser executado. Se você precisar que uma tarefa recorrente dure mais tempo, cancele e recrie-a antes de expirar, ou use [Routines](/pt/routines) ou [tarefas agendadas do Desktop](/pt/desktop-scheduled-tasks) para agendamento durável.211Tarefas recorrentes expiram automaticamente 7 dias após a criação. A tarefa é acionada uma última vez e depois se deleta. Isso limita quanto tempo um loop esquecido pode ser executado. Se você precisar que uma tarefa recorrente dure mais tempo, cancele e recrie-a antes de expirar, ou use [Routines](/docs/pt/routines) ou [tarefas agendadas do Desktop](/docs/pt/desktop-scheduled-tasks) para agendamento durável.

212 212 

213<h2 id="cron-expression-reference">213<h2 id="cron-expression-reference">

214 Referência de expressão cron214 Referência de expressão cron


233 Desabilite tarefas agendadas233 Desabilite tarefas agendadas

234</h2>234</h2>

235 235 

236Defina `CLAUDE_CODE_DISABLE_CRON=1` em seu ambiente para desabilitar o agendador completamente. As ferramentas cron e `/loop` ficam indisponíveis e qualquer tarefa já agendada para de ser acionada. Consulte [Variáveis de ambiente](/pt/env-vars) para a lista completa de sinalizadores de desabilitação.236Defina `CLAUDE_CODE_DISABLE_CRON=1` em seu ambiente para desabilitar o agendador completamente. As ferramentas cron e `/loop` ficam indisponíveis e qualquer tarefa já agendada para de ser acionada. Consulte [Variáveis de ambiente](/docs/pt/env-vars) para a lista completa de sinalizadores de desabilitação.

237 237 

238<h2 id="limitations">238<h2 id="limitations">

239 Limitações239 Limitações


241 241 

242O agendamento com escopo de sessão tem limitações inerentes:242O agendamento com escopo de sessão tem limitações inerentes:

243 243 

244* As tarefas só são acionadas enquanto Claude Code está em execução e ocioso. Fechar o terminal ou deixar a sessão sair para tudo. [Colocar a sessão em segundo plano](/pt/agent-view#from-inside-a-session) leva tarefas `/loop` para uma sessão em segundo plano, que continua em execução sem um terminal.244* As tarefas só são acionadas enquanto Claude Code está em execução e ocioso. Fechar o terminal ou deixar a sessão sair para tudo. [Colocar a sessão em segundo plano](/docs/pt/agent-view#from-inside-a-session) leva tarefas `/loop` para uma sessão em segundo plano, que continua em execução sem um terminal.

245* Sem recuperação para disparos perdidos. Se o tempo agendado de uma tarefa passar enquanto Claude está ocupado em uma solicitação de longa duração, ela dispara uma vez quando Claude fica ocioso, não uma vez por intervalo perdido.245* Sem recuperação para disparos perdidos. Se o tempo agendado de uma tarefa passar enquanto Claude está ocupado em uma solicitação de longa duração, ela dispara uma vez quando Claude fica ocioso, não uma vez por intervalo perdido.

246* Iniciar uma conversa nova limpa todas as tarefas com escopo de sessão. Retomar com `claude --resume` ou `claude --continue` restaura tarefas que não expiraram: tarefas recorrentes dentro de sete dias de criação, e tarefas únicas cujo tempo agendado ainda não passou. Tarefas de Bash em segundo plano e tarefas de monitor nunca são restauradas ao retomar.246* Iniciar uma conversa nova limpa todas as tarefas com escopo de sessão. Retomar com `claude --resume` ou `claude --continue` restaura tarefas que não expiraram: tarefas recorrentes dentro de sete dias de criação, e tarefas únicas cujo tempo agendado ainda não passou. Tarefas de Bash em segundo plano e tarefas de monitor nunca são restauradas ao retomar.

247 247 

248Para automação orientada por cron que precisa ser executada sem supervisão:248Para automação orientada por cron que precisa ser executada sem supervisão:

249 249 

250* [Routines](/pt/routines): executadas na infraestrutura gerenciada pela Anthropic em um cronograma, via chamada de API ou em eventos do GitHub250* [Routines](/docs/pt/routines): executadas na infraestrutura gerenciada pela Anthropic em um cronograma, via chamada de API ou em eventos do GitHub

251* [GitHub Actions](/pt/github-actions): use um gatilho `schedule` em CI251* [GitHub Actions](/docs/pt/github-actions): use um gatilho `schedule` em CI

252* [Tarefas agendadas do Desktop](/pt/desktop-scheduled-tasks): executadas localmente em sua máquina252* [Tarefas agendadas do Desktop](/docs/pt/desktop-scheduled-tasks): executadas localmente em sua máquina

Details

10 10 

11Uma vez instalado, o plugin é executado automaticamente. Não há nada para invocar e nenhum comando separado para lembrar.11Uma vez instalado, o plugin é executado automaticamente. Não há nada para invocar e nenhum comando separado para lembrar.

12 12 

13O plugin é o companheiro em sessão do [Code Review](/pt/code-review), que é executado em pull requests. Este plugin reduz o que chega ao PR. Code Review detecta o que faz. Para saber como o plugin se integra com revisão sob demanda e varredura de CI, consulte [Como isso se encaixa com outras ferramentas de segurança](#how-this-fits-with-other-security-tools).13O plugin é o companheiro em sessão do [Code Review](/docs/pt/code-review), que é executado em pull requests. Este plugin reduz o que chega ao PR. Code Review detecta o que faz. Para saber como o plugin se integra com revisão sob demanda e varredura de CI, consulte [Como isso se encaixa com outras ferramentas de segurança](#how-this-fits-with-other-security-tools).

14 14 

15<h2 id="prerequisites">15<h2 id="prerequisites">

16 Pré-requisitos16 Pré-requisitos


26 Instalar o plugin26 Instalar o plugin

27</h2>27</h2>

28 28 

29Em uma sessão Claude Code, instale do [marketplace oficial da Anthropic](/pt/discover-plugins#official-anthropic-marketplace):29Em uma sessão Claude Code, instale do [marketplace oficial da Anthropic](/docs/pt/discover-plugins#official-anthropic-marketplace):

30 30 

31```text theme={null}31```text theme={null}

32/plugin install security-guidance@claude-plugins-official32/plugin install security-guidance@claude-plugins-official


44 Ativar em sessões na nuvem e repositórios compartilhados44 Ativar em sessões na nuvem e repositórios compartilhados

45</h3>45</h3>

46 46 

47Plugins com escopo de usuário não são transferidos para [Claude Code na web](/pt/claude-code-on-the-web), porque essas sessões são executadas na infraestrutura da Anthropic em vez de sua máquina. Para ativar o plugin lá, ou para ativá-lo para todos que clonam um repositório, declare-o nas configurações verificadas do projeto:47Plugins com escopo de usuário não são transferidos para [Claude Code na web](/docs/pt/claude-code-on-the-web), porque essas sessões são executadas na infraestrutura da Anthropic em vez de sua máquina. Para ativar o plugin lá, ou para ativá-lo para todos que clonam um repositório, declare-o nas configurações verificadas do projeto:

48 48 

49```json .claude/settings.json theme={null}49```json .claude/settings.json theme={null}

50{50{


54}54}

55```55```

56 56 

57Os administradores podem ativar o plugin em toda a organização definindo [`enabledPlugins`](/pt/settings#plugin-settings) em [configurações gerenciadas](/pt/admin-setup).57Os administradores podem ativar o plugin em toda a organização definindo [`enabledPlugins`](/docs/pt/settings#plugin-settings) em [configurações gerenciadas](/docs/pt/admin-setup).

58 58 

59<h2 id="what-the-plugin-checks">59<h2 id="what-the-plugin-checks">

60 O que o plugin verifica60 O que o plugin verifica


139- Use `crypto.timingSafeEqual` for token comparison instead of `===`.139- Use `crypto.timingSafeEqual` for token comparison instead of `===`.

140```140```

141 141 

142Essas regras são orientação para o revisor, não guardrails determinísticos. O plugin apresenta violações como descobertas para Claude corrigir, mas não bloqueia escritas ou garante que cada violação seja detectada. A orientação é apenas aditiva: uma regra que diz ignorar uma classe de vulnerabilidade não suprime essas descobertas. Para aplicação rígida, combine o plugin com um [hook que bloqueia a edição](/pt/hooks-guide#block-edits-to-protected-files) ou uma verificação de CI.142Essas regras são orientação para o revisor, não guardrails determinísticos. O plugin apresenta violações como descobertas para Claude corrigir, mas não bloqueia escritas ou garante que cada violação seja detectada. A orientação é apenas aditiva: uma regra que diz ignorar uma classe de vulnerabilidade não suprime essas descobertas. Para aplicação rígida, combine o plugin com um [hook que bloqueia a edição](/docs/pt/hooks-guide#block-edits-to-protected-files) ou uma verificação de CI.

143 143 

144<h3 id="add-custom-per-edit-patterns">144<h3 id="add-custom-per-edit-patterns">

145 Adicione padrões personalizados por edição145 Adicione padrões personalizados por edição


187 Custo de uso187 Custo de uso

188</h2>188</h2>

189 189 

190A [verificação de padrão por edição](#on-each-file-edit) não faz chamada de modelo e não adiciona custo. As revisões de [fim de turno](#at-the-end-of-each-turn) e [commit](#on-each-commit-or-push-claude-makes) cada uma gasta uso de modelo adicional que conta para seu [uso](/pt/costs) como qualquer outra solicitação Claude. A revisão de commit é agêntica e pode levar vários turnos de modelo por commit, limitada a 20 revisões por hora contínua. Espere aproximadamente uma chamada de revisão por turno que altera arquivos e uma revisão mais profunda por commit, ambas sujeitas aos limites acima.190A [verificação de padrão por edição](#on-each-file-edit) não faz chamada de modelo e não adiciona custo. As revisões de [fim de turno](#at-the-end-of-each-turn) e [commit](#on-each-commit-or-push-claude-makes) cada uma gasta uso de modelo adicional que conta para seu [uso](/docs/pt/costs) como qualquer outra solicitação Claude. A revisão de commit é agêntica e pode levar vários turnos de modelo por commit, limitada a 20 revisões por hora contínua. Espere aproximadamente uma chamada de revisão por turno que altera arquivos e uma revisão mais profunda por commit, ambas sujeitas aos limites acima.

191 191 

192Ambas as revisões apoiadas por modelo usam Claude Opus 4.7 por padrão. Defina `SECURITY_REVIEW_MODEL` para escolher um modelo diferente para a revisão de fim de turno e `SG_AGENTIC_MODEL` para a revisão de commit.192Ambas as revisões apoiadas por modelo usam Claude Opus 4.7 por padrão. Defina `SECURITY_REVIEW_MODEL` para escolher um modelo diferente para a revisão de fim de turno e `SG_AGENTIC_MODEL` para a revisão de commit.

193 193 


219/plugin uninstall security-guidance@claude-plugins-official219/plugin uninstall security-guidance@claude-plugins-official

220```220```

221 221 

222Se o plugin foi ativado através do `.claude/settings.json` de um projeto, desabilitá-lo de `/plugin` escreve uma substituição para seu `.claude/settings.local.json` em vez de editar o arquivo verificado, portanto o plugin permanece desativado para você enquanto os colegas de equipe não são afetados. {/* min-version: 2.1.203 */}O mesmo diálogo também oferece desinstalar o plugin para todos removendo-o do `.claude/settings.json` compartilhado; essa opção requer Claude Code v2.1.203 ou posterior. Se foi ativado através de [configurações gerenciadas](/pt/admin-setup), apenas um administrador pode desabilitá-lo.222Se o plugin foi ativado através do `.claude/settings.json` de um projeto, desabilitá-lo de `/plugin` escreve uma substituição para seu `.claude/settings.local.json` em vez de editar o arquivo verificado, portanto o plugin permanece desativado para você enquanto os colegas de equipe não são afetados. O mesmo diálogo também oferece desinstalar o plugin para todos removendo-o do `.claude/settings.json` compartilhado; essa opção requer Claude Code v2.1.203 ou posterior. Se foi ativado através de [configurações gerenciadas](/docs/pt/admin-setup), apenas um administrador pode desabilitá-lo.

223 223 

224<h2 id="how-the-plugin-integrates-with-claude-code">224<h2 id="how-the-plugin-integrates-with-claude-code">

225 Como o plugin se integra com Claude Code225 Como o plugin se integra com Claude Code

226</h2>226</h2>

227 227 

228O plugin é construído inteiramente em [hooks](/pt/hooks), o mecanismo para executar seu próprio código em pontos específicos do loop de Claude. Ele registra:228O plugin é construído inteiramente em [hooks](/docs/pt/hooks), o mecanismo para executar seu próprio código em pontos específicos do loop de Claude. Ele registra:

229 229 

230| Evento de Hook | Propósito |230| Evento de Hook | Propósito |

231| :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |231| :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |


246| Estágio | Ferramenta | O que cobre |246| Estágio | Ferramenta | O que cobre |

247| :-------------- | :--------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------- |247| :-------------- | :--------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------- |

248| Em sessão | Plugin de orientação de segurança | Vulnerabilidades comuns em código que Claude escreve, corrigidas na mesma sessão |248| Em sessão | Plugin de orientação de segurança | Vulnerabilidades comuns em código que Claude escreve, corrigidas na mesma sessão |

249| Sob demanda | [`/security-review`](/pt/commands#all-commands) | Uma passagem de segurança única no branch atual, executada quando você pede |249| Sob demanda | [`/security-review`](/docs/pt/commands#all-commands) | Uma passagem de segurança única no branch atual, executada quando você pede |

250| Em pull request | [Code Review](/pt/code-review), planos Team e Enterprise | Revisão de correção e segurança multi-agente com contexto completo do repositório |250| Em pull request | [Code Review](/docs/pt/code-review), planos Team e Enterprise | Revisão de correção e segurança multi-agente com contexto completo do repositório |

251| Em CI | Seus scanners de análise estática e dependência existentes | Regras específicas de linguagem, verificações de cadeia de suprimentos e aplicação de política que o plugin não tenta |251| Em CI | Seus scanners de análise estática e dependência existentes | Regras específicas de linguagem, verificações de cadeia de suprimentos e aplicação de política que o plugin não tenta |

252 252 

253Cada estágio posterior detecta o que os anteriores perdem. O valor do plugin é reduzir o volume que chega a eles, não eliminar a necessidade deles.253Cada estágio posterior detecta o que os anteriores perdem. O valor do plugin é reduzir o volume que chega a eles, não eliminar a necessidade deles.


270 270 

271Para aprofundar-se nos tópicos que esta página toca:271Para aprofundar-se nos tópicos que esta página toca:

272 272 

273* [Code Review](/pt/code-review): configurar a revisão multi-agente no tempo de PR273* [Code Review](/docs/pt/code-review): configurar a revisão multi-agente no tempo de PR

274* [Automatizar fluxos de trabalho com hooks](/pt/hooks-guide): construir suas próprias verificações nos mesmos pontos de ciclo de vida274* [Automatizar fluxos de trabalho com hooks](/docs/pt/hooks-guide): construir suas próprias verificações nos mesmos pontos de ciclo de vida

275* [Descobrir e instalar plugins](/pt/discover-plugins#official-anthropic-marketplace): procurar outros plugins oficiais275* [Descobrir e instalar plugins](/docs/pt/discover-plugins#official-anthropic-marketplace): procurar outros plugins oficiais

Details

28 Escolha entre configurações gerenciadas pelo servidor e gerenciadas pelo endpoint28 Escolha entre configurações gerenciadas pelo servidor e gerenciadas pelo endpoint

29</h2>29</h2>

30 30 

31O Claude Code suporta duas abordagens para configuração centralizada. As configurações gerenciadas pelo servidor entregam a configuração dos servidores da Anthropic. As [configurações gerenciadas pelo endpoint](/pt/settings#settings-files) são implantadas diretamente em dispositivos através de políticas nativas do SO (preferências gerenciadas do macOS, registro do Windows) ou arquivos de configurações gerenciadas.31O Claude Code suporta duas abordagens para configuração centralizada. As configurações gerenciadas pelo servidor entregam a configuração dos servidores da Anthropic. As [configurações gerenciadas pelo endpoint](/docs/pt/settings#settings-files) são implantadas diretamente em dispositivos através de políticas nativas do SO (preferências gerenciadas do macOS, registro do Windows) ou arquivos de configurações gerenciadas.

32 32 

33| Abordagem | Melhor para | Modelo de segurança |33| Abordagem | Melhor para | Modelo de segurança |

34| :------------------------------------------------------------------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |34| :------------------------------------------------------------------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |

35| **Configurações gerenciadas pelo servidor** | Organizações sem MDM, ou usuários em dispositivos não gerenciados | Configurações entregues dos servidores da Anthropic no momento da autenticação |35| **Configurações gerenciadas pelo servidor** | Organizações sem MDM, ou usuários em dispositivos não gerenciados | Configurações entregues dos servidores da Anthropic no momento da autenticação |

36| **[Configurações gerenciadas pelo endpoint](/pt/settings#settings-files)** | Organizações com MDM ou gerenciamento de endpoint | Configurações implantadas em dispositivos via perfis de configuração MDM, políticas de registro ou arquivos de configurações gerenciadas |36| **[Configurações gerenciadas pelo endpoint](/docs/pt/settings#settings-files)** | Organizações com MDM ou gerenciamento de endpoint | Configurações implantadas em dispositivos via perfis de configuração MDM, políticas de registro ou arquivos de configurações gerenciadas |

37 37 

38Se seus dispositivos estão inscritos em uma solução MDM ou gerenciamento de endpoint, as configurações gerenciadas pelo endpoint fornecem garantias de segurança mais fortes porque o arquivo de configurações pode ser protegido contra modificação do usuário no nível do SO. As configurações gerenciadas pelo endpoint não chegam às [sessões na nuvem](/pt/model-config#surface-coverage), portanto as organizações que usam Claude Code na web devem configurar também as configurações gerenciadas pelo servidor.38Se seus dispositivos estão inscritos em uma solução MDM ou gerenciamento de endpoint, as configurações gerenciadas pelo endpoint fornecem garantias de segurança mais fortes porque o arquivo de configurações pode ser protegido contra modificação do usuário no nível do SO. As configurações gerenciadas pelo endpoint não chegam às [sessões na nuvem](/docs/pt/model-config#surface-coverage), portanto as organizações que usam Claude Code na web devem configurar também as configurações gerenciadas pelo servidor.

39 39 

40<h2 id="configure-server-managed-settings">40<h2 id="configure-server-managed-settings">

41 Configurar configurações gerenciadas pelo servidor41 Configurar configurações gerenciadas pelo servidor


49 </Step>49 </Step>

50 50 

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

52 Adicione sua configuração como JSON. Todas as [configurações disponíveis em `settings.json`](/pt/settings#available-settings) são suportadas, exceto aquelas restritas à entrega de política em nível do SO; veja [Limitações atuais](#current-limitations) para essa lista curta. Isso inclui [hooks](/pt/hooks), [variáveis de ambiente](/pt/env-vars) e [configurações apenas gerenciadas](/pt/permissions#managed-only-settings) como `allowManagedPermissionRulesOnly`.52 Adicione sua configuração como JSON. Todas as [configurações disponíveis em `settings.json`](/docs/pt/settings#available-settings) são suportadas, exceto aquelas restritas à entrega de política em nível do SO; veja [Limitações atuais](#current-limitations) para essa lista curta. Isso inclui [hooks](/docs/pt/hooks), [variáveis de ambiente](/docs/pt/env-vars) e [configurações apenas gerenciadas](/docs/pt/permissions#managed-only-settings) como `allowManagedPermissionRulesOnly`.

53 53 

54 Este exemplo impõe uma lista de negação de permissões, impede que os usuários ignorem as permissões e restringe as regras de permissão àquelas definidas nas configurações gerenciadas:54 Este exemplo impõe uma lista de negação de permissões, impede que os usuários ignorem as permissões e restringe as regras de permissão àquelas definidas nas configurações gerenciadas:

55 55 


87 }87 }

88 ```88 ```

89 89 

90 Para configurar o classificador do [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) para que ele saiba quais repositórios, buckets e domínios sua organização confia:90 Para configurar o classificador do [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) para que ele saiba quais repositórios, buckets e domínios sua organização confia:

91 91 

92 ```json theme={null}92 ```json theme={null}

93 {93 {


101 }101 }

102 ```102 ```

103 103 

104 Como hooks executam comandos shell, os usuários veem uma [caixa de diálogo de aprovação de segurança](#security-approval-dialogs) antes de serem aplicados. Veja [Configurar o modo automático](/pt/auto-mode-config) para saber como as entradas `autoMode` afetam o que o classificador bloqueia e avisos importantes sobre os campos `environment`, `allow`, `soft_deny` e `hard_deny`.104 Como hooks executam comandos shell, os usuários veem uma [caixa de diálogo de aprovação de segurança](#security-approval-dialogs) antes de serem aplicados. Veja [Configurar o modo automático](/docs/pt/auto-mode-config) para saber como as entradas `autoMode` afetam o que o classificador bloqueia e avisos importantes sobre os campos `environment`, `allow`, `soft_deny` e `hard_deny`.

105 </Step>105 </Step>

106 106 

107 <Step title="Salvar e implantar">107 <Step title="Salvar e implantar">


130 Configurações apenas gerenciadas130 Configurações apenas gerenciadas

131</h3>131</h3>

132 132 

133A maioria das [chaves de configurações](/pt/settings#available-settings) funciona em qualquer escopo. Um punhado de chaves são lidas apenas de configurações gerenciadas e não têm efeito quando colocadas em arquivos de configurações de usuário ou projeto. Veja [configurações apenas gerenciadas](/pt/permissions#managed-only-settings) para a lista completa. Qualquer configuração não nessa lista ainda pode ser colocada em configurações gerenciadas e tem a precedência mais alta.133A maioria das [chaves de configurações](/docs/pt/settings#available-settings) funciona em qualquer escopo. Um punhado de chaves são lidas apenas de configurações gerenciadas e não têm efeito quando colocadas em arquivos de configurações de usuário ou projeto. Veja [configurações apenas gerenciadas](/docs/pt/permissions#managed-only-settings) para a lista completa. Qualquer configuração não nessa lista ainda pode ser colocada em configurações gerenciadas e tem a precedência mais alta.

134 134 

135<h3 id="current-limitations">135<h3 id="current-limitations">

136 Limitações atuais136 Limitações atuais


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

140 140 

141* As configurações se aplicam uniformemente a todos os usuários da organização. Configurações por grupo ainda não são suportadas.141* As configurações se aplicam uniformemente a todos os usuários da organização. Configurações por grupo ainda não são suportadas.

142* Um arquivo [`managed-mcp.json`](/pt/managed-mcp) não pode ser distribuído através de configurações gerenciadas pelo servidor. Entregue as chaves de política `allowedMcpServers` e `deniedMcpServers` lá em vez disso.142* Um arquivo [`managed-mcp.json`](/docs/pt/managed-mcp) não pode ser distribuído através de configurações gerenciadas pelo servidor. Entregue as chaves de política `allowedMcpServers` e `deniedMcpServers` lá em vez disso.

143* Configurações restritas a fontes de política em nível do SO, como `policyHelper` e `wslInheritsWindowsSettings`, não são honradas. Implante-as através de MDM ou um arquivo `managed-settings.json` do sistema.143* Configurações restritas a fontes de política em nível do SO, como `policyHelper` e `wslInheritsWindowsSettings`, não são honradas. Implante-as através de MDM ou um arquivo `managed-settings.json` do sistema.

144 144 

145<h2 id="settings-delivery">145<h2 id="settings-delivery">


150 Precedência de configurações150 Precedência de configurações

151</h3>151</h3>

152 152 

153As configurações gerenciadas pelo servidor e as [configurações gerenciadas pelo endpoint](/pt/settings#settings-files) ocupam o nível mais alto na [hierarquia de configurações](/pt/settings#settings-precedence) do Claude Code. Nenhum outro nível de configurações pode substituí-las, incluindo argumentos de linha de comando.153As configurações gerenciadas pelo servidor e as [configurações gerenciadas pelo endpoint](/docs/pt/settings#settings-files) ocupam o nível mais alto na [hierarquia de configurações](/docs/pt/settings#settings-precedence) do Claude Code. Nenhum outro nível de configurações pode substituí-las, incluindo argumentos de linha de comando.

154 154 

155Dentro do nível gerenciado, um [`policyHelper`](/pt/settings#compute-managed-settings-with-a-policy-helper) configurado preempta todas as outras fontes gerenciadas, incluindo configurações gerenciadas pelo servidor: sua saída se torna a única configuração gerenciada para a execução.155Dentro do nível gerenciado, um [`policyHelper`](/docs/pt/settings#compute-managed-settings-with-a-policy-helper) configurado preempta todas as outras fontes gerenciadas, incluindo configurações gerenciadas pelo servidor: sua saída se torna a única configuração gerenciada para a execução.

156 156 

157Caso contrário, o Claude Code usa a primeira fonte que entrega uma configuração não vazia. As configurações gerenciadas pelo servidor são verificadas primeiro, depois as configurações gerenciadas pelo endpoint. As fontes não se mesclam: se as configurações gerenciadas pelo servidor entregarem qualquer chave, as configurações gerenciadas pelo endpoint são ignoradas. Se as configurações gerenciadas pelo servidor não entregarem nada, as configurações gerenciadas pelo endpoint se aplicam.157Caso contrário, o Claude Code usa a primeira fonte que entrega uma configuração não vazia. As configurações gerenciadas pelo servidor são verificadas primeiro, depois as configurações gerenciadas pelo endpoint. As fontes não se mesclam: se as configurações gerenciadas pelo servidor entregarem qualquer chave, as configurações gerenciadas pelo endpoint são ignoradas. Se as configurações gerenciadas pelo servidor não entregarem nada, as configurações gerenciadas pelo endpoint se aplicam.

158 158 

159Uma exceção se aplica: um pequeno conjunto de [chaves de bloqueio entre fontes](/pt/settings#settings-precedence), como os bloqueios da lista de permissão de sandbox, é honrado quando qualquer fonte gerenciada controlada por administrador os define; o nível de registro HKCU gravável pelo usuário é excluído.159Uma exceção se aplica: um pequeno conjunto de [chaves de bloqueio entre fontes](/docs/pt/settings#settings-precedence), como os bloqueios da lista de permissão de sandbox, é honrado quando qualquer fonte gerenciada controlada por administrador os define; o nível de registro HKCU gravável pelo usuário é excluído.

160 160 

161Se você limpar sua configuração gerenciada pelo servidor no console de administração com a intenção de voltar a uma plist gerenciada pelo endpoint ou política de registro, esteja ciente de que [configurações em cache](#fetch-and-caching-behavior) persistem em máquinas cliente até a próxima busca bem-sucedida. Execute `/status` para ver qual fonte gerenciada está ativa.161Se você limpar sua configuração gerenciada pelo servidor no console de administração com a intenção de voltar a uma plist gerenciada pelo endpoint ou política de registro, esteja ciente de que [configurações em cache](#fetch-and-caching-behavior) persistem em máquinas cliente até a próxima busca bem-sucedida. Execute `/status` para ver qual fonte gerenciada está ativa.

162 162 


178* O Claude Code busca configurações atualizadas em segundo plano178* O Claude Code busca configurações atualizadas em segundo plano

179* As configurações em cache persistem através de falhas de rede. As variáveis retidas permanecem retidas até que uma busca seja bem-sucedida179* As configurações em cache persistem através de falhas de rede. As variáveis retidas permanecem retidas até que uma busca seja bem-sucedida

180 180 

181A partir da v2.1.198, o Claude Code retém três categorias de variáveis no bloco `env` em cache até que o servidor confirme o payload para a sessão. Isso evita que um valor de proxy em cache, autoridade de certificação, endpoint ou credencial redirecione, intercepte ou reautentique a busca de configurações que confirma o payload. O endurecimento se aplica apenas ao cache de configurações buscado do servidor: [configurações gerenciadas pelo endpoint](/pt/settings#settings-files) implantadas através de MDM ou `managed-settings.json` não são afetadas. As categorias retidas são:181A partir da v2.1.198, o Claude Code retém três categorias de variáveis no bloco `env` em cache até que o servidor confirme o payload para a sessão. Isso evita que um valor de proxy em cache, autoridade de certificação, endpoint ou credencial redirecione, intercepte ou reautentique a busca de configurações que confirma o payload. O endurecimento se aplica apenas ao cache de configurações buscado do servidor: [configurações gerenciadas pelo endpoint](/docs/pt/settings#settings-files) implantadas através de MDM ou `managed-settings.json` não são afetadas. As categorias retidas são:

182 182 

183* Configuração de proxy e TLS, como `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` e as variáveis de certificado de cliente mTLS `CLAUDE_CODE_CLIENT_CERT` e `CLAUDE_CODE_CLIENT_KEY`183* Configuração de proxy e TLS, como `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` e as variáveis de certificado de cliente mTLS `CLAUDE_CODE_CLIENT_CERT` e `CLAUDE_CODE_CLIENT_KEY`

184* Roteamento de API e seleção de provedor, incluindo `ANTHROPIC_BASE_URL`, as variáveis de seleção de provedor como `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, e as URLs de endpoint do provedor como `ANTHROPIC_BEDROCK_BASE_URL`184* Roteamento de API e seleção de provedor, incluindo `ANTHROPIC_BASE_URL`, as variáveis de seleção de provedor como `CLAUDE_CODE_USE_BEDROCK` e `CLAUDE_CODE_USE_VERTEX`, e as URLs de endpoint do provedor como `ANTHROPIC_BEDROCK_BASE_URL`


186 186 

187Todas as outras chaves no bloco `env` em cache, como telemetria e configuração OpenTelemetry, se aplicam na inicialização como antes. Uma vez que a busca seja bem-sucedida, as variáveis retidas se aplicam pelo resto da sessão.187Todas as outras chaves no bloco `env` em cache, como telemetria e configuração OpenTelemetry, se aplicam na inicialização como antes. Uma vez que a busca seja bem-sucedida, as variáveis retidas se aplicam pelo resto da sessão.

188 188 

189Se sua organização precisa de um proxy para alcançar `api.anthropic.com`, defina-o no ambiente do shell ou em [configurações do usuário](/pt/settings#settings-files) em vez de apenas no bloco `env` gerenciado. O primeiro lançamento não tem cache, portanto essas fontes já eram necessárias para a busca inicial.189Se sua organização precisa de um proxy para alcançar `api.anthropic.com`, defina-o no ambiente do shell ou em [configurações do usuário](/docs/pt/settings#settings-files) em vez de apenas no bloco `env` gerenciado. O primeiro lançamento não tem cache, portanto essas fontes já eram necessárias para a busca inicial.

190 190 

191O Claude Code aplica atualizações de configurações automaticamente sem reinicialização, exceto para configurações avançadas como configuração OpenTelemetry, que exigem uma reinicialização completa para entrar em vigor.191O Claude Code aplica atualizações de configurações automaticamente sem reinicialização, exceto para configurações avançadas como configuração OpenTelemetry, que exigem uma reinicialização completa para entrar em vigor.

192 192 


194 Entradas inválidas em configurações entregues194 Entradas inválidas em configurações entregues

195</h3>195</h3>

196 196 

197Os payloads entregues são analisados com tolerância usando as mesmas regras que as outras fontes gerenciadas. Quando um payload contém uma entrada que falha na validação do esquema, o Claude Code remove essa entrada, exibe um erro de validação e aplica todas as configurações válidas restantes. Consulte [Entradas inválidas em configurações gerenciadas](/pt/settings#invalid-entries-in-managed-settings) para o comportamento em nível de campo, incluindo como os campos de aplicação de segurança são tratados. Requer Claude Code v2.1.169 ou posterior.197Os payloads entregues são analisados com tolerância usando as mesmas regras que as outras fontes gerenciadas. Quando um payload contém uma entrada que falha na validação do esquema, o Claude Code remove essa entrada, exibe um erro de validação e aplica todas as configurações válidas restantes. Consulte [Entradas inválidas em configurações gerenciadas](/docs/pt/settings#invalid-entries-in-managed-settings) para o comportamento em nível de campo, incluindo como os campos de aplicação de segurança são tratados. Requer Claude Code v2.1.169 ou posterior.

198 198 

199A entrega gerenciada pelo servidor adiciona esses comportamentos:199A entrega gerenciada pelo servidor adiciona esses comportamentos:

200 200 


220}220}

221```221```

222 222 

223Você também pode definir essa chave em um [perfil MDM gerenciado pelo endpoint](/pt/settings#settings-files) ou arquivo `managed-settings.json` do sistema para impor comportamento de falha fechada no primeiro lançamento, antes de qualquer payload do servidor ter sido entregue. A partir da v2.1.191, esse sinalizador é uma exceção à [regra de precedência](#settings-precedence) acima: ele é honrado quando definido em qualquer fonte gerenciada mesmo se um payload gerenciado pelo servidor em cache também estiver presente, portanto um valor entregue por MDM não é ignorado quando configurações gerenciadas pelo servidor existem.223Você também pode definir essa chave em um [perfil MDM gerenciado pelo endpoint](/docs/pt/settings#settings-files) ou arquivo `managed-settings.json` do sistema para impor comportamento de falha fechada no primeiro lançamento, antes de qualquer payload do servidor ter sido entregue. A partir da v2.1.191, esse sinalizador é uma exceção à [regra de precedência](#settings-precedence) acima: ele é honrado quando definido em qualquer fonte gerenciada mesmo se um payload gerenciado pelo servidor em cache também estiver presente, portanto um valor entregue por MDM não é ignorado quando configurações gerenciadas pelo servidor existem.

224 224 

225A busca de configurações também envia um cabeçalho `Cache-Control: no-cache` para que proxies HTTP intermediários não sirvam uma resposta obsoleta.225A busca de configurações também envia um cabeçalho `Cache-Control: no-cache` para que proxies HTTP intermediários não sirvam uma resposta obsoleta.

226 226 


249 Disponibilidade de plataforma249 Disponibilidade de plataforma

250</h2>250</h2>

251 251 

252As configurações gerenciadas pelo servidor exigem uma conexão direta a `api.anthropic.com`, e a entrega requer que a sessão se autentique com um login OAuth da organização ou uma chave de API configurada diretamente. As chaves retornadas por um script [`apiKeyHelper`](/pt/settings#available-settings) não acionam a busca de configurações.252As configurações gerenciadas pelo servidor exigem uma conexão direta a `api.anthropic.com`, e a entrega requer que a sessão se autentique com um login OAuth da organização ou uma chave de API configurada diretamente. As chaves retornadas por um script [`apiKeyHelper`](/docs/pt/settings#available-settings) não acionam a busca de configurações.

253 253 

254As configurações gerenciadas pelo servidor não estão disponíveis ao usar provedores de modelo de terceiros:254As configurações gerenciadas pelo servidor não estão disponíveis ao usar provedores de modelo de terceiros:

255 255 

256* Amazon Bedrock256* Amazon Bedrock

257* Google Cloud's Agent Platform257* Google Cloud's Agent Platform

258* Microsoft Foundry258* Microsoft Foundry

259* [Claude Platform on AWS](/pt/claude-platform-on-aws)259* [Claude Platform on AWS](/docs/pt/claude-platform-on-aws)

260* Endpoints de API personalizados via `ANTHROPIC_BASE_URL` ou [gateways LLM](/pt/llm-gateway)260* Endpoints de API personalizados via `ANTHROPIC_BASE_URL` ou [gateways LLM](/docs/pt/llm-gateway)

261 261 

262Se você exportar uma variável de provedor `CLAUDE_CODE_USE_*` ou um `ANTHROPIC_BASE_URL` não padrão em seu shell, Claude Code ignora a busca de configurações para suas sessões. Você não pode limpar a exportação com um bloco `env` gerenciado pelo servidor, porque o bloco chega através da busca que a exportação impede. Um bloco `env` de [configurações gerenciadas pelo endpoint](/pt/settings#settings-files) também não restaura a busca: Claude Code verifica a elegibilidade antes de aplicar blocos `env` gerenciados, portanto a substituição altera a seleção de provedor da sessão, mas a busca permanece ignorada.262Se você exportar uma variável de provedor `CLAUDE_CODE_USE_*` ou um `ANTHROPIC_BASE_URL` não padrão em seu shell, Claude Code ignora a busca de configurações para suas sessões. Você não pode limpar a exportação com um bloco `env` gerenciado pelo servidor, porque o bloco chega através da busca que a exportação impede. Um bloco `env` de [configurações gerenciadas pelo endpoint](/docs/pt/settings#settings-files) também não restaura a busca: Claude Code verifica a elegibilidade antes de aplicar blocos `env` gerenciados, portanto a substituição altera a seleção de provedor da sessão, mas a busca permanece ignorada.

263 263 

264Para restaurar a entrega gerenciada pelo servidor, remova a exportação do seu shell ou defina a variável como `""` no bloco `env` de suas configurações de usuário, que se aplica antes da verificação de elegibilidade. Para impor política sem depender de usuários para alterar seus shells, entregue as configurações através do canal gerenciado pelo endpoint.264Para restaurar a entrega gerenciada pelo servidor, remova a exportação do seu shell ou defina a variável como `""` no bloco `env` de suas configurações de usuário, que se aplica antes da verificação de elegibilidade. Para impor política sem depender de usuários para alterar seus shells, entregue as configurações através do canal gerenciado pelo endpoint.

265 265 

266Para implantações do Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, um [gateway de aplicativos Claude](/pt/claude-apps-gateway) auto-hospedado fornece a entrega equivalente de configurações gerenciadas remotamente: clientes assinados no gateway buscam configurações gerenciadas do gateway em vez de `api.anthropic.com`. A semântica de falha difere na inicialização: um cliente de gateway que não consegue alcançar o gateway sai com um erro em vez de fazer fallback para configurações em cache, enquanto a atualização de fundo por hora é fail-open em ambos os canais.266Para implantações do Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado fornece a entrega equivalente de configurações gerenciadas remotamente: clientes assinados no gateway buscam configurações gerenciadas do gateway em vez de `api.anthropic.com`. A semântica de falha difere na inicialização: um cliente de gateway que não consegue alcançar o gateway sai com um erro em vez de fazer fallback para configurações em cache, enquanto a atualização de fundo por hora é fail-open em ambos os canais.

267 267 

268<h2 id="audit-logging">268<h2 id="audit-logging">

269 Auditoria de logs269 Auditoria de logs


280As configurações gerenciadas pelo servidor fornecem aplicação de política centralizada, mas funcionam como um controle do lado do cliente, não como um limite de segurança. Em dispositivos não gerenciados, um usuário não precisa de acesso de administrador ou sudo para contorná-las.280As configurações gerenciadas pelo servidor fornecem aplicação de política centralizada, mas funcionam como um controle do lado do cliente, não como um limite de segurança. Em dispositivos não gerenciados, um usuário não precisa de acesso de administrador ou sudo para contorná-las.

281 281 

282| Cenário | Comportamento |282| Cenário | Comportamento |

283| :----------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |283| :----------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

284| Usuário edita o arquivo de configurações em cache | O arquivo adulterado se aplica na inicialização, mas as configurações corretas são restauradas na próxima busca do servidor. {/* min-version: 2.1.198 */}A partir da v2.1.198, as variáveis de ambiente de transporte, roteamento de API e autenticação no bloco `env` são [retidas até que o servidor confirme o payload](#fetch-and-caching-behavior) |284| Usuário edita o arquivo de configurações em cache | O arquivo adulterado se aplica na inicialização, mas as configurações corretas são restauradas na próxima busca do servidor. A partir da v2.1.198, as variáveis de ambiente de transporte, roteamento de API e autenticação no bloco `env` são [retidas até que o servidor confirme o payload](#fetch-and-caching-behavior) |

285| Usuário deleta o arquivo de configurações em cache | Comportamento de primeiro lançamento ocorre: configurações são buscadas de forma assíncrona com uma breve janela não aplicada |285| Usuário deleta o arquivo de configurações em cache | Comportamento de primeiro lançamento ocorre: configurações são buscadas de forma assíncrona com uma breve janela não aplicada |

286| Usuário executa um binário Claude Code modificado | Um usuário que pode executar um cliente modificado pode contornar qualquer controle do lado do cliente |286| Usuário executa um binário Claude Code modificado | Um usuário que pode executar um cliente modificado pode contornar qualquer controle do lado do cliente |

287| Usuário executa uma versão anterior do Claude Code | Versões que antecedem as configurações gerenciadas pelo servidor não as buscam ou aplicam |287| Usuário executa uma versão anterior do Claude Code | Versões que antecedem as configurações gerenciadas pelo servidor não as buscam ou aplicam |

288| API está indisponível | As configurações em cache se aplicam se disponíveis, caso contrário, as configurações gerenciadas não são aplicadas até a próxima busca bem-sucedida. {/* min-version: 2.1.198 */}A partir da v2.1.198, as variáveis de ambiente de transporte, roteamento de API e autenticação no bloco `env` em cache são [retidas em caso de falha de busca](#fetch-and-caching-behavior); o resto do cache ainda se aplica. Com `forceRemoteSettingsRefresh: true`, a CLI sai em vez de continuar, exceto para [subcomandos `claude auth`](#enforce-fail-closed-startup) |288| API está indisponível | As configurações em cache se aplicam se disponíveis, caso contrário, as configurações gerenciadas não são aplicadas até a próxima busca bem-sucedida. A partir da v2.1.198, as variáveis de ambiente de transporte, roteamento de API e autenticação no bloco `env` em cache são [retidas em caso de falha de busca](#fetch-and-caching-behavior); o resto do cache ainda se aplica. Com `forceRemoteSettingsRefresh: true`, a CLI sai em vez de continuar, exceto para [subcomandos `claude auth`](#enforce-fail-closed-startup) |

289| Usuário se autentica com uma organização diferente | As configurações não são entregues para contas fora da organização gerenciada |289| Usuário se autentica com uma organização diferente | As configurações não são entregues para contas fora da organização gerenciada |

290| Usuário configura um [provedor de modelo de terceiros](#platform-availability) | As configurações gerenciadas pelo servidor são ignoradas. Isso inclui definir `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS`, ou um `ANTHROPIC_BASE_URL` não padrão |290| Usuário configura um [provedor de modelo de terceiros](#platform-availability) | As configurações gerenciadas pelo servidor são ignoradas. Isso inclui definir `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS`, ou um `ANTHROPIC_BASE_URL` não padrão |

291| Tráfego de rede é interceptado ou redirecionado | Validação TLS desabilitada ou tráfego interceptado pode alterar as configurações que o cliente recebe |291| Tráfego de rede é interceptado ou redirecionado | Validação TLS desabilitada ou tráfego interceptado pode alterar as configurações que o cliente recebe |

292 292 

293Para detectar alterações de configuração em tempo de execução, use [hooks `ConfigChange`](/pt/hooks#configchange) para registrar modificações ou bloquear alterações não autorizadas antes que entrem em vigor.293Para detectar alterações de configuração em tempo de execução, use [hooks `ConfigChange`](/docs/pt/hooks#configchange) para registrar modificações ou bloquear alterações não autorizadas antes que entrem em vigor.

294 294 

295Para restringir quais organizações seus usuários podem acessar com as credenciais que o cliente fornece, consulte [Enforce network-level access control with Tenant Restrictions](https://support.claude.com/en/articles/13198485-enforce-network-level-access-control-with-tenant-restrictions) no Claude Help Center. Para garantias de aplicação mais fortes, use [configurações gerenciadas pelo endpoint](/pt/settings#settings-files) em dispositivos inscritos em uma solução MDM.295Para restringir quais organizações seus usuários podem acessar com as credenciais que o cliente fornece, consulte [Enforce network-level access control with Tenant Restrictions](https://support.claude.com/en/articles/13198485-enforce-network-level-access-control-with-tenant-restrictions) no Claude Help Center. Para garantias de aplicação mais fortes, use [configurações gerenciadas pelo endpoint](/docs/pt/settings#settings-files) em dispositivos inscritos em uma solução MDM.

296 296 

297<h2 id="see-also">297<h2 id="see-also">

298 Veja também298 Veja também


300 300 

301Páginas relacionadas para gerenciar a configuração do Claude Code:301Páginas relacionadas para gerenciar a configuração do Claude Code:

302 302 

303* [Settings](/pt/settings): referência de configuração completa incluindo todas as configurações disponíveis303* [Settings](/docs/pt/settings): referência de configuração completa incluindo todas as configurações disponíveis

304* [Configurações gerenciadas pelo endpoint](/pt/settings#settings-files): configurações gerenciadas implantadas em dispositivos por TI304* [Configurações gerenciadas pelo endpoint](/docs/pt/settings#settings-files): configurações gerenciadas implantadas em dispositivos por TI

305* [Authentication](/pt/authentication): configure o acesso do usuário ao Claude Code305* [Authentication](/docs/pt/authentication): configure o acesso do usuário ao Claude Code

306* [Security](/pt/security): salvaguardas de segurança e melhores práticas306* [Security](/docs/pt/security): salvaguardas de segurança e melhores práticas

sessions.md +21 −21

Details

8 8 

9Uma sessão é uma conversa salva vinculada a um diretório de projeto. Claude Code a armazena localmente conforme você trabalha, para que você possa retomar de onde parou, ramificar para tentar uma abordagem diferente ou alternar entre tarefas.9Uma sessão é uma conversa salva vinculada a um diretório de projeto. Claude Code a armazena localmente conforme você trabalha, para que você possa retomar de onde parou, ramificar para tentar uma abordagem diferente ou alternar entre tarefas.

10 10 

11O [aplicativo desktop](/pt/desktop#work-in-parallel-with-sessions), [Claude Code na web](/pt/claude-code-on-the-web) e a [extensão VS Code](/pt/vs-code#resume-past-conversations) mantêm seu próprio histórico de sessões. Esta página abrange a CLI.11O [aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions), [Claude Code na web](/docs/pt/claude-code-on-the-web) e a [extensão VS Code](/docs/pt/vs-code#resume-past-conversations) mantêm seu próprio histórico de sessões. Esta página abrange a CLI.

12 12 

13<h2 id="resume-a-session">13<h2 id="resume-a-session">

14 Retomar uma sessão14 Retomar uma sessão


24| `claude --from-pr <number>` | Retoma a sessão vinculada a esse pull request |24| `claude --from-pr <number>` | Retoma a sessão vinculada a esse pull request |

25| `/resume` | Alterna para uma conversa diferente de dentro de uma sessão ativa |25| `/resume` | Alterna para uma conversa diferente de dentro de uma sessão ativa |

26 26 

27As sessões criadas com [`claude -p`](/pt/headless) ou o [Agent SDK](/pt/agent-sdk/overview) não aparecem no seletor de sessão, mas você ainda pode retomar uma passando seu ID de sessão para `claude --resume <session-id>`. Execute isto a partir do diretório em que a sessão foi iniciada: a busca de ID de sessão é limitada ao diretório do projeto atual e seus git worktrees, portanto uma sessão criada em outro lugar relata `No conversation found with session ID: <session-id>`.27As sessões criadas com [`claude -p`](/docs/pt/headless) ou o [Agent SDK](/docs/pt/agent-sdk/overview) não aparecem no seletor de sessão, mas você ainda pode retomar uma passando seu ID de sessão para `claude --resume <session-id>`. Execute isto a partir do diretório em que a sessão foi iniciada: a busca de ID de sessão é limitada ao diretório do projeto atual e seus git worktrees, portanto uma sessão criada em outro lugar relata `No conversation found with session ID: <session-id>`.

28 28 

29<h3 id="where-the-session-picker-looks">29<h3 id="where-the-session-picker-looks">

30 Onde o seletor de sessão procura30 Onde o seletor de sessão procura


32 32 

33As sessões são armazenadas por diretório de projeto. Por padrão, o seletor de sessão mostra sessões interativas da worktree atual, além de sessões iniciadas em outro lugar que adicionaram o diretório atual com `/add-dir`. Use `Ctrl+W` para expandir para todas as worktrees do repositório ou `Ctrl+A` para expandir para cada projeto nesta máquina.33As sessões são armazenadas por diretório de projeto. Por padrão, o seletor de sessão mostra sessões interativas da worktree atual, além de sessões iniciadas em outro lugar que adicionaram o diretório atual com `/add-dir`. Use `Ctrl+W` para expandir para todas as worktrees do repositório ou `Ctrl+A` para expandir para cada projeto nesta máquina.

34 34 

35{/* min-version: 2.1.169 */}A partir da v2.1.169, mover uma sessão com [`/cd`](/pt/commands) a relocata para o armazenamento de projeto do novo diretório, para que apareça no seletor desse diretório depois. {/* min-version: 2.1.196 */}A partir da v2.1.196, uma sessão movida fica fora do seletor do diretório antigo mesmo após uma falha ou saída forçada. Em versões anteriores, ela também poderia reaparecer na lista do diretório antigo após uma saída que não foi limpa quando o caminho antigo continha caracteres especiais como sublinhados.35A partir da v2.1.169, mover uma sessão com [`/cd`](/docs/pt/commands) a relocata para o armazenamento de projeto do novo diretório, para que apareça no seletor desse diretório depois. A partir da v2.1.196, uma sessão movida fica fora do seletor do diretório antigo mesmo após uma falha ou saída forçada. Em versões anteriores, ela também poderia reaparecer na lista do diretório antigo após uma saída que não foi limpa quando o caminho antigo continha caracteres especiais como sublinhados.

36 36 

37Selecionar uma sessão de outra worktree do mesmo repositório a retoma no local. Selecionar uma sessão de um projeto não relacionado copia um comando `cd` e retoma para sua área de transferência.37Selecionar uma sessão de outra worktree do mesmo repositório a retoma no local. Selecionar uma sessão de um projeto não relacionado copia um comando `cd` e retoma para sua área de transferência.

38 38 


54| Na inicialização | `claude -n auth-refactor` |54| Na inicialização | `claude -n auth-refactor` |

55| Durante uma sessão | `/rename auth-refactor`. O nome também aparece na barra de prompt |55| Durante uma sessão | `/rename auth-refactor`. O nome também aparece na barra de prompt |

56| Do seletor de sessão | Destaque uma sessão e pressione `Ctrl+R` |56| Do seletor de sessão | Destaque uma sessão e pressione `Ctrl+R` |

57| Na aceitação do plano | Aceitar um plano no [Plan Mode](/pt/permission-modes#analyze-before-you-edit-with-plan-mode) nomeia a sessão a partir do conteúdo do plano, a menos que você já tenha definido um |57| Na aceitação do plano | Aceitar um plano no [Plan Mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) nomeia a sessão a partir do conteúdo do plano, a menos que você já tenha definido um |

58 58 

59Depois que uma sessão é nomeada, retorne a ela com `claude --resume <name>` ou `/resume <name>`. Veja [Retomar uma sessão](#resume-a-session) para saber como a resolução de nomes se comporta entre worktrees.59Depois que uma sessão é nomeada, retorne a ela com `claude --resume <name>` ou `/resume <name>`. Veja [Retomar uma sessão](#resume-a-session) para saber como a resolução de nomes se comporta entre worktrees.

60 60 

61{/* min-version: 2.1.196 */}As sessões interativas que você nunca nomeia ainda recebem um nome de exibição padrão quando iniciam. Requer Claude Code v2.1.196 ou posterior. O padrão combina o nome do diretório de trabalho com um sufixo de dois caracteres, por exemplo `my-app-3f`, e identifica a sessão em listagens de sessões em execução, como [agent view](/pt/agent-view) e saída de `claude agents --json`.61As sessões interativas que você nunca nomeia ainda recebem um nome de exibição padrão quando iniciam. Requer Claude Code v2.1.196 ou posterior. O padrão combina o nome do diretório de trabalho com um sufixo de dois caracteres, por exemplo `my-app-3f`, e identifica a sessão em listagens de sessões em execução, como [agent view](/docs/pt/agent-view) e saída de `claude agents --json`.

62 62 

63O padrão não é um identificador de retomada: `claude --resume <name>`, `/resume <name>` e o seletor de sessão correspondem apenas aos nomes que você definiu. Nomear a sessão substitui o padrão.63O padrão não é um identificador de retomada: `claude --resume <name>`, `/resume <name>` e o seletor de sessão correspondem apenas aos nomes que você definiu. Nomear a sessão substitui o padrão.

64 64 


97/branch try-streaming-approach97/branch try-streaming-approach

98```98```

99 99 

100Se você omitir o nome, Claude Code nomeia o novo branch após o primeiro prompt na conversa. A partir da v2.1.198, isso também se aplica após [compaction](/pt/how-claude-code-works#when-context-fills-up); versões anteriores voltavam para o nome literal `Branched conversation` em vez de procurar além do resumo de compaction para o primeiro prompt original.100Se você omitir o nome, Claude Code nomeia o novo branch após o primeiro prompt na conversa. A partir da v2.1.198, isso também se aplica após [compaction](/docs/pt/how-claude-code-works#when-context-fills-up); versões anteriores voltavam para o nome literal `Branched conversation` em vez de procurar além do resumo de compaction para o primeiro prompt original.

101 101 

102Na linha de comando, combine `--continue` ou `--resume` com `--fork-session`:102Na linha de comando, combine `--continue` ou `--resume` com `--fork-session`:

103 103 


107 107 

108A sessão original permanece inalterada e disponível no seletor de sessão. A confirmação `/branch` imprime dois IDs de sessão: o novo branch em que você está agora e o original. Para retornar ao original, passe seu ID para `/resume`, use o seletor de sessão ou execute `/resume <original-name>`. As permissões que você aprovou com "permitir para esta sessão" não são transferidas para o novo branch. Se você retomar a mesma sessão em dois terminais sem bifurcar, as mensagens de ambos se intercalam em um transcrição.108A sessão original permanece inalterada e disponível no seletor de sessão. A confirmação `/branch` imprime dois IDs de sessão: o novo branch em que você está agora e o original. Para retornar ao original, passe seu ID para `/resume`, use o seletor de sessão ou execute `/resume <original-name>`. As permissões que você aprovou com "permitir para esta sessão" não são transferidas para o novo branch. Se você retomar a mesma sessão em dois terminais sem bifurcar, as mensagens de ambos se intercalam em um transcrição.

109 109 

110Para rewind baseado em checkpoint dentro de uma única sessão, veja [Checkpointing](/pt/checkpointing).110Para rewind baseado em checkpoint dentro de uma única sessão, veja [Checkpointing](/docs/pt/checkpointing).

111 111 

112<h2 id="manage-context-within-a-session">112<h2 id="manage-context-within-a-session">

113 Gerenciar contexto dentro de uma sessão113 Gerenciar contexto dentro de uma sessão


115 115 

116Estes comandos controlam o que está na janela de contexto sem deixar a sessão:116Estes comandos controlam o que está na janela de contexto sem deixar a sessão:

117 117 

118* **`/clear`**: comece do zero com um contexto vazio. A conversa anterior é salva e retomável com `/resume`, ou, no mesmo processo Claude Code, {/* min-version: 2.1.191 */}a partir da [entrada de sessão anterior do menu de rewind](/pt/checkpointing#rewind-past-a-cleared-conversation)118* **`/clear`**: comece do zero com um contexto vazio. A conversa anterior é salva e retomável com `/resume`, ou, no mesmo processo Claude Code, a partir da [entrada de sessão anterior do menu de rewind](/docs/pt/checkpointing#rewind-past-a-cleared-conversation)

119* **`/compact [instructions]`**: substitua o histórico por um resumo, opcionalmente focado no que você especificar119* **`/compact [instructions]`**: substitua o histórico por um resumo, opcionalmente focado no que você especificar

120* **`/context`**: mostrar o que está consumindo contexto atualmente120* **`/context`**: mostrar o que está consumindo contexto atualmente

121 121 

122Para saber como a compactação interage com CLAUDE.md, skills e regras, veja o [guia de janela de contexto](/pt/context-window). Para estratégias sobre quando limpar versus compactar, veja [Melhores práticas](/pt/best-practices#manage-your-session).122Para saber como a compactação interage com CLAUDE.md, skills e regras, veja o [guia de janela de contexto](/docs/pt/context-window). Para estratégias sobre quando limpar versus compactar, veja [Melhores práticas](/docs/pt/best-practices#manage-your-session).

123 123 

124<h2 id="export-and-locate-session-data">124<h2 id="export-and-locate-session-data">

125 Exportar e localizar dados de sessão125 Exportar e localizar dados de sessão


133 133 

134`/export` produz uma transcrição renderizada para uma pessoa ler. As interfaces abaixo produzem dados estruturados para um script analisar: um resultado JSON de uma execução, o caminho para o arquivo de transcrição de uma sessão, ou um fluxo ao vivo de eventos. Escolha pelo que dispara o script:134`/export` produz uma transcrição renderizada para uma pessoa ler. As interfaces abaixo produzem dados estruturados para um script analisar: um resultado JSON de uma execução, o caminho para o arquivo de transcrição de uma sessão, ou um fluxo ao vivo de eventos. Escolha pelo que dispara o script:

135 135 

136* **Executar Claude uma vez e capturar o resultado**: invoque `claude -p` com [`--output-format json` ou `stream-json`](/pt/headless#get-structured-output) para capturar o resultado, ID da sessão, uso e custo de uma execução não interativa como JSON estruturado.136* **Executar Claude uma vez e capturar o resultado**: invoque `claude -p` com [`--output-format json` ou `stream-json`](/docs/pt/headless#get-structured-output) para capturar o resultado, ID da sessão, uso e custo de uma execução não interativa como JSON estruturado.

137* **Fazer uma pergunta a uma sessão existente**: passe um ID de sessão para [`claude -p --resume`](/pt/headless#continue-conversations) para enviar um prompt de acompanhamento, como uma solicitação de resumo, e capturar a resposta estruturada.137* **Fazer uma pergunta a uma sessão existente**: passe um ID de sessão para [`claude -p --resume`](/docs/pt/headless#continue-conversations) para enviar um prompt de acompanhamento, como uma solicitação de resumo, e capturar a resposta estruturada.

138* **Reagir a eventos de sessão**: leia o campo `transcript_path` que [hooks](/pt/hooks#common-input-fields) e [comandos de linha de status](/pt/statusline#available-data) recebem como entrada. Um hook `SessionEnd` pode arquivar a transcrição quando uma sessão termina.138* **Reagir a eventos de sessão**: leia o campo `transcript_path` que [hooks](/docs/pt/hooks#common-input-fields) e [comandos de linha de status](/docs/pt/statusline#available-data) recebem como entrada. Um hook `SessionEnd` pode arquivar a transcrição quando uma sessão termina.

139* **Incorporar Claude em um aplicativo TypeScript ou Python**: use o [Agent SDK](/pt/agent-sdk/overview) para receber cada mensagem programaticamente.139* **Incorporar Claude em um aplicativo TypeScript ou Python**: use o [Agent SDK](/docs/pt/agent-sdk/overview) para receber cada mensagem programaticamente.

140 140 

141O exemplo abaixo usa a segunda interface. Ele envia um prompt de acompanhamento para uma sessão existente e lê a resposta com `jq`:141O exemplo abaixo usa a segunda interface. Ele envia um prompt de acompanhamento para uma sessão existente e lê a resposta com `jq`:

142 142 


154 154 

155| Para | Defina | Onde |155| Para | Defina | Onde |

156| --------------------------------------------------- | ------------------------------------------------------ | ------------------------------- |156| --------------------------------------------------- | ------------------------------------------------------ | ------------------------------- |

157| Mover armazenamento para fora de `~/.claude` | [`CLAUDE_CONFIG_DIR`](/pt/env-vars) | Variável de ambiente |157| Mover armazenamento para fora de `~/.claude` | [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) | Variável de ambiente |

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

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

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

161 161 

162<h2 id="see-also">162<h2 id="see-also">

163 Veja também163 Veja também


165 165 

166Estas páginas cobrem mecânicas relacionadas de sessão e paralelismo:166Estas páginas cobrem mecânicas relacionadas de sessão e paralelismo:

167 167 

168* [Worktrees](/pt/worktrees): execute sessões paralelas isoladas em branches separados168* [Worktrees](/docs/pt/worktrees): execute sessões paralelas isoladas em branches separados

169* [Checkpointing](/pt/checkpointing): retroceda código e conversa para um ponto anterior169* [Checkpointing](/docs/pt/checkpointing): retroceda código e conversa para um ponto anterior

170* [Janela de contexto](/pt/context-window): o que preenche o contexto e o que sobrevive à compactação170* [Janela de contexto](/docs/pt/context-window): o que preenche o contexto e o que sobrevive à compactação

171* [Modo não interativo](/pt/headless): comportamento de sessão sob `claude -p`171* [Modo não interativo](/docs/pt/headless): comportamento de sessão sob `claude -p`

settings.md +159 −159

Details

6 6 

7> Configure o Claude Code com configurações globais e em nível de projeto, e variáveis de ambiente.7> Configure o Claude Code com configurações globais e em nível de projeto, e variáveis de ambiente.

8 8 

9O Claude Code oferece uma variedade de configurações para personalizar seu comportamento de acordo com suas necessidades. Você pode configurar o Claude Code executando o comando `/config`, que abre uma interface de Configurações com abas onde você pode visualizar informações de status e modificar opções de configuração. {/* min-version: 2.1.181 */}A partir da v2.1.181, você pode alterar uma única opção sem abrir a interface passando `key=value` para `/config`, por exemplo `/config verbose=true`.9O Claude Code oferece uma variedade de configurações para personalizar seu comportamento de acordo com suas necessidades. Você pode configurar o Claude Code executando o comando `/config`, que abre uma interface de Configurações com abas onde você pode visualizar informações de status e modificar opções de configuração. A partir da v2.1.181, você pode alterar uma única opção sem abrir a interface passando `key=value` para `/config`, por exemplo `/config verbose=true`.

10 10 

11<h2 id="configuration-scopes">11<h2 id="configuration-scopes">

12 Escopos de configuração12 Escopos de configuração


96 * `.claude/settings.json` para configurações que são verificadas no controle de origem e compartilhadas com sua equipe96 * `.claude/settings.json` para configurações que são verificadas no controle de origem e compartilhadas com sua equipe

97 * `.claude/settings.local.json` para configurações que não são verificadas, úteis para preferências pessoais e experimentação. Quando o Claude Code cria `.claude/settings.local.json`, ele configura o git para ignorar o arquivo. Se você criar o arquivo você mesmo, adicione-o ao seu gitignore manualmente.97 * `.claude/settings.local.json` para configurações que não são verificadas, úteis para preferências pessoais e experimentação. Quando o Claude Code cria `.claude/settings.local.json`, ele configura o git para ignorar o arquivo. Se você criar o arquivo você mesmo, adicione-o ao seu gitignore manualmente.

98 98 

99 Como este arquivo é seu em vez do repositório, suas regras de permissão `allow` entram em vigor sem a etapa de [confiança do workspace](/pt/permissions#project-allow-rules-and-workspace-trust) que as regras allow de `.claude/settings.json` exigem. Se o repositório fornece o arquivo, por exemplo ao confirmá-lo, a confiança do workspace ainda se aplica.99 Como este arquivo é seu em vez do repositório, suas regras de permissão `allow` entram em vigor sem a etapa de [confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) que as regras allow de `.claude/settings.json` exigem. Se o repositório fornece o arquivo, por exemplo ao confirmá-lo, a confiança do workspace ainda se aplica.

100* **Configurações gerenciadas**: Para organizações que precisam de controle centralizado, o Claude Code suporta múltiplos mecanismos de entrega para configurações gerenciadas. Todos usam o mesmo formato JSON e não podem ser substituídos por configurações de usuário ou projeto:100* **Configurações gerenciadas**: Para organizações que precisam de controle centralizado, o Claude Code suporta múltiplos mecanismos de entrega para configurações gerenciadas. Todos usam o mesmo formato JSON e não podem ser substituídos por configurações de usuário ou projeto:

101 101 

102 * **Configurações gerenciadas pelo servidor**: entregues remotamente na entrada, seja dos servidores da Anthropic através do console de administração do claude.ai ou de um [gateway de aplicativos Claude](/pt/claude-apps-gateway) auto-hospedado. Veja [configurações gerenciadas pelo servidor](/pt/server-managed-settings).102 * **Configurações gerenciadas pelo servidor**: entregues remotamente na entrada, seja dos servidores da Anthropic através do console de administração do claude.ai ou de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado. Veja [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings).

103 * **Políticas de nível MDM/SO**: entregues através do gerenciamento nativo de dispositivos no macOS e Windows:103 * **Políticas de nível MDM/SO**: entregues através do gerenciamento nativo de dispositivos no macOS e Windows:

104 * macOS: domínio de preferências gerenciadas `com.anthropic.claudecode`. As chaves de nível superior do plist espelham `managed-settings.json`, com configurações aninhadas como dicionários e arrays como arrays de plist. Implante via perfis de configuração em Jamf, Iru (Kandji), ou ferramentas MDM similares.104 * macOS: domínio de preferências gerenciadas `com.anthropic.claudecode`. As chaves de nível superior do plist espelham `managed-settings.json`, com configurações aninhadas como dicionários e arrays como arrays de plist. Implante via perfis de configuração em Jamf, Iru (Kandji), ou ferramentas MDM similares.

105 * Windows: chave de registro `HKLM\SOFTWARE\Policies\ClaudeCode` com um valor `Settings` (REG\_SZ ou REG\_EXPAND\_SZ) contendo JSON (implantado via Política de Grupo ou Intune)105 * Windows: chave de registro `HKLM\SOFTWARE\Policies\ClaudeCode` com um valor `Settings` (REG\_SZ ou REG\_EXPAND\_SZ) contendo JSON (implantado via Política de Grupo ou Intune)


120 120 

121 Use prefixos numéricos para controlar a ordem de mesclagem, por exemplo `10-telemetry.json` e `20-security.json`.121 Use prefixos numéricos para controlar a ordem de mesclagem, por exemplo `10-telemetry.json` e `20-security.json`.

122 122 

123 Veja [configurações gerenciadas](/pt/permissions#managed-only-settings) e [Configuração MCP gerenciada](/pt/managed-mcp) para detalhes.123 Veja [configurações gerenciadas](/docs/pt/permissions#managed-only-settings) e [Configuração MCP gerenciada](/docs/pt/managed-mcp) para detalhes.

124 124 

125 Este [repositório](https://github.com/anthropics/claude-code/tree/main/examples/mdm) inclui modelos de implantação iniciais para Jamf, Iru (Kandji), Intune, e Política de Grupo. Use estes como pontos de partida e ajuste-os para suas necessidades.125 Este [repositório](https://github.com/anthropics/claude-code/tree/main/examples/mdm) inclui modelos de implantação iniciais para Jamf, Iru (Kandji), Intune, e Política de Grupo. Use estes como pontos de partida e ajuste-os para suas necessidades.

126 126 

127 <Note>127 <Note>

128 Implantações gerenciadas também podem restringir **adições ao marketplace de plugins** usando `strictKnownMarketplaces`. Para mais informações, veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions).128 Implantações gerenciadas também podem restringir **adições ao marketplace de plugins** usando `strictKnownMarketplaces`. Para mais informações, veja [Restrições de marketplace gerenciado](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions).

129 </Note>129 </Note>

130* **Outra configuração** é armazenada em `~/.claude.json`. Este arquivo contém sua sessão OAuth, configurações de [MCP server](/pt/mcp) para escopos de usuário e local, estado por projeto (ferramentas permitidas, configurações de confiança), e vários caches. Os MCP servers com escopo de projeto são armazenados separadamente em `.mcp.json`.130* **Outra configuração** é armazenada em `~/.claude.json`. Este arquivo contém sua sessão OAuth, configurações de [MCP server](/docs/pt/mcp) para escopos de usuário e local, estado por projeto (ferramentas permitidas, configurações de confiança), e vários caches. Os MCP servers com escopo de projeto são armazenados separadamente em `.mcp.json`.

131 131 

132<Note>132<Note>

133 O Claude Code cria automaticamente backups com timestamp dos arquivos de configuração e retém os cinco backups mais recentes para evitar perda de dados.133 O Claude Code cria automaticamente backups com timestamp dos arquivos de configuração e retém os cinco backups mais recentes para evitar perda de dados.


169 Quando as edições entram em vigor169 Quando as edições entram em vigor

170</h3>170</h3>

171 171 

172O Claude Code observa seus arquivos de configuração e os recarrega quando mudam, então edições na maioria das chaves se aplicam à sessão em execução sem uma reinicialização. Isto inclui `permissions`, `hooks`, e auxiliares de credenciais como `apiKeyHelper`. O recarregamento cobre configurações de usuário, projeto, local e gerenciadas, e o [hook `ConfigChange`](/pt/hooks#configchange) dispara para cada mudança detectada.172O Claude Code observa seus arquivos de configuração e os recarrega quando mudam, então edições na maioria das chaves se aplicam à sessão em execução sem uma reinicialização. Isto inclui `permissions`, `hooks`, e auxiliares de credenciais como `apiKeyHelper`. O recarregamento cobre configurações de usuário, projeto, local e gerenciadas, e o [hook `ConfigChange`](/docs/pt/hooks#configchange) dispara para cada mudança detectada.

173 173 

174Algumas poucas chaves são lidas uma vez na inicialização da sessão e se aplicam na próxima reinicialização em vez disso:174Algumas poucas chaves são lidas uma vez na inicialização da sessão e se aplicam na próxima reinicialização em vez disso:

175 175 

176* `model`: use [`/model`](/pt/model-config#setting-your-model) para mudar no meio da sessão176* `model`: use [`/model`](/docs/pt/model-config#setting-your-model) para mudar no meio da sessão

177* [`outputStyle`](/pt/output-styles): parte do prompt do sistema, que é reconstruído em `/clear` ou reinicialização177* [`outputStyle`](/docs/pt/output-styles): parte do prompt do sistema, que é reconstruído em `/clear` ou reinicialização

178 178 

179<h3 id="invalid-entries-in-managed-settings">179<h3 id="invalid-entries-in-managed-settings">

180 Entradas inválidas em configurações gerenciadas180 Entradas inválidas em configurações gerenciadas

181</h3>181</h3>

182 182 

183Configurações gerenciadas analisam com tolerância. Quando uma configuração gerenciada contém uma entrada que falha na validação de esquema, o Claude Code remove essa entrada, registra um aviso, e aplica todas as políticas válidas restantes. Um único erro de digitação não pode desabilitar o resto da política da sua organização. Execute [`/doctor`](/pt/debug-your-config#check-resolved-settings) para listar entradas removidas com sua fonte de arquivo e campo.183Configurações gerenciadas analisam com tolerância. Quando uma configuração gerenciada contém uma entrada que falha na validação de esquema, o Claude Code remove essa entrada, registra um aviso, e aplica todas as políticas válidas restantes. Um único erro de digitação não pode desabilitar o resto da política da sua organização. Execute [`/doctor`](/docs/pt/debug-your-config#check-resolved-settings) para listar entradas removidas com sua fonte de arquivo e campo.

184 184 

185Este comportamento é consistente em todos os três mecanismos de entrega: [configurações gerenciadas pelo servidor](/pt/server-managed-settings), políticas de plist e registro implantadas através de MDM, e arquivos `managed-settings.json`. Requer Claude Code v2.1.169 ou posterior.185Este comportamento é consistente em todos os três mecanismos de entrega: [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings), políticas de plist e registro implantadas através de MDM, e arquivos `managed-settings.json`. Requer Claude Code v2.1.169 ou posterior.

186 186 

187Campos de aplicação de segurança são tratados por campo em vez de serem removidos no atacado quando estão presentes mas inválidos:187Campos de aplicação de segurança são tratados por campo em vez de serem removidos no atacado quando estão presentes mas inválidos:

188 188 

189| Campo | Comportamento quando presente mas inválido |189| Campo | Comportamento quando presente mas inválido |

190| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |190| :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

191| `allowedMcpServers` | Aplicado como uma lista de permissões vazia, então nenhum MCP server é admitido até que o valor seja corrigido. Uma entrada individual inválida é removida e o subconjunto válido é aplicado. |191| `allowedMcpServers` | Aplicado como uma lista de permissões vazia, então nenhum MCP server é admitido até que o valor seja corrigido. Uma entrada individual inválida é removida e o subconjunto válido é aplicado. |

192| `allowManagedMcpServersOnly` | Tratado como `true`. |192| `allowManagedMcpServersOnly` | Tratado como `true`. |

193| `availableModels` | {/* min-version: 2.1.175 */}Aplicado como uma lista de permissões vazia, então apenas o modelo Padrão está disponível até que o valor seja corrigido. Uma entrada individual não-string é removida e o subconjunto válido é aplicado. Se aplica em v2.1.175 e posterior. |193| `availableModels` | Aplicado como uma lista de permissões vazia, então apenas o modelo Padrão está disponível até que o valor seja corrigido. Uma entrada individual não-string é removida e o subconjunto válido é aplicado. Se aplica em v2.1.175 e posterior. |

194| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Tratado como `true`. Se aplica em v2.1.175 e posterior. |194| `enforceAvailableModels` | Tratado como `true`. Se aplica em v2.1.175 e posterior. |

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

196| `deniedMcpServers` | Uma entrada individual inválida é removida e o subconjunto válido é aplicado. Um valor totalmente inválido é descartado com um aviso, já que negar cada servidor bloquearia servidores que a política nunca nomeou. |196| `deniedMcpServers` | Uma entrada individual inválida é removida e o subconjunto válido é aplicado. Um valor totalmente inválido é descartado com um aviso, já que negar cada servidor bloquearia servidores que a política nunca nomeou. |

197| `sandbox.credentials` | {/* min-version: 2.1.191 */}Uma entrada individual inválida em `files` ou `envVars` é removida com um aviso e o subconjunto válido é aplicado. Um valor totalmente inválido de `credentials` é descartado com um aviso enquanto o resto de `sandbox` ainda se aplica. Se aplica em v2.1.191 e posterior. |197| `sandbox.credentials` | Uma entrada individual inválida em `files` ou `envVars` é removida com um aviso e o subconjunto válido é aplicado. Um valor totalmente inválido de `credentials` é descartado com um aviso enquanto o resto de `sandbox` ainda se aplica. Se aplica em v2.1.191 e posterior. |

198 198 

199`requiredMinimumVersion` e `requiredMaximumVersion` falham abertos por design: um valor inválido é removido em vez de ser aplicado, então um push de política ruim não pode impedir que o Claude Code inicie.199`requiredMinimumVersion` e `requiredMaximumVersion` falham abertos por design: um valor inválido é removido em vez de ser aplicado, então um push de política ruim não pode impedir que o Claude Code inicie.

200 200 


202 202 

203* Sessões interativas mostram um diálogo na inicialização listando as entradas inválidas.203* Sessões interativas mostram um diálogo na inicialização listando as entradas inválidas.

204* Execuções headless com `-p` imprimem um resumo para stderr.204* Execuções headless com `-p` imprimem um resumo para stderr.

205* [`claude doctor`](/pt/debug-your-config) lista cada entrada inválida com sua fonte e campo.205* [`claude doctor`](/docs/pt/debug-your-config) lista cada entrada inválida com sua fonte e campo.

206 206 

207Valide mudanças de política executando `claude doctor` em uma máquina de teste antes de implantá-las em toda a frota.207Valide mudanças de política executando `claude doctor` em uma máquina de teste antes de implantá-las em toda a frota.

208 208 


215`settings.json` suporta várias opções:215`settings.json` suporta várias opções:

216 216 

217| Chave | Descrição | Exemplo |217| Chave | Descrição | Exemplo |

218| :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |218| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |

219| `advisorModel` | Modelo para a [ferramenta advisor](/pt/advisor) do lado do servidor. Aceita um alias de modelo como `"opus"`, `"sonnet"`, ou `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), ou um ID de modelo completo. Escrito automaticamente quando você executa `/advisor`. Desdefina para desabilitar o advisor | `"opus"` |219| `advisorModel` | Modelo para a [ferramenta advisor](/docs/pt/advisor) do lado do servidor. Aceita um alias de modelo como `"opus"`, `"sonnet"`, ou `"fable"` (v2.1.170+), ou um ID de modelo completo. Escrito automaticamente quando você executa `/advisor`. Desdefina para desabilitar o advisor | `"opus"` |

220| `agent` | Executar a thread principal como um subagent nomeado, e definir o agente padrão para sessões despachadas de `claude agents`. Aplica o prompt do sistema, restrições de ferramenta e modelo do subagent. Veja [Invocar subagents explicitamente](/pt/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |220| `agent` | Executar a thread principal como um subagent nomeado, e definir o agente padrão para sessões despachadas de `claude agents`. Aplica o prompt do sistema, restrições de ferramenta e modelo do subagent. Veja [Invocar subagents explicitamente](/docs/pt/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Padrão**: `false`. Quando [Controle Remoto](/pt/remote-control) está conectado, permitir que Claude envie notificações push proativas para seu telefone, por exemplo quando uma tarefa longa termina. Aparece em `/config` como **Push when Claude decides**. Veja [Notificações push móveis](/pt/remote-control#mobile-push-notifications). Requer Claude Code v2.1.119 ou posterior | `true` |221| `agentPushNotifEnabled` | **Padrão**: `false`. Quando [Controle Remoto](/docs/pt/remote-control) está conectado, permitir que Claude envie notificações push proativas para seu telefone, por exemplo quando uma tarefa longa termina. Aparece em `/config` como **Push when Claude decides**. Veja [Notificações push móveis](/docs/pt/remote-control#mobile-push-notifications). Requer Claude Code v2.1.119 ou posterior | `true` |

222| `allowAllClaudeAiMcps` | (Apenas configurações gerenciadas) Carregar conectores claude.ai ao lado de um `managed-mcp.json` implantado, que de outra forma assume controle exclusivo e os suprime. Veja [Configuração MCP gerenciada](/pt/managed-mcp) | `true` |222| `allowAllClaudeAiMcps` | (Apenas configurações gerenciadas) Carregar conectores claude.ai ao lado de um `managed-mcp.json` implantado, que de outra forma assume controle exclusivo e os suprime. Veja [Configuração MCP gerenciada](/docs/pt/managed-mcp) | `true` |

223| `allowedChannelPlugins` | (Apenas configurações gerenciadas) Lista de permissões de plugins de canal que podem enviar mensagens. Substitui a lista de permissões padrão da Anthropic quando definido. Indefinido = voltar para o padrão, array vazio = bloquear todos os plugins de canal. Requer `channelsEnabled: true`. Veja [Restringir quais plugins de canal podem executar](/pt/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |223| `allowedChannelPlugins` | (Apenas configurações gerenciadas) Lista de permissões de plugins de canal que podem enviar mensagens. Substitui a lista de permissões padrão da Anthropic quando definido. Indefinido = voltar para o padrão, array vazio = bloquear todos os plugins de canal. Requer `channelsEnabled: true`. Veja [Restringir quais plugins de canal podem executar](/docs/pt/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |

224| `allowedHttpHookUrls` | Lista de permissões de padrões de URL que hooks HTTP podem almejar. Suporta `*` como curinga. Quando definido, hooks com URLs não correspondentes são bloqueados. Indefinido = sem restrição, array vazio = bloquear todos os hooks HTTP. Arrays se mesclam entre fontes de configuração. Veja [Configuração de hooks](#hook-configuration) | `["https://hooks.example.com/*"]` |224| `allowedHttpHookUrls` | Lista de permissões de padrões de URL que hooks HTTP podem almejar. Suporta `*` como curinga. Quando definido, hooks com URLs não correspondentes são bloqueados. Indefinido = sem restrição, array vazio = bloquear todos os hooks HTTP. Arrays se mesclam entre fontes de configuração. Veja [Configuração de hooks](#hook-configuration) | `["https://hooks.example.com/*"]` |

225| `allowedMcpServers` | Quando definido em managed-settings.json, lista de permissões de MCP servers que os usuários podem configurar. Indefinido = sem restrições, array vazio = bloqueio. Se aplica a todos os escopos. A lista de negação tem precedência. Veja [Configuração MCP gerenciada](/pt/managed-mcp) | `[{ "serverName": "github" }]` |225| `allowedMcpServers` | Quando definido em managed-settings.json, lista de permissões de MCP servers que os usuários podem configurar. Indefinido = sem restrições, array vazio = bloqueio. Se aplica a todos os escopos. A lista de negação tem precedência. Veja [Configuração MCP gerenciada](/docs/pt/managed-mcp) | `[{ "serverName": "github" }]` |

226| `allowManagedHooksOnly` | (Apenas configurações gerenciadas) Apenas hooks gerenciados, hooks SDK, e hooks de plugins força-habilitados em configurações gerenciadas `enabledPlugins` são carregados. Hooks de usuário, projeto e todos os outros plugins são bloqueados. Veja [Configuração de hooks](#hook-configuration) | `true` |226| `allowManagedHooksOnly` | (Apenas configurações gerenciadas) Apenas hooks gerenciados, hooks SDK, e hooks de plugins força-habilitados em configurações gerenciadas `enabledPlugins` são carregados. Hooks de usuário, projeto e todos os outros plugins são bloqueados. Veja [Configuração de hooks](#hook-configuration) | `true` |

227| `allowManagedMcpServersOnly` | (Apenas configurações gerenciadas) Apenas `allowedMcpServers` de configurações gerenciadas são respeitados. `deniedMcpServers` ainda se mescla de todas as fontes. Usuários ainda podem adicionar MCP servers, mas apenas a lista de permissões definida pelo administrador se aplica. Veja [Configuração MCP gerenciada](/pt/managed-mcp) | `true` |227| `allowManagedMcpServersOnly` | (Apenas configurações gerenciadas) Apenas `allowedMcpServers` de configurações gerenciadas são respeitados. `deniedMcpServers` ainda se mescla de todas as fontes. Usuários ainda podem adicionar MCP servers, mas apenas a lista de permissões definida pelo administrador se aplica. Veja [Configuração MCP gerenciada](/docs/pt/managed-mcp) | `true` |

228| `allowManagedPermissionRulesOnly` | (Apenas configurações gerenciadas) Impedir que configurações de usuário e projeto definam regras de permissão `allow`, `ask` ou `deny`. Apenas regras em configurações gerenciadas se aplicam. Veja [Configurações apenas gerenciadas](/pt/permissions#managed-only-settings) | `true` |228| `allowManagedPermissionRulesOnly` | (Apenas configurações gerenciadas) Impedir que configurações de usuário e projeto definam regras de permissão `allow`, `ask` ou `deny`. Apenas regras em configurações gerenciadas se aplicam. Veja [Configurações apenas gerenciadas](/docs/pt/permissions#managed-only-settings) | `true` |

229| `alwaysThinkingEnabled` | Ativar [pensamento estendido](/pt/model-config#extended-thinking) por padrão para todas as sessões. Tipicamente configurado via comando `/config` em vez de editar diretamente. Para forçar o pensamento desligado independentemente desta configuração, defina [`MAX_THINKING_TOKENS=0`](/pt/env-vars) em `env`, que desabilita o pensamento na API Anthropic exceto em Fable 5, que não pode ter o pensamento desligado. Em [provedores de terceiros](/pt/third-party-integrations) isto omite o parâmetro `thinking` em vez disso, e modelos de raciocínio adaptativo ainda podem pensar | `true` |229| `alwaysThinkingEnabled` | Ativar [pensamento estendido](/docs/pt/model-config#extended-thinking) por padrão para todas as sessões. Tipicamente configurado via comando `/config` em vez de editar diretamente. Para forçar o pensamento desligado independentemente desta configuração, defina [`MAX_THINKING_TOKENS=0`](/docs/pt/env-vars) em `env`, que desabilita o pensamento na API Anthropic exceto em Fable 5, que não pode ter o pensamento desligado. Em [provedores de terceiros](/docs/pt/third-party-integrations) isto omite o parâmetro `thinking` em vez disso, e modelos de raciocínio adaptativo ainda podem pensar | `true` |

230| `apiKeyHelper` | Comando personalizado, executado através do shell do sistema (`/bin/sh` no macOS e Linux, `cmd` no Windows), para gerar um valor de autenticação. Este valor será enviado como cabeçalhos `X-Api-Key` e `Authorization: Bearer` para solicitações de modelo. Defina o intervalo de atualização com [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/pt/env-vars) | `/bin/generate_temp_api_key.sh` |230| `apiKeyHelper` | Comando personalizado, executado através do shell do sistema (`/bin/sh` no macOS e Linux, `cmd` no Windows), para gerar um valor de autenticação. Este valor será enviado como cabeçalhos `X-Api-Key` e `Authorization: Bearer` para solicitações de modelo. Defina o intervalo de atualização com [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/docs/pt/env-vars) | `/bin/generate_temp_api_key.sh` |

231| `askUserQuestionTimeout` | {/* min-version: 2.1.200 */}**Padrão**: `"never"`. Tempo ocioso antes de um diálogo [`AskUserQuestion`](/pt/tools-reference) não respondido auto-continuar com quaisquer opções que você já tivesse selecionado. Aceita `"60s"`, `"5m"`, `"10m"`, ou `"never"`. Com o padrão, as perguntas esperam até você respondê-las. Aparece em `/config` como **Question auto-continue timeout**, que escreve esta chave em configurações de usuário. Não lido de configurações de projeto ou local. Requer Claude Code v2.1.200 ou posterior | `"5m"` |231| `askUserQuestionTimeout` | **Padrão**: `"never"`. Tempo ocioso antes de um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido auto-continuar com quaisquer opções que você já tivesse selecionado. Aceita `"60s"`, `"5m"`, `"10m"`, ou `"never"`. Com o padrão, as perguntas esperam até você respondê-las. Aparece em `/config` como **Question auto-continue timeout**, que escreve esta chave em configurações de usuário. Não lido de configurações de projeto ou local. Requer Claude Code v2.1.200 ou posterior | `"5m"` |

232| `attribution` | Personalizar atribuição para commits git e pull requests. Veja [Configurações de atribuição](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |232| `attribution` | Personalizar atribuição para commits git e pull requests. Veja [Configurações de atribuição](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

233| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**Padrão**: `true`. Compactar automaticamente a conversa quando o contexto se aproxima do limite. Aparece em `/config` como **Auto-compact**. Para desabilitar via variável de ambiente, defina [`DISABLE_AUTO_COMPACT`](/pt/env-vars) em `env` | `false` |233| `autoCompactEnabled` | **Padrão**: `true`. Compactar automaticamente a conversa quando o contexto se aproxima do limite. Aparece em `/config` como **Auto-compact**. Para desabilitar via variável de ambiente, defina [`DISABLE_AUTO_COMPACT`](/docs/pt/env-vars) em `env` | `false` |

234| `autoMemoryDirectory` | Diretório personalizado para armazenamento de [memória automática](/pt/memory#storage-location). Aceita um caminho absoluto ou um caminho com prefixo `~/`. A partir de configurações de projeto ou local, isto é honrado apenas após você aceitar o diálogo de confiança do workspace, já que um repositório clonado pode fornecer este arquivo | `"~/my-memory-dir"` |234| `autoMemoryDirectory` | Diretório personalizado para armazenamento de [memória automática](/docs/pt/memory#storage-location). Aceita um caminho absoluto ou um caminho com prefixo `~/`. A partir de configurações de projeto ou local, isto é honrado apenas após você aceitar o diálogo de confiança do workspace, já que um repositório clonado pode fornecer este arquivo | `"~/my-memory-dir"` |

235| `autoMemoryEnabled` | **Padrão**: `true`. Ativar [memória automática](/pt/memory#enable-or-disable-auto-memory). Quando `false`, Claude não lê ou escreve no diretório de memória automática. Você também pode alternar isto com `/memory` durante uma sessão. Para desabilitar via variável de ambiente, defina [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/pt/env-vars) em `env` | `false` |235| `autoMemoryEnabled` | **Padrão**: `true`. Ativar [memória automática](/docs/pt/memory#enable-or-disable-auto-memory). Quando `false`, Claude não lê ou escreve no diretório de memória automática. Você também pode alternar isto com `/memory` durante uma sessão. Para desabilitar via variável de ambiente, defina [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/pt/env-vars) em `env` | `false` |

236| `autoMode` | Personalizar o que o classificador de [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) bloqueia e permite. Contém arrays `environment`, `allow`, `soft_deny`, e `hard_deny` de regras em prosa. Inclua a string literal `"$defaults"` em um array para herdar as regras integradas nessa posição. Veja [Configurar modo automático](/pt/auto-mode-config). Lido de configurações de usuário, flag `--settings`, e configurações gerenciadas apenas. Ignorado em `.claude/settings.json` de projeto e `.claude/settings.local.json` local. {/* min-version: 2.1.207 */}Antes de v2.1.207, `.claude/settings.local.json` também era lido | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |236| `autoMode` | Personalizar o que o classificador de [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) bloqueia e permite. Contém arrays `environment`, `allow`, `soft_deny`, e `hard_deny` de regras em prosa. Inclua a string literal `"$defaults"` em um array para herdar as regras integradas nessa posição. Veja [Configurar modo automático](/docs/pt/auto-mode-config). Lido de configurações de usuário, flag `--settings`, e configurações gerenciadas apenas. Ignorado em `.claude/settings.json` de projeto e `.claude/settings.local.json` local. Antes de v2.1.207, `.claude/settings.local.json` também era lido | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

237| `autoMode.classifyAllShell` | {/* min-version: 2.1.193 */}**Padrão**: `false`. Quando `true`, suspende cada regra allow de Bash e PowerShell enquanto o modo automático está ativo para que todos os comandos shell sejam roteados através do classificador, não apenas regras que correspondem a padrões de execução de código arbitrário. Veja [Rotear todos os comandos shell através do classificador](/pt/auto-mode-config#route-all-shell-commands-through-the-classifier). Requer Claude Code v2.1.193 ou posterior | `true` |237| `autoMode.classifyAllShell` | **Padrão**: `false`. Quando `true`, suspende cada regra allow de Bash e PowerShell enquanto o modo automático está ativo para que todos os comandos shell sejam roteados através do classificador, não apenas regras que correspondem a padrões de execução de código arbitrário. Veja [Rotear todos os comandos shell através do classificador](/docs/pt/auto-mode-config#route-all-shell-commands-through-the-classifier). Requer Claude Code v2.1.193 ou posterior | `true` |

238| `autoScrollEnabled` | **Padrão**: `true`. Em [renderização fullscreen](/pt/fullscreen), seguir nova saída até o fundo da conversa. Aparece em `/config` como **Auto-scroll**. Prompts de permissão ainda rolam para a vista quando isto está desligado | `false` |238| `autoScrollEnabled` | **Padrão**: `true`. Em [renderização fullscreen](/docs/pt/fullscreen), seguir nova saída até o fundo da conversa. Aparece em `/config` como **Auto-scroll**. Prompts de permissão ainda rolam para a vista quando isto está desligado | `false` |

239| `autoUpdatesChannel` | **Padrão**: `"latest"`. Canal de lançamento a seguir para atualizações. Use `"stable"` para uma versão que é tipicamente cerca de uma semana antiga e pula versões com regressões maiores, ou `"latest"` para o lançamento mais recente. Para desabilitar auto-atualizações completamente, defina [`DISABLE_AUTOUPDATER`](/pt/setup#disable-auto-updates) em `env` | `"stable"` |239| `autoUpdatesChannel` | **Padrão**: `"latest"`. Canal de lançamento a seguir para atualizações. Use `"stable"` para uma versão que é tipicamente cerca de uma semana antiga e pula versões com regressões maiores, ou `"latest"` para o lançamento mais recente. Para desabilitar auto-atualizações completamente, defina [`DISABLE_AUTOUPDATER`](/docs/pt/setup#disable-auto-updates) em `env` | `"stable"` |

240| `availableModels` | Restringir quais modelos os usuários podem selecionar para a sessão principal, [subagents](/pt/sub-agents), [skills](/pt/skills), e o [advisor](/pt/advisor). Não afeta a opção Padrão a menos que `enforceAvailableModels` também esteja definido. Veja [Restringir seleção de modelo](/pt/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |240| `availableModels` | Restringir quais modelos os usuários podem selecionar para a sessão principal, [subagents](/docs/pt/sub-agents), [skills](/docs/pt/skills), e o [advisor](/docs/pt/advisor). Não afeta a opção Padrão a menos que `enforceAvailableModels` também esteja definido. Veja [Restringir seleção de modelo](/docs/pt/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |

241| `awaySummaryEnabled` | Mostrar um resumo de sessão de uma linha quando você retorna ao terminal após alguns minutos ausente. Defina como `false` ou desative Resumo de sessão em `/config` para desabilitar. Mesmo que [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/pt/env-vars) | `true` |241| `awaySummaryEnabled` | Mostrar um resumo de sessão de uma linha quando você retorna ao terminal após alguns minutos ausente. Defina como `false` ou desative Resumo de sessão em `/config` para desabilitar. Mesmo que [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/docs/pt/env-vars) | `true` |

242| `awsAuthRefresh` | Script personalizado que modifica o diretório `.aws` (veja [configuração avançada de credenciais](/pt/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |242| `awsAuthRefresh` | Script personalizado que modifica o diretório `.aws` (veja [configuração avançada de credenciais](/docs/pt/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |

243| `awsCredentialExport` | Script personalizado que produz JSON com credenciais AWS (veja [configuração avançada de credenciais](/pt/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |243| `awsCredentialExport` | Script personalizado que produz JSON com credenciais AWS (veja [configuração avançada de credenciais](/docs/pt/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

244| `axScreenReader` | {/* min-version: 2.1.181 */}Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. O modo leitor de tela usa o renderizador clássico, então a configuração `tui` não tem efeito enquanto está ativo; [sessões em background](/pt/agent-view) anexadas ainda renderizam fullscreen. A variável de ambiente [`CLAUDE_AX_SCREEN_READER`](/pt/env-vars) e a flag [`--ax-screen-reader`](/pt/cli-reference#cli-flags) têm precedência. Requer Claude Code v2.1.181 ou posterior | `true` |244| `axScreenReader` | Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. O modo leitor de tela usa o renderizador clássico, então a configuração `tui` não tem efeito enquanto está ativo; [sessões em background](/docs/pt/agent-view) anexadas ainda renderizam fullscreen. A variável de ambiente [`CLAUDE_AX_SCREEN_READER`](/docs/pt/env-vars) e a flag [`--ax-screen-reader`](/docs/pt/cli-reference#cli-flags) têm precedência. Requer Claude Code v2.1.181 ou posterior | `true` |

245| `blockedMarketplaces` | (Apenas configurações gerenciadas) Lista de negação de fontes de marketplace. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Fontes bloqueadas são verificadas antes do download, então nunca tocam o sistema de arquivos. Veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |245| `blockedMarketplaces` | (Apenas configurações gerenciadas) Lista de negação de fontes de marketplace. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Fontes bloqueadas são verificadas antes do download, então nunca tocam o sistema de arquivos. Veja [Restrições de marketplace gerenciado](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

246| `browserExternalPageTools` | (Apenas configurações gerenciadas) Defina como `"disabled"` para impedir que Claude use ferramentas para ler ou agir em páginas externas no painel [Browser](/pt/desktop#browse-external-sites) do aplicativo desktop. Os usuários ainda podem navegar para sites externos eles mesmos, e visualizações de servidor de desenvolvimento local não são afetadas | `"disabled"` |246| `browserExternalPageTools` | (Apenas configurações gerenciadas) Defina como `"disabled"` para impedir que Claude use ferramentas para ler ou agir em páginas externas no painel [Browser](/docs/pt/desktop#browse-external-sites) do aplicativo desktop. Os usuários ainda podem navegar para sites externos eles mesmos, e visualizações de servidor de desenvolvimento local não são afetadas | `"disabled"` |

247| `channelsEnabled` | (Apenas configurações gerenciadas) Permitir [channels](/pt/channels) para a organização. Em planos Claude.ai Team e Enterprise, channels são bloqueados quando isto está indefinido ou `false`. Para contas [Anthropic Console](/pt/authentication#claude-console-authentication) usando autenticação de chave de API, channels são permitidos por padrão a menos que sua organização implante configurações gerenciadas, nesse caso esta chave deve ser definida como `true` | `true` |247| `channelsEnabled` | (Apenas configurações gerenciadas) Permitir [channels](/docs/pt/channels) para a organização. Em planos Claude.ai Team e Enterprise, channels são bloqueados quando isto está indefinido ou `false`. Para contas [Anthropic Console](/docs/pt/authentication#claude-console-authentication) usando autenticação de chave de API, channels são permitidos por padrão a menos que sua organização implante configurações gerenciadas, nesse caso esta chave deve ser definida como `true` | `true` |

248| `claudeMd` | (Apenas configurações gerenciadas) Instruções no estilo CLAUDE.md injetadas como memória gerenciada pela organização. Apenas honrado quando definido em configurações gerenciadas ou de política e ignorado em configurações de usuário, projeto e local. Veja [CLAUDE.md em toda a organização](/pt/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |248| `claudeMd` | (Apenas configurações gerenciadas) Instruções no estilo CLAUDE.md injetadas como memória gerenciada pela organização. Apenas honrado quando definido em configurações gerenciadas ou de política e ignorado em configurações de usuário, projeto e local. Veja [CLAUDE.md em toda a organização](/docs/pt/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

249| `claudeMdExcludes` | Padrões Glob ou caminhos absolutos de arquivos `CLAUDE.md` para pular ao carregar [memória](/pt/memory). Padrões correspondem contra caminhos de arquivo absolutos. Aplica-se apenas a memória de usuário, projeto e local; arquivos de política gerenciada não podem ser excluídos | `["**/vendor/**/CLAUDE.md"]` |249| `claudeMdExcludes` | Padrões Glob ou caminhos absolutos de arquivos `CLAUDE.md` para pular ao carregar [memória](/docs/pt/memory). Padrões correspondem contra caminhos de arquivo absolutos. Aplica-se apenas a memória de usuário, projeto e local; arquivos de política gerenciada não podem ser excluídos | `["**/vendor/**/CLAUDE.md"]` |

250| `cleanupPeriodDays` | **Padrão**: `30` dias, mínimo `1`. Claude Code deleta [arquivos de sessão e outros dados de aplicação](/pt/claude-directory#cleaned-up-automatically) mais antigos que este período na inicialização. Definir `0` falha com um erro de validação. O mesmo corte de idade se aplica à remoção automática de [worktrees órfãos](/pt/worktrees#clean-up-worktrees) na inicialização. {/* min-version: 2.1.203 */}Se Claude Code não conseguir ler ou analisar um arquivo de configuração, ele pausa a varredura de limpeza de retenção e mostra um aviso em `/status` até você corrigir o arquivo, a menos que [configurações gerenciadas](/pt/server-managed-settings) forneçam `cleanupPeriodDays`, nesse caso a varredura executa no valor gerenciado. Antes de v2.1.203, a limpeza executava no padrão de 30 dias nesse estado e poderia deletar transcrições que um `cleanupPeriodDays` mais longo era destinado a manter; arquivos mais novos que 30 dias nunca foram removidos. Para desabilitar escritas de transcrição completamente, defina a variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/pt/env-vars). Em modo não interativo, passe `--no-session-persistence` ao lado de `-p` ou defina `persistSession: false` no Agent SDK. | `20` |250| `cleanupPeriodDays` | **Padrão**: `30` dias, mínimo `1`. Claude Code deleta [arquivos de sessão e outros dados de aplicação](/docs/pt/claude-directory#cleaned-up-automatically) mais antigos que este período na inicialização. Definir `0` falha com um erro de validação. O mesmo corte de idade se aplica à remoção automática de [worktrees órfãos](/docs/pt/worktrees#clean-up-worktrees) na inicialização. Se Claude Code não conseguir ler ou analisar um arquivo de configuração, ele pausa a varredura de limpeza de retenção e mostra um aviso em `/status` até você corrigir o arquivo, a menos que [configurações gerenciadas](/docs/pt/server-managed-settings) forneçam `cleanupPeriodDays`, nesse caso a varredura executa no valor gerenciado. Antes de v2.1.203, a limpeza executava no padrão de 30 dias nesse estado e poderia deletar transcrições que um `cleanupPeriodDays` mais longo era destinado a manter; arquivos mais novos que 30 dias nunca foram removidos. Para desabilitar escritas de transcrição completamente, defina a variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/pt/env-vars). Em modo não interativo, passe `--no-session-persistence` ao lado de `-p` ou defina `persistSession: false` no Agent SDK. | `20` |

251| `companyAnnouncements` | Anúncio a ser exibido aos usuários na inicialização. Se múltiplos anúncios forem fornecidos, eles serão alternados aleatoriamente. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |251| `companyAnnouncements` | Anúncio a ser exibido aos usuários na inicialização. Se múltiplos anúncios forem fornecidos, eles serão alternados aleatoriamente. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

252| `defaultShell` | **Padrão**: `"bash"`, ou `"powershell"` no Windows quando Bash não está disponível. Shell padrão para comandos `!` da caixa de entrada. Aceita `"bash"` ou `"powershell"`. Definir `"powershell"` roteia comandos `!` interativos através do PowerShell no Windows. Requer `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Veja [Ferramenta PowerShell](/pt/tools-reference#powershell-tool) | `"powershell"` |252| `defaultShell` | **Padrão**: `"bash"`, ou `"powershell"` no Windows quando Bash não está disponível. Shell padrão para comandos `!` da caixa de entrada. Aceita `"bash"` ou `"powershell"`. Definir `"powershell"` roteia comandos `!` interativos através do PowerShell no Windows. Requer `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Veja [Ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) | `"powershell"` |

253| `deniedMcpServers` | Quando definido em managed-settings.json, lista de negação de MCP servers que são explicitamente bloqueados. Se aplica a todos os escopos incluindo servers gerenciados. A lista de negação tem precedência sobre a lista de permissões. Veja [Configuração MCP gerenciada](/pt/managed-mcp) | `[{ "serverName": "filesystem" }]` |253| `deniedMcpServers` | Quando definido em managed-settings.json, lista de negação de MCP servers que são explicitamente bloqueados. Se aplica a todos os escopos incluindo servers gerenciados. A lista de negação tem precedência sobre a lista de permissões. Veja [Configuração MCP gerenciada](/docs/pt/managed-mcp) | `[{ "serverName": "filesystem" }]` |

254| `disableAgentView` | Defina como `true` para desligar [agentes em background e visualização de agente](/pt/agent-view): `claude agents`, `--bg`, `/background`, e o supervisor sob demanda. Tipicamente definido em [configurações gerenciadas](/pt/permissions#managed-settings). Equivalente a definir `CLAUDE_CODE_DISABLE_AGENT_VIEW` como `1` | `true` |254| `disableAgentView` | Defina como `true` para desligar [agentes em background e visualização de agente](/docs/pt/agent-view): `claude agents`, `--bg`, `/background`, e o supervisor sob demanda. Tipicamente definido em [configurações gerenciadas](/docs/pt/permissions#managed-settings). Equivalente a definir `CLAUDE_CODE_DISABLE_AGENT_VIEW` como `1` | `true` |

255| `disableAllHooks` | Desabilitar todos os [hooks](/pt/hooks) e qualquer [linha de status](/pt/statusline) personalizada | `true` |255| `disableAllHooks` | Desabilitar todos os [hooks](/docs/pt/hooks) e qualquer [linha de status](/docs/pt/statusline) personalizada | `true` |

256| `disableArtifact` | Defina como `true` para desabilitar a ferramenta [Artifact](/pt/artifacts), que publica saída de sessão como uma página web privada no claude.ai. Equivalente a definir `CLAUDE_CODE_DISABLE_ARTIFACT` como `1` | `true` |256| `disableArtifact` | Defina como `true` para desabilitar a ferramenta [Artifact](/docs/pt/artifacts), que publica saída de sessão como uma página web privada no claude.ai. Equivalente a definir `CLAUDE_CODE_DISABLE_ARTIFACT` como `1` | `true` |

257| `disableAutoMode` | Defina como `"disable"` para impedir que o [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) seja ativado. Remove `auto` do ciclo `Shift+Tab` e rejeita `--permission-mode auto` na inicialização. Mais útil em [configurações gerenciadas](/pt/permissions#managed-settings) onde os usuários não podem substituir | `"disable"` |257| `disableAutoMode` | Defina como `"disable"` para impedir que o [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) seja ativado. Remove `auto` do ciclo `Shift+Tab` e rejeita `--permission-mode auto` na inicialização. Mais útil em [configurações gerenciadas](/docs/pt/permissions#managed-settings) onde os usuários não podem substituir | `"disable"` |

258| `disableBrowserExternalNavigation` | (Apenas configurações gerenciadas) Defina como `true` para desligar navegação externa no painel [Browser](/pt/desktop#browse-external-sites) do aplicativo desktop. Nem usuários nem Claude podem navegar para sites externos, e visualizações de servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada | `true` |258| `disableBrowserExternalNavigation` | (Apenas configurações gerenciadas) Defina como `true` para desligar navegação externa no painel [Browser](/docs/pt/desktop#browse-external-sites) do aplicativo desktop. Nem usuários nem Claude podem navegar para sites externos, e visualizações de servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada | `true` |

259| `disableBundledSkills` | Defina como `true` para desabilitar as [skills](/pt/skills) e workflows que vêm com o Claude Code: skills agrupadas e workflows são removidos completamente, 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`](/pt/env-vars) em vez disso. Skills de plugins, `.claude/skills/`, e `.claude/commands/` não são afetadas. Equivalente a definir `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` como `1` | `true` |259| `disableBundledSkills` | Defina como `true` para desabilitar as [skills](/docs/pt/skills) e workflows que vêm com o Claude Code: skills agrupadas e workflows são removidos completamente, 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`](/docs/pt/env-vars) em vez disso. Skills de plugins, `.claude/skills/`, e `.claude/commands/` não são afetadas. Equivalente a definir `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` como `1` | `true` |

260| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Desabilitar [conectores MCP claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) para que não sejam auto-buscados ou conectados. Defina em qualquer escopo de configuração. `true` em qualquer fonte tem precedência, então um `.claude/settings.json` de projeto verificado pode optar um repositório por conectores de nuvem, mas um `false` de nível de projeto não pode substituir um `true` de nível de usuário ou política. Servers passados explicitamente via `--mcp-config` não são afetados. Para negar conectores individuais em vez de todos eles, use [`deniedMcpServers`](/pt/managed-mcp). Requer Claude Code v2.1.182 ou posterior | `true` |260| `disableClaudeAiConnectors` | Desabilitar [conectores MCP claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) para que não sejam auto-buscados ou conectados. Defina em qualquer escopo de configuração. `true` em qualquer fonte tem precedência, então um `.claude/settings.json` de projeto verificado pode optar um repositório por conectores de nuvem, mas um `false` de nível de projeto não pode substituir um `true` de nível de usuário ou política. Servers passados explicitamente via `--mcp-config` não são afetados. Para negar conectores individuais em vez de todos eles, use [`deniedMcpServers`](/docs/pt/managed-mcp). Requer Claude Code v2.1.182 ou posterior | `true` |

261| `disableDeepLinkRegistration` | Defina como `"disable"` para impedir que o Claude Code registre o manipulador de protocolo `claude-cli://` com o sistema operacional na inicialização. [Deep links](/pt/deep-links) permitem que ferramentas externas abram uma sessão do Claude Code com um prompt pré-preenchido. Útil em ambientes onde o registro de manipulador de protocolo é restrito ou gerenciado separadamente | `"disable"` |261| `disableDeepLinkRegistration` | Defina como `"disable"` para impedir que o Claude Code registre o manipulador de protocolo `claude-cli://` com o sistema operacional na inicialização. [Deep links](/docs/pt/deep-links) permitem que ferramentas externas abram uma sessão do Claude Code com um prompt pré-preenchido. Útil em ambientes onde o registro de manipulador de protocolo é restrito ou gerenciado separadamente | `"disable"` |

262| `disabledMcpjsonServers` | Lista de MCP servers específicos de arquivos `.mcp.json` para rejeitar | `["filesystem"]` |262| `disabledMcpjsonServers` | Lista de MCP servers específicos de arquivos `.mcp.json` para rejeitar | `["filesystem"]` |

263| `disableRemoteControl` | {/* min-version: 2.1.128 */}Desabilitar [Controle Remoto](/pt/remote-control): bloqueia `claude remote-control`, a flag `--remote-control`, auto-start, e o toggle em sessão. Tipicamente colocado em [configurações gerenciadas](/pt/permissions#managed-settings) para aplicação de MDM por dispositivo, mas funciona de qualquer escopo. Requer Claude Code v2.1.128 ou posterior | `true` |263| `disableRemoteControl` | Desabilitar [Controle Remoto](/docs/pt/remote-control): bloqueia `claude remote-control`, a flag `--remote-control`, auto-start, e o toggle em sessão. Tipicamente colocado em [configurações gerenciadas](/docs/pt/permissions#managed-settings) para aplicação de MDM por dispositivo, mas funciona de qualquer escopo. Requer Claude Code v2.1.128 ou posterior | `true` |

264| `disableSideloadFlags` | {/* min-version: 2.1.193 */}(Apenas configurações gerenciadas) Rejeitar as flags CLI `--plugin-dir`, `--plugin-url`, `--agents`, e `--mcp-config` na inicialização, que os usuários poderiam passar para contornar [`strictKnownMarketplaces`](#strictknownmarketplaces) para uma única execução. Também rejeita estas flags de qualquer superfície que gera a CLI com elas internamente, atualmente [Cowork](/pt/desktop) sessões locais no aplicativo desktop. Um `--mcp-config` cujos servers são todas entradas `type: "sdk"` em processo ainda é aceito, então o Agent SDK e a extensão VS Code continuam funcionando. Não bloqueia `claude mcp add`, `.mcp.json`, ou SDK `setMcpServers()`; emparelhe com [`allowedMcpServers`](/pt/managed-mcp) para controle de MCP por servidor. Requer Claude Code v2.1.193 ou posterior | `true` |264| `disableSideloadFlags` | (Apenas configurações gerenciadas) Rejeitar as flags CLI `--plugin-dir`, `--plugin-url`, `--agents`, e `--mcp-config` na inicialização, que os usuários poderiam passar para contornar [`strictKnownMarketplaces`](#strictknownmarketplaces) para uma única execução. Também rejeita estas flags de qualquer superfície que gera a CLI com elas internamente, atualmente [Cowork](/docs/pt/desktop) sessões locais no aplicativo desktop. Um `--mcp-config` cujos servers são todas entradas `type: "sdk"` em processo ainda é aceito, então o Agent SDK e a extensão VS Code continuam funcionando. Não bloqueia `claude mcp add`, `.mcp.json`, ou SDK `setMcpServers()`; emparelhe com [`allowedMcpServers`](/docs/pt/managed-mcp) para controle de MCP por servidor. Requer Claude Code v2.1.193 ou posterior | `true` |

265| `disableSkillShellExecution` | Desabilitar execução de shell inline para blocos `` !`...` `` e ` ```! ` em [skills](/pt/skills) e comandos personalizados de fontes de usuário, projeto, plugin ou diretório adicional. Comandos são substituídos por `[shell command execution disabled by policy]` em vez de serem executados. Skills agrupadas e gerenciadas não são afetadas. Mais útil em [configurações gerenciadas](/pt/permissions#managed-settings) onde os usuários não podem substituir | `true` |265| `disableSkillShellExecution` | Desabilitar execução de shell inline para blocos `` !`...` `` e ` ```! ` em [skills](/pt/skills) e comandos personalizados de fontes de usuário, projeto, plugin ou diretório adicional. Comandos são substituídos por `[shell command execution disabled by policy]` em vez de serem executados. Skills agrupadas e gerenciadas não são afetadas. Mais útil em [configurações gerenciadas](/pt/permissions#managed-settings) onde os usuários não podem substituir | `true` |

266| `disableWorkflows` | **Padrão**: `false`. Desabilitar [workflows dinâmicos](/pt/workflows#turn-workflows-off) e os comandos de workflow agrupados. Equivalente a definir `CLAUDE_CODE_DISABLE_WORKFLOWS` como `1` | `true` |266| `disableWorkflows` | **Padrão**: `false`. Desabilitar [workflows dinâmicos](/docs/pt/workflows#turn-workflows-off) e os comandos de workflow agrupados. Equivalente a definir `CLAUDE_CODE_DISABLE_WORKFLOWS` como `1` | `true` |

267| `editorMode` | **Padrão**: `"normal"`. Modo de atalho de teclado para o prompt de entrada: `"normal"` ou `"vim"`. Aparece em `/config` como **Editor mode** | `"vim"` |267| `editorMode` | **Padrão**: `"normal"`. Modo de atalho de teclado para o prompt de entrada: `"normal"` ou `"vim"`. Aparece em `/config` como **Editor mode** | `"vim"` |

268| `effortLevel` | Persistir o [nível de esforço](/pt/model-config#adjust-effort-level) entre sessões. Aceita `"low"`, `"medium"`, `"high"`, ou `"xhigh"`. Escrito automaticamente quando você executa `/effort` com um desses valores. `--effort` e [`CLAUDE_CODE_EFFORT_LEVEL`](/pt/env-vars) substituem isto para uma sessão. Veja [Ajustar nível de esforço](/pt/model-config#adjust-effort-level) para modelos suportados | `"xhigh"` |268| `effortLevel` | Persistir o [nível de esforço](/docs/pt/model-config#adjust-effort-level) entre sessões. Aceita `"low"`, `"medium"`, `"high"`, ou `"xhigh"`. Escrito automaticamente quando você executa `/effort` com um desses valores. `--effort` e [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/pt/env-vars) substituem isto para uma sessão. Veja [Ajustar nível de esforço](/docs/pt/model-config#adjust-effort-level) para modelos suportados | `"xhigh"` |

269| `enableAllProjectMcpServers` | Aprovar automaticamente todos os MCP servers definidos em arquivos `.mcp.json` do projeto. {/* min-version: 2.1.196 */}A partir de v2.1.196, `claude mcp list` e `claude mcp get` honram esta chave em uma pasta não confiável apenas de [arquivos de configuração que não são verificados no repositório](/pt/mcp#managing-your-servers) | `true` |269| `enableAllProjectMcpServers` | Aprovar automaticamente todos os MCP servers definidos em arquivos `.mcp.json` do projeto. A partir de v2.1.196, `claude mcp list` e `claude mcp get` honram esta chave em uma pasta não confiável apenas de [arquivos de configuração que não são verificados no repositório](/docs/pt/mcp#managing-your-servers) | `true` |

270| `enableArtifact` | {/* min-version: 2.1.196 */}Ativar ou desabilitar a ferramenta [Artifact](/pt/artifacts) para este usuário. Quando indefinido, o padrão segue a [disponibilidade](/pt/artifacts#availability) do recurso para sua conta. A linha **Artifacts** em `/config` escreve esta chave. Um `disableArtifact` gerenciado e sua [configuração de administrador](/pt/artifacts#manage-artifacts-for-your-organization) da organização têm precedência, e a chave é ignorada em configurações de projeto e local (`.claude/settings.json`, `.claude/settings.local.json`), que um repositório poderia de outra forma confirmar. Requer Claude Code v2.1.196 ou posterior | `true` |270| `enableArtifact` | Ativar ou desabilitar a ferramenta [Artifact](/docs/pt/artifacts) para este usuário. Quando indefinido, o padrão segue a [disponibilidade](/docs/pt/artifacts#availability) do recurso para sua conta. A linha **Artifacts** em `/config` escreve esta chave. Um `disableArtifact` gerenciado e sua [configuração de administrador](/docs/pt/artifacts#manage-artifacts-for-your-organization) da organização têm precedência, e a chave é ignorada em configurações de projeto e local (`.claude/settings.json`, `.claude/settings.local.json`), que um repositório poderia de outra forma confirmar. Requer Claude Code v2.1.196 ou posterior | `true` |

271| `enabledMcpjsonServers` | Lista de MCP servers específicos de arquivos `.mcp.json` para aprovar. {/* min-version: 2.1.196 */}A partir de v2.1.196, `claude mcp list` e `claude mcp get` honram esta chave em uma pasta não confiável apenas de [arquivos de configuração que não são verificados no repositório](/pt/mcp#managing-your-servers) | `["memory", "github"]` |271| `enabledMcpjsonServers` | Lista de MCP servers específicos de arquivos `.mcp.json` para aprovar. A partir de v2.1.196, `claude mcp list` e `claude mcp get` honram esta chave em uma pasta não confiável apenas de [arquivos de configuração que não são verificados no repositório](/docs/pt/mcp#managing-your-servers) | `["memory", "github"]` |

272| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Estender a lista de permissões `availableModels` para o modelo Padrão. Quando `true` em configurações gerenciadas e `availableModels` é uma lista não-vazia, a opção Padrão volta para a primeira entrada na lista de permissões que está disponível, mas apenas quando o modelo padrão para a [organização](/pt/model-config#organization-default-model) quando um se aplica, caso contrário o padrão do tipo de conta não está na lista de permissões; um padrão na lista de permissões é mantido como está. Não tem efeito quando `availableModels` está indefinido ou vazio. Veja [Aplicar a lista de permissões para o modelo Padrão](/pt/model-config#enforce-the-allowlist-for-the-default-model). Requer Claude Code v2.1.175 ou posterior | `true` |272| `enforceAvailableModels` | Estender a lista de permissões `availableModels` para o modelo Padrão. Quando `true` em configurações gerenciadas e `availableModels` é uma lista não-vazia, a opção Padrão volta para a primeira entrada na lista de permissões que está disponível, mas apenas quando o modelo padrão para a [organização](/docs/pt/model-config#organization-default-model) quando um se aplica, caso contrário o padrão do tipo de conta não está na lista de permissões; um padrão na lista de permissões é mantido como está. Não tem efeito quando `availableModels` está indefinido ou vazio. Veja [Aplicar a lista de permissões para o modelo Padrão](/docs/pt/model-config#enforce-the-allowlist-for-the-default-model). Requer Claude Code v2.1.175 ou posterior | `true` |

273| `env` | Variáveis de ambiente aplicadas a cada sessão e a subprocessos que Claude Code gera a partir dela. Defina uma variável como `""` para substituir uma exportação de shell com uma string vazia, que Claude Code trata como não definida para seleção de provedor. Subprocessos ainda herdam o valor vazio. `NO_COLOR` e `FORCE_COLOR` definidos aqui alcançam apenas subprocessos; para mudar as cores da interface do Claude Code, defina-os em seu shell antes de lançar `claude`. {/* min-version: 2.1.195 */}A partir de v2.1.195, variáveis de identidade que ambientes de hospedagem do Claude Code definem, por exemplo `CLAUDE_CODE_REMOTE` e `CLAUDE_CODE_ACCOUNT_UUID`, são ignoradas quando definidas aqui | `{"FOO": "bar"}` |273| `env` | Variáveis de ambiente aplicadas a cada sessão e a subprocessos que Claude Code gera a partir dela. Defina uma variável como `""` para substituir uma exportação de shell com uma string vazia, que Claude Code trata como não definida para seleção de provedor. Subprocessos ainda herdam o valor vazio. `NO_COLOR` e `FORCE_COLOR` definidos aqui alcançam apenas subprocessos; para mudar as cores da interface do Claude Code, defina-os em seu shell antes de lançar `claude`. A partir de v2.1.195, variáveis de identidade que ambientes de hospedagem do Claude Code definem, por exemplo `CLAUDE_CODE_REMOTE` e `CLAUDE_CODE_ACCOUNT_UUID`, são ignoradas quando definidas aqui | `{"FOO": "bar"}` |

274| `fallbackModel` | Modelo(s) de fallback para tentar em ordem quando o modelo primário está sobrecarregado ou indisponível. O Claude Code muda para o próximo modelo disponível na cadeia para o resto do turno e mostra um aviso. `"default"` expande para o modelo padrão. Cadeias são limitadas a três modelos; entradas extras são ignoradas. Ao contrário da maioria das configurações de array, esta chave não se mescla entre arquivos de configuração: o arquivo de precedência mais alta que a define fornece a cadeia inteira. A flag [`--fallback-model`](/pt/cli-reference#cli-flags) substitui isto para uma sessão. Veja [Cadeias de modelo de fallback](/pt/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |274| `fallbackModel` | Modelo(s) de fallback para tentar em ordem quando o modelo primário está sobrecarregado ou indisponível. O Claude Code muda para o próximo modelo disponível na cadeia para o resto do turno e mostra um aviso. `"default"` expande para o modelo padrão. Cadeias são limitadas a três modelos; entradas extras são ignoradas. Ao contrário da maioria das configurações de array, esta chave não se mescla entre arquivos de configuração: o arquivo de precedência mais alta que a define fornece a cadeia inteira. A flag [`--fallback-model`](/docs/pt/cli-reference#cli-flags) substitui isto para uma sessão. Veja [Cadeias de modelo de fallback](/docs/pt/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |

275| `fastMode` | Ativar [modo rápido](/pt/fast-mode) para sessões onde está disponível. Alternar com `/fast` escreve `true` aqui em configurações de usuário e remove a chave quando você desliga o modo rápido | `true` |275| `fastMode` | Ativar [modo rápido](/docs/pt/fast-mode) para sessões onde está disponível. Alternar com `/fast` escreve `true` aqui em configurações de usuário e remove a chave quando você desliga o modo rápido | `true` |

276| `fastModePerSessionOptIn` | Quando `true`, o modo rápido não persiste entre sessões. Cada sessão começa com modo rápido desligado, exigindo que os usuários o habilitem com `/fast`. A preferência de modo rápido do usuário ainda é salva. Veja [Exigir opt-in por sessão](/pt/fast-mode#require-per-session-opt-in) | `true` |276| `fastModePerSessionOptIn` | Quando `true`, o modo rápido não persiste entre sessões. Cada sessão começa com modo rápido desligado, exigindo que os usuários o habilitem com `/fast`. A preferência de modo rápido do usuário ainda é salva. Veja [Exigir opt-in por sessão](/docs/pt/fast-mode#require-per-session-opt-in) | `true` |

277| `feedbackSurveyRate` | Probabilidade (0–1) que a [pesquisa de qualidade de sessão](/pt/data-usage#session-quality-surveys) aparece quando elegível. Defina como `0` para suprimir completamente, ou defina [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/pt/env-vars) em `env`. Útil ao usar Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry onde a taxa de amostra padrão não se aplica | `0.05` |277| `feedbackSurveyRate` | Probabilidade (0–1) que a [pesquisa de qualidade de sessão](/docs/pt/data-usage#session-quality-surveys) aparece quando elegível. Defina como `0` para suprimir completamente, ou defina [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/docs/pt/env-vars) em `env`. Útil ao usar Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry onde a taxa de amostra padrão não se aplica | `0.05` |

278| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**Padrão**: `true`. Fazer snapshot de arquivos antes de cada edição para que [`/rewind`](/pt/checkpointing) possa restaurá-los. Aparece em `/config` como **Rewind code (checkpoints)**. Para desabilitar via variável de ambiente, defina [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/pt/env-vars) em `env` | `false` |278| `fileCheckpointingEnabled` | **Padrão**: `true`. Fazer snapshot de arquivos antes de cada edição para que [`/rewind`](/docs/pt/checkpointing) possa restaurá-los. Aparece em `/config` como **Rewind code (checkpoints)**. Para desabilitar via variável de ambiente, defina [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/docs/pt/env-vars) em `env` | `false` |

279| `fileSuggestion` | Configure um script personalizado para preenchimento automático de arquivo `@`. Veja [Configurações de sugestão de arquivo](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |279| `fileSuggestion` | Configure um script personalizado para preenchimento automático de arquivo `@`. Veja [Configurações de sugestão de arquivo](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

280| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Renderizar badges clicáveis extras no rodapé quando uma regex corresponde à saída de turno. Cada entrada tem um `pattern`, um modelo de URL `url` com placeholders `{name}` preenchidos de grupos de captura nomeados, e um `label` opcional. Lido apenas de configurações de usuário, flag `--settings`, e configurações gerenciadas. Veja [Badges de link de rodapé](#footer-link-badges) para restrições de URL, lista de permissões de esquema, e limites. Requer Claude Code v2.1.176 ou posterior | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |280| `footerLinksRegexes` | Renderizar badges clicáveis extras no rodapé quando uma regex corresponde à saída de turno. Cada entrada tem um `pattern`, um modelo de URL `url` com placeholders `{name}` preenchidos de grupos de captura nomeados, e um `label` opcional. Lido apenas de configurações de usuário, flag `--settings`, e configurações gerenciadas. Veja [Badges de link de rodapé](#footer-link-badges) para restrições de URL, lista de permissões de esquema, e limites. Requer Claude Code v2.1.176 ou posterior | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |

281| `forceLoginMethod` | Use `claudeai` para restringir login a contas Claude.ai, `console` para restringir login a contas Claude Console, ou `gateway` para restringir login a um gateway de nuvem; veja [gateway de aplicativos Claude](/pt/claude-apps-gateway). Quando definido em qualquer valor em configurações gerenciadas, sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` são bloqueadas na inicialização, já que uma credencial de ambiente não pode satisfazer o método de login necessário. Sessões de provedor de terceiros como Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry não são bloqueadas: elas autenticam contra seu provedor de nuvem em vez de Anthropic | `claudeai` |281| `forceLoginMethod` | Use `claudeai` para restringir login a contas Claude.ai, `console` para restringir login a contas Claude Console, ou `gateway` para restringir login a um gateway de nuvem; veja [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway). Quando definido em qualquer valor em configurações gerenciadas, sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` são bloqueadas na inicialização, já que uma credencial de ambiente não pode satisfazer o método de login necessário. Sessões de provedor de terceiros como Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry não são bloqueadas: elas autenticam contra seu provedor de nuvem em vez de Anthropic | `claudeai` |

282| `forceLoginGatewayUrl` | Pré-preenche e bloqueia a URL do gateway na tela `/login` Cloud gateway. Ou esta chave ou `forceLoginMethod: "gateway"` superficializa essa tela; defina ambas para que a URL seja preenchida. Honrado apenas no nível de política gerenciada; ignorado em configurações de usuário e projeto. Veja [gateway de aplicativos Claude](/pt/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |282| `forceLoginGatewayUrl` | Pré-preenche e bloqueia a URL do gateway na tela `/login` Cloud gateway. Ou esta chave ou `forceLoginMethod: "gateway"` superficializa essa tela; defina ambas para que a URL seja preenchida. Honrado apenas no nível de política gerenciada; ignorado em configurações de usuário e projeto. Veja [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |

283| `forceLoginOrgUUID` | Exigir que o login pertença a uma organização Anthropic específica. Aceita uma string UUID única, que também pré-seleciona essa organização durante o login, ou um array de UUIDs onde qualquer organização listada é aceita sem pré-seleção. Quando definido em configurações gerenciadas, o login falha se a conta autenticada não pertencer a uma organização listada, e sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` são bloqueadas na inicialização já que a associação à organização não pode ser verificada para elas. Sessões de provedor de terceiros como Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry não são bloqueadas: use seu IAM de nuvem para restringir quais contas de nuvem podem ser usadas. Um array vazio falha fechado e bloqueia o login com uma mensagem de configuração incorreta | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` ou `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |283| `forceLoginOrgUUID` | Exigir que o login pertença a uma organização Anthropic específica. Aceita uma string UUID única, que também pré-seleciona essa organização durante o login, ou um array de UUIDs onde qualquer organização listada é aceita sem pré-seleção. Quando definido em configurações gerenciadas, o login falha se a conta autenticada não pertencer a uma organização listada, e sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` são bloqueadas na inicialização já que a associação à organização não pode ser verificada para elas. Sessões de provedor de terceiros como Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry não são bloqueadas: use seu IAM de nuvem para restringir quais contas de nuvem podem ser usadas. Um array vazio falha fechado e bloqueia o login com uma mensagem de configuração incorreta | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` ou `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |

284| `forceRemoteSettingsRefresh` | (Apenas configurações gerenciadas) Bloquear inicialização da CLI até que configurações gerenciadas remotas sejam buscadas recentemente do servidor. Se a busca falhar, a CLI sai em vez de continuar com configurações em cache ou sem configurações. Quando não definido, a inicialização continua sem esperar por configurações remotas. Veja [aplicação fail-closed](/pt/server-managed-settings#enforce-fail-closed-startup) | `true` |284| `forceRemoteSettingsRefresh` | (Apenas configurações gerenciadas) Bloquear inicialização da CLI até que configurações gerenciadas remotas sejam buscadas recentemente do servidor. Se a busca falhar, a CLI sai em vez de continuar com configurações em cache ou sem configurações. Quando não definido, a inicialização continua sem esperar por configurações remotas. Veja [aplicação fail-closed](/docs/pt/server-managed-settings#enforce-fail-closed-startup) | `true` |

285| `gcpAuthRefresh` | Script personalizado que atualiza as Credenciais Padrão de Aplicação GCP quando expiram ou não podem ser carregadas. Veja [configuração avançada de credenciais](/pt/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |285| `gcpAuthRefresh` | Script personalizado que atualiza as Credenciais Padrão de Aplicação GCP quando expiram ou não podem ser carregadas. Veja [configuração avançada de credenciais](/docs/pt/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |

286| `hooks` | Configure comandos personalizados para executar em eventos do ciclo de vida. Veja [documentação de hooks](/pt/hooks) para formato | Veja [hooks](/pt/hooks) |286| `hooks` | Configure comandos personalizados para executar em eventos do ciclo de vida. Veja [documentação de hooks](/docs/pt/hooks) para formato | Veja [hooks](/docs/pt/hooks) |

287| `httpHookAllowedEnvVars` | Lista de permissões de nomes de variáveis de ambiente que hooks HTTP podem interpolar em cabeçalhos. Quando definido, o `allowedEnvVars` efetivo de cada hook é a interseção com esta lista. Indefinido = sem restrição. Arrays se mesclam entre fontes de configuração. Veja [Configuração de hooks](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |287| `httpHookAllowedEnvVars` | Lista de permissões de nomes de variáveis de ambiente que hooks HTTP podem interpolar em cabeçalhos. Quando definido, o `allowedEnvVars` efetivo de cada hook é a interseção com esta lista. Indefinido = sem restrição. Arrays se mesclam entre fontes de configuração. Veja [Configuração de hooks](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |

288| `includeGitInstructions` | **Padrão**: `true`. Incluir instruções de workflow de commit e PR integradas e o snapshot de status git no prompt do sistema do Claude. Defina como `false` para remover ambos, por exemplo ao usar suas próprias skills de workflow git. A variável de ambiente `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` tem precedência sobre esta configuração quando definida | `false` |288| `includeGitInstructions` | **Padrão**: `true`. Incluir instruções de workflow de commit e PR integradas e o snapshot de status git no prompt do sistema do Claude. Defina como `false` para remover ambos, por exemplo ao usar suas próprias skills de workflow git. A variável de ambiente `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` tem precedência sobre esta configuração quando definida | `false` |

289| `inputNeededNotifEnabled` | {/* min-version: 2.1.119 */}**Padrão**: `false`. Quando [Controle Remoto](/pt/remote-control) está conectado, enviar uma notificação push para seu telefone quando um prompt de permissão ou pergunta está aguardando sua entrada. Aparece em `/config` como **Push when actions required**. Veja [Notificações push móveis](/pt/remote-control#mobile-push-notifications). Requer Claude Code v2.1.119 ou posterior | `true` |289| `inputNeededNotifEnabled` | **Padrão**: `false`. Quando [Controle Remoto](/docs/pt/remote-control) está conectado, enviar uma notificação push para seu telefone quando um prompt de permissão ou pergunta está aguardando sua entrada. Aparece em `/config` como **Push when actions required**. Veja [Notificações push móveis](/docs/pt/remote-control#mobile-push-notifications). Requer Claude Code v2.1.119 ou posterior | `true` |

290| `language` | Configure o idioma de resposta preferido do Claude (por exemplo, `"japanese"`, `"spanish"`, `"french"`). Claude responderá neste idioma por padrão. Também define o idioma de [ditado por voz](/pt/voice-dictation#change-the-dictation-language) e títulos de sessão gerados automaticamente. {/* min-version: 2.1.176 */}A partir de v2.1.176, quando não definido, títulos de sessão correspondem ao idioma de sua conversa | `"japanese"` |290| `language` | Configure o idioma de resposta preferido do Claude (por exemplo, `"japanese"`, `"spanish"`, `"french"`). Claude responderá neste idioma por padrão. Também define o idioma de [ditado por voz](/docs/pt/voice-dictation#change-the-dictation-language) e títulos de sessão gerados automaticamente. A partir de v2.1.176, quando não definido, títulos de sessão correspondem ao idioma de sua conversa | `"japanese"` |

291| `minimumVersion` | Piso que impede auto-atualizações em background e `claude update` de instalar uma versão abaixo desta. Mudar do canal `"latest"` para `"stable"` via `/config` solicita que você fique na versão atual ou permita o downgrade. Escolher ficar define este valor. Também útil em [configurações gerenciadas](/pt/permissions#managed-settings) para fixar um mínimo em toda a organização. Para um piso duro que bloqueia a inicialização completamente, veja `requiredMinimumVersion` | `"2.1.100"` |291| `minimumVersion` | Piso que impede auto-atualizações em background e `claude update` de instalar uma versão abaixo desta. Mudar do canal `"latest"` para `"stable"` via `/config` solicita que você fique na versão atual ou permita o downgrade. Escolher ficar define este valor. Também útil em [configurações gerenciadas](/docs/pt/permissions#managed-settings) para fixar um mínimo em toda a organização. Para um piso duro que bloqueia a inicialização completamente, veja `requiredMinimumVersion` | `"2.1.100"` |

292| `model` | Substituir o modelo padrão a usar para Claude Code. `--model` e [`ANTHROPIC_MODEL`](/pt/model-config#environment-variables) substituem isto para uma sessão | `"claude-sonnet-5"` |292| `model` | Substituir o modelo padrão a usar para Claude Code. `--model` e [`ANTHROPIC_MODEL`](/docs/pt/model-config#environment-variables) substituem isto para uma sessão | `"claude-sonnet-5"` |

293| `modelOverrides` | Mapear IDs de modelo Anthropic para IDs de modelo específicos do provedor, como ARNs de perfil de inferência Bedrock. Cada entrada do seletor de modelo usa seu valor mapeado ao chamar a API do provedor. Veja [Substituir IDs de modelo por versão](/pt/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |293| `modelOverrides` | Mapear IDs de modelo Anthropic para IDs de modelo específicos do provedor, como ARNs de perfil de inferência Bedrock. Cada entrada do seletor de modelo usa seu valor mapeado ao chamar a API do provedor. Veja [Substituir IDs de modelo por versão](/docs/pt/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

294| `otelHeadersHelper` | Script para gerar cabeçalhos OpenTelemetry dinâmicos. Executa na inicialização e periodicamente. Defina o intervalo de atualização com [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/pt/env-vars). Veja [Cabeçalhos dinâmicos](/pt/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |294| `otelHeadersHelper` | Script para gerar cabeçalhos OpenTelemetry dinâmicos. Executa na inicialização e periodicamente. Defina o intervalo de atualização com [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/pt/env-vars). Veja [Cabeçalhos dinâmicos](/docs/pt/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |

295| `outputStyle` | Configure um estilo de saída para ajustar o prompt do sistema. Veja [documentação de estilos de saída](/pt/output-styles) | `"Explanatory"` |295| `outputStyle` | Configure um estilo de saída para ajustar o prompt do sistema. Veja [documentação de estilos de saída](/docs/pt/output-styles) | `"Explanatory"` |

296| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Apenas configurações gerenciadas) **Padrão**: `"first-wins"`. Controla se configurações gerenciadas fornecidas programaticamente por um processo host de incorporação, como o Agent SDK ou uma extensão IDE, se aplicam quando um nível gerenciado implantado por administrador também está presente. `"first-wins"`: as configurações fornecidas pelo pai são descartadas e apenas o nível de administrador se aplica. `"merge"`: as configurações fornecidas pelo pai se aplicam sob o nível de administrador, filtradas para que possam apertar a política mas não afrouxá-la. Não tem efeito quando nenhum nível de administrador é implantado. Requer Claude Code v2.1.133 ou posterior | `"merge"` |296| `parentSettingsBehavior` | (Apenas configurações gerenciadas) **Padrão**: `"first-wins"`. Controla se configurações gerenciadas fornecidas programaticamente por um processo host de incorporação, como o Agent SDK ou uma extensão IDE, se aplicam quando um nível gerenciado implantado por administrador também está presente. `"first-wins"`: as configurações fornecidas pelo pai são descartadas e apenas o nível de administrador se aplica. `"merge"`: as configurações fornecidas pelo pai se aplicam sob o nível de administrador, filtradas para que possam apertar a política mas não afrouxá-la. Não tem efeito quando nenhum nível de administrador é implantado. Requer Claude Code v2.1.133 ou posterior | `"merge"` |

297| `permissions` | Veja a tabela abaixo para a estrutura de permissões. | |297| `permissions` | Veja a tabela abaixo para a estrutura de permissões. | |

298| `plansDirectory` | **Padrão**: `~/.claude/plans`. Personalizar onde os arquivos de plano são armazenados. O caminho é relativo à raiz do projeto. | `"./plans"` |298| `plansDirectory` | **Padrão**: `~/.claude/plans`. Personalizar onde os arquivos de plano são armazenados. O caminho é relativo à raiz do projeto. | `"./plans"` |

299| `pluginSuggestionMarketplaces` | (Apenas configurações gerenciadas) Nomes de marketplace cujos plugins podem aparecer como sugestões de instalação contextual. Nenhuma sugestão declarada por marketplace aparece sem esta lista de permissões; a dica integrada de design de frontend de primeira parte não é afetada. Sugestões vêm da declaração `relevance` de cada plugin em sua entrada de marketplace. Um nome só tem efeito quando o marketplace está registrado na máquina e sua fonte registrada também é declarada em configurações gerenciadas, seja como a entrada `extraKnownMarketplaces` para esse nome ou como uma entrada de `strictKnownMarketplaces`. Um marketplace registrado de uma fonte diferente sob um nome na lista de permissões é ignorado. O marketplace oficial é isento do requisito de fonte: permitir seu nome sozinho é suficiente, já que esse nome só pode se registrar da fonte Anthropic oficial. | `["acme-corp-plugins"]` |299| `pluginSuggestionMarketplaces` | (Apenas configurações gerenciadas) Nomes de marketplace cujos plugins podem aparecer como sugestões de instalação contextual. Nenhuma sugestão declarada por marketplace aparece sem esta lista de permissões; a dica integrada de design de frontend de primeira parte não é afetada. Sugestões vêm da declaração `relevance` de cada plugin em sua entrada de marketplace. Um nome só tem efeito quando o marketplace está registrado na máquina e sua fonte registrada também é declarada em configurações gerenciadas, seja como a entrada `extraKnownMarketplaces` para esse nome ou como uma entrada de `strictKnownMarketplaces`. Um marketplace registrado de uma fonte diferente sob um nome na lista de permissões é ignorado. O marketplace oficial é isento do requisito de fonte: permitir seu nome sozinho é suficiente, já que esse nome só pode se registrar da fonte Anthropic oficial. | `["acme-corp-plugins"]` |

300| `pluginTrustMessage` | (Apenas configurações gerenciadas) Mensagem personalizada anexada ao aviso de confiança de plugin mostrado antes da instalação. Use isto para adicionar contexto específico da organização, por exemplo para confirmar que plugins do seu marketplace interno são verificados. | `"All plugins from our marketplace are approved by IT"` |300| `pluginTrustMessage` | (Apenas configurações gerenciadas) Mensagem personalizada anexada ao aviso de confiança de plugin mostrado antes da instalação. Use isto para adicionar contexto específico da organização, por exemplo para confirmar que plugins do seu marketplace interno são verificados. | `"All plugins from our marketplace are approved by IT"` |

301| `policyHelper` | {/* min-version: 2.1.136 */}Executável implantado por administrador que calcula configurações gerenciadas dinamicamente na inicialização. Apenas honrado de MDM ou um arquivo `managed-settings.json` do sistema. Veja [Calcular configurações gerenciadas com um auxiliar de política](#compute-managed-settings-with-a-policy-helper). Requer Claude Code v2.1.136 ou posterior | `{"path": "/usr/local/bin/claude-policy"}` |301| `policyHelper` | Executável implantado por administrador que calcula configurações gerenciadas dinamicamente na inicialização. Apenas honrado de MDM ou um arquivo `managed-settings.json` do sistema. Veja [Calcular configurações gerenciadas com um auxiliar de política](#compute-managed-settings-with-a-policy-helper). Requer Claude Code v2.1.136 ou posterior | `{"path": "/usr/local/bin/claude-policy"}` |

302| `preferredNotifChannel` | **Padrão**: `"auto"`. Método para notificações de conclusão de tarefa e prompt de permissão: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"`, ou `"notifications_disabled"`. `"auto"` envia uma notificação de desktop em iTerm2, Ghostty, e Kitty e não faz nada em outros terminais. Defina `"terminal_bell"` para tocar o caractere de sino em qualquer terminal. Aparece em `/config` como **Notifications**. Veja [Obter um sino de terminal ou notificação](/pt/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |302| `preferredNotifChannel` | **Padrão**: `"auto"`. Método para notificações de conclusão de tarefa e prompt de permissão: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"`, ou `"notifications_disabled"`. `"auto"` envia uma notificação de desktop em iTerm2, Ghostty, e Kitty e não faz nada em outros terminais. Defina `"terminal_bell"` para tocar o caractere de sino em qualquer terminal. Aparece em `/config` como **Notifications**. Veja [Obter um sino de terminal ou notificação](/docs/pt/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

303| `prefersReducedMotion` | Reduzir ou desabilitar animações de UI (spinners, shimmer, efeitos de flash) para acessibilidade | `true` |303| `prefersReducedMotion` | Reduzir ou desabilitar animações de UI (spinners, shimmer, efeitos de flash) para acessibilidade | `true` |

304| `prUrlTemplate` | Modelo de URL para o badge de PR mostrado no rodapé e em resumos de resultado de ferramenta. Substitui `{host}`, `{owner}`, `{repo}`, `{number}`, e `{url}` da URL de PR relatada por `gh`. Use para apontar links de PR para uma ferramenta de revisão de código interna em vez de `github.com`. Não afeta autolinks `#123` na prosa do Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |304| `prUrlTemplate` | Modelo de URL para o badge de PR mostrado no rodapé e em resumos de resultado de ferramenta. Substitui `{host}`, `{owner}`, `{repo}`, `{number}`, e `{url}` da URL de PR relatada por `gh`. Use para apontar links de PR para uma ferramenta de revisão de código interna em vez de `github.com`. Não afeta autolinks `#123` na prosa do Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

305| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}Conectar [Controle Remoto](/pt/remote-control) automaticamente quando cada sessão interativa inicia, em vez de esperar por `/remote-control`. Defina como `true` para sempre auto-conectar, `false` para nunca auto-conectar, ou deixe indefinido para seguir o padrão da sua organização. Aparece em `/config` como **Enable Remote Control for all sessions**. Veja [Ativar Controle Remoto para todas as sessões](/pt/remote-control#enable-remote-control-for-all-sessions) | `false` |305| `remoteControlAtStartup` | Conectar [Controle Remoto](/docs/pt/remote-control) automaticamente quando cada sessão interativa inicia, em vez de esperar por `/remote-control`. Defina como `true` para sempre auto-conectar, `false` para nunca auto-conectar, ou deixe indefinido para seguir o padrão da sua organização. Aparece em `/config` como **Enable Remote Control for all sessions**. Veja [Ativar Controle Remoto para todas as sessões](/docs/pt/remote-control#enable-remote-control-for-all-sessions) | `false` |

306| `requiredMaximumVersion` | Apenas configurações gerenciadas. Versão máxima do Claude Code permitida para iniciar. Se a versão em execução for mais nova, o Claude Code sai na inicialização e instrui o usuário a instalar uma versão aprovada através do método aprovado da organização; `claude install <version>` também pode funcionar. Auto-atualizações em background e `claude update` pulam versões acima do teto, então uma instalação dentro do intervalo permanece dentro do intervalo. `claude update`, `claude install`, e `claude doctor` continuam funcionando acima do teto para que os usuários possam se recuperar. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |306| `requiredMaximumVersion` | Apenas configurações gerenciadas. Versão máxima do Claude Code permitida para iniciar. Se a versão em execução for mais nova, o Claude Code sai na inicialização e instrui o usuário a instalar uma versão aprovada através do método aprovado da organização; `claude install <version>` também pode funcionar. Auto-atualizações em background e `claude update` pulam versões acima do teto, então uma instalação dentro do intervalo permanece dentro do intervalo. `claude update`, `claude install`, e `claude doctor` continuam funcionando acima do teto para que os usuários possam se recuperar. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |

307| `requiredMinimumVersion` | Apenas configurações gerenciadas. Versão mínima do Claude Code necessária para iniciar. Se a versão em execução for mais antiga, o Claude Code sai na inicialização e instrui o usuário a atualizar através do método aprovado da organização. `claude update`, `claude install`, e `claude doctor` continuam funcionando abaixo do piso para que os usuários possam se recuperar. Difere de `minimumVersion`, que impede downgrades mas nunca bloqueia a inicialização. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |307| `requiredMinimumVersion` | Apenas configurações gerenciadas. Versão mínima do Claude Code necessária para iniciar. Se a versão em execução for mais antiga, o Claude Code sai na inicialização e instrui o usuário a atualizar através do método aprovado da organização. `claude update`, `claude install`, e `claude doctor` continuam funcionando abaixo do piso para que os usuários possam se recuperar. Difere de `minimumVersion`, que impede downgrades mas nunca bloqueia a inicialização. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |

308| `respectGitignore` | **Padrão**: `true`. Controlar se o seletor de arquivo `@` respeita padrões `.gitignore`. Quando `true`, arquivos correspondentes a padrões `.gitignore` são excluídos das sugestões | `false` |308| `respectGitignore` | **Padrão**: `true`. Controlar se o seletor de arquivo `@` respeita padrões `.gitignore`. Quando `true`, arquivos correspondentes a padrões `.gitignore` são excluídos das sugestões | `false` |

309| `respondToBashCommands` | {/* min-version: 2.1.186 */}**Padrão**: `true`. Se Claude responde após um comando shell `!` da caixa de entrada ser executado. Defina como `false` para adicionar a saída do comando ao contexto sem uma resposta. Veja [Modo Shell com prefixo `!`](/pt/interactive-mode#shell-mode-with-prefix). Requer Claude Code v2.1.186 ou posterior | `false` |309| `respondToBashCommands` | **Padrão**: `true`. Se Claude responde após um comando shell `!` da caixa de entrada ser executado. Defina como `false` para adicionar a saída do comando ao contexto sem uma resposta. Veja [Modo Shell com prefixo `!`](/docs/pt/interactive-mode#shell-mode-with-prefix). Requer Claude Code v2.1.186 ou posterior | `false` |

310| `showClearContextOnPlanAccept` | **Padrão**: `false`. Mostrar a opção "limpar contexto" na tela de aceitação do plano. Defina como `true` para restaurar a opção | `true` |310| `showClearContextOnPlanAccept` | **Padrão**: `false`. Mostrar a opção "limpar contexto" na tela de aceitação do plano. Defina como `true` para restaurar a opção | `true` |

311| `showThinkingSummaries` | **Padrão**: `false`. Mostrar resumos de [pensamento estendido](/pt/model-config#extended-thinking) em sessões interativas. Quando indefinido ou `false`, blocos de pensamento são redatados pela API e mostrados como um stub recolhido. A redação apenas muda o que você vê, não o que o modelo gera: para reduzir gastos de pensamento, [reduza o orçamento ou desabilite o pensamento](/pt/model-config#extended-thinking) em vez disso. Esta configuração não tem efeito em modo não interativo (`-p`), no Agent SDK, ou em extensões IDE como VS Code | `true` |311| `showThinkingSummaries` | **Padrão**: `false`. Mostrar resumos de [pensamento estendido](/docs/pt/model-config#extended-thinking) em sessões interativas. Quando indefinido ou `false`, blocos de pensamento são redatados pela API e mostrados como um stub recolhido. A redação apenas muda o que você vê, não o que o modelo gera: para reduzir gastos de pensamento, [reduza o orçamento ou desabilite o pensamento](/docs/pt/model-config#extended-thinking) em vez disso. Esta configuração não tem efeito em modo não interativo (`-p`), no Agent SDK, ou em extensões IDE como VS Code | `true` |

312| `showTurnDuration` | **Padrão**: `true`. Mostrar mensagens de duração de turno após respostas, por exemplo "Cooked for 1m 6s". Aparece em `/config` como **Show turn duration** | `false` |312| `showTurnDuration` | **Padrão**: `true`. Mostrar mensagens de duração de turno após respostas, por exemplo "Cooked for 1m 6s". Aparece em `/config` como **Show turn duration** | `false` |

313| `skillListingBudgetFraction` | **Padrão**: `0.01`. Fração da janela de contexto do modelo reservada para a [listagem de skills](/pt/skills#skill-descriptions-are-cut-short) que Claude vê a cada turno, então o padrão reserva 1%. Quando a listagem excede o orçamento, descrições para as skills menos usadas são recolhidas para nomes simples para que Claude ainda possa invocá-las mas não verá por quê. Aumente para manter mais descrições visíveis ao custo de mais contexto por turno. `/doctor` estima o custo da listagem contra o orçamento | `0.02` |313| `skillListingBudgetFraction` | **Padrão**: `0.01`. Fração da janela de contexto do modelo reservada para a [listagem de skills](/docs/pt/skills#skill-descriptions-are-cut-short) que Claude vê a cada turno, então o padrão reserva 1%. Quando a listagem excede o orçamento, descrições para as skills menos usadas são recolhidas para nomes simples para que Claude ainda possa invocá-las mas não verá por quê. Aumente para manter mais descrições visíveis ao custo de mais contexto por turno. `/doctor` estima o custo da listagem contra o orçamento | `0.02` |

314| `skillListingMaxDescChars` | **Padrão**: `1536`. Limite de caracteres por skill no texto combinado `description` e `when_to_use` na [listagem de skills](/pt/skills#skill-descriptions-are-cut-short) que Claude vê a cada turno. Texto mais longo que isto é truncado. Aumente para manter descrições longas intactas ao custo de mais contexto por turno; diminua para caber mais skills sob [`skillListingBudgetFraction`](#available-settings) | `2048` |314| `skillListingMaxDescChars` | **Padrão**: `1536`. Limite de caracteres por skill no texto combinado `description` e `when_to_use` na [listagem de skills](/docs/pt/skills#skill-descriptions-are-cut-short) que Claude vê a cada turno. Texto mais longo que isto é truncado. Aumente para manter descrições longas intactas ao custo de mais contexto por turno; diminua para caber mais skills sob [`skillListingBudgetFraction`](#available-settings) | `2048` |

315| `skillOverrides` | {/* min-version: 2.1.129 */}Substituições de visibilidade por skill com chave de nome de skill. O valor é `"on"`, `"name-only"`, `"user-invocable-only"`, ou `"off"`. Permite ocultar ou recolher uma skill sem editar seu SKILL.md. Não se aplica a skills de plugin, que são gerenciadas através de `/plugin`. O menu `/skills` escreve estes em `.claude/settings.local.json`. Veja [Substituir visibilidade de skill a partir de configurações](/pt/skills#override-skill-visibility-from-settings). Requer Claude Code v2.1.129 ou posterior | `{"legacy-context": "name-only", "deploy": "off"}` |315| `skillOverrides` | Substituições de visibilidade por skill com chave de nome de skill. O valor é `"on"`, `"name-only"`, `"user-invocable-only"`, ou `"off"`. Permite ocultar ou recolher uma skill sem editar seu SKILL.md. Não se aplica a skills de plugin, que são gerenciadas através de `/plugin`. O menu `/skills` escreve estes em `.claude/settings.local.json`. Veja [Substituir visibilidade de skill a partir de configurações](/docs/pt/skills#override-skill-visibility-from-settings). Requer Claude Code v2.1.129 ou posterior | `{"legacy-context": "name-only", "deploy": "off"}` |

316| `skipWebFetchPreflight` | Pular a [verificação de segurança de domínio WebFetch](/pt/data-usage#webfetch-domain-safety-check) que envia cada nome de host solicitado para `api.anthropic.com` antes de buscar. Defina como `true` em ambientes que bloqueiam tráfego para Anthropic, como implantações Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry com egresso restritivo. Quando pulado, WebFetch tenta qualquer URL sem consultar a lista de bloqueio | `true` |316| `skipWebFetchPreflight` | Pular a [verificação de segurança de domínio WebFetch](/docs/pt/data-usage#webfetch-domain-safety-check) que envia cada nome de host solicitado para `api.anthropic.com` antes de buscar. Defina como `true` em ambientes que bloqueiam tráfego para Anthropic, como implantações Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry com egresso restritivo. Quando pulado, WebFetch tenta qualquer URL sem consultar a lista de bloqueio | `true` |

317| `spinnerTipsEnabled` | **Padrão**: `true`. Mostrar dicas no spinner enquanto Claude está trabalhando. Defina como `false` para desabilitar dicas | `false` |317| `spinnerTipsEnabled` | **Padrão**: `true`. Mostrar dicas no spinner enquanto Claude está trabalhando. Defina como `false` para desabilitar dicas | `false` |

318| `spinnerTipsOverride` | Substituir dicas do spinner com strings personalizadas. `tips`: array de strings de dica. `excludeDefault`: se `true`, mostrar apenas dicas personalizadas; se `false` ou ausente, dicas personalizadas são mescladas com dicas integradas | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |318| `spinnerTipsOverride` | Substituir dicas do spinner com strings personalizadas. `tips`: array de strings de dica. `excludeDefault`: se `true`, mostrar apenas dicas personalizadas; se `false` ou ausente, dicas personalizadas são mescladas com dicas integradas | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

319| `spinnerVerbs` | Personalizar os verbos de ação mostrados enquanto um turno está em progresso. Defina `mode` como `"replace"` para usar apenas seus verbos, ou `"append"` para adicioná-los aos padrões | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |319| `spinnerVerbs` | Personalizar os verbos de ação mostrados enquanto um turno está em progresso. Defina `mode` como `"replace"` para usar apenas seus verbos, ou `"append"` para adicioná-los aos padrões | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |

320| `sshConfigs` | Conexões SSH para mostrar no dropdown de ambiente [Desktop](/pt/desktop#pre-configure-ssh-connections-for-your-team). Cada entrada requer `id`, `name`, e `sshHost`; `sshPort`, `sshIdentityFile`, e `startDirectory` são opcionais. Quando definido em configurações gerenciadas, conexões são somente leitura para usuários. Lido apenas de configurações gerenciadas e de usuário | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |320| `sshConfigs` | Conexões SSH para mostrar no dropdown de ambiente [Desktop](/docs/pt/desktop#pre-configure-ssh-connections-for-your-team). Cada entrada requer `id`, `name`, e `sshHost`; `sshPort`, `sshIdentityFile`, e `startDirectory` são opcionais. Quando definido em configurações gerenciadas, conexões são somente leitura para usuários. Lido apenas de configurações gerenciadas e de usuário | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |

321| `statusLine` | Configure uma linha de status personalizada para exibir contexto. O objeto opcional tem campos `padding`, `refreshInterval`, e `hideVimModeIndicator` que controlam espaçamento, re-execuções periódicas, e se o indicador de modo vim integrado abaixo do prompt está oculto. Veja [documentação de `statusLine`](/pt/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |321| `statusLine` | Configure uma linha de status personalizada para exibir contexto. O objeto opcional tem campos `padding`, `refreshInterval`, e `hideVimModeIndicator` que controlam espaçamento, re-execuções periódicas, e se o indicador de modo vim integrado abaixo do prompt está oculto. Veja [documentação de `statusLine`](/docs/pt/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |

322| `strictKnownMarketplaces` | (Apenas configurações gerenciadas) Lista de permissões de marketplaces de plugin. Indefinido = sem restrições, array vazio = bloqueio. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |322| `strictKnownMarketplaces` | (Apenas configurações gerenciadas) Lista de permissões de marketplaces de plugin. Indefinido = sem restrições, array vazio = bloqueio. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Veja [Restrições de marketplace gerenciado](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

323| `strictPluginOnlyCustomization` | (Apenas configurações gerenciadas) Bloquear skills, agents, hooks, e MCP servers de fontes de usuário e projeto, para que possam vir apenas de plugins ou configurações gerenciadas. `true` bloqueia todas as quatro superfícies; um array bloqueia apenas as nomeadas. Veja [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |323| `strictPluginOnlyCustomization` | (Apenas configurações gerenciadas) Bloquear skills, agents, hooks, e MCP servers de fontes de usuário e projeto, para que possam vir apenas de plugins ou configurações gerenciadas. `true` bloqueia todas as quatro superfícies; um array bloqueia apenas as nomeadas. Veja [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

324| `syntaxHighlightingDisabled` | Desabilitar destaque de sintaxe em diffs, blocos de código e visualizações de arquivo | `true` |324| `syntaxHighlightingDisabled` | Desabilitar destaque de sintaxe em diffs, blocos de código e visualizações de arquivo | `true` |

325| `teammateMode` | **Padrão**: `in-process`. Como [colegas de equipe de agente](/pt/agent-teams) são exibidos: `in-process`, `auto` (painéis divididos ao executar dentro de tmux ou iTerm2 com `it2` em seu `PATH`; em processo caso contrário), `tmux` (painéis divididos usando tmux ou iTerm2, detectado do seu terminal), ou {/* min-version: 2.1.186 */}}`iterm2` (painéis divididos nativos do iTerm2 via CLI `it2`, adicionado em v2.1.186). O padrão mudou de `auto` em v2.1.179. `--teammate-mode` substitui isto para uma sessão. Veja [escolher um modo de exibição](/pt/agent-teams#choose-a-display-mode) | `"auto"` |325| `teammateMode` | **Padrão**: `in-process`. Como [colegas de equipe de agente](/docs/pt/agent-teams) são exibidos: `in-process`, `auto` (painéis divididos ao executar dentro de tmux ou iTerm2 com `it2` em seu `PATH`; em processo caso contrário), `tmux` (painéis divididos usando tmux ou iTerm2, detectado do seu terminal), ou }`iterm2` (painéis divididos nativos do iTerm2 via CLI `it2`, adicionado em v2.1.186). O padrão mudou de `auto` em v2.1.179. `--teammate-mode` substitui isto para uma sessão. Veja [escolher um modo de exibição](/docs/pt/agent-teams#choose-a-display-mode) | `"auto"` |

326| `terminalProgressBarEnabled` | **Padrão**: `true`. Mostrar a barra de progresso do terminal em terminais suportados: ConEmu, Ghostty 1.2.0+, e iTerm2 3.6.6+. Aparece em `/config` como **Terminal progress bar** | `false` |326| `terminalProgressBarEnabled` | **Padrão**: `true`. Mostrar a barra de progresso do terminal em terminais suportados: ConEmu, Ghostty 1.2.0+, e iTerm2 3.6.6+. Aparece em `/config` como **Terminal progress bar** | `false` |

327| `theme` | {/* min-version: 2.1.119 */}**Padrão**: `"dark"`. Tema de cor para a interface: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, ou uma referência de tema personalizado como `"custom:<slug>"` ou `"custom:<plugin-name>:<slug>"`. Veja [Criar um tema personalizado](/pt/terminal-config#create-a-custom-theme). Aparece em `/config` como **Theme** | `"dark"` |327| `theme` | **Padrão**: `"dark"`. Tema de cor para a interface: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, ou uma referência de tema personalizado como `"custom:<slug>"` ou `"custom:<plugin-name>:<slug>"`. Veja [Criar um tema personalizado](/docs/pt/terminal-config#create-a-custom-theme). Aparece em `/config` como **Theme** | `"dark"` |

328| `tui` | Renderizador de UI de terminal. Use `"fullscreen"` para o renderizador [alt-screen](/pt/fullscreen) sem cintilação com scrollback virtualizado. Use `"default"` para o renderizador clássico de tela principal. Defina via `/tui`. Você também pode definir a variável de ambiente [`CLAUDE_CODE_NO_FLICKER`](/pt/env-vars). Sessões em background abertas de [visualização de agente](/pt/agent-view) sempre usam o renderizador fullscreen independentemente desta configuração | `"fullscreen"` |328| `tui` | Renderizador de UI de terminal. Use `"fullscreen"` para o renderizador [alt-screen](/docs/pt/fullscreen) sem cintilação com scrollback virtualizado. Use `"default"` para o renderizador clássico de tela principal. Defina via `/tui`. Você também pode definir a variável de ambiente [`CLAUDE_CODE_NO_FLICKER`](/docs/pt/env-vars). Sessões em background abertas de [visualização de agente](/docs/pt/agent-view) sempre usam o renderizador fullscreen independentemente desta configuração | `"fullscreen"` |

329| `ultracode` | Ativar [ultracode](/pt/workflows#let-claude-decide-with-ultracode) para a sessão atual. Esta chave não é lida de `settings.json`. Defina através de `/effort ultracode`, `--settings`, ou uma solicitação de controle do Agent SDK. {/* min-version: 2.1.203 */}Para iniciar uma sessão com ultracode já ligado, lance com `claude --effort ultracode`, que requer Claude Code v2.1.203 ou posterior | `true` |329| `ultracode` | Ativar [ultracode](/docs/pt/workflows#let-claude-decide-with-ultracode) para a sessão atual. Esta chave não é lida de `settings.json`. Defina através de `/effort ultracode`, `--settings`, ou uma solicitação de controle do Agent SDK. Para iniciar uma sessão com ultracode já ligado, lance com `claude --effort ultracode`, que requer Claude Code v2.1.203 ou posterior | `true` |

330| `useAutoModeDuringPlan` | **Padrão**: `true`. Se Plan Mode usa semântica de modo automático quando o modo automático está disponível. Não lido de configurações de projeto compartilhadas. Aparece em `/config` como "Use auto mode during plan" | `false` |330| `useAutoModeDuringPlan` | **Padrão**: `true`. Se Plan Mode usa semântica de modo automático quando o modo automático está disponível. Não lido de configurações de projeto compartilhadas. Aparece em `/config` como "Use auto mode during plan" | `false` |

331| `verbose` | {/* min-version: 2.1.119 */}**Padrão**: `false`. Mostrar saída completa de ferramenta em vez de resumos truncados. Aparece em `/config` como **Verbose output**. A flag `--verbose` substitui isto para uma sessão | `true` |331| `verbose` | **Padrão**: `false`. Mostrar saída completa de ferramenta em vez de resumos truncados. Aparece em `/config` como **Verbose output**. A flag `--verbose` substitui isto para uma sessão | `true` |

332| `viewMode` | Modo de visualização de transcrição padrão na inicialização: `"default"`, `"verbose"`, ou `"focus"`. Substitui a seleção pegajosa `/focus` quando definido. A flag `--verbose` substitui isto para uma sessão | `"verbose"` |332| `viewMode` | Modo de visualização de transcrição padrão na inicialização: `"default"`, `"verbose"`, ou `"focus"`. Substitui a seleção pegajosa `/focus` quando definido. A flag `--verbose` substitui isto para uma sessão | `"verbose"` |

333| `vimInsertModeRemaps` | {/* min-version: 2.1.208 */}Mapear sequências INSERT-mode de duas teclas para Escape em [modo editor vim](/pt/interactive-mode#vim-editor-mode). Cada chave é exatamente dois caracteres imprimíveis digitados em sequência, e `"<Esc>"` é o único alvo suportado; outras entradas são ignoradas. Lido apenas de configurações de usuário, flag `--settings`, e configurações gerenciadas, para que as configurações verificadas de um repositório não possam remapear seus pressionamentos de tecla. Não tem efeito a menos que `editorMode` seja `"vim"`. Veja [Remapear sequências de tecla INSERT-mode](/pt/interactive-mode#remap-insert-mode-key-sequences). Requer Claude Code v2.1.208 ou posterior | `{"jj": "<Esc>"}` |333| `vimInsertModeRemaps` | Mapear sequências INSERT-mode de duas teclas para Escape em [modo editor vim](/docs/pt/interactive-mode#vim-editor-mode). Cada chave é exatamente dois caracteres imprimíveis digitados em sequência, e `"<Esc>"` é o único alvo suportado; outras entradas são ignoradas. Lido apenas de configurações de usuário, flag `--settings`, e configurações gerenciadas, para que as configurações verificadas de um repositório não possam remapear seus pressionamentos de tecla. Não tem efeito a menos que `editorMode` seja `"vim"`. Veja [Remapear sequências de tecla INSERT-mode](/docs/pt/interactive-mode#remap-insert-mode-key-sequences). Requer Claude Code v2.1.208 ou posterior | `{"jj": "<Esc>"}` |

334| `voice` | Configurações de [ditado por voz](/pt/voice-dictation): `enabled` ativa ditado, `mode` seleciona `"hold"` ou `"tap"`, e `autoSubmit` envia o prompt ao soltar a tecla em modo hold. Escrito automaticamente quando você executa `/voice`. Requer uma conta Claude.ai | `{ "enabled": true, "mode": "tap" }` |334| `voice` | Configurações de [ditado por voz](/docs/pt/voice-dictation): `enabled` ativa ditado, `mode` seleciona `"hold"` ou `"tap"`, e `autoSubmit` envia o prompt ao soltar a tecla em modo hold. Escrito automaticamente quando você executa `/voice`. Requer uma conta Claude.ai | `{ "enabled": true, "mode": "tap" }` |

335| `voiceEnabled` | Alias legado para `voice.enabled`. Prefira o objeto `voice` | `true` |335| `voiceEnabled` | Alias legado para `voice.enabled`. Prefira o objeto `voice` | `true` |

336| `wheelScrollAccelerationEnabled` | {/* min-version: 2.1.174 */}**Padrão**: `true`. Em [renderização fullscreen](/pt/fullscreen#mouse-wheel-scrolling), acelerar velocidade de scroll de roda do mouse durante scrolls rápidos. Defina como `false` para uma taxa de scroll constante por entalhe de roda. Requer Claude Code v2.1.174 ou posterior | `false` |336| `wheelScrollAccelerationEnabled` | **Padrão**: `true`. Em [renderização fullscreen](/docs/pt/fullscreen#mouse-wheel-scrolling), acelerar velocidade de scroll de roda do mouse durante scrolls rápidos. Defina como `false` para uma taxa de scroll constante por entalhe de roda. Requer Claude Code v2.1.174 ou posterior | `false` |

337| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}**Padrão**: `true`. Se a palavra-chave `ultracode` em um prompt dispara um [workflow dinâmico](/pt/workflows#ask-for-a-workflow-in-your-prompt). Defina como `false` para digitar a palavra sem disparar um. A configuração de esforço ultracode, `/workflows`, e comandos de workflow salvos não são afetados. Aparece em `/config` como **Ultracode keyword trigger**. Adicionado em v2.1.157; antes de v2.1.160 a palavra-chave de disparo era `workflow` | `false` |337| `workflowKeywordTriggerEnabled` | **Padrão**: `true`. Se a palavra-chave `ultracode` em um prompt dispara um [workflow dinâmico](/docs/pt/workflows#ask-for-a-workflow-in-your-prompt). Defina como `false` para digitar a palavra sem disparar um. A configuração de esforço ultracode, `/workflows`, e comandos de workflow salvos não são afetados. Aparece em `/config` como **Ultracode keyword trigger**. Adicionado em v2.1.157; antes de v2.1.160 a palavra-chave de disparo era `workflow` | `false` |

338| `wslInheritsWindowsSettings` | (Apenas configurações gerenciadas do Windows) Quando `true`, Claude Code no WSL lê configurações gerenciadas da cadeia de política do Windows além de `/etc/claude-code`, com fontes do Windows tendo prioridade. Apenas honrado quando definido na chave de registro HKLM ou `C:\Program Files\ClaudeCode\managed-settings.json`, ambos exigindo admin do Windows para escrever. Para que a política HKCU também se aplique no WSL, a flag deve ser adicionalmente definida no HKCU em si. Não tem efeito no Windows nativo | `true` |338| `wslInheritsWindowsSettings` | (Apenas configurações gerenciadas do Windows) Quando `true`, Claude Code no WSL lê configurações gerenciadas da cadeia de política do Windows além de `/etc/claude-code`, com fontes do Windows tendo prioridade. Apenas honrado quando definido na chave de registro HKLM ou `C:\Program Files\ClaudeCode\managed-settings.json`, ambos exigindo admin do Windows para escrever. Para que a política HKCU também se aplique no WSL, a flag deve ser adicionalmente definida no HKCU em si. Não tem efeito no Windows nativo | `true` |

339 339 

340<h3 id="global-config-settings">340<h3 id="global-config-settings">


348</Note>348</Note>

349 349 

350| Chave | Descrição | Exemplo |350| Chave | Descrição | Exemplo |

351| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------- |351| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

352| `autoConnectIde` | **Padrão**: `false`. Conectar automaticamente a um IDE em execução quando Claude Code inicia de um terminal externo. Aparece em `/config` como **Auto-connect to IDE (external terminal)** ao executar fora de um terminal VS Code ou JetBrains. A variável de ambiente [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/pt/env-vars) substitui isto quando definida | `true` |352| `autoConnectIde` | **Padrão**: `false`. Conectar automaticamente a um IDE em execução quando Claude Code inicia de um terminal externo. Aparece em `/config` como **Auto-connect to IDE (external terminal)** ao executar fora de um terminal VS Code ou JetBrains. A variável de ambiente [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/docs/pt/env-vars) substitui isto quando definida | `true` |

353| `autoInstallIdeExtension` | **Padrão**: `true`. Instalar automaticamente a extensão IDE do Claude Code ao executar de um terminal VS Code. Aparece em `/config` como **Auto-install IDE extension** ao executar dentro de um terminal VS Code ou JetBrains. Você também pode definir a variável de ambiente [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/pt/env-vars) para `1` | `false` |353| `autoInstallIdeExtension` | **Padrão**: `true`. Instalar automaticamente a extensão IDE do Claude Code ao executar de um terminal VS Code. Aparece em `/config` como **Auto-install IDE extension** ao executar dentro de um terminal VS Code ou JetBrains. Você também pode definir a variável de ambiente [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/pt/env-vars) para `1` | `false` |

354| `externalEditorContext` | **Padrão**: `false`. Prepend a resposta anterior do Claude como contexto comentado com `#` quando você abre o editor externo com `Ctrl+G`. Aparece em `/config` como **Show last response in external editor** | `true` |354| `externalEditorContext` | **Padrão**: `false`. Prepend a resposta anterior do Claude como contexto comentado com `#` quando você abre o editor externo com `Ctrl+G`. Aparece em `/config` como **Show last response in external editor** | `true` |

355| `permissionExplainerEnabled` | **Padrão**: `true`. Mostrar uma [explicação gerada por modelo do comando](/pt/permissions#permission-system) quando você pressiona `Ctrl+E` em um prompt de permissão Bash ou PowerShell. Defina como `false` para desligar o atalho | `false` |355| `permissionExplainerEnabled` | **Padrão**: `true`. Mostrar uma [explicação gerada por modelo do comando](/docs/pt/permissions#permission-system) quando você pressiona `Ctrl+E` em um prompt de permissão Bash ou PowerShell. Defina como `false` para desligar o atalho | `false` |

356| `teammateDefaultModel` | Modelo padrão para [colegas de equipe de agente](/pt/agent-teams) quando o prompt de spawn não especifica um. Defina como um alias de modelo como `"sonnet"`, ou `null` para herdar a seleção `/model` atual do líder. Aparece em `/config` como **Default teammate model** | `"sonnet"` |356| `teammateDefaultModel` | Modelo padrão para [colegas de equipe de agente](/docs/pt/agent-teams) quando o prompt de spawn não especifica um. Defina como um alias de modelo como `"sonnet"`, ou `null` para herdar a seleção `/model` atual do líder. Aparece em `/config` como **Default teammate model** | `"sonnet"` |

357| `workflowSizeGuideline` | {/* min-version: 2.1.202 */}**Padrão**: `unrestricted`, que não envia nenhuma diretriz. Define a [contagem de agente que Claude visa](/pt/workflows#set-a-size-guideline) nos workflows dinâmicos que escreve. Claude Code envia o valor para Claude como conselho, não um limite aplicado. Aceita `unrestricted`, `small`, `medium`, ou `large`. Aparece em `/config` como **Dynamic workflow size**. Você também pode defini-lo diretamente com `/config workflowSizeGuideline=small`. Requer Claude Code v2.1.202 ou posterior. {/* min-version: 2.1.203 */}A diretriz de contagem de agente também substitui o limite padrão para o [aviso `Large workflow`](/pt/workflows#cost); esse comportamento requer Claude Code v2.1.203 ou posterior | `"small"` |357| `workflowSizeGuideline` | **Padrão**: `unrestricted`, que não envia nenhuma diretriz. Define a [contagem de agente que Claude visa](/docs/pt/workflows#set-a-size-guideline) nos workflows dinâmicos que escreve. Claude Code envia o valor para Claude como conselho, não um limite aplicado. Aceita `unrestricted`, `small`, `medium`, ou `large`. Aparece em `/config` como **Dynamic workflow size**. Você também pode defini-lo diretamente com `/config workflowSizeGuideline=small`. Requer Claude Code v2.1.202 ou posterior. A diretriz de contagem de agente também substitui o limite padrão para o [aviso `Large workflow`](/docs/pt/workflows#cost); esse comportamento requer Claude Code v2.1.203 ou posterior | `"small"` |

358 358 

359<h3 id="worktree-settings">359<h3 id="worktree-settings">

360 Configurações de worktrees360 Configurações de worktrees


363Configure como `--worktree` cria e gerencia git worktrees.363Configure como `--worktree` cria e gerencia git worktrees.

364 364 

365| Chave | Descrição | Exemplo |365| Chave | Descrição | Exemplo |

366| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |366| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------ |

367| `worktree.baseRef` | Qual ref novos worktrees ramificam. `"fresh"` (padrão) ramifica de `origin/<default-branch>` para uma árvore limpa correspondendo ao remoto. `"head"` ramifica de seu `HEAD` local atual, então commits não enviados e estado de branch de feature estão presentes no worktree. Dentro de um worktree vinculado, `"head"` resolve para o `HEAD` desse worktree, não o da checkout principal. Se aplica a `--worktree`, a ferramenta `EnterWorktree`, e isolamento de subagent | `"head"` |367| `worktree.baseRef` | Qual ref novos worktrees ramificam. `"fresh"` (padrão) ramifica de `origin/<default-branch>` para uma árvore limpa correspondendo ao remoto. `"head"` ramifica de seu `HEAD` local atual, então commits não enviados e estado de branch de feature estão presentes no worktree. Dentro de um worktree vinculado, `"head"` resolve para o `HEAD` desse worktree, não o da checkout principal. Se aplica a `--worktree`, a ferramenta `EnterWorktree`, e isolamento de subagent | `"head"` |

368| `worktree.symlinkDirectories` | Diretórios para criar symlink do repositório principal em cada worktree para evitar duplicar grandes diretórios no disco. Nenhum diretório é criado symlink por padrão | `["node_modules", ".cache"]` |368| `worktree.symlinkDirectories` | Diretórios para criar symlink do repositório principal em cada worktree para evitar duplicar grandes diretórios no disco. Nenhum diretório é criado symlink por padrão | `["node_modules", ".cache"]` |

369| `worktree.sparsePaths` | Diretórios para fazer checkout em cada worktree via git sparse-checkout. Apenas os caminhos listados mais arquivos de nível raiz são escritos no disco, o que é mais rápido em grandes monorepos. Enquanto um worktree esparso existe, git ativa `extensions.worktreeConfig` no `.git/config` compartilhado do repositório; veja [Fazer checkout apenas dos diretórios que você precisa](/pt/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |369| `worktree.sparsePaths` | Diretórios para fazer checkout em cada worktree via git sparse-checkout. Apenas os caminhos listados mais arquivos de nível raiz são escritos no disco, o que é mais rápido em grandes monorepos. Enquanto um worktree esparso existe, git ativa `extensions.worktreeConfig` no `.git/config` compartilhado do repositório; veja [Fazer checkout apenas dos diretórios que você precisa](/docs/pt/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |

370| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Modo de isolamento para [sessões em background](/pt/agent-view#how-file-edits-are-isolated). `"worktree"` (padrão) bloqueia `Edit`/`Write` no checkout principal até que `EnterWorktree` seja chamado. {/* min-version: 2.1.203 */}Fora de um repositório git, um [hook `WorktreeCreate`](/pt/worktrees#non-git-version-control) que falha libera o bloqueio para que a sessão possa editar o diretório de trabalho no local; requer Claude Code v2.1.203 ou posterior. `"none"` permite que trabalhos em background editem a cópia de trabalho diretamente. Requer Claude Code v2.1.143 ou posterior | `"none"` |370| `worktree.bgIsolation` | Modo de isolamento para [sessões em background](/docs/pt/agent-view#how-file-edits-are-isolated). `"worktree"` (padrão) bloqueia `Edit`/`Write` no checkout principal até que `EnterWorktree` seja chamado. Fora de um repositório git, um [hook `WorktreeCreate`](/docs/pt/worktrees#non-git-version-control) que falha libera o bloqueio para que a sessão possa editar o diretório de trabalho no local; requer Claude Code v2.1.203 ou posterior. `"none"` permite que trabalhos em background editem a cópia de trabalho diretamente. Requer Claude Code v2.1.143 ou posterior | `"none"` |

371 371 

372Para copiar arquivos ignorados pelo git como `.env` em novos worktrees, use um arquivo [`.worktreeinclude`](/pt/worktrees#copy-gitignored-files-into-worktrees) na raiz do seu projeto em vez de uma configuração.372Para copiar arquivos ignorados pelo git como `.env` em novos worktrees, use um arquivo [`.worktreeinclude`](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) na raiz do seu projeto em vez de uma configuração.

373 373 

374<h3 id="permission-settings">374<h3 id="permission-settings">

375 Configurações de permissão375 Configurações de permissão

376</h3>376</h3>

377 377 

378| Chaves | Descrição | Exemplo |378| Chaves | Descrição | Exemplo |

379| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |379| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |

380| `allow` | Array de regras de permissão para permitir uso de ferramenta. Nomes de ferramenta globs são suportados apenas na posição de ferramenta após um prefixo literal `mcp__<server>__`, como `mcp__github__get_*`; o segmento de servidor deve estar livre de glob. Veja [Sintaxe de regra de permissão](#permission-rule-syntax) abaixo para detalhes de correspondência de padrão | `[ "Bash(git diff *)" ]` |380| `allow` | Array de regras de permissão para permitir uso de ferramenta. Nomes de ferramenta globs são suportados apenas na posição de ferramenta após um prefixo literal `mcp__<server>__`, como `mcp__github__get_*`; o segmento de servidor deve estar livre de glob. Veja [Sintaxe de regra de permissão](#permission-rule-syntax) abaixo para detalhes de correspondência de padrão | `[ "Bash(git diff *)" ]` |

381| `ask` | Array de regras de permissão para pedir confirmação ao usar ferramenta. Veja [Sintaxe de regra de permissão](#permission-rule-syntax) abaixo | `[ "Bash(git push *)" ]` |381| `ask` | Array de regras de permissão para pedir confirmação ao usar ferramenta. Veja [Sintaxe de regra de permissão](#permission-rule-syntax) abaixo | `[ "Bash(git push *)" ]` |

382| `deny` | Array de regras de permissão para negar uso de ferramenta. Use isto para excluir arquivos sensíveis do acesso do Claude Code. Nomes de ferramenta aceitam padrões glob: `"*"` nega cada ferramenta e `"mcp__*"` nega todas as ferramentas MCP. Veja [Sintaxe de regra de permissão](#permission-rule-syntax) e [Limitações de permissão Bash](/pt/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |382| `deny` | Array de regras de permissão para negar uso de ferramenta. Use isto para excluir arquivos sensíveis do acesso do Claude Code. Nomes de ferramenta aceitam padrões glob: `"*"` nega cada ferramenta e `"mcp__*"` nega todas as ferramentas MCP. Veja [Sintaxe de regra de permissão](#permission-rule-syntax) e [Limitações de permissão Bash](/docs/pt/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

383| `additionalDirectories` | [Diretórios de trabalho](/pt/permissions#working-directories) adicionais para acesso a arquivos. A maioria da configuração `.claude/` [não é descoberta](/pt/permissions#additional-directories-grant-file-access-not-configuration) destes diretórios | `[ "../docs/" ]` |383| `additionalDirectories` | [Diretórios de trabalho](/docs/pt/permissions#working-directories) adicionais para acesso a arquivos. A maioria da configuração `.claude/` [não é descoberta](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) destes diretórios | `[ "../docs/" ]` |

384| `defaultMode` | [Modo de permissão](/pt/permission-modes) padrão ao abrir Claude Code. Valores válidos: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, e {/* min-version: 2.1.200 */}}`manual` como um alias para `default`, o modo rotulado Manual na CLI, nas extensões VS Code e JetBrains, e no aplicativo desktop. O alias `manual` requer Claude Code v2.1.200 ou posterior. {/* min-version: 2.1.142 */}}`auto` é ignorado quando definido em configurações de projeto ou local, para que um repositório não possa se conceder modo automático; defina-o em `~/.claude/settings.json` em vez disso. Antes de v2.1.142, configurações de projeto podiam definir `auto`. A flag CLI `--permission-mode` substitui esta configuração para uma única sessão | `"acceptEdits"` |384| `defaultMode` | [Modo de permissão](/docs/pt/permission-modes) padrão ao abrir Claude Code. Valores válidos: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, e }`manual` como um alias para `default`, o modo rotulado Manual na CLI, nas extensões VS Code e JetBrains, e no aplicativo desktop. O alias `manual` requer Claude Code v2.1.200 ou posterior. }`auto` é ignorado quando definido em configurações de projeto ou local, para que um repositório não possa se conceder modo automático; defina-o em `~/.claude/settings.json` em vez disso. Antes de v2.1.142, configurações de projeto podiam definir `auto`. A flag CLI `--permission-mode` substitui esta configuração para uma única sessão | `"acceptEdits"` |

385| `disableBypassPermissionsMode` | Defina como `"disable"` para impedir que o modo `bypassPermissions` seja ativado. Isto desabilita a flag de linha de comando `--dangerously-skip-permissions`. Tipicamente colocado em [configurações gerenciadas](/pt/permissions#managed-settings) para aplicar política organizacional, mas funciona de qualquer escopo | `"disable"` |385| `disableBypassPermissionsMode` | Defina como `"disable"` para impedir que o modo `bypassPermissions` seja ativado. Isto desabilita a flag de linha de comando `--dangerously-skip-permissions`. Tipicamente colocado em [configurações gerenciadas](/docs/pt/permissions#managed-settings) para aplicar política organizacional, mas funciona de qualquer escopo | `"disable"` |

386| `skipDangerousModePermissionPrompt` | Pular o prompt de confirmação mostrado antes de entrar no modo de permissões de bypass via `--dangerously-skip-permissions` ou `defaultMode: "bypassPermissions"`. Ignorado quando definido em configurações de projeto (`.claude/settings.json`) para evitar que repositórios não confiáveis contornem automaticamente o prompt | `true` |386| `skipDangerousModePermissionPrompt` | Pular o prompt de confirmação mostrado antes de entrar no modo de permissões de bypass via `--dangerously-skip-permissions` ou `defaultMode: "bypassPermissions"`. Ignorado quando definido em configurações de projeto (`.claude/settings.json`) para evitar que repositórios não confiáveis contornem automaticamente o prompt | `true` |

387 387 

388<h3 id="permission-rule-syntax">388<h3 id="permission-rule-syntax">

389 Sintaxe de regra de permissão389 Sintaxe de regra de permissão

390</h3>390</h3>

391 391 

392Regras de permissão seguem o formato `Tool` ou `Tool(specifier)`. Regras são avaliadas em ordem: regras de negação primeiro, depois ask, depois allow. A primeira regra correspondente determina o resultado independentemente da especificidade da regra. Veja a [ordem de avaliação de regra de permissão](/pt/permissions#manage-permissions) para detalhes.392Regras de permissão seguem o formato `Tool` ou `Tool(specifier)`. Regras são avaliadas em ordem: regras de negação primeiro, depois ask, depois allow. A primeira regra correspondente determina o resultado independentemente da especificidade da regra. Veja a [ordem de avaliação de regra de permissão](/docs/pt/permissions#manage-permissions) para detalhes.

393 393 

394Exemplos rápidos:394Exemplos rápidos:

395 395 


400| `Read(./.env)` | Corresponde a leitura do arquivo `.env` |400| `Read(./.env)` | Corresponde a leitura do arquivo `.env` |

401| `WebFetch(domain:example.com)` | Corresponde a solicitações de fetch para example.com |401| `WebFetch(domain:example.com)` | Corresponde a solicitações de fetch para example.com |

402 402 

403Para a referência completa de sintaxe de regra, incluindo comportamento de curinga, padrões específicos de ferramenta para Read, Edit, WebFetch, MCP, e regras de Agent, e limitações de segurança de padrões Bash, veja [Sintaxe de regra de permissão](/pt/permissions#permission-rule-syntax).403Para a referência completa de sintaxe de regra, incluindo comportamento de curinga, padrões específicos de ferramenta para Read, Edit, WebFetch, MCP, e regras de Agent, e limitações de segurança de padrões Bash, veja [Sintaxe de regra de permissão](/docs/pt/permissions#permission-rule-syntax).

404 404 

405<h3 id="sandbox-settings">405<h3 id="sandbox-settings">

406 Configurações de sandbox406 Configurações de sandbox

407</h3>407</h3>

408 408 

409Configure comportamento avançado de sandboxing. Sandboxing isola comandos bash do seu sistema de arquivos e rede. Veja [Sandboxing](/pt/sandboxing) para detalhes.409Configure comportamento avançado de sandboxing. Sandboxing isola comandos bash do seu sistema de arquivos e rede. Veja [Sandboxing](/docs/pt/sandboxing) para detalhes.

410 410 

411| Chaves | Descrição | Exemplo |411| Chaves | Descrição | Exemplo |

412| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |412| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

413| `enabled` | Ativar sandboxing bash (macOS, Linux, e WSL2). Padrão: false | `true` |413| `enabled` | Ativar sandboxing bash (macOS, Linux, e WSL2). Padrão: false | `true` |

414| `failIfUnavailable` | Sair com um erro na inicialização se `sandbox.enabled` é true mas o sandbox não pode iniciar (dependências faltantes ou plataforma não suportada). Quando false (padrão), um aviso é mostrado e comandos executam sem sandbox. Destinado para implantações de configurações gerenciadas que exigem sandboxing como um portão duro | `true` |414| `failIfUnavailable` | Sair com um erro na inicialização se `sandbox.enabled` é true mas o sandbox não pode iniciar (dependências faltantes ou plataforma não suportada). Quando false (padrão), um aviso é mostrado e comandos executam sem sandbox. Destinado para implantações de configurações gerenciadas que exigem sandboxing como um portão duro | `true` |

415| `autoAllowBashIfSandboxed` | Aprovar automaticamente comandos bash quando sandboxed. Padrão: true | `true` |415| `autoAllowBashIfSandboxed` | Aprovar automaticamente comandos bash quando sandboxed. Padrão: true | `true` |


418| `filesystem.allowWrite` | Caminhos adicionais onde comandos sandboxed podem escrever. Arrays são mesclados em todos os escopos de configuração: caminhos de usuário, projeto e gerenciados são combinados, não substituídos. Também mesclado com caminhos de regras de permissão `Edit(...)` allow. Veja [prefixos de caminho de sandbox](#sandbox-path-prefixes) abaixo. | `["/tmp/build", "~/.kube"]` |418| `filesystem.allowWrite` | Caminhos adicionais onde comandos sandboxed podem escrever. Arrays são mesclados em todos os escopos de configuração: caminhos de usuário, projeto e gerenciados são combinados, não substituídos. Também mesclado com caminhos de regras de permissão `Edit(...)` allow. Veja [prefixos de caminho de sandbox](#sandbox-path-prefixes) abaixo. | `["/tmp/build", "~/.kube"]` |

419| `filesystem.denyWrite` | Caminhos onde comandos sandboxed não podem escrever. Arrays são mesclados em todos os escopos de configuração. Também mesclado com caminhos de regras de permissão `Edit(...)` deny. | `["/etc", "/usr/local/bin"]` |419| `filesystem.denyWrite` | Caminhos onde comandos sandboxed não podem escrever. Arrays são mesclados em todos os escopos de configuração. Também mesclado com caminhos de regras de permissão `Edit(...)` deny. | `["/etc", "/usr/local/bin"]` |

420| `filesystem.denyRead` | Caminhos onde comandos sandboxed não podem ler. Arrays são mesclados em todos os escopos de configuração. Também mesclado com caminhos de regras de permissão `Read(...)` deny. | `["~/.aws/credentials"]` |420| `filesystem.denyRead` | Caminhos onde comandos sandboxed não podem ler. Arrays são mesclados em todos os escopos de configuração. Também mesclado com caminhos de regras de permissão `Read(...)` deny. | `["~/.aws/credentials"]` |

421| `filesystem.allowRead` | Caminhos para re-permitir leitura dentro de regiões `denyRead`. Uma entrada `allowRead` reabre leitura dentro de uma região `denyRead` mais ampla, e um caminho exato em `denyRead` permanece bloqueado dentro de uma `allowRead` mais ampla; veja a [tabela de sobreposição](/pt/sandboxing#configure-sandboxing) para exemplos. Arrays são mesclados em todos os escopos de configuração. Use isto para criar padrões de acesso de leitura apenas para workspace. | `["."]` |421| `filesystem.allowRead` | Caminhos para re-permitir leitura dentro de regiões `denyRead`. Uma entrada `allowRead` reabre leitura dentro de uma região `denyRead` mais ampla, e um caminho exato em `denyRead` permanece bloqueado dentro de uma `allowRead` mais ampla; veja a [tabela de sobreposição](/docs/pt/sandboxing#configure-sandboxing) para exemplos. Arrays são mesclados em todos os escopos de configuração. Use isto para criar padrões de acesso de leitura apenas para workspace. | `["."]` |

422| `filesystem.allowManagedReadPathsOnly` | (Apenas configurações gerenciadas) Apenas caminhos `allowRead` de configurações gerenciadas são respeitados. `denyRead` ainda se mescla de todas as fontes. Padrão: false | `true` |422| `filesystem.allowManagedReadPathsOnly` | (Apenas configurações gerenciadas) Apenas caminhos `allowRead` de configurações gerenciadas são respeitados. `denyRead` ainda se mescla de todas as fontes. Padrão: false | `true` |

423| `credentials.files` | {/* min-version: 2.1.187 */}Arquivos ou diretórios de credenciais que comandos sandboxed não podem ler. Aplica o mesmo bloqueio de leitura que `filesystem.denyRead`; a chave separada mantém caminhos de credenciais agrupados com `credentials.envVars` e separados de regras gerais de sistema de arquivos. Cada entrada é `{ "path": "...", "mode": "deny" }`, e `deny` é o único modo suportado para arquivos. Caminhos usam os mesmos [prefixos](#sandbox-path-prefixes) que configurações `filesystem.*`. Arrays são mesclados em todos os escopos de configuração. Requer Claude Code v2.1.187 ou posterior. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |423| `credentials.files` | Arquivos ou diretórios de credenciais que comandos sandboxed não podem ler. Aplica o mesmo bloqueio de leitura que `filesystem.denyRead`; a chave separada mantém caminhos de credenciais agrupados com `credentials.envVars` e separados de regras gerais de sistema de arquivos. Cada entrada é `{ "path": "...", "mode": "deny" }`, e `deny` é o único modo suportado para arquivos. Caminhos usam os mesmos [prefixos](#sandbox-path-prefixes) que configurações `filesystem.*`. Arrays são mesclados em todos os escopos de configuração. Requer Claude Code v2.1.187 ou posterior. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

424| `credentials.envVars` | {/* min-version: 2.1.187 */}Variáveis de ambiente para [proteger de comandos sandboxed](/pt/sandboxing#protect-credentials). Cada entrada tem um `name` e um `mode`; o nome deve começar com uma letra ou underscore e conter apenas letras, dígitos e underscores. `deny` remove a variável do ambiente de comandos sandboxed. Requer Claude Code v2.1.187 ou posterior. {/* min-version: 2.1.199 */}}`mask` substitui a variável com um valor sentinela por sessão dentro do sandbox enquanto o proxy do sandbox substitui o valor real em solicitações de saída para `injectHosts` dessa entrada; requer `network.tlsTerminate` e Claude Code v2.1.199 ou posterior. Entradas `mask` são apenas honradas de configurações de usuário, gerenciadas, ou CLI `--settings`, não de `.claude/settings.json` ou `.claude/settings.local.json`. Arrays são mesclados em todos os escopos de configuração, e `deny` tem precedência quando a mesma variável aparece com ambos os modos. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |424| `credentials.envVars` | Variáveis de ambiente para [proteger de comandos sandboxed](/docs/pt/sandboxing#protect-credentials). Cada entrada tem um `name` e um `mode`; o nome deve começar com uma letra ou underscore e conter apenas letras, dígitos e underscores. `deny` remove a variável do ambiente de comandos sandboxed. Requer Claude Code v2.1.187 ou posterior. }`mask` substitui a variável com um valor sentinela por sessão dentro do sandbox enquanto o proxy do sandbox substitui o valor real em solicitações de saída para `injectHosts` dessa entrada; requer `network.tlsTerminate` e Claude Code v2.1.199 ou posterior. Entradas `mask` são apenas honradas de configurações de usuário, gerenciadas, ou CLI `--settings`, não de `.claude/settings.json` ou `.claude/settings.local.json`. Arrays são mesclados em todos os escopos de configuração, e `deny` tem precedência quando a mesma variável aparece com ambos os modos. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

425| `credentials.envVars[].injectHosts` | Hosts onde o proxy do sandbox substitui o valor real de uma entrada `mask`. Cada host também deve ser coberto por `network.allowedDomains`, exatamente ou por um curinga. Quando indefinido, o proxy substitui o valor em solicitações para cada host em `network.allowedDomains`. Aceito mas ignorado quando `mode` é `deny`. Requer Claude Code v2.1.199 ou posterior. {/* min-version: 2.1.199 */}} | `["api.github.com"]` |425| `credentials.envVars[].injectHosts` | Hosts onde o proxy do sandbox substitui o valor real de uma entrada `mask`. Cada host também deve ser coberto por `network.allowedDomains`, exatamente ou por um curinga. Quando indefinido, o proxy substitui o valor em solicitações para cada host em `network.allowedDomains`. Aceito mas ignorado quando `mode` é `deny`. Requer Claude Code v2.1.199 ou posterior. } | `["api.github.com"]` |

426| `credentials.allowPlaintextInject` | Permitir substituição `mask` em solicitações HTTP simples bem como HTTPS com TLS terminado. Em HTTP simples a identidade upstream não é verificada e a credencial viaja em cleartext, então deixe isto desligado fora de redes de teste confiáveis. Apenas honrado de configurações de usuário, gerenciadas, ou CLI `--settings`, não de `.claude/settings.json` ou `.claude/settings.local.json`. Padrão: false. Requer Claude Code v2.1.199 ou posterior. {/* min-version: 2.1.199 */}} | `true` |426| `credentials.allowPlaintextInject` | Permitir substituição `mask` em solicitações HTTP simples bem como HTTPS com TLS terminado. Em HTTP simples a identidade upstream não é verificada e a credencial viaja em cleartext, então deixe isto desligado fora de redes de teste confiáveis. Apenas honrado de configurações de usuário, gerenciadas, ou CLI `--settings`, não de `.claude/settings.json` ou `.claude/settings.local.json`. Padrão: false. Requer Claude Code v2.1.199 ou posterior. } | `true` |

427| `network.allowUnixSockets` | (Apenas macOS) Caminhos de socket Unix acessíveis no sandbox. Ignorado no Linux e WSL2, onde o filtro seccomp não pode inspecionar caminhos de socket; use `allowAllUnixSockets` em vez disso. | `["~/.ssh/agent-socket"]` |427| `network.allowUnixSockets` | (Apenas macOS) Caminhos de socket Unix acessíveis no sandbox. Ignorado no Linux e WSL2, onde o filtro seccomp não pode inspecionar caminhos de socket; use `allowAllUnixSockets` em vez disso. | `["~/.ssh/agent-socket"]` |

428| `network.allowAllUnixSockets` | Permitir todas as conexões de socket Unix no sandbox. No Linux e WSL2 esta é a única maneira de permitir sockets Unix, já que pula o filtro seccomp que de outra forma bloqueia chamadas `socket(AF_UNIX, ...)`. Padrão: false | `true` |428| `network.allowAllUnixSockets` | Permitir todas as conexões de socket Unix no sandbox. No Linux e WSL2 esta é a única maneira de permitir sockets Unix, já que pula o filtro seccomp que de outra forma bloqueia chamadas `socket(AF_UNIX, ...)`. Padrão: false | `true` |

429| `network.allowLocalBinding` | Permitir vinculação a portas localhost (apenas macOS). Padrão: false | `true` |429| `network.allowLocalBinding` | Permitir vinculação a portas localhost (apenas macOS). Padrão: false | `true` |


433| `network.allowManagedDomainsOnly` | (Apenas configurações gerenciadas) Apenas `allowedDomains` e regras allow `WebFetch(domain:...)` de configurações gerenciadas são respeitadas. Domínios de configurações de usuário, projeto e local são ignorados. Domínios não permitidos são bloqueados automaticamente sem solicitar o usuário. Domínios negados ainda são respeitados de todas as fontes. Padrão: false | `true` |433| `network.allowManagedDomainsOnly` | (Apenas configurações gerenciadas) Apenas `allowedDomains` e regras allow `WebFetch(domain:...)` de configurações gerenciadas são respeitadas. Domínios de configurações de usuário, projeto e local são ignorados. Domínios não permitidos são bloqueados automaticamente sem solicitar o usuário. Domínios negados ainda são respeitados de todas as fontes. Padrão: false | `true` |

434| `network.httpProxyPort` | Porta de proxy HTTP usada se você deseja trazer seu próprio proxy. Se não especificado, Claude executará seu próprio proxy. | `8080` |434| `network.httpProxyPort` | Porta de proxy HTTP usada se você deseja trazer seu próprio proxy. Se não especificado, Claude executará seu próprio proxy. | `8080` |

435| `network.socksProxyPort` | Porta de proxy SOCKS5 usada se você deseja trazer seu próprio proxy. Se não especificado, Claude executará seu próprio proxy. | `8081` |435| `network.socksProxyPort` | Porta de proxy SOCKS5 usada se você deseja trazer seu próprio proxy. Se não especificado, Claude executará seu próprio proxy. | `8081` |

436| `network.tlsTerminate` | Experimental. Terminar TLS dentro do proxy do sandbox para que possa ler o conteúdo de solicitações HTTPS. Necessário para [substituição de credenciais](/pt/sandboxing#protect-credentials) `mask`. Defina `{}` para gerar uma autoridade de certificado efêmera para a sessão, ou defina `caCertPath` e `caKeyPath` para usar a sua própria. Apenas honrado de configurações de usuário, gerenciadas, ou CLI `--settings`, não de `.claude/settings.json` ou `.claude/settings.local.json`. Requer Claude Code v2.1.199 ou posterior. {/* min-version: 2.1.199 */}} | `{}` |436| `network.tlsTerminate` | Experimental. Terminar TLS dentro do proxy do sandbox para que possa ler o conteúdo de solicitações HTTPS. Necessário para [substituição de credenciais](/docs/pt/sandboxing#protect-credentials) `mask`. Defina `{}` para gerar uma autoridade de certificado efêmera para a sessão, ou defina `caCertPath` e `caKeyPath` para usar a sua própria. Apenas honrado de configurações de usuário, gerenciadas, ou CLI `--settings`, não de `.claude/settings.json` ou `.claude/settings.local.json`. Requer Claude Code v2.1.199 ou posterior. } | `{}` |

437| `enableWeakerNestedSandbox` | Ativar sandbox mais fraco para ambientes Docker sem privilégios (apenas Linux e WSL2). **Reduz segurança.** Padrão: false | `true` |437| `enableWeakerNestedSandbox` | Ativar sandbox mais fraco para ambientes Docker sem privilégios (apenas Linux e WSL2). **Reduz segurança.** Padrão: false | `true` |

438| `enableWeakerNetworkIsolation` | (Apenas macOS) Permitir acesso ao serviço de confiança TLS do sistema (`com.apple.trustd.agent`) no sandbox. Necessário para ferramentas baseadas em Go como `gh`, `gcloud`, e `terraform` verificarem certificados TLS ao usar `httpProxyPort` com um proxy MITM e CA personalizada. **Reduz segurança** abrindo um possível caminho de exfiltração de dados. Padrão: false | `true` |438| `enableWeakerNetworkIsolation` | (Apenas macOS) Permitir acesso ao serviço de confiança TLS do sistema (`com.apple.trustd.agent`) no sandbox. Necessário para ferramentas baseadas em Go como `gh`, `gcloud`, e `terraform` verificarem certificados TLS ao usar `httpProxyPort` com um proxy MITM e CA personalizada. **Reduz segurança** abrindo um possível caminho de exfiltração de dados. Padrão: false | `true` |

439| `allowAppleEvents` | (Apenas macOS) Permitir que comandos sandboxed enviem Apple Events. Necessário para `open`, `osascript`, e ferramentas que abrem URLs em um navegador, que de outra forma falham com erro `-600`. **Remove isolamento de execução de código.** Comandos sandboxed podem lançar outras aplicações sem sandbox sem prompt do usuário; eles também podem enviar comandos AppleScript para aplicações em execução como Terminal, sujeito ao prompt de consentimento de automação por aplicativo do macOS (TCC). Apenas honrado de configurações de usuário, gerenciadas, ou CLI, não de configurações de projeto. Padrão: false | `true` |439| `allowAppleEvents` | (Apenas macOS) Permitir que comandos sandboxed enviem Apple Events. Necessário para `open`, `osascript`, e ferramentas que abrem URLs em um navegador, que de outra forma falham com erro `-600`. **Remove isolamento de execução de código.** Comandos sandboxed podem lançar outras aplicações sem sandbox sem prompt do usuário; eles também podem enviar comandos AppleScript para aplicações em execução como Terminal, sujeito ao prompt de consentimento de automação por aplicativo do macOS (TCC). Apenas honrado de configurações de usuário, gerenciadas, ou CLI, não de configurações de projeto. Padrão: false | `true` |

440| `bwrapPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário bubblewrap (`bwrap`). Substitui detecção automática via `PATH`. Apenas honrado de [configurações gerenciadas](/pt/settings#settings-files), não de configurações de usuário ou projeto. Útil quando `bwrap` é instalado em um local não padrão em ambientes gerenciados. | `/opt/admin/bwrap` |440| `bwrapPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário bubblewrap (`bwrap`). Substitui detecção automática via `PATH`. Apenas honrado de [configurações gerenciadas](/docs/pt/settings#settings-files), não de configurações de usuário ou projeto. Útil quando `bwrap` é instalado em um local não padrão em ambientes gerenciados. | `/opt/admin/bwrap` |

441| `socatPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário `socat` usado para o proxy de rede do sandbox. Substitui detecção automática via `PATH`. Apenas honrado de configurações gerenciadas. | `/opt/admin/socat` |441| `socatPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário `socat` usado para o proxy de rede do sandbox. Substitui detecção automática via `PATH`. Apenas honrado de configurações gerenciadas. | `/opt/admin/socat` |

442 442 

443<h4 id="sandbox-path-prefixes">443<h4 id="sandbox-path-prefixes">


452| `~/` | Relativo ao diretório home | `~/.kube` se torna `$HOME/.kube` |452| `~/` | Relativo ao diretório home | `~/.kube` se torna `$HOME/.kube` |

453| `./` ou sem prefixo | Relativo à raiz do projeto para configurações de projeto, ou a `~/.claude` para configurações de usuário | `./output` em `.claude/settings.json` resolve para `<project-root>/output` |453| `./` ou sem prefixo | Relativo à raiz do projeto para configurações de projeto, ou a `~/.claude` para configurações de usuário | `./output` em `.claude/settings.json` resolve para `<project-root>/output` |

454 454 

455O prefixo mais antigo `//path` para caminhos absolutos ainda funciona. Se você usou anteriormente `/path` esperando resolução relativa ao projeto, mude para `./path`. Esta sintaxe difere de [regras de permissão Read e Edit](/pt/permissions#read-and-edit), que usam `//path` para absoluto e `/path` para relativo ao projeto. Caminhos de sistema de arquivos de sandbox usam convenções padrão: `/tmp/build` é um caminho absoluto.455O prefixo mais antigo `//path` para caminhos absolutos ainda funciona. Se você usou anteriormente `/path` esperando resolução relativa ao projeto, mude para `./path`. Esta sintaxe difere de [regras de permissão Read e Edit](/docs/pt/permissions#read-and-edit), que usam `//path` para absoluto e `/path` para relativo ao projeto. Caminhos de sistema de arquivos de sandbox usam convenções padrão: `/tmp/build` é um caminho absoluto.

456 456 

457**Exemplo de configuração:**457**Exemplo de configuração:**

458 458 


542}542}

543```543```

544 544 

545O comando executa com as mesmas variáveis de ambiente que [hooks](/pt/hooks), incluindo `CLAUDE_PROJECT_DIR`. Recebe JSON via stdin com um campo `query`:545O comando executa com as mesmas variáveis de ambiente que [hooks](/docs/pt/hooks), incluindo `CLAUDE_PROJECT_DIR`. Recebe JSON via stdin com um campo `query`:

546 546 

547```json theme={null}547```json theme={null}

548{"query": "src/comp"}548{"query": "src/comp"}


603 603 

604Quando um turno é concluído, Claude Code corresponde cada regex `pattern` de entrada contra a saída de turno na thread principal, então uma regex lenta bloqueia a UI até terminar. Quantificadores aninhados como `(a+)+$` podem levar exponencialmente tempo contra certas entradas e congelar a sessão, então mantenha cada `pattern` linear e evite aninhar `+` ou `*`.604Quando um turno é concluído, Claude Code corresponde cada regex `pattern` de entrada contra a saída de turno na thread principal, então uma regex lenta bloqueia a UI até terminar. Quantificadores aninhados como `(a+)+$` podem levar exponencialmente tempo contra certas entradas e congelar a sessão, então mantenha cada `pattern` linear e evite aninhar `+` ou `*`.

605 605 

606Badges de rodapé renderizam ao lado de uma [linha de status personalizada](/pt/statusline) quando uma está configurada; nenhuma substitui a outra. Use uma linha de status para uma linha acionada por script que calcula seu próprio conteúdo a partir de dados de sessão, e badges de rodapé para transformar IDs da conversa em links sem um script.606Badges de rodapé renderizam ao lado de uma [linha de status personalizada](/docs/pt/statusline) quando uma está configurada; nenhuma substitui a outra. Use uma linha de status para uma linha acionada por script que calcula seu próprio conteúdo a partir de dados de sessão, e badges de rodapé para transformar IDs da conversa em links sem um script.

607 607 

608<h3 id="hook-configuration">608<h3 id="hook-configuration">

609 Configuração de hooks609 Configuração de hooks


641 Calcular configurações gerenciadas com um auxiliar de política641 Calcular configurações gerenciadas com um auxiliar de política

642</h3>642</h3>

643 643 

644A configuração `policyHelper` aponta para um executável que calcula configurações gerenciadas na inicialização, para que administradores possam derivar política da postura do dispositivo, identidade, ou um serviço remoto em vez de um arquivo estático. Configure-o a partir de MDM ou um arquivo `managed-settings.json` do sistema. O Claude Code ignora `policyHelper` quando aparece em qualquer outro escopo, incluindo configurações de usuário, configurações de projeto, a hive de registro HKCU, e [configurações gerenciadas pelo servidor](/pt/server-managed-settings).644A configuração `policyHelper` aponta para um executável que calcula configurações gerenciadas na inicialização, para que administradores possam derivar política da postura do dispositivo, identidade, ou um serviço remoto em vez de um arquivo estático. Configure-o a partir de MDM ou um arquivo `managed-settings.json` do sistema. O Claude Code ignora `policyHelper` quando aparece em qualquer outro escopo, incluindo configurações de usuário, configurações de projeto, a hive de registro HKCU, e [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings).

645 645 

646A configuração aceita estas chaves:646A configuração aceita estas chaves:

647 647 


671 671 

672Configurações se aplicam em ordem de precedência. De mais alta para mais baixa:672Configurações se aplicam em ordem de precedência. De mais alta para mais baixa:

673 673 

6741. **Configurações gerenciadas** ([gerenciadas pelo servidor](/pt/server-managed-settings), [políticas de nível MDM/SO](#configuration-scopes), ou [configurações gerenciadas](/pt/settings#settings-files))6741. **Configurações gerenciadas** ([gerenciadas pelo servidor](/docs/pt/server-managed-settings), [políticas de nível MDM/SO](#configuration-scopes), ou [configurações gerenciadas](/docs/pt/settings#settings-files))

675 * Políticas implantadas por TI através de entrega de servidor, perfis de configuração MDM, políticas de registro, ou arquivos de configurações gerenciadas675 * Políticas implantadas por TI através de entrega de servidor, perfis de configuração MDM, políticas de registro, ou arquivos de configurações gerenciadas

676 * Não podem ser substituídas por qualquer outro nível, incluindo argumentos de linha de comando676 * Não podem ser substituídas por qualquer outro nível, incluindo argumentos de linha de comando

677 * Dentro do nível gerenciado, apenas uma fonte é usada e as outras são ignoradas em vez de mescladas. Precedência, mais alta primeiro:677 * Dentro do nível gerenciado, apenas uma fonte é usada e as outras são ignoradas em vez de mescladas. Precedência, mais alta primeiro:

678 * Saída [`policyHelper`](#compute-managed-settings-with-a-policy-helper): quando configurada, esta é a única fonte gerenciada usada678 * Saída [`policyHelper`](#compute-managed-settings-with-a-policy-helper): quando configurada, esta é a única fonte gerenciada usada

679 * Remota (configurações gerenciadas pelo servidor do [claude.ai](/pt/server-managed-settings) ou [gateway de aplicativos Claude](/pt/claude-apps-gateway)-entregues)679 * Remota (configurações gerenciadas pelo servidor do [claude.ai](/docs/pt/server-managed-settings) ou [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway)-entregues)

680 * Políticas de nível MDM/SO680 * Políticas de nível MDM/SO

681 * Baseada em arquivo (`managed-settings.d/*.json` e `managed-settings.json`, mescladas juntas)681 * Baseada em arquivo (`managed-settings.d/*.json` e `managed-settings.json`, mescladas juntas)

682 * Registro HKCU (apenas Windows)682 * Registro HKCU (apenas Windows)


684 * as chaves de bloqueio de sandbox `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`, com suas listas de permissões associadas684 * as chaves de bloqueio de sandbox `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`, com suas listas de permissões associadas

685 * `allowAllClaudeAiMcps`685 * `allowAllClaudeAiMcps`

686 * os caminhos binários de sandbox `sandbox.bwrapPath` e `sandbox.socatPath`686 * os caminhos binários de sandbox `sandbox.bwrapPath` e `sandbox.socatPath`

687 * [`forceRemoteSettingsRefresh`](/pt/server-managed-settings)687 * [`forceRemoteSettingsRefresh`](/docs/pt/server-managed-settings)

688 * Hosts de incorporação como Claude Desktop podem fornecer política via opção SDK `managedSettings`. Por padrão isto é ignorado quando qualquer fonte gerenciada controlada por administrador está presente: configurações gerenciadas pelo servidor, uma política MDM ou SO, ou um arquivo de configurações gerenciadas. O fallback de registro HKCU gravável pelo usuário não conta como uma fonte gerenciada controlada por administrador. Administradores podem optar por definir [`parentSettingsBehavior`](#available-settings) como `"merge"`. Os valores do incorporador são filtrados para que possam apertar a política gerenciada mas não afrouxá-la.688 * Hosts de incorporação como Claude Desktop podem fornecer política via opção SDK `managedSettings`. Por padrão isto é ignorado quando qualquer fonte gerenciada controlada por administrador está presente: configurações gerenciadas pelo servidor, uma política MDM ou SO, ou um arquivo de configurações gerenciadas. O fallback de registro HKCU gravável pelo usuário não conta como uma fonte gerenciada controlada por administrador. Administradores podem optar por definir [`parentSettingsBehavior`](#available-settings) como `"merge"`. Os valores do incorporador são filtrados para que possam apertar a política gerenciada mas não afrouxá-la.

689 689 

6902. **Argumentos de linha de comando**6902. **Argumentos de linha de comando**


6995. **Configurações de usuário** (`~/.claude/settings.json`)6995. **Configurações de usuário** (`~/.claude/settings.json`)

700 * Configurações globais pessoais700 * Configurações globais pessoais

701 701 

702Esta hierarquia garante que políticas organizacionais sejam sempre aplicadas enquanto ainda permite que equipes e indivíduos personalizem sua experiência. A mesma precedência se aplica se você executar Claude Code a partir da CLI, da [extensão VS Code](/pt/vs-code), ou de um [IDE JetBrains](/pt/jetbrains).702Esta hierarquia garante que políticas organizacionais sejam sempre aplicadas enquanto ainda permite que equipes e indivíduos personalizem sua experiência. A mesma precedência se aplica se você executar Claude Code a partir da CLI, da [extensão VS Code](/docs/pt/vs-code), ou de um [IDE JetBrains](/docs/pt/jetbrains).

703 703 

704Por exemplo, se suas configurações de usuário definem `permissions.defaultMode` como `acceptEdits` e as configurações compartilhadas de um projeto definem como `default`, o valor do projeto se aplica. O exemplo abaixo cobre como configurações com valor de array como regras de permissão se combinam em vez disso.704Por exemplo, se suas configurações de usuário definem `permissions.defaultMode` como `acceptEdits` e as configurações compartilhadas de um projeto definem como `default`, o valor do projeto se aplica. O exemplo abaixo cobre como configurações com valor de array como regras de permissão se combinam em vez disso.

705 705 


709 Duas configurações de array não se mesclam desta forma:709 Duas configurações de array não se mesclam desta forma:

710 710 

711 * [`fallbackModel`](#available-settings) é uma cadeia ordenada onde a posição carrega significado: o arquivo de precedência mais alta que a define fornece o valor inteiro.711 * [`fallbackModel`](#available-settings) é uma cadeia ordenada onde a posição carrega significado: o arquivo de precedência mais alta que a define fornece o valor inteiro.

712 * [`availableModels`](#available-settings): {/* min-version: 2.1.175 */}quando a [fonte gerenciada de precedência mais alta](/pt/server-managed-settings#settings-precedence) a define, essa lista se aplica como está e entradas de usuário, projeto e local não podem estendê-la. Entre escopos não gerenciados os arrays se mesclam como usual. Veja [Comportamento de mesclagem](/pt/model-config#merge-behavior).712 * [`availableModels`](#available-settings): quando a [fonte gerenciada de precedência mais alta](/docs/pt/server-managed-settings#settings-precedence) a define, essa lista se aplica como está e entradas de usuário, projeto e local não podem estendê-la. Entre escopos não gerenciados os arrays se mesclam como usual. Veja [Comportamento de mesclagem](/docs/pt/model-config#merge-behavior).

713</Note>713</Note>

714 714 

715<h3 id="verify-active-settings">715<h3 id="verify-active-settings">

716 Verificar configurações ativas716 Verificar configurações ativas

717</h3>717</h3>

718 718 

719Execute `/status` dentro do Claude Code para ver quais fontes de configuração estão ativas. Dentro do menu, a aba **Status** inclui uma linha `Setting sources` que lista cada camada que Claude Code carregou para a sessão atual, como `User settings` ou `Project local settings`. Quando [configurações gerenciadas](/pt/admin-setup#decide-how-settings-reach-devices) estão em efeito, a entrada mostra o canal de entrega entre parênteses, por exemplo `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)`, ou `(file)`. O canal `remote` cobre configurações gerenciadas pelo servidor do claude.ai e políticas [gateway de aplicativos Claude](/pt/claude-apps-gateway)-entregues. Uma camada aparece na lista apenas quando essa fonte é carregada com pelo menos uma chave, então uma lista vazia significa que nenhuma fonte de configuração foi encontrada.719Execute `/status` dentro do Claude Code para ver quais fontes de configuração estão ativas. Dentro do menu, a aba **Status** inclui uma linha `Setting sources` que lista cada camada que Claude Code carregou para a sessão atual, como `User settings` ou `Project local settings`. Quando [configurações gerenciadas](/docs/pt/admin-setup#decide-how-settings-reach-devices) estão em efeito, a entrada mostra o canal de entrega entre parênteses, por exemplo `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)`, ou `(file)`. O canal `remote` cobre configurações gerenciadas pelo servidor do claude.ai e políticas [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway)-entregues. Uma camada aparece na lista apenas quando essa fonte é carregada com pelo menos uma chave, então uma lista vazia significa que nenhuma fonte de configuração foi encontrada.

720 720 

721A linha `Setting sources` confirma quais fontes estão sendo lidas. Ela não mostra qual camada forneceu cada chave individual. A aba **Config** no mesmo diálogo é um editor para um conjunto fixo de toggles como tema e saída verbose, não uma visualização do conteúdo do seu `settings.json`.721A linha `Setting sources` confirma quais fontes estão sendo lidas. Ela não mostra qual camada forneceu cada chave individual. A aba **Config** no mesmo diálogo é um editor para um conjunto fixo de toggles como tema e saída verbose, não uma visualização do conteúdo do seu `settings.json`.

722 722 


770* **Subagents de usuário**: `~/.claude/agents/`, disponíveis em todos os seus projetos770* **Subagents de usuário**: `~/.claude/agents/`, disponíveis em todos os seus projetos

771* **Subagents de projeto**: `.claude/agents/`, específicos ao seu projeto e compartilháveis com sua equipe771* **Subagents de projeto**: `.claude/agents/`, específicos ao seu projeto e compartilháveis com sua equipe

772 772 

773Arquivos de subagent definem assistentes de IA especializados com prompts personalizados e permissões de ferramenta. Saiba mais sobre criação e uso de subagents na [documentação de subagents](/pt/sub-agents).773Arquivos de subagent definem assistentes de IA especializados com prompts personalizados e permissões de ferramenta. Saiba mais sobre criação e uso de subagents na [documentação de subagents](/docs/pt/sub-agents).

774 774 

775<h2 id="plugin-configuration">775<h2 id="plugin-configuration">

776 Configuração de plugin776 Configuração de plugin


806 `enabledPlugins`806 `enabledPlugins`

807</h4>807</h4>

808 808 

809Controla quais plugins estão habilitados. Formato: `"plugin-name@marketplace-name": true/false`. Um plugin sem entrada em nenhum escopo volta ao seu valor [`defaultEnabled`](/pt/plugins-reference#default-enablement).809Controla quais plugins estão habilitados. Formato: `"plugin-name@marketplace-name": true/false`. Um plugin sem entrada em nenhum escopo volta ao seu valor [`defaultEnabled`](/docs/pt/plugins-reference#default-enablement).

810 810 

811**Escopos**:811**Escopos**:

812 812 


820 820 

821 Plugins forçadamente habilitados por configurações gerenciadas não podem ser desabilitados desta forma, pois as configurações gerenciadas substituem as configurações locais.821 Plugins forçadamente habilitados por configurações gerenciadas não podem ser desabilitados desta forma, pois as configurações gerenciadas substituem as configurações locais.

822 822 

823 Habilitar um plugin de uma fonte externa como um repositório GitHub ou pacote npm em um `.claude/settings.json` de projeto não o instala para outras pessoas. A partir de Claude Code v2.1.195, cada caminho que carrega plugins pede a cada usuário para [instalar e confiar no plugin](/pt/discover-plugins#configure-team-marketplaces) antes de executá-lo.823 Habilitar um plugin de uma fonte externa como um repositório GitHub ou pacote npm em um `.claude/settings.json` de projeto não o instala para outras pessoas. A partir de Claude Code v2.1.195, cada caminho que carrega plugins pede a cada usuário para [instalar e confiar no plugin](/docs/pt/discover-plugins#configure-team-marketplaces) antes de executá-lo.

824</Note>824</Note>

825 825 

826**Exemplo**:826**Exemplo**:


839 `pluginConfigs`839 `pluginConfigs`

840</h4>840</h4>

841 841 

842Armazena os valores de opção não sensíveis que o prompt [`userConfig`](/pt/plugins-reference#user-configuration) de um plugin coleta, indexados por ID de plugin. Claude Code escreve esta chave em configurações de usuário quando você preenche o diálogo de configuração do plugin, portanto você não precisa editá-la manualmente. Opções sensíveis são armazenadas no Keychain do macOS em vez disso, ou em `~/.claude/.credentials.json` em plataformas sem um keychain suportado.842Armazena os valores de opção não sensíveis que o prompt [`userConfig`](/docs/pt/plugins-reference#user-configuration) de um plugin coleta, indexados por ID de plugin. Claude Code escreve esta chave em configurações de usuário quando você preenche o diálogo de configuração do plugin, portanto você não precisa editá-la manualmente. Opções sensíveis são armazenadas no Keychain do macOS em vez disso, ou em `~/.claude/.credentials.json` em plataformas sem um keychain suportado.

843 843 

844Este exemplo armazena uma opção para um plugin instalado do marketplace `acme-tools`:844Este exemplo armazena uma opção para um plugin instalado do marketplace `acme-tools`:

845 845 


899* `hostPattern`: Padrão regex para corresponder hosts de marketplace (usa `hostPattern`)899* `hostPattern`: Padrão regex para corresponder hosts de marketplace (usa `hostPattern`)

900* `settings`: marketplace inline declarado diretamente em settings.json sem um repositório hospedado separado (usa `name` e `plugins`)900* `settings`: marketplace inline declarado diretamente em settings.json sem um repositório hospedado separado (usa `name` e `plugins`)

901 901 

902O tipo de fonte `git` funciona com qualquer serviço de hospedagem git, incluindo GitLab auto-hospedado e Bitbucket. Claude Code clona o repositório com a mesma autenticação que `git clone` usaria naquela máquina: assistentes de credencial configurados ou chaves SSH. Um token de provedor como `GITHUB_TOKEN` tem efeito apenas através de um assistente de credencial que o lê. Veja [Repositórios privados](/pt/plugin-marketplaces#private-repositories) para detalhes de configuração.902O tipo de fonte `git` funciona com qualquer serviço de hospedagem git, incluindo GitLab auto-hospedado e Bitbucket. Claude Code clona o repositório com a mesma autenticação que `git clone` usaria naquela máquina: assistentes de credencial configurados ou chaves SSH. Um token de provedor como `GITHUB_TOKEN` tem efeito apenas através de um assistente de credencial que o lê. Veja [Repositórios privados](/docs/pt/plugin-marketplaces#private-repositories) para detalhes de configuração.

903 903 

904Para fontes `github` e `git`, defina `"skipLfs": true` dentro do objeto `source` (junto com `repo` ou `url`) para pular downloads de Git LFS quando Claude Code clona ou atualiza o repositório de marketplace. Arquivos de ponteiro LFS permanecem como ponteiros em vez de baixar seu conteúdo. Use isto quando o repositório contém objetos LFS grandes não relacionados ao conteúdo de plugin. {/* min-version: 2.1.153 */}Requer Claude Code v2.1.153 ou posterior.904Para fontes `github` e `git`, defina `"skipLfs": true` dentro do objeto `source` (junto com `repo` ou `url`) para pular downloads de Git LFS quando Claude Code clona ou atualiza o repositório de marketplace. Arquivos de ponteiro LFS permanecem como ponteiros em vez de baixar seu conteúdo. Use isto quando o repositório contém objetos LFS grandes não relacionados ao conteúdo de plugin. Requer Claude Code v2.1.153 ou posterior.

905 905 

906Cada entrada de marketplace também aceita um Boolean `autoUpdate` opcional. Defina `"autoUpdate": true` junto com `source` para fazer Claude Code atualizar aquele marketplace e atualizar seus plugins instalados em segundo plano após a inicialização. Quando omitido, marketplaces oficiais da Anthropic padrão para `true` e todos os outros marketplaces padrão para `false`. Veja [Configurar auto-atualizações](/pt/discover-plugins#configure-auto-updates).906Cada entrada de marketplace também aceita um Boolean `autoUpdate` opcional. Defina `"autoUpdate": true` junto com `source` para fazer Claude Code atualizar aquele marketplace e atualizar seus plugins instalados em segundo plano após a inicialização. Quando omitido, marketplaces oficiais da Anthropic padrão para `true` e todos os outros marketplaces padrão para `false`. Veja [Configurar auto-atualizações](/docs/pt/discover-plugins#configure-auto-updates).

907 907 

908Use `source: 'settings'` para declarar um pequeno conjunto de plugins inline sem configurar um repositório de marketplace hospedado. Plugins listados aqui devem referenciar fontes externas como GitHub ou npm. Você ainda precisa habilitar cada plugin separadamente em `enabledPlugins`.908Use `source: 'settings'` para declarar um pequeno conjunto de plugins inline sem configurar um repositório de marketplace hospedado. Plugins listados aqui devem referenciar fontes externas como GitHub ou npm. Você ainda precisa habilitar cada plugin separadamente em `enabledPlugins`.

909 909 


933 `strictKnownMarketplaces`933 `strictKnownMarketplaces`

934</h4>934</h4>

935 935 

936**Apenas configurações gerenciadas**: Controla quais marketplaces de plugin os usuários podem adicionar e instalar plugins. Esta configuração pode ser configurada apenas em [configurações gerenciadas](/pt/settings#settings-files) e fornece aos administradores controle rigoroso sobre fontes de marketplace.936**Apenas configurações gerenciadas**: Controla quais marketplaces de plugin os usuários podem adicionar e instalar plugins. Esta configuração pode ser configurada apenas em [configurações gerenciadas](/docs/pt/settings#settings-files) e fornece aos administradores controle rigoroso sobre fontes de marketplace.

937 937 

938**Localizações de arquivo de configurações gerenciadas**:938**Localizações de arquivo de configurações gerenciadas**:

939 939 


988Campos: `url` (obrigatório), `headers` (opcional: cabeçalhos HTTP para acesso autenticado)988Campos: `url` (obrigatório), `headers` (opcional: cabeçalhos HTTP para acesso autenticado)

989 989 

990<Note>990<Note>

991 Marketplaces baseados em URL apenas baixam o arquivo `marketplace.json`. Eles não baixam arquivos de plugin do servidor. Plugins em marketplaces baseados em URL devem usar fontes externas (URLs GitHub, npm, ou git) em vez de caminhos relativos. Para plugins com caminhos relativos, use um marketplace baseado em Git em vez disso. Veja [Troubleshooting](/pt/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) para detalhes.991 Marketplaces baseados em URL apenas baixam o arquivo `marketplace.json`. Eles não baixam arquivos de plugin do servidor. Plugins em marketplaces baseados em URL devem usar fontes externas (URLs GitHub, npm, ou git) em vez de caminhos relativos. Para plugins com caminhos relativos, use um marketplace baseado em Git em vez disso. Veja [Troubleshooting](/docs/pt/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) para detalhes.

992</Note>992</Note>

993 993 

9944. **Pacotes NPM**:9944. **Pacotes NPM**:


1178* A restrição é aplicada em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin. Um marketplace adicionado antes da política ser definida não pode ser usado para instalar ou atualizar plugins uma vez que sua fonte não corresponde mais à lista de permissões1178* A restrição é aplicada em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin. Um marketplace adicionado antes da política ser definida não pode ser usado para instalar ou atualizar plugins uma vez que sua fonte não corresponde mais à lista de permissões

1179* Configurações gerenciadas têm a precedência mais alta e não podem ser substituídas1179* Configurações gerenciadas têm a precedência mais alta e não podem ser substituídas

1180 1180 

1181Veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) para documentação voltada para o usuário.1181Veja [Restrições de marketplace gerenciado](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) para documentação voltada para o usuário.

1182 1182 

1183<h4 id="strictpluginonlycustomization">1183<h4 id="strictpluginonlycustomization">

1184 `strictPluginOnlyCustomization`1184 `strictPluginOnlyCustomization`


1201| `skills` | `~/.claude/skills/`, `.claude/skills/` | Skills de plugin, skills agrupadas, skills no diretório de política gerenciada |1201| `skills` | `~/.claude/skills/`, `.claude/skills/` | Skills de plugin, skills agrupadas, skills no diretório de política gerenciada |

1202| `agents` | `~/.claude/agents/`, `.claude/agents/` | Agents de plugin, agents integrados, agents no diretório de política gerenciada |1202| `agents` | `~/.claude/agents/`, `.claude/agents/` | Agents de plugin, agents integrados, agents no diretório de política gerenciada |

1203| `hooks` | Hooks em `settings.json` de usuário, projeto e local | Hooks de plugin, hooks em configurações gerenciadas |1203| `hooks` | Hooks em `settings.json` de usuário, projeto e local | Hooks de plugin, hooks em configurações gerenciadas |

1204| `mcp` | Servidores em `~/.claude.json` e `.mcp.json` | MCP servers de plugin, servidores [`managed-mcp.json`](/pt/managed-mcp) |1204| `mcp` | Servidores em `~/.claude.json` e `.mcp.json` | MCP servers de plugin, servidores [`managed-mcp.json`](/docs/pt/managed-mcp) |

1205 1205 

1206Nomes de superfície que uma versão de Claude Code não reconhece são ignorados em vez de falhar no arquivo de configurações, portanto você pode adicionar novos nomes de superfície antes que todos os clientes tenham atualizado.1206Nomes de superfície que uma versão de Claude Code não reconhece são ignorados em vez de falhar no arquivo de configurações, portanto você pode adicionar novos nomes de superfície antes que todos os clientes tenham atualizado.

1207 1207 


1217* Ver detalhes de plugin (skills, agents, hooks fornecidos)1217* Ver detalhes de plugin (skills, agents, hooks fornecidos)

1218* Adicionar/remover marketplaces1218* Adicionar/remover marketplaces

1219 1219 

1220Saiba mais sobre o sistema de plugin na [documentação de plugins](/pt/plugins).1220Saiba mais sobre o sistema de plugin na [documentação de plugins](/docs/pt/plugins).

1221 1221 

1222<h2 id="environment-variables">1222<h2 id="environment-variables">

1223 Variáveis de ambiente1223 Variáveis de ambiente


1225 1225 

1226Variáveis de ambiente permitem controlar o comportamento do Claude Code sem editar arquivos de configuração. Qualquer variável também pode ser configurada em [`settings.json`](#available-settings) sob a chave `env` para aplicá-la a cada sessão ou implantá-la para sua equipe.1226Variáveis de ambiente permitem controlar o comportamento do Claude Code sem editar arquivos de configuração. Qualquer variável também pode ser configurada em [`settings.json`](#available-settings) sob a chave `env` para aplicá-la a cada sessão ou implantá-la para sua equipe.

1227 1227 

1228Veja a [referência de variáveis de ambiente](/pt/env-vars) para a lista completa.1228Veja a [referência de variáveis de ambiente](/docs/pt/env-vars) para a lista completa.

1229 1229 

1230<h2 id="tools-available-to-claude">1230<h2 id="tools-available-to-claude">

1231 Ferramentas disponíveis para Claude1231 Ferramentas disponíveis para Claude


1233 1233 

1234O Claude Code tem acesso a um conjunto de ferramentas para leitura, edição, busca, execução de comandos, e orquestração de subagents. Nomes de ferramenta são as strings exatas que você usa em regras de permissão e correspondedores de hook.1234O Claude Code tem acesso a um conjunto de ferramentas para leitura, edição, busca, execução de comandos, e orquestração de subagents. Nomes de ferramenta são as strings exatas que você usa em regras de permissão e correspondedores de hook.

1235 1235 

1236Veja a [referência de ferramentas](/pt/tools-reference) para a lista completa e detalhes de comportamento da ferramenta Bash.1236Veja a [referência de ferramentas](/docs/pt/tools-reference) para a lista completa e detalhes de comportamento da ferramenta Bash.

1237 1237 

1238<h2 id="see-also">1238<h2 id="see-also">

1239 Veja também1239 Veja também

1240</h2>1240</h2>

1241 1241 

1242* [Permissões](/pt/permissions): sistema de permissões, sintaxe de regra, padrões específicos de ferramenta, e políticas gerenciadas1242* [Permissões](/docs/pt/permissions): sistema de permissões, sintaxe de regra, padrões específicos de ferramenta, e políticas gerenciadas

1243* [Autenticação](/pt/authentication): configurar acesso de usuário ao Claude Code1243* [Autenticação](/docs/pt/authentication): configurar acesso de usuário ao Claude Code

1244* [Depurar sua configuração](/pt/debug-your-config): diagnosticar por que uma configuração, hook, ou servidor MCP não está tendo efeito1244* [Depurar sua configuração](/docs/pt/debug-your-config): diagnosticar por que uma configuração, hook, ou servidor MCP não está tendo efeito

1245* [Solucionar problemas de instalação e login](/pt/troubleshoot-install): problemas de instalação, autenticação e plataforma1245* [Solucionar problemas de instalação e login](/docs/pt/troubleshoot-install): problemas de instalação, autenticação e plataforma

skills.md +45 −45

Details

11Crie uma skill quando você fica colando o mesmo manual, checklist ou procedimento de múltiplas etapas no chat, ou quando uma seção de CLAUDE.md cresceu em um procedimento em vez de um fato. Diferentemente do conteúdo de CLAUDE.md, o corpo de uma skill carrega apenas quando é usado, então material de referência longo custa quase nada até você precisar dele.11Crie uma skill quando você fica colando o mesmo manual, checklist ou procedimento de múltiplas etapas no chat, ou quando uma seção de CLAUDE.md cresceu em um procedimento em vez de um fato. Diferentemente do conteúdo de CLAUDE.md, o corpo de uma skill carrega apenas quando é usado, então material de referência longo custa quase nada até você precisar dele.

12 12 

13<Note>13<Note>

14 Para comandos integrados como `/help` e `/compact`, e skills agrupadas como `/debug` e `/code-review`, consulte a [referência de comandos](/pt/commands).14 Para comandos integrados como `/help` e `/compact`, e skills agrupadas como `/debug` e `/code-review`, consulte a [referência de comandos](/docs/pt/commands).

15 15 

16 **Comandos personalizados foram mesclados em skills.** Um arquivo em `.claude/commands/deploy.md` e uma skill em `.claude/skills/deploy/SKILL.md` ambos criam `/deploy` e funcionam da mesma forma. Seus arquivos `.claude/commands/` existentes continuam funcionando. Skills adicionam recursos opcionais: um diretório para arquivos de suporte, frontmatter para [controlar se você ou Claude invoca eles](#control-who-invokes-a-skill), e a capacidade de Claude carregá-los automaticamente quando relevante.16 **Comandos personalizados foram mesclados em skills.** Um arquivo em `.claude/commands/deploy.md` e uma skill em `.claude/skills/deploy/SKILL.md` ambos criam `/deploy` e funcionam da mesma forma. Seus arquivos `.claude/commands/` existentes continuam funcionando. Skills adicionam recursos opcionais: um diretório para arquivos de suporte, frontmatter para [controlar se você ou Claude invoca eles](#control-who-invokes-a-skill), e a capacidade de Claude carregá-los automaticamente quando relevante.

17</Note>17</Note>


22 Skills agrupadas22 Skills agrupadas

23</h2>23</h2>

24 24 

25Claude Code inclui um conjunto de skills agrupadas que estão disponíveis em cada sessão, a menos que desabilitadas com a configuração [`disableBundledSkills`](/pt/settings#available-settings), incluindo `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop`, e `/claude-api`. Diferentemente da maioria dos comandos integrados, que executam lógica fixa diretamente, skills agrupadas são baseadas em prompt: elas dão ao Claude instruções detalhadas e deixam que ele orquestre o trabalho usando suas ferramentas. Você invoca elas da mesma forma que qualquer outra skill, digitando `/` seguido do nome da skill.25Claude Code inclui um conjunto de skills agrupadas que estão disponíveis em cada sessão, a menos que desabilitadas com a configuração [`disableBundledSkills`](/docs/pt/settings#available-settings), incluindo `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop`, e `/claude-api`. Diferentemente da maioria dos comandos integrados, que executam lógica fixa diretamente, skills agrupadas são baseadas em prompt: elas dão ao Claude instruções detalhadas e deixam que ele orquestre o trabalho usando suas ferramentas. Você invoca elas da mesma forma que qualquer outra skill, digitando `/` seguido do nome da skill.

26 26 

27O checkup de configuração [`/doctor`](/pt/commands#all-commands) é a única exceção ao `disableBundledSkills` no Claude Code v2.1.205 e posterior: ele permanece digitável quando a configuração está ativada. Para ocultá-lo, defina a variável de ambiente `DISABLE_DOCTOR_COMMAND` ou uma entrada [`skillOverrides`](#override-skill-visibility-from-settings) de `"doctor": "off"`. Antes da v2.1.205, `/doctor` era um comando integrado em vez de uma skill agrupada.27O checkup de configuração [`/doctor`](/docs/pt/commands#all-commands) é a única exceção ao `disableBundledSkills` no Claude Code v2.1.205 e posterior: ele permanece digitável quando a configuração está ativada. Para ocultá-lo, defina a variável de ambiente `DISABLE_DOCTOR_COMMAND` ou uma entrada [`skillOverrides`](#override-skill-visibility-from-settings) de `"doctor": "off"`. Antes da v2.1.205, `/doctor` era um comando integrado em vez de uma skill agrupada.

28 28 

29Skills agrupadas estão listadas junto com comandos integrados na [referência de comandos](/pt/commands), marcadas como **Skill** na coluna Propósito.29Skills agrupadas estão listadas junto com comandos integrados na [referência de comandos](/docs/pt/commands), marcadas como **Skill** na coluna Propósito.

30 30 

31<h3 id="run-and-verify-your-app">31<h3 id="run-and-verify-your-app">

32 Execute e verifique seu aplicativo32 Execute e verifique seu aplicativo


40| `/verify` | Compile e execute seu aplicativo para confirmar que uma alteração de código faz o que deveria, sem recorrer a testes ou verificações de tipo |40| `/verify` | Compile e execute seu aplicativo para confirmar que uma alteração de código faz o que deveria, sem recorrer a testes ou verificações de tipo |

41| `/run-skill-generator` | Ensine ao `/run` e `/verify` como compilar e iniciar seu projeto |41| `/run-skill-generator` | Ensine ao `/run` e `/verify` como compilar e iniciar seu projeto |

42 42 

43{/* min-version: 2.1.145 */}Todas as três skills requerem Claude Code v2.1.145 ou posterior.43Todas as três skills requerem Claude Code v2.1.145 ou posterior.

44 44 

45`/run` e `/verify` funcionam sem configuração. Eles inferem o lançamento do tipo de seu projeto (CLI, servidor, TUI, orientado por navegador) e do que está em seu README, `package.json`, ou `Makefile`. Essa inferência se torna pouco confiável para projetos que precisam de algo além de um lançamento padrão: um banco de dados, um arquivo env, uma sessão gráfica, uma compilação em várias etapas.45`/run` e `/verify` funcionam sem configuração. Eles inferem o lançamento do tipo de seu projeto (CLI, servidor, TUI, orientado por navegador) e do que está em seu README, `package.json`, ou `Makefile`. Essa inferência se torna pouco confiável para projetos que precisam de algo além de um lançamento padrão: um banco de dados, um arquivo env, uma sessão gráfica, uma compilação em várias etapas.

46 46 


114 114 

115| Localização | Caminho | Aplica-se a |115| Localização | Caminho | Aplica-se a |

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

117| Enterprise | Consulte [configurações gerenciadas](/pt/settings#settings-files) | Todos os usuários em sua organização |117| Enterprise | Consulte [configurações gerenciadas](/docs/pt/settings#settings-files) | Todos os usuários em sua organização |

118| Pessoal | `~/.claude/skills/<skill-name>/SKILL.md` | Todos os seus projetos |118| Pessoal | `~/.claude/skills/<skill-name>/SKILL.md` | Todos os seus projetos |

119| Projeto | `.claude/skills/<skill-name>/SKILL.md` | Apenas este projeto |119| Projeto | `.claude/skills/<skill-name>/SKILL.md` | Apenas este projeto |

120| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Onde o plugin está habilitado |120| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Onde o plugin está habilitado |


133 133 

134Quando você ou Claude invocam o nome não qualificado, a skill da raiz do projeto carrega, e Claude Code anexa uma lista das variantes qualificadas por diretório ao seu conteúdo com uma instrução para também invocar qualquer variante cujo diretório contenha os arquivos em que Claude está trabalhando. Uma skill aninhada, portanto, ainda se aplica ao trabalho em seu diretório quando apenas o nome não qualificado é invocado. Requer Claude Code v2.1.203 ou posterior.134Quando você ou Claude invocam o nome não qualificado, a skill da raiz do projeto carrega, e Claude Code anexa uma lista das variantes qualificadas por diretório ao seu conteúdo com uma instrução para também invocar qualquer variante cujo diretório contenha os arquivos em que Claude está trabalhando. Uma skill aninhada, portanto, ainda se aplica ao trabalho em seu diretório quando apenas o nome não qualificado é invocado. Requer Claude Code v2.1.203 ou posterior.

135 135 

136Uma entrada `<skill-name>` nas localizações enterprise, pessoal ou projeto pode ser um symlink para um diretório em outro lugar no disco. Claude Code segue o symlink e lê `SKILL.md` do diretório de destino, e se o mesmo destino for acessível de mais de um local, Claude Code carrega a skill uma vez. Skills de plugin lidam com symlinks de forma diferente; consulte [Compartilhe arquivos dentro de um marketplace com symlinks](/pt/plugins-reference#share-files-within-a-marketplace-with-symlinks).136Uma entrada `<skill-name>` nas localizações enterprise, pessoal ou projeto pode ser um symlink para um diretório em outro lugar no disco. Claude Code segue o symlink e lê `SKILL.md` do diretório de destino, e se o mesmo destino for acessível de mais de um local, Claude Code carrega a skill uma vez. Skills de plugin lidam com symlinks de forma diferente; consulte [Compartilhe arquivos dentro de um marketplace com symlinks](/docs/pt/plugins-reference#share-files-within-a-marketplace-with-symlinks).

137 137 

138<Note>138<Note>

139 Adicione um `.claude-plugin/plugin.json` a uma pasta de skill e ela carrega como um [plugin](/pt/plugins-reference#skills-directory-plugins) nomeado `<name>@skills-dir`, para que possa agrupar agents, hooks e servidores MCP. Em um `.claude/skills/` de projeto, isso requer aceitar o diálogo de confiança do workspace primeiro.139 Adicione um `.claude-plugin/plugin.json` a uma pasta de skill e ela carrega como um [plugin](/docs/pt/plugins-reference#skills-directory-plugins) nomeado `<name>@skills-dir`, para que possa agrupar agents, hooks e servidores MCP. Em um `.claude/skills/` de projeto, isso requer aceitar o diálogo de confiança do workspace primeiro.

140</Note>140</Note>

141 141 

142<h4 id="live-change-detection">142<h4 id="live-change-detection">


146Claude Code observa diretórios de skills para mudanças de arquivo. Adicionar, editar ou remover uma skill em `~/.claude/skills/`, o projeto `.claude/skills/`, ou um `.claude/skills/` dentro de um diretório `--add-dir` entra em efeito dentro da sessão atual sem reiniciar. Criar um diretório de skills de nível superior que não existia quando a sessão começou requer reiniciar Claude Code para que o novo diretório possa ser observado.146Claude Code observa diretórios de skills para mudanças de arquivo. Adicionar, editar ou remover uma skill em `~/.claude/skills/`, o projeto `.claude/skills/`, ou um `.claude/skills/` dentro de um diretório `--add-dir` entra em efeito dentro da sessão atual sem reiniciar. Criar um diretório de skills de nível superior que não existia quando a sessão começou requer reiniciar Claude Code para que o novo diretório possa ser observado.

147 147 

148<Note>148<Note>

149 A detecção de mudança ao vivo cobre apenas o texto `SKILL.md`. Para uma pasta de skill que também é um [plugin](/pt/plugins-reference#skills-directory-plugins), mudanças em `hooks/`, `.mcp.json`, `agents/` e `output-styles/` precisam de `/reload-plugins` para entrar em efeito.149 A detecção de mudança ao vivo cobre apenas o texto `SKILL.md`. Para uma pasta de skill que também é um [plugin](/docs/pt/plugins-reference#skills-directory-plugins), mudanças em `hooks/`, `.mcp.json`, `agents/` e `output-styles/` precisam de `/reload-plugins` para entrar em efeito.

150</Note>150</Note>

151 151 

152<h4 id="automatic-discovery-from-parent-and-nested-directories">152<h4 id="automatic-discovery-from-parent-and-nested-directories">


177 Skills de diretórios adicionais177 Skills de diretórios adicionais

178</h4>178</h4>

179 179 

180O sinalizador `--add-dir` e o comando `/add-dir` [concedem acesso a arquivos](/pt/permissions#additional-directories-grant-file-access-not-configuration) em vez de descoberta de configuração, mas skills são uma exceção: `.claude/skills/` dentro de um diretório adicionado é carregado automaticamente. Esta exceção se aplica apenas a `--add-dir` e `/add-dir`. A configuração `permissions.additionalDirectories` em `settings.json` concede acesso a arquivos apenas e não carrega skills. Consulte [Detecção de mudança ao vivo](#live-change-detection) para como edições são detectadas durante uma sessão.180O sinalizador `--add-dir` e o comando `/add-dir` [concedem acesso a arquivos](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) em vez de descoberta de configuração, mas skills são uma exceção: `.claude/skills/` dentro de um diretório adicionado é carregado automaticamente. Esta exceção se aplica apenas a `--add-dir` e `/add-dir`. A configuração `permissions.additionalDirectories` em `settings.json` concede acesso a arquivos apenas e não carrega skills. Consulte [Detecção de mudança ao vivo](#live-change-detection) para como edições são detectadas durante uma sessão.

181 181 

182Outra configuração `.claude/` como comandos e estilos de saída não é carregada de diretórios adicionais. Consulte a [tabela de exceções](/pt/permissions#additional-directories-grant-file-access-not-configuration) para a lista completa do que é e não é carregado, e as formas recomendadas de compartilhar configuração entre projetos.182Outra configuração `.claude/` como comandos e estilos de saída não é carregada de diretórios adicionais. Consulte a [tabela de exceções](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) para a lista completa do que é e não é carregado, e as formas recomendadas de compartilhar configuração entre projetos.

183 183 

184<Note>184<Note>

185 Arquivos CLAUDE.md de diretórios `--add-dir` não são carregados por padrão. Para carregá-los, defina `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Consulte [Carregar de diretórios adicionais](/pt/memory#load-from-additional-directories).185 Arquivos CLAUDE.md de diretórios `--add-dir` não são carregados por padrão. Para carregá-los, defina `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Consulte [Carregar de diretórios adicionais](/docs/pt/memory#load-from-additional-directories).

186</Note>186</Note>

187 187 

188<h2 id="configure-skills">188<h2 id="configure-skills">


229 229 

230Seu `SKILL.md` pode conter qualquer coisa, mas pensar em como você quer que a skill seja invocada (por você, por Claude, ou ambos) e onde você quer que seja executada (inline ou em um subagent) ajuda a guiar o que incluir. Para skills complexas, você também pode [adicionar arquivos de suporte](#add-supporting-files) para manter a skill principal focada.230Seu `SKILL.md` pode conter qualquer coisa, mas pensar em como você quer que a skill seja invocada (por você, por Claude, ou ambos) e onde você quer que seja executada (inline ou em um subagent) ajuda a guiar o que incluir. Para skills complexas, você também pode [adicionar arquivos de suporte](#add-supporting-files) para manter a skill principal focada.

231 231 

232Mantenha o corpo em si conciso. Uma vez que uma skill carrega, seu conteúdo [permanece em contexto entre turnos](#skill-content-lifecycle), então cada linha é um custo de token recorrente. Declare o que fazer em vez de narrar como ou por que, e aplique o mesmo teste de concisão que você faria para [conteúdo de CLAUDE.md](/pt/best-practices#write-an-effective-claude-md).232Mantenha o corpo em si conciso. Uma vez que uma skill carrega, seu conteúdo [permanece em contexto entre turnos](#skill-content-lifecycle), então cada linha é um custo de token recorrente. Declare o que fazer em vez de narrar como ou por que, e aplique o mesmo teste de concisão que você faria para [conteúdo de CLAUDE.md](/docs/pt/best-practices#write-an-effective-claude-md).

233 233 

234<h3 id="frontmatter-reference">234<h3 id="frontmatter-reference">

235 Referência de frontmatter235 Referência de frontmatter


257| `when_to_use` | Não | Contexto adicional para quando Claude deve invocar a skill, como frases de gatilho ou solicitações de exemplo. Anexado a `description` na listagem de skills e conta para o limite de 1.536 caracteres. |257| `when_to_use` | Não | Contexto adicional para quando Claude deve invocar a skill, como frases de gatilho ou solicitações de exemplo. Anexado a `description` na listagem de skills e conta para o limite de 1.536 caracteres. |

258| `argument-hint` | Não | Dica mostrada durante autocomplete para indicar argumentos esperados. Exemplo: `[issue-number]` ou `[filename] [format]`. |258| `argument-hint` | Não | Dica mostrada durante autocomplete para indicar argumentos esperados. Exemplo: `[issue-number]` ou `[filename] [format]`. |

259| `arguments` | Não | Argumentos posicionais nomeados para [substituição `$name`](#available-string-substitutions) no conteúdo da skill. Aceita uma string separada por espaços ou uma lista YAML. Nomes mapeiam para posições de argumento em ordem. |259| `arguments` | Não | Argumentos posicionais nomeados para [substituição `$name`](#available-string-substitutions) no conteúdo da skill. Aceita uma string separada por espaços ou uma lista YAML. Nomes mapeiam para posições de argumento em ordem. |

260| `disable-model-invocation` | Não | Defina como `true` para evitar que Claude carregue automaticamente esta skill. Use para fluxos de trabalho que você quer disparar manualmente com `/name`. Também evita que a skill seja [pré-carregada em subagents](/pt/sub-agents#preload-skills-into-subagents). A partir da v2.1.196, também evita que a skill seja executada quando uma [tarefa agendada](/pt/scheduled-tasks) dispara com a skill como seu prompt. Padrão: `false`. |260| `disable-model-invocation` | Não | Defina como `true` para evitar que Claude carregue automaticamente esta skill. Use para fluxos de trabalho que você quer disparar manualmente com `/name`. Também evita que a skill seja [pré-carregada em subagents](/docs/pt/sub-agents#preload-skills-into-subagents). A partir da v2.1.196, também evita que a skill seja executada quando uma [tarefa agendada](/docs/pt/scheduled-tasks) dispara com a skill como seu prompt. Padrão: `false`. |

261| `user-invocable` | Não | Defina como `false` para ocultar do menu `/`. Use para conhecimento de fundo que usuários não devem invocar diretamente. Padrão: `true`. |261| `user-invocable` | Não | Defina como `false` para ocultar do menu `/`. Use para conhecimento de fundo que usuários não devem invocar diretamente. Padrão: `true`. |

262| `allowed-tools` | Não | Ferramentas que Claude pode usar sem pedir permissão quando esta skill está ativa. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. |262| `allowed-tools` | Não | Ferramentas que Claude pode usar sem pedir permissão quando esta skill está ativa. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. |

263| `disallowed-tools` | Não | Ferramentas removidas do pool disponível de Claude enquanto esta skill está ativa. Use para skills autônomas que nunca devem chamar certas ferramentas, como `AskUserQuestion` para um loop de fundo. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. A restrição é limpa quando você envia sua próxima mensagem. |263| `disallowed-tools` | Não | Ferramentas removidas do pool disponível de Claude enquanto esta skill está ativa. Use para skills autônomas que nunca devem chamar certas ferramentas, como `AskUserQuestion` para um loop de fundo. Aceita uma string separada por espaços ou vírgulas, ou uma lista YAML. A restrição é limpa quando você envia sua próxima mensagem. |

264| `model` | Não | Modelo a usar quando esta skill está ativa. A sobrescrita se aplica pelo resto da volta atual e não é salva em configurações; o modelo de sessão retoma em seu próximo prompt. Aceita os mesmos valores que [`/model`](/pt/model-config), ou `inherit` para manter o modelo ativo. Um valor excluído pela lista de permissão [`availableModels`](/pt/model-config#restrict-model-selection) da sua organização não é usado e a sessão mantém seu modelo atual. |264| `model` | Não | Modelo a usar quando esta skill está ativa. A sobrescrita se aplica pelo resto da volta atual e não é salva em configurações; o modelo de sessão retoma em seu próximo prompt. Aceita os mesmos valores que [`/model`](/docs/pt/model-config), ou `inherit` para manter o modelo ativo. Um valor excluído pela lista de permissão [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização não é usado e a sessão mantém seu modelo atual. |

265| `effort` | Não | [Nível de esforço](/pt/model-config#adjust-effort-level) quando esta skill está ativa. Sobrescreve o nível de esforço da sessão. Padrão: herda da sessão. Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo. |265| `effort` | Não | [Nível de esforço](/docs/pt/model-config#adjust-effort-level) quando esta skill está ativa. Sobrescreve o nível de esforço da sessão. Padrão: herda da sessão. Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo. |

266| `context` | Não | Defina como `fork` para executar em um contexto de subagent bifurcado. |266| `context` | Não | Defina como `fork` para executar em um contexto de subagent bifurcado. |

267| `agent` | Não | Qual tipo de subagent usar quando `context: fork` está definido. |267| `agent` | Não | Qual tipo de subagent usar quando `context: fork` está definido. |

268| `hooks` | Não | Hooks com escopo para o ciclo de vida desta skill. Consulte [Hooks em skills e agents](/pt/hooks#hooks-in-skills-and-agents) para formato de configuração. |268| `hooks` | Não | Hooks com escopo para o ciclo de vida desta skill. Consulte [Hooks em skills e agents](/docs/pt/hooks#hooks-in-skills-and-agents) para formato de configuração. |

269| `paths` | Não | Padrões glob que limitam quando esta skill é ativada. Aceita uma string separada por vírgulas ou uma lista YAML. Quando definido, Claude carrega a skill automaticamente apenas ao trabalhar com arquivos que correspondem aos padrões. Usa o mesmo formato que [regras específicas de caminho](/pt/memory#path-specific-rules). |269| `paths` | Não | Padrões glob que limitam quando esta skill é ativada. Aceita uma string separada por vírgulas ou uma lista YAML. Quando definido, Claude carrega a skill automaticamente apenas ao trabalhar com arquivos que correspondem aos padrões. Usa o mesmo formato que [regras específicas de caminho](/docs/pt/memory#path-specific-rules). |

270| `shell` | Não | Shell a usar para `` !`command` `` e blocos ` ```! ` nesta skill. Aceita `bash` (padrão) ou `powershell`. Definir `powershell` executa comandos shell inline via PowerShell no Windows. Requer `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. |270| `shell` | Não | Shell a usar para `` !`command` `` e blocos ` ```! ` nesta skill. Aceita `bash` (padrão) ou `powershell`. Definir `powershell` executa comandos shell inline via PowerShell no Windows. Requer `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. |

271 271 

272<h4 id="how-a-skill-gets-its-command-name">272<h4 id="how-a-skill-gets-its-command-name">


283| [Diretório `.claude/skills/` aninhado](#where-skills-live), quando o nome entra em conflito com outra skill | Caminho do subdiretório relativo ao diretório de trabalho, depois o nome do diretório de skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |283| [Diretório `.claude/skills/` aninhado](#where-skills-live), quando o nome entra em conflito com outra skill | Caminho do subdiretório relativo ao diretório de trabalho, depois o nome do diretório de skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

284| Arquivo sob `.claude/commands/` | Nome do arquivo sem extensão | `.claude/commands/deploy.md` → `/deploy` |284| Arquivo sob `.claude/commands/` | Nome do arquivo sem extensão | `.claude/commands/deploy.md` → `/deploy` |

285| Subdiretório `skills/` do plugin | Nome do diretório, com namespace pelo plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review` |285| Subdiretório `skills/` do plugin | Nome do diretório, com namespace pelo plugin | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review` |

286| `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`. Consulte [Regras de comportamento de caminho](/pt/plugins-reference#path-behavior-rules) |286| `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`. Consulte [Regras de comportamento de caminho](/docs/pt/plugins-reference#path-behavior-rules) |

287 287 

288O caso raiz do plugin é o único lugar onde `name` define o nome do comando, porque não há diretório de skill para obtê-lo. Se `name` não estiver definido no frontmatter, o nome do diretório do plugin é usado em seu lugar.288O caso raiz do plugin é o único lugar onde `name` define o nome do comando, porque não há diretório de skill para obtê-lo. Se `name` não estiver definido no frontmatter, o nome do diretório do plugin é usado em seu lugar.

289 289 


302| `${CLAUDE_SESSION_ID}` | O ID da sessão atual. Útil para logging, criação de arquivos específicos da sessão, ou correlação de saída de skill com sessões. |302| `${CLAUDE_SESSION_ID}` | O ID da sessão atual. Útil para logging, criação de arquivos específicos da sessão, ou correlação de saída de skill com sessões. |

303| `${CLAUDE_EFFORT}` | O nível de esforço atual: `low`, `medium`, `high`, `xhigh`, ou `max`. Ultracode não é um nível distinto e é relatado como `xhigh`. Use isso para adaptar instruções de skill à configuração de esforço ativo. |303| `${CLAUDE_EFFORT}` | O nível de esforço atual: `low`, `medium`, `high`, `xhigh`, ou `max`. Ultracode não é um nível distinto e é relatado como `xhigh`. Use isso para adaptar instruções de skill à configuração de esforço ativo. |

304| `${CLAUDE_SKILL_DIR}` | O diretório contendo o arquivo `SKILL.md` da skill. Para skills de plugin, este é o subdiretório da skill dentro do plugin, não a raiz do plugin. Use isso em comandos de injeção bash para referenciar scripts ou arquivos agrupados com a skill, independentemente do diretório de trabalho atual. |304| `${CLAUDE_SKILL_DIR}` | O diretório contendo o arquivo `SKILL.md` da skill. Para skills de plugin, este é o subdiretório da skill dentro do plugin, não a raiz do plugin. Use isso em comandos de injeção bash para referenciar scripts ou arquivos agrupados com a skill, independentemente do diretório de trabalho atual. |

305| `${CLAUDE_PROJECT_DIR}` | O diretório raiz do projeto. Este é o mesmo caminho que [hooks](/pt/hooks#reference-scripts-by-path) e servidores MCP recebem como `CLAUDE_PROJECT_DIR`. Use isso para referenciar scripts ou arquivos locais do projeto, como `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, independentemente de onde a skill está instalada. |305| `${CLAUDE_PROJECT_DIR}` | O diretório raiz do projeto. Este é o mesmo caminho que [hooks](/docs/pt/hooks#reference-scripts-by-path) e servidores MCP recebem como `CLAUDE_PROJECT_DIR`. Use isso para referenciar scripts ou arquivos locais do projeto, como `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, independentemente de onde a skill está instalada. |

306 306 

307A substituição `${CLAUDE_PROJECT_DIR}` requer Claude Code v2.1.196 ou posterior. Ela se aplica tanto ao corpo da skill quanto ao frontmatter [`allowed-tools`](#frontmatter-reference), para que uma regra de permissão como `Bash(${CLAUDE_PROJECT_DIR}/scripts/lint.sh *)` se resolva para o mesmo caminho que o corpo da skill usa.307A substituição `${CLAUDE_PROJECT_DIR}` requer Claude Code v2.1.196 ou posterior. Ela se aplica tanto ao corpo da skill quanto ao frontmatter [`allowed-tools`](#frontmatter-reference), para que uma regra de permissão como `Bash(${CLAUDE_PROJECT_DIR}/scripts/lint.sh *)` se resolva para o mesmo caminho que o corpo da skill usa.

308 308 


385| `user-invocable: false` | Não | Sim | Descrição sempre em contexto, skill completa carrega quando invocada |385| `user-invocable: false` | Não | Sim | Descrição sempre em contexto, skill completa carrega quando invocada |

386 386 

387<Note>387<Note>

388 Em uma sessão regular, descrições de skills são carregadas em contexto para que Claude saiba o que está disponível, mas conteúdo completo de skill apenas carrega quando invocado. [Subagents com skills pré-carregadas](/pt/sub-agents#preload-skills-into-subagents) funcionam diferentemente: o conteúdo completo da skill é injetado na inicialização.388 Em uma sessão regular, descrições de skills são carregadas em contexto para que Claude saiba o que está disponível, mas conteúdo completo de skill apenas carrega quando invocado. [Subagents com skills pré-carregadas](/docs/pt/sub-agents#preload-skills-into-subagents) funcionam diferentemente: o conteúdo completo da skill é injetado na inicialização.

389</Note>389</Note>

390 390 

391<h3 id="skill-content-lifecycle">391<h3 id="skill-content-lifecycle">


396 396 

397Quando Claude re-invoca uma skill cujo conteúdo renderizado é idêntico à cópia já em contexto, Claude Code adiciona uma nota breve de que a skill já está carregada em vez de uma segunda cópia do conteúdo. Quando o conteúdo renderizado difere, porque os argumentos mudaram ou um comando de [contexto dinâmico](#inject-dynamic-context) produziu nova saída, Claude Code anexa o conteúdo completo novamente. Antes da v2.1.202, cada re-invocação anexava outra cópia completa das instruções da skill.397Quando Claude re-invoca uma skill cujo conteúdo renderizado é idêntico à cópia já em contexto, Claude Code adiciona uma nota breve de que a skill já está carregada em vez de uma segunda cópia do conteúdo. Quando o conteúdo renderizado difere, porque os argumentos mudaram ou um comando de [contexto dinâmico](#inject-dynamic-context) produziu nova saída, Claude Code anexa o conteúdo completo novamente. Antes da v2.1.202, cada re-invocação anexava outra cópia completa das instruções da skill.

398 398 

399[Auto-compactação](/pt/how-claude-code-works#when-context-fills-up) carrega skills invocadas para frente dentro de um orçamento de token. Quando a conversa é resumida para liberar contexto, Claude Code reanexa a invocação mais recente de cada skill após o resumo, mantendo os primeiros 5.000 tokens de cada. Skills reanexadas compartilham um orçamento combinado de 25.000 tokens. Claude Code preenche este orçamento começando da skill invocada mais recentemente, então skills mais antigas podem ser descartadas inteiramente após compactação se você invocou muitas em uma sessão.399[Auto-compactação](/docs/pt/how-claude-code-works#when-context-fills-up) carrega skills invocadas para frente dentro de um orçamento de token. Quando a conversa é resumida para liberar contexto, Claude Code reanexa a invocação mais recente de cada skill após o resumo, mantendo os primeiros 5.000 tokens de cada. Skills reanexadas compartilham um orçamento combinado de 25.000 tokens. Claude Code preenche este orçamento começando da skill invocada mais recentemente, então skills mais antigas podem ser descartadas inteiramente após compactação se você invocou muitas em uma sessão.

400 400 

401Se uma skill parece parar de influenciar comportamento após a primeira resposta, o conteúdo geralmente ainda está presente e o modelo está escolhendo outras ferramentas ou abordagens. Fortaleça a `description` da skill e instruções para que o modelo continue preferindo-a, ou use [hooks](/pt/hooks) para impor comportamento deterministicamente. Se a skill é grande ou você invocou várias outras depois dela, re-invoque-a após compactação para restaurar o conteúdo completo.401Se uma skill parece parar de influenciar comportamento após a primeira resposta, o conteúdo geralmente ainda está presente e o modelo está escolhendo outras ferramentas ou abordagens. Fortaleça a `description` da skill e instruções para que o modelo continue preferindo-a, ou use [hooks](/docs/pt/hooks) para impor comportamento deterministicamente. Se a skill é grande ou você invocou várias outras depois dela, re-invoque-a após compactação para restaurar o conteúdo completo.

402 402 

403<h3 id="pre-approve-tools-for-a-skill">403<h3 id="pre-approve-tools-for-a-skill">

404 Pré-aprove ferramentas para uma skill404 Pré-aprove ferramentas para uma skill

405</h3>405</h3>

406 406 

407O campo `allowed-tools` concede permissão para as ferramentas listadas enquanto a skill está ativa, para que Claude possa usá-las sem solicitar sua aprovação. Ele não restringe quais ferramentas estão disponíveis: cada ferramenta permanece chamável, e suas [configurações de permissão](/pt/permissions) ainda governam ferramentas que não estão listadas.407O campo `allowed-tools` concede permissão para as ferramentas listadas enquanto a skill está ativa, para que Claude possa usá-las sem solicitar sua aprovação. Ele não restringe quais ferramentas estão disponíveis: cada ferramenta permanece chamável, e suas [configurações de permissão](/docs/pt/permissions) ainda governam ferramentas que não estão listadas.

408 408 

409Para skills verificadas em um diretório `.claude/skills/` de um projeto, `allowed-tools` entra em vigor após você aceitar o diálogo de confiança do workspace para essa pasta, o mesmo que regras de permissão em `.claude/settings.json`. Revise skills de projeto antes de confiar em um repositório, já que uma skill pode conceder a si mesma acesso amplo a ferramentas.409Para skills verificadas em um diretório `.claude/skills/` de um projeto, `allowed-tools` entra em vigor após você aceitar o diálogo de confiança do workspace para essa pasta, o mesmo que regras de permissão em `.claude/settings.json`. Revise skills de projeto antes de confiar em um repositório, já que uma skill pode conceder a si mesma acesso amplo a ferramentas.

410 410 


419---419---

420```420```

421 421 

422Para remover ferramentas do pool disponível de Claude enquanto uma skill está ativa, liste-as em `disallowed-tools` no frontmatter da skill. A restrição é limpa quando você envia sua próxima mensagem. Para bloquear ferramentas em todas as skills e prompts, adicione regras de negação em suas [configurações de permissão](/pt/permissions).422Para remover ferramentas do pool disponível de Claude enquanto uma skill está ativa, liste-as em `disallowed-tools` no frontmatter da skill. A restrição é limpa quando você envia sua próxima mensagem. Para bloquear ferramentas em todas as skills e prompts, adicione regras de negação em suas [configurações de permissão](/docs/pt/permissions).

423 423 

424<h3 id="pass-arguments-to-skills">424<h3 id="pass-arguments-to-skills">

425 Passe argumentos para skills425 Passe argumentos para skills


530```530```

531````531````

532 532 

533Para desabilitar este comportamento para skills e comandos personalizados de fontes de usuário, projeto, plugin ou [diretório adicional](#skills-from-additional-directories), defina `"disableSkillShellExecution": true` em [configurações](/pt/settings). Cada comando é substituído com `[shell command execution disabled by policy]` em vez de ser executado. Skills agrupadas e gerenciadas não são afetadas. Esta configuração é mais útil em [configurações gerenciadas](/pt/permissions#managed-settings), onde usuários não podem sobrescrevê-la.533Para desabilitar este comportamento para skills e comandos personalizados de fontes de usuário, projeto, plugin ou [diretório adicional](#skills-from-additional-directories), defina `"disableSkillShellExecution": true` em [configurações](/docs/pt/settings). Cada comando é substituído com `[shell command execution disabled by policy]` em vez de ser executado. Skills agrupadas e gerenciadas não são afetadas. Esta configuração é mais útil em [configurações gerenciadas](/docs/pt/permissions#managed-settings), onde usuários não podem sobrescrevê-la.

534 534 

535<Tip>535<Tip>

536 Para solicitar raciocínio mais profundo quando uma skill é executada, inclua `ultrathink` em qualquer lugar no conteúdo da skill. Consulte [Use ultrathink for one-off deep reasoning](/pt/model-config#use-ultrathink-for-one-off-deep-reasoning).536 Para solicitar raciocínio mais profundo quando uma skill é executada, inclua `ultrathink` em qualquer lugar no conteúdo da skill. Consulte [Use ultrathink for one-off deep reasoning](/docs/pt/model-config#use-ultrathink-for-one-off-deep-reasoning).

537</Tip>537</Tip>

538 538 

539<h3 id="run-skills-in-a-subagent">539<h3 id="run-skills-in-a-subagent">


546 `context: fork` apenas faz sentido para skills com instruções explícitas. Se sua skill contém diretrizes como "use estas convenções de API" sem uma tarefa, o subagent recebe as diretrizes mas nenhum prompt acionável, e retorna sem saída significativa.546 `context: fork` apenas faz sentido para skills com instruções explícitas. Se sua skill contém diretrizes como "use estas convenções de API" sem uma tarefa, o subagent recebe as diretrizes mas nenhum prompt acionável, e retorna sem saída significativa.

547</Warning>547</Warning>

548 548 

549Skills e [subagents](/pt/sub-agents) trabalham juntos em duas direções:549Skills e [subagents](/docs/pt/sub-agents) trabalham juntos em duas direções:

550 550 

551| Abordagem | Prompt do sistema | Tarefa | Também carrega |551| Abordagem | Prompt do sistema | Tarefa | Também carrega |

552| :-------------------------- | :------------------------- | :------------------------------ | :------------------------------------------------- |552| :-------------------------- | :------------------------- | :------------------------------ | :------------------------------------------------- |

553| Skill com `context: fork` | Do tipo de agent | Conteúdo de SKILL.md | CLAUDE.md, exceto quando o agent é Explore ou Plan |553| Skill com `context: fork` | Do tipo de agent | Conteúdo de SKILL.md | CLAUDE.md, exceto quando o agent é Explore ou Plan |

554| Subagent com campo `skills` | Corpo markdown do subagent | Mensagem de delegação do Claude | Skills pré-carregadas + CLAUDE.md |554| Subagent com campo `skills` | Corpo markdown do subagent | Mensagem de delegação do Claude | Skills pré-carregadas + CLAUDE.md |

555 555 

556Com `context: fork`, você escreve a tarefa em sua skill e escolhe um tipo de agent para executá-la. Os agents integrados Explore e Plan [pulam CLAUDE.md e git status](/pt/sub-agents#what-loads-at-startup) para manter seu contexto pequeno, portanto uma skill bifurcada usando `agent: Explore` vê apenas o conteúdo de SKILL.md e o prompt do sistema do próprio agent. Para o inverso, onde você define um subagent personalizado que usa skills como material de referência, consulte [Subagents](/pt/sub-agents#preload-skills-into-subagents).556Com `context: fork`, você escreve a tarefa em sua skill e escolhe um tipo de agent para executá-la. Os agents integrados Explore e Plan [pulam CLAUDE.md e git status](/docs/pt/sub-agents#what-loads-at-startup) para manter seu contexto pequeno, portanto uma skill bifurcada usando `agent: Explore` vê apenas o conteúdo de SKILL.md e o prompt do sistema do próprio agent. Para o inverso, onde você define um subagent personalizado que usa skills como material de referência, consulte [Subagents](/docs/pt/sub-agents#preload-skills-into-subagents).

557 557 

558<h4 id="example-research-skill-using-explore-agent">558<h4 id="example-research-skill-using-explore-agent">

559 Exemplo: Skill de pesquisa usando agent Explore559 Exemplo: Skill de pesquisa usando agent Explore


589 Restrinja acesso de skill do Claude589 Restrinja acesso de skill do Claude

590</h3>590</h3>

591 591 

592Por padrão, Claude pode invocar qualquer skill que não tenha `disable-model-invocation: true` definido. Skills que definem `allowed-tools` concedem a Claude acesso a essas ferramentas sem aprovação por uso quando a skill está ativa. Suas [configurações de permissão](/pt/permissions) ainda governam comportamento de aprovação de linha de base para todas as outras ferramentas. Alguns comandos integrados também estão disponíveis através da ferramenta Skill, incluindo `/init`, `/review`, e `/security-review`. Outros comandos integrados como `/compact` não estão.592Por padrão, Claude pode invocar qualquer skill que não tenha `disable-model-invocation: true` definido. Skills que definem `allowed-tools` concedem a Claude acesso a essas ferramentas sem aprovação por uso quando a skill está ativa. Suas [configurações de permissão](/docs/pt/permissions) ainda governam comportamento de aprovação de linha de base para todas as outras ferramentas. Alguns comandos integrados também estão disponíveis através da ferramenta Skill, incluindo `/init`, `/review`, e `/security-review`. Outros comandos integrados como `/compact` não estão.

593 593 

594Três formas de controlar quais skills Claude pode invocar:594Três formas de controlar quais skills Claude pode invocar:

595 595 


600Skill600Skill

601```601```

602 602 

603**Permita ou negue skills específicas** usando [regras de permissão](/pt/permissions):603**Permita ou negue skills específicas** usando [regras de permissão](/docs/pt/permissions):

604 604 

605```text theme={null}605```text theme={null}

606# Allow only specific skills606# Allow only specific skills


623 Substitua visibilidade de skill a partir de configurações623 Substitua visibilidade de skill a partir de configurações

624</h3>624</h3>

625 625 

626A configuração `skillOverrides` controla visibilidade de skill a partir de suas [configurações](/pt/settings) em vez do frontmatter da própria skill. Use-a para skills cujo SKILL.md você não quer editar, como aquelas verificadas em um repositório de projeto compartilhado ou fornecidas por um servidor MCP. O menu `/skills` escreve para você: destaque uma skill e pressione `Space` para alternar estados, depois `Enter` para salvar em `.claude/settings.local.json`.626A configuração `skillOverrides` controla visibilidade de skill a partir de suas [configurações](/docs/pt/settings) em vez do frontmatter da própria skill. Use-a para skills cujo SKILL.md você não quer editar, como aquelas verificadas em um repositório de projeto compartilhado ou fornecidas por um servidor MCP. O menu `/skills` escreve para você: destaque uma skill e pressione `Space` para alternar estados, depois `Enter` para salvar em `.claude/settings.local.json`.

627 627 

628Cada chave é um nome de skill e cada valor é um de quatro estados:628Cada chave é um nome de skill e cada valor é um de quatro estados:

629 629 


634| `"user-invocable-only"` | Oculto | Sim |634| `"user-invocable-only"` | Oculto | Sim |

635| `"off"` | Oculto | Oculto |635| `"off"` | Oculto | Oculto |

636 636 

637A partir da v2.1.199, `"off"` também oculta a skill das listas de comandos anunciadas para clientes [Remote Control](/pt/remote-control) e para chamadores [Agent SDK](/pt/agent-sdk/slash-commands), não apenas o menu `/` do terminal. Invocar uma skill oculta pelo seu nome completo ainda retorna o erro `skillOverrides` em vez de executá-la.637A partir da v2.1.199, `"off"` também oculta a skill das listas de comandos anunciadas para clientes [Remote Control](/docs/pt/remote-control) e para chamadores [Agent SDK](/docs/pt/agent-sdk/slash-commands), não apenas o menu `/` do terminal. Invocar uma skill oculta pelo seu nome completo ainda retorna o erro `skillOverrides` em vez de executá-la.

638 638 

639Uma skill que está ausente de `skillOverrides` é tratada como `"on"`. O exemplo abaixo colapsa uma skill para seu nome e desativa outra inteiramente:639Uma skill que está ausente de `skillOverrides` é tratada como `"on"`. O exemplo abaixo colapsa uma skill para seu nome e desativa outra inteiramente:

640 640 


672Após instalar, execute `/reload-plugins` para tornar as skills do plugin disponíveis na sessão atual. Depois peça ao Claude para avaliar uma skill existente, por exemplo `evaluate my summarize-changes skill with skill-creator`. O plugin o guia através da escrita de casos de teste e executa o loop:672Após instalar, execute `/reload-plugins` para tornar as skills do plugin disponíveis na sessão atual. Depois peça ao Claude para avaliar uma skill existente, por exemplo `evaluate my summarize-changes skill with skill-creator`. O plugin o guia através da escrita de casos de teste e executa o loop:

673 673 

674* **Casos de teste**: armazena prompts, arquivos de entrada e comportamento esperado em `evals/evals.json` dentro do diretório da skill674* **Casos de teste**: armazena prompts, arquivos de entrada e comportamento esperado em `evals/evals.json` dentro do diretório da skill

675* **Execuções isoladas**: gera um [subagent](/pt/sub-agents) por caso de teste para que cada execução comece com um contexto limpo, e registra contagem de token e duração675* **Execuções isoladas**: gera um [subagent](/docs/pt/sub-agents) por caso de teste para que cada execução comece com um contexto limpo, e registra contagem de token e duração

676* **Classificação**: verifica cada asserção contra a saída e escreve passar ou falhar com evidência para `grading.json`676* **Classificação**: verifica cada asserção contra a saída e escreve passar ou falhar com evidência para `grading.json`

677* **Benchmark**: agrega taxa de aprovação, tempo e tokens para com-skill versus sem-skill em `benchmark.json` para que você possa comparar a melhoria de taxa de aprovação contra a sobrecarga de token e tempo677* **Benchmark**: agrega taxa de aprovação, tempo e tokens para com-skill versus sem-skill em `benchmark.json` para que você possa comparar a melhoria de taxa de aprovação contra a sobrecarga de token e tempo

678* **Comparação de versão**: executa um cego A/B entre duas versões da skill para que você possa confirmar que uma edição é uma melhoria antes de confirmá-la678* **Comparação de versão**: executa um cego A/B entre duas versões da skill para que você possa confirmar que uma edição é uma melhoria antes de confirmá-la


688Skills podem ser distribuídas em diferentes escopos dependendo do seu público:688Skills podem ser distribuídas em diferentes escopos dependendo do seu público:

689 689 

690* **Skills de projeto**: Faça commit de `.claude/skills/` para controle de versão690* **Skills de projeto**: Faça commit de `.claude/skills/` para controle de versão

691* **Plugins**: Crie um diretório `skills/` em seu [plugin](/pt/plugins)691* **Plugins**: Crie um diretório `skills/` em seu [plugin](/docs/pt/plugins)

692* **Gerenciado**: Implante em toda a organização através de [configurações gerenciadas](/pt/settings#settings-files)692* **Gerenciado**: Implante em toda a organização através de [configurações gerenciadas](/docs/pt/settings#settings-files)

693 693 

694<h3 id="generate-visual-output">694<h3 id="generate-visual-output">

695 Gere saída visual695 Gere saída visual


916 916 

917Claude Code carrega uma listagem de nomes de skills e descrições em contexto para que Claude saiba o que está disponível. A listagem sempre contém todos os nomes de skills, mas se você tem muitas skills, Claude Code encurta as descrições para caber no orçamento de caracteres da listagem, o que pode remover as palavras-chave que Claude precisa para corresponder sua solicitação. O orçamento escala em 1% da janela de contexto do modelo. Quando a listagem transborda, Claude Code remove descrições começando com as skills que você invoca menos, então as skills que você usa mais mantêm seu texto completo.917Claude Code carrega uma listagem de nomes de skills e descrições em contexto para que Claude saiba o que está disponível. A listagem sempre contém todos os nomes de skills, mas se você tem muitas skills, Claude Code encurta as descrições para caber no orçamento de caracteres da listagem, o que pode remover as palavras-chave que Claude precisa para corresponder sua solicitação. O orçamento escala em 1% da janela de contexto do modelo. Quando a listagem transborda, Claude Code remove descrições começando com as skills que você invoca menos, então as skills que você usa mais mantêm seu texto completo.

918 918 

919Execute `/doctor` para uma estimativa do custo de contexto da listagem e seus maiores contribuidores. Quando a listagem excede seu orçamento, Claude Code também escreve um aviso para o log de debug, visível com [`--debug`](/pt/cli-reference#cli-flags).919Execute `/doctor` para uma estimativa do custo de contexto da listagem e seus maiores contribuidores. Quando a listagem excede seu orçamento, Claude Code também escreve um aviso para o log de debug, visível com [`--debug`](/docs/pt/cli-reference#cli-flags).

920 920 

921A linha Skills em `/context` relata o tamanho da listagem após o orçamento ser aplicado, então corresponde ao que o modelo recebe. Antes da v2.1.196, a linha contava o texto completo de cada descrição e poderia mostrar um valor várias vezes maior do que o orçamento configurado.921A linha Skills em `/context` relata o tamanho da listagem após o orçamento ser aplicado, então corresponde ao que o modelo recebe. Antes da v2.1.196, a linha contava o texto completo de cada descrição e poderia mostrar um valor várias vezes maior do que o orçamento configurado.

922 922 

923Para aumentar o orçamento, defina a configuração [`skillListingBudgetFraction`](/pt/settings#available-settings) (por exemplo, `0.02` = 2%) ou a variável de ambiente `SLASH_COMMAND_TOOL_CHAR_BUDGET` para uma contagem de caracteres fixa. Para liberar orçamento para outras skills, defina entradas de baixa prioridade como `"name-only"` em [`skillOverrides`](#override-skill-visibility-from-settings) para que sejam listadas sem uma descrição. Você também pode aparar o texto de `description` e `when_to_use` na fonte: coloque o caso de uso principal na frente, já que o texto combinado de cada entrada é limitado a 1.536 caracteres independentemente do orçamento. O limite é configurável com [`skillListingMaxDescChars`](/pt/settings#available-settings).923Para aumentar o orçamento, defina a configuração [`skillListingBudgetFraction`](/docs/pt/settings#available-settings) (por exemplo, `0.02` = 2%) ou a variável de ambiente `SLASH_COMMAND_TOOL_CHAR_BUDGET` para uma contagem de caracteres fixa. Para liberar orçamento para outras skills, defina entradas de baixa prioridade como `"name-only"` em [`skillOverrides`](#override-skill-visibility-from-settings) para que sejam listadas sem uma descrição. Você também pode aparar o texto de `description` e `when_to_use` na fonte: coloque o caso de uso principal na frente, já que o texto combinado de cada entrada é limitado a 1.536 caracteres independentemente do orçamento. O limite é configurável com [`skillListingMaxDescChars`](/docs/pt/settings#available-settings).

924 924 

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

926 Recursos relacionados926 Recursos relacionados

927</h2>927</h2>

928 928 

929* **[Depure sua configuração](/pt/debug-your-config)**: diagnostique por que uma skill não está aparecendo ou sendo acionada929* **[Depure sua configuração](/docs/pt/debug-your-config)**: diagnostique por que uma skill não está aparecendo ou sendo acionada

930* **[Avaliando a qualidade de saída de skill](https://agentskills.io/skill-creation/evaluating-skills)**: o formato do arquivo eval e fluxo de trabalho de iteração em agentskills.io930* **[Avaliando a qualidade de saída de skill](https://agentskills.io/skill-creation/evaluating-skills)**: o formato do arquivo eval e fluxo de trabalho de iteração em agentskills.io

931* **[Melhores práticas de autoria de skill](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: orientação de escrita que se aplica em produtos Claude931* **[Melhores práticas de autoria de skill](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: orientação de escrita que se aplica em produtos Claude

932* **[Subagents](/pt/sub-agents)**: delegue tarefas para agents especializados932* **[Subagents](/docs/pt/sub-agents)**: delegue tarefas para agents especializados

933* **[Plugins](/pt/plugins)**: empacote e distribua skills com outras extensões933* **[Plugins](/docs/pt/plugins)**: empacote e distribua skills com outras extensões

934* **[Hooks](/pt/hooks)**: automatize fluxos de trabalho em torno de eventos de ferramentas934* **[Hooks](/docs/pt/hooks)**: automatize fluxos de trabalho em torno de eventos de ferramentas

935* **[Memory](/pt/memory)**: gerencie arquivos CLAUDE.md para contexto persistente935* **[Memory](/docs/pt/memory)**: gerencie arquivos CLAUDE.md para contexto persistente

936* **[Comandos](/pt/commands)**: referência para comandos integrados e skills agrupadas936* **[Comandos](/docs/pt/commands)**: referência para comandos integrados e skills agrupadas

937* **[Permissões](/pt/permissions)**: controle acesso a ferramentas e skills937* **[Permissões](/docs/pt/permissions)**: controle acesso a ferramentas e skills

938* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: skills de projeto confirmadas em um repositório também são carregadas quando esse repositório é usado em um canal Claude Tag938* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: skills de projeto confirmadas em um repositório também são carregadas quando esse repositório é usado em um canal Claude Tag

statusline.md +10 −10

Details

15* Trabalha em várias sessões e precisa distingui-las15* Trabalha em várias sessões e precisa distingui-las

16* Quer que a ramificação git e o status estejam sempre visíveis16* Quer que a ramificação git e o status estejam sempre visíveis

17 17 

18A linha de status é renderizada em sua própria linha acima dos crachás de rodapé integrados e não os substitui. Para adicionar crachás de links clicáveis ao rodapé quando uma ID aparece na conversa, sem escrever um script, configure [`footerLinksRegexes`](/pt/settings#footer-link-badges) em vez disso.18A linha de status é renderizada em sua própria linha acima dos crachás de rodapé integrados e não os substitui. Para adicionar crachás de links clicáveis ao rodapé quando uma ID aparece na conversa, sem escrever um script, configure [`footerLinksRegexes`](/docs/pt/settings#footer-link-badges) em vez disso.

19 19 

20Aqui está um exemplo de uma [linha de status de múltiplas linhas](#display-multiple-lines) que exibe informações do git na primeira linha e uma barra de contexto codificada por cores na segunda.20Aqui está um exemplo de uma [linha de status de múltiplas linhas](#display-multiple-lines) que exibe informações do git na primeira linha e uma barra de contexto codificada por cores na segunda.

21 21 


45 Configure manualmente uma linha de status45 Configure manualmente uma linha de status

46</h3>46</h3>

47 47 

48Adicione um campo `statusLine` às suas configurações de usuário (`~/.claude/settings.json`, onde `~` é seu diretório inicial) ou [configurações de projeto](/pt/settings#settings-files). Defina `type` como `"command"` e aponte `command` para um caminho de script ou um comando de shell inline. Para um passo a passo completo de criação de um script, consulte [Construir uma linha de status passo a passo](#build-a-status-line-step-by-step).48Adicione um campo `statusLine` às suas configurações de usuário (`~/.claude/settings.json`, onde `~` é seu diretório inicial) ou [configurações de projeto](/docs/pt/settings#settings-files). Defina `type` como `"command"` e aponte `command` para um caminho de script ou um comando de shell inline. Para um passo a passo completo de criação de um script, consulte [Construir uma linha de status passo a passo](#build-a-status-line-step-by-step).

49 49 

50```json theme={null}50```json theme={null}

51{51{


160 160 

161**Dimensionando a saída para o terminal**161**Dimensionando a saída para o terminal**

162 162 

163O Claude Code captura a saída do seu script em vez de conectá-la diretamente ao terminal, portanto `tput cols` e a detecção de largura em nível de linguagem não podem ler o tamanho do terminal de dentro do script. {/* min-version: 2.1.153 */}Leia as variáveis de ambiente `COLUMNS` e `LINES` em vez disso. O Claude Code define estas variáveis para as dimensões atuais do terminal antes de executar seu script. Requer Claude Code v2.1.153 ou posterior.163O Claude Code captura a saída do seu script em vez de conectá-la diretamente ao terminal, portanto `tput cols` e a detecção de largura em nível de linguagem não podem ler o tamanho do terminal de dentro do script. Leia as variáveis de ambiente `COLUMNS` e `LINES` em vez disso. O Claude Code define estas variáveis para as dimensões atuais do terminal antes de executar seu script. Requer Claude Code v2.1.153 ou posterior.

164 164 

165<Note>A linha de status é executada localmente e não consome tokens de API. Ela se oculta temporariamente durante certas interações da interface, incluindo sugestões de preenchimento automático, o menu de ajuda e prompts de permissão.</Note>165<Note>A linha de status é executada localmente e não consome tokens de API. Ela se oculta temporariamente durante certas interações da interface, incluindo sugestões de preenchimento automático, o menu de ajuda e prompts de permissão.</Note>

166 166 


182| `cost.total_duration_ms` | Tempo total decorrido desde o início da sessão, em milissegundos |182| `cost.total_duration_ms` | Tempo total decorrido desde o início da sessão, em milissegundos |

183| `cost.total_api_duration_ms` | Tempo total gasto aguardando respostas de API em milissegundos |183| `cost.total_api_duration_ms` | Tempo total gasto aguardando respostas de API em milissegundos |

184| `cost.total_lines_added`, `cost.total_lines_removed` | Linhas de código alteradas |184| `cost.total_lines_added`, `cost.total_lines_removed` | Linhas de código alteradas |

185| `context_window.total_input_tokens`, `context_window.total_output_tokens` | Contagens de tokens atualmente na janela de contexto, da resposta de API mais recente. A entrada inclui leituras e escritas de cache. {/* min-version: 2.1.132 */}Antes da v2.1.132, estas eram totais cumulativos de sessão |185| `context_window.total_input_tokens`, `context_window.total_output_tokens` | Contagens de tokens atualmente na janela de contexto, da resposta de API mais recente. A entrada inclui leituras e escritas de cache. Antes da v2.1.132, estas eram totais cumulativos de sessão |

186| `context_window.context_window_size` | Tamanho máximo da janela de contexto em tokens. 200000 por padrão, ou 1000000 para modelos com contexto estendido. |186| `context_window.context_window_size` | Tamanho máximo da janela de contexto em tokens. 200000 por padrão, ou 1000000 para modelos com contexto estendido. |

187| `context_window.used_percentage` | Porcentagem pré-calculada da janela de contexto usada |187| `context_window.used_percentage` | Porcentagem pré-calculada da janela de contexto usada |

188| `context_window.remaining_percentage` | Porcentagem pré-calculada da janela de contexto restante |188| `context_window.remaining_percentage` | Porcentagem pré-calculada da janela de contexto restante |


194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Segundos de época Unix quando a janela de limite de taxa de 5 horas ou 7 dias é redefinida |194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Segundos de época Unix quando a janela de limite de taxa de 5 horas ou 7 dias é redefinida |

195| `session_id` | Identificador único de sessão |195| `session_id` | Identificador único de sessão |

196| `session_name` | Nome de sessão personalizado definido com a flag `--name` ou `/rename`. Ausente se nenhum nome personalizado foi definido |196| `session_name` | Nome de sessão personalizado definido com a flag `--name` ou `/rename`. Ausente se nenhum nome personalizado foi definido |

197| `prompt_id` | UUID identificando o prompt do usuário sendo processado no momento. Corresponde ao atributo [`prompt.id` em eventos OpenTelemetry](/pt/monitoring-usage#event-correlation-attributes). Ausente até a primeira entrada do usuário. {/* min-version: 2.1.196 */}Requer Claude Code v2.1.196 ou posterior |197| `prompt_id` | UUID identificando o prompt do usuário sendo processado no momento. Corresponde ao atributo [`prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes). Ausente até a primeira entrada do usuário. Requer Claude Code v2.1.196 ou posterior |

198| `transcript_path` | Caminho para o arquivo de transcrição de conversa |198| `transcript_path` | Caminho para o arquivo de transcrição de conversa |

199| `version` | Versão do Claude Code |199| `version` | Versão do Claude Code |

200| `output_style.name` | Nome do estilo de saída atual |200| `output_style.name` | Nome do estilo de saída atual |

201| `vim.mode` | Modo vim atual (`NORMAL`, `INSERT`, `VISUAL` ou `VISUAL LINE`) quando [modo vim](/pt/interactive-mode#vim-editor-mode) está habilitado |201| `vim.mode` | Modo vim atual (`NORMAL`, `INSERT`, `VISUAL` ou `VISUAL LINE`) quando [modo vim](/docs/pt/interactive-mode#vim-editor-mode) está habilitado |

202| `agent.name` | Nome do agente ao executar com a flag `--agent` ou configurações de agente configuradas |202| `agent.name` | Nome do agente ao executar com a flag `--agent` ou configurações de agente configuradas |

203| `pr.number`, `pr.url` | Solicitação de pull aberta para o branch atual. Espelha o badge de PR na barra de status inferior. Ausente até que um PR seja encontrado, quando não em um repositório git, ou uma vez que o PR seja mesclado ou fechado |203| `pr.number`, `pr.url` | Solicitação de pull aberta para o branch atual. Espelha o badge de PR na barra de status inferior. Ausente até que um PR seja encontrado, quando não em um repositório git, ou uma vez que o PR seja mesclado ou fechado |

204| `pr.review_state` | Status de revisão do PR aberto: `approved`, `pending`, `changes_requested` ou `draft`. Pode estar independentemente ausente mesmo quando `pr` está presente |204| `pr.review_state` | Status de revisão do PR aberto: `approved`, `pending`, `changes_requested` ou `draft`. Pode estar independentemente ausente mesmo quando `pr` está presente |


332* `cache_creation_input_tokens`: tokens escritos no cache332* `cache_creation_input_tokens`: tokens escritos no cache

333* `cache_read_input_tokens`: tokens lidos do cache333* `cache_read_input_tokens`: tokens lidos do cache

334 334 

335Para o que os campos de cache significam e como são cobrados, consulte [verificar desempenho do cache](/pt/prompt-caching#check-cache-performance).335Para o que os campos de cache significam e como são cobrados, consulte [verificar desempenho do cache](/docs/pt/prompt-caching#check-cache-performance).

336 336 

337O campo `used_percentage` é calculado apenas a partir de tokens de entrada: `input_tokens + cache_creation_input_tokens + cache_read_input_tokens`. Ele não inclui `output_tokens`.337O campo `used_percentage` é calculado apenas a partir de tokens de entrada: `input_tokens + cache_creation_input_tokens + cache_read_input_tokens`. Ele não inclui `output_tokens`.

338 338 


1033 Linhas de status de subagente1033 Linhas de status de subagente

1034</h2>1034</h2>

1035 1035 

1036A configuração `subagentStatusLine` renderiza um corpo de linha personalizado para cada [subagente](/pt/sub-agents) mostrado no painel de agente abaixo do prompt. Use-a para substituir a linha padrão `name · description · token count` pela sua própria formatação.1036A configuração `subagentStatusLine` renderiza um corpo de linha personalizado para cada [subagente](/docs/pt/sub-agents) mostrado no painel de agente abaixo do prompt. Use-a para substituir a linha padrão `name · description · token count` pela sua própria formatação.

1037 1037 

1038```json theme={null}1038```json theme={null}

1039{1039{


1044}1044}

1045```1045```

1046 1046 

1047O comando é executado uma vez por tick de atualização com todas as linhas de subagente visíveis passadas como um único objeto JSON em stdin. A entrada inclui os [campos de hook base](/pt/hooks#common-input-fields), um campo `columns` com a largura de linha utilizável e um array `tasks`. Cada tarefa tem `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` e `cwd`.1047O comando é executado uma vez por tick de atualização com todas as linhas de subagente visíveis passadas como um único objeto JSON em stdin. A entrada inclui os [campos de hook base](/docs/pt/hooks#common-input-fields), um campo `columns` com a largura de linha utilizável e um array `tasks`. Cada tarefa tem `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` e `cwd`.

1048 1048 

1049O campo `model` por tarefa é o ID do modelo resolvido em que a tarefa é executada. `contextWindowSize` é a janela de contexto desse modelo em tokens, calculada da mesma forma que a `context_window.context_window_size` da linha de status principal, para que você possa renderizar uma porcentagem por linha a partir de `tokenCount`. Ambos os campos exigem Claude Code v2.1.205 ou posterior e são omitidos para uma tarefa cujo modelo ainda não foi resolvido.1049O campo `model` por tarefa é o ID do modelo resolvido em que a tarefa é executada. `contextWindowSize` é a janela de contexto desse modelo em tokens, calculada da mesma forma que a `context_window.context_window_size` da linha de status principal, para que você possa renderizar uma porcentagem por linha a partir de `tokenCount`. Ambos os campos exigem Claude Code v2.1.205 ou posterior e são omitidos para uma tarefa cujo modelo ainda não foi resolvido.

1050 1050 

1051Escreva uma linha JSON para stdout por linha que você queira substituir, na forma `{"id": "<task id>", "content": "<row body>"}`. A string `content` é renderizada como está, incluindo cores ANSI e hiperlinks OSC 8. Omita o `id` de uma tarefa para manter a renderização padrão para essa linha; emita uma string `content` vazia para ocultá-la.1051Escreva uma linha JSON para stdout por linha que você queira substituir, na forma `{"id": "<task id>", "content": "<row body>"}`. A string `content` é renderizada como está, incluindo cores ANSI e hiperlinks OSC 8. Omita o `id` de uma tarefa para manter a renderização padrão para essa linha; emita uma string `content` vazia para ocultá-la.

1052 1052 

1053Os mesmos portões de confiança e `disableAllHooks` que se aplicam a `statusLine` se aplicam aqui. Plugins podem enviar um `subagentStatusLine` padrão em seu [`settings.json`](/pt/plugins-reference#standard-plugin-layout).1053Os mesmos portões de confiança e `disableAllHooks` que se aplicam a `statusLine` se aplicam aqui. Plugins podem enviar um `subagentStatusLine` padrão em seu [`settings.json`](/docs/pt/plugins-reference#standard-plugin-layout).

1054 1054 

1055<h2 id="tips">1055<h2 id="tips">

1056 Dicas1056 Dicas

sub-agents.md +87 −87

Details

8 8 

9Subagentes são assistentes de IA especializados que lidam com tipos específicos de tarefas. Use um quando uma tarefa secundária inundaria sua conversa principal com resultados de pesquisa, logs ou conteúdos de arquivo que você não referenciará novamente: o subagente faz esse trabalho em seu próprio contexto e retorna apenas o resumo. Defina um subagente personalizado quando você continua gerando o mesmo tipo de worker com as mesmas instruções.9Subagentes são assistentes de IA especializados que lidam com tipos específicos de tarefas. Use um quando uma tarefa secundária inundaria sua conversa principal com resultados de pesquisa, logs ou conteúdos de arquivo que você não referenciará novamente: o subagente faz esse trabalho em seu próprio contexto e retorna apenas o resumo. Defina um subagente personalizado quando você continua gerando o mesmo tipo de worker com as mesmas instruções.

10 10 

11Cada subagente é executado em sua própria janela de contexto com um prompt de sistema personalizado, acesso a ferramentas específicas e permissões independentes. Quando Claude encontra uma tarefa que corresponde à descrição de um subagente, ele delega para esse subagente, que funciona independentemente e retorna resultados. Para ver a economia de contexto na prática, a [visualização da janela de contexto](/pt/context-window) apresenta uma sessão onde um subagente lida com pesquisa em sua própria janela separada.11Cada subagente é executado em sua própria janela de contexto com um prompt de sistema personalizado, acesso a ferramentas específicas e permissões independentes. Quando Claude encontra uma tarefa que corresponde à descrição de um subagente, ele delega para esse subagente, que funciona independentemente e retorna resultados. Para ver a economia de contexto na prática, a [visualização da janela de contexto](/docs/pt/context-window) apresenta uma sessão onde um subagente lida com pesquisa em sua própria janela separada.

12 12 

13<Note>13<Note>

14 Subagentes funcionam dentro de uma única sessão. Para executar muitas sessões independentes em paralelo e monitorá-las de um único lugar, consulte [agentes em segundo plano](/pt/agent-view). Para sessões que se comunicam entre si, consulte [equipes de agentes](/pt/agent-teams).14 Subagentes funcionam dentro de uma única sessão. Para executar muitas sessões independentes em paralelo e monitorá-las de um único lugar, consulte [agentes em segundo plano](/docs/pt/agent-view). Para sessões que se comunicam entre si, consulte [equipes de agentes](/docs/pt/agent-teams).

15</Note>15</Note>

16 16 

17Subagentes ajudam você a:17Subagentes ajudam você a:


42 * **Tools**: ferramentas somente leitura; Write e Edit são negados42 * **Tools**: ferramentas somente leitura; Write e Edit são negados

43 * **Purpose**: descoberta de arquivos, pesquisa de código, exploração de base de código43 * **Purpose**: descoberta de arquivos, pesquisa de código, exploração de base de código

44 44 

45 {/* min-version: 2.1.198 */}A partir da v2.1.198, Explore herda o modelo da conversa principal em vez de sempre ser executado em Haiku. Na Claude API, o modelo herdado é limitado a Opus: uma conversa principal em um nível superior executa Explore em Opus, e uma conversa principal em Sonnet ou Haiku executa Explore nesse mesmo modelo. Em qualquer outro provedor, como [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou Claude Platform on AWS](/pt/third-party-integrations), Explore herda o modelo da conversa principal diretamente.45 A partir da v2.1.198, Explore herda o modelo da conversa principal em vez de sempre ser executado em Haiku. Na Claude API, o modelo herdado é limitado a Opus: uma conversa principal em um nível superior executa Explore em Opus, e uma conversa principal em Sonnet ou Haiku executa Explore nesse mesmo modelo. Em qualquer outro provedor, como [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou Claude Platform on AWS](/docs/pt/third-party-integrations), Explore herda o modelo da conversa principal diretamente.

46 46 

47 Um [subagente de usuário ou projeto](#choose-the-subagent-scope) nomeado `Explore` substitui o integrado e mantém seu próprio campo `model`, portanto defina um com `model: haiku` para manter a exploração em um modelo de menor custo.47 Um [subagente de usuário ou projeto](#choose-the-subagent-scope) nomeado `Explore` substitui o integrado e mantém seu próprio campo `model`, portanto defina um com `model: haiku` para manter a exploração em um modelo de menor custo.

48 48 


52 </Tab>52 </Tab>

53 53 

54 <Tab title="Plan">54 <Tab title="Plan">

55 Um agente de pesquisa usado durante [plan mode](/pt/permission-modes#analyze-before-you-edit-with-plan-mode) para reunir contexto antes de apresentar um plano.55 Um agente de pesquisa usado durante [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) para reunir contexto antes de apresentar um plano.

56 56 

57 * **Model**: herda da conversa principal57 * **Model**: herda da conversa principal

58 * **Tools**: ferramentas somente leitura; Write e Edit são negados58 * **Tools**: ferramentas somente leitura; Write e Edit são negados


84Os subagentes integrados são registrados por padrão em sessões interativas. Para restringi-los:84Os subagentes integrados são registrados por padrão em sessões interativas. Para restringi-los:

85 85 

86* Para bloquear um tipo integrado específico, adicione-o a `permissions.deny` conforme mostrado em [Desabilitar subagentes específicos](#disable-specific-subagents).86* Para bloquear um tipo integrado específico, adicione-o a `permissions.deny` conforme mostrado em [Desabilitar subagentes específicos](#disable-specific-subagents).

87* Para impedir que Claude delegue a qualquer subagente, negue a ferramenta `Agent` em si com [`permissions.deny`](/pt/permissions#tool-specific-permission-rules).87* Para impedir que Claude delegue a qualquer subagente, negue a ferramenta `Agent` em si com [`permissions.deny`](/docs/pt/permissions#tool-specific-permission-rules).

88* {/* min-version: 2.1.198 */}Para remover apenas os subagentes integrados `Explore` e `Plan`, defina [`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/pt/env-vars). Claude lê e explora arquivos diretamente em vez de delegar para eles. Requer Claude Code v2.1.198 ou posterior.88* Para remover apenas os subagentes integrados `Explore` e `Plan`, defina [`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/docs/pt/env-vars). Claude lê e explora arquivos diretamente em vez de delegar para eles. Requer Claude Code v2.1.198 ou posterior.

89* Em [modo não interativo](/pt/headless) e no [Agent SDK](/pt/agent-sdk/overview), defina [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/pt/env-vars) para remover todos os tipos integrados e fornecer apenas os seus próprios.89* Em [modo não interativo](/docs/pt/headless) e no [Agent SDK](/docs/pt/agent-sdk/overview), defina [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/pt/env-vars) para remover todos os tipos integrados e fornecer apenas os seus próprios.

90 90 

91Além desses subagentes integrados, você pode criar os seus próprios com prompts personalizados, restrições de ferramentas, modos de permissão, hooks e skills. As seções a seguir mostram como começar e personalizar subagentes.91Além desses subagentes integrados, você pode criar os seus próprios com prompts personalizados, restrições de ferramentas, modos de permissão, hooks e skills. As seções a seguir mostram como começar e personalizar subagentes.

92 92 


96 96 

97Subagentes são arquivos Markdown com frontmatter YAML. Para criar um, peça ao Claude para escrevê-lo para você, ou [escreva o arquivo você mesmo](#write-subagent-files).97Subagentes são arquivos Markdown com frontmatter YAML. Para criar um, peça ao Claude para escrevê-lo para você, ou [escreva o arquivo você mesmo](#write-subagent-files).

98 98 

99{/* min-version: 2.1.198 */}A partir da v2.1.198, o comando `/agents` não abre mais o assistente de criação interativo; executá-lo imprime um lembrete para pedir ao Claude ou editar `.claude/agents/` diretamente. Os arquivos de subagente, campos de frontmatter e os locais `.claude/agents/` e `~/.claude/agents/` permanecem inalterados; apenas o assistente de terminal foi removido.99A partir da v2.1.198, o comando `/agents` não abre mais o assistente de criação interativo; executá-lo imprime um lembrete para pedir ao Claude ou editar `.claude/agents/` diretamente. Os arquivos de subagente, campos de frontmatter e os locais `.claude/agents/` e `~/.claude/agents/` permanecem inalterados; apenas o assistente de terminal foi removido.

100 100 

101Este passo a passo cria um subagente no nível do usuário que revisa código e sugere melhorias.101Este passo a passo cria um subagente no nível do usuário que revisa código e sugere melhorias.

102 102 


150Você também pode escrever arquivos de subagente manualmente, defini-los via flags CLI ou distribuí-los através de plugins. As seções a seguir cobrem todas as opções de configuração.150Você também pode escrever arquivos de subagente manualmente, defini-los via flags CLI ou distribuí-los através de plugins. As seções a seguir cobrem todas as opções de configuração.

151 151 

152<Note>152<Note>

153 No Claude Code v2.1.197 e anterior, `/agents` abre um assistente interativo com uma aba **Running** que lista subagentes ativos e uma aba **Library** para criá-los, editá-los e deletá-los. {/* max-version: 2.1.197 */}153 No Claude Code v2.1.197 e anterior, `/agents` abre um assistente interativo com uma aba **Running** que lista subagentes ativos e uma aba **Library** para criá-los, editá-los e deletá-los.&#x20;

154</Note>154</Note>

155 155 

156<h2 id="configure-subagents">156<h2 id="configure-subagents">


167 167 

168| Location | Scope | Priority | How to create |168| Location | Scope | Priority | How to create |

169| :--------------------------- | :---------------------- | :---------- | :-------------------------------------------- |169| :--------------------------- | :---------------------- | :---------- | :-------------------------------------------- |

170| Managed settings | Organization-wide | 1 (highest) | Deployed via [managed settings](/pt/settings) |170| Managed settings | Organization-wide | 1 (highest) | Deployed via [managed settings](/docs/pt/settings) |

171| `--agents` CLI flag | Current session | 2 | Pass JSON when launching Claude Code |171| `--agents` CLI flag | Current session | 2 | Pass JSON when launching Claude Code |

172| `.claude/agents/` | Current project | 3 | Ask Claude, or create the file manually |172| `.claude/agents/` | Current project | 3 | Ask Claude, or create the file manually |

173| `~/.claude/agents/` | All your projects | 4 | Ask Claude, or create the file manually |173| `~/.claude/agents/` | All your projects | 4 | Ask Claude, or create the file manually |

174| Plugin's `agents/` directory | Where plugin is enabled | 5 (lowest) | Installed with [plugins](/pt/plugins) |174| Plugin's `agents/` directory | Where plugin is enabled | 5 (lowest) | Installed with [plugins](/docs/pt/plugins) |

175 175 

176**Subagentes de projeto** (`.claude/agents/`) são ideais para subagentes específicos de uma base de código. Verifique-os no controle de versão para que sua equipe possa usá-los e melhorá-los colaborativamente.176**Subagentes de projeto** (`.claude/agents/`) são ideais para subagentes específicos de uma base de código. Verifique-os no controle de versão para que sua equipe possa usá-los e melhorá-los colaborativamente.

177 177 

178Subagentes de projeto são descobertos caminhando para cima a partir do diretório de trabalho atual, portanto cada `.claude/agents/` entre lá e a raiz do repositório é verificado. {/* min-version: 2.1.178 */}A partir da v2.1.178, quando mais de um desses diretórios aninhados define o mesmo `name`, Claude Code usa a definição mais próxima do diretório de trabalho.178Subagentes de projeto são descobertos caminhando para cima a partir do diretório de trabalho atual, portanto cada `.claude/agents/` entre lá e a raiz do repositório é verificado. A partir da v2.1.178, quando mais de um desses diretórios aninhados define o mesmo `name`, Claude Code usa a definição mais próxima do diretório de trabalho.

179 179 

180Diretórios adicionados com `--add-dir` também são verificados: uma pasta `.claude/agents/` dentro de um diretório adicionado carrega junto com subagentes de projeto. Veja [Diretórios adicionais](/pt/permissions#additional-directories-grant-file-access-not-configuration) para quais outros tipos de configuração carregam de `--add-dir`. Para compartilhar subagentes entre projetos sem `--add-dir`, use `~/.claude/agents/` ou um [plugin](/pt/plugins).180Diretórios adicionados com `--add-dir` também são verificados: uma pasta `.claude/agents/` dentro de um diretório adicionado carrega junto com subagentes de projeto. Veja [Diretórios adicionais](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) para quais outros tipos de configuração carregam de `--add-dir`. Para compartilhar subagentes entre projetos sem `--add-dir`, use `~/.claude/agents/` ou um [plugin](/docs/pt/plugins).

181 181 

182**Subagentes de usuário** (`~/.claude/agents/`) são subagentes pessoais disponíveis em todos os seus projetos.182**Subagentes de usuário** (`~/.claude/agents/`) são subagentes pessoais disponíveis em todos os seus projetos.

183 183 

184Claude Code verifica `.claude/agents/` e `~/.claude/agents/` recursivamente, para que você possa organizar definições em subpastas como `agents/review/` ou `agents/research/`. O caminho do subdiretório não afeta como um subagente é identificado ou invocado, porque a identidade vem apenas do campo `name` do frontmatter.184Claude Code verifica `.claude/agents/` e `~/.claude/agents/` recursivamente, para que você possa organizar definições em subpastas como `agents/review/` ou `agents/research/`. O caminho do subdiretório não afeta como um subagente é identificado ou invocado, porque a identidade vem apenas do campo `name` do frontmatter.

185 185 

186Mantenha valores de `name` únicos em toda a árvore: se dois arquivos sob o mesmo diretório `.claude/agents/`, incluindo suas subpastas, declaram o mesmo nome, Claude Code carrega apenas um deles, escolhido pela ordem de leitura do sistema de arquivos em vez de uma precedência documentada. Entre diretórios de projeto aninhados, a definição mais próxima do diretório de trabalho vence, conforme descrito acima. {/* min-version: 2.1.205 */}O verificador de configuração [`/doctor`](/pt/commands#all-commands) relata arquivos no mesmo diretório que compartilham um nome e propõe renomear ou remover todos exceto um. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos que listava duplicatas e mostrava qual definição estava ativa.186Mantenha valores de `name` únicos em toda a árvore: se dois arquivos sob o mesmo diretório `.claude/agents/`, incluindo suas subpastas, declaram o mesmo nome, Claude Code carrega apenas um deles, escolhido pela ordem de leitura do sistema de arquivos em vez de uma precedência documentada. Entre diretórios de projeto aninhados, a definição mais próxima do diretório de trabalho vence, conforme descrito acima. O verificador de configuração [`/doctor`](/docs/pt/commands#all-commands) relata arquivos no mesmo diretório que compartilham um nome e propõe renomear ou remover todos exceto um. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos que listava duplicatas e mostrava qual definição estava ativa.

187 187 

188Diretórios `agents/` de plugin também são verificados recursivamente. Diferentemente dos escopos de projeto e usuário, uma subpasta dentro do diretório `agents/` de um plugin se torna parte do [identificador com escopo](#invoke-subagents-explicitly): um arquivo em `agents/review/security.md` no plugin `my-plugin` se registra como `my-plugin:review:security`.188Diretórios `agents/` de plugin também são verificados recursivamente. Diferentemente dos escopos de projeto e usuário, uma subpasta dentro do diretório `agents/` de um plugin se torna parte do [identificador com escopo](#invoke-subagents-explicitly): um arquivo em `agents/review/security.md` no plugin `my-plugin` se registra como `my-plugin:review:security`.

189 189 


229 229 

230O flag `--agents` aceita JSON com os mesmos campos de [frontmatter](#supported-frontmatter-fields) que subagentes baseados em arquivo: `description`, `prompt`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `isolation` e `color`. Use `prompt` para o prompt de sistema, equivalente ao corpo markdown em subagentes baseados em arquivo.230O flag `--agents` aceita JSON com os mesmos campos de [frontmatter](#supported-frontmatter-fields) que subagentes baseados em arquivo: `description`, `prompt`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `isolation` e `color`. Use `prompt` para o prompt de sistema, equivalente ao corpo markdown em subagentes baseados em arquivo.

231 231 

232**Subagentes gerenciados** são implantados por administradores da organização. Coloque arquivos markdown em `.claude/agents/` dentro do [diretório de configurações gerenciadas](/pt/settings#settings-files), usando o mesmo formato de frontmatter que subagentes de projeto e usuário. Definições gerenciadas têm precedência sobre subagentes de projeto e usuário com o mesmo nome.232**Subagentes gerenciados** são implantados por administradores da organização. Coloque arquivos markdown em `.claude/agents/` dentro do [diretório de configurações gerenciadas](/docs/pt/settings#settings-files), usando o mesmo formato de frontmatter que subagentes de projeto e usuário. Definições gerenciadas têm precedência sobre subagentes de projeto e usuário com o mesmo nome.

233 233 

234**Subagentes de plugin** vêm de [plugins](/pt/plugins) que você instalou. Eles carregam junto com seus subagentes personalizados e aparecem na digitação de @-menção sob seu nome com escopo. Veja a [referência de componentes de plugin](/pt/plugins-reference#agents) para detalhes sobre como criar subagentes de plugin.234**Subagentes de plugin** vêm de [plugins](/docs/pt/plugins) que você instalou. Eles carregam junto com seus subagentes personalizados e aparecem na digitação de @-menção sob seu nome com escopo. Veja a [referência de componentes de plugin](/docs/pt/plugins-reference#agents) para detalhes sobre como criar subagentes de plugin.

235 235 

236<Note>236<Note>

237 Por razões de segurança, subagentes de plugin não suportam os campos de frontmatter `hooks`, `mcpServers` ou `permissionMode`. Estes campos são ignorados ao carregar agentes de um plugin. Se você precisar deles, copie o arquivo do agente para `.claude/agents/` ou `~/.claude/agents/`. Você também pode adicionar regras a [`permissions.allow`](/pt/settings#permission-settings) em `settings.json` ou `settings.local.json`, mas estas regras se aplicam a toda a sessão, não apenas ao subagente do plugin.237 Por razões de segurança, subagentes de plugin não suportam os campos de frontmatter `hooks`, `mcpServers` ou `permissionMode`. Estes campos são ignorados ao carregar agentes de um plugin. Se você precisar deles, copie o arquivo do agente para `.claude/agents/` ou `~/.claude/agents/`. Você também pode adicionar regras a [`permissions.allow`](/docs/pt/settings#permission-settings) em `settings.json` ou `settings.local.json`, mas estas regras se aplicam a toda a sessão, não apenas ao subagente do plugin.

238</Note>238</Note>

239 239 

240Definições de subagente de qualquer um desses escopos também estão disponíveis para [equipes de agentes](/pt/agent-teams#use-subagent-definitions-for-teammates): ao gerar um colega de trabalho, você pode referenciar um tipo de subagente e o colega de trabalho usa suas `tools` e `model`, com o corpo da definição anexado ao prompt de sistema do colega de trabalho como instruções adicionais. Veja [equipes de agentes](/pt/agent-teams#use-subagent-definitions-for-teammates) para quais campos de frontmatter se aplicam nesse caminho.240Definições de subagente de qualquer um desses escopos também estão disponíveis para [equipes de agentes](/docs/pt/agent-teams#use-subagent-definitions-for-teammates): ao gerar um colega de trabalho, você pode referenciar um tipo de subagente e o colega de trabalho usa suas `tools` e `model`, com o corpo da definição anexado ao prompt de sistema do colega de trabalho como instruções adicionais. Veja [equipes de agentes](/docs/pt/agent-teams#use-subagent-definitions-for-teammates) para quais campos de frontmatter se aplicam nesse caminho.

241 241 

242<h3 id="write-subagent-files">242<h3 id="write-subagent-files">

243 Escrever arquivos de subagente243 Escrever arquivos de subagente


268 268 

269O frontmatter define os metadados e configuração do subagente. O corpo se torna o prompt de sistema que guia o comportamento do subagente. Subagentes recebem apenas este prompt de sistema mais detalhes básicos de ambiente como diretório de trabalho, não o prompt de sistema completo do Claude Code.269O frontmatter define os metadados e configuração do subagente. O corpo se torna o prompt de sistema que guia o comportamento do subagente. Subagentes recebem apenas este prompt de sistema mais detalhes básicos de ambiente como diretório de trabalho, não o prompt de sistema completo do Claude Code.

270 270 

271Em [modo não interativo](/pt/headless), o flag [`--append-subagent-system-prompt`](/pt/cli-reference#cli-flags) anexa o texto que você fornece ao final do prompt de sistema de cada subagente, incluindo subagentes aninhados. Requer Claude Code v2.1.205 ou posterior.271Em [modo não interativo](/docs/pt/headless), o flag [`--append-subagent-system-prompt`](/docs/pt/cli-reference#cli-flags) anexa o texto que você fornece ao final do prompt de sistema de cada subagente, incluindo subagentes aninhados. Requer Claude Code v2.1.205 ou posterior.

272 272 

273Um subagente começa no diretório de trabalho atual da conversa principal. Dentro de um subagente, comandos `cd` não persistem entre chamadas de ferramentas Bash ou PowerShell e não afetam o diretório de trabalho da conversa principal. Para dar ao subagente uma cópia isolada do repositório em vez disso, defina [`isolation: worktree`](#supported-frontmatter-fields).273Um subagente começa no diretório de trabalho atual da conversa principal. Dentro de um subagente, comandos `cd` não persistem entre chamadas de ferramentas Bash ou PowerShell e não afetam o diretório de trabalho da conversa principal. Para dar ao subagente uma cópia isolada do repositório em vez disso, defina [`isolation: worktree`](#supported-frontmatter-fields).

274 274 

275{/* min-version: 2.1.203 */}Um subagente com `isolation: worktree` executa seus comandos Bash e PowerShell dentro de seu worktree. Um comando cujo diretório de trabalho se resolve para seu checkout principal, por exemplo porque o diretório worktree foi removido enquanto o subagente estava em execução, falha com um erro. Antes da v2.1.203, tal comando poderia ser executado no checkout principal.275Um subagente com `isolation: worktree` executa seus comandos Bash e PowerShell dentro de seu worktree. Um comando cujo diretório de trabalho se resolve para seu checkout principal, por exemplo porque o diretório worktree foi removido enquanto o subagente estava em execução, falha com um erro. Antes da v2.1.203, tal comando poderia ser executado no checkout principal.

276 276 

277<h4 id="supported-frontmatter-fields">277<h4 id="supported-frontmatter-fields">

278 Campos de frontmatter suportados278 Campos de frontmatter suportados


282 282 

283| Field | Required | Description |283| Field | Required | Description |

284| :---------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |284| :---------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

285| `name` | Yes | Identificador único usando letras minúsculas e hífens. [Hooks](/pt/hooks#subagentstart) recebem este valor como `agent_type`. O nome do arquivo não precisa corresponder |285| `name` | Yes | Identificador único usando letras minúsculas e hífens. [Hooks](/docs/pt/hooks#subagentstart) recebem este valor como `agent_type`. O nome do arquivo não precisa corresponder |

286| `description` | Yes | Quando Claude deve delegar para este subagente |286| `description` | Yes | Quando Claude deve delegar para este subagente |

287| `tools` | No | [Ferramentas](#available-tools) que o subagente pode usar. Herda todas as ferramentas se omitido. Se nenhuma entrada na lista se resolver para uma ferramenta, o subagente falha ao iniciar com um erro nomeando as entradas. Para pré-carregar Skills no contexto, use o campo `skills` em vez de listar `Skill` aqui |287| `tools` | No | [Ferramentas](#available-tools) que o subagente pode usar. Herda todas as ferramentas se omitido. Se nenhuma entrada na lista se resolver para uma ferramenta, o subagente falha ao iniciar com um erro nomeando as entradas. Para pré-carregar Skills no contexto, use o campo `skills` em vez de listar `Skill` aqui |

288| `disallowedTools` | No | Ferramentas a negar, removidas da lista herdada ou especificada |288| `disallowedTools` | No | Ferramentas a negar, removidas da lista herdada ou especificada |

289| `model` | No | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, um ID de modelo completo (por exemplo, `claude-opus-4-8`), ou `inherit`. Padrão: `inherit` |289| `model` | No | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, um ID de modelo completo (por exemplo, `claude-opus-4-8`), ou `inherit`. Padrão: `inherit` |

290| `permissionMode` | No | [Modo de permissão](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, ou {/* min-version: 2.1.200 */}`manual` como um alias para `default`. O alias `manual` requer Claude Code v2.1.200 ou posterior. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |290| `permissionMode` | No | [Modo de permissão](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, ou `manual` como um alias para `default`. O alias `manual` requer Claude Code v2.1.200 ou posterior. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

291| `maxTurns` | No | Número máximo de turnos de agente antes do subagente parar |291| `maxTurns` | No | Número máximo de turnos de agente antes do subagente parar |

292| `skills` | No | [Skills](/pt/skills) a pré-carregar no contexto do subagente na inicialização. O conteúdo completo da skill é injetado, não apenas a descrição. Subagentes ainda podem invocar skills de projeto, usuário e plugin não listadas através da ferramenta Skill |292| `skills` | No | [Skills](/docs/pt/skills) a pré-carregar no contexto do subagente na inicialização. O conteúdo completo da skill é injetado, não apenas a descrição. Subagentes ainda podem invocar skills de projeto, usuário e plugin não listadas através da ferramenta Skill |

293| `mcpServers` | No | [MCP servers](/pt/mcp) disponíveis para este subagente. Cada entrada é um nome de servidor referenciando um servidor já configurado (por exemplo, `"slack"`) ou uma definição inline com o nome do servidor como chave e uma [configuração completa de MCP server](/pt/mcp#installing-mcp-servers) como valor. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |293| `mcpServers` | No | [MCP servers](/docs/pt/mcp) disponíveis para este subagente. Cada entrada é um nome de servidor referenciando um servidor já configurado (por exemplo, `"slack"`) ou uma definição inline com o nome do servidor como chave e uma [configuração completa de MCP server](/docs/pt/mcp#installing-mcp-servers) como valor. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

294| `hooks` | No | [Lifecycle hooks](#define-hooks-for-subagents) com escopo para este subagente. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |294| `hooks` | No | [Lifecycle hooks](#define-hooks-for-subagents) com escopo para este subagente. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

295| `memory` | No | [Escopo de memória persistente](#enable-persistent-memory): `user`, `project`, ou `local`. Habilita aprendizado entre sessões |295| `memory` | No | [Escopo de memória persistente](#enable-persistent-memory): `user`, `project`, ou `local`. Habilita aprendizado entre sessões |

296| `background` | No | Defina como `true` para sempre executar este subagente como uma [tarefa em background](#run-subagents-in-foreground-or-background), mesmo quando Claude precisa de seu resultado imediatamente. Quando não definido, Claude escolhe, e {/* min-version: 2.1.198 */}a partir da v2.1.198 ele executa subagentes em background por padrão |296| `background` | No | Defina como `true` para sempre executar este subagente como uma [tarefa em background](#run-subagents-in-foreground-or-background), mesmo quando Claude precisa de seu resultado imediatamente. Quando não definido, Claude escolhe, e a partir da v2.1.198 ele executa subagentes em background por padrão |

297| `effort` | No | Nível de esforço quando este subagente está ativo. Sobrescreve o nível de esforço da sessão. Padrão: herda da sessão. Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo |297| `effort` | No | Nível de esforço quando este subagente está ativo. Sobrescreve o nível de esforço da sessão. Padrão: herda da sessão. Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo |

298| `isolation` | No | Defina como `worktree` para executar o subagente em um [git worktree](/pt/worktrees) temporário, dando-lhe uma cópia isolada do repositório ramificada por padrão a partir de sua [branch padrão](/pt/worktrees#choose-the-base-branch) em vez do `HEAD` da sessão pai. O worktree é automaticamente limpo se o subagente não fizer alterações |298| `isolation` | No | Defina como `worktree` para executar o subagente em um [git worktree](/docs/pt/worktrees) temporário, dando-lhe uma cópia isolada do repositório ramificada por padrão a partir de sua [branch padrão](/docs/pt/worktrees#choose-the-base-branch) em vez do `HEAD` da sessão pai. O worktree é automaticamente limpo se o subagente não fizer alterações |

299| `color` | No | Cor de exibição para o subagente na lista de tarefas e transcrição. Aceita `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, ou `cyan` |299| `color` | No | Cor de exibição para o subagente na lista de tarefas e transcrição. Aceita `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, ou `cyan` |

300| `initialPrompt` | No | Auto-enviado como o primeiro turno do usuário quando este agente é executado como o agente da sessão principal (via `--agent` ou a configuração `agent`). [Comandos](/pt/commands) e [skills](/pt/skills) são processados. Preposto a qualquer prompt fornecido pelo usuário |300| `initialPrompt` | No | Auto-enviado como o primeiro turno do usuário quando este agente é executado como o agente da sessão principal (via `--agent` ou a configuração `agent`). [Comandos](/docs/pt/commands) e [skills](/docs/pt/skills) são processados. Preposto a qualquer prompt fornecido pelo usuário |

301 301 

302<h3 id="choose-a-model">302<h3 id="choose-a-model">

303 Escolher um modelo303 Escolher um modelo

304</h3>304</h3>

305 305 

306O campo `model` controla qual [modelo de IA](/pt/model-config) o subagente usa:306O campo `model` controla qual [modelo de IA](/docs/pt/model-config) o subagente usa:

307 307 

308* **Alias de modelo**: Use um dos aliases disponíveis: `sonnet`, `opus`, `haiku`, ou `fable`308* **Alias de modelo**: Use um dos aliases disponíveis: `sonnet`, `opus`, `haiku`, ou `fable`

309* **ID de modelo completo**: Use um ID de modelo completo como `claude-opus-4-8` ou `claude-sonnet-5`. Aceita os mesmos valores que o flag `--model`309* **ID de modelo completo**: Use um ID de modelo completo como `claude-opus-4-8` ou `claude-sonnet-5`. Aceita os mesmos valores que o flag `--model`


312 312 

313Quando Claude invoca um subagente, ele também pode passar um parâmetro `model` para essa invocação específica. Claude Code resolve o modelo do subagente nesta ordem:313Quando Claude invoca um subagente, ele também pode passar um parâmetro `model` para essa invocação específica. Claude Code resolve o modelo do subagente nesta ordem:

314 314 

3151. A variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/pt/model-config#environment-variables), quando definida para um alias de modelo ou ID de modelo3151. A variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/pt/model-config#environment-variables), quando definida para um alias de modelo ou ID de modelo

3162. O parâmetro `model` por invocação3162. O parâmetro `model` por invocação

3173. O frontmatter `model` da definição do subagente3173. O frontmatter `model` da definição do subagente

3184. O modelo da conversa principal3184. O modelo da conversa principal

319 319 

320{/* min-version: 2.1.196 */}A partir da v2.1.196, definir `CLAUDE_CODE_SUBAGENT_MODEL` para `inherit` é o mesmo que deixá-lo indefinido: a resolução continua com o parâmetro `model` por invocação, depois o frontmatter. Em versões anteriores, `inherit` forçava subagentes para o modelo da conversa principal e ignorava ambas essas fontes.320A partir da v2.1.196, definir `CLAUDE_CODE_SUBAGENT_MODEL` para `inherit` é o mesmo que deixá-lo indefinido: a resolução continua com o parâmetro `model` por invocação, depois o frontmatter. Em versões anteriores, `inherit` forçava subagentes para o modelo da conversa principal e ignorava ambas essas fontes.

321 321 

322Claude Code verifica o valor da variável de ambiente, parâmetro por invocação e valores de frontmatter contra a lista de permissões [`availableModels`](/pt/model-config#restrict-model-selection) da sua organização. Um valor que se resolve para um modelo excluído é ignorado e o subagente é executado no modelo herdado em vez disso.322Claude Code verifica o valor da variável de ambiente, parâmetro por invocação e valores de frontmatter contra a lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização. Um valor que se resolve para um modelo excluído é ignorado e o subagente é executado no modelo herdado em vez disso.

323 323 

324{/* min-version: 2.1.198 */}A partir da v2.1.198, subagentes também herdam a configuração de [pensamento estendido](/pt/model-config#extended-thinking) da conversa principal: se o pensamento está ativado em sua sessão, está ativado para o subagente, e se está desativado, permanece desativado. Não há configuração de pensamento por subagente. Antes da v2.1.198, subagentes eram executados com pensamento estendido desabilitado independentemente da configuração da conversa principal.324A partir da v2.1.198, subagentes também herdam a configuração de [pensamento estendido](/docs/pt/model-config#extended-thinking) da conversa principal: se o pensamento está ativado em sua sessão, está ativado para o subagente, e se está desativado, permanece desativado. Não há configuração de pensamento por subagente. Antes da v2.1.198, subagentes eram executados com pensamento estendido desabilitado independentemente da configuração da conversa principal.

325 325 

326<h3 id="control-subagent-capabilities">326<h3 id="control-subagent-capabilities">

327 Controlar capacidades do subagente327 Controlar capacidades do subagente


333 Ferramentas disponíveis333 Ferramentas disponíveis

334</h4>334</h4>

335 335 

336Subagentes herdam as [ferramentas internas](/pt/tools-reference) e ferramentas MCP disponíveis na conversa principal por padrão. As seguintes ferramentas dependem da interface ou estado de sessão da conversa principal e não estão disponíveis para subagentes, mesmo quando listadas no campo `tools`:336Subagentes herdam as [ferramentas internas](/docs/pt/tools-reference) e ferramentas MCP disponíveis na conversa principal por padrão. As seguintes ferramentas dependem da interface ou estado de sessão da conversa principal e não estão disponíveis para subagentes, mesmo quando listadas no campo `tools`:

337 337 

338* `AskUserQuestion`338* `AskUserQuestion`

339* `EnterPlanMode`339* `EnterPlanMode`


363 363 

364Se ambos forem definidos, `disallowedTools` é aplicado primeiro, depois `tools` é resolvido contra o pool restante. Uma ferramenta listada em ambos é removida.364Se ambos forem definidos, `disallowedTools` é aplicado primeiro, depois `tools` é resolvido contra o pool restante. Uma ferramenta listada em ambos é removida.

365 365 

366Quando nada na lista `tools` se resolve para uma ferramenta, por exemplo porque cada entrada está com erro de digitação ou nomeia uma ferramenta que não está disponível para subagentes, Claude Code recusa iniciar o subagente e a ferramenta Agent retorna um erro nomeando as entradas não resolvidas. {/* min-version: 2.1.208 */}Antes da v2.1.208, esse subagente era iniciado sem ferramentas e poderia retornar um resultado vazio ou confuso.366Quando nada na lista `tools` se resolve para uma ferramenta, por exemplo porque cada entrada está com erro de digitação ou nomeia uma ferramenta que não está disponível para subagentes, Claude Code recusa iniciar o subagente e a ferramenta Agent retorna um erro nomeando as entradas não resolvidas. Antes da v2.1.208, esse subagente era iniciado sem ferramentas e poderia retornar um resultado vazio ou confuso.

367 367 

368Ambos os campos aceitam padrões de nível de servidor MCP além de nomes de ferramentas exatos: `mcp__<server>` ou `mcp__<server>__*` concede ou remove todas as ferramentas do servidor nomeado. Em `disallowedTools`, `mcp__*` também remove todas as ferramentas MCP de qualquer servidor. Este exemplo remove todas as ferramentas do servidor MCP `github` enquanto mantém ferramentas de outros servidores e todas as ferramentas integradas:368Ambos os campos aceitam padrões de nível de servidor MCP além de nomes de ferramentas exatos: `mcp__<server>` ou `mcp__<server>__*` concede ou remove todas as ferramentas do servidor nomeado. Em `disallowedTools`, `mcp__*` também remove todas as ferramentas MCP de qualquer servidor. Este exemplo remove todas as ferramentas do servidor MCP `github` enquanto mantém ferramentas de outros servidores e todas as ferramentas integradas:

369 369 


407 Escopo de MCP servers para um subagente407 Escopo de MCP servers para um subagente

408</h4>408</h4>

409 409 

410Use o campo `mcpServers` para dar a um subagente acesso a [MCP](/pt/mcp) servers que não estão disponíveis na conversa principal. Servidores inline definidos aqui são conectados quando o subagente inicia e desconectados quando termina. Referências de string compartilham a conexão da sessão pai.410Use o campo `mcpServers` para dar a um subagente acesso a [MCP](/docs/pt/mcp) servers que não estão disponíveis na conversa principal. Servidores inline definidos aqui são conectados quando o subagente inicia e desconectados quando termina. Referências de string compartilham a conexão da sessão pai.

411 411 

412<Note>412<Note>

413 O campo `mcpServers` se aplica em ambos os contextos onde um arquivo de agente pode ser executado:413 O campo `mcpServers` se aplica em ambos os contextos onde um arquivo de agente pode ser executado:


415 * Como um subagente, gerado através da ferramenta Agent ou uma @-menção415 * Como um subagente, gerado através da ferramenta Agent ou uma @-menção

416 * Como a sessão principal, iniciada com [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`416 * Como a sessão principal, iniciada com [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`

417 417 

418 Quando o agente é a sessão principal, definições de servidor inline se conectam na inicialização junto com servidores de [`.mcp.json`](/pt/mcp) e arquivos de configurações.418 Quando o agente é a sessão principal, definições de servidor inline se conectam na inicialização junto com servidores de [`.mcp.json`](/docs/pt/mcp) e arquivos de configurações.

419</Note>419</Note>

420 420 

421Cada entrada na lista é uma definição de servidor inline ou uma string referenciando um MCP server já configurado em sua sessão:421Cada entrada na lista é uma definição de servidor inline ou uma string referenciando um MCP server já configurado em sua sessão:


443 443 

444A partir da v2.1.153, as restrições de MCP que se aplicam à sessão principal também cobrem servidores declarados no frontmatter do subagente:444A partir da v2.1.153, as restrições de MCP que se aplicam à sessão principal também cobrem servidores declarados no frontmatter do subagente:

445 445 

446* [`--strict-mcp-config`](/pt/cli-reference) e [`--bare`](/pt/cli-reference)446* [`--strict-mcp-config`](/docs/pt/cli-reference) e [`--bare`](/docs/pt/cli-reference)

447* [Configuração de MCP gerenciada pela empresa](/pt/managed-mcp)447* [Configuração de MCP gerenciada pela empresa](/docs/pt/managed-mcp)

448* [Políticas `allowedMcpServers` e `deniedMcpServers`](/pt/managed-mcp#policy-based-control-with-allowlists-and-denylists)448* [Políticas `allowedMcpServers` e `deniedMcpServers`](/docs/pt/managed-mcp#policy-based-control-with-allowlists-and-denylists)

449 449 

450Quando um destes bloqueia um servidor, Claude Code o ignora e mostra um aviso nomeando os servidores bloqueados.450Quando um destes bloqueia um servidor, Claude Code o ignora e mostra um aviso nomeando os servidores bloqueados.

451 451 


461| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |461| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

462| `default` | Verificação de permissão padrão com prompts |462| `default` | Verificação de permissão padrão com prompts |

463| `acceptEdits` | Auto-aceitar edições de arquivo e comandos comuns do sistema de arquivos para caminhos no diretório de trabalho ou `additionalDirectories` |463| `acceptEdits` | Auto-aceitar edições de arquivo e comandos comuns do sistema de arquivos para caminhos no diretório de trabalho ou `additionalDirectories` |

464| `auto` | [Auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode): um classificador de IA avalia cada chamada de ferramenta |464| `auto` | [Auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode): um classificador de IA avalia cada chamada de ferramenta |

465| `dontAsk` | Auto-negar prompts de permissão. Ferramentas explicitamente permitidas ainda funcionam; `AskUserQuestion`, ferramentas de conector [sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo se você as permitiu |465| `dontAsk` | Auto-negar prompts de permissão. Ferramentas explicitamente permitidas ainda funcionam; `AskUserQuestion`, ferramentas de conector [sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) são negadas mesmo se você as permitiu |

466| `bypassPermissions` | Pular prompts de permissão |466| `bypassPermissions` | Pular prompts de permissão |

467| `plan` | Plan mode (exploração somente leitura) |467| `plan` | Plan mode (exploração somente leitura) |

468 468 

469<Warning>469<Warning>

470 Use `bypassPermissions` com cuidado. Ele pula prompts de permissão, permitindo que o subagente execute operações sem aprovação, incluindo escritas em `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` e `.mvn`.470 Use `bypassPermissions` com cuidado. Ele pula prompts de permissão, permitindo que o subagente execute operações sem aprovação, incluindo escritas em `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` e `.mvn`.

471 471 

472 Regras [`ask`](/pt/permissions#manage-permissions) explícitas, ferramentas de conector [sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools), ferramentas MCP marcadas [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool), e remoções de diretório raiz e home como `rm -rf /` ainda solicitam. Veja [modos de permissão](/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para detalhes.472 Regras [`ask`](/docs/pt/permissions#manage-permissions) explícitas, ferramentas de conector [sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools), ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool), e remoções de diretório raiz e home como `rm -rf /` ainda solicitam. Veja [modos de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para detalhes.

473</Warning>473</Warning>

474 474 

475Se o pai usar `bypassPermissions` ou `acceptEdits`, isso tem precedência e não pode ser sobrescrito. Se o pai usar [auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode), o subagente herda auto mode e qualquer `permissionMode` em seu frontmatter é ignorado: o classificador avalia as chamadas de ferramentas do subagente com as mesmas regras de bloqueio e permissão que a sessão pai.475Se o pai usar `bypassPermissions` ou `acceptEdits`, isso tem precedência e não pode ser sobrescrito. Se o pai usar [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), o subagente herda auto mode e qualquer `permissionMode` em seu frontmatter é ignorado: o classificador avalia as chamadas de ferramentas do subagente com as mesmas regras de bloqueio e permissão que a sessão pai.

476 476 

477<h4 id="preload-skills-into-subagents">477<h4 id="preload-skills-into-subagents">

478 Pré-carregar skills em subagentes478 Pré-carregar skills em subagentes


494 494 

495O conteúdo completo de cada skill listada é injetado no contexto do subagente na inicialização. Este campo controla quais skills são pré-carregadas, não quais skills o subagente pode acessar: sem ele, o subagente ainda pode descobrir e invocar skills de projeto, usuário e plugin através da ferramenta Skill durante a execução. Para impedir que um subagente invoque skills inteiramente, omita `Skill` da lista [`tools`](#available-tools) ou adicione-o a `disallowedTools`.495O conteúdo completo de cada skill listada é injetado no contexto do subagente na inicialização. Este campo controla quais skills são pré-carregadas, não quais skills o subagente pode acessar: sem ele, o subagente ainda pode descobrir e invocar skills de projeto, usuário e plugin através da ferramenta Skill durante a execução. Para impedir que um subagente invoque skills inteiramente, omita `Skill` da lista [`tools`](#available-tools) ou adicione-o a `disallowedTools`.

496 496 

497Você não pode pré-carregar skills que definem [`disable-model-invocation: true`](/pt/skills#control-who-invokes-a-skill), já que pré-carregar extrai do mesmo conjunto de skills que Claude pode invocar. Se uma skill listada estiver faltando ou desabilitada, Claude Code a ignora e registra um aviso no log de debug.497Você não pode pré-carregar skills que definem [`disable-model-invocation: true`](/docs/pt/skills#control-who-invokes-a-skill), já que pré-carregar extrai do mesmo conjunto de skills que Claude pode invocar. Se uma skill listada estiver faltando ou desabilitada, Claude Code a ignora e registra um aviso no log de debug.

498 498 

499<Note>499<Note>

500 Isto é o inverso de [executar uma skill em um subagente](/pt/skills#run-skills-in-a-subagent). Com `skills` em um subagente, o subagente controla o prompt de sistema e carrega conteúdo de skill. Com `context: fork` em uma skill, o conteúdo de skill é injetado no agente que você especificar. Ambos usam o mesmo sistema subjacente.500 Isto é o inverso de [executar uma skill em um subagente](/docs/pt/skills#run-skills-in-a-subagent). Com `skills` em um subagente, o subagente controla o prompt de sistema e carrega conteúdo de skill. Com `context: fork` em uma skill, o conteúdo de skill é injetado no agente que você especificar. Ambos usam o mesmo sistema subjacente.

501</Note>501</Note>

502 502 

503<h4 id="enable-persistent-memory">503<h4 id="enable-persistent-memory">


569---569---

570```570```

571 571 

572Claude Code [passa entrada de hook como JSON](/pt/hooks#pretooluse-input) via stdin para comandos de hook. O script de validação lê este JSON, extrai o comando Bash e [sai com código 2](/pt/hooks#exit-code-2-behavior-per-event) para bloquear operações de escrita:572Claude Code [passa entrada de hook como JSON](/docs/pt/hooks#pretooluse-input) via stdin para comandos de hook. O script de validação lê este JSON, extrai o comando Bash e [sai com código 2](/docs/pt/hooks#exit-code-2-behavior-per-event) para bloquear operações de escrita:

573 573 

574```bash theme={null}574```bash theme={null}

575#!/bin/bash575#!/bin/bash


587exit 0587exit 0

588```588```

589 589 

590Veja [Hook input](/pt/hooks#pretooluse-input) para o schema de entrada completo e [exit codes](/pt/hooks#exit-code-output) para como códigos de saída afetam o comportamento. No Windows, escreva scripts de hook em PowerShell e adicione `shell: powershell` à entrada de hook conforme mostrado em [executando hooks em PowerShell](/pt/hooks#windows-powershell-tool).590Veja [Hook input](/docs/pt/hooks#pretooluse-input) para o schema de entrada completo e [exit codes](/docs/pt/hooks#exit-code-output) para como códigos de saída afetam o comportamento. No Windows, escreva scripts de hook em PowerShell e adicione `shell: powershell` à entrada de hook conforme mostrado em [executando hooks em PowerShell](/docs/pt/hooks#windows-powershell-tool).

591 591 

592<h4 id="disable-specific-subagents">592<h4 id="disable-specific-subagents">

593 Desabilitar subagentes específicos593 Desabilitar subagentes específicos

594</h4>594</h4>

595 595 

596Você pode impedir que Claude use subagentes específicos adicionando-os ao array `deny` em suas [configurações](/pt/settings#permission-settings). Use o formato `Agent(subagent-name)` onde `subagent-name` corresponde ao campo name do subagente.596Você pode impedir que Claude use subagentes específicos adicionando-os ao array `deny` em suas [configurações](/docs/pt/settings#permission-settings). Use o formato `Agent(subagent-name)` onde `subagent-name` corresponde ao campo name do subagente.

597 597 

598```json theme={null}598```json theme={null}

599{599{


609claude --disallowedTools "Agent(Explore)"609claude --disallowedTools "Agent(Explore)"

610```610```

611 611 

612Veja [documentação de Permissões](/pt/permissions#tool-specific-permission-rules) para mais detalhes sobre regras de permissão.612Veja [documentação de Permissões](/docs/pt/permissions#tool-specific-permission-rules) para mais detalhes sobre regras de permissão.

613 613 

614<h3 id="define-hooks-for-subagents">614<h3 id="define-hooks-for-subagents">

615 Definir hooks para subagentes615 Definir hooks para subagentes

616</h3>616</h3>

617 617 

618Subagentes podem definir [hooks](/pt/hooks) que são executados durante o ciclo de vida do subagente. Existem duas formas de configurar hooks:618Subagentes podem definir [hooks](/docs/pt/hooks) que são executados durante o ciclo de vida do subagente. Existem duas formas de configurar hooks:

619 619 

620* **No frontmatter do subagente**: defina hooks que são executados apenas enquanto esse subagente específico está ativo620* **No frontmatter do subagente**: defina hooks que são executados apenas enquanto esse subagente específico está ativo

621* **Em `settings.json`**: defina hooks que são executados na sessão principal quando subagentes iniciam ou param621* **Em `settings.json`**: defina hooks que são executados na sessão principal quando subagentes iniciam ou param


627Defina hooks diretamente no arquivo markdown do subagente. Estes hooks são executados apenas enquanto esse subagente específico está ativo e são limpos quando termina.627Defina hooks diretamente no arquivo markdown do subagente. Estes hooks são executados apenas enquanto esse subagente específico está ativo e são limpos quando termina.

628 628 

629<Note>629<Note>

630 Hooks de frontmatter disparam quando o agente é gerado como um subagente através da ferramenta Agent ou uma @-menção, e quando o agente é executado como a sessão principal via [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`. No caso de sessão principal, eles são executados junto com qualquer hook definido em [`settings.json`](/pt/hooks).630 Hooks de frontmatter disparam quando o agente é gerado como um subagente através da ferramenta Agent ou uma @-menção, e quando o agente é executado como a sessão principal via [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`. No caso de sessão principal, eles são executados junto com qualquer hook definido em [`settings.json`](/docs/pt/hooks).

631</Note>631</Note>

632 632 

633Todos os [eventos de hook](/pt/hooks#hook-events) são suportados. Os eventos mais comuns para subagentes são:633Todos os [eventos de hook](/docs/pt/hooks#hook-events) são suportados. Os eventos mais comuns para subagentes são:

634 634 

635| Event | Matcher input | When it fires |635| Event | Matcher input | When it fires |

636| :------------ | :----------------- | :------------------------------------------------------------------------------- |636| :------------ | :----------------- | :------------------------------------------------------------------------------- |


671| `SubagentStart` | Nome do tipo de agente | Quando um subagente começa a execução |671| `SubagentStart` | Nome do tipo de agente | Quando um subagente começa a execução |

672| `SubagentStop` | Nome do tipo de agente | Quando um subagente completa |672| `SubagentStop` | Nome do tipo de agente | Quando um subagente completa |

673 673 

674Ambos os eventos suportam matchers para direcionar tipos de agente específicos por nome. O valor do matcher é o `name` do frontmatter do agente para subagentes no nível de projeto e usuário, ou o identificador com escopo de plugin como `my-plugin:db-agent` para [subagentes de plugin](/pt/plugins). Um nome com escopo contém dois-pontos, portanto é avaliado como uma [expressão regular sem âncora](/pt/hooks#matcher-patterns); ancorá-lo com `^` e `$`, como em `^my-plugin:db-agent$`, para corresponder apenas a esse agente.674Ambos os eventos suportam matchers para direcionar tipos de agente específicos por nome. O valor do matcher é o `name` do frontmatter do agente para subagentes no nível de projeto e usuário, ou o identificador com escopo de plugin como `my-plugin:db-agent` para [subagentes de plugin](/docs/pt/plugins). Um nome com escopo contém dois-pontos, portanto é avaliado como uma [expressão regular sem âncora](/docs/pt/hooks#matcher-patterns); ancorá-lo com `^` e `$`, como em `^my-plugin:db-agent$`, para corresponder apenas a esse agente.

675 675 

676Este exemplo executa um script de configuração apenas quando o subagente `db-agent` inicia, e um script de limpeza quando qualquer subagente para:676Este exemplo executa um script de configuração apenas quando o subagente `db-agent` inicia, e um script de limpeza quando qualquer subagente para:

677 677 


699 699 

700Um matcher com hífens como `db-agent` corresponde exatamente no Claude Code v2.1.195 ou posterior. Em versões anteriores, é avaliado como uma expressão regular sem âncora e também dispara para qualquer tipo de agente que o contenha, como `prod-db-agent`; ancorá-lo como `^db-agent$` nessas versões.700Um matcher com hífens como `db-agent` corresponde exatamente no Claude Code v2.1.195 ou posterior. Em versões anteriores, é avaliado como uma expressão regular sem âncora e também dispara para qualquer tipo de agente que o contenha, como `prod-db-agent`; ancorá-lo como `^db-agent$` nessas versões.

701 701 

702Veja [Hooks](/pt/hooks) para o formato de configuração de hook completo.702Veja [Hooks](/docs/pt/hooks) para o formato de configuração de hook completo.

703 703 

704<h2 id="work-with-subagents">704<h2 id="work-with-subagents">

705 Trabalhar com subagentes705 Trabalhar com subagentes


736 736 

737Sua mensagem completa ainda vai para Claude, que escreve o prompt de tarefa do subagente baseado no que você pediu. O @-mention controla qual subagente Claude invoca, não qual prompt ele recebe.737Sua mensagem completa ainda vai para Claude, que escreve o prompt de tarefa do subagente baseado no que você pediu. O @-mention controla qual subagente Claude invoca, não qual prompt ele recebe.

738 738 

739Subagentes fornecidos por um [plugin](/pt/plugins) habilitado aparecem no typeahead sob seu nome com escopo, como `my-plugin:code-reviewer` ou `my-plugin:review:security` quando o plugin [organiza agentes em subpastas](#choose-the-subagent-scope). Subagentes em background nomeados atualmente em execução na sessão também aparecem no typeahead, mostrando seu status ao lado do nome.739Subagentes fornecidos por um [plugin](/docs/pt/plugins) habilitado aparecem no typeahead sob seu nome com escopo, como `my-plugin:code-reviewer` ou `my-plugin:review:security` quando o plugin [organiza agentes em subpastas](#choose-the-subagent-scope). Subagentes em background nomeados atualmente em execução na sessão também aparecem no typeahead, mostrando seu status ao lado do nome.

740 740 

741Você também pode digitar a menção manualmente sem usar o picker: `@agent-<name>` para subagentes locais, ou `@agent-` seguido pelo nome com escopo para subagentes de plugin, por exemplo `@agent-my-plugin:code-reviewer`.741Você também pode digitar a menção manualmente sem usar o picker: `@agent-<name>` para subagentes locais, ou `@agent-` seguido pelo nome com escopo para subagentes de plugin, por exemplo `@agent-my-plugin:code-reviewer`.

742 742 

743**Execute toda a sessão como um subagente.** Passe [`--agent <name>`](/pt/cli-reference) para iniciar uma sessão onde a thread principal em si assume o prompt de sistema, restrições de ferramentas e modelo do subagente:743**Execute toda a sessão como um subagente.** Passe [`--agent <name>`](/docs/pt/cli-reference) para iniciar uma sessão onde a thread principal em si assume o prompt de sistema, restrições de ferramentas e modelo do subagente:

744 744 

745```bash theme={null}745```bash theme={null}

746claude --agent code-reviewer746claude --agent code-reviewer

747```747```

748 748 

749O prompt de sistema do subagente substitui completamente o prompt de sistema padrão do Claude Code, da mesma forma que [`--system-prompt`](/pt/cli-reference) faz. Arquivos `CLAUDE.md` e memória de projeto ainda carregam através do fluxo de mensagem normal. O nome do agente aparece como `@<name>` no cabeçalho de inicialização para que você possa confirmar que está ativo.749O prompt de sistema do subagente substitui completamente o prompt de sistema padrão do Claude Code, da mesma forma que [`--system-prompt`](/docs/pt/cli-reference) faz. Arquivos `CLAUDE.md` e memória de projeto ainda carregam através do fluxo de mensagem normal. O nome do agente aparece como `@<name>` no cabeçalho de inicialização para que você possa confirmar que está ativo.

750 750 

751Isso funciona com subagentes integrados e personalizados, e a escolha persiste quando você retoma a sessão.751Isso funciona com subagentes integrados e personalizados, e a escolha persiste quando você retoma a sessão.

752 752 


781Subagentes podem ser executados em foreground ou background:781Subagentes podem ser executados em foreground ou background:

782 782 

783* **Subagentes em foreground** bloqueiam a conversa principal até completar. Prompts de permissão são passados para você conforme surgem.783* **Subagentes em foreground** bloqueiam a conversa principal até completar. Prompts de permissão são passados para você conforme surgem.

784* **Subagentes em background** são executados concorrentemente enquanto você continua trabalhando. {/* min-version: 2.1.186 */}A partir da v2.1.186, quando um subagente em background atinge uma chamada de ferramenta que precisa de permissão, o prompt aparece em sua sessão principal e nomeia o subagente que está pedindo. Aprove para deixar o subagente continuar, ou pressione Esc para negar essa chamada de ferramenta sem parar o subagente. Antes da v2.1.186, subagentes em background auto-negavam qualquer chamada de ferramenta que teria solicitado.784* **Subagentes em background** são executados concorrentemente enquanto você continua trabalhando. A partir da v2.1.186, quando um subagente em background atinge uma chamada de ferramenta que precisa de permissão, o prompt aparece em sua sessão principal e nomeia o subagente que está pedindo. Aprove para deixar o subagente continuar, ou pressione Esc para negar essa chamada de ferramenta sem parar o subagente. Antes da v2.1.186, subagentes em background auto-negavam qualquer chamada de ferramenta que teria solicitado.

785 785 

786{/* min-version: 2.1.198 */}A partir da v2.1.198, subagentes são executados em background por padrão. Claude executa um subagente em foreground quando precisa do resultado antes de continuar. O padrão muda onde um subagente é executado, não o que é permitido fazer: subagentes em background ainda exibem cada prompt de permissão em sua sessão principal. Antes da v2.1.198, Claude escolhia entre foreground e background baseado na tarefa.786A partir da v2.1.198, subagentes são executados em background por padrão. Claude executa um subagente em foreground quando precisa do resultado antes de continuar. O padrão muda onde um subagente é executado, não o que é permitido fazer: subagentes em background ainda exibem cada prompt de permissão em sua sessão principal. Antes da v2.1.198, Claude escolhia entre foreground e background baseado na tarefa.

787 787 

788Você também pode direcionar isso você mesmo:788Você também pode direcionar isso você mesmo:

789 789 

790* Peça a Claude para executar uma tarefa em background ou em foreground790* Peça a Claude para executar uma tarefa em background ou em foreground

791* Pressione **Ctrl+B** para colocar uma tarefa em execução em background791* Pressione **Ctrl+B** para colocar uma tarefa em execução em background

792 792 

793{/* min-version: 2.1.208 */}Um subagente em background que completa fica listado em [`/tasks`](/pt/commands), marcado como concluído e classificado abaixo do trabalho em execução, até que a sessão limpe sua lista de tarefas. Sua visualização de detalhes fica aberta quando o subagente termina. Subagentes que falham ou que você para deixam a lista. Antes da v2.1.208, um subagente concluído deixava a lista no momento em que terminava e sua visualização de detalhes fechava.793Um subagente em background que completa fica listado em [`/tasks`](/docs/pt/commands), marcado como concluído e classificado abaixo do trabalho em execução, até que a sessão limpe sua lista de tarefas. Sua visualização de detalhes fica aberta quando o subagente termina. Subagentes que falham ou que você para deixam a lista. Antes da v2.1.208, um subagente concluído deixava a lista no momento em que terminava e sua visualização de detalhes fechava.

794 794 

795Para desabilitar toda a funcionalidade de tarefa em background, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` para `1`. Veja [Variáveis de ambiente](/pt/env-vars).795Para desabilitar toda a funcionalidade de tarefa em background, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` para `1`. Veja [Variáveis de ambiente](/docs/pt/env-vars).

796 796 

797Quando [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) está definido para `1`, cada spawn de subagente é executado em background e o campo frontmatter `background` não tem efeito, porque o modo fork remove o parâmetro `run_in_background` da ferramenta `Agent`. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` tem precedência sobre o modo fork e mantém spawns de subagente em foreground.797Quando [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) está definido para `1`, cada spawn de subagente é executado em background e o campo frontmatter `background` não tem efeito, porque o modo fork remove o parâmetro `run_in_background` da ferramenta `Agent`. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` tem precedência sobre o modo fork e mantém spawns de subagente em foreground.

798 798 


800 Erros de API em subagentes800 Erros de API em subagentes

801</h3>801</h3>

802 802 

803{/* min-version: 2.1.199 */}A partir da v2.1.199, um subagente cuja execução termina em um erro de API, como um limite de uso ou um erro de servidor repetido, relata essa falha de volta para Claude em vez de retornar o texto de erro como se fossem os achados do subagente. O que Claude recebe depende de onde o subagente foi executado:803A partir da v2.1.199, um subagente cuja execução termina em um erro de API, como um limite de uso ou um erro de servidor repetido, relata essa falha de volta para Claude em vez de retornar o texto de erro como se fossem os achados do subagente. O que Claude recebe depende de onde o subagente foi executado:

804 804 

805* **Foreground**: se um limite de taxa, sobrecarga ou erro de servidor corta um subagente que já produziu saída de texto, a ferramenta Agent retorna essa saída parcial com uma nota de que o subagente foi cortado e não completou sua tarefa. {/* min-version: 2.1.200 */}Um subagente que não produziu nada, ou cuja única saída foram chamadas de ferramenta, falha com [`Agent terminated early due to an API error`](/pt/errors#agent-terminated-early-due-to-an-api-error), seguido pelo detalhe do erro. Na v2.1.199, um limite de taxa, sobrecarga ou erro de servidor que cortou a forma de chamadas de ferramenta apenas retornou um resultado parcial vazio contendo apenas a nota de corte em vez disso.805* **Foreground**: se um limite de taxa, sobrecarga ou erro de servidor corta um subagente que já produziu saída de texto, a ferramenta Agent retorna essa saída parcial com uma nota de que o subagente foi cortado e não completou sua tarefa. Um subagente que não produziu nada, ou cuja única saída foram chamadas de ferramenta, falha com [`Agent terminated early due to an API error`](/docs/pt/errors#agent-terminated-early-due-to-an-api-error), seguido pelo detalhe do erro. Na v2.1.199, um limite de taxa, sobrecarga ou erro de servidor que cortou a forma de chamadas de ferramenta apenas retornou um resultado parcial vazio contendo apenas a nota de corte em vez disso.

806* **Background**: o subagente é marcado como falho, e a mensagem que Claude recebe quando termina nomeia o erro de API e inclui a última saída do subagente, então o trabalho parcial não é perdido.806* **Background**: o subagente é marcado como falho, e a mensagem que Claude recebe quando termina nomeia o erro de API e inclui a última saída do subagente, então o trabalho parcial não é perdido.

807 807 

808Uma vez que o erro de API subjacente seja resolvido, peça a Claude para tentar novamente a tarefa ou [retomar o subagente](#resume-subagents).808Uma vez que o erro de API subjacente seja resolvido, peça a Claude para tentar novamente a tarefa ou [retomar o subagente](#resume-subagents).


837 Quando subagentes completam, seus resultados retornam para sua conversa principal. Executar muitos subagentes que cada um retorna resultados detalhados pode consumir contexto significativo.837 Quando subagentes completam, seus resultados retornam para sua conversa principal. Executar muitos subagentes que cada um retorna resultados detalhados pode consumir contexto significativo.

838</Warning>838</Warning>

839 839 

840Para tarefas que precisam de paralelismo sustentado ou excedem sua janela de contexto, [equipes de agentes](/pt/agent-teams) dão a cada worker seu próprio contexto independente.840Para tarefas que precisam de paralelismo sustentado ou excedem sua janela de contexto, [equipes de agentes](/docs/pt/agent-teams) dão a cada worker seu próprio contexto independente.

841 841 

842<h4 id="chain-subagents">842<h4 id="chain-subagents">

843 Encadear subagentes843 Encadear subagentes


866* Você quer aplicar restrições de ferramentas específicas ou permissões866* Você quer aplicar restrições de ferramentas específicas ou permissões

867* O trabalho é auto-contido e pode retornar um resumo867* O trabalho é auto-contido e pode retornar um resumo

868 868 

869Considere [Skills](/pt/skills) em vez disso quando você quer prompts reutilizáveis ou fluxos de trabalho que são executados no contexto da conversa principal em vez de contexto de subagente isolado.869Considere [Skills](/docs/pt/skills) em vez disso quando você quer prompts reutilizáveis ou fluxos de trabalho que são executados no contexto da conversa principal em vez de contexto de subagente isolado.

870 870 

871Para uma pergunta rápida sobre algo já em sua conversa, use [`/btw`](/pt/interactive-mode#side-questions-with-%2Fbtw) em vez de um subagente. Ele vê seu contexto completo mas não tem acesso a ferramentas, e a resposta é descartada em vez de adicionada ao histórico.871Para uma pergunta rápida sobre algo já em sua conversa, use [`/btw`](/docs/pt/interactive-mode#side-questions-with-%2Fbtw) em vez de um subagente. Ele vê seu contexto completo mas não tem acesso a ferramentas, e a resposta é descartada em vez de adicionada ao histórico.

872 872 

873<h3 id="spawn-nested-subagents">873<h3 id="spawn-nested-subagents">

874 Gerar subagentes aninhados874 Gerar subagentes aninhados

875</h3>875</h3>

876 876 

877{/* min-version: 2.1.172 */}A partir do Claude Code v2.1.172, um subagente pode gerar seus próprios subagentes. Use isso quando uma tarefa delegada em si se divide em subtarefas paralelas, como um subagente revisor que distribui um verificador por descoberta, para que a saída intermediária nunca alcance sua conversa principal. Apenas o resumo do subagente de nível superior retorna para você.877A partir do Claude Code v2.1.172, um subagente pode gerar seus próprios subagentes. Use isso quando uma tarefa delegada em si se divide em subtarefas paralelas, como um subagente revisor que distribui um verificador por descoberta, para que a saída intermediária nunca alcance sua conversa principal. Apenas o resumo do subagente de nível superior retorna para você.

878 878 

879Um subagente aninhado é configurado da mesma forma que um de nível superior e é resolvido dos mesmos [escopos](#choose-the-subagent-scope). O painel de subagente abaixo da entrada de prompt mostra a árvore completa: cada linha exibe uma contagem `(+N)` de descendentes, e {/* min-version: 2.1.193 */}a partir da v2.1.193, abrir uma linha mostra os irmãos desse subagente e filhos diretos com um caminho de volta para `main`.879Um subagente aninhado é configurado da mesma forma que um de nível superior e é resolvido dos mesmos [escopos](#choose-the-subagent-scope). O painel de subagente abaixo da entrada de prompt mostra a árvore completa: cada linha exibe uma contagem `(+N)` de descendentes, e a partir da v2.1.193, abrir uma linha mostra os irmãos desse subagente e filhos diretos com um caminho de volta para `main`.

880 880 

881A profundidade é contada como o número de níveis de subagente abaixo da conversa principal, independentemente de cada nível ser executado em [foreground ou background](#run-subagents-in-foreground-or-background). Um subagente na profundidade cinco não recebe a ferramenta Agent e não pode gerar mais. O limite é fixo e não configurável.881A profundidade é contada como o número de níveis de subagente abaixo da conversa principal, independentemente de cada nível ser executado em [foreground ou background](#run-subagents-in-foreground-or-background). Um subagente na profundidade cinco não recebe a ferramenta Agent e não pode gerar mais. O limite é fixo e não configurável.

882 882 


900 900 

901* **Prompt de sistema**: o prompt próprio do agente mais detalhes de ambiente que Claude Code acrescenta, não o prompt de sistema completo do Claude Code. Subagentes personalizados definem o seu no [corpo markdown](#write-subagent-files) ou campo `prompt`. Agentes integrados têm prompts predefinidos.901* **Prompt de sistema**: o prompt próprio do agente mais detalhes de ambiente que Claude Code acrescenta, não o prompt de sistema completo do Claude Code. Subagentes personalizados definem o seu no [corpo markdown](#write-subagent-files) ou campo `prompt`. Agentes integrados têm prompts predefinidos.

902* **Mensagem de tarefa**: o prompt de delegação que Claude escreve quando passa o trabalho.902* **Mensagem de tarefa**: o prompt de delegação que Claude escreve quando passa o trabalho.

903* **CLAUDE.md e memória**: cada nível da [hierarquia de memória](/pt/memory#how-claude-md-files-load) que a conversa principal carrega, incluindo `~/.claude/CLAUDE.md`, regras de projeto, `CLAUDE.local.md` e arquivos de política gerenciados. Os agentes integrados Explore e Plan pulam isso.903* **CLAUDE.md e memória**: cada nível da [hierarquia de memória](/docs/pt/memory#how-claude-md-files-load) que a conversa principal carrega, incluindo `~/.claude/CLAUDE.md`, regras de projeto, `CLAUDE.local.md` e arquivos de política gerenciados. Os agentes integrados Explore e Plan pulam isso.

904* **Status do Git**: um snapshot tirado no início da sessão pai. Ausente quando o diretório de trabalho não é um repositório Git ou quando [`includeGitInstructions`](/pt/settings#available-settings) é `false`. Explore e Plan pulam isso independentemente.904* **Status do Git**: um snapshot tirado no início da sessão pai. Ausente quando o diretório de trabalho não é um repositório Git ou quando [`includeGitInstructions`](/docs/pt/settings#available-settings) é `false`. Explore e Plan pulam isso independentemente.

905* **Skills pré-carregadas**: conteúdo completo de qualquer skill nomeada no campo [`skills`](#preload-skills-into-subagents) do agente. Agentes integrados não pré-carregam skills.905* **Skills pré-carregadas**: conteúdo completo de qualquer skill nomeada no campo [`skills`](#preload-skills-into-subagents) do agente. Agentes integrados não pré-carregam skills.

906* **Roster de irmãos**: um lembrete de sistema listando `main` e cada outro agente nomeado na sessão, cada um um valor `to` válido para [`SendMessage`](#resume-subagents). {/* min-version: 2.1.206 */}Requer Claude Code v2.1.206 ou posterior. O roster aparece apenas quando as ferramentas do subagente incluem `SendMessage` e pelo menos um outro agente tem um nome, seja Claude o nomeou ao gerá-lo ou ele é executado como um colega de [equipe de agentes](/pt/agent-teams). É um snapshot tirado quando o subagente começa, então agentes nomeados depois não aparecem.906* **Roster de irmãos**: um lembrete de sistema listando `main` e cada outro agente nomeado na sessão, cada um um valor `to` válido para [`SendMessage`](#resume-subagents). Requer Claude Code v2.1.206 ou posterior. O roster aparece apenas quando as ferramentas do subagente incluem `SendMessage` e pelo menos um outro agente tem um nome, seja Claude o nomeou ao gerá-lo ou ele é executado como um colega de [equipe de agentes](/docs/pt/agent-teams). É um snapshot tirado quando o subagente começa, então agentes nomeados depois não aparecem.

907 907 

908Explore e Plan são os únicos subagentes que omitem CLAUDE.md e status do Git. Não há campo de frontmatter ou configuração por-agente para mudar quais agentes pulam isso.908Explore e Plan são os únicos subagentes que omitem CLAUDE.md e status do Git. Não há campo de frontmatter ou configuração por-agente para mudar quais agentes pulam isso.

909 909 


919 919 

920Quando um subagente completa, Claude recebe seu ID de agente. Os agentes integrados Explore e Plan são de uma única execução e não retornam ID de agente, então eles não podem ser retomados; use `general-purpose` ou um subagente personalizado quando você precisar continuar o trabalho.920Quando um subagente completa, Claude recebe seu ID de agente. Os agentes integrados Explore e Plan são de uma única execução e não retornam ID de agente, então eles não podem ser retomados; use `general-purpose` ou um subagente personalizado quando você precisar continuar o trabalho.

921 921 

922Claude usa a ferramenta `SendMessage` com o ID do agente ou nome do agente como campo `to` para retomá-lo. `SendMessage` não requer que [equipes de agentes](/pt/agent-teams) estejam habilitadas; apenas mensagens de protocolo de equipe estruturadas como `shutdown_request` e `plan_approval_response` fazem.922Claude usa a ferramenta `SendMessage` com o ID do agente ou nome do agente como campo `to` para retomá-lo. `SendMessage` não requer que [equipes de agentes](/docs/pt/agent-teams) estejam habilitadas; apenas mensagens de protocolo de equipe estruturadas como `shutdown_request` e `plan_approval_response` fazem.

923 923 

924Para retomar um subagente, peça a Claude para continuar o trabalho anterior:924Para retomar um subagente, peça a Claude para continuar o trabalho anterior:

925 925 


933 933 

934Um subagente parado que recebe um `SendMessage` auto-retoma em background sem exigir uma nova invocação de `Agent`. O mesmo se aplica a um subagente que Claude parou com a ferramenta `TaskStop`.934Um subagente parado que recebe um `SendMessage` auto-retoma em background sem exigir uma nova invocação de `Agent`. O mesmo se aplica a um subagente que Claude parou com a ferramenta `TaskStop`.

935 935 

936{/* min-version: 2.1.191 */}A partir da v2.1.191, um subagente que você parou você mesmo, com `x` em `/tasks` ou uma solicitação SDK `stop_task`, não auto-retoma. A chamada `SendMessage` retorna uma recusa dizendo a Claude que o agente foi cancelado. Digite na transcrição desse subagente no painel de subagente para retomá-lo você mesmo, o que limpa a parada para que chamadas `SendMessage` posteriores possam auto-retomá-lo novamente.936A partir da v2.1.191, um subagente que você parou você mesmo, com `x` em `/tasks` ou uma solicitação SDK `stop_task`, não auto-retoma. A chamada `SendMessage` retorna uma recusa dizendo a Claude que o agente foi cancelado. Digite na transcrição desse subagente no painel de subagente para retomá-lo você mesmo, o que limpa a parada para que chamadas `SendMessage` posteriores possam auto-retomá-lo novamente.

937 937 

938Retomar inicia uma nova execução do agente sob o mesmo ID, então um subagente que já tinha falhado ou completado mostra como em execução novamente na lista de tarefas e nos eventos de tarefa do Agent SDK. Antes da v2.1.205, ele continuava mostrando seu status anterior de falha ou conclusão enquanto a execução retomada estava funcionando.938Retomar inicia uma nova execução do agente sob o mesmo ID, então um subagente que já tinha falhado ou completado mostra como em execução novamente na lista de tarefas e nos eventos de tarefa do Agent SDK. Antes da v2.1.205, ele continuava mostrando seu status anterior de falha ou conclusão enquanto a execução retomada estava funcionando.

939 939 

940{/* min-version: 2.1.199 */}A partir da v2.1.199, `SendMessage` verifica que um nome ainda se refere ao mesmo agente que alcançou anteriormente na conversa. Se um agente mais novo assumiu o nome, como um agente em background re-gerado que o reutilizou, Claude Code recusa o envio em vez de entregá-lo ao agente errado, e o erro relata qual agente o nome agora alcança para que Claude possa redirecionar. Para alcançar o agente anterior enquanto ainda está em execução, Claude o endereça pelo ID do agente do resultado de spawn. A verificação é escopo da conversa atual e é redefinida em `/clear`.940A partir da v2.1.199, `SendMessage` verifica que um nome ainda se refere ao mesmo agente que alcançou anteriormente na conversa. Se um agente mais novo assumiu o nome, como um agente em background re-gerado que o reutilizou, Claude Code recusa o envio em vez de entregá-lo ao agente errado, e o erro relata qual agente o nome agora alcança para que Claude possa redirecionar. Para alcançar o agente anterior enquanto ainda está em execução, Claude o endereça pelo ID do agente do resultado de spawn. A verificação é escopo da conversa atual e é redefinida em `/clear`.

941 941 

942{/* min-version: 2.1.198 */}A partir da v2.1.198, um subagente trata mensagens do agente que o lançou como direção de tarefa normal, incluindo correções de curso no meio da tarefa, e age sobre elas dentro de suas próprias configurações de permissão. Dois limites ainda se mantêm independentemente de quem enviou a mensagem: nenhuma mensagem de qualquer agente conta como sua aprovação para um prompt de permissão pendente, e nenhuma mensagem de agente pode mudar as configurações de permissão, `CLAUDE.md` ou configuração de um subagente. Apenas o sistema de permissão ou suas próprias mensagens podem conceder aprovação.942A partir da v2.1.198, um subagente trata mensagens do agente que o lançou como direção de tarefa normal, incluindo correções de curso no meio da tarefa, e age sobre elas dentro de suas próprias configurações de permissão. Dois limites ainda se mantêm independentemente de quem enviou a mensagem: nenhuma mensagem de qualquer agente conta como sua aprovação para um prompt de permissão pendente, e nenhuma mensagem de agente pode mudar as configurações de permissão, `CLAUDE.md` ou configuração de um subagente. Apenas o sistema de permissão ou suas próprias mensagens podem conceder aprovação.

943 943 

944Você também pode pedir a Claude pelo ID do agente se quiser referenciá-lo explicitamente, ou encontrar IDs nos arquivos de transcrição em `~/.claude/projects/{project}/{sessionId}/subagents/`. Cada transcrição é armazenada como `agent-{agentId}.jsonl`.944Você também pode pedir a Claude pelo ID do agente se quiser referenciá-lo explicitamente, ou encontrar IDs nos arquivos de transcrição em `~/.claude/projects/{project}/{sessionId}/subagents/`. Cada transcrição é armazenada como `agent-{agentId}.jsonl`.

945 945 


953 Auto-compactação953 Auto-compactação

954</h4>954</h4>

955 955 

956Subagentes suportam compactação automática usando a mesma lógica que a conversa principal. A compactação é acionada sob as mesmas condições, e `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` se aplica a subagentes também. Veja [variáveis de ambiente](/pt/env-vars) para quando a sobrescrita entra em efeito.956Subagentes suportam compactação automática usando a mesma lógica que a conversa principal. A compactação é acionada sob as mesmas condições, e `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` se aplica a subagentes também. Veja [variáveis de ambiente](/docs/pt/env-vars) para quando a sobrescrita entra em efeito.

957 957 

958Eventos de compactação são registrados em arquivos de transcrição de subagente:958Eventos de compactação são registrados em arquivos de transcrição de subagente:

959 959 


975</h2>975</h2>

976 976 

977<Note>977<Note>

978 Subagentes bifurcados requerem Claude Code v2.1.117 ou posterior. {/* min-version: 2.1.161 */}A partir da v2.1.161, o comando `/fork` está habilitado por padrão; em versões anteriores, requer definir a variável de ambiente [`CLAUDE_CODE_FORK_SUBAGENT`](/pt/env-vars) para `1`. Deixar Claude gerar bifurcações é experimental e pode mudar em versões futuras. Esta capacidade também pode ser habilitada em sessões interativas como parte de um lançamento em fases.978 Subagentes bifurcados requerem Claude Code v2.1.117 ou posterior. A partir da v2.1.161, o comando `/fork` está habilitado por padrão; em versões anteriores, requer definir a variável de ambiente [`CLAUDE_CODE_FORK_SUBAGENT`](/docs/pt/env-vars) para `1`. Deixar Claude gerar bifurcações é experimental e pode mudar em versões futuras. Esta capacidade também pode ser habilitada em sessões interativas como parte de um lançamento em fases.

979</Note>979</Note>

980 980 

981Uma bifurcação é um subagente que herda toda a conversa até agora em vez de começar do zero. Isso remove o isolamento de entrada que subagentes de outra forma fornecem: uma bifurcação vê o mesmo prompt de sistema, ferramentas, modelo e histórico de mensagens que a sessão principal, para que você possa entregar uma tarefa secundária sem re-explicar a situação. As chamadas de ferramentas da bifurcação ainda ficam fora de sua conversa e apenas seu resultado final volta, para que sua janela de contexto principal permaneça limpa. Use uma bifurcação quando um subagente nomeado precisaria de muito contexto para ser útil, ou quando você quer tentar várias abordagens em paralelo a partir do mesmo ponto de partida.981Uma bifurcação é um subagente que herda toda a conversa até agora em vez de começar do zero. Isso remove o isolamento de entrada que subagentes de outra forma fornecem: uma bifurcação vê o mesmo prompt de sistema, ferramentas, modelo e histórico de mensagens que a sessão principal, para que você possa entregar uma tarefa secundária sem re-explicar a situação. As chamadas de ferramentas da bifurcação ainda ficam fora de sua conversa e apenas seu resultado final volta, para que sua janela de contexto principal permaneça limpa. Use uma bifurcação quando um subagente nomeado precisaria de muito contexto para ser útil, ou quando você quer tentar várias abordagens em paralelo a partir do mesmo ponto de partida.

982 982 

983Para controlar o modo de bifurcação independentemente do lançamento em fases, defina [`CLAUDE_CODE_FORK_SUBAGENT`](/pt/env-vars) para `1` para habilitá-lo explicitamente ou para `0` para desabilitá-lo. A variável é respeitada em modo interativo e via SDK ou `claude -p`.983Para controlar o modo de bifurcação independentemente do lançamento em fases, defina [`CLAUDE_CODE_FORK_SUBAGENT`](/docs/pt/env-vars) para `1` para habilitá-lo explicitamente ou para `0` para desabilitá-lo. A variável é respeitada em modo interativo e via SDK ou `claude -p`.

984 984 

985Habilitar o modo de bifurcação muda Claude Code de duas formas:985Habilitar o modo de bifurcação muda Claude Code de duas formas:

986 986 


1008| `x` | Descartar uma bifurcação terminada ou parar uma em execução |1008| `x` | Descartar uma bifurcação terminada ou parar uma em execução |

1009| `Esc` | Retornar foco para a entrada de prompt |1009| `Esc` | Retornar foco para a entrada de prompt |

1010 1010 

1011Com a transcrição de uma bifurcação ou subagente aberta, mensagens de acompanhamento e [skills](/pt/skills) vão para esse agente, mas comandos integrados ainda são executados em sua conversa principal. {/* min-version: 2.1.199 */}A partir da v2.1.199, digitar `/model` ou `/fast` nessa visualização mostra um aviso de que isso muda o modelo da conversa principal ou modo rápido, não do agente visualizado, em vez de executá-lo silenciosamente.1011Com a transcrição de uma bifurcação ou subagente aberta, mensagens de acompanhamento e [skills](/docs/pt/skills) vão para esse agente, mas comandos integrados ainda são executados em sua conversa principal. A partir da v2.1.199, digitar `/model` ou `/fast` nessa visualização mostra um aviso de que isso muda o modelo da conversa principal ou modo rápido, não do agente visualizado, em vez de executá-lo silenciosamente.

1012 1012 

1013<h3 id="how-forks-differ-from-named-subagents">1013<h3 id="how-forks-differ-from-named-subagents">

1014 Como bifurcações diferem de subagentes nomeados1014 Como bifurcações diferem de subagentes nomeados


1024| Permissions | Prompts aparecem em seu terminal | [Prompts aparecem em sua sessão principal](#run-subagents-in-foreground-or-background) quando em execução em background |1024| Permissions | Prompts aparecem em seu terminal | [Prompts aparecem em sua sessão principal](#run-subagents-in-foreground-or-background) quando em execução em background |

1025| Prompt cache | Compartilhado com a sessão principal | Cache separado |1025| Prompt cache | Compartilhado com a sessão principal | Cache separado |

1026 1026 

1027Porque o prompt de sistema de uma bifurcação e as definições de ferramentas são idênticas ao pai, sua primeira solicitação reutiliza o [prompt cache](/pt/prompt-caching#subagents-and-the-cache) do pai. Isso torna bifurcação mais barata do que gerar um subagente fresco para tarefas que precisam do mesmo contexto.1027Porque o prompt de sistema de uma bifurcação e as definições de ferramentas são idênticas ao pai, sua primeira solicitação reutiliza o [prompt cache](/docs/pt/prompt-caching#subagents-and-the-cache) do pai. Isso torna bifurcação mais barata do que gerar um subagente fresco para tarefas que precisam do mesmo contexto.

1028 1028 

1029Quando Claude gera uma bifurcação através da ferramenta Agent, ele pode passar `isolation: "worktree"` para que as edições de arquivo da bifurcação sejam escritas em um git worktree separado em vez de seu checkout.1029Quando Claude gera uma bifurcação através da ferramenta Agent, ele pode passar `isolation: "worktree"` para que as edições de arquivo da bifurcação sejam escritas em um git worktree separado em vez de seu checkout.

1030 1030 


1032 Limitações1032 Limitações

1033</h3>1033</h3>

1034 1034 

1035Definir `CLAUDE_CODE_FORK_SUBAGENT=1` habilita fork mode em sessões interativas, [modo não-interativo](/pt/headless) e o Agent SDK; definir para `0` desabilita fork mode em todos os lugares, incluindo qualquer lançamento no servidor. Uma bifurcação não pode gerar bifurcações adicionais.1035Definir `CLAUDE_CODE_FORK_SUBAGENT=1` habilita fork mode em sessões interativas, [modo não-interativo](/docs/pt/headless) e o Agent SDK; definir para `0` desabilita fork mode em todos os lugares, incluindo qualquer lançamento no servidor. Uma bifurcação não pode gerar bifurcações adicionais.

1036 1036 

1037<h2 id="example-subagents">1037<h2 id="example-subagents">

1038 Subagentes de exemplo1038 Subagentes de exemplo


1195You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.1195You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.

1196```1196```

1197 1197 

1198Claude Code [passa entrada de hook como JSON](/pt/hooks#pretooluse-input) via stdin para comandos de hook. O script de validação lê este JSON, extrai o comando sendo executado e o verifica contra uma lista de operações de escrita SQL. Se uma operação de escrita é detectada, o script [sai com código 2](/pt/hooks#exit-code-2-behavior-per-event) para bloquear execução e retorna uma mensagem de erro para Claude via stderr.1198Claude Code [passa entrada de hook como JSON](/docs/pt/hooks#pretooluse-input) via stdin para comandos de hook. O script de validação lê este JSON, extrai o comando sendo executado e o verifica contra uma lista de operações de escrita SQL. Se uma operação de escrita é detectada, o script [sai com código 2](/docs/pt/hooks#exit-code-2-behavior-per-event) para bloquear execução e retorna uma mensagem de erro para Claude via stderr.

1199 1199 

1200Crie o script de validação em qualquer lugar em seu projeto. O caminho deve corresponder ao campo `command` em sua configuração de hook:1200Crie o script de validação em qualquer lugar em seu projeto. O caminho deve corresponder ao campo `command` em sua configuração de hook:

1201 1201 


1228chmod +x ./scripts/validate-readonly-query.sh1228chmod +x ./scripts/validate-readonly-query.sh

1229```1229```

1230 1230 

1231No Windows, escreva o script de validação em PowerShell e adicione `shell: powershell` à entrada de hook. Veja [executando hooks em PowerShell](/pt/hooks#windows-powershell-tool).1231No Windows, escreva o script de validação em PowerShell e adicione `shell: powershell` à entrada de hook. Veja [executando hooks em PowerShell](/docs/pt/hooks#windows-powershell-tool).

1232 1232 

1233O hook recebe JSON via stdin com o comando Bash em `tool_input.command`. Código de saída 2 bloqueia a operação e alimenta a mensagem de erro de volta para Claude. Veja [Hooks](/pt/hooks#exit-code-output) para detalhes sobre códigos de saída e [Hook input](/pt/hooks#pretooluse-input) para o schema de entrada completo.1233O hook recebe JSON via stdin com o comando Bash em `tool_input.command`. Código de saída 2 bloqueia a operação e alimenta a mensagem de erro de volta para Claude. Veja [Hooks](/docs/pt/hooks#exit-code-output) para detalhes sobre códigos de saída e [Hook input](/docs/pt/hooks#pretooluse-input) para o schema de entrada completo.

1234 1234 

1235<h2 id="next-steps">1235<h2 id="next-steps">

1236 Próximos passos1236 Próximos passos


1238 1238 

1239Agora que você entende subagentes, explore estes recursos relacionados:1239Agora que você entende subagentes, explore estes recursos relacionados:

1240 1240 

1241* [Distribuir subagentes com plugins](/pt/plugins) para compartilhar subagentes entre equipes ou projetos1241* [Distribuir subagentes com plugins](/docs/pt/plugins) para compartilhar subagentes entre equipes ou projetos

1242* [Executar Claude Code programaticamente](/pt/headless) com o Agent SDK para CI/CD e automação1242* [Executar Claude Code programaticamente](/docs/pt/headless) com o Agent SDK para CI/CD e automação

1243* [Usar MCP servers](/pt/mcp) para dar aos subagentes acesso a ferramentas e dados externos1243* [Usar MCP servers](/docs/pt/mcp) para dar aos subagentes acesso a ferramentas e dados externos

tools-reference.md +73 −73

Details

6 6 

7> Referência completa para as ferramentas que Claude Code pode usar, incluindo requisitos de permissão e comportamento por ferramenta.7> Referência completa para as ferramentas que Claude Code pode usar, incluindo requisitos de permissão e comportamento por ferramenta.

8 8 

9Claude Code tem acesso a um conjunto de ferramentas integradas que o ajudam a entender e modificar sua base de código. Os nomes das ferramentas são as strings exatas que você usa em [regras de permissão](/pt/permissions#tool-specific-permission-rules), [listas de ferramentas de subagent](/pt/sub-agents) e [correspondências de hooks](/pt/hooks). Para desabilitar uma ferramenta completamente, adicione seu nome ao array `deny` em suas [configurações de permissão](/pt/permissions#tool-specific-permission-rules).9Claude Code tem acesso a um conjunto de ferramentas integradas que o ajudam a entender e modificar sua base de código. Os nomes das ferramentas são as strings exatas que você usa em [regras de permissão](/docs/pt/permissions#tool-specific-permission-rules), [listas de ferramentas de subagent](/docs/pt/sub-agents) e [correspondências de hooks](/docs/pt/hooks). Para desabilitar uma ferramenta completamente, adicione seu nome ao array `deny` em suas [configurações de permissão](/docs/pt/permissions#tool-specific-permission-rules).

10 10 

11Para adicionar ferramentas personalizadas, conecte um [servidor MCP](/pt/mcp). Para estender Claude com fluxos de trabalho baseados em prompts reutilizáveis, escreva uma [skill](/pt/skills), que é executada através da ferramenta `Skill` existente em vez de adicionar uma nova entrada de ferramenta.11Para adicionar ferramentas personalizadas, conecte um [servidor MCP](/docs/pt/mcp). Para estender Claude com fluxos de trabalho baseados em prompts reutilizáveis, escreva uma [skill](/docs/pt/skills), que é executada através da ferramenta `Skill` existente em vez de adicionar uma nova entrada de ferramenta.

12 12 

13A coluna Permissão necessária mostra se a ferramenta solicita no modo de permissão padrão para caminhos dentro do diretório de trabalho. Ferramentas de acesso a arquivos marcadas como Não, incluindo `Read`, `Grep` e `Glob`, ainda solicitam para caminhos fora do [diretório de trabalho e diretórios adicionais](/pt/permissions#working-directories). `Bash` é marcado como Sim, mas executa um conjunto integrado de [comandos somente leitura](/pt/permissions#read-only-commands) sem solicitar.13A coluna Permissão necessária mostra se a ferramenta solicita no modo de permissão padrão para caminhos dentro do diretório de trabalho. Ferramentas de acesso a arquivos marcadas como Não, incluindo `Read`, `Grep` e `Glob`, ainda solicitam para caminhos fora do [diretório de trabalho e diretórios adicionais](/docs/pt/permissions#working-directories). `Bash` é marcado como Sim, mas executa um conjunto integrado de [comandos somente leitura](/docs/pt/permissions#read-only-commands) sem solicitar.

14 14 

15| Ferramenta | Descrição | Permissão Necessária |15| Ferramenta | Descrição | Permissão Necessária |

16| :--------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |16| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

17| `Agent` | Cria um [subagent](/pt/sub-agents) com sua própria janela de contexto para lidar com uma tarefa. Veja [comportamento da ferramenta Agent](#agent-tool-behavior) | Não |17| `Agent` | Cria um [subagent](/docs/pt/sub-agents) com sua própria janela de contexto para lidar com uma tarefa. Veja [comportamento da ferramenta Agent](#agent-tool-behavior) | Não |

18| `Artifact` | Publica um arquivo HTML ou Markdown como um [artifact](/pt/artifacts): uma página privada e interativa no claude.ai. Você pode compartilhá-lo com um link público, ou dentro de sua organização em planos Team e Enterprise, onde o compartilhamento público requer que um Owner [o habilite](/pt/artifacts#control-public-sharing). {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Requer um plano Pro, Max, Team ou Enterprise e autenticação `/login`; veja [Disponibilidade](/pt/artifacts#availability) | Sim |18| `Artifact` | Publica um arquivo HTML ou Markdown como um [artifact](/docs/pt/artifacts): uma página privada e interativa no claude.ai. Você pode compartilhá-lo com um link público, ou dentro de sua organização em planos Team e Enterprise, onde o compartilhamento público requer que um Owner [o habilite](/docs/pt/artifacts#control-public-sharing). Requer um plano Pro, Max, Team ou Enterprise e autenticação `/login`; veja [Disponibilidade](/docs/pt/artifacts#availability) | Sim |

19| `AskUserQuestion` | Faz perguntas de múltipla escolha para coletar requisitos ou esclarecer ambiguidades. {/* min-version: 2.1.200 */}As perguntas permanecem abertas até que você as responda: não há tempo limite de inatividade por padrão. Para fazer um diálogo inativo continuar automaticamente, defina a configuração [`askUserQuestionTimeout`](/pt/settings#available-settings) como `60s`, `5m` ou `10m`, seja em seu `settings.json` do usuário ou na linha **Question auto-continue timeout** em `/config`. Depois que o tempo de inatividade escolhido passar sem entrada, o diálogo fecha por conta própria: ele envia todas as opções que você já havia selecionado e diz a Claude que você pode estar longe do teclado, para que Claude prossiga com seu próprio julgamento e possa fazer perguntas novamente mais tarde. Uma contagem regressiva aparece nos últimos 20 segundos. Qualquer pressionamento de tecla reinicia o temporizador, assim como uma janela focada em terminais que relatam foco. O tempo limite se aplica apenas às perguntas de múltipla escolha do `AskUserQuestion`; prompts de permissão, incluindo aprovação de plano, nunca se resolvem automaticamente em inatividade. Nas versões v2.1.198 e v2.1.199, o diálogo continuava automaticamente após 60 segundos de inatividade por padrão, e [`CLAUDE_AFK_TIMEOUT_MS`](/pt/env-vars#variables) era a única maneira de alterar isso | Não |19| `AskUserQuestion` | Faz perguntas de múltipla escolha para coletar requisitos ou esclarecer ambiguidades. As perguntas permanecem abertas até que você as responda: não há tempo limite de inatividade por padrão. Para fazer um diálogo inativo continuar automaticamente, defina a configuração [`askUserQuestionTimeout`](/docs/pt/settings#available-settings) como `60s`, `5m` ou `10m`, seja em seu `settings.json` do usuário ou na linha **Question auto-continue timeout** em `/config`. Depois que o tempo de inatividade escolhido passar sem entrada, o diálogo fecha por conta própria: ele envia todas as opções que você já havia selecionado e diz a Claude que você pode estar longe do teclado, para que Claude prossiga com seu próprio julgamento e possa fazer perguntas novamente mais tarde. Uma contagem regressiva aparece nos últimos 20 segundos. Qualquer pressionamento de tecla reinicia o temporizador, assim como uma janela focada em terminais que relatam foco. O tempo limite se aplica apenas às perguntas de múltipla escolha do `AskUserQuestion`; prompts de permissão, incluindo aprovação de plano, nunca se resolvem automaticamente em inatividade. Nas versões v2.1.198 e v2.1.199, o diálogo continuava automaticamente após 60 segundos de inatividade por padrão, e [`CLAUDE_AFK_TIMEOUT_MS`](/docs/pt/env-vars#variables) era a única maneira de alterar isso | Não |

20| `Bash` | Executa comandos de shell em seu ambiente. Veja [comportamento da ferramenta Bash](#bash-tool-behavior) | Sim |20| `Bash` | Executa comandos de shell em seu ambiente. Veja [comportamento da ferramenta Bash](#bash-tool-behavior) | Sim |

21| `CronCreate` | Agenda uma solicitação recorrente ou única dentro da sessão atual. As tarefas têm escopo de sessão e são restauradas em `--resume` ou `--continue` se não expiradas. Veja [tarefas agendadas](/pt/scheduled-tasks) | Não |21| `CronCreate` | Agenda uma solicitação recorrente ou única dentro da sessão atual. As tarefas têm escopo de sessão e são restauradas em `--resume` ou `--continue` se não expiradas. Veja [tarefas agendadas](/docs/pt/scheduled-tasks) | Não |

22| `CronDelete` | Cancela uma tarefa agendada por ID | Não |22| `CronDelete` | Cancela uma tarefa agendada por ID | Não |

23| `CronList` | Lista todas as tarefas agendadas na sessão | Não |23| `CronList` | Lista todas as tarefas agendadas na sessão | Não |

24| `Edit` | Faz edições direcionadas em arquivos específicos. Veja [comportamento da ferramenta Edit](#edit-tool-behavior) | Sim |24| `Edit` | Faz edições direcionadas em arquivos específicos. Veja [comportamento da ferramenta Edit](#edit-tool-behavior) | Sim |

25| `EnterPlanMode` | Muda para Plan Mode para projetar uma abordagem antes de codificar | Não |25| `EnterPlanMode` | Muda para Plan Mode para projetar uma abordagem antes de codificar | Não |

26| `EnterWorktree` | Cria um [git worktree](/pt/worktrees) isolado e muda para ele. Passe um `path` para mudar para um worktree existente em vez de criar um novo. {/* min-version: 2.1.203 */}Na primeira entrada, o destino pode ser um worktree do repositório atual ou, em um espaço de trabalho multi-repositório, de um repositório aninhado dentro dele. Antes de v2.1.203, um worktree de um repositório aninhado era rejeitado. {/* min-version: 2.1.206 */}Um `path` fora de `.claude/worktrees/` solicita sua aprovação antes de entrar, já que move o diretório de trabalho da sessão e o acesso de escrita para esse local. A criação de novo worktree e caminhos sob `.claude/worktrees/` não solicitam. Antes de v2.1.206, Claude entrava em caminhos fora de `.claude/worktrees/` sem um prompt. De dentro de uma sessão de worktree, ou de um subagent com um diretório de trabalho fixado como [`isolation: worktree`](/pt/sub-agents#supported-frontmatter-fields), apenas a forma `path` está disponível e o destino deve estar sob `.claude/worktrees/` do repositório da sessão | Sim |26| `EnterWorktree` | Cria um [git worktree](/docs/pt/worktrees) isolado e muda para ele. Passe um `path` para mudar para um worktree existente em vez de criar um novo. Na primeira entrada, o destino pode ser um worktree do repositório atual ou, em um espaço de trabalho multi-repositório, de um repositório aninhado dentro dele. Antes de v2.1.203, um worktree de um repositório aninhado era rejeitado. Um `path` fora de `.claude/worktrees/` solicita sua aprovação antes de entrar, já que move o diretório de trabalho da sessão e o acesso de escrita para esse local. A criação de novo worktree e caminhos sob `.claude/worktrees/` não solicitam. Antes de v2.1.206, Claude entrava em caminhos fora de `.claude/worktrees/` sem um prompt. De dentro de uma sessão de worktree, ou de um subagent com um diretório de trabalho fixado como [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields), apenas a forma `path` está disponível e o destino deve estar sob `.claude/worktrees/` do repositório da sessão | Sim |

27| `ExitPlanMode` | Apresenta um plano para aprovação e sai do Plan Mode | Sim |27| `ExitPlanMode` | Apresenta um plano para aprovação e sai do Plan Mode | Sim |

28| `ExitWorktree` | Sai de uma sessão de worktree e retorna ao diretório original. Não disponível para subagents que já são executados em seu próprio diretório de trabalho, como com [`isolation: worktree`](/pt/sub-agents#supported-frontmatter-fields) | Não |28| `ExitWorktree` | Sai de uma sessão de worktree e retorna ao diretório original. Não disponível para subagents que já são executados em seu próprio diretório de trabalho, como com [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields) | Não |

29| `Glob` | Encontra arquivos com base em correspondência de padrões. Veja [comportamento da ferramenta Glob](#glob-tool-behavior) | Não |29| `Glob` | Encontra arquivos com base em correspondência de padrões. Veja [comportamento da ferramenta Glob](#glob-tool-behavior) | Não |

30| `Grep` | Pesquisa padrões no conteúdo de arquivos. Veja [comportamento da ferramenta Grep](#grep-tool-behavior) | Não |30| `Grep` | Pesquisa padrões no conteúdo de arquivos. Veja [comportamento da ferramenta Grep](#grep-tool-behavior) | Não |

31| `ListMcpResourcesTool` | Lista recursos expostos por [servidores MCP](/pt/mcp) conectados | Não |31| `ListMcpResourcesTool` | Lista recursos expostos por [servidores MCP](/docs/pt/mcp) conectados | Não |

32| `LSP` | Inteligência de código via servidores de linguagem: ir para definições, encontrar referências, relatar erros de tipo e avisos. Veja [comportamento da ferramenta LSP](#lsp-tool-behavior) | Não |32| `LSP` | Inteligência de código via servidores de linguagem: ir para definições, encontrar referências, relatar erros de tipo e avisos. Veja [comportamento da ferramenta LSP](#lsp-tool-behavior) | Não |

33| `Monitor` | Executa um comando em segundo plano e alimenta cada linha de saída de volta para Claude, para que ele possa reagir a entradas de log, mudanças de arquivo ou status consultado no meio da conversa. Também pode abrir um WebSocket e tratar cada mensagem recebida como um evento. Veja [ferramenta Monitor](#monitor-tool) | Sim |33| `Monitor` | Executa um comando em segundo plano e alimenta cada linha de saída de volta para Claude, para que ele possa reagir a entradas de log, mudanças de arquivo ou status consultado no meio da conversa. Também pode abrir um WebSocket e tratar cada mensagem recebida como um evento. Veja [ferramenta Monitor](#monitor-tool) | Sim |

34| `NotebookEdit` | Modifica células de notebook Jupyter. Veja [comportamento da ferramenta NotebookEdit](#notebookedit-tool-behavior) | Sim |34| `NotebookEdit` | Modifica células de notebook Jupyter. Veja [comportamento da ferramenta NotebookEdit](#notebookedit-tool-behavior) | Sim |

35| `PowerShell` | Executa comandos PowerShell nativamente. Veja [ferramenta PowerShell](#powershell-tool) para disponibilidade | Sim |35| `PowerShell` | Executa comandos PowerShell nativamente. Veja [ferramenta PowerShell](#powershell-tool) para disponibilidade | Sim |

36| `PushNotification` | Envia uma notificação de desktop e um push de telefone quando [Remote Control](/pt/remote-control) está conectado, para que uma tarefa de longa duração ou [tarefa agendada](/pt/scheduled-tasks) possa alcançá-lo quando você se afastar. {/* plan-availability: feature=push-notifications providers=anthropic */}A entrega de push é executada através de infraestrutura hospedada pela Anthropic, que não é acessível do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry | Não |36| `PushNotification` | Envia uma notificação de desktop e um push de telefone quando [Remote Control](/docs/pt/remote-control) está conectado, para que uma tarefa de longa duração ou [tarefa agendada](/docs/pt/scheduled-tasks) possa alcançá-lo quando você se afastar. A entrega de push é executada através de infraestrutura hospedada pela Anthropic, que não é acessível do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry | Não |

37| `Read` | Lê o conteúdo de arquivos. Veja [comportamento da ferramenta Read](#read-tool-behavior) | Não |37| `Read` | Lê o conteúdo de arquivos. Veja [comportamento da ferramenta Read](#read-tool-behavior) | Não |

38| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |38| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |

39| `RemoteTrigger` | Cria, atualiza, executa e lista [Routines](/pt/routines) no claude.ai. Suporta o comando `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines vivem no claude.ai e requerem um plano Pro, Max, Team ou Enterprise, portanto esta ferramenta não é acessível do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry | Não |39| `RemoteTrigger` | Cria, atualiza, executa e lista [Routines](/docs/pt/routines) no claude.ai. Suporta o comando `/schedule`. Routines vivem no claude.ai e requerem um plano Pro, Max, Team ou Enterprise, portanto esta ferramenta não é acessível do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry | Não |

40| `ReportFindings` | Relata descobertas de revisão de código como uma lista estruturada, com um arquivo, resumo e cenário de falha por descoberta, para que Claude Code possa renderizá-las em vez de imprimi-las como texto. Claude a chama quando instruções ativas de revisão de código dizem para fazê-lo. {/* min-version: 2.1.196 */}Requer Claude Code v2.1.196 ou posterior. {/* min-version: 2.1.199 */}A partir de v2.1.199, uma descoberta também pode carregar um slug `category` opcional, como `correctness` ou `test-coverage`, mostrado ao lado da localização do arquivo na lista renderizada | Não |40| `ReportFindings` | Relata descobertas de revisão de código como uma lista estruturada, com um arquivo, resumo e cenário de falha por descoberta, para que Claude Code possa renderizá-las em vez de imprimi-las como texto. Claude a chama quando instruções ativas de revisão de código dizem para fazê-lo. Requer Claude Code v2.1.196 ou posterior. A partir de v2.1.199, uma descoberta também pode carregar um slug `category` opcional, como `correctness` ou `test-coverage`, mostrado ao lado da localização do arquivo na lista renderizada | Não |

41| `ScheduleWakeup` | Reagenda a próxima iteração de um [`/loop` auto-paced](/pt/scheduled-tasks#let-claude-choose-the-interval). Claude chama isso no final de cada iteração para escolher quando a próxima será executada, entre um minuto e uma hora; você não a chama diretamente. Para encerrar o loop em vez disso, Claude a chama com `stop: true`, que cancela o wakeup pendente. {/* min-version: 2.1.202 */}O campo `stop` requer Claude Code v2.1.202 ou posterior. O wakeup pendente aparece em `session_crons` em [Stop hook input](/pt/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Não disponível no Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry, onde um prompt `/loop` sem intervalo é executado em um cronograma fixo | Não |41| `ScheduleWakeup` | Reagenda a próxima iteração de um [`/loop` auto-paced](/docs/pt/scheduled-tasks#let-claude-choose-the-interval). Claude chama isso no final de cada iteração para escolher quando a próxima será executada, entre um minuto e uma hora; você não a chama diretamente. Para encerrar o loop em vez disso, Claude a chama com `stop: true`, que cancela o wakeup pendente. O campo `stop` requer Claude Code v2.1.202 ou posterior. O wakeup pendente aparece em `session_crons` em [Stop hook input](/docs/pt/hooks#stop-input). Não disponível no Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry, onde um prompt `/loop` sem intervalo é executado em um cronograma fixo | Não |

42| `SendMessage` | Envia uma mensagem para um [membro da equipe de agentes](/pt/agent-teams), ou [retoma um subagent](/pt/sub-agents#resume-subagents) por seu ID de agente ou nome. Um subagent concluído retoma automaticamente em segundo plano; um subagent que você parou de `/tasks` não retoma e a chamada retorna uma recusa. Mensagens de protocolo de equipe estruturadas requerem equipes de agentes. Um receptor nunca trata uma mensagem de outro agente como seu consentimento ou aprovação. {/* min-version: 2.1.198 */}A partir de v2.1.198, um subagent trata uma mensagem do agente que o lançou como direção de tarefa normal em vez de como uma solicitação de pares. {/* min-version: 2.1.199 */}A partir de v2.1.199, um envio para um nome que agora se resolve para um agente diferente do que fez anteriormente na conversa é recusado em vez de entregue; veja [Retomar subagents](/pt/sub-agents#resume-subagents) | Não |42| `SendMessage` | Envia uma mensagem para um [membro da equipe de agentes](/docs/pt/agent-teams), ou [retoma um subagent](/docs/pt/sub-agents#resume-subagents) por seu ID de agente ou nome. Um subagent concluído retoma automaticamente em segundo plano; um subagent que você parou de `/tasks` não retoma e a chamada retorna uma recusa. Mensagens de protocolo de equipe estruturadas requerem equipes de agentes. Um receptor nunca trata uma mensagem de outro agente como seu consentimento ou aprovação. A partir de v2.1.198, um subagent trata uma mensagem do agente que o lançou como direção de tarefa normal em vez de como uma solicitação de pares. A partir de v2.1.199, um envio para um nome que agora se resolve para um agente diferente do que fez anteriormente na conversa é recusado em vez de entregue; veja [Retomar subagents](/docs/pt/sub-agents#resume-subagents) | Não |

43| `SendUserFile` | Envia arquivos da sessão para você com uma legenda opcional, para que um relatório gerado, diagrama, captura de tela ou artefato construído chegue ao seu dispositivo em vez de apenas ser mencionado na transcrição. {/* min-version: 2.1.196 */}A partir de v2.1.196, a entrada `display` opcional controla a apresentação: `render` abre o arquivo inline no cliente, `attach` mostra apenas um cartão de download, e quando não definido o cliente decide pelo tipo de arquivo. Disponível quando um cliente [Remote Control](/pt/remote-control) está conectado ou a sessão é executada em um ambiente de nuvem gerenciado como [Claude Code na web](/pt/claude-code-on-the-web). A entrega é executada através de infraestrutura hospedada pela Anthropic, portanto a ferramenta não está disponível no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry | Não |43| `SendUserFile` | Envia arquivos da sessão para você com uma legenda opcional, para que um relatório gerado, diagrama, captura de tela ou artefato construído chegue ao seu dispositivo em vez de apenas ser mencionado na transcrição. A partir de v2.1.196, a entrada `display` opcional controla a apresentação: `render` abre o arquivo inline no cliente, `attach` mostra apenas um cartão de download, e quando não definido o cliente decide pelo tipo de arquivo. Disponível quando um cliente [Remote Control](/docs/pt/remote-control) está conectado ou a sessão é executada em um ambiente de nuvem gerenciado como [Claude Code na web](/docs/pt/claude-code-on-the-web). A entrega é executada através de infraestrutura hospedada pela Anthropic, portanto a ferramenta não está disponível no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry | Não |

44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Carrega `ONBOARDING.md` e retorna um link de compartilhamento que colegas podem abrir no Claude Code. Chamado de `/team-onboarding` após o guia ser escrito. Disponível para assinantes do claude.ai em planos Pro, Max, Team e Enterprise | Sim |44| `ShareOnboardingGuide` | Carrega `ONBOARDING.md` e retorna um link de compartilhamento que colegas podem abrir no Claude Code. Chamado de `/team-onboarding` após o guia ser escrito. Disponível para assinantes do claude.ai em planos Pro, Max, Team e Enterprise | Sim |

45| `Skill` | Executa uma [skill](/pt/skills#control-who-invokes-a-skill) dentro da conversa principal | Sim |45| `Skill` | Executa uma [skill](/docs/pt/skills#control-who-invokes-a-skill) dentro da conversa principal | Sim |

46| `TaskCreate` | Cria uma nova tarefa na lista de tarefas | Não |46| `TaskCreate` | Cria uma nova tarefa na lista de tarefas | Não |

47| `TaskGet` | Recupera detalhes completos para uma tarefa específica | Não |47| `TaskGet` | Recupera detalhes completos para uma tarefa específica | Não |

48| `TaskList` | Lista todas as tarefas com seu status atual | Não |48| `TaskList` | Lista todas as tarefas com seu status atual | Não |

49| `TaskOutput` | Recupera saída de uma tarefa em segundo plano. Descontinuado em favor de `Read` no caminho do arquivo de saída da tarefa. {/* min-version: 2.1.203 */}Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes de fundo em execução por ID e descrição. Antes de v2.1.203, o erro nomeava apenas o ID ausente | Não |49| `TaskOutput` | Recupera saída de uma tarefa em segundo plano. Descontinuado em favor de `Read` no caminho do arquivo de saída da tarefa. Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes de fundo em execução por ID e descrição. Antes de v2.1.203, o erro nomeava apenas o ID ausente | Não |

50| `TaskStop` | Para uma tarefa em segundo plano em execução por ID. {/* min-version: 2.1.198 */}Também aceita um [membro da equipe de agentes](/pt/agent-teams) ou um agente de fundo nomeado por ID de agente ou nome. Antes de v2.1.198, aceitava apenas um ID de tarefa em segundo plano. {/* min-version: 2.1.203 */}Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes de fundo em execução por ID e descrição, incluindo agentes que outro agente gerou. Antes de v2.1.203, o erro listava colegas em execução e agentes nomeados, mas não agentes de fundo que outro agente gerou, portanto esses não podiam ser identificados ou parados da conversa principal | Não |50| `TaskStop` | Para uma tarefa em segundo plano em execução por ID. Também aceita um [membro da equipe de agentes](/docs/pt/agent-teams) ou um agente de fundo nomeado por ID de agente ou nome. Antes de v2.1.198, aceitava apenas um ID de tarefa em segundo plano. Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes de fundo em execução por ID e descrição, incluindo agentes que outro agente gerou. Antes de v2.1.203, o erro listava colegas em execução e agentes nomeados, mas não agentes de fundo que outro agente gerou, portanto esses não podiam ser identificados ou parados da conversa principal | Não |

51| `TaskUpdate` | Atualiza status da tarefa, dependências, detalhes ou deleta tarefas | Não |51| `TaskUpdate` | Atualiza status da tarefa, dependências, detalhes ou deleta tarefas | Não |

52| `TodoWrite` | {/* min-version: 2.1.142 */}Gerencia a lista de verificação de tarefas da sessão. Desabilitado por padrão a partir de v2.1.142 em favor de `TaskCreate`, `TaskGet`, `TaskList` e `TaskUpdate`. Defina `CLAUDE_CODE_ENABLE_TASKS=0` para reabilitar | Não |52| `TodoWrite` | Gerencia a lista de verificação de tarefas da sessão. Desabilitado por padrão a partir de v2.1.142 em favor de `TaskCreate`, `TaskGet`, `TaskList` e `TaskUpdate`. Defina `CLAUDE_CODE_ENABLE_TASKS=0` para reabilitar | Não |

53| `ToolSearch` | Pesquisa e carrega ferramentas diferidas quando [pesquisa de ferramentas](/pt/mcp#scale-with-mcp-tool-search) está ativada | Não |53| `ToolSearch` | Pesquisa e carrega ferramentas diferidas quando [pesquisa de ferramentas](/docs/pt/mcp#scale-with-mcp-tool-search) está ativada | Não |

54| `WaitForMcpServers` | Aguarda um ou mais [servidores MCP](/pt/mcp) que ainda estão se conectando em segundo plano, para que uma solicitação possa usar suas ferramentas sem reiniciar a sessão. Claude a chama quando um servidor necessário ainda não está conectado. Aparece apenas quando [pesquisa de ferramentas](/pt/mcp#scale-with-mcp-tool-search) está desabilitada, já que `ToolSearch` lida com a espera quando está ativada | Não |54| `WaitForMcpServers` | Aguarda um ou mais [servidores MCP](/docs/pt/mcp) que ainda estão se conectando em segundo plano, para que uma solicitação possa usar suas ferramentas sem reiniciar a sessão. Claude a chama quando um servidor necessário ainda não está conectado. Aparece apenas quando [pesquisa de ferramentas](/docs/pt/mcp#scale-with-mcp-tool-search) está desabilitada, já que `ToolSearch` lida com a espera quando está ativada | Não |

55| `WebFetch` | Busca conteúdo de uma URL especificada. Veja [comportamento da ferramenta WebFetch](#webfetch-tool-behavior) | Sim |55| `WebFetch` | Busca conteúdo de uma URL especificada. Veja [comportamento da ferramenta WebFetch](#webfetch-tool-behavior) | Sim |

56| `WebSearch` | Realiza pesquisas na web. Veja [comportamento da ferramenta WebSearch](#websearch-tool-behavior) | Sim |56| `WebSearch` | Realiza pesquisas na web. Veja [comportamento da ferramenta WebSearch](#websearch-tool-behavior) | Sim |

57| `Workflow` | Executa um [fluxo de trabalho dinâmico](/pt/workflows): um script que orquestra muitos subagents em segundo plano e retorna um resultado consolidado | Sim |57| `Workflow` | Executa um [fluxo de trabalho dinâmico](/docs/pt/workflows): um script que orquestra muitos subagents em segundo plano e retorna um resultado consolidado | Sim |

58| `Write` | Cria ou sobrescreve arquivos. Veja [comportamento da ferramenta Write](#write-tool-behavior) | Sim |58| `Write` | Cria ou sobrescreve arquivos. Veja [comportamento da ferramenta Write](#write-tool-behavior) | Sim |

59 59 

60<h2 id="configure-tools-with-permission-rules-and-hooks">60<h2 id="configure-tools-with-permission-rules-and-hooks">


63 63 

64Na maioria dos casos, Claude decide quando usar essas ferramentas e você não precisa nomeá-las quando interage com Claude. Você referencia nomes de ferramentas diretamente ao definir permissões e outras configurações:64Na maioria dos casos, Claude decide quando usar essas ferramentas e você não precisa nomeá-las quando interage com Claude. Você referencia nomes de ferramentas diretamente ao definir permissões e outras configurações:

65 65 

66* em [`permissions.allow` e `permissions.deny`](/pt/settings#available-settings) em configurações e na interface `/permissions`66* em [`permissions.allow` e `permissions.deny`](/docs/pt/settings#available-settings) em configurações e na interface `/permissions`

67* nos sinalizadores CLI [`--allowedTools` e `--disallowedTools`](/pt/cli-reference)67* nos sinalizadores CLI [`--allowedTools` e `--disallowedTools`](/docs/pt/cli-reference)

68* nas opções [`allowedTools` e `disallowedTools`](/pt/agent-sdk/permissions#allow-and-deny-rules) do Agent SDK68* nas opções [`allowedTools` e `disallowedTools`](/docs/pt/agent-sdk/permissions#allow-and-deny-rules) do Agent SDK

69* no [frontmatter `tools` ou `disallowedTools`](/pt/sub-agents#supported-frontmatter-fields) de um subagent69* no [frontmatter `tools` ou `disallowedTools`](/docs/pt/sub-agents#supported-frontmatter-fields) de um subagent

70* no frontmatter [`allowed-tools`](/pt/skills#frontmatter-reference) de uma skill70* no frontmatter [`allowed-tools`](/docs/pt/skills#frontmatter-reference) de uma skill

71* na [condição `if`](/pt/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field) de um hook71* na [condição `if`](/docs/pt/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field) de um hook

72 72 

73Todos esses aceitam o mesmo formato de regra, `ToolName(specifier)`. O especificador depende da ferramenta, e várias ferramentas compartilham um formato:73Todos esses aceitam o mesmo formato de regra, `ToolName(specifier)`. O especificador depende da ferramenta, e várias ferramentas compartilham um formato:

74 74 

75| Formato de regra | Aplica-se a | Detalhes |75| Formato de regra | Aplica-se a | Detalhes |

76| :----------------------------- | :------------------------ | :------------------------------------------------------------------------------------ |76| :----------------------------- | :------------------------ | :------------------------------------------------------------------------------------ |

77| `Bash(npm run *)` | Bash, Monitor | [Correspondência de padrão de comando](/pt/permissions#bash) |77| `Bash(npm run *)` | Bash, Monitor | [Correspondência de padrão de comando](/docs/pt/permissions#bash) |

78| `PowerShell(Get-ChildItem *)` | PowerShell | [Correspondência de padrão de comando](/pt/permissions#powershell) |78| `PowerShell(Get-ChildItem *)` | PowerShell | [Correspondência de padrão de comando](/docs/pt/permissions#powershell) |

79| `Read(~/secrets/**)` | Read, Grep, Glob, LSP | [Correspondência de padrão de caminho](/pt/permissions#read-and-edit) |79| `Read(~/secrets/**)` | Read, Grep, Glob, LSP | [Correspondência de padrão de caminho](/docs/pt/permissions#read-and-edit) |

80| `Edit(/src/**)` | Edit, Write, NotebookEdit | [Correspondência de padrão de caminho](/pt/permissions#read-and-edit) |80| `Edit(/src/**)` | Edit, Write, NotebookEdit | [Correspondência de padrão de caminho](/docs/pt/permissions#read-and-edit) |

81| `Skill(deploy *)` | Skill | [Correspondência de nome de skill](/pt/skills#restrict-claude%E2%80%99s-skill-access) |81| `Skill(deploy *)` | Skill | [Correspondência de nome de skill](/docs/pt/skills#restrict-claude%E2%80%99s-skill-access) |

82| `Agent(Explore)` | Agent | [Correspondência de tipo de subagent](/pt/permissions#agent-subagents) |82| `Agent(Explore)` | Agent | [Correspondência de tipo de subagent](/docs/pt/permissions#agent-subagents) |

83| `WebFetch(domain:example.com)` | WebFetch | [Correspondência de domínio](/pt/permissions#webfetch) |83| `WebFetch(domain:example.com)` | WebFetch | [Correspondência de domínio](/docs/pt/permissions#webfetch) |

84| `WebSearch` | WebSearch | Sem especificador; permitir ou negar a ferramenta como um todo |84| `WebSearch` | WebSearch | Sem especificador; permitir ou negar a ferramenta como um todo |

85 85 

86Ferramentas não listadas aqui, como `ExitPlanMode` ou `ShareOnboardingGuide`, aceitam apenas o nome da ferramenta sem especificador.86Ferramentas não listadas aqui, como `ExitPlanMode` ou `ShareOnboardingGuide`, aceitam apenas o nome da ferramenta sem especificador.

87 87 

88Uma regra de permissão `Edit(...)` também concede acesso de leitura ao mesmo caminho, portanto você não precisa de uma regra `Read(...)` correspondente. Uma regra de negação `Read(...)` também bloqueia a ferramenta Edit no mesmo caminho, incluindo a criação de um novo arquivo lá, porque a edição requer ler o resultado de volta. A verificação de negação `Read` em edições requer Claude Code v2.1.208 ou posterior.88Uma regra de permissão `Edit(...)` também concede acesso de leitura ao mesmo caminho, portanto você não precisa de uma regra `Read(...)` correspondente. Uma regra de negação `Read(...)` também bloqueia a ferramenta Edit no mesmo caminho, incluindo a criação de um novo arquivo lá, porque a edição requer ler o resultado de volta. A verificação de negação `Read` em edições requer Claude Code v2.1.208 ou posterior.

89 89 

90Os campos `matcher` de hooks usam nomes de ferramentas simples, não o formato de regra entre parênteses. Veja [padrões de correspondência](/pt/hooks#matcher-patterns) para as regras de correspondência. Para os nomes de campos que cada ferramenta passa para `tool_input` em hooks, veja a [referência de entrada PreToolUse](/pt/hooks#pretooluse-input).90Os campos `matcher` de hooks usam nomes de ferramentas simples, não o formato de regra entre parênteses. Veja [padrões de correspondência](/docs/pt/hooks#matcher-patterns) para as regras de correspondência. Para os nomes de campos que cada ferramenta passa para `tool_input` em hooks, veja a [referência de entrada PreToolUse](/docs/pt/hooks#pretooluse-input).

91 91 

92<h2 id="agent-tool-behavior">92<h2 id="agent-tool-behavior">

93 Comportamento da ferramenta Agent93 Comportamento da ferramenta Agent


95 95 

96A ferramenta Agent cria um subagent em uma janela de contexto separada. O subagent trabalha através de sua tarefa autonomamente, depois retorna um único resultado de texto para a conversa pai. O pai não vê as chamadas de ferramenta intermediárias ou saídas do subagent, apenas esse resultado final.96A ferramenta Agent cria um subagent em uma janela de contexto separada. O subagent trabalha através de sua tarefa autonomamente, depois retorna um único resultado de texto para a conversa pai. O pai não vê as chamadas de ferramenta intermediárias ou saídas do subagent, apenas esse resultado final.

97 97 

98Para limitar quantas voltas um subagent executa, defina `maxTurns` na [definição do subagent](/pt/sub-agents#supported-frontmatter-fields).98Para limitar quantas voltas um subagent executa, defina `maxTurns` na [definição do subagent](/docs/pt/sub-agents#supported-frontmatter-fields).

99 99 

100A mesma ferramenta Agent também inicia [subagents bifurcados](/pt/sub-agents#fork-the-current-conversation) quando o modo de bifurcação está ativado. Uma bifurcação herda a conversa pai completa em vez de começar do zero, sempre é executada em segundo plano e ainda exibe prompts de permissão em seu terminal. O resto desta seção descreve subagents nomeados.100A mesma ferramenta Agent também inicia [subagents bifurcados](/docs/pt/sub-agents#fork-the-current-conversation) quando o modo de bifurcação está ativado. Uma bifurcação herda a conversa pai completa em vez de começar do zero, sempre é executada em segundo plano e ainda exibe prompts de permissão em seu terminal. O resto desta seção descreve subagents nomeados.

101 101 

102Quais ferramentas um subagent nomeado pode usar depende dos campos `tools` e `disallowedTools` na [definição do subagent](/pt/sub-agents):102Quais ferramentas um subagent nomeado pode usar depende dos campos `tools` e `disallowedTools` na [definição do subagent](/docs/pt/sub-agents):

103 103 

104* **Nenhum campo definido**: o subagent herda todas as ferramentas disponíveis para o pai.104* **Nenhum campo definido**: o subagent herda todas as ferramentas disponíveis para o pai.

105* **Apenas `tools`**: o subagent obtém apenas as ferramentas listadas.105* **Apenas `tools`**: o subagent obtém apenas as ferramentas listadas.

106* **Apenas `disallowedTools`**: o subagent obtém todas as ferramentas pai exceto as listadas.106* **Apenas `disallowedTools`**: o subagent obtém todas as ferramentas pai exceto as listadas.

107* **Ambos definidos**: `disallowedTools` tem precedência. Uma ferramenta listada em ambos é removida.107* **Ambos definidos**: `disallowedTools` tem precedência. Uma ferramenta listada em ambos é removida.

108 108 

109Quando a lista `tools` de um subagent se resolve para nenhuma ferramenta, por exemplo porque cada entrada está com erro de digitação ou nomeia uma ferramenta que não está disponível para subagents, a ferramenta Agent retorna um erro listando essas entradas em vez de iniciar o subagent. {/* min-version: 2.1.208 */}Antes da v2.1.208, o subagent era iniciado sem ferramentas e poderia retornar um resultado vazio ou confuso.109Quando a lista `tools` de um subagent se resolve para nenhuma ferramenta, por exemplo porque cada entrada está com erro de digitação ou nomeia uma ferramenta que não está disponível para subagents, a ferramenta Agent retorna um erro listando essas entradas em vez de iniciar o subagent. Antes da v2.1.208, o subagent era iniciado sem ferramentas e poderia retornar um resultado vazio ou confuso.

110 110 

111Iniciar o subagent não solicita permissão por si só. Claude Code verifica as chamadas de ferramenta do subagent contra suas regras de permissão conforme ele é executado.111Iniciar o subagent não solicita permissão por si só. Claude Code verifica as chamadas de ferramenta do subagent contra suas regras de permissão conforme ele é executado.

112 112 

113{/* min-version: 2.1.198 */}A partir da v2.1.198, subagents são executados em segundo plano por padrão; Claude executa um em primeiro plano quando precisa do resultado antes de continuar.113A partir da v2.1.198, subagents são executados em segundo plano por padrão; Claude executa um em primeiro plano quando precisa do resultado antes de continuar.

114 114 

115* **Subagents em primeiro plano** mostram os mesmos prompts de permissão que você veria na conversa principal, no momento em que cada chamada de ferramenta acontece.115* **Subagents em primeiro plano** mostram os mesmos prompts de permissão que você veria na conversa principal, no momento em que cada chamada de ferramenta acontece.

116* **Subagents em segundo plano** {/* min-version: 2.1.186 */}exibem prompts de permissão em sua sessão principal a partir da v2.1.186. O prompt indica qual subagent está solicitando, e pressionar Esc nega essa chamada de ferramenta sem parar o subagent. Antes da v2.1.186, subagents em segundo plano negavam automaticamente qualquer chamada de ferramenta que de outra forma solicitaria e continuavam sem essa ferramenta.116* **Subagents em segundo plano** exibem prompts de permissão em sua sessão principal a partir da v2.1.186. O prompt indica qual subagent está solicitando, e pressionar Esc nega essa chamada de ferramenta sem parar o subagent. Antes da v2.1.186, subagents em segundo plano negavam automaticamente qualquer chamada de ferramenta que de outra forma solicitaria e continuavam sem essa ferramenta.

117 117 

118Para limitar o que um subagent pode alcançar em primeiro lugar, restrinja seu campo `tools`, deixe Bash fora da lista ou defina regras de negação em suas configurações, conforme descrito em [Controlar capacidades de subagent](/pt/sub-agents#control-subagent-capabilities). Para mais informações sobre como escolher entre primeiro plano e segundo plano, veja [Executar subagents em primeiro plano ou segundo plano](/pt/sub-agents#run-subagents-in-foreground-or-background).118Para limitar o que um subagent pode alcançar em primeiro lugar, restrinja seu campo `tools`, deixe Bash fora da lista ou defina regras de negação em suas configurações, conforme descrito em [Controlar capacidades de subagent](/docs/pt/sub-agents#control-subagent-capabilities). Para mais informações sobre como escolher entre primeiro plano e segundo plano, veja [Executar subagents em primeiro plano ou segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background).

119 119 

120<h2 id="bash-tool-behavior">120<h2 id="bash-tool-behavior">

121 Comportamento da ferramenta Bash121 Comportamento da ferramenta Bash


123 123 

124A ferramenta Bash executa cada comando em um processo separado com o seguinte comportamento de persistência:124A ferramenta Bash executa cada comando em um processo separado com o seguinte comportamento de persistência:

125 125 

126* Quando Claude executa `cd` na sessão principal, o novo diretório de trabalho é mantido para comandos Bash posteriores, desde que permaneça dentro do diretório do projeto ou um [diretório de trabalho adicional](/pt/permissions#working-directories) que você adicionou com `--add-dir`, `/add-dir` ou `additionalDirectories` nas configurações. Sessões de subagent nunca mantêm mudanças de diretório de trabalho.126* Quando Claude executa `cd` na sessão principal, o novo diretório de trabalho é mantido para comandos Bash posteriores, desde que permaneça dentro do diretório do projeto ou um [diretório de trabalho adicional](/docs/pt/permissions#working-directories) que você adicionou com `--add-dir`, `/add-dir` ou `additionalDirectories` nas configurações. Sessões de subagent nunca mantêm mudanças de diretório de trabalho.

127 * Se `cd` sair desses diretórios, Claude Code redefine para o diretório do projeto e anexa `Shell cwd was reset to <dir>` ao resultado da ferramenta.127 * Se `cd` sair desses diretórios, Claude Code redefine para o diretório do projeto e anexa `Shell cwd was reset to <dir>` ao resultado da ferramenta.

128 * Para desabilitar esse carregamento para que cada comando Bash comece no diretório do projeto, defina `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.128 * Para desabilitar esse carregamento para que cada comando Bash comece no diretório do projeto, defina `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

129* As variáveis de ambiente não persistem. Um `export` em um comando não estará disponível no próximo.129* As variáveis de ambiente não persistem. Um `export` em um comando não estará disponível no próximo.

130* Aliases e funções de shell definidas em seu arquivo de inicialização de shell estão disponíveis. No início da sessão, Claude Code carrega `~/.zshrc`, `~/.bashrc` ou `~/.profile` dependendo do seu shell, captura os aliases, funções e opções de shell resultantes e os aplica a cada comando Bash.130* Aliases e funções de shell definidas em seu arquivo de inicialização de shell estão disponíveis. No início da sessão, Claude Code carrega `~/.zshrc`, `~/.bashrc` ou `~/.profile` dependendo do seu shell, captura os aliases, funções e opções de shell resultantes e os aplica a cada comando Bash.

131 131 

132Ative seu virtualenv ou ambiente conda antes de iniciar Claude Code. Para fazer as variáveis de ambiente persistirem entre comandos Bash, defina [`CLAUDE_ENV_FILE`](/pt/env-vars) para um script de shell antes de iniciar Claude Code, ou use um [hook SessionStart](/pt/hooks#persist-environment-variables) para preenchê-lo dinamicamente.132Ative seu virtualenv ou ambiente conda antes de iniciar Claude Code. Para fazer as variáveis de ambiente persistirem entre comandos Bash, defina [`CLAUDE_ENV_FILE`](/docs/pt/env-vars) para um script de shell antes de iniciar Claude Code, ou use um [hook SessionStart](/docs/pt/hooks#persist-environment-variables) para preenchê-lo dinamicamente.

133 133 

134Dois limites limitam cada comando:134Dois limites limitam cada comando:

135 135 

136* **Timeout**: dois minutos por padrão. Claude pode solicitar até 10 minutos por comando com o parâmetro `timeout`. Substitua o padrão e o limite máximo com [`BASH_DEFAULT_TIMEOUT_MS` e `BASH_MAX_TIMEOUT_MS`](/pt/env-vars).136* **Timeout**: dois minutos por padrão. Claude pode solicitar até 10 minutos por comando com o parâmetro `timeout`. Substitua o padrão e o limite máximo com [`BASH_DEFAULT_TIMEOUT_MS` e `BASH_MAX_TIMEOUT_MS`](/docs/pt/env-vars).

137* **Comprimento de saída**: 30.000 caracteres por padrão. Quando um comando produz mais do que isso, Claude Code salva a saída completa em um arquivo no diretório da sessão e fornece a Claude o caminho do arquivo mais uma visualização curta do início. Claude lê ou pesquisa esse arquivo quando precisa do resto. Aumente o limite com [`BASH_MAX_OUTPUT_LENGTH`](/pt/env-vars), até um limite máximo de 150.000 caracteres.137* **Comprimento de saída**: 30.000 caracteres por padrão. Quando um comando produz mais do que isso, Claude Code salva a saída completa em um arquivo no diretório da sessão e fornece a Claude o caminho do arquivo mais uma visualização curta do início. Claude lê ou pesquisa esse arquivo quando precisa do resto. Aumente o limite com [`BASH_MAX_OUTPUT_LENGTH`](/docs/pt/env-vars), até um limite máximo de 150.000 caracteres.

138 138 

139Para processos de longa duração, como servidores de desenvolvimento ou compilações de observação, Claude pode definir `run_in_background: true` para iniciar o comando como uma tarefa em segundo plano e continuar trabalhando enquanto ele é executado. Liste e pare tarefas em segundo plano com `/tasks`. No modo não interativo com a flag `-p`, [tarefas em segundo plano terminam logo após o resultado final da execução](/pt/headless#background-tasks-at-exit).139Para processos de longa duração, como servidores de desenvolvimento ou compilações de observação, Claude pode definir `run_in_background: true` para iniciar o comando como uma tarefa em segundo plano e continuar trabalhando enquanto ele é executado. Liste e pare tarefas em segundo plano com `/tasks`. No modo não interativo com a flag `-p`, [tarefas em segundo plano terminam logo após o resultado final da execução](/docs/pt/headless#background-tasks-at-exit).

140 140 

141<h2 id="edit-tool-behavior">141<h2 id="edit-tool-behavior">

142 Comportamento da ferramenta Edit142 Comportamento da ferramenta Edit


144 144 

145A ferramenta Edit realiza substituição exata de string. Ela pega um `old_string` e um `new_string` e substitui o primeiro pelo segundo. Ela não usa regex ou correspondência difusa.145A ferramenta Edit realiza substituição exata de string. Ela pega um `old_string` e um `new_string` e substitui o primeiro pelo segundo. Ela não usa regex ou correspondência difusa.

146 146 

147Três verificações devem passar para que uma edição seja aplicada. Antes de qualquer uma delas, um caminho correspondido por uma [regra de negação `Read`](/pt/permissions#tool-specific-permission-rules) é recusado, incluindo a criação de um novo arquivo lá. A recusa requer Claude Code v2.1.208 ou posterior.147Três verificações devem passar para que uma edição seja aplicada. Antes de qualquer uma delas, um caminho correspondido por uma [regra de negação `Read`](/docs/pt/permissions#tool-specific-permission-rules) é recusado, incluindo a criação de um novo arquivo lá. A recusa requer Claude Code v2.1.208 ou posterior.

148 148 

149* **Leitura antes da edição**: Claude lê o arquivo na conversa atual antes de editá-lo, e uma leitura interrompida com um aviso [`PARTIAL view`](#read-tool-behavior) não conta. Claude Opus 4.6, Claude Haiku 4.5 e modelos mais antigos sempre exigem a leitura. Modelos mais novos podem editar um arquivo não lido quando a leitura não precisaria de um prompt de permissão e a ferramenta Read está disponível.149* **Leitura antes da edição**: Claude lê o arquivo na conversa atual antes de editá-lo, e uma leitura interrompida com um aviso [`PARTIAL view`](#read-tool-behavior) não conta. Claude Opus 4.6, Claude Haiku 4.5 e modelos mais antigos sempre exigem a leitura. Modelos mais novos podem editar um arquivo não lido quando a leitura não precisaria de um prompt de permissão e a ferramenta Read está disponível.

150* **Correspondência**: `old_string` deve aparecer no arquivo exatamente como escrito. Uma única diferença de caractere de espaço em branco ou indentação é suficiente para falhar.150* **Correspondência**: `old_string` deve aparecer no arquivo exatamente como escrito. Uma única diferença de caractere de espaço em branco ou indentação é suficiente para falhar.


154 154 

155Visualizar um arquivo com Bash também satisfaz o requisito de leitura antes da edição quando o comando é `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` ou `fgrep` em um único arquivo sem pipes ou redirecionamentos. Saída com pipe e outros comandos Bash não contam para a verificação de leitura antes da edição.155Visualizar um arquivo com Bash também satisfaz o requisito de leitura antes da edição quando o comando é `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` ou `fgrep` em um único arquivo sem pipes ou redirecionamentos. Saída com pipe e outros comandos Bash não contam para a verificação de leitura antes da edição.

156 156 

157Isso afeta apenas a elegibilidade de edição, não as permissões. [Regras de negação de Read e Edit](/pt/permissions#tool-specific-permission-rules) também se aplicam a comandos de arquivo que Claude Code reconhece em Bash, como `cat`, `head`, `tail`, `sed` e `grep`, mas não a subprocessos arbitrários que leem ou escrevem arquivos indiretamente, como um script Python ou Node que abre arquivos por si mesmo. O conjunto de comandos reconhecidos para regras de negação não é o mesmo que a lista de leitura antes da edição acima: por exemplo, `egrep` e `fgrep` contam para leitura antes da edição, mas não são verificados contra regras de negação de Read. Para imposição em nível de SO que cobre todos os processos, [ative o sandbox](/pt/sandboxing).157Isso afeta apenas a elegibilidade de edição, não as permissões. [Regras de negação de Read e Edit](/docs/pt/permissions#tool-specific-permission-rules) também se aplicam a comandos de arquivo que Claude Code reconhece em Bash, como `cat`, `head`, `tail`, `sed` e `grep`, mas não a subprocessos arbitrários que leem ou escrevem arquivos indiretamente, como um script Python ou Node que abre arquivos por si mesmo. O conjunto de comandos reconhecidos para regras de negação não é o mesmo que a lista de leitura antes da edição acima: por exemplo, `egrep` e `fgrep` contam para leitura antes da edição, mas não são verificados contra regras de negação de Read. Para imposição em nível de SO que cobre todos os processos, [ative o sandbox](/docs/pt/sandboxing).

158 158 

159<h2 id="glob-tool-behavior">159<h2 id="glob-tool-behavior">

160 Comportamento da ferramenta Glob160 Comportamento da ferramenta Glob


170 170 

171Glob não respeita `.gitignore` por padrão, portanto encontra arquivos ignorados pelo git junto com os rastreados. Isso difere de [Grep](#grep-tool-behavior), que pula arquivos ignorados pelo git. Para fazer Glob respeitar `.gitignore`, defina `CLAUDE_CODE_GLOB_NO_IGNORE=false` antes de iniciar Claude Code.171Glob não respeita `.gitignore` por padrão, portanto encontra arquivos ignorados pelo git junto com os rastreados. Isso difere de [Grep](#grep-tool-behavior), que pula arquivos ignorados pelo git. Para fazer Glob respeitar `.gitignore`, defina `CLAUDE_CODE_GLOB_NO_IGNORE=false` antes de iniciar Claude Code.

172 172 

173Um valor `pattern` ou `path` que contém um byte nulo retorna um erro pedindo a Claude para removê-lo. {/* min-version: 2.1.208 */}173Um valor `pattern` ou `path` que contém um byte nulo retorna um erro pedindo a Claude para removê-lo.&#x20;

174 174 

175<h2 id="grep-tool-behavior">175<h2 id="grep-tool-behavior">

176 Comportamento da ferramenta Grep176 Comportamento da ferramenta Grep


180 180 

181Grep é construído em [ripgrep](https://github.com/BurntSushi/ripgrep) e usa sintaxe regex do ripgrep, não grep POSIX. Padrões que incluem metacaracteres regex precisam ser escapados. Por exemplo, encontrar `interface{}` em código Go leva o padrão `interface\{\}`.181Grep é construído em [ripgrep](https://github.com/BurntSushi/ripgrep) e usa sintaxe regex do ripgrep, não grep POSIX. Padrões que incluem metacaracteres regex precisam ser escapados. Por exemplo, encontrar `interface{}` em código Go leva o padrão `interface\{\}`.

182 182 

183Um padrão, glob ou tipo de arquivo que ripgrep rejeita retorna um erro que inclui o diagnóstico do ripgrep, para que Claude possa corrigir a entrada e pesquisar novamente. {/* min-version: 2.1.208 */}Antes da v2.1.208, Claude Code relatava uma entrada rejeitada como `No files found` em vez de um erro, mesmo quando o texto pesquisado existia nos arquivos de destino.183Um padrão, glob ou tipo de arquivo que ripgrep rejeita retorna um erro que inclui o diagnóstico do ripgrep, para que Claude possa corrigir a entrada e pesquisar novamente. Antes da v2.1.208, Claude Code relatava uma entrada rejeitada como `No files found` em vez de um erro, mesmo quando o texto pesquisado existia nos arquivos de destino.

184 184 

185Três modos de saída controlam o que volta:185Três modos de saída controlam o que volta:

186 186 

187* `files_with_matches`: apenas caminhos de arquivo, sem conteúdo de linha. Este é o padrão.187* `files_with_matches`: apenas caminhos de arquivo, sem conteúdo de linha. Este é o padrão.

188* `content`: linhas correspondentes com arquivo e número de linha.188* `content`: linhas correspondentes com arquivo e número de linha.

189* `count`: contagem de correspondências por arquivo, seguida por um total em todos os arquivos correspondentes. {/* min-version: 2.1.208 */}O total cobre cada correspondência mesmo quando os parâmetros `head_limit` ou `offset` da ferramenta truncam as entradas listadas por arquivo. Antes da v2.1.208, o total apenas somava as entradas listadas.189* `count`: contagem de correspondências por arquivo, seguida por um total em todos os arquivos correspondentes. O total cobre cada correspondência mesmo quando os parâmetros `head_limit` ou `offset` da ferramenta truncam as entradas listadas por arquivo. Antes da v2.1.208, o total apenas somava as entradas listadas.

190 190 

191Claude pode escopar resultados por arquivo com o parâmetro `glob`, como `**/*.tsx`, ou por linguagem com o parâmetro `type`, como `py` ou `rust`. Por padrão, padrões correspondem dentro de uma única linha. Claude pode definir `multiline: true` para corresponder através de limites de linha.191Claude pode escopar resultados por arquivo com o parâmetro `glob`, como `**/*.tsx`, ou por linguagem com o parâmetro `type`, como `py` ou `rust`. Por padrão, padrões correspondem dentro de uma única linha. Claude pode definir `multiline: true` para corresponder através de limites de linha.

192 192 


206* Encontrar implementações de uma interface206* Encontrar implementações de uma interface

207* Rastrear hierarquias de chamadas207* Rastrear hierarquias de chamadas

208 208 

209A ferramenta fica inativa até que você instale um [plugin de inteligência de código](/pt/discover-plugins#code-intelligence) para sua linguagem. O plugin agrupa a configuração do servidor de linguagem, e você instala o binário do servidor separadamente.209A ferramenta fica inativa até que você instale um [plugin de inteligência de código](/docs/pt/discover-plugins#code-intelligence) para sua linguagem. O plugin agrupa a configuração do servidor de linguagem, e você instala o binário do servidor separadamente.

210 210 

211<h2 id="monitor-tool">211<h2 id="monitor-tool">

212 Ferramenta Monitor212 Ferramenta Monitor


224 224 

225Você continua trabalhando na mesma sessão e Claude intervém quando um evento chega. Pare um monitor pedindo a Claude para cancelá-lo ou encerrando a sessão.225Você continua trabalhando na mesma sessão e Claude intervém quando um evento chega. Pare um monitor pedindo a Claude para cancelá-lo ou encerrando a sessão.

226 226 

227Quando Monitor executa um comando, ele usa as mesmas [regras de permissão que Bash](/pt/permissions#tool-specific-permission-rules), portanto os padrões `allow` e `deny` que você definiu para Bash se aplicam aqui também. A [fonte WebSocket](#websocket-source) tem seu próprio prompt de aprovação.227Quando Monitor executa um comando, ele usa as mesmas [regras de permissão que Bash](/docs/pt/permissions#tool-specific-permission-rules), portanto os padrões `allow` e `deny` que você definiu para Bash se aplicam aqui também. A [fonte WebSocket](#websocket-source) tem seu próprio prompt de aprovação.

228 228 

229A ferramenta não está disponível no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Também não está disponível quando `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definido.229A ferramenta não está disponível no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Também não está disponível quando `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definido.

230 230 

231Plugins podem declarar monitores que iniciam automaticamente quando o plugin está ativo, em vez de pedir a Claude para iniciá-los. Veja [monitores de plugin](/pt/plugins-reference#monitors).231Plugins podem declarar monitores que iniciam automaticamente quando o plugin está ativo, em vez de pedir a Claude para iniciá-los. Veja [monitores de plugin](/docs/pt/plugins-reference#monitors).

232 232 

233<h3 id="websocket-source">233<h3 id="websocket-source">

234 Fonte WebSocket234 Fonte WebSocket


256 256 

257Abrir uma WebSocket solicita aprovação, e o prompt não oferece uma opção para pular prompts futuros para o mesmo host.257Abrir uma WebSocket solicita aprovação, e o prompt não oferece uma opção para pular prompts futuros para o mesmo host.

258 258 

259Claude Code nega URLs que apontam para um endereço privado, link-local ou de metadados em nuvem, incluindo nomes de host que resolvem para um. Também nega hosts em `sandbox.network.deniedDomains`, e quando [`allowManagedDomainsOnly`](/pt/settings#sandbox-settings) está definido nas configurações gerenciadas, qualquer host fora da lista de permissões gerenciada.259Claude Code nega URLs que apontam para um endereço privado, link-local ou de metadados em nuvem, incluindo nomes de host que resolvem para um. Também nega hosts em `sandbox.network.deniedDomains`, e quando [`allowManagedDomainsOnly`](/docs/pt/settings#sandbox-settings) está definido nas configurações gerenciadas, qualquer host fora da lista de permissões gerenciada.

260 260 

261<h2 id="notebookedit-tool-behavior">261<h2 id="notebookedit-tool-behavior">

262 Comportamento da ferramenta NotebookEdit262 Comportamento da ferramenta NotebookEdit


308 308 

309Três configurações adicionais controlam onde PowerShell é usado:309Três configurações adicionais controlam onde PowerShell é usado:

310 310 

311* `"defaultShell": "powershell"` em [`settings.json`](/pt/settings#available-settings): roteia comandos `!` interativos através do PowerShell. Requer que a ferramenta PowerShell esteja ativada.311* `"defaultShell": "powershell"` em [`settings.json`](/docs/pt/settings#available-settings): roteia comandos `!` interativos através do PowerShell. Requer que a ferramenta PowerShell esteja ativada.

312* `"shell": "powershell"` em [hooks de comando](/pt/hooks#command-hook-fields) individuais: executa esse hook em PowerShell. Hooks geram PowerShell diretamente, portanto isso funciona independentemente de `CLAUDE_CODE_USE_POWERSHELL_TOOL`.312* `"shell": "powershell"` em [hooks de comando](/docs/pt/hooks#command-hook-fields) individuais: executa esse hook em PowerShell. Hooks geram PowerShell diretamente, portanto isso funciona independentemente de `CLAUDE_CODE_USE_POWERSHELL_TOOL`.

313* `shell: powershell` em [frontmatter de skill](/pt/skills#frontmatter-reference): executa blocos `` !`command` `` em PowerShell. Requer que a ferramenta PowerShell esteja ativada.313* `shell: powershell` em [frontmatter de skill](/docs/pt/skills#frontmatter-reference): executa blocos `` !`command` `` em PowerShell. Requer que a ferramenta PowerShell esteja ativada.

314 314 

315O mesmo comportamento de redefinição de diretório de trabalho da sessão principal descrito na seção da ferramenta Bash se aplica aos comandos PowerShell, incluindo a variável de ambiente `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.315O mesmo comportamento de redefinição de diretório de trabalho da sessão principal descrito na seção da ferramenta Bash se aplica aos comandos PowerShell, incluindo a variável de ambiente `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.

316 316 

317{/* min-version: 2.1.196 */}A partir da v2.1.196, a ferramenta PowerShell corresponde ao tratamento da ferramenta Bash dos códigos de saída de busca e diff. O código de saída 1 de `grep`, `egrep`, `fgrep` e `git grep` significa nenhuma correspondência, e o código de saída 1 de `git diff` significa que existem diferenças, portanto esses resultados não são relatados a Claude como falhas de comando.317A partir da v2.1.196, a ferramenta PowerShell corresponde ao tratamento da ferramenta Bash dos códigos de saída de busca e diff. O código de saída 1 de `grep`, `egrep`, `fgrep` e `git grep` significa nenhuma correspondência, e o código de saída 1 de `git diff` significa que existem diferenças, portanto esses resultados não são relatados a Claude como falhas de comando.

318 318 

319<h3 id="preview-limitations">319<h3 id="preview-limitations">

320 Limitações da visualização320 Limitações da visualização


360* Respostas são armazenadas em cache por 15 minutos, portanto buscas repetidas da mesma URL retornam rapidamente.360* Respostas são armazenadas em cache por 15 minutos, portanto buscas repetidas da mesma URL retornam rapidamente.

361* Quando uma URL redireciona para um host diferente, WebFetch retorna um resultado de texto que nomeia a URL original e o alvo de redirecionamento em vez de segui-lo. Claude então busca a nova URL com uma segunda chamada WebFetch.361* Quando uma URL redireciona para um host diferente, WebFetch retorna um resultado de texto que nomeia a URL original e o alvo de redirecionamento em vez de segui-lo. Claude então busca a nova URL com uma segunda chamada WebFetch.

362 362 

363Nos modos de permissão padrão e `acceptEdits`, WebFetch solicita a primeira vez que atinge um novo domínio, exceto por um conjunto integrado de domínios de documentação pré-aprovados que buscam sem um prompt. Para permitir outro domínio antecipadamente sem um prompt, adicione uma regra de permissão como `WebFetch(domain:example.com)`. Os modos de permissão `auto` e `bypassPermissions` [permission modes](/pt/permissions#permission-modes) pulam o prompt inteiramente.363Nos modos de permissão padrão e `acceptEdits`, WebFetch solicita a primeira vez que atinge um novo domínio, exceto por um conjunto integrado de domínios de documentação pré-aprovados que buscam sem um prompt. Para permitir outro domínio antecipadamente sem um prompt, adicione uma regra de permissão como `WebFetch(domain:example.com)`. Os modos de permissão `auto` e `bypassPermissions` [permission modes](/docs/pt/permissions#permission-modes) pulam o prompt inteiramente.

364 364 

365Uma regra explícita `WebFetch(domain:...)` em `deny`, `ask` ou `allow` tem precedência sobre o conjunto pré-aprovado, portanto você pode bloquear um domínio pré-aprovado ou exigir um prompt para ele.365Uma regra explícita `WebFetch(domain:...)` em `deny`, `ask` ou `allow` tem precedência sobre o conjunto pré-aprovado, portanto você pode bloquear um domínio pré-aprovado ou exigir um prompt para ele.

366 366 

367WebFetch define um cabeçalho `User-Agent` começando com `Claude-User` e um cabeçalho `Accept` que prefere Markdown sobre HTML para que servidores que suportam negociação de conteúdo possam retornar Markdown diretamente.367WebFetch define um cabeçalho `User-Agent` começando com `Claude-User` e um cabeçalho `Accept` que prefere Markdown sobre HTML para que servidores que suportam negociação de conteúdo possam retornar Markdown diretamente.

368 368 

369Você configura regras de rede [sandbox](/pt/sandboxing) separadamente, portanto um domínio que você quer que um processo em sandbox alcance ainda precisa de uma regra de permissão de sandbox explícita.369Você configura regras de rede [sandbox](/docs/pt/sandboxing) separadamente, portanto um domínio que você quer que um processo em sandbox alcance ainda precisa de uma regra de permissão de sandbox explícita.

370 370 

371<h2 id="websearch-tool-behavior">371<h2 id="websearch-tool-behavior">

372 Comportamento da ferramenta WebSearch372 Comportamento da ferramenta WebSearch


376 376 

377A ferramenta pode emitir até oito pesquisas de backend por chamada, refinando a pesquisa internamente antes de retornar resultados. Claude pode escopar resultados com `allowed_domains` para incluir apenas certos hosts, ou `blocked_domains` para excluí-los. As duas listas não podem ser combinadas em uma única chamada.377A ferramenta pode emitir até oito pesquisas de backend por chamada, refinando a pesquisa internamente antes de retornar resultados. Claude pode escopar resultados com `allowed_domains` para incluir apenas certos hosts, ou `blocked_domains` para excluí-los. As duas listas não podem ser combinadas em uma única chamada.

378 378 

379O backend de pesquisa não é configurável. Para pesquisar com um provedor diferente, adicione um [servidor MCP](/pt/mcp) que exponha uma ferramenta de pesquisa.379O backend de pesquisa não é configurável. Para pesquisar com um provedor diferente, adicione um [servidor MCP](/docs/pt/mcp) que exponha uma ferramenta de pesquisa.

380 380 

381Regras de permissão WebSearch não levam especificador. Uma entrada `WebSearch` simples em `allow` ou `deny` é a única forma.381Regras de permissão WebSearch não levam especificador. Uma entrada `WebSearch` simples em `allow` ou `deny` é a única forma.

382 382 

383<Note>383<Note>

384 WebSearch está disponível na Claude API, [Claude Platform on AWS](/pt/claude-platform-on-aws), e Microsoft Foundry. No Google Cloud's Agent Platform funciona com modelos Claude 4 e posteriores, incluindo Opus, Sonnet e Haiku. Amazon Bedrock não expõe a ferramenta de pesquisa na web do lado do servidor.384 WebSearch está disponível na Claude API, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), e Microsoft Foundry. No Google Cloud's Agent Platform funciona com modelos Claude 4 e posteriores, incluindo Opus, Sonnet e Haiku. Amazon Bedrock não expõe a ferramenta de pesquisa na web do lado do servidor.

385</Note>385</Note>

386 386 

387<h2 id="write-tool-behavior">387<h2 id="write-tool-behavior">


409Claude fornece um resumo conversacional. Para nomes exatos de ferramentas MCP, execute `/mcp`.409Claude fornece um resumo conversacional. Para nomes exatos de ferramentas MCP, execute `/mcp`.

410 410 

411<Note>411<Note>

412 A [ferramenta advisor](/pt/advisor) é uma [ferramenta de servidor](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool) que a API executa, em vez de uma ferramenta que Claude Code implementa. Ela não tem um nome que você possa referenciar em regras de permissão ou correspondências de hook.412 A [ferramenta advisor](/docs/pt/advisor) é uma [ferramenta de servidor](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool) que a API executa, em vez de uma ferramenta que Claude Code implementa. Ela não tem um nome que você possa referenciar em regras de permissão ou correspondências de hook.

413</Note>413</Note>

414 414 

415<h2 id="see-also">415<h2 id="see-also">

416 Veja também416 Veja também

417</h2>417</h2>

418 418 

419* [Servidores MCP](/pt/mcp): adicione ferramentas personalizadas conectando servidores externos419* [Servidores MCP](/docs/pt/mcp): adicione ferramentas personalizadas conectando servidores externos

420* [Permissões](/pt/permissions): sistema de permissões, sintaxe de regras e padrões específicos de ferramentas420* [Permissões](/docs/pt/permissions): sistema de permissões, sintaxe de regras e padrões específicos de ferramentas

421* [Subagents](/pt/sub-agents): configure o acesso a ferramentas para subagents421* [Subagents](/docs/pt/sub-agents): configure o acesso a ferramentas para subagents

422* [Hooks](/pt/hooks-guide): execute comandos personalizados antes ou depois da execução da ferramenta422* [Hooks](/docs/pt/hooks-guide): execute comandos personalizados antes ou depois da execução da ferramenta

Details

6 6 

7> Corrija erros de comando não encontrado, PATH, permissão, rede e autenticação ao instalar ou fazer login no Claude Code.7> Corrija erros de comando não encontrado, PATH, permissão, rede e autenticação ao instalar ou fazer login no Claude Code.

8 8 

9Se a instalação falhar ou você não conseguir fazer login, encontre seu erro abaixo. Para problemas de tempo de execução após o Claude Code estar funcionando, consulte [Troubleshooting](/pt/troubleshooting). Para problemas de configuração, como configurações não sendo aplicadas ou hooks não disparando, consulte [Debug your configuration](/pt/debug-your-config).9Se a instalação falhar ou você não conseguir fazer login, encontre seu erro abaixo. Para problemas de tempo de execução após o Claude Code estar funcionando, consulte [Troubleshooting](/docs/pt/troubleshooting). Para problemas de configuração, como configurações não sendo aplicadas ou hooks não disparando, consulte [Debug your configuration](/docs/pt/debug-your-config).

10 10 

11<h2 id="find-your-error">11<h2 id="find-your-error">

12 Encontre seu erro12 Encontre seu erro


41| `OAuth error` ou `403 Forbidden` | [Corrija a autenticação](#login-and-authentication) |41| `OAuth error` ou `403 Forbidden` | [Corrija a autenticação](#login-and-authentication) |

42| `Could not load the default credentials` ou `Could not load credentials from any providers` | [Credenciais do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |42| `Could not load the default credentials` ou `Could not load credentials from any providers` | [Credenciais do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

43| `ChainedTokenCredential authentication failed` ou `CredentialUnavailableError` | [Credenciais do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |43| `ChainedTokenCredential authentication failed` ou `CredentialUnavailableError` | [Credenciais do Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

44| `API Error: 500`, `529 Overloaded`, `429`, ou outros erros 4xx e 5xx não listados acima | Consulte a [referência de erros](/pt/errors) |44| `API Error: 500`, `529 Overloaded`, `429`, ou outros erros 4xx e 5xx não listados acima | Consulte a [referência de erros](/docs/pt/errors) |

45 45 

46Se seu problema não estiver listado, trabalhe através das verificações de diagnóstico abaixo para estreitar a causa.46Se seu problema não estiver listado, trabalhe através das verificações de diagnóstico abaixo para estreitar a causa.

47 47 

48<Tip>48<Tip>

49 Se você preferir pular o terminal completamente, o [Claude Code Desktop app](/pt/desktop-quickstart) permite que você instale e use Claude Code através de uma interface gráfica. Baixe-o para [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) ou [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) e comece a codificar sem nenhuma configuração de linha de comando. No Linux, instale o aplicativo com apt seguindo as [instruções de instalação do Linux](/pt/desktop-linux).49 Se você preferir pular o terminal completamente, o [Claude Code Desktop app](/docs/pt/desktop-quickstart) permite que você instale e use Claude Code através de uma interface gráfica. Baixe-o para [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) ou [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) e comece a codificar sem nenhuma configuração de linha de comando. No Linux, instale o aplicativo com apt seguindo as [instruções de instalação do Linux](/docs/pt/desktop-linux).

50</Tip>50</Tip>

51 51 

52<h2 id="run-diagnostic-checks">52<h2 id="run-diagnostic-checks">


100Se a instalação foi bem-sucedida mas você recebe um erro `command not found` ou `not recognized` ao executar `claude`, o diretório de instalação não está em seu PATH. Seu shell procura por programas em diretórios listados em PATH, e o instalador coloca `claude` em `~/.local/bin/claude` no macOS/Linux ou `%USERPROFILE%\.local\bin\claude.exe` no Windows.100Se a instalação foi bem-sucedida mas você recebe um erro `command not found` ou `not recognized` ao executar `claude`, o diretório de instalação não está em seu PATH. Seu shell procura por programas em diretórios listados em PATH, e o instalador coloca `claude` em `~/.local/bin/claude` no macOS/Linux ou `%USERPROFILE%\.local\bin\claude.exe` no Windows.

101 101 

102<Note>102<Note>

103 A [extensão VS Code](/pt/vs-code) não coloca `claude` neste local. Ela agrupa uma cópia privada da CLI dentro do diretório da extensão para seu próprio painel de chat e não a adiciona ao PATH. Se você tiver instalado apenas a extensão, `~/.local/bin/claude` não existirá. Execute a [instalação autônoma](/pt/setup) para usar `claude` a partir de um terminal, depois continue abaixo.103 A [extensão VS Code](/docs/pt/vs-code) não coloca `claude` neste local. Ela agrupa uma cópia privada da CLI dentro do diretório da extensão para seu próprio painel de chat e não a adiciona ao PATH. Se você tiver instalado apenas a extensão, `~/.local/bin/claude` não existirá. Execute a [instalação autônoma](/docs/pt/setup) para usar `claude` a partir de um terminal, depois continue abaixo.

104</Note>104</Note>

105 105 

106Verifique se o diretório de instalação está em seu PATH listando suas entradas de PATH e filtrando por `local/bin`:106Verifique se o diretório de instalação está em seu PATH listando suas entradas de PATH e filtrando por `local/bin`:


196 ls -la ~/.local/bin/claude196 ls -la ~/.local/bin/claude

197 ```197 ```

198 198 

199 Uma instalação nativa mostra um symlink em `~/.local/share/claude/versions/`. Um script ou um symlink que você criou por conta própria neste caminho é um inicializador personalizado, que [auto-update deixa no lugar](/pt/setup#auto-updates).199 Uma instalação nativa mostra um symlink em `~/.local/share/claude/versions/`. Um script ou um symlink que você criou por conta própria neste caminho é um inicializador personalizado, que [auto-update deixa no lugar](/docs/pt/setup#auto-updates).

200 200 

201 Se algum comando `ls` imprimir `No such file or directory`, isso não é um erro. Significa que nada está instalado naquele local, então passe para a próxima verificação.201 Se algum comando `ls` imprimir `No such file or directory`, isso não é um erro. Significa que nada está instalado naquele local, então passe para a próxima verificação.

202 202 


294Get-Command claude | Select-Object Source294Get-Command claude | Select-Object Source

295```295```

296 296 

297No Linux, verifique se há bibliotecas compartilhadas ausentes. Se `ldd` mostrar bibliotecas ausentes, você pode precisar instalar pacotes do sistema. No Alpine Linux e outras distribuições baseadas em musl, consulte [Alpine Linux setup](/pt/setup#alpine-linux-and-musl-based-distributions).297No Linux, verifique se há bibliotecas compartilhadas ausentes. Se `ldd` mostrar bibliotecas ausentes, você pode precisar instalar pacotes do sistema. No Alpine Linux e outras distribuições baseadas em musl, consulte [Alpine Linux setup](/docs/pt/setup#alpine-linux-and-musl-based-distributions).

298 298 

299```bash theme={null}299```bash theme={null}

300ldd "$(command -v claude)" | grep "not found"300ldd "$(command -v claude)" | grep "not found"


413brew install --cask claude-code413brew install --cask claude-code

414```414```

415 415 

416Se Homebrew instalar uma versão mais antiga do Claude Code do que você espera, o mesmo índice desatualizado é geralmente a causa. O cask `claude-code` rastreia o canal estável e é tipicamente cerca de uma semana atrás da versão mais recente; para a versão mais recente execute `brew install --cask claude-code@latest` em vez disso. Consulte [Configure release channel](/pt/setup#configure-release-channel) para a diferença entre os dois casks.416Se Homebrew instalar uma versão mais antiga do Claude Code do que você espera, o mesmo índice desatualizado é geralmente a causa. O cask `claude-code` rastreia o canal estável e é tipicamente cerca de uma semana atrás da versão mais recente; para a versão mais recente execute `brew install --cask claude-code@latest` em vez disso. Consulte [Configure release channel](/docs/pt/setup#configure-release-channel) para a diferença entre os dois casks.

417 417 

418<h3 id="tls-or-ssl-connection-errors">418<h3 id="tls-or-ssl-connection-errors">

419 TLS or SSL connection errors419 TLS or SSL connection errors


468 curl -sI https://downloads.claude.ai/claude-code-releases/latest468 curl -sI https://downloads.claude.ai/claude-code-releases/latest

469 ```469 ```

470 470 

4712. **Se atrás de um proxy**, defina `HTTPS_PROXY` para que o instalador possa rotear através dele. Consulte [proxy configuration](/pt/network-config#proxy-configuration) para detalhes.4712. **Se atrás de um proxy**, defina `HTTPS_PROXY` para que o instalador possa rotear através dele. Consulte [proxy configuration](/docs/pt/network-config#proxy-configuration) para detalhes.

472 ```bash theme={null}472 ```bash theme={null}

473 export HTTPS_PROXY=http://proxy.example.com:8080473 export HTTPS_PROXY=http://proxy.example.com:8080

474 curl -fsSL https://claude.ai/install.sh | bash474 curl -fsSL https://claude.ai/install.sh | bash


551 551 

552Antes da v2.1.200, o script saía apenas com a linha `Killed` simples do shell e sem explicação.552Antes da v2.1.200, o script saía apenas com a linha `Killed` simples do shell e sem explicação.

553 553 

554A instalação precisa de aproximadamente 512 MB de memória livre, e executar Claude Code precisa de mais. Consulte os [system requirements](/pt/setup#system-requirements).554A instalação precisa de aproximadamente 512 MB de memória livre, e executar Claude Code precisa de mais. Consulte os [system requirements](/docs/pt/setup#system-requirements).

555 555 

556**Soluções:**556**Soluções:**

557 557 


607 Claude Code on Windows requires either Git for Windows (for bash) or PowerShell607 Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

608</h3>608</h3>

609 609 

610Git for Windows é opcional. Claude Code usa a [PowerShell tool](/pt/tools-reference#powershell-tool) quando Git Bash está ausente, então este erro significa que nenhum shell foi encontrado.610Git for Windows é opcional. Claude Code usa a [PowerShell tool](/docs/pt/tools-reference#powershell-tool) quando Git Bash está ausente, então este erro significa que nenhum shell foi encontrado.

611 611 

612**Se PowerShell estiver faltando do seu PATH**, sua localização padrão é `C:\Windows\System32\WindowsPowerShell\v1.0\`. Adicione esse diretório ao seu `PATH`, ou instale [PowerShell 7](https://aka.ms/powershell), que fornece `pwsh`.612**Se PowerShell estiver faltando do seu PATH**, sua localização padrão é `C:\Windows\System32\WindowsPowerShell\v1.0\`. Adicione esse diretório ao seu `PATH`, ou instale [PowerShell 7](https://aka.ms/powershell), que fornece `pwsh`.

613 613 

614**Para instalar Git for Windows em vez disso**, baixe de [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Durante a configuração, selecione "Add to PATH." Reinicie seu terminal após instalar. Instalá-lo ativa a ferramenta Bash, útil ao trabalhar com scripts e ferramentas baseadas em Bash.614**Para instalar Git for Windows em vez disso**, baixe de [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Durante a configuração, selecione "Add to PATH." Reinicie seu terminal após instalar. Instalá-lo ativa a ferramenta Bash, útil ao trabalhar com scripts e ferramentas baseadas em Bash.

615 615 

616**Se Git já estiver instalado** mas Claude Code não conseguir encontrá-lo, defina o caminho em seu [settings.json file](/pt/settings):616**Se Git já estiver instalado** mas Claude Code não conseguir encontrá-lo, defina o caminho em seu [settings.json file](/docs/pt/settings):

617 617 

618```json theme={null}618```json theme={null}

619{619{


641 641 

642Se isso imprimir `True`, seu sistema operacional está bem. Feche a janela, abra `Windows PowerShell` sem o sufixo x86 e execute o comando de instalação novamente.642Se isso imprimir `True`, seu sistema operacional está bem. Feche a janela, abra `Windows PowerShell` sem o sufixo x86 e execute o comando de instalação novamente.

643 643 

644Se isso imprimir `False`, você está em uma edição de 32 bits do Windows. Claude Code requer um sistema operacional de 64 bits. Consulte os [system requirements](/pt/setup#system-requirements).644Se isso imprimir `False`, você está em uma edição de 32 bits do Windows. Claude Code requer um sistema operacional de 64 bits. Consulte os [system requirements](/docs/pt/setup#system-requirements).

645 645 

646<h3 id="linux-musl-or-glibc-binary-mismatch">646<h3 id="linux-musl-or-glibc-binary-mismatch">

647 Linux musl or glibc binary mismatch647 Linux musl or glibc binary mismatch


737 npm install errors in WSL737 npm install errors in WSL

738</h3>738</h3>

739 739 

740Estes problemas se aplicam se você instalou Claude Code com `npm install -g` dentro do WSL. Se você usou o [native installer](/pt/setup), pule esta seção.740Estes problemas se aplicam se você instalou Claude Code com `npm install -g` dentro do WSL. Se você usou o [native installer](/docs/pt/setup), pule esta seção.

741 741 

742**Problemas de detecção de SO ou plataforma.** Se npm relatar uma incompatibilidade de plataforma durante a instalação, WSL provavelmente está pegando o `npm` do Windows. Execute `npm config set os linux` primeiro, depois instale com `npm install -g @anthropic-ai/claude-code --force`. Não use `sudo`.742**Problemas de detecção de SO ou plataforma.** Se npm relatar uma incompatibilidade de plataforma durante a instalação, WSL provavelmente está pegando o `npm` do Windows. Execute `npm config set os linux` primeiro, depois instale com `npm install -g @anthropic-ai/claude-code --force`. Não use `sudo`.

743 743 


786O pacote npm `@anthropic-ai/claude-code` puxa o binário nativo através de uma dependência opcional por plataforma como `@anthropic-ai/claude-code-darwin-arm64`. Se executar `claude` após a instalação imprimir `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, verifique as seguintes causas:786O pacote npm `@anthropic-ai/claude-code` puxa o binário nativo através de uma dependência opcional por plataforma como `@anthropic-ai/claude-code-darwin-arm64`. Se executar `claude` após a instalação imprimir `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, verifique as seguintes causas:

787 787 

788* **Dependências opcionais estão desabilitadas.** Remova `--omit=optional` do seu comando npm install, `--no-optional` do pnpm, ou `--ignore-optional` do yarn, e verifique que `.npmrc` não define `optional=false`. Depois reinstale. O binário nativo é entregue apenas como uma dependência opcional, então não há fallback JavaScript se for ignorado.788* **Dependências opcionais estão desabilitadas.** Remova `--omit=optional` do seu comando npm install, `--no-optional` do pnpm, ou `--ignore-optional` do yarn, e verifique que `.npmrc` não define `optional=false`. Depois reinstale. O binário nativo é entregue apenas como uma dependência opcional, então não há fallback JavaScript se for ignorado.

789* **Plataforma não suportada.** Binários pré-compilados são publicados para `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` e `win32-arm64`. Claude Code não envia um binário para outras plataformas; consulte os [system requirements](/pt/setup#system-requirements). {/* min-version: 2.1.205 */}No FreeBSD, o instalador relata a plataforma como não suportada. Antes da v2.1.205, ele tratava FreeBSD como Linux e baixava um binário que não conseguia executar.789* **Plataforma não suportada.** Binários pré-compilados são publicados para `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` e `win32-arm64`. Claude Code não envia um binário para outras plataformas; consulte os [system requirements](/docs/pt/setup#system-requirements). No FreeBSD, o instalador relata a plataforma como não suportada. Antes da v2.1.205, ele tratava FreeBSD como Linux e baixava um binário que não conseguia executar.

790* **Espelho npm corporativo está faltando os pacotes de plataforma.** Certifique-se de que seu registro espelha todos os oito pacotes `@anthropic-ai/claude-code-*` de plataforma além do pacote meta.790* **Espelho npm corporativo está faltando os pacotes de plataforma.** Certifique-se de que seu registro espelha todos os oito pacotes `@anthropic-ai/claude-code-*` de plataforma além do pacote meta.

791 791 

792Instalar com `--ignore-scripts` não dispara este erro. A etapa de pós-instalação que vincula o binário no lugar é ignorada, então Claude Code volta a um wrapper que localiza e gera o binário de plataforma em cada inicialização. Isso funciona mas inicia mais lentamente; reinstale com scripts habilitados para execução direta.792Instalar com `--ignore-scripts` não dispara este erro. A etapa de pós-instalação que vincula o binário no lugar é ignorada, então Claude Code volta a um wrapper que localiza e gera o binário de plataforma em cada inicialização. Isso funciona mas inicia mais lentamente; reinstale com scripts habilitados para execução direta.


829 829 

830* **Usuários Claude Pro/Max**: verifique se sua assinatura está ativa em [claude.ai/settings](https://claude.ai/settings)830* **Usuários Claude Pro/Max**: verifique se sua assinatura está ativa em [claude.ai/settings](https://claude.ai/settings)

831* **Usuários do Anthropic Console**: confirme que sua conta tem a função "Claude Code" ou "Developer". Os administradores atribuem isso no Anthropic Console em Settings → Members.831* **Usuários do Anthropic Console**: confirme que sua conta tem a função "Claude Code" ou "Developer". Os administradores atribuem isso no Anthropic Console em Settings → Members.

832* **Atrás de um proxy**: proxies corporativos podem interferir com solicitações de API. Consulte [network configuration](/pt/network-config) para configuração de proxy.832* **Atrás de um proxy**: proxies corporativos podem interferir com solicitações de API. Consulte [network configuration](/docs/pt/network-config) para configuração de proxy.

833 833 

834<h3 id="this-organization-has-been-disabled-with-an-active-subscription">834<h3 id="this-organization-has-been-disabled-with-an-active-subscription">

835 This organization has been disabled with an active subscription835 This organization has been disabled with an active subscription


837 837 

838Se você vir `API Error: 400 ... "This organization has been disabled"` apesar de ter uma assinatura Claude ativa, uma variável de ambiente `ANTHROPIC_API_KEY` está substituindo sua assinatura. Isso comumente acontece quando uma chave de API antiga de um empregador anterior ou projeto ainda está definida em seu perfil de shell.838Se você vir `API Error: 400 ... "This organization has been disabled"` apesar de ter uma assinatura Claude ativa, uma variável de ambiente `ANTHROPIC_API_KEY` está substituindo sua assinatura. Isso comumente acontece quando uma chave de API antiga de um empregador anterior ou projeto ainda está definida em seu perfil de shell.

839 839 

840Quando `ANTHROPIC_API_KEY` está presente e você a aprovou, Claude Code usa essa chave em vez das credenciais OAuth da sua assinatura. Em modo não interativo com a flag `-p`, a chave é sempre usada quando presente. Consulte [authentication precedence](/pt/authentication#authentication-precedence) para a ordem de resolução completa.840Quando `ANTHROPIC_API_KEY` está presente e você a aprovou, Claude Code usa essa chave em vez das credenciais OAuth da sua assinatura. Em modo não interativo com a flag `-p`, a chave é sempre usada quando presente. Consulte [authentication precedence](/docs/pt/authentication#authentication-precedence) para a ordem de resolução completa.

841 841 

842Para usar sua assinatura em vez disso, desdefina a variável de ambiente e remova-a do seu perfil de shell:842Para usar sua assinatura em vez disso, desdefina a variável de ambiente e remova-a do seu perfil de shell:

843 843 


907 907 

908Se as credenciais funcionam em seu terminal mas não na extensão VS Code ou JetBrains, o processo IDE provavelmente não herdou seu ambiente de shell. Defina as variáveis de ambiente do provedor nas configurações do próprio IDE, ou inicie o IDE a partir de um terminal onde elas já estão exportadas.908Se as credenciais funcionam em seu terminal mas não na extensão VS Code ou JetBrains, o processo IDE provavelmente não herdou seu ambiente de shell. Defina as variáveis de ambiente do provedor nas configurações do próprio IDE, ou inicie o IDE a partir de um terminal onde elas já estão exportadas.

909 909 

910Consulte [Amazon Bedrock](/pt/amazon-bedrock), [Google Cloud's Agent Platform](/pt/google-vertex-ai), ou [Microsoft Foundry](/pt/microsoft-foundry) para configuração completa do provedor.910Consulte [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), ou [Microsoft Foundry](/docs/pt/microsoft-foundry) para configuração completa do provedor.

911 911 

912<h2 id="still-stuck">912<h2 id="still-stuck">

913 Still stuck913 Still stuck

voice-dictation.md +16 −16

Details

12 Modo de toque requer Claude Code v2.1.116 ou posterior. Verifique sua versão com `claude --version`.12 Modo de toque requer Claude Code v2.1.116 ou posterior. Verifique sua versão com `claude --version`.

13</Note>13</Note>

14 14 

15O ditado também funciona na [visualização do agente](/pt/agent-view#peek-and-reply). Mantenha ou toque sua tecla push-to-talk enquanto a entrada de despacho ou uma resposta do painel de visualização estiver em foco para ditar para uma sessão em segundo plano.15O ditado também funciona na [visualização do agente](/docs/pt/agent-view#peek-and-reply). Mantenha ou toque sua tecla push-to-talk enquanto a entrada de despacho ou uma resposta do painel de visualização estiver em foco para ditar para uma sessão em segundo plano.

16 16 

17<h2 id="requirements">17<h2 id="requirements">

18 Requisitos18 Requisitos


22 22 

23* **Uma conta Claude.ai**: o serviço de fala para texto está disponível apenas quando você se autentica com uma, e não está disponível quando Claude Code está configurado para usar uma chave API da Anthropic diretamente, Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.23* **Uma conta Claude.ai**: o serviço de fala para texto está disponível apenas quando você se autentica com uma, e não está disponível quando Claude Code está configurado para usar uma chave API da Anthropic diretamente, Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

24* **Uma organização sem conformidade HIPAA ativada**: `/voice` mostra `Voice mode is disabled by your organization's policy` quando essa restrição se aplica.24* **Uma organização sem conformidade HIPAA ativada**: `/voice` mostra `Voice mode is disabled by your organization's policy` quando essa restrição se aplica.

25* **Um microfone local**: o ditado por voz não funciona em ambientes remotos como [Claude Code na web](/pt/claude-code-on-the-web) ou sessões SSH.25* **Um microfone local**: o ditado por voz não funciona em ambientes remotos como [Claude Code na web](/docs/pt/claude-code-on-the-web) ou sessões SSH.

26* **WSLg, se você executar Claude Code no WSL**: WSLg está incluído no WSL2 quando instalado na Microsoft Store no Windows 10 ou 11. Se WSLg não estiver disponível, por exemplo no WSL1, execute Claude Code no Windows nativo.26* **WSLg, se você executar Claude Code no WSL**: WSLg está incluído no WSL2 quando instalado na Microsoft Store no Windows 10 ou 11. Se WSLg não estiver disponível, por exemplo no WSL1, execute Claude Code no Windows nativo.

27 27 

28A transcrição não consome mensagens Claude ou tokens e não conta para os limites mostrados em `/usage`. Consulte [data usage](/pt/data-usage) para saber como a Anthropic lida com seus dados.28A transcrição não consome mensagens Claude ou tokens e não conta para os limites mostrados em `/usage`. Consulte [data usage](/docs/pt/data-usage) para saber como a Anthropic lida com seus dados.

29 29 

30A gravação de áudio usa um módulo nativo integrado no macOS, Linux e Windows. No Linux, se o módulo nativo não conseguir carregar, Claude Code volta para `arecord` do ALSA utils ou `rec` do SoX. Se nenhum estiver disponível, `/voice` imprime um comando de instalação para seu gerenciador de pacotes.30A gravação de áudio usa um módulo nativo integrado no macOS, Linux e Windows. No Linux, se o módulo nativo não conseguir carregar, Claude Code volta para `arecord` do ALSA utils ou `rec` do SoX. Se nenhum estiver disponível, `/voice` imprime um comando de instalação para seu gerenciador de pacotes.

31 31 

32A [extensão VS Code](/pt/vs-code) do Claude Code também suporta ditado por voz com o mesmo requisito de conta Claude.ai. Não está disponível em sessões VS Code Remote, incluindo SSH, Dev Containers e Codespaces, porque o microfone está em sua máquina local e a extensão é executada no host remoto.32A [extensão VS Code](/docs/pt/vs-code) do Claude Code também suporta ditado por voz com o mesmo requisito de conta Claude.ai. Não está disponível em sessões VS Code Remote, incluindo SSH, Dev Containers e Codespaces, porque o microfone está em sua máquina local e a extensão é executada no host remoto.

33 33 

34<h2 id="enable-voice-dictation">34<h2 id="enable-voice-dictation">

35 Ativar ditado por voz35 Ativar ditado por voz


51| `/voice tap` | Ativar no [modo de toque](#tap-to-record-and-send) |51| `/voice tap` | Ativar no [modo de toque](#tap-to-record-and-send) |

52| `/voice off` | Desativar |52| `/voice off` | Desativar |

53 53 

54O ditado por voz persiste entre sessões. Defina-o diretamente em seu [arquivo de configurações do usuário](/pt/settings) em vez de executar `/voice`:54O ditado por voz persiste entre sessões. Defina-o diretamente em seu [arquivo de configurações do usuário](/docs/pt/settings) em vez de executar `/voice`:

55 55 

56```json theme={null}56```json theme={null}

57{57{


62}62}

63```63```

64 64 

65Enquanto o ditado por voz está ativado, o rodapé de entrada mostra uma dica `hold space to speak` quando o prompt está vazio. A dica reflete sua vinculação `voice:pushToTalk` atual e é atualizada se você [reassociar a tecla de ditado](#rebind-the-dictation-key). O texto da dica é o mesmo em ambos os modos e não aparece se você tiver um [status line personalizado](/pt/statusline) configurado.65Enquanto o ditado por voz está ativado, o rodapé de entrada mostra uma dica `hold space to speak` quando o prompt está vazio. A dica reflete sua vinculação `voice:pushToTalk` atual e é atualizada se você [reassociar a tecla de ditado](#rebind-the-dictation-key). O texto da dica é o mesmo em ambos os modos e não aparece se você tiver um [status line personalizado](/docs/pt/statusline) configurado.

66 66 

67A transcrição é ajustada para vocabulário de codificação em ambos os modos. Termos de desenvolvimento comuns como `regex`, `OAuth`, `JSON` e `localhost` são reconhecidos corretamente, e o nome do seu projeto atual e o nome da ramificação git são adicionados automaticamente como dicas de reconhecimento.67A transcrição é ajustada para vocabulário de codificação em ambos os modos. Termos de desenvolvimento comuns como `regex`, `OAuth`, `JSON` e `localhost` são reconhecidos corretamente, e o nome do seu projeto atual e o nome da ramificação git são adicionados automaticamente como dicas de reconhecimento.

68 68 


108 Alterar o idioma do ditado108 Alterar o idioma do ditado

109</h2>109</h2>

110 110 

111O ditado por voz usa a mesma [configuração `language`](/pt/settings) que controla o idioma de resposta do Claude. Se essa configuração estiver vazia, o ditado usa o padrão em inglês. Na extensão VS Code, se `language` estiver vazio, o ditado usa a configuração `accessibility.voice.speechLanguage` do VS Code antes de usar o padrão em inglês.111O ditado por voz usa a mesma [configuração `language`](/docs/pt/settings) que controla o idioma de resposta do Claude. Se essa configuração estiver vazia, o ditado usa o padrão em inglês. Na extensão VS Code, se `language` estiver vazio, o ditado usa a configuração `accessibility.voice.speechLanguage` do VS Code antes de usar o padrão em inglês.

112 112 

113<Accordion title="Idiomas de ditado suportados">113<Accordion title="Idiomas de ditado suportados">

114 | Idioma | Código |114 | Idioma | Código |


149 Revinculação da tecla de ditado149 Revinculação da tecla de ditado

150</h2>150</h2>

151 151 

152A tecla de ditado está vinculada a `voice:pushToTalk` no contexto `Chat` e usa como padrão `Space`. A mesma vinculação controla os modos de manutenção e toque. Revinculação em [`~/.claude/keybindings.json`](/pt/keybindings):152A tecla de ditado está vinculada a `voice:pushToTalk` no contexto `Chat` e usa como padrão `Space`. A mesma vinculação controla os modos de manutenção e toque. Revinculação em [`~/.claude/keybindings.json`](/docs/pt/keybindings):

153 153 

154```json theme={null}154```json theme={null}

155{155{


169 169 

170No modo de manutenção, evite vincular uma tecla de letra simples como `v` pois a detecção de manutenção depende da repetição de tecla e a letra digita no prompt durante o aquecimento. Use `Space`, ou use uma combinação de modificador como `meta+k` para começar a gravar no primeiro pressionamento de tecla sem aquecimento. O modo de toque não tem aquecimento, portanto a maioria das teclas funciona.170No modo de manutenção, evite vincular uma tecla de letra simples como `v` pois a detecção de manutenção depende da repetição de tecla e a letra digita no prompt durante o aquecimento. Use `Space`, ou use uma combinação de modificador como `meta+k` para começar a gravar no primeiro pressionamento de tecla sem aquecimento. O modo de toque não tem aquecimento, portanto a maioria das teclas funciona.

171 171 

172Algumas teclas não são entregues a aplicativos de terminal e não podem ser vinculadas. Por exemplo, `Caps Lock` mostra um erro se você tentar vinculá-la. Consulte [customize keyboard shortcuts](/pt/keybindings) para a sintaxe completa de vinculação de teclado e a lista de atalhos reservados.172Algumas teclas não são entregues a aplicativos de terminal e não podem ser vinculadas. Por exemplo, `Caps Lock` mostra um erro se você tentar vinculá-la. Consulte [customize keyboard shortcuts](/docs/pt/keybindings) para a sintaxe completa de vinculação de teclado e a lista de atalhos reservados.

173 173 

174<h2 id="troubleshooting">174<h2 id="troubleshooting">

175 Troubleshooting175 Troubleshooting


181* **`Voice mode is disabled by your organization's policy`**: a configuração de conformidade da sua organização desativa o ditado por voz, conforme descrito em [Requirements](#requirements). Entre em contato com o administrador da sua organização para confirmar se o ditado por voz está disponível para sua organização.181* **`Voice mode is disabled by your organization's policy`**: a configuração de conformidade da sua organização desativa o ditado por voz, conforme descrito em [Requirements](#requirements). Entre em contato com o administrador da sua organização para confirmar se o ditado por voz está disponível para sua organização.

182* **`Microphone access is denied`**: conceda permissão de microfone ao seu terminal nas configurações do sistema. No macOS, vá para Configurações do Sistema → Privacidade e Segurança → Microfone e ative seu aplicativo de terminal, depois execute `/voice` novamente. No Windows, vá para Configurações → Privacidade e segurança → Microfone e ative o acesso ao microfone para aplicativos de desktop, depois execute `/voice` novamente. Se seu terminal não estiver listado nas configurações de Microfone do macOS, consulte [Terminal not listed in macOS Microphone settings](#terminal-not-listed-in-macos-microphone-settings).182* **`Microphone access is denied`**: conceda permissão de microfone ao seu terminal nas configurações do sistema. No macOS, vá para Configurações do Sistema → Privacidade e Segurança → Microfone e ative seu aplicativo de terminal, depois execute `/voice` novamente. No Windows, vá para Configurações → Privacidade e segurança → Microfone e ative o acesso ao microfone para aplicativos de desktop, depois execute `/voice` novamente. Se seu terminal não estiver listado nas configurações de Microfone do macOS, consulte [Terminal not listed in macOS Microphone settings](#terminal-not-listed-in-macos-microphone-settings).

183* **`No audio recording tool found` no Linux**: o módulo de áudio nativo não conseguiu carregar e nenhum fallback está instalado. Instale SoX com o comando mostrado na mensagem de erro, por exemplo `sudo apt-get install sox`.183* **`No audio recording tool found` no Linux**: o módulo de áudio nativo não conseguiu carregar e nenhum fallback está instalado. Instale SoX com o comando mostrado na mensagem de erro, por exemplo `sudo apt-get install sox`.

184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX está instalado, mas o host não possui um dispositivo de captura de áudio, por exemplo um servidor sem cabeça ou um contêiner. Execute Claude Code em uma máquina com um microfone. {/* min-version: 2.1.195 */}A partir da v2.1.195, Claude Code no Linux relata esta mensagem nessa situação; versões anteriores pediam que você instalasse SoX mesmo quando já estava instalado.184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX está instalado, mas o host não possui um dispositivo de captura de áudio, por exemplo um servidor sem cabeça ou um contêiner. Execute Claude Code em uma máquina com um microfone. A partir da v2.1.195, Claude Code no Linux relata esta mensagem nessa situação; versões anteriores pediam que você instalasse SoX mesmo quando já estava instalado.

185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg roteia áudio através do PulseAudio em vez de um dispositivo ALSA, portanto SoX precisa que seu backend PulseAudio esteja instalado explicitamente. Execute `sudo apt install sox libsox-fmt-pulse`. Instalar apenas `sox` puxa o backend ALSA, que não consegue gravar no WSL porque não há nenhum dispositivo `/dev/snd`.185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg roteia áudio através do PulseAudio em vez de um dispositivo ALSA, portanto SoX precisa que seu backend PulseAudio esteja instalado explicitamente. Execute `sudo apt install sox libsox-fmt-pulse`. Instalar apenas `sox` puxa o backend ALSA, que não consegue gravar no WSL porque não há nenhum dispositivo `/dev/snd`.

186* **`Voice input is failing repeatedly and has been paused`**: o ditado por voz atingiu várias falhas de captura seguidas e parou de tentar novas sessões até que uma tenha sucesso. Uma falha conta se o microfone falhar ao iniciar ou o gravador iniciar e depois parar sem produzir nenhum áudio. Isso geralmente significa que o microfone ou a pilha de áudio neste host não consegue capturar áudio, por exemplo um servidor sem cabeça, um shell remoto sem passagem de áudio, ou uma permissão de microfone negada. Confirme um dispositivo de entrada funcionando, corrija a causa subjacente das entradas acima, depois dispare a voz novamente. {/* min-version: 2.1.202 */}Antes da v2.1.202, apenas falhas de inicialização contavam para a pausa.186* **`Voice input is failing repeatedly and has been paused`**: o ditado por voz atingiu várias falhas de captura seguidas e parou de tentar novas sessões até que uma tenha sucesso. Uma falha conta se o microfone falhar ao iniciar ou o gravador iniciar e depois parar sem produzir nenhum áudio. Isso geralmente significa que o microfone ou a pilha de áudio neste host não consegue capturar áudio, por exemplo um servidor sem cabeça, um shell remoto sem passagem de áudio, ou uma permissão de microfone negada. Confirme um dispositivo de entrada funcionando, corrija a causa subjacente das entradas acima, depois dispare a voz novamente. Antes da v2.1.202, apenas falhas de inicialização contavam para a pausa.

187* **Nada acontece ao manter `Space` pressionado no modo de manutenção**: observe a entrada do prompt enquanto você mantém. Se espaços continuarem se acumulando, o ditado por voz provavelmente está desativado; execute `/voice hold` para ativá-lo. Se apenas um ou dois espaços aparecerem e depois nada, o ditado por voz está ativado mas a detecção de manutenção não está sendo acionada. A detecção de manutenção requer que seu terminal envie eventos de repetição de tecla, portanto não pode detectar uma tecla mantida se a repetição de tecla estiver desativada no nível do SO. Mude para o modo de toque com `/voice tap` para evitar o requisito de repetição de tecla.187* **Nada acontece ao manter `Space` pressionado no modo de manutenção**: observe a entrada do prompt enquanto você mantém. Se espaços continuarem se acumulando, o ditado por voz provavelmente está desativado; execute `/voice hold` para ativá-lo. Se apenas um ou dois espaços aparecerem e depois nada, o ditado por voz está ativado mas a detecção de manutenção não está sendo acionada. A detecção de manutenção requer que seu terminal envie eventos de repetição de tecla, portanto não pode detectar uma tecla mantida se a repetição de tecla estiver desativada no nível do SO. Mude para o modo de toque com `/voice tap` para evitar o requisito de repetição de tecla.

188* **Tocar `Space` digita um espaço em vez de gravar no modo de toque**: o primeiro toque só começa a gravar quando a entrada do prompt está vazia. Limpe a entrada primeiro, ou verifique se você está no modo de toque executando `/voice tap`.188* **Tocar `Space` digita um espaço em vez de gravar no modo de toque**: o primeiro toque só começa a gravar quando a entrada do prompt está vazia. Limpe a entrada primeiro, ou verifique se você está no modo de toque executando `/voice tap`.

189* **`No audio detected from microphone`**: a gravação começou mas capturou silêncio. Confirme que o dispositivo de entrada correto está definido como padrão do sistema e que seu nível de entrada não está mudo ou próximo a zero. No Windows, abra Configurações → Sistema → Som → Entrada e selecione seu microfone. No macOS, abra Configurações do Sistema → Som → Entrada.189* **`No audio detected from microphone`**: a gravação começou mas capturou silêncio. Confirme que o dispositivo de entrada correto está definido como padrão do sistema e que seu nível de entrada não está mudo ou próximo a zero. No Windows, abra Configurações → Sistema → Som → Entrada e selecione seu microfone. No macOS, abra Configurações do Sistema → Som → Entrada.

190* **`Voice connection failed`**: sua gravação nunca chegou ao serviço de transcrição porque a conexão falhou. Verifique sua rede e tente novamente. {/* min-version: 2.1.200 */}Uma gravação que captura nenhum áudio relata `No audio detected from microphone` em vez desta mensagem. Antes da v2.1.200, um microfone silencioso poderia relatar uma falha de conexão, o que sugeria um problema de rede quando o problema real era o dispositivo de entrada.190* **`Voice connection failed`**: sua gravação nunca chegou ao serviço de transcrição porque a conexão falhou. Verifique sua rede e tente novamente. Uma gravação que captura nenhum áudio relata `No audio detected from microphone` em vez desta mensagem. Antes da v2.1.200, um microfone silencioso poderia relatar uma falha de conexão, o que sugeria um problema de rede quando o problema real era o dispositivo de entrada.

191* **`No speech detected`**: o áudio chegou ao serviço de transcrição mas nenhuma palavra foi reconhecida. Fale mais perto do microfone, reduza o ruído de fundo e confirme que seu [idioma de ditado](#change-the-dictation-language) corresponde ao idioma que você está falando.191* **`No speech detected`**: o áudio chegou ao serviço de transcrição mas nenhuma palavra foi reconhecida. Fale mais perto do microfone, reduza o ruído de fundo e confirme que seu [idioma de ditado](#change-the-dictation-language) corresponde ao idioma que você está falando.

192* **A transcrição está distorcida ou no idioma errado**: o ditado usa o padrão em inglês. Se você estiver ditando em outro idioma, defina-o em `/config` primeiro. Consulte [Change the dictation language](#change-the-dictation-language).192* **A transcrição está distorcida ou no idioma errado**: o ditado usa o padrão em inglês. Se você estiver ditando em outro idioma, defina-o em `/config` primeiro. Consulte [Change the dictation language](#change-the-dictation-language).

193 193 


219 Veja também219 Veja também

220</h2>220</h2>

221 221 

222* [Personalize atalhos de teclado](/pt/keybindings): revinculação `voice:pushToTalk` e outras ações de teclado CLI222* [Personalize atalhos de teclado](/docs/pt/keybindings): revinculação `voice:pushToTalk` e outras ações de teclado CLI

223* [Configure configurações](/pt/settings): referência completa para `voice`, `language` e outras chaves de configurações223* [Configure configurações](/docs/pt/settings): referência completa para `voice`, `language` e outras chaves de configurações

224* [Modo interativo](/pt/interactive-mode): atalhos de teclado, modos de entrada e controles de sessão224* [Modo interativo](/docs/pt/interactive-mode): atalhos de teclado, modos de entrada e controles de sessão

225* [Comandos](/pt/commands): referência para `/voice`, `/config` e todos os outros comandos225* [Comandos](/docs/pt/commands): referência para `/voice`, `/config` e todos os outros comandos

vs-code.md +35 −35

Details

19Antes de instalar, certifique-se de que você tem:19Antes de instalar, certifique-se de que você tem:

20 20 

21* VS Code 1.98.0 ou superior21* VS Code 1.98.0 ou superior

22* Uma conta Anthropic: qualquer assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou uma conta Claude Console funciona, e nenhuma chave de API é necessária. Você fará [login](/pt/authentication#log-in-to-claude-code) com essa conta quando abrir a extensão pela primeira vez. Se você acessar Claude através de um provedor de terceiros como Amazon Bedrock ou Google Cloud's Agent Platform, consulte [Use third-party providers](#use-third-party-providers) para instruções de configuração.22* Uma conta Anthropic: qualquer assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou uma conta Claude Console funciona, e nenhuma chave de API é necessária. Você fará [login](/docs/pt/authentication#log-in-to-claude-code) com essa conta quando abrir a extensão pela primeira vez. Se você acessar Claude através de um provedor de terceiros como Amazon Bedrock ou Google Cloud's Agent Platform, consulte [Use third-party providers](#use-third-party-providers) para instruções de configuração.

23 23 

24<Tip>24<Tip>

25 A extensão inclui sua própria cópia da CLI (interface de linha de comando) para o painel de chat. Para executar `claude` no terminal integrado do VS Code, você também precisa da [instalação da CLI autônoma](/pt/setup). Consulte [VS Code extension vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli) para detalhes.25 A extensão inclui sua própria cópia da CLI (interface de linha de comando) para o painel de chat. Para executar `claude` no terminal integrado do VS Code, você também precisa da [instalação da CLI autônoma](/docs/pt/setup). Consulte [VS Code extension vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli) para detalhes.

26</Tip>26</Tip>

27 27 

28<h2 id="install-the-extension">28<h2 id="install-the-extension">


36 36 

37Ou no VS Code, pressione `Cmd+Shift+X` (Mac) ou `Ctrl+Shift+X` (Windows/Linux) para abrir a visualização de Extensões, procure por "Claude Code" e clique em **Instalar**.37Ou no VS Code, pressione `Cmd+Shift+X` (Mac) ou `Ctrl+Shift+X` (Windows/Linux) para abrir a visualização de Extensões, procure por "Claude Code" e clique em **Instalar**.

38 38 

39A extensão também é instalada em outros forks do VS Code como Devin Desktop ou Kiro. Procure por "Claude Code" na visualização de Extensões do editor, ou instale a partir do [registro Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Se o seu editor não conseguir instalar a extensão, [instale a CLI](/pt/quickstart) e execute `claude` no seu terminal integrado. A CLI funciona em qualquer terminal.39A extensão também é instalada em outros forks do VS Code como Devin Desktop ou Kiro. Procure por "Claude Code" na visualização de Extensões do editor, ou instale a partir do [registro Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Se o seu editor não conseguir instalar a extensão, [instale a CLI](/docs/pt/quickstart) e execute `claude` no seu terminal integrado. A CLI funciona em qualquer terminal.

40 40 

41<Note>Se a extensão não aparecer após a instalação, reinicie o VS Code ou execute "Developer: Reload Window" na Paleta de Comandos.</Note>41<Note>Se a extensão não aparecer após a instalação, reinicie o VS Code ou execute "Developer: Reload Window" na Paleta de Comandos.</Note>

42 42 


90 </Step>90 </Step>

91</Steps>91</Steps>

92 92 

93Para mais ideias sobre o que você pode fazer com Claude Code, consulte [Fluxos de trabalho comuns](/pt/common-workflows).93Para mais ideias sobre o que você pode fazer com Claude Code, consulte [Fluxos de trabalho comuns](/docs/pt/common-workflows).

94 94 

95<Tip>95<Tip>

96 Execute "Claude Code: Open Walkthrough" na Paleta de Comandos para um tour guiado dos conceitos básicos.96 Execute "Claude Code: Open Walkthrough" na Paleta de Comandos para um tour guiado dos conceitos básicos.


102 102 

103A caixa de prompt suporta vários recursos:103A caixa de prompt suporta vários recursos:

104 104 

105* **Permission modes**: clique no indicador de modo na parte inferior da caixa de prompt para alternar modos, ou defina o padrão nas configurações do VS Code em `claudeCode.initialPermissionMode`. Consulte [permission modes](/pt/permission-modes#switch-permission-modes) para cada modo que o indicador oferece.105* **Permission modes**: clique no indicador de modo na parte inferior da caixa de prompt para alternar modos, ou defina o padrão nas configurações do VS Code em `claudeCode.initialPermissionMode`. Consulte [permission modes](/docs/pt/permission-modes#switch-permission-modes) para cada modo que o indicador oferece.

106 * **Manual**: Claude pede permissão antes de edições de arquivo e a maioria dos comandos shell.106 * **Manual**: Claude pede permissão antes de edições de arquivo e a maioria dos comandos shell.

107 * **Plan**: Claude descreve o que fará e aguarda aprovação antes de fazer alterações. VS Code abre automaticamente o plano como um documento Markdown completo onde você pode adicionar comentários inline para fornecer feedback antes de Claude começar.107 * **Plan**: Claude descreve o que fará e aguarda aprovação antes de fazer alterações. VS Code abre automaticamente o plano como um documento Markdown completo onde você pode adicionar comentários inline para fornecer feedback antes de Claude começar.

108 * **Edit automatically**: Claude faz edições sem perguntar.108 * **Edit automatically**: Claude faz edições sem perguntar.

109* **Command menu**: clique em `/` ou digite `/` para abrir o menu de comandos. As opções incluem anexar arquivos, alternar modelos, alternar pensamento estendido, visualizar uso de plano (`/usage`) e iniciar uma sessão de [Remote Control](/pt/remote-control) (`/remote-control`). A seção Customize fornece acesso a MCP servers, hooks, memory, permissions e plugins. Itens com um ícone de terminal abrem no terminal integrado.109* **Command menu**: clique em `/` ou digite `/` para abrir o menu de comandos. As opções incluem anexar arquivos, alternar modelos, alternar pensamento estendido, visualizar uso de plano (`/usage`) e iniciar uma sessão de [Remote Control](/docs/pt/remote-control) (`/remote-control`). A seção Customize fornece acesso a MCP servers, hooks, memory, permissions e plugins. Itens com um ícone de terminal abrem no terminal integrado.

110 * {/* min-version: 2.1.203 */}A seção Settings inclui **Enable Remote Control for all sessions**, que define [`remoteControlAtStartup`](/pt/settings#available-settings) para que [cada nova sessão interativa se conecte ao Remote Control automaticamente](/pt/remote-control#enable-remote-control-for-all-sessions). Requer Claude Code v2.1.203 ou posterior.110 * A seção Settings inclui **Enable Remote Control for all sessions**, que define [`remoteControlAtStartup`](/docs/pt/settings#available-settings) para que [cada nova sessão interativa se conecte ao Remote Control automaticamente](/docs/pt/remote-control#enable-remote-control-for-all-sessions). Requer Claude Code v2.1.203 ou posterior.

111* **Context indicator**: a caixa de prompt mostra quanto da context window do Claude você está usando. Claude compacta automaticamente quando necessário, ou você pode executar `/compact` manualmente.111* **Context indicator**: a caixa de prompt mostra quanto da context window do Claude você está usando. Claude compacta automaticamente quando necessário, ou você pode executar `/compact` manualmente.

112* **Extended thinking**: permite que Claude gaste mais tempo raciocinando sobre problemas complexos. Alterne-o via menu de comandos (`/`). O raciocínio do Claude aparece na conversa como blocos recolhidos: clique em um bloco para lê-lo, ou pressione `Ctrl+O` para expandir ou recolher cada bloco de pensamento na sessão. Consulte [Extended thinking](/pt/model-config#extended-thinking) para detalhes.112* **Extended thinking**: permite que Claude gaste mais tempo raciocinando sobre problemas complexos. Alterne-o via menu de comandos (`/`). O raciocínio do Claude aparece na conversa como blocos recolhidos: clique em um bloco para lê-lo, ou pressione `Ctrl+O` para expandir ou recolher cada bloco de pensamento na sessão. Consulte [Extended thinking](/docs/pt/model-config#extended-thinking) para detalhes.

113* **Multi-line input**: pressione `Shift+Enter` para adicionar uma nova linha sem enviar. Isso também funciona na entrada de texto livre "Other" de diálogos de pergunta.113* **Multi-line input**: pressione `Shift+Enter` para adicionar uma nova linha sem enviar. Isso também funciona na entrada de texto livre "Other" de diálogos de pergunta.

114 114 

115<h3 id="reference-files-and-folders">115<h3 id="reference-files-and-folders">


133 Resume past conversations133 Resume past conversations

134</h3>134</h3>

135 135 

136Clique no botão **Session history** na parte superior do painel Claude Code para acessar seu histórico de conversas. Você pode pesquisar por palavra-chave ou navegar por tempo (Today, Yesterday, Last 7 days, etc.). Clique em qualquer conversa para retomá-la com o histórico completo de mensagens. Novas sessões recebem títulos gerados por IA com base em sua primeira mensagem. Passe o mouse sobre uma sessão para revelar ações de renomear e remover: renomeie para dar um título descritivo, ou remova para deletá-la da lista. Para mais sobre retomar sessões, consulte [Manage sessions](/pt/sessions).136Clique no botão **Session history** na parte superior do painel Claude Code para acessar seu histórico de conversas. Você pode pesquisar por palavra-chave ou navegar por tempo (Today, Yesterday, Last 7 days, etc.). Clique em qualquer conversa para retomá-la com o histórico completo de mensagens. Novas sessões recebem títulos gerados por IA com base em sua primeira mensagem. Passe o mouse sobre uma sessão para revelar ações de renomear e remover: renomeie para dar um título descritivo, ou remova para deletá-la da lista. Para mais sobre retomar sessões, consulte [Manage sessions](/docs/pt/sessions).

137 137 

138<h3 id="resume-cloud-sessions-from-claude-ai">138<h3 id="resume-cloud-sessions-from-claude-ai">

139 Resume cloud sessions from Claude.ai139 Resume cloud sessions from Claude.ai

140</h3>140</h3>

141 141 

142Se você usar [Claude Code on the web](/pt/claude-code-on-the-web), você pode retomar essas sessões remotas diretamente no VS Code. Isso requer fazer login com **Claude.ai Subscription**, não Anthropic Console.142Se você usar [Claude Code on the web](/docs/pt/claude-code-on-the-web), você pode retomar essas sessões remotas diretamente no VS Code. Isso requer fazer login com **Claude.ai Subscription**, não Anthropic Console.

143 143 

144<Steps>144<Steps>

145 <Step title="Open session history">145 <Step title="Open session history">


167 167 

168O diálogo também detalha o que está contribuindo para seus limites de plano. Ele sinaliza comportamentos que representam 10% ou mais do uso recente, como falhas de cache, contexto longo e sessões com muitos subagentes ou altamente paralelas, cada uma com uma dica para reduzi-la. Tabelas de atribuição mostram quanto uso veio de cada skill, subagente, plugin e servidor MCP. Requer Claude Code v2.1.174 ou posterior.168O diálogo também detalha o que está contribuindo para seus limites de plano. Ele sinaliza comportamentos que representam 10% ou mais do uso recente, como falhas de cache, contexto longo e sessões com muitos subagentes ou altamente paralelas, cada uma com uma dica para reduzi-la. Tabelas de atribuição mostram quanto uso veio de cada skill, subagente, plugin e servidor MCP. Requer Claude Code v2.1.174 ou posterior.

169 169 

170Use o alternador Day e Week para alternar entre as últimas 24 horas e os últimos 7 dias. Os números são aproximados e calculados a partir de sessões locais nesta máquina, portanto o uso de outros dispositivos ou claude.ai não está incluído. Para mais sobre rastreamento e redução de uso, consulte [Track your costs](/pt/costs#track-your-costs).170Use o alternador Day e Week para alternar entre as últimas 24 horas e os últimos 7 dias. Os números são aproximados e calculados a partir de sessões locais nesta máquina, portanto o uso de outros dispositivos ou claude.ai não está incluído. Para mais sobre rastreamento e redução de uso, consulte [Track your costs](/docs/pt/costs#track-your-costs).

171 171 

172<h2 id="customize-your-workflow">172<h2 id="customize-your-workflow">

173 Personalize seu fluxo de trabalho173 Personalize seu fluxo de trabalho


209 Manage plugins209 Manage plugins

210</h2>210</h2>

211 211 

212A extensão VS Code inclui uma interface gráfica para instalar e gerenciar [plugins](/pt/plugins). Digite `/plugins` na caixa de prompt para abrir a interface **Manage plugins**.212A extensão VS Code inclui uma interface gráfica para instalar e gerenciar [plugins](/docs/pt/plugins). Digite `/plugins` na caixa de prompt para abrir a interface **Manage plugins**.

213 213 

214<h3 id="install-plugins">214<h3 id="install-plugins">

215 Install plugins215 Install plugins


246 O gerenciamento de plugins no VS Code usa os mesmos comandos CLI sob o capô. Plugins e marketplaces que você configura na extensão também estão disponíveis na CLI, e vice-versa.246 O gerenciamento de plugins no VS Code usa os mesmos comandos CLI sob o capô. Plugins e marketplaces que você configura na extensão também estão disponíveis na CLI, e vice-versa.

247</Note>247</Note>

248 248 

249Para mais sobre o sistema de plugins, consulte [Plugins](/pt/plugins) e [Plugin marketplaces](/pt/plugin-marketplaces).249Para mais sobre o sistema de plugins, consulte [Plugins](/docs/pt/plugins) e [Plugin marketplaces](/docs/pt/plugin-marketplaces).

250 250 

251<h2 id="automate-browser-tasks-with-chrome">251<h2 id="automate-browser-tasks-with-chrome">

252 Automate browser tasks with Chrome252 Automate browser tasks with Chrome


264 264 

265Claude abre novas abas para tarefas do navegador e compartilha o estado de login do seu navegador, então pode acessar qualquer site em que você já esteja conectado.265Claude abre novas abas para tarefas do navegador e compartilha o estado de login do seu navegador, então pode acessar qualquer site em que você já esteja conectado.

266 266 

267Para instruções de configuração, a lista completa de capacidades e solução de problemas, consulte [Use Claude Code with Chrome](/pt/chrome).267Para instruções de configuração, a lista completa de capacidades e solução de problemas, consulte [Use Claude Code with Chrome](/docs/pt/chrome).

268 268 

269<h2 id="vs-code-commands-and-shortcuts">269<h2 id="vs-code-commands-and-shortcuts">

270 Comandos e atalhos de teclado do VS Code270 Comandos e atalhos de teclado do VS Code


332| Parameter | Description |332| Parameter | Description |

333| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |333| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

334| `prompt` | Texto para pré-preenchimento na caixa de prompt. Deve ser codificado em URL. O prompt é pré-preenchido mas não enviado automaticamente. |334| `prompt` | Texto para pré-preenchimento na caixa de prompt. Deve ser codificado em URL. O prompt é pré-preenchido mas não enviado automaticamente. |

335| `session` | Um ID de sessão para retomar em vez de iniciar uma nova conversa. A sessão deve pertencer ao espaço de trabalho atualmente aberto no VS Code. Se a sessão não for encontrada, uma conversa nova é iniciada em vez disso. Se a sessão já estiver aberta em uma aba, essa aba é focada. Para capturar um ID de sessão programaticamente, consulte [Continue conversations](/pt/headless#continue-conversations). |335| `session` | Um ID de sessão para retomar em vez de iniciar uma nova conversa. A sessão deve pertencer ao espaço de trabalho atualmente aberto no VS Code. Se a sessão não for encontrada, uma conversa nova é iniciada em vez disso. Se a sessão já estiver aberta em uma aba, essa aba é focada. Para capturar um ID de sessão programaticamente, consulte [Continue conversations](/docs/pt/headless#continue-conversations). |

336 336 

337Por exemplo, para abrir uma aba pré-preenchida com "review my changes":337Por exemplo, para abrir uma aba pré-preenchida com "review my changes":

338 338 


340vscode://anthropic.claude-code/open?prompt=review%20my%20changes340vscode://anthropic.claude-code/open?prompt=review%20my%20changes

341```341```

342 342 

343Para iniciar uma sessão de terminal em vez de uma aba VS Code, use o manipulador `claude-cli://` da CLI. Consulte [Launch sessions from links](/pt/deep-links).343Para iniciar uma sessão de terminal em vez de uma aba VS Code, use o manipulador `claude-cli://` da CLI. Consulte [Launch sessions from links](/docs/pt/deep-links).

344 344 

345<h2 id="configure-settings">345<h2 id="configure-settings">

346 Configurar configurações346 Configurar configurações


349A extensão tem dois tipos de configurações:349A extensão tem dois tipos de configurações:

350 350 

351* **Extension settings** no VS Code: controlam o comportamento da extensão dentro do VS Code. Abra com `Cmd+,` (Mac) ou `Ctrl+,` (Windows/Linux), depois vá para Extensions → Claude Code. Você também pode digitar `/` e selecionar **General Config** para abrir as configurações.351* **Extension settings** no VS Code: controlam o comportamento da extensão dentro do VS Code. Abra com `Cmd+,` (Mac) ou `Ctrl+,` (Windows/Linux), depois vá para Extensions → Claude Code. Você também pode digitar `/` e selecionar **General Config** para abrir as configurações.

352* **Claude Code settings** em `~/.claude/settings.json`: compartilhadas entre a extensão e CLI. Use para comandos permitidos, variáveis de ambiente, hooks e MCP servers. Consulte [Settings](/pt/settings) para detalhes.352* **Claude Code settings** em `~/.claude/settings.json`: compartilhadas entre a extensão e CLI. Use para comandos permitidos, variáveis de ambiente, hooks e MCP servers. Consulte [Settings](/docs/pt/settings) para detalhes.

353 353 

354<Tip>354<Tip>

355 Adicione `"$schema": "https://json.schemastore.org/claude-code-settings.json"` ao seu `settings.json` para obter autocomplete e validação inline para todas as configurações disponíveis diretamente no VS Code.355 Adicione `"$schema": "https://json.schemastore.org/claude-code-settings.json"` ao seu `settings.json` para obter autocomplete e validação inline para todas as configurações disponíveis diretamente no VS Code.


362| Setting | Default | Description |362| Setting | Default | Description |

363| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |363| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

364| `useTerminal` | `false` | Inicie Claude em modo terminal em vez de painel gráfico |364| `useTerminal` | `false` | Inicie Claude em modo terminal em vez de painel gráfico |

365| `initialPermissionMode` | `default` | Controla prompts de aprovação para novas conversas: `default`, `plan`, `acceptEdits` ou `bypassPermissions`. {/* min-version: 2.1.200 */}`manual` é um alias para `default` e seleciona o modo rotulado **Manual** no indicador de modo. Requer Claude Code v2.1.200 ou posterior. Consulte [permission modes](/pt/permission-modes). |365| `initialPermissionMode` | `default` | Controla prompts de aprovação para novas conversas: `default`, `plan`, `acceptEdits` ou `bypassPermissions`. `manual` é um alias para `default` e seleciona o modo rotulado **Manual** no indicador de modo. Requer Claude Code v2.1.200 ou posterior. Consulte [permission modes](/docs/pt/permission-modes). |

366| `preferredLocation` | `panel` | Onde Claude abre: `sidebar` (direita) ou `panel` (nova aba) |366| `preferredLocation` | `panel` | Onde Claude abre: `sidebar` (direita) ou `panel` (nova aba) |

367| `autosave` | `true` | Auto-salve arquivos antes de Claude lê-los ou escrevê-los |367| `autosave` | `true` | Auto-salve arquivos antes de Claude lê-los ou escrevê-los |

368| `useCtrlEnterToSend` | `false` | Use Ctrl/Cmd+Enter em vez de Enter para enviar prompts |368| `useCtrlEnterToSend` | `false` | Use Ctrl/Cmd+Enter em vez de Enter para enviar prompts |


374| `environmentVariables` | `[]` | Defina variáveis de ambiente para o processo Claude. Use configurações Claude Code em vez disso para configuração compartilhada. |374| `environmentVariables` | `[]` | Defina variáveis de ambiente para o processo Claude. Use configurações Claude Code em vez disso para configuração compartilhada. |

375| `disableLoginPrompt` | `false` | Pule prompts de autenticação (para configurações de provedor de terceiros) |375| `disableLoginPrompt` | `false` | Pule prompts de autenticação (para configurações de provedor de terceiros) |

376| `allowDangerouslySkipPermissions` | `false` | Adiciona Bypass permissions ao seletor de modo. Use apenas em sandboxes sem acesso à internet. |376| `allowDangerouslySkipPermissions` | `false` | Adiciona Bypass permissions ao seletor de modo. Use apenas em sandboxes sem acesso à internet. |

377| `claudeProcessWrapper` | - | Executável usado para iniciar o processo Claude. O caminho do binário incluído é passado como um argumento quando presente. Defina isso para um binário `claude` instalado separadamente se a compilação da extensão não incluir um para sua plataforma. Um erro "Unsupported platform" na ativação significa que nenhum binário está incluído para sua plataforma; consulte [which platforms have prebuilt binaries](/pt/troubleshoot-install#native-binary-not-found-after-npm-install). |377| `claudeProcessWrapper` | - | Executável usado para iniciar o processo Claude. O caminho do binário incluído é passado como um argumento quando presente. Defina isso para um binário `claude` instalado separadamente se a compilação da extensão não incluir um para sua plataforma. Um erro "Unsupported platform" na ativação significa que nenhum binário está incluído para sua plataforma; consulte [which platforms have prebuilt binaries](/docs/pt/troubleshoot-install#native-binary-not-found-after-npm-install). |

378 378 

379<h2 id="vs-code-extension-vs-claude-code-cli">379<h2 id="vs-code-extension-vs-claude-code-cli">

380 VS Code extension vs. Claude Code CLI380 VS Code extension vs. Claude Code CLI

381</h2>381</h2>

382 382 

383Claude Code está disponível tanto como uma extensão VS Code (painel gráfico) quanto como uma CLI (interface de linha de comando no terminal). Alguns recursos estão disponíveis apenas na CLI. Se você precisar de um recurso apenas da CLI, execute `claude` no terminal integrado do VS Code. Isso requer a [instalação da CLI autônoma](/pt/setup): a extensão não adiciona `claude` ao seu PATH. Consulte [Executar CLI no VS Code](#run-cli-in-vs-code).383Claude Code está disponível tanto como uma extensão VS Code (painel gráfico) quanto como uma CLI (interface de linha de comando no terminal). Alguns recursos estão disponíveis apenas na CLI. Se você precisar de um recurso apenas da CLI, execute `claude` no terminal integrado do VS Code. Isso requer a [instalação da CLI autônoma](/docs/pt/setup): a extensão não adiciona `claude` ao seu PATH. Consulte [Executar CLI no VS Code](#run-cli-in-vs-code).

384 384 

385| Feature | CLI | VS Code Extension |385| Feature | CLI | VS Code Extension |

386| ------------------- | ------------------- | -------------------------------------------------------------------------------------------------- |386| ------------------- | ------------------- | -------------------------------------------------------------------------------------------------- |

387| Commands and skills | [All](/pt/commands) | Subset (digite `/` para ver disponíveis) |387| Commands and skills | [All](/docs/pt/commands) | Subset (digite `/` para ver disponíveis) |

388| MCP server config | Yes | Partial (adicione servidores via CLI; gerencie servidores existentes com `/mcp` no painel de chat) |388| MCP server config | Yes | Partial (adicione servidores via CLI; gerencie servidores existentes com `/mcp` no painel de chat) |

389| Checkpoints | Yes | Yes |389| Checkpoints | Yes | Yes |

390| `!` bash shortcut | Yes | No |390| `!` bash shortcut | Yes | No |


400* **Rewind code to here**: reverta alterações de arquivo de volta a este ponto na conversa mantendo o histórico completo de conversas400* **Rewind code to here**: reverta alterações de arquivo de volta a este ponto na conversa mantendo o histórico completo de conversas

401* **Fork conversation and rewind code**: inicie um novo ramo de conversa e reverta alterações de arquivo para este ponto401* **Fork conversation and rewind code**: inicie um novo ramo de conversa e reverta alterações de arquivo para este ponto

402 402 

403Para detalhes completos sobre como checkpoints funcionam e suas limitações, consulte [Checkpointing](/pt/checkpointing).403Para detalhes completos sobre como checkpoints funcionam e suas limitações, consulte [Checkpointing](/docs/pt/checkpointing).

404 404 

405<h3 id="run-cli-in-vs-code">405<h3 id="run-cli-in-vs-code">

406 Run CLI in VS Code406 Run CLI in VS Code


408 408 

409Para usar a CLI enquanto permanece no VS Code, abra o terminal integrado (`` Ctrl+` `` no Windows/Linux ou `` Cmd+` `` no Mac) e execute `claude`. A CLI se integra automaticamente ao seu IDE para recursos como visualização de diff e compartilhamento de diagnósticos.409Para usar a CLI enquanto permanece no VS Code, abra o terminal integrado (`` Ctrl+` `` no Windows/Linux ou `` Cmd+` `` no Mac) e execute `claude`. A CLI se integra automaticamente ao seu IDE para recursos como visualização de diff e compartilhamento de diagnósticos.

410 410 

411Instalar a extensão não coloca `claude` no PATH do seu shell. A extensão agrupa uma cópia privada da CLI para seu painel de chat, mas digitar `claude` em um terminal requer a [instalação da CLI autônoma](/pt/setup). Execute a instalação uma vez e os comandos nesta página, incluindo `claude mcp add` e `claude --resume`, funcionam em qualquer terminal. Se `claude` ainda não for encontrado após a instalação, [verifique seu PATH](/pt/troubleshoot-install#verify-your-path).411Instalar a extensão não coloca `claude` no PATH do seu shell. A extensão agrupa uma cópia privada da CLI para seu painel de chat, mas digitar `claude` em um terminal requer a [instalação da CLI autônoma](/docs/pt/setup). Execute a instalação uma vez e os comandos nesta página, incluindo `claude mcp add` e `claude --resume`, funcionam em qualquer terminal. Se `claude` ainda não for encontrado após a instalação, [verifique seu PATH](/docs/pt/troubleshoot-install#verify-your-path).

412 412 

413Se estiver usando um terminal externo, execute `/ide` dentro de Claude Code para conectá-lo ao VS Code.413Se estiver usando um terminal externo, execute `/ide` dentro de Claude Code para conectá-lo ao VS Code.

414 414 


445 445 

446Uma vez configurado, peça ao Claude para usar as ferramentas (por exemplo, "Review PR #456").446Uma vez configurado, peça ao Claude para usar as ferramentas (por exemplo, "Review PR #456").

447 447 

448Para gerenciar MCP servers sem sair do VS Code, digite `/mcp` no painel de chat. O diálogo de gerenciamento de MCP permite que você habilite ou desabilite servidores, reconecte a um servidor e gerencie autenticação OAuth. Consulte a [MCP documentation](/pt/mcp) para servidores disponíveis.448Para gerenciar MCP servers sem sair do VS Code, digite `/mcp` no painel de chat. O diálogo de gerenciamento de MCP permite que você habilite ou desabilite servidores, reconecte a um servidor e gerencie autenticação OAuth. Consulte a [MCP documentation](/docs/pt/mcp) para servidores disponíveis.

449 449 

450<h2 id="work-with-git">450<h2 id="work-with-git">

451 Trabalhar com git451 Trabalhar com git


477claude --worktree feature-auth477claude --worktree feature-auth

478```478```

479 479 

480Cada worktree mantém estado de arquivo independente enquanto compartilha histórico git. Isso evita que instâncias do Claude interfiram uma com a outra ao trabalhar em diferentes tarefas. Para mais detalhes, consulte [Run parallel sessions with Git worktrees](/pt/worktrees).480Cada worktree mantém estado de arquivo independente enquanto compartilha histórico git. Isso evita que instâncias do Claude interfiram uma com a outra ao trabalhar em diferentes tarefas. Para mais detalhes, consulte [Run parallel sessions with Git worktrees](/docs/pt/worktrees).

481 481 

482<h2 id="use-third-party-providers">482<h2 id="use-third-party-providers">

483 Use third-party providers483 Use third-party providers


495 <Step title="Configure your provider">495 <Step title="Configure your provider">

496 Siga o guia de configuração para seu provedor:496 Siga o guia de configuração para seu provedor:

497 497 

498 * [Claude Code on Amazon Bedrock](/pt/amazon-bedrock)498 * [Claude Code on Amazon Bedrock](/docs/pt/amazon-bedrock)

499 * [Claude Code on Google Cloud's Agent Platform](/pt/google-vertex-ai)499 * [Claude Code on Google Cloud's Agent Platform](/docs/pt/google-vertex-ai)

500 * [Claude Code on Microsoft Foundry](/pt/microsoft-foundry)500 * [Claude Code on Microsoft Foundry](/docs/pt/microsoft-foundry)

501 501 

502 Estes guias cobrem a configuração de seu provedor em `~/.claude/settings.json`, o que garante que suas configurações sejam compartilhadas entre a extensão VS Code e a CLI.502 Estes guias cobrem a configuração de seu provedor em `~/.claude/settings.json`, o que garante que suas configurações sejam compartilhadas entre a extensão VS Code e a CLI.

503 </Step>503 </Step>


507 Segurança e privacidade507 Segurança e privacidade

508</h2>508</h2>

509 509 

510Seu código permanece privado. Claude Code processa seu código para fornecer assistência, mas não o usa para treinar modelos. Para detalhes sobre manipulação de dados e como desativar o logging, consulte [Data and privacy](/pt/data-usage).510Seu código permanece privado. Claude Code processa seu código para fornecer assistência, mas não o usa para treinar modelos. Para detalhes sobre manipulação de dados e como desativar o logging, consulte [Data and privacy](/docs/pt/data-usage).

511 511 

512Com permissões de auto-edição habilitadas, Claude Code pode modificar arquivos de configuração do VS Code (como `settings.json` ou `tasks.json`) que o VS Code pode executar automaticamente. Para reduzir o risco ao trabalhar com código não confiável:512Com permissões de auto-edição habilitadas, Claude Code pode modificar arquivos de configuração do VS Code (como `settings.json` ou `tasks.json`) que o VS Code pode executar automaticamente. Para reduzir o risco ao trabalhar com código não confiável:

513 513 


523 523 

524O servidor é nomeado `ide` e está oculto de `/mcp` porque não há nada para configurar. Se sua organização usa um hook `PreToolUse` para criar uma lista de permissões de ferramentas MCP, porém, você precisará saber que ele existe.524O servidor é nomeado `ide` e está oculto de `/mcp` porque não há nada para configurar. Se sua organização usa um hook `PreToolUse` para criar uma lista de permissões de ferramentas MCP, porém, você precisará saber que ele existe.

525 525 

526**Seleção e contexto de arquivo aberto.** Enquanto conectado, a CLI inclui sua seleção atual do editor e o caminho do arquivo ativo como contexto em cada prompt que você envia. A transcrição mostra uma linha `⧉ Selected N lines from <file>` quando isso acontece. Para excluir um arquivo sensível como `.env`, adicione uma [regra de negação `Read`](/pt/permissions#read-and-edit) para seu caminho. Uma regra de negação correspondente impede que tanto o texto selecionado quanto o aviso de arquivo aberto para esse arquivo cheguem ao Claude.526**Seleção e contexto de arquivo aberto.** Enquanto conectado, a CLI inclui sua seleção atual do editor e o caminho do arquivo ativo como contexto em cada prompt que você envia. A transcrição mostra uma linha `⧉ Selected N lines from <file>` quando isso acontece. Para excluir um arquivo sensível como `.env`, adicione uma [regra de negação `Read`](/docs/pt/permissions#read-and-edit) para seu caminho. Uma regra de negação correspondente impede que tanto o texto selecionado quanto o aviso de arquivo aberto para esse arquivo cheguem ao Claude.

527 527 

528**Transporte e autenticação.** O servidor se vincula a `127.0.0.1` em uma porta aleatória no intervalo 10000–65535, e a porta não é configurável. O transporte é `ws://` não criptografado; porque o socket é apenas loopback, qualquer processo que pudesse capturar o tráfego também pode ler o token do arquivo de lock, então TLS não adicionaria proteção. Cada ativação de extensão gera um token de autenticação aleatório novo, escreve-o em um arquivo de lock em `~/.claude/ide/<port>.lock`, e a CLI deve apresentá-lo como o header `X-Claude-Code-Ide-Authorization` para se conectar. O arquivo de lock tem permissões `0600` em um diretório `0700`, então apenas o usuário executando VS Code pode lê-lo. Se `CLAUDE_CONFIG_DIR` estiver definido, o arquivo de lock é escrito em `$CLAUDE_CONFIG_DIR/ide/` em vez disso.528**Transporte e autenticação.** O servidor se vincula a `127.0.0.1` em uma porta aleatória no intervalo 10000–65535, e a porta não é configurável. O transporte é `ws://` não criptografado; porque o socket é apenas loopback, qualquer processo que pudesse capturar o tráfego também pode ler o token do arquivo de lock, então TLS não adicionaria proteção. Cada ativação de extensão gera um token de autenticação aleatório novo, escreve-o em um arquivo de lock em `~/.claude/ide/<port>.lock`, e a CLI deve apresentá-lo como o header `X-Claude-Code-Ide-Authorization` para se conectar. O arquivo de lock tem permissões `0600` em um diretório `0700`, então apenas o usuário executando VS Code pode lê-lo. Se `CLAUDE_CONFIG_DIR` estiver definido, o arquivo de lock é escrito em `$CLAUDE_CONFIG_DIR/ide/` em vez disso.

529 529 


6022. Pesquise por "Claude Code"6022. Pesquise por "Claude Code"

6033. Clique em **Uninstall**6033. Clique em **Uninstall**

604 604 

605Executar `claude` em um terminal integrado do VS Code reinstala a extensão automaticamente. Para mantê-la desinstalada, desative **Auto-install IDE extension** em `/config`, ou defina [`autoInstallIdeExtension`](/pt/settings#global-config-settings) como `false`. Você também pode definir a variável de ambiente [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/pt/env-vars) como `1`.605Executar `claude` em um terminal integrado do VS Code reinstala a extensão automaticamente. Para mantê-la desinstalada, desative **Auto-install IDE extension** em `/config`, ou defina [`autoInstallIdeExtension`](/docs/pt/settings#global-config-settings) como `false`. Você também pode definir a variável de ambiente [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/pt/env-vars) como `1`.

606 606 

607Para também remover dados de extensão e redefinir todas as configurações, delete o diretório de armazenamento da extensão para sua plataforma.607Para também remover dados de extensão e redefinir todas as configurações, delete o diretório de armazenamento da extensão para sua plataforma.

608 608 


624Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"624Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

625```625```

626 626 

627Para ajuda adicional, consulte o [guia de solução de problemas](/pt/troubleshooting).627Para ajuda adicional, consulte o [guia de solução de problemas](/docs/pt/troubleshooting).

628 628 

629<h2 id="next-steps">629<h2 id="next-steps">

630 Próximos passos630 Próximos passos


632 632 

633Agora que você tem Claude Code configurado no VS Code:633Agora que você tem Claude Code configurado no VS Code:

634 634 

635* [Explore common workflows](/pt/common-workflows) para aproveitar ao máximo Claude Code635* [Explore common workflows](/docs/pt/common-workflows) para aproveitar ao máximo Claude Code

636* [Set up MCP servers](/pt/mcp) para estender as capacidades do Claude com ferramentas externas. Adicione servidores usando a CLI, depois gerencie-os com `/mcp` no painel de chat.636* [Set up MCP servers](/docs/pt/mcp) para estender as capacidades do Claude com ferramentas externas. Adicione servidores usando a CLI, depois gerencie-os com `/mcp` no painel de chat.

637* [Configure Claude Code settings](/pt/settings) para personalizar comandos permitidos, hooks e muito mais. Essas configurações são compartilhadas entre a extensão e CLI.637* [Configure Claude Code settings](/docs/pt/settings) para personalizar comandos permitidos, hooks e muito mais. Essas configurações são compartilhadas entre a extensão e CLI.

web-quickstart.md +25 −25

Details

21* **Tarefas que não precisam de direcionamento frequente**: envie uma tarefa bem definida, faça outra coisa e revise o resultado quando Claude terminar21* **Tarefas que não precisam de direcionamento frequente**: envie uma tarefa bem definida, faça outra coisa e revise o resultado quando Claude terminar

22* **Perguntas sobre código e exploração**: entenda uma base de código ou rastreie como um recurso é implementado sem um checkout local22* **Perguntas sobre código e exploração**: entenda uma base de código ou rastreie como um recurso é implementado sem um checkout local

23 23 

24Para trabalho que precisa de sua configuração local, ferramentas ou ambiente, executar Claude Code localmente ou usar [Remote Control](/pt/remote-control) é mais adequado.24Para trabalho que precisa de sua configuração local, ferramentas ou ambiente, executar Claude Code localmente ou usar [Remote Control](/docs/pt/remote-control) é mais adequado.

25 25 

26<h2 id="how-sessions-run">26<h2 id="how-sessions-run">

27 Como as sessões são executadas27 Como as sessões são executadas


29 29 

30Quando você envia uma tarefa:30Quando você envia uma tarefa:

31 31 

321. **Clone e prepare**: seu repositório é clonado para uma VM gerenciada pela Anthropic, e seu [script de configuração](/pt/claude-code-on-the-web#setup-scripts) é executado se configurado.321. **Clone e prepare**: seu repositório é clonado para uma VM gerenciada pela Anthropic, e seu [script de configuração](/docs/pt/claude-code-on-the-web#setup-scripts) é executado se configurado.

332. **Configure a rede**: o acesso à internet é definido com base no [nível de acesso](/pt/claude-code-on-the-web#access-levels) do seu ambiente.332. **Configure a rede**: o acesso à internet é definido com base no [nível de acesso](/docs/pt/claude-code-on-the-web#access-levels) do seu ambiente.

343. **Trabalhe**: Claude analisa código, faz alterações, executa testes e verifica seu trabalho. Você pode assistir e direcionar durante todo o processo, ou se afastar e voltar quando terminar.343. **Trabalhe**: Claude analisa código, faz alterações, executa testes e verifica seu trabalho. Você pode assistir e direcionar durante todo o processo, ou se afastar e voltar quando terminar.

354. **Envie a branch**: quando Claude atinge um ponto de parada, ele envia sua branch para o GitHub. Você revisa o diff, deixa comentários inline, cria um PR ou envia outra mensagem para continuar.354. **Envie a branch**: quando Claude atinge um ponto de parada, ele envia sua branch para o GitHub. Você revisa o diff, deixa comentários inline, cria um PR ou envia outra mensagem para continuar.

36 36 


47| **O código é executado em** | VM de nuvem Anthropic | Sua máquina | Sua máquina | Sua máquina ou VM de nuvem |47| **O código é executado em** | VM de nuvem Anthropic | Sua máquina | Sua máquina | Sua máquina ou VM de nuvem |

48| **Você conversa de** | claude.ai ou aplicativo móvel | claude.ai ou aplicativo móvel | Seu terminal | A interface do Desktop |48| **Você conversa de** | claude.ai ou aplicativo móvel | claude.ai ou aplicativo móvel | Seu terminal | A interface do Desktop |

49| **Usa sua configuração local** | Não, apenas repositório | Sim | Sim | Sim para local, não para nuvem |49| **Usa sua configuração local** | Não, apenas repositório | Sim | Sim | Sim para local, não para nuvem |

50| **Requer GitHub** | Sim, ou [agrupe um repositório local](/pt/claude-code-on-the-web#send-local-repositories-without-github) via `--cloud` | Não | Não | Apenas para sessões em nuvem |50| **Requer GitHub** | Sim, ou [agrupe um repositório local](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github) via `--cloud` | Não | Não | Apenas para sessões em nuvem |

51| **Continua funcionando se você desconectar** | Sim | Enquanto o terminal permanecer aberto | Não | Depende do tipo de sessão |51| **Continua funcionando se você desconectar** | Sim | Enquanto o terminal permanecer aberto | Não | Depende do tipo de sessão |

52| **[Modos de permissão](/pt/permission-modes)** | Aceitar edições, Plan, Auto | Manual, Aceitar edições, Plan | Todos os modos | Depende do tipo de sessão |52| **[Modos de permissão](/docs/pt/permission-modes)** | Aceitar edições, Plan, Auto | Manual, Aceitar edições, Plan | Todos os modos | Depende do tipo de sessão |

53| **Acesso à rede** | Configurável por ambiente | Rede da sua máquina | Rede da sua máquina | Depende do tipo de sessão |53| **Acesso à rede** | Configurável por ambiente | Rede da sua máquina | Rede da sua máquina | Depende do tipo de sessão |

54 54 

55Consulte a documentação do [quickstart do terminal](/pt/quickstart), [aplicativo Desktop](/pt/desktop) ou [Remote Control](/pt/remote-control) para configurá-los.55Consulte a documentação do [quickstart do terminal](/docs/pt/quickstart), [aplicativo Desktop](/docs/pt/desktop) ou [Remote Control](/docs/pt/remote-control) para configurá-los.

56 56 

57<h2 id="connect-github-and-create-an-environment">57<h2 id="connect-github-and-create-an-environment">

58 Conecte GitHub e crie um ambiente58 Conecte GitHub e crie um ambiente


70 </Step>70 </Step>

71 71 

72 <Step title="Crie seu ambiente">72 <Step title="Crie seu ambiente">

73 Após conectar o GitHub, você será solicitado a criar um ambiente de nuvem. O ambiente controla qual acesso à rede Claude tem durante as sessões e o que é executado quando uma nova sessão é criada. Consulte [Ferramentas instaladas](/pt/claude-code-on-the-web#installed-tools) para ver o que está disponível sem nenhuma configuração.73 Após conectar o GitHub, você será solicitado a criar um ambiente de nuvem. O ambiente controla qual acesso à rede Claude tem durante as sessões e o que é executado quando uma nova sessão é criada. Consulte [Ferramentas instaladas](/docs/pt/claude-code-on-the-web#installed-tools) para ver o que está disponível sem nenhuma configuração.

74 74 

75 O formulário tem estes campos:75 O formulário tem estes campos:

76 76 

77 * **Nome**: um rótulo de exibição. Útil quando você tem múltiplos ambientes para diferentes projetos ou níveis de acesso.77 * **Nome**: um rótulo de exibição. Útil quando você tem múltiplos ambientes para diferentes projetos ou níveis de acesso.

78 * **Acesso à rede**: controla o que a sessão pode alcançar na internet. O padrão, `Trusted`, permite conexões com [registros de pacotes comuns](/pt/claude-code-on-the-web#default-allowed-domains) como npm, PyPI e RubyGems enquanto bloqueia o acesso geral à internet.78 * **Acesso à rede**: controla o que a sessão pode alcançar na internet. O padrão, `Trusted`, permite conexões com [registros de pacotes comuns](/docs/pt/claude-code-on-the-web#default-allowed-domains) como npm, PyPI e RubyGems enquanto bloqueia o acesso geral à internet.

79 * **Variáveis de ambiente**: variáveis opcionais disponíveis em cada sessão, em formato `.env`. Não coloque valores entre aspas, pois as aspas são armazenadas como parte do valor. Estas são visíveis para qualquer pessoa que possa editar este ambiente.79 * **Variáveis de ambiente**: variáveis opcionais disponíveis em cada sessão, em formato `.env`. Não coloque valores entre aspas, pois as aspas são armazenadas como parte do valor. Estas são visíveis para qualquer pessoa que possa editar este ambiente.

80 * **Script de configuração**: um script Bash opcional que é executado antes do Claude Code ser iniciado. Use-o para instalar ferramentas do sistema que a VM de nuvem não inclui, como `apt install -y gh`. O resultado é [armazenado em cache](/pt/claude-code-on-the-web#environment-caching), portanto o script não é executado novamente a cada sessão. Consulte [Scripts de configuração](/pt/claude-code-on-the-web#setup-scripts) para exemplos e dicas de depuração.80 * **Script de configuração**: um script Bash opcional que é executado antes do Claude Code ser iniciado. Use-o para instalar ferramentas do sistema que a VM de nuvem não inclui, como `apt install -y gh`. O resultado é [armazenado em cache](/docs/pt/claude-code-on-the-web#environment-caching), portanto o script não é executado novamente a cada sessão. Consulte [Scripts de configuração](/docs/pt/claude-code-on-the-web#setup-scripts) para exemplos e dicas de depuração.

81 81 

82 Para um primeiro projeto, deixe os padrões e clique em **Criar ambiente**. Você pode [editá-lo depois ou criar ambientes adicionais](/pt/claude-code-on-the-web#configure-your-environment) para diferentes projetos.82 Para um primeiro projeto, deixe os padrões e clique em **Criar ambiente**. Você pode [editá-lo depois ou criar ambientes adicionais](/docs/pt/claude-code-on-the-web#configure-your-environment) para diferentes projetos.

83 </Step>83 </Step>

84</Steps>84</Steps>

85 85 


87 Conecte do seu terminal87 Conecte do seu terminal

88</h3>88</h3>

89 89 

90Se 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](/pt/quickstart). `/web-setup` lê seu token `gh` local, vincula-o à sua conta Claude e cria um ambiente de nuvem padrão se você não tiver um.90Se 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). `/web-setup` lê seu token `gh` local, vincula-o à sua conta Claude e cria um ambiente de nuvem padrão se você não tiver um.

91 91 

92<Note>92<Note>

93 Organizações com [Zero Data Retention](/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem. Se a CLI do GitHub não estiver instalada ou autenticada, `/web-setup` abre o fluxo de integração do navegador.93 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem. Se a CLI do GitHub não estiver instalada ou autenticada, `/web-setup` abre o fluxo de integração do navegador.

94</Note>94</Note>

95 95 

96<Steps>96<Steps>


113 /web-setup113 /web-setup

114 ```114 ```

115 115 

116 Isso sincroniza seu token `gh` com sua conta Claude. Se você ainda não tiver um ambiente de nuvem, `/web-setup` cria um com acesso à rede Trusted e sem script de configuração. Você pode [editar o ambiente ou adicionar variáveis](/pt/claude-code-on-the-web#configure-your-environment) depois. Após `/web-setup` ser concluído, você pode iniciar sessões em nuvem do seu terminal com [`--cloud`](/pt/claude-code-on-the-web#from-terminal-to-web) ou configurar tarefas recorrentes com [`/schedule`](/pt/routines).116 Isso sincroniza seu token `gh` com sua conta Claude. Se você ainda não tiver um ambiente de nuvem, `/web-setup` cria um com acesso à rede Trusted e sem script de configuração. Você pode [editar o ambiente ou adicionar variáveis](/docs/pt/claude-code-on-the-web#configure-your-environment) depois. Após `/web-setup` ser concluído, você pode iniciar sessões em nuvem do seu terminal com [`--cloud`](/docs/pt/claude-code-on-the-web#from-terminal-to-web) ou configurar tarefas recorrentes com [`/schedule`](/docs/pt/routines).

117 </Step>117 </Step>

118</Steps>118</Steps>

119 119 


129 </Step>129 </Step>

130 130 

131 <Step title="Escolha um modo de permissão">131 <Step title="Escolha um modo de permissão">

132 O dropdown de modo ao lado da entrada padrão é **Aceitar edições**, onde Claude faz alterações e envia uma branch sem parar para aprovação. Mude para **Plan** se você quiser que Claude proponha uma abordagem e aguarde seu aval antes de editar arquivos. As sessões em nuvem não oferecem permissões Manual ou Bypass. Consulte a [lista completa de modos de permissão](/pt/permission-modes#available-modes) para saber o que cada um permite.132 O dropdown de modo ao lado da entrada padrão é **Aceitar edições**, onde Claude faz alterações e envia uma branch sem parar para aprovação. Mude para **Plan** se você quiser que Claude proponha uma abordagem e aguarde seu aval antes de editar arquivos. As sessões em nuvem não oferecem permissões Manual ou Bypass. Consulte a [lista completa de modos de permissão](/docs/pt/permission-modes#available-modes) para saber o que cada um permite.

133 </Step>133 </Step>

134 134 

135 <Step title="Descreva a tarefa e envie">135 <Step title="Descreva a tarefa e envie">


182 </Step>182 </Step>

183 183 

184 <Step title="Continue iterando após o PR">184 <Step title="Continue iterando após o PR">

185 A sessão permanece ativa após o PR ser criado. Cole a saída de falha de CI ou comentários do revisor no chat e peça a Claude para resolvê-los. Para ter Claude monitorar o PR automaticamente, consulte [Auto-fix pull requests](/pt/claude-code-on-the-web#auto-fix-pull-requests).185 A sessão permanece ativa após o PR ser criado. Cole a saída de falha de CI ou comentários do revisor no chat e peça a Claude para resolvê-los. Para ter Claude monitorar o PR automaticamente, consulte [Auto-fix pull requests](/docs/pt/claude-code-on-the-web#auto-fix-pull-requests).

186 </Step>186 </Step>

187</Steps>187</Steps>

188 188 


194 Nenhum repositório aparece após conectar GitHub194 Nenhum repositório aparece após conectar GitHub

195</h3>195</h3>

196 196 

197Uma sessão em nuvem pode usar qualquer repositório que a conta GitHub conectada possa ver, independentemente de quais repositórios o aplicativo Claude GitHub está instalado. Se um repositório está faltando, verifique se a conta GitHub conectada tem acesso a ele no GitHub. Se você também quiser [Auto-fix](/pt/claude-code-on-the-web#auto-fix-pull-requests) para um repositório, instale o App nele: em github.com, abra **Configurações → Aplicativos → Claude → Configurar** e verifique se o repositório está listado em **Acesso ao repositório**. Repositórios privados precisam da mesma autorização que os públicos.197Uma sessão em nuvem pode usar qualquer repositório que a conta GitHub conectada possa ver, independentemente de quais repositórios o aplicativo Claude GitHub está instalado. Se um repositório está faltando, verifique se a conta GitHub conectada tem acesso a ele no GitHub. Se você também quiser [Auto-fix](/docs/pt/claude-code-on-the-web#auto-fix-pull-requests) para um repositório, instale o App nele: em github.com, abra **Configurações → Aplicativos → Claude → Configurar** e verifique se o repositório está listado em **Acesso ao repositório**. Repositórios privados precisam da mesma autorização que os públicos.

198 198 

199<h3 id="the-page-only-shows-a-github-login-button">199<h3 id="the-page-only-shows-a-github-login-button">

200 A página mostra apenas um botão de login do GitHub200 A página mostra apenas um botão de login do GitHub

201</h3>201</h3>

202 202 

203As sessões em nuvem requerem uma conta GitHub conectada. Conecte através do fluxo do navegador acima, ou execute `/web-setup` do seu terminal se você usar a CLI do GitHub. Se você preferir não conectar o GitHub, consulte [Remote Control](/pt/remote-control) para executar Claude Code em sua própria máquina e monitorá-lo na web.203As sessões em nuvem requerem uma conta GitHub conectada. Conecte através do fluxo do navegador acima, ou execute `/web-setup` do seu terminal se você usar a CLI do GitHub. Se você preferir não conectar o GitHub, consulte [Remote Control](/docs/pt/remote-control) para executar Claude Code em sua própria máquina e monitorá-lo na web.

204 204 

205<h3 id="not-available-for-the-selected-organization">205<h3 id="not-available-for-the-selected-organization">

206 "Não disponível para a organização selecionada"206 "Não disponível para a organização selecionada"


220 "Não foi possível criar um ambiente de nuvem" ou "Nenhum ambiente de nuvem disponível" ao usar `--cloud` ou ultraplan220 "Não foi possível criar um ambiente de nuvem" ou "Nenhum ambiente de nuvem disponível" ao usar `--cloud` ou ultraplan

221</h3>221</h3>

222 222 

223Os recursos de sessão remota criam um ambiente de nuvem padrão automaticamente se você não tiver um. Se você vir "Não foi possível criar um ambiente de nuvem", a criação automática falhou. {/* max-version: 2.1.100 */}Se você vir "Nenhum ambiente de nuvem disponível", sua CLI é anterior à criação automática. Em qualquer caso, execute `/web-setup` na CLI do Claude Code para criar um manualmente, ou visite [claude.ai/code](https://claude.ai/code) e siga a etapa **Crie seu ambiente** acima.223Os recursos de sessão remota criam um ambiente de nuvem padrão automaticamente se você não tiver um. Se você vir "Não foi possível criar um ambiente de nuvem", a criação automática falhou. Se você vir "Nenhum ambiente de nuvem disponível", sua CLI é anterior à criação automática. Em qualquer caso, execute `/web-setup` na CLI do Claude Code para criar um manualmente, ou visite [claude.ai/code](https://claude.ai/code) e siga a etapa **Crie seu ambiente** acima.

224 224 

225<h3 id="setup-script-failed">225<h3 id="setup-script-failed">

226 Script de configuração falhou226 Script de configuração falhou


228 228 

229O script de configuração saiu com um status diferente de zero, o que bloqueia o início da sessão. Causas comuns:229O script de configuração saiu com um status diferente de zero, o que bloqueia o início da sessão. Causas comuns:

230 230 

231* Uma instalação de pacote falhou porque o registro não está no seu [nível de acesso à rede](/pt/claude-code-on-the-web#access-levels). `Trusted` cobre a maioria dos gerenciadores de pacotes; `None` bloqueia todos.231* Uma instalação de pacote falhou porque o registro não está no seu [nível de acesso à rede](/docs/pt/claude-code-on-the-web#access-levels). `Trusted` cobre a maioria dos gerenciadores de pacotes; `None` bloqueia todos.

232* O script faz referência a um arquivo ou caminho que não existe em um clone novo.232* O script faz referência a um arquivo ou caminho que não existe em um clone novo.

233* Um comando que funciona localmente precisa de uma invocação diferente no Ubuntu.233* Um comando que funciona localmente precisa de uma invocação diferente no Ubuntu.

234 234 


238 Novas sessões travam ou expiram durante a configuração238 Novas sessões travam ou expiram durante a configuração

239</h3>239</h3>

240 240 

241Se novas sessões ficarem presas na etapa do script de configuração ou falharem com um erro genérico de contêiner antes do script terminar, o script provavelmente está excedendo o orçamento de tempo de aproximadamente cinco minutos para construir o [cache de ambiente](/pt/claude-code-on-the-web#environment-caching). Etapas pesadas como puxar imagens Docker grandes, sincronizar árvores de dependência completas ou baixar pesos de modelo frequentemente empurram o total além do limite, especialmente quando são executadas uma após a outra.241Se novas sessões ficarem presas na etapa do script de configuração ou falharem com um erro genérico de contêiner antes do script terminar, o script provavelmente está excedendo o orçamento de tempo de aproximadamente cinco minutos para construir o [cache de ambiente](/docs/pt/claude-code-on-the-web#environment-caching). Etapas pesadas como puxar imagens Docker grandes, sincronizar árvores de dependência completas ou baixar pesos de modelo frequentemente empurram o total além do limite, especialmente quando são executadas uma após a outra.

242 242 

243Para corrigir isso, reduza o script para que ele termine de forma confiável em menos de cinco minutos:243Para corrigir isso, reduza o script para que ele termine de forma confiável em menos de cinco minutos:

244 244 

245* Execute instalações independentes em paralelo com `&` e um `wait` final em vez de executá-las serialmente.245* Execute instalações independentes em paralelo com `&` e um `wait` final em vez de executá-las serialmente.

246* Mova os maiores downloads para fora do script de configuração e para um [hook SessionStart](/pt/claude-code-on-the-web#setup-scripts-vs-sessionstart-hooks) que os inicia em segundo plano, para que a sessão se torne utilizável enquanto eles terminam.246* Mova os maiores downloads para fora do script de configuração e para um [hook SessionStart](/docs/pt/claude-code-on-the-web#setup-scripts-vs-sessionstart-hooks) que os inicia em segundo plano, para que a sessão se torne utilizável enquanto eles terminam.

247* Remova longas tentativas de sono do script de configuração, pois um loop de tentativa travado conta contra o orçamento.247* Remova longas tentativas de sono do script de configuração, pois um loop de tentativa travado conta contra o orçamento.

248 248 

249<h3 id="session-keeps-running-after-closing-the-tab">249<h3 id="session-keeps-running-after-closing-the-tab">

250 A sessão continua funcionando após fechar a aba250 A sessão continua funcionando após fechar a aba

251</h3>251</h3>

252 252 

253Isso é por design. Fechar a aba ou navegar para longe não interrompe a sessão. Ela continua funcionando em segundo plano até Claude terminar a tarefa atual, depois fica ociosa. Na barra lateral, você pode [arquivar uma sessão](/pt/claude-code-on-the-web#archive-sessions) para ocultá-la de sua lista, ou [deletá-la](/pt/claude-code-on-the-web#delete-sessions) para removê-la permanentemente.253Isso é por design. Fechar a aba ou navegar para longe não interrompe a sessão. Ela continua funcionando em segundo plano até Claude terminar a tarefa atual, depois fica ociosa. Na barra lateral, você pode [arquivar uma sessão](/docs/pt/claude-code-on-the-web#archive-sessions) para ocultá-la de sua lista, ou [deletá-la](/docs/pt/claude-code-on-the-web#delete-sessions) para removê-la permanentemente.

254 254 

255<h2 id="next-steps">255<h2 id="next-steps">

256 Próximos passos256 Próximos passos


258 258 

259Agora que você pode enviar e revisar tarefas, estas páginas cobrem o que vem a seguir: iniciar sessões em nuvem do seu terminal, agendar trabalho recorrente e dar instruções permanentes a Claude.259Agora que você pode enviar e revisar tarefas, estas páginas cobrem o que vem a seguir: iniciar sessões em nuvem do seu terminal, agendar trabalho recorrente e dar instruções permanentes a Claude.

260 260 

261* [Use Claude Code na web](/pt/claude-code-on-the-web): a referência completa, incluindo teletransporte de sessões para seu terminal, scripts de configuração, variáveis de ambiente e configuração de rede261* [Use Claude Code na web](/docs/pt/claude-code-on-the-web): a referência completa, incluindo teletransporte de sessões para seu terminal, scripts de configuração, variáveis de ambiente e configuração de rede

262* [Routines](/pt/routines): automatize trabalho em um cronograma, via chamada de API ou em resposta a eventos do GitHub262* [Routines](/docs/pt/routines): automatize trabalho em um cronograma, via chamada de API ou em resposta a eventos do GitHub

263* [CLAUDE.md](/pt/memory): dê a Claude instruções persistentes e contexto que carregam no início de cada sessão263* [CLAUDE.md](/docs/pt/memory): dê a Claude instruções persistentes e contexto que carregam no início de cada sessão

264* Instale o aplicativo móvel Claude para [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) ou [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) para monitorar sessões do seu telefone. Da CLI do Claude Code, `/mobile` mostra um código QR.264* Instale o aplicativo móvel Claude para [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) ou [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) para monitorar sessões do seu telefone. Da CLI do Claude Code, `/mobile` mostra um código QR.

workflows.md +19 −21

Details

6 6 

7> Fluxos de trabalho dinâmicos orquestram muitos subagentos a partir de um script que Claude escreve e você pode executar novamente. Use-os para auditorias de base de código, grandes migrações e pesquisa com verificação cruzada.7> Fluxos de trabalho dinâmicos orquestram muitos subagentos a partir de um script que Claude escreve e você pode executar novamente. Use-os para auditorias de base de código, grandes migrações e pesquisa com verificação cruzada.

8 8 

9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}

10 

11<Note>9<Note>

12 Fluxos de trabalho dinâmicos exigem Claude Code v2.1.154 ou posterior e estão disponíveis em todos os planos pagos, com acesso à API Anthropic, e no Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. No Pro, ative-os na linha Dynamic workflows em `/config`.10 Fluxos de trabalho dinâmicos exigem Claude Code v2.1.154 ou posterior e estão disponíveis em todos os planos pagos, com acesso à API Anthropic, e no Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. No Pro, ative-os na linha Dynamic workflows em `/config`.

13</Note>11</Note>

14 12 

15Um fluxo de trabalho dinâmico é um script JavaScript que orquestra [subagentos](/pt/sub-agents) em escala. Claude escreve o script para a tarefa que você descreve, e um runtime o executa em segundo plano enquanto sua sessão permanece responsiva.13Um fluxo de trabalho dinâmico é um script JavaScript que orquestra [subagentos](/docs/pt/sub-agents) em escala. Claude escreve o script para a tarefa que você descreve, e um runtime o executa em segundo plano enquanto sua sessão permanece responsiva.

16 14 

17Recorra a um fluxo de trabalho quando uma tarefa precisar de mais agentes do que uma conversa pode coordenar, ou quando você quiser que a orquestração seja codificada como um script que você possa ler e executar novamente. Os exemplos incluem uma varredura de bugs em toda a base de código, uma migração de 500 arquivos, uma pergunta de pesquisa que precisa ter fontes verificadas cruzadamente uma contra a outra, e um plano difícil que vale a pena ser elaborado de vários ângulos independentes antes de você se comprometer com um.15Recorra a um fluxo de trabalho quando uma tarefa precisar de mais agentes do que uma conversa pode coordenar, ou quando você quiser que a orquestração seja codificada como um script que você possa ler e executar novamente. Os exemplos incluem uma varredura de bugs em toda a base de código, uma migração de 500 arquivos, uma pergunta de pesquisa que precisa ter fontes verificadas cruzadamente uma contra a outra, e um plano difícil que vale a pena ser elaborado de vários ângulos independentes antes de você se comprometer com um.

18 16 


20 Quando usar um fluxo de trabalho18 Quando usar um fluxo de trabalho

21</h2>19</h2>

22 20 

23[Subagentos](/pt/sub-agents), [skills](/pt/skills), [equipes de agentes](/pt/agent-teams) e fluxos de trabalho podem todos executar uma tarefa com várias etapas. A diferença é quem mantém o plano:21[Subagentos](/docs/pt/sub-agents), [skills](/docs/pt/skills), [equipes de agentes](/docs/pt/agent-teams) e fluxos de trabalho podem todos executar uma tarefa com várias etapas. A diferença é quem mantém o plano:

24 22 

25| | Subagentos | Skills | Equipes de agentes | Fluxos de trabalho |23| | Subagentos | Skills | Equipes de agentes | Fluxos de trabalho |

26| :-------------------------------------- | :---------------------------------- | :--------------------------- | :-------------------------------------------------- | :----------------------------------------- |24| :-------------------------------------- | :---------------------------------- | :--------------------------- | :-------------------------------------------------- | :----------------------------------------- |


69 <Step title="Ler o relatório">67 <Step title="Ler o relatório">

70 Quando a execução termina, o relatório chega em sua sessão. Ele cita as fontes de cada afirmação, com afirmações que não sobreviveram à verificação cruzada já filtradas.68 Quando a execução termina, o relatório chega em sua sessão. Ele cita as fontes de cada afirmação, com afirmações que não sobreviveram à verificação cruzada já filtradas.

71 69 

72 {/* min-version: 2.1.196 */}A partir da v2.1.196, quando os agentes verificadores não conseguem verificar uma afirmação, como após um limite de taxa ou erro de API, o relatório lista essa afirmação como não verificada em vez de contá-la como refutada.70 A partir da v2.1.196, quando os agentes verificadores não conseguem verificar uma afirmação, como após um limite de taxa ou erro de API, o relatório lista essa afirmação como não verificada em vez de contá-la como refutada.

73 </Step>71 </Step>

74</Steps>72</Steps>

75 73 


83 81 

84| Comando | O que faz |82| Comando | O que faz |

85| :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

86| `/deep-research <question>` | Distribui buscas na web em uma pergunta em vários ângulos, busca e verifica cruzadamente as fontes que encontra, vota em cada afirmação e retorna um relatório citado com afirmações que não sobreviveram à verificação cruzada filtradas. Requer que a [ferramenta WebSearch](/pt/tools-reference#websearch-tool-behavior) esteja disponível |84| `/deep-research <question>` | Distribui buscas na web em uma pergunta em vários ângulos, busca e verifica cruzadamente as fontes que encontra, vota em cada afirmação e retorna um relatório citado com afirmações que não sobreviveram à verificação cruzada filtradas. Requer que a [ferramenta WebSearch](/docs/pt/tools-reference#websearch-tool-behavior) esteja disponível |

87 85 

88[Fluxos de trabalho que você salva](#save-the-workflow-for-reuse) você mesmo se tornam comandos da mesma forma e aparecem no autocomplete `/` junto com os agrupados.86[Fluxos de trabalho que você salva](#save-the-workflow-for-reuse) você mesmo se tornam comandos da mesma forma e aparecem no autocomplete `/` junto com os agrupados.

89 87 


105| `Enter` ou `→` | Aprofundar-se na fase selecionada, depois em um agente para ler seu prompt, chamadas de ferramentas recentes e resultado |103| `Enter` ou `→` | Aprofundar-se na fase selecionada, depois em um agente para ler seu prompt, chamadas de ferramentas recentes e resultado |

106| `Esc` ou `←` | Voltar um nível. Na v2.1.203 até v2.1.205, `←` não voltava para fora de uma fase ou agente; use `Esc` nessas versões |104| `Esc` ou `←` | Voltar um nível. Na v2.1.203 até v2.1.205, `←` não voltava para fora de uma fase ou agente; use `Esc` nessas versões |

107| `j` / `k` | Rolar dentro do detalhe do agente quando transborda |105| `j` / `k` | Rolar dentro do detalhe do agente quando transborda |

108| `f` | {/* min-version: 2.1.186 */}Filtrar a lista de agentes na fase selecionada por status. Pressione novamente para ciclar |106| `f` | Filtrar a lista de agentes na fase selecionada por status. Pressione novamente para ciclar |

109| `p` | Pausar ou retomar a execução |107| `p` | Pausar ou retomar a execução |

110| `x` | Parar o agente selecionado, ou parar todo o fluxo de trabalho quando o foco está na execução |108| `x` | Parar o agente selecionado, ou parar todo o fluxo de trabalho quando o foco está na execução |

111| `r` | Reiniciar o agente em execução selecionado |109| `r` | Reiniciar o agente em execução selecionado |


142 Deixe Claude decidir com ultracode140 Deixe Claude decidir com ultracode

143</h3>141</h3>

144 142 

145Ultracode é uma configuração de Claude Code que combina `xhigh` [esforço de raciocínio](/pt/model-config#adjust-effort-level) com orquestração automática de fluxo de trabalho. Com ele ativado, Claude planeja um fluxo de trabalho para cada tarefa substancial em vez de esperar você pedir.143Ultracode é uma configuração de Claude Code que combina `xhigh` [esforço de raciocínio](/docs/pt/model-config#adjust-effort-level) com orquestração automática de fluxo de trabalho. Com ele ativado, Claude planeja um fluxo de trabalho para cada tarefa substancial em vez de esperar você pedir.

146 144 

147```text theme={null}145```text theme={null}

148/effort ultracode146/effort ultracode


152 150 

153Com ultracode ativado, Claude decide quando uma tarefa justifica um fluxo de trabalho. Uma única solicitação pode se transformar em vários fluxos de trabalho seguidos: um para entender o código, um para fazer a alteração e um para verificá-la. Isso se aplica a cada tarefa na sessão, então cada solicitação usa mais tokens e leva mais tempo do que em níveis de esforço mais baixos.151Com ultracode ativado, Claude decide quando uma tarefa justifica um fluxo de trabalho. Uma única solicitação pode se transformar em vários fluxos de trabalho seguidos: um para entender o código, um para fazer a alteração e um para verificá-la. Isso se aplica a cada tarefa na sessão, então cada solicitação usa mais tokens e leva mais tempo do que em níveis de esforço mais baixos.

154 152 

155Ultracode dura para a sessão atual e é redefinido quando você inicia uma nova. Volte com `/effort high` quando retornar ao trabalho de rotina. Está disponível em modelos que suportam `xhigh` [esforço](/pt/model-config#adjust-effort-level); em outros modelos o menu `/effort` não o oferece.153Ultracode dura para a sessão atual e é redefinido quando você inicia uma nova. Volte com `/effort high` quando retornar ao trabalho de rotina. Está disponível em modelos que suportam `xhigh` [esforço](/docs/pt/model-config#adjust-effort-level); em outros modelos o menu `/effort` não o oferece.

156 154 

157<h3 id="approve-the-plan-before-it-runs">155<h3 id="approve-the-plan-before-it-runs">

158 Aprovar o plano antes de ser executado156 Aprovar o plano antes de ser executado


167 165 

168`Ctrl+G` abre o script em seu editor. `Tab` permite que você ajuste o prompt antes da execução começar.166`Ctrl+G` abre o script em seu editor. `Tab` permite que você ajuste o prompt antes da execução começar.

169 167 

170Se você vê este prompt depende do seu [modo de permissão](/pt/permission-modes):168Se você vê este prompt depende do seu [modo de permissão](/docs/pt/permission-modes):

171 169 

172| Modo de permissão | Quando você é solicitado |170| Modo de permissão | Quando você é solicitado |

173| :------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |171| :------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


177 175 

178No aplicativo Desktop, um cartão de aprovação mostra o nome do fluxo de trabalho, a lista de fases e um aviso de uso de token, com ações **Uma vez**, **Sempre** e **Negar**. A visualização de progresso aparece no painel de tarefas em segundo plano.176No aplicativo Desktop, um cartão de aprovação mostra o nome do fluxo de trabalho, a lista de fases e um aviso de uso de token, com ações **Uma vez**, **Sempre** e **Negar**. A visualização de progresso aparece no painel de tarefas em segundo plano.

179 177 

180Seu modo de permissão controla apenas o prompt de lançamento acima. Os subagentos que o fluxo de trabalho spawna sempre são executados no modo `acceptEdits` e herdam sua [lista de permissão de ferramentas](/pt/settings#permission-settings), independentemente do modo de sua sessão. As edições de arquivo são aprovadas automaticamente.178Seu modo de permissão controla apenas o prompt de lançamento acima. Os subagentos que o fluxo de trabalho spawna sempre são executados no modo `acceptEdits` e herdam sua [lista de permissão de ferramentas](/docs/pt/settings#permission-settings), independentemente do modo de sua sessão. As edições de arquivo são aprovadas automaticamente.

181 179 

182Comandos shell, buscas na web e ferramentas MCP que não estão em sua lista de permissão ainda podem solicitá-lo durante a execução. Para evitar isso em uma execução longa, adicione os comandos que os agentes precisam à sua lista de permissão antes de começar.180Comandos shell, buscas na web e ferramentas MCP que não estão em sua lista de permissão ainda podem solicitá-lo durante a execução. Para evitar isso em uma execução longa, adicione os comandos que os agentes precisam à sua lista de permissão antes de começar.

183 181 


192Execute `/workflows`, selecione a execução que você deseja manter e pressione `s`. Na caixa de diálogo de salvamento, Tab alterna entre os dois locais de salvamento:190Execute `/workflows`, selecione a execução que você deseja manter e pressione `s`. Na caixa de diálogo de salvamento, Tab alterna entre os dois locais de salvamento:

193 191 

194* `.claude/workflows/` em seu projeto: compartilhado com todos que clonam o repositório192* `.claude/workflows/` em seu projeto: compartilhado com todos que clonam o repositório

195* `~/.claude/workflows/` em seu diretório inicial: disponível em cada projeto, visível apenas para você. Se você definir [`CLAUDE_CONFIG_DIR`](/pt/env-vars), este local é o diretório `workflows/` sob esse caminho.193* `~/.claude/workflows/` em seu diretório inicial: disponível em cada projeto, visível apenas para você. Se você definir [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars), este local é o diretório `workflows/` sob esse caminho.

196 194 

197{/* min-version: 2.1.208 */}A caixa de diálogo de salvamento mostra o caminho resolvido para o local pessoal. Antes da v2.1.208, ela mostrava `~/.claude/workflows/` mesmo quando `CLAUDE_CONFIG_DIR` estava definido; o arquivo ainda era salvo sob o diretório configurado.195A caixa de diálogo de salvamento mostra o caminho resolvido para o local pessoal. Antes da v2.1.208, ela mostrava `~/.claude/workflows/` mesmo quando `CLAUDE_CONFIG_DIR` estava definido; o arquivo ainda era salvo sob o diretório configurado.

198 196 

199Pressione Enter para salvar. O fluxo de trabalho é executado como `/<name>` em futuras sessões de qualquer local.197Pressione Enter para salvar. O fluxo de trabalho é executado como `/<name>` em futuras sessões de qualquer local.

200 198 

201{/* min-version: 2.1.178 */}Em um monorepo com vários diretórios `.claude/`, você pode manter fluxos de trabalho ao lado do pacote ao qual se aplicam. A partir da v2.1.178, salvar no local do projeto escreve no diretório `.claude/workflows/` mais próximo que já existe entre seu diretório de trabalho e a raiz do repositório, ou para a raiz do repositório se nenhum existir ainda. Os fluxos de trabalho do projeto também carregam de cada `.claude/workflows/` ao longo desse caminho, e quando mais de um define o mesmo nome Claude Code executa o mais próximo do diretório de trabalho.199Em um monorepo com vários diretórios `.claude/`, você pode manter fluxos de trabalho ao lado do pacote ao qual se aplicam. A partir da v2.1.178, salvar no local do projeto escreve no diretório `.claude/workflows/` mais próximo que já existe entre seu diretório de trabalho e a raiz do repositório, ou para a raiz do repositório se nenhum existir ainda. Os fluxos de trabalho do projeto também carregam de cada `.claude/workflows/` ao longo desse caminho, e quando mais de um define o mesmo nome Claude Code executa o mais próximo do diretório de trabalho.

202 200 

203Se um fluxo de trabalho de projeto e um fluxo de trabalho pessoal compartilham um nome, o do projeto é executado.201Se um fluxo de trabalho de projeto e um fluxo de trabalho pessoal compartilham um nome, o do projeto é executado.

204 202 


305return audits.filter(Boolean)303return audits.filter(Boolean)

306```304```

307 305 

308O corpo é JavaScript simples com `await` de nível superior. `agent()` spawna um subagentos e `pipeline()` executa um por item em uma lista. Se você quiser editar um script manualmente, peça a Claude para orientá-lo através da alteração, ou consulte a entrada da ferramenta Workflow na [referência do Agent SDK](/pt/agent-sdk/typescript) para o conjunto completo de opções.306O corpo é JavaScript simples com `await` de nível superior. `agent()` spawna um subagentos e `pipeline()` executa um por item em uma lista. Se você quiser editar um script manualmente, peça a Claude para orientá-lo através da alteração, ou consulte a entrada da ferramenta Workflow na [referência do Agent SDK](/docs/pt/agent-sdk/typescript) para o conjunto completo de opções.

309 307 

310<h2 id="how-a-workflow-runs">308<h2 id="how-a-workflow-runs">

311 Como um fluxo de trabalho é executado309 Como um fluxo de trabalho é executado


359* Se você [defina uma diretriz de tamanho](#set-a-size-guideline), a contagem de agentes da diretriz substitui o limite de 25 agentes.357* Se você [defina uma diretriz de tamanho](#set-a-size-guideline), a contagem de agentes da diretriz substitui o limite de 25 agentes.

360* Sessões com [ultracode](#let-claude-decide-with-ultracode) ativado não mostram o aviso, porque ativar ultracode já o opta para execuções grandes.358* Sessões com [ultracode](#let-claude-decide-with-ultracode) ativado não mostram o aviso, porque ativar ultracode já o opta para execuções grandes.

361 359 

362Cada agente em um fluxo de trabalho usa o modelo de sua sessão a menos que o script rotule um estágio para um diferente ou a variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/pt/model-config#environment-variables) esteja definida, o que substitui ambos. Para controlar o custo do modelo:360Cada agente em um fluxo de trabalho usa o modelo de sua sessão a menos que o script rotule um estágio para um diferente ou a variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/pt/model-config#environment-variables) esteja definida, o que substitui ambos. Para controlar o custo do modelo:

363 361 

364* Verifique `/model` antes de uma execução grande se você geralmente muda para um modelo menor para trabalho de rotina362* Verifique `/model` antes de uma execução grande se você geralmente muda para um modelo menor para trabalho de rotina

365* Peça a Claude para usar um modelo menor para estágios que não precisam do mais forte quando você descreve a tarefa363* Peça a Claude para usar um modelo menor para estágios que não precisam do mais forte quando você descreve a tarefa


385 Desativar fluxos de trabalho383 Desativar fluxos de trabalho

386</h3>384</h3>

387 385 

388Fluxos de trabalho estão disponíveis na CLI, no aplicativo Desktop, nas extensões IDE, [modo não interativo](/pt/headless) com `claude -p`, e no [Agent SDK](/pt/agent-sdk/overview). As mesmas configurações de desativação se aplicam em cada superfície.386Fluxos de trabalho estão disponíveis na CLI, no aplicativo Desktop, nas extensões IDE, [modo não interativo](/docs/pt/headless) com `claude -p`, e no [Agent SDK](/docs/pt/agent-sdk/overview). As mesmas configurações de desativação se aplicam em cada superfície.

389 387 

390Para desativar fluxos de trabalho para você:388Para desativar fluxos de trabalho para você:

391 389 


393* Defina `"disableWorkflows": true` em `~/.claude/settings.json`. Persiste entre sessões.391* Defina `"disableWorkflows": true` em `~/.claude/settings.json`. Persiste entre sessões.

394* Defina `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Lido na inicialização, então se aplica onde quer que você o defina.392* Defina `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Lido na inicialização, então se aplica onde quer que você o defina.

395 393 

396Para desativar fluxos de trabalho para toda a sua organização, defina `"disableWorkflows": true` em [configurações gerenciadas](/pt/server-managed-settings), ou use o alternador na página [configurações de administrador de Claude Code](https://claude.ai/admin-settings/claude-code).394Para desativar fluxos de trabalho para toda a sua organização, defina `"disableWorkflows": true` em [configurações gerenciadas](/docs/pt/server-managed-settings), ou use o alternador na página [configurações de administrador de Claude Code](https://claude.ai/admin-settings/claude-code).

397 395 

398Quando fluxos de trabalho estão desativados, os comandos de fluxo de trabalho agrupados não estão disponíveis, a palavra-chave `ultracode` não dispara mais uma execução, e `ultracode` é removido do menu `/effort`.396Quando fluxos de trabalho estão desativados, os comandos de fluxo de trabalho agrupados não estão disponíveis, a palavra-chave `ultracode` não dispara mais uma execução, e `ultracode` é removido do menu `/effort`.

399 397 


401 Recursos relacionados399 Recursos relacionados

402</h2>400</h2>

403 401 

404* [Executar agentes em paralelo](/pt/agents): comparar subagentos, visualização de agente, equipes de agentes e fluxos de trabalho402* [Executar agentes em paralelo](/docs/pt/agents): comparar subagentos, visualização de agente, equipes de agentes e fluxos de trabalho

405* [Criar subagentos personalizados](/pt/sub-agents): a primitiva de worker que fluxos de trabalho orquestram403* [Criar subagentos personalizados](/docs/pt/sub-agents): a primitiva de worker que fluxos de trabalho orquestram

406* [Gerenciar custos](/pt/costs): como execuções multi-agente contam para limites de uso404* [Gerenciar custos](/docs/pt/costs): como execuções multi-agente contam para limites de uso

worktrees.md +21 −21

Details

8 8 

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 você possa ter Claude construindo um recurso em um terminal enquanto corrige um bug em um segundo.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 você possa ter Claude construindo um recurso em um terminal enquanto corrige um bug em um segundo.

10 10 

11Esta página aborda isolamento de worktree na CLI. Tudo abaixo assume um repositório git. Para outros sistemas de controle de versão, consulte [Controle de versão não-git](#non-git-version-control). O [aplicativo desktop](/pt/desktop#work-in-parallel-with-sessions) cria uma worktree para cada nova sessão automaticamente.11Esta página aborda isolamento de worktree na CLI. Tudo abaixo assume um repositório git. Para outros sistemas de controle de versão, consulte [Controle de versão não-git](#non-git-version-control). O [aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions) cria uma worktree para cada nova sessão automaticamente.

12 12 

13Worktrees são uma das várias maneiras de executar Claude em paralelo. Elas isolam edições de arquivo, enquanto [subagentes](/pt/sub-agents) e [equipes de agentes](/pt/agent-teams) coordenam o trabalho em si. Consulte [Executar agentes em paralelo](/pt/agents) para comparar as abordagens, ou pule para [Isolar subagentes com worktrees](#isolate-subagents-with-worktrees) para usar worktrees e subagentes juntos.13Worktrees são uma das várias maneiras de executar Claude em paralelo. Elas isolam edições de arquivo, enquanto [subagentes](/docs/pt/sub-agents) e [equipes de agentes](/docs/pt/agent-teams) coordenam o trabalho em si. 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.

14 14 

15<h2 id="start-claude-in-a-worktree">15<h2 id="start-claude-in-a-worktree">

16 Inicie Claude em uma worktree16 Inicie Claude em uma worktree


34claude --worktree34claude --worktree

35```35```

36 36 

37Você também pode pedir ao Claude para "trabalhar em uma worktree" durante uma sessão, e ele criará uma com a ferramenta [`EnterWorktree`](/pt/tools-reference). Uma vez em uma worktree, Claude pode alternar diretamente para outra em `.claude/worktrees/` chamando `EnterWorktree` com o caminho de destino. A worktree anterior permanece no disco intacta.37Você também pode pedir ao Claude para "trabalhar em uma worktree" durante uma sessão, e ele criará uma com a ferramenta [`EnterWorktree`](/docs/pt/tools-reference). Uma vez em uma worktree, Claude pode alternar diretamente para outra em `.claude/worktrees/` chamando `EnterWorktree` com o caminho de destino. A worktree anterior permanece no disco intacta.

38 38 

39Entrar em um caminho fora do diretório `.claude/worktrees/` do repositório solicita sua aprovação primeiro, porque move o diretório de trabalho da sessão, acesso de escrita e configuração do projeto, como `CLAUDE.md` e configurações para esse local. Uma regra de permissão [`EnterWorktree`](/pt/permissions) ou escolher "não perguntar novamente" não suprime este prompt; apenas o modo `bypassPermissions` o ignora. Antes da v2.1.206, Claude podia entrar em qualquer caminho de worktree existente sem perguntar.39Entrar em um caminho fora do diretório `.claude/worktrees/` do repositório solicita sua aprovação primeiro, porque move o diretório de trabalho da sessão, acesso de escrita e configuração do projeto, como `CLAUDE.md` e configurações para esse local. Uma regra de permissão [`EnterWorktree`](/docs/pt/permissions) ou escolher "não perguntar novamente" não suprime este prompt; apenas o modo `bypassPermissions` o ignora. Antes da v2.1.206, Claude podia entrar em qualquer caminho de worktree existente sem perguntar.

40 40 

41{/* min-version: 2.1.198 */}A partir da v2.1.198, entrar ou sair de uma worktree também realoca a transcrição da sessão para o armazenamento de projeto desse diretório, da mesma forma que [`/cd`](/pt/commands) faz, então `/desktop` e `--resume` encontram a sessão lá depois. Worktrees criadas por um hook [`WorktreeCreate`](#non-git-version-control) são excluídas e mantêm a transcrição no diretório de inicialização.41A partir da v2.1.198, entrar ou sair de uma worktree também realoca a transcrição da sessão para o armazenamento de projeto desse diretório, da mesma forma que [`/cd`](/docs/pt/commands) faz, então `/desktop` e `--resume` encontram a sessão lá depois. Worktrees criadas por um hook [`WorktreeCreate`](#non-git-version-control) são excluídas e mantêm a transcrição no diretório de inicialização.

42 42 

43Worktrees funcionam com [sandboxing](/pt/sandboxing#filesystem-isolation) ativado: a sandbox permite escritas no diretório compartilhado `.git` do repositório principal para que comandos como `git commit` possam atualizar refs e o índice de dentro de uma worktree vinculada.43Worktrees funcionam com [sandboxing](/docs/pt/sandboxing#filesystem-isolation) ativado: a sandbox permite escritas no diretório compartilhado `.git` do repositório principal para que comandos como `git commit` possam atualizar refs e o índice de dentro de uma worktree vinculada.

44 44 

45Antes de usar `--worktree` interativamente em um diretório pela primeira vez, aceite o diálogo de confiança do workspace executando `claude` uma vez nesse diretório. Se a confiança ainda não foi aceita, `--worktree` sai com um erro e solicita que você execute `claude` no diretório primeiro. Execuções não interativas com `-p` pulam a [verificação de confiança](/pt/security), então `claude -p --worktree` prossegue sem ela.45Antes de usar `--worktree` interativamente em um diretório pela primeira vez, aceite o diálogo de confiança do workspace executando `claude` uma vez nesse diretório. Se a confiança ainda não foi aceita, `--worktree` sai com um erro e solicita que você execute `claude` no diretório primeiro. Execuções não interativas com `-p` pulam a [verificação de confiança](/docs/pt/security), então `claude -p --worktree` prossegue sem ela.

46 46 

47{/* min-version: 2.1.205 */}Se Claude Code não conseguir entrar no diretório da worktree na inicialização, por exemplo porque um hook [`WorktreeCreate`](/pt/hooks#worktreecreate) imprimiu algo diferente do diretório que criou, ou porque o diretório foi deletado após ser configurado, Claude Code imprime um erro nomeando o caminho e sai com código 1. Antes da v2.1.205, isso causava crash na sessão, e com `-p` travava por cerca de 30 segundos antes de sair com código 0.47Se Claude Code não conseguir entrar no diretório da worktree na inicialização, por exemplo porque um hook [`WorktreeCreate`](/docs/pt/hooks#worktreecreate) imprimiu algo diferente do diretório que criou, ou porque o diretório foi deletado após ser configurado, Claude Code imprime um erro nomeando o caminho e sai com código 1. Antes da v2.1.205, isso causava crash na sessão, e com `-p` travava por cerca de 30 segundos antes de sair com código 0.

48 48 

49{/* min-version: 2.1.200 */}Plugins instalados no [escopo do projeto](/pt/plugins-reference#plugin-installation-scopes) do checkout principal também carregam em worktrees do mesmo repositório, então você não precisa reinstalá-los por worktree. Isso se aplica se você criar a worktree com `--worktree` ou com `git worktree add`. Requer Claude Code v2.1.200 ou posterior.49Plugins instalados no [escopo do projeto](/docs/pt/plugins-reference#plugin-installation-scopes) do checkout principal também carregam em worktrees do mesmo repositório, então você não precisa reinstalá-los por worktree. Isso se aplica se você criar a worktree com `--worktree` ou com `git worktree add`. Requer Claude Code v2.1.200 ou posterior.

50 50 

51<Tip>51<Tip>

52 Adicione `.claude/worktrees/` ao seu `.gitignore` para que o conteúdo da worktree não apareça como arquivos não rastreados no seu checkout principal.52 Adicione `.claude/worktrees/` ao seu `.gitignore` para que o conteúdo da worktree não apareça como arquivos não rastreados no seu checkout principal.


60 60 

61A atualização requer Claude Code v2.1.208 ou posterior; antes disso, uma worktree nova usava qualquer `origin/HEAD` que já estivesse armazenado em cache localmente.61A atualização requer Claude Code v2.1.208 ou posterior; antes disso, uma worktree nova usava qualquer `origin/HEAD` que já estivesse armazenado em cache localmente.

62 62 

63Para sempre fazer branch a partir do `HEAD` local, defina `worktree.baseRef` como `"head"` em [configurações](/pt/settings#worktree-settings). Definir `baseRef` como `"head"` faz com que novas worktrees carreguem seus commits não enviados e estado de branch de recurso, o que é útil ao isolar subagentes que precisam operar em trabalho em andamento. Quando a sessão é executada dentro de uma worktree vinculada, `"head"` resolve para o `HEAD` dessa worktree, não para o checkout principal. A configuração aceita apenas `"fresh"` ou `"head"`, não refs git arbitrárias:63Para sempre fazer branch a partir do `HEAD` local, defina `worktree.baseRef` como `"head"` em [configurações](/docs/pt/settings#worktree-settings). Definir `baseRef` como `"head"` faz com que novas worktrees carreguem seus commits não enviados e estado de branch de recurso, o que é útil ao isolar subagentes que precisam operar em trabalho em andamento. Quando a sessão é executada dentro de uma worktree vinculada, `"head"` resolve para o `HEAD` dessa worktree, não para o checkout principal. A configuração aceita apenas `"fresh"` ou `"head"`, não refs git arbitrárias:

64 64 

65```json theme={null}65```json theme={null}

66{66{


76claude --worktree "#1234"76claude --worktree "#1234"

77```77```

78 78 

79Para controle total sobre como as worktrees são criadas, configure um hook [`WorktreeCreate`](/pt/hooks#worktreecreate), que substitui completamente a lógica padrão de `git worktree`.79Para controle total sobre como as worktrees são criadas, configure um hook [`WorktreeCreate`](/docs/pt/hooks#worktreecreate), que substitui completamente a lógica padrão de `git worktree`.

80 80 

81<h3 id="reuse-a-worktree-name">81<h3 id="reuse-a-worktree-name">

82 Reutilize um nome de worktree82 Reutilize um nome de worktree


108config/secrets.json108config/secrets.json

109```109```

110 110 

111Isso se aplica a worktrees criadas com `--worktree`, [worktrees de subagentes](#isolate-subagents-with-worktrees), e sessões paralelas no [aplicativo desktop](/pt/desktop#work-in-parallel-with-sessions).111Isso se aplica a worktrees criadas com `--worktree`, [worktrees de subagentes](#isolate-subagents-with-worktrees), e sessões paralelas no [aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions).

112 112 

113<h2 id="isolate-subagents-with-worktrees">113<h2 id="isolate-subagents-with-worktrees">

114 Isole subagentes com worktrees114 Isole subagentes com worktrees

115</h2>115</h2>

116 116 

117Subagentes podem executar em suas próprias worktrees para que edições paralelas não entrem em conflito. Peça ao Claude para "usar worktrees para seus agentes", ou defina permanentemente em um [subagente personalizado](/pt/sub-agents#supported-frontmatter-fields) adicionando `isolation: worktree` ao frontmatter. Cada subagente obtém uma worktree temporária que é removida automaticamente quando o subagente termina sem alterações.117Subagentes podem executar em suas próprias worktrees para que edições paralelas não entrem em conflito. Peça ao Claude para "usar worktrees para seus agentes", ou defina permanentemente em um [subagente personalizado](/docs/pt/sub-agents#supported-frontmatter-fields) adicionando `isolation: worktree` ao frontmatter. Cada subagente obtém uma worktree temporária que é removida automaticamente quando o subagente termina sem alterações.

118 118 

119As worktrees de subagentes usam a mesma [branch base](#choose-the-base-branch) que `--worktree`, portanto elas fazem branch da branch padrão do seu repositório, a menos que `worktree.baseRef` seja definido como `"head"`.119As worktrees de subagentes usam a mesma [branch base](#choose-the-base-branch) que `--worktree`, portanto elas fazem branch da branch padrão do seu repositório, a menos que `worktree.baseRef` seja definido como `"head"`.

120 120 


124 124 

125Quando você sai de uma sessão de worktree, a limpeza depende se você fez alterações:125Quando você sai de uma sessão de worktree, a limpeza depende se você fez alterações:

126 126 

127* **Sem alterações não confirmadas, sem arquivos não rastreados e sem novos commits**: a worktree e seu branch são removidos automaticamente. Se a sessão tiver um [nome](/pt/sessions#name-your-sessions), Claude solicita em vez disso para que você possa manter a worktree para depois127* **Sem alterações não confirmadas, sem arquivos não rastreados e sem novos commits**: a worktree e seu branch são removidos automaticamente. Se a sessão tiver um [nome](/docs/pt/sessions#name-your-sessions), Claude solicita em vez disso para que você possa manter a worktree para depois

128* **Alterações não confirmadas, arquivos não rastreados ou novos commits existem**: Claude solicita que você mantenha ou remova a worktree. Manter preserva o diretório e branch para que você possa retornar mais tarde. Remover exclui o diretório da worktree e seu branch, descartando todas as alterações não confirmadas, arquivos não rastreados e commits128* **Alterações não confirmadas, arquivos não rastreados ou novos commits existem**: Claude solicita que você mantenha ou remova a worktree. Manter preserva o diretório e branch para que você possa retornar mais tarde. Remover exclui o diretório da worktree e seu branch, descartando todas as alterações não confirmadas, arquivos não rastreados e commits

129* **Execuções não interativas**: worktrees criadas com `--worktree` junto com `-p` não são limpas automaticamente, pois não há prompt de saída. Remova-as com `git worktree remove`129* **Execuções não interativas**: worktrees criadas com `--worktree` junto com `-p` não são limpas automaticamente, pois não há prompt de saída. Remova-as com `git worktree remove`

130 130 

131Worktrees que Claude criou para subagentes e [sessões em segundo plano](/pt/agent-view#how-file-edits-are-isolated) são removidas automaticamente uma vez que são mais antigas que sua configuração [`cleanupPeriodDays`](/pt/settings#available-settings), desde que não tenham alterações não confirmadas, nenhum arquivo não rastreado e nenhum commit não enviado. Worktrees que você cria com `--worktree` nunca são removidas por esta varredura.131Worktrees que Claude criou para subagentes e [sessões em segundo plano](/docs/pt/agent-view#how-file-edits-are-isolated) são removidas automaticamente uma vez que são mais antigas que sua configuração [`cleanupPeriodDays`](/docs/pt/settings#available-settings), desde que não tenham alterações não confirmadas, nenhum arquivo não rastreado e nenhum commit não enviado. Worktrees que você cria com `--worktree` nunca são removidas por esta varredura.

132 132 

133Enquanto um agente está em execução, Claude executa `git worktree lock` em sua worktree para que a limpeza simultânea não possa removê-la. O bloqueio é liberado quando o agente termina. Para limpar uma worktree que a varredura mantém, execute `git worktree remove`, adicionando `--force` se a worktree tiver alterações não confirmadas ou arquivos não rastreados.133Enquanto um agente está em execução, Claude executa `git worktree lock` em sua worktree para que a limpeza simultânea não possa removê-la. O bloqueio é liberado quando o agente termina. Para limpar uma worktree que a varredura mantém, execute `git worktree remove`, adicionando `--force` se a worktree tiver alterações não confirmadas ou arquivos não rastreados.

134 134 


176 Controle de versão não-git176 Controle de versão não-git

177</h2>177</h2>

178 178 

179Isolamento de worktrees usa git por padrão. Para SVN, Perforce, Mercurial, ou outros sistemas, configure os hooks [`WorktreeCreate` e `WorktreeRemove`](/pt/hooks#worktreecreate) para fornecer lógica de criação e limpeza personalizada. Como o hook substitui o comportamento padrão do git, [`.worktreeinclude`](#copy-gitignored-files-into-worktrees) não é processado quando você usa `--worktree`. Copie quaisquer arquivos de configuração local dentro do seu script de hook.179Isolamento de worktrees usa git por padrão. Para SVN, Perforce, Mercurial, ou outros sistemas, configure os hooks [`WorktreeCreate` e `WorktreeRemove`](/docs/pt/hooks#worktreecreate) para fornecer lógica de criação e limpeza personalizada. Como o hook substitui o comportamento padrão do git, [`.worktreeinclude`](#copy-gitignored-files-into-worktrees) não é processado quando você usa `--worktree`. Copie quaisquer arquivos de configuração local dentro do seu script de hook.

180 180 

181Este hook `WorktreeCreate` lê o nome da worktree de stdin, faz checkout de uma cópia de trabalho SVN fresca, e imprime o caminho do diretório para que Claude Code possa usá-lo como o diretório de trabalho da sessão:181Este hook `WorktreeCreate` lê o nome da worktree de stdin, faz checkout de uma cópia de trabalho SVN fresca, e imprime o caminho do diretório para que Claude Code possa usá-lo como o diretório de trabalho da sessão:

182 182 


197}197}

198```198```

199 199 

200Emparelhe-o com um hook `WorktreeRemove` para limpar quando a sessão terminar. Consulte a [referência de hooks](/pt/hooks#worktreecreate) para o esquema de entrada e um exemplo de remoção.200Emparelhe-o com um hook `WorktreeRemove` para limpar quando a sessão terminar. Consulte a [referência de hooks](/docs/pt/hooks#worktreecreate) para o esquema de entrada e um exemplo de remoção.

201 201 

202<h2 id="see-also">202<h2 id="see-also">

203 Veja também203 Veja também


205 205 

206Worktrees lidam com isolamento de arquivo. As páginas relacionadas abaixo cobrem delegação de trabalho para esses checkouts isolados e alternância entre as sessões que você cria:206Worktrees lidam com isolamento de arquivo. As páginas relacionadas abaixo cobrem delegação de trabalho para esses checkouts isolados e alternância entre as sessões que você cria:

207 207 

208* [Subagentes](/pt/sub-agents): delegue trabalho para agentes isolados dentro de uma sessão208* [Subagentes](/docs/pt/sub-agents): delegue trabalho para agentes isolados dentro de uma sessão

209* [Equipes de agentes](/pt/agent-teams): coordene múltiplas sessões do Claude automaticamente209* [Equipes de agentes](/docs/pt/agent-teams): coordene múltiplas sessões do Claude automaticamente

210* [Gerencie sessões](/pt/sessions): nomeie, retome e alterne entre conversas210* [Gerencie sessões](/docs/pt/sessions): nomeie, retome e alterne entre conversas

211* [Sessões paralelas do desktop](/pt/desktop#work-in-parallel-with-sessions): sessões apoiadas por worktree no aplicativo desktop211* [Sessões paralelas do desktop](/docs/pt/desktop#work-in-parallel-with-sessions): sessões apoiadas por worktree no aplicativo desktop