Documentation — Spybara

admin-setup.md +1 −1

Details

167 167

168* [Quickstart](/docs/pt/quickstart): passo a passo da primeira sessão da instalação ao trabalho com um projeto168* [Quickstart](/docs/pt/quickstart): passo a passo da primeira sessão da instalação ao trabalho com um projeto

169* [Common workflows](/docs/pt/common-workflows): padrões para tarefas cotidianas como revisão de código, refatoração e depuração169* [Common workflows](/docs/pt/common-workflows): padrões para tarefas cotidianas como revisão de código, refatoração e depuração

170* [Claude 101](https://anthropic.skilljar.com/claude-101) e [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action): cursos de ritmo próprio da Anthropic Academy170* [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action): cursos de ritmo próprio gratuitos em [Claude Academy](https://academy.claude.com/)

171 171

172Para problemas de login, direcione os desenvolvedores para [solução de problemas de autenticação](/docs/pt/troubleshoot-install#login-and-authentication). As correções mais comuns são:172Para problemas de login, direcione os desenvolvedores para [solução de problemas de autenticação](/docs/pt/troubleshoot-install#login-and-authentication). As correções mais comuns são:

173 173

advisor.md +10 −8

Details

56* Execute `/advisor` com um modelo, como `/advisor opus`, para defini-lo.56* Execute `/advisor` com um modelo, como `/advisor opus`, para defini-lo.

57* Execute `/advisor off` para desativá-lo.57* Execute `/advisor off` para desativá-lo.

58 58

59Claude Code não invoca um advisor salvo que a allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização exclua. Para usar o advisor, escolha um modelo permitido com `/advisor`. Claude Code ainda salva um advisor que seu modelo principal atual não suporta. Esse advisor é ativado após você mudar para um [modelo principal compatível](#choose-an-advisor-model) com [`/model`](/docs/pt/model-config#setting-your-model).59Claude Code não invoca um advisor salvo que a allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização exclua. Para usar o advisor, escolha um modelo permitido com `/advisor`.

61Claude Code ainda salva um advisor que seu modelo principal atual não suporta. Esse advisor é ativado após você mudar para um [modelo principal compatível](#choose-an-advisor-model) com [`/model`](/docs/pt/model-config#setting-your-model). Se a API já recusou o advisor salvo na conversa atual, ele permanece desativado até `/clear` ou `/compact`, mesmo após você mudar de modelos.

60 62

61Em alguns planos, Fable como advisor também precisa de seu [consentimento único para cobrar o uso de Fable aos créditos de uso](/docs/pt/model-config#fable-and-usage-credits). Para saber o que `/advisor fable` faz antes de você ter dado esse consentimento, veja [Advisor Fable e créditos de uso](#fable-advisor-and-usage-credits).63Em alguns planos, Fable como advisor também precisa de seu [consentimento único para cobrar o uso de Fable aos créditos de uso](/docs/pt/model-config#fable-and-usage-credits). Para saber o que `/advisor fable` faz antes de você ter dado esse consentimento, veja [Advisor Fable e créditos de uso](#fable-advisor-and-usage-credits).

62 64

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

99 101

101| -------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |103| -------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------- |

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

110 112

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

112 114

113Defina o advisor como `fable`, `opus`, ou `sonnet`. Esses aliases resolvem para a versão padrão integrada do Claude Code para cada família de modelos, que avança com novos lançamentos do Claude Code. Você também pode passar um ID de modelo completo como `claude-opus-5`.115Defina o advisor como `fable`, `opus`, ou `sonnet`. Esses aliases resolvem para a versão padrão integrada do Claude Code para cada família de modelos, que avança com novos lançamentos do Claude Code. Você também pode passar um ID de modelo completo como `claude-opus-5-5`.

114 116

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

116 118

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

118 120

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

120* Para um advisor que a tabela lista como falhando com um erro de API, Claude Code o anexa e a API o recusa. Cada solicitação falha com `'<advisor model>' cannot be used as an advisor when the request model is '<main model>'` até que você altere o advisor com `/advisor` ou o desative.122* Para um advisor que a tabela lista como recusado pela API, Claude Code o anexa e a API o recusa. Claude Code então reenvia essa solicitação sem o advisor, e o resto da conversa é executado sem um, então você não vê nenhum erro e não obtém nenhuma chamada de advisor. Escolha um advisor aceito com `/advisor`; a mudança entra em vigor após `/clear` ou `/compact` e em novas sessões.

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

122 124

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

195 197

196A ferramenta advisor requer todos os seguintes:198A ferramenta advisor requer todos os seguintes:

197 199

198* **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.200* **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. Se o gateway ou seu upstream não reconhecer a ferramenta advisor, consulte [Retry automático e encaminhamento de erro](/docs/pt/llm-gateway-protocol#automatic-retry-and-error-forwarding) para saber como Claude Code responde.

199* **Modelo principal suportado**: Fable, Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou Haiku 4.5. Consulte [Escolher um modelo advisor](#choose-an-advisor-model) para saber quais advisors cada um aceita.201* **Modelo principal suportado**: Fable, Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou Haiku 4.5. Consulte [Escolher um modelo advisor](#choose-an-advisor-model) para saber quais advisors cada um aceita.

200* **Busca de feature-flag**: Claude Code ativa o advisor através de um feature flag que busca da Anthropic. Em uma sessão onde uma variável que desativa a busca de flag está definida, como `DISABLE_TELEMETRY`, o advisor permanece desativado. Consulte [Recursos que precisam de busca de feature-flag](/docs/pt/env-vars#features-that-need-feature-flag-fetching).202* **Busca de feature-flag**: Claude Code ativa o advisor através de um feature flag que busca da Anthropic. Em uma sessão onde uma variável que desativa a busca de flag está definida, como `DISABLE_TELEMETRY`, o advisor permanece desativado. Consulte [Recursos que precisam de busca de feature-flag](/docs/pt/env-vars#features-that-need-feature-flag-fetching).

201 203

agent-sdk/configuration.md +3 −1

Details

189TypeScript também tem `applyFlagSettings()` e `updateSettings()`:189TypeScript também tem `applyFlagSettings()` e `updateSettings()`:

190 190

191* **`applyFlagSettings()`**: aplica configurações em tempo de execução, como em `await session.applyFlagSettings({ effortLevel: "high" })`. O método aceita chaves de arquivo de configuração em vez de campos de opções, portanto verifique a referência [`applyFlagSettings()`](/docs/pt/agent-sdk/typescript#applyflagsettings) para o esquema e para quais chaves têm efeito no meio da sessão.191* **`applyFlagSettings()`**: aplica configurações em tempo de execução, como em `await session.applyFlagSettings({ effortLevel: "high" })`. O método aceita chaves de arquivo de configuração em vez de campos de opções, portanto verifique a referência [`applyFlagSettings()`](/docs/pt/agent-sdk/typescript#applyflagsettings) para o esquema e para quais chaves têm efeito no meio da sessão.

192* **`updateSettings()`**: escreve um conjunto de chaves na lista de permissões para o arquivo de configuração local do projeto, como em `await session.updateSettings("localSettings", { outputStyle: "Explanatory" })`. As chaves escritas têm efeito na próxima solicitação da sessão e persistem para sessões posteriores que carregam configurações `local`. A linha do método na [tabela de métodos](/docs/pt/agent-sdk/typescript#methods) nomeia as chaves na lista de permissões e o piso de versão.192* **`updateSettings()`**: escreve uma chave na lista de permissões para um arquivo de configuração. A referência [`updateSettings()`](/docs/pt/agent-sdk/typescript#updatesettings) nomeia a chave que cada fonte aceita e o piso de versão.

193 * Passe `"localSettings"` para escrever o arquivo de configurações locais do projeto, como em `await session.updateSettings("localSettings", { outputStyle: "Explanatory" })`. A chave escrita tem efeito na próxima solicitação da sessão e persiste para sessões posteriores que carregam configurações `local`.

194 * Passe `"userSettings"` para escrever `effortLevel`, a única chave que a fonte aceita. Claude Code a salva como o nível de esforço padrão para o modelo atual da sessão, e o esforço da sessão em execução não muda.

193 195

194O exemplo abaixo executa uma sessão de dois turnos, altera a configuração entre os turnos e imprime o modelo que respondeu cada turno. Em TypeScript, o fluxo de prompt mantém a segunda mensagem até que os setters tenham sido executados, e o segundo turno é executado no novo modelo.196O exemplo abaixo executa uma sessão de dois turnos, altera a configuração entre os turnos e imprime o modelo que respondeu cada turno. Em TypeScript, o fluxo de prompt mantém a segunda mensagem até que os setters tenham sido executados, e o segundo turno é executado no novo modelo.

195 197

agent-sdk/cost-tracking.md +19 −9

Details

37 37

38* **Chamada `query()`:** uma invocação da função `query()` do SDK. Uma única chamada pode envolver múltiplas etapas: Claude responde, usa ferramentas, obtém resultados e responde novamente. Cada chamada produz uma mensagem [`result`](/docs/pt/agent-sdk/typescript#sdkresultmessage) ao final, exceto no [modo de entrada em streaming](/docs/pt/agent-sdk/streaming-vs-single-mode), onde uma chamada `query()` carrega múltiplos turnos do usuário e cada turno emite sua própria mensagem `result`.38* **Chamada `query()`:** uma invocação da função `query()` do SDK. Uma única chamada pode envolver múltiplas etapas: Claude responde, usa ferramentas, obtém resultados e responde novamente. Cada chamada produz uma mensagem [`result`](/docs/pt/agent-sdk/typescript#sdkresultmessage) ao final, exceto no [modo de entrada em streaming](/docs/pt/agent-sdk/streaming-vs-single-mode), onde uma chamada `query()` carrega múltiplos turnos do usuário e cada turno emite sua própria mensagem `result`.

39* **Etapa:** um único ciclo de solicitação/resposta dentro de uma chamada `query()`. Cada etapa produz mensagens do assistente com uso de tokens.39* **Etapa:** um único ciclo de solicitação/resposta dentro de uma chamada `query()`. Cada etapa produz mensagens do assistente com uso de tokens.

~~40* **Sessão:** uma série de chamadas `query()` vinculadas por um ID de sessão (usando a opção `resume`). Cada chamada `query()` dentro de uma sessão relata seu próprio custo independentemente.~~40* **Sessão:** uma série de chamadas `query()` vinculadas por um ID de sessão através da opção `resume`. Uma chamada retomada relata o gasto total da sessão, não apenas o da própria chamada. Veja [Acumular custos em múltiplas chamadas](#accumulate-costs-across-multiple-calls) para saber como os totais se transferem.

41 41

42O diagrama a seguir mostra o fluxo de mensagens de uma única chamada `query()`, com uso de tokens relatado em cada etapa e a estimativa cumulativa ao final:42O diagrama a seguir mostra o fluxo de mensagens de uma única chamada `query()`, com uso de tokens relatado em cada etapa e a estimativa cumulativa ao final:

43 43

51 </Step>51 </Step>

52 52

53 <Step title="A mensagem de resultado fornece a estimativa cumulativa">53 <Step title="A mensagem de resultado fornece a estimativa cumulativa">

54 Quando a chamada `query()` é concluída, o SDK emite uma mensagem de resultado com `total_cost_usd` e `usage` cumulativo, tipado como [`SDKResultMessage`](/docs/pt/agent-sdk/typescript#sdkresultmessage) em TypeScript e [`ResultMessage`](/docs/pt/agent-sdk/python#resultmessage) em Python. Se você fizer múltiplas chamadas `query()`, por exemplo em uma sessão com múltiplos turnos, cada resultado reflete apenas o custo dessa chamada individual. Se você só precisar da estimativa total, pode ignorar o uso por etapa e ler este único valor.54 Quando a chamada `query()` é concluída, o SDK emite uma mensagem de resultado com `total_cost_usd` e `usage` cumulativo, tipado como [`SDKResultMessage`](/docs/pt/agent-sdk/typescript#sdkresultmessage) em TypeScript e [`ResultMessage`](/docs/pt/agent-sdk/python#resultmessage) em Python. Se você só precisar da estimativa total, pode ignorar o uso por etapa e ler este único valor.

56 Se você fizer múltiplas chamadas `query()` independentes, cada resultado reflete apenas o custo dessa chamada individual. Uma chamada que retoma uma sessão também conta o gasto anterior da sessão.

55 57

56 No modo de entrada em streaming, cada turno emite sua própria mensagem de resultado. Veja [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode) para saber como ler totais de chamadas nesse modo.58 No modo de entrada em streaming, cada turno emite sua própria mensagem de resultado. Veja [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode) para saber como ler totais de chamadas nesse modo.

57 </Step>59 </Step>

64No [modo de entrada em streaming](/docs/pt/agent-sdk/streaming-vs-single-mode), uma chamada `query()` carrega múltiplos turnos do usuário e cada turno emite sua própria mensagem de resultado. Os campos de resultado diferem em escopo:66No [modo de entrada em streaming](/docs/pt/agent-sdk/streaming-vs-single-mode), uma chamada `query()` carrega múltiplos turnos do usuário e cada turno emite sua própria mensagem de resultado. Os campos de resultado diferem em escopo:

65 67

66* **`usage`**: cobre apenas esse turno, e dentro dele apenas o loop principal do agente, não qualquer subagenteque ele executou.68* **`usage`**: cobre apenas esse turno, e dentro dele apenas o loop principal do agente, não qualquer subagenteque ele executou.

~~67* **`total_cost_usd` e `modelUsage`, ou `model_usage` em Python**: carregam o total acumulado para toda a chamada até agora.~~69* **`total_cost_usd` e `modelUsage`, ou `model_usage` em Python**: carregam o total acumulado para toda a chamada até agora, mais qualquer gasto restaurado quando a chamada retomou uma sessão.

68 70

69Em uma chamada onde seu aplicativo nunca envia `/clear`, `/reset` ou `/new`, leia o resultado mais recente para totais de chamada em vez de somar entre resultados.71Em uma chamada onde seu aplicativo nunca envia `/clear`, `/reset` ou `/new`, leia o resultado mais recente para totais de chamada em vez de somar entre resultados.

70 72

78 80

79Em TypeScript, o SDK também emite uma [`SDKConversationResetMessage`](/docs/pt/agent-sdk/typescript#sdkconversationresetmessage) em cada redefinição, para que você possa detectar redefinições do stream. Em Python, o SDK igualmente emite uma `ConversationResetMessage`. Antes da versão 0.2.137 do SDK Python, o iterador Python descartava essa mensagem, então nessas versões conte as redefinições você mesmo a partir dos turnos `/clear` que seu aplicativo envia.81Em TypeScript, o SDK também emite uma [`SDKConversationResetMessage`](/docs/pt/agent-sdk/typescript#sdkconversationresetmessage) em cada redefinição, para que você possa detectar redefinições do stream. Em Python, o SDK igualmente emite uma `ConversationResetMessage`. Antes da versão 0.2.137 do SDK Python, o iterador Python descartava essa mensagem, então nessas versões conte as redefinições você mesmo a partir dos turnos `/clear` que seu aplicativo envia.

80 82

~~81`maxBudgetUsd` (TypeScript) ou `max_budget_usd` (Python) é comparado contra o mesmo total acumulado, então um `/clear` também inicia o orçamento novamente.~~83`maxBudgetUsd` (TypeScript) ou `max_budget_usd` (Python) conta apenas o gasto da própria chamada: totais restaurados de uma sessão retomada não contam contra ele, e um `/clear` inicia o orçamento novamente.

82 84

83<h2 id="get-the-total-cost-of-a-query">85<h2 id="get-the-total-cost-of-a-query">

84 Obter o custo total de uma consulta86 Obter o custo total de uma consulta

85</h2>87</h2>

86 88

87A mensagem de resultado, digitada como [`SDKResultMessage`](/docs/pt/agent-sdk/typescript#sdkresultmessage) em TypeScript e [`ResultMessage`](/docs/pt/agent-sdk/python#resultmessage) em Python, marca o fim do loop do agente para uma chamada `query()`. Ela inclui `total_cost_usd`, o custo estimado cumulativo em todas as etapas dessa chamada. Em Python, o campo é digitado como opcional, portanto verifique se não é `None` antes de lê-lo. Os resultados de sucesso e erro carregam ambos, embora o resultado final de um [travamento de sessão](#recover-totals-after-a-session-crash) possa carregá-lo zerado.89A mensagem de resultado, digitada como [`SDKResultMessage`](/docs/pt/agent-sdk/typescript#sdkresultmessage) em TypeScript e [`ResultMessage`](/docs/pt/agent-sdk/python#resultmessage) em Python, marca o fim do loop do agente para uma chamada `query()`. Ela inclui `total_cost_usd`, o custo estimado cumulativo em todas as etapas dessa chamada. Uma chamada que retoma uma sessão também conta o gasto anterior da sessão. Duas ressalvas se aplicam quando você lê o valor:

91* Em Python, o campo é digitado como opcional, portanto verifique se não é `None` antes de lê-lo.

92* Os resultados de sucesso e erro carregam ambos, embora o resultado final de um [travamento de sessão](#recover-totals-after-a-session-crash) possa carregá-lo zerado.

88 93

89Se você usar sessões para fazer várias chamadas `query()`, cada resultado reflete apenas o custo dessa chamada individual. No modo de entrada em streaming, leia os totais de chamadas conforme descrito em [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode).94No modo de entrada em streaming, leia os totais de chamadas conforme descrito em [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode).

90 95

91Os três campos de nível de resultado diferem no que contam quando o agente gera [subagentes](/docs/pt/agent-sdk/subagents). Use `modelUsage`, ou `model_usage` em Python, para contabilidade de tokens de toda a árvore; o campo `usage` subestima assim que o aninhamento ocorre.96Os três campos de nível de resultado diferem no que contam quando o agente gera [subagentes](/docs/pt/agent-sdk/subagents). Use `modelUsage`, ou `model_usage` em Python, para contabilidade de tokens de toda a árvore; o campo `usage` subestima assim que o aninhamento ocorre.

92 97

232 Acumular custos em múltiplas chamadas237 Acumular custos em múltiplas chamadas

233</h2>238</h2>

234 239

235Cada chamada `query()` retorna seu próprio `total_cost_usd`. O SDK não fornece um total no nível da sessão, portanto, se sua aplicação fizer múltiplas chamadas `query()`, por exemplo em uma sessão multi-turno ou entre diferentes usuários, acumule os totais você mesmo. No modo de entrada em streaming, leia o total de cada chamada conforme descrito em [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode). Para uma chamada que terminou em uma falha, consulte [Recuperar totais após uma falha de sessão](#recover-totals-after-a-session-crash).240Cada chamada `query()` retorna `total_cost_usd` em seus resultados. Como você combina os valores depende se as chamadas compartilham uma sessão:

241

242* **Chamadas independentes, sem opção `resume` ou `continue`**: cada resultado cobre apenas sua própria chamada, portanto, adicione os totais você mesmo, como os exemplos abaixo fazem.

243* **Chamadas que retomam a mesma sessão**: Claude Code salva os totais da sessão em sua [transcrição](/docs/pt/sessions#where-transcripts-are-stored) quando o processo sai normalmente e os restaura quando uma chamada posterior retoma ou bifurca a sessão. Cada resultado já inclui o gasto anterior da sessão. Leia o resultado mais recente para o total da sessão; somar resultados conta duas vezes o gasto restaurado. Antes da v2.1.277, uma sessão que você retomou através do SDK ou `claude -p` iniciava seus totais em zero, portanto, cada resultado de chamada cobria apenas essa chamada.

244

245No modo de entrada em streaming, leia o total de cada chamada conforme descrito em [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode). Para uma chamada que terminou em uma falha, consulte [Recuperar totais após uma falha de sessão](#recover-totals-after-a-session-crash).

236 246

237Os exemplos a seguir executam duas chamadas `query()` sequencialmente, adicionam o `total_cost_usd` de cada chamada a um total acumulado e imprimem tanto o custo por chamada quanto o custo combinado:247Os exemplos a seguir executam duas chamadas `query()` sequencialmente, adicionam o `total_cost_usd` de cada chamada a um total acumulado e imprimem tanto o custo por chamada quanto o custo combinado:

238 248

338 348

339Quando o processo Claude Code trava, ele emite um resultado final `error_during_execution` e sai, tanto no modo de entrada única quanto no modo de entrada de transmissão. Esse resultado pode carregar `usage`, `total_cost_usd` e `modelUsage` zerados, portanto, recupere os totais da chamada a partir do que chegou antes dele. A etapa 1 recupera os totais completos sempre que existe um resultado anterior; o fallback na etapa 2 recupera apenas os tokens de entrada e cache do loop principal.349Quando o processo Claude Code trava, ele emite um resultado final `error_during_execution` e sai, tanto no modo de entrada única quanto no modo de entrada de transmissão. Esse resultado pode carregar `usage`, `total_cost_usd` e `modelUsage` zerados, portanto, recupere os totais da chamada a partir do que chegou antes dele. A etapa 1 recupera os totais completos sempre que existe um resultado anterior; o fallback na etapa 2 recupera apenas os tokens de entrada e cache do loop principal.

340 350

3411. Use o resultado da rodada antes do travamento. No modo de entrada de transmissão, ele contém o total em execução desde o início da chamada ou desde o último [`/clear`](#track-costs-in-streaming-input-mode). Vá para a etapa 2 em vez disso quando esse resultado não puder ajudá-lo:3511. Use o resultado da rodada antes do travamento. No modo de entrada de transmissão, ele contém o total em execução descrito em [Rastrear custos no modo de entrada de transmissão](#track-costs-in-streaming-input-mode). Vá para a etapa 2 em vez disso quando esse resultado não puder ajudá-lo:

342 * A chamada foi única, portanto, nenhum resultado anterior existe.352 * A chamada foi única, portanto, nenhum resultado anterior existe.

343 * O travamento aconteceu na primeira rodada.353 * O travamento aconteceu na primeira rodada.

344 * A rodada antes do travamento foi o próprio `/clear`, portanto, seu resultado cobre apenas a redefinição.354 * A rodada antes do travamento foi o `/clear` em si, portanto, seu resultado cobre apenas a redefinição.

3452. Some o `usage` nas mensagens do assistente em vez disso, contando cada resposta da API uma vez, como o exemplo [Track per-step usage](#track-per-step-usage) faz. No modo de entrada única, some todas elas; no modo de entrada de transmissão, some as que chegaram após o último resultado. Isso fornece os tokens de entrada e cache do loop principal. O uso de subagentos não é recuperável dessa forma, e nem são tokens de saída ou custo em USD, porque [o `output_tokens` por etapa é um espaço reservado](#read-output-tokens-from-the-result-message).3552. Some o `usage` nas mensagens do assistente em vez disso, contando cada resposta da API uma vez, como o exemplo [Track per-step usage](#track-per-step-usage) faz. No modo de entrada única, some todas elas; no modo de entrada de transmissão, some as que chegaram após o último resultado. Isso fornece os tokens de entrada e cache do loop principal. O uso de subagentos não é recuperável dessa forma, e nem são tokens de saída ou custo em USD, porque [o `output_tokens` por etapa é um espaço reservado](#read-output-tokens-from-the-result-message).

346 356

347<h3 id="track-cache-tokens">357<h3 id="track-cache-tokens">

agent-sdk/hosting.md +1 −1

Details

10 10

11Esta página aborda a auto-hospedagem em sua própria infraestrutura. Para Dockerfiles implantáveis e manifestos Kubernetes, consulte o [hosting cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting).11Esta página aborda a auto-hospedagem em sua própria infraestrutura. Para Dockerfiles implantáveis e manifestos Kubernetes, consulte o [hosting cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting).

12 12

13Se você não precisar de controle de infraestrutura, isolamento personalizado ou seu próprio plano de dados, considere [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) em vez disso: uma API REST hospedada onde a Anthropic executa o agente e o sandbox, para que sua aplicação envie eventos e transmita resultados novamente sem nenhuma infraestrutura de hospedagem para operar.13Se você não precisar executar o loop do agente em sua própria infraestrutura, considere [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) em vez disso. A Anthropic hospeda o loop do agente, e sua aplicação envia eventos e recebe resultados transmitidos através dos SDKs do cliente ou da API REST. A execução de ferramentas é executada em um sandbox de nuvem gerenciado pela Anthropic ou em um [sandbox auto-hospedado](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes) em sua própria infraestrutura.

14 14

15<h2 id="the-subprocess-model">15<h2 id="the-subprocess-model">

16 O modelo de subprocess16 O modelo de subprocess

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

Details

355No SDK TypeScript, você pode passar um prompt personalizado como um array de strings em vez de uma string, com o marcador `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` entre a parte estática e o resto. Use isso quando seu prompt combina instruções que são as mesmas em cada solicitação com contexto que muda por solicitação, como o cliente ou ticket que o agente está tratando. Quando você passa ambas as partes como uma string, uma mudança na parte por solicitação muda todo o prompt do sistema, então as instruções estáticas perdem o cache também. Este formulário não está disponível no SDK Python; [`ClaudeAgentOptions`](/docs/pt/agent-sdk/python#claudeagentoptions) lista os formulários que `system_prompt` aceita.355No SDK TypeScript, você pode passar um prompt personalizado como um array de strings em vez de uma string, com o marcador `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` entre a parte estática e o resto. Use isso quando seu prompt combina instruções que são as mesmas em cada solicitação com contexto que muda por solicitação, como o cliente ou ticket que o agente está tratando. Quando você passa ambas as partes como uma string, uma mudança na parte por solicitação muda todo o prompt do sistema, então as instruções estáticas perdem o cache também. Este formulário não está disponível no SDK Python; [`ClaudeAgentOptions`](/docs/pt/agent-sdk/python#claudeagentoptions) lista os formulários que `system_prompt` aceita.

356 356

357<Note>357<Note>

358 O SDK divide o prompt apenas quando chama a API Claude diretamente ou executa em [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Em todas as outras configurações, como Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou um [LLM gateway](/docs/pt/llm-gateway-connect), e sempre que você define [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities), o SDK envia todo o prompt como um bloco, o mesmo que passar uma string.358 O SDK divide o prompt apenas quando chama a API Claude diretamente ou executa em [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Em todas as outras configurações, como Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou um [LLM gateway](/docs/pt/llm-gateway-connect), ele envia todo o prompt como um bloco, o mesmo que passar uma string. O mesmo acontece sempre que você define [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities).

359</Note>359</Note>

360 360

361Para dividir o prompt, importe `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` de `@anthropic-ai/claude-agent-sdk` e passe-o como seu próprio elemento de array entre as duas partes. O SDK envia as strings antes do marcador como um bloco de texto e as strings após ele como um segundo bloco, cada um com seu próprio ponto de quebra de cache. No exemplo abaixo, um agente de suporte carrega suas instruções de triagem de um arquivo e recebe detalhes sobre um ticket em cada solicitação, então as instruções permanecem em cache enquanto os detalhes do ticket mudam:361Para dividir o prompt, importe `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` de `@anthropic-ai/claude-agent-sdk` e passe-o como seu próprio elemento de array entre as duas partes. O SDK envia as strings antes do marcador como um bloco de texto e as strings após ele como um segundo bloco, cada um com seu próprio ponto de quebra de cache. No exemplo abaixo, um agente de suporte carrega suas instruções de triagem de um arquivo e recebe detalhes sobre um ticket em cada solicitação, então as instruções permanecem em cache enquanto os detalhes do ticket mudam:

387* Se você incluir o marcador mais de uma vez, o primeiro é a divisão e o SDK remove os outros.387* Se você incluir o marcador mais de uma vez, o primeiro é a divisão e o SDK remove os outros.

388* Se você deixar o marcador de fora, o SDK une todas as strings em um bloco, o mesmo que passar uma string.388* Se você deixar o marcador de fora, o SDK une todas as strings em um bloco, o mesmo que passar uma string.

389 389

390Com os flags [`--system-prompt` ou `--system-prompt-file`](/docs/pt/cli-reference#system-prompt-flags) da CLI, o prompt é uma string, então não há array para carregar o marcador. Inclua uma linha contendo apenas `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` entre as partes estática e por solicitação em vez disso. Claude Code divide o prompt na primeira linha assim em dois blocos e remove essa linha. Requer Claude Code v2.1.275 ou posterior.

391

392No SDK, prefira o formulário de array, que carrega o limite sem uma linha de marcador.

393

390<h3 id="change-the-prompt-of-an-existing-session">394<h3 id="change-the-prompt-of-an-existing-session">

391 Alterar o prompt de uma sessão existente395 Alterar o prompt de uma sessão existente

392</h3>396</h3>

agent-sdk/overview.md +8 −8

Details

12 Compare o Agent SDK com outras ferramentas Claude12 Compare o Agent SDK com outras ferramentas Claude

13</h2>13</h2>

14 14

~~15O Agent SDK, a CLI, o Client SDK e Managed Agents atendem a diferentes necessidades. Use a tabela para encontrar aquele que corresponde ao que você está construindo.~~15O Agent SDK, a CLI, o Client SDK e Managed Agents diferem em quem executa o agente, o que vem integrado e como você o acessa. Encontre a linha que corresponde a como você deseja construir e executar o seu.

16 16

17| Se você está... | Use | Por quê |17| Você quer | Use | O que você obtém |

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

19| Construindo um agente sem implementar o loop de ferramentas você mesmo | **Agent SDK** | Uma biblioteca Python ou TypeScript que executa o loop do agente para você. |19| Incorporar o agente Claude Code em sua própria aplicação Python ou TypeScript, em um processo que você opera | **Agent SDK** | Uma biblioteca que executa o binário Claude Code, com as [capacidades](#capabilities) do Claude Code, como ferramentas integradas, permissões, sessões e hooks. |

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

21| Chamando a API diretamente e implementando o loop de ferramentas você mesmo | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Acesso direto à API Anthropic em vez de Claude Code. Você implementa o loop de ferramentas você mesmo. |21| Chamar a API Claude diretamente do seu próprio código | [**Client SDK**](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) | Acesso direto à API Claude de qualquer uma das linguagens do Client SDK. Você escreve o loop de ferramentas você mesmo, ou deixa o [tool runner](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner) beta do Client SDK conduzi-lo. |

22| Executando agentes de longa duração ou assíncronos sem gerenciar sua própria infraestrutura de sandbox ou sessão | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | API REST hospedada, um produto separado do Agent SDK. Anthropic executa o agente e o sandbox. |22| Ter a Anthropic hospedando o agente, configurado através da API Claude | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | Um agente hospedado que executa o loop do agente, com sessões em um sandbox gerenciado pela Anthropic ou um [sandbox auto-hospedado](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes) em sua própria infraestrutura. Use-o a partir do [SDK para sua linguagem](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-sdk), da CLI `ant` ou da API REST. |

23 23

24O SDK está disponível como uma biblioteca apenas para Python e TypeScript. Para conduzir o mesmo loop de agente de outro idioma, [execute a CLI como um subprocesso](/docs/pt/headless) com a flag `-p` e `--output-format json`.24Para conduzir o mesmo loop de agente de uma linguagem diferente de Python ou TypeScript, [execute a CLI como um subprocesso](/docs/pt/headless) com a flag `-p` e `--output-format json`.

25 25

26<h2 id="capabilities">26<h2 id="capabilities">

27 Capacidades27 Capacidades

agent-sdk/python.md +12 −30

Details

1487Use com o campo `betas` em `ClaudeAgentOptions` para ativar recursos beta.1487Use com o campo `betas` em `ClaudeAgentOptions` para ativar recursos beta.

1488 1488

1489<Warning>1489<Warning>

1490 O beta `context-1m-2025-08-07` foi descontinuado a partir de 30 de abril de 2026. Passar este header com Claude Sonnet 4.5 ou Sonnet 4 não tem efeito, e requisições que excedem a janela de contexto padrão de 200k-token retornam um erro. Para usar uma janela de contexto de 1M-token, migre para [Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7, ou Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), que incluem contexto de 1M a preços padrão sem header beta necessário.1490 O beta `context-1m-2025-08-07` foi descontinuado a partir de 30 de abril de 2026. Passar este header com Claude Sonnet 4.5 ou Sonnet 4 não tem efeito, e requisições que excedem a janela de contexto padrão de 200k-token retornam um erro. Para usar uma janela de contexto de 1M-token, migre para [Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7, ou Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), que incluem contexto de 1M a preços padrão sem header beta necessário.

1491</Warning>1491</Warning>

1492 1492

1493<h3 id="mcpsdkserverconfig">1493<h3 id="mcpsdkserverconfig">

1799 1799

1800O dict `model_usage` mapeia nomes de modelo para uso por modelo. Ele cobre cada chamada de modelo feita através do pipeline de consulta: o loop principal, subagentes e chamadas internas como compactação e agentes Workflow. Chamadas auxiliares fora desse pipeline, como o classificador de permissão e solicitações de contagem de tokens, são excluídas de `model_usage`. Trate `model_usage` como uma estimativa, não como um extrato de faturamento.1800O dict `model_usage` mapeia nomes de modelo para uso por modelo. Ele cobre cada chamada de modelo feita através do pipeline de consulta: o loop principal, subagentes e chamadas internas como compactação e agentes Workflow. Chamadas auxiliares fora desse pipeline, como o classificador de permissão e solicitações de contagem de tokens, são excluídas de `model_usage`. Trate `model_usage` como uma estimativa, não como um extrato de faturamento.

1801 1801

1802Em [modo de entrada de streaming](/docs/pt/agent-sdk/streaming-vs-single-mode), `model_usage` e `total_cost_usd` são cumulativos entre turnos, então leia o resultado mais recente em vez de somar entre resultados. Veja [Rastrear custos em modo de entrada de streaming](/docs/pt/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) para redefinições e [Recuperar totais após uma falha de sessão](/docs/pt/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) para resultados zerados.1802Em [modo de entrada de streaming](/docs/pt/agent-sdk/streaming-vs-single-mode), `model_usage` e `total_cost_usd` são cumulativos entre turnos, então leia o resultado mais recente em vez de somar entre resultados. Uma chamada que retoma uma sessão também conta os [totais restaurados das chamadas anteriores da sessão](/docs/pt/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Veja [Rastrear custos em modo de entrada de streaming](/docs/pt/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) para redefinições e [Recuperar totais após uma falha de sessão](/docs/pt/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) para resultados zerados.

1803 1803

1804Cada valor em `model_usage` é um TypedDict `ModelUsage`, importado via `from claude_agent_sdk.types import ModelUsage`. Suas chaves usam camelCase porque o SDK passa o valor através sem modificação do processo CLI subjacente, correspondendo ao tipo TypeScript [`ModelUsage`](/docs/pt/agent-sdk/typescript#modelusage):1804Cada valor em `model_usage` é um TypedDict `ModelUsage`, importado via `from claude_agent_sdk.types import ModelUsage`. Suas chaves usam camelCase porque o SDK passa o valor através sem modificação do processo CLI subjacente, correspondendo ao tipo TypeScript [`ModelUsage`](/docs/pt/agent-sdk/typescript#modelusage):

1805 1805

2923 "command": str | None, # Script de shell; cada linha stdout é um evento, exit encerra a observação2923 "command": str | None, # Script de shell; cada linha stdout é um evento, exit encerra a observação

2924 "ws": dict | None, # Fonte WebSocket: {"url": str, "protocols": list[str] | None}; cada frame de texto é um evento2924 "ws": dict | None, # Fonte WebSocket: {"url": str, "protocols": list[str] | None}; cada frame de texto é um evento

2925 "description": str, # Descrição breve mostrada em notificações2925 "description": str, # Descrição breve mostrada em notificações

2926 "timeout_ms": int | None, # Interromper após este prazo (padrão 300000, máx 3600000)2926 "timeout_ms": int | None, # Prazo em milissegundos (padrão 300000, máx 3600000; o prazo efetivo é no máximo 1800000)

2927 "persistent": bool | None, # Executar pela vida útil da sessão; parar com TaskStop

2928}2927}

2929```2928```

2930 2929

2933```python theme={null}2932```python theme={null}

2934{2933{

2935 "taskId": str, # ID da tarefa de monitor de fundo2934 "taskId": str, # ID da tarefa de monitor de fundo

2936 "timeoutMs": int, # Prazo de tempo limite em milissegundos (0 quando persistente)2935 "timeoutMs": int, # O prazo efetivo da observação em milissegundos

2937 "persistent": bool | None, # True quando executando até TaskStop ou fim da sessão2936 "persistent": bool | None, # False: cada observação tem um prazo

2938}2937}

2939```2938```

2940 2939

3350 TaskOutput3349 TaskOutput

3351</h3>3350</h3>

3352 3351

3353**Nome da ferramenta:** `TaskOutput`. O nome anterior `BashOutput` ainda é aceito como alias.3352Removido em Claude Code v2.1.277. Anteriormente recuperava saída de uma tarefa de fundo em execução ou concluída, com `BashOutput` aceito como alias; Claude lê o arquivo de saída de uma tarefa de fundo com `Read` em seu lugar.

3354 3353

3355<Note>`TaskOutput` está descontinuado; prefira `Read` no caminho do arquivo de saída da tarefa. Os schemas abaixo permanecem válidos para hooks e manipuladores de permissão que encontram a ferramenta.</Note>3354Uma entrada `disallowed_tools` ou uma regra de negação que ainda nomeia qualquer um dos nomes é ignorada sem um aviso.

~~3356~~

3357**Entrada:**

~~3358~~

3359```python theme={null}

3360{

3361 "task_id": str, # O ID da tarefa para obter saída

3362 "block": bool, # Se deve aguardar a conclusão (padrão True)

3363 "timeout": int, # Tempo máximo de espera em ms (padrão 30000)

3364}

3365```

~~3366~~

3367**Saída:**

~~3368~~

3369```python theme={null}

3370{

3371 "retrieval_status": "success" | "timeout" | "not_ready", # Se a saída foi recuperada

3372 "task": dict | None, # Detalhes da tarefa: task_id, task_type, status, description, output, mais campos específicos do tipo como exitCode

3373}

3374```

3375 3355

3376<h3 id="taskstop">3356<h3 id="taskstop">

3377 TaskStop3357 TaskStop

3629```3609```

3630 3610

3632| :-------------------------- | :---------------------------------------------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3612| :-------------------------- | :---------------------------------------------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3635| `excludedCommands` | `list[str]` | `[]` | Comandos que sempre contornam restrições de sandbox (por exemplo, `["docker"]`). Esses executam sem sandbox automaticamente sem envolvimento do modelo |3615| `excludedCommands` | `list[str]` | `[]` | Comandos que contornam restrições de sandbox, como `["docker *"]`. Esses executam sem sandbox automaticamente sem envolvimento do modelo; [`sandbox.excludedCommands`](/docs/pt/settings-reference#sandbox-excludedcommands) cobre quando uma entrada se aplica |

3636| `allowUnsandboxedCommands` | `bool` | `True` | Permite que o modelo solicite executar comandos fora do sandbox. Quando `True`, o modelo pode definir `dangerouslyDisableSandbox` na entrada da ferramenta, que volta para o [sistema de permissões](#permissions-fallback-for-unsandboxed-commands) |3616| `allowUnsandboxedCommands` | `bool` | `True` | Permite que o modelo solicite executar comandos fora do sandbox. Quando `True`, o modelo pode definir `dangerouslyDisableSandbox` na entrada da ferramenta, que volta para o [sistema de permissões](#permissions-fallback-for-unsandboxed-commands) |

3737 Fallback de Permissões para Comandos Sem Sandbox3717 Fallback de Permissões para Comandos Sem Sandbox

3738</h3>3718</h3>

3739 3719

3740Quando `allowUnsandboxedCommands` está ativado, o modelo pode solicitar executar comandos fora do sandbox definindo `dangerouslyDisableSandbox: True` na entrada da ferramenta. Essas solicitações voltam para o sistema de permissões existente, significando que seu manipulador `can_use_tool` será invocado, permitindo que você implemente lógica de autorização personalizada. Comandos listados em `excludedCommands` em vez disso contornam o sandbox automaticamente, sem envolvimento do modelo; veja [`SandboxSettings`](#sandboxsettings).3720Quando `allowUnsandboxedCommands` está ativado, o modelo pode solicitar executar comandos fora do sandbox definindo `dangerouslyDisableSandbox: True` na entrada da ferramenta. Essas solicitações voltam para o sistema de permissões existente, significando que seu manipulador `can_use_tool` será invocado, permitindo que você implemente lógica de autorização personalizada.

3721

3722Suas entradas `excludedCommands` em vez disso contornam o sandbox com nenhum envolvimento do modelo; [`sandbox.excludedCommands`](/docs/pt/settings-reference#sandbox-excludedcommands) cobre quando uma entrada se aplica.

3741 3723

3742O exemplo a seguir registra cada solicitação sem sandbox e a nega a menos que sua própria lógica de autorização a permita:3724O exemplo a seguir registra cada solicitação sem sandbox e a nega a menos que sua própria lógica de autorização a permita:

3743 3725

agent-sdk/subagents.md +2 −2

Details

648| :----------- | :------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |648| :----------- | :------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

649| Profundidade | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/pt/env-vars) | `3` camadas de subagentes abaixo do seu agente principal. `1` impede que seus subagentes gerem qualquer um dos seus próprios | Deixa um subagente na camada inferior incapaz de gerar, portanto ele faz seu trabalho delegado por conta própria. Veja [subagentes aninhados](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) |649| Profundidade | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/pt/env-vars) | `3` camadas de subagentes abaixo do seu agente principal. `1` impede que seus subagentes gerem qualquer um dos seus próprios | Deixa um subagente na camada inferior incapaz de gerar, portanto ele faz seu trabalho delegado por conta própria. Veja [subagentes aninhados](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents) |

650| Concorrência | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/pt/env-vars) | `20` subagentes em execução simultaneamente, contando cada subagente que Claude gera com a ferramenta Agent | Recusa gerar outro subagente, retornando `Concurrent subagent limit reached`, até que a contagem em execução caia abaixo do limite. Sessões com [ultracode](/docs/pt/model-config#adjust-effort-level) ativo nunca são recusadas. Veja o [limite de subagente concorrente](/docs/pt/sub-agents#concurrent-subagent-limit) |650| Concorrência | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/pt/env-vars) | `20` subagentes em execução simultaneamente, contando cada subagente que Claude gera com a ferramenta Agent | Recusa gerar outro subagente, retornando `Concurrent subagent limit reached`, até que a contagem em execução caia abaixo do limite. Sessões com [ultracode](/docs/pt/model-config#adjust-effort-level) ativo nunca são recusadas. Veja o [limite de subagente concorrente](/docs/pt/sub-agents#concurrent-subagent-limit) |

651| Gastos | `maxBudgetUsd` em TypeScript, `max_budget_usd` em Python | Sem limite. Comparado com `total_cost_usd`, portanto as solicitações de subagentes contam | Aplica o limite de três maneiras: recusa gerar mais subagentes, retornando `Budget limit reached`, interrompe subagentes em segundo plano que ainda estão em execução e encerra a consulta com o subtipo de resultado `error_max_budget_usd`. Para como os limites se comportam em uma sessão, veja [turnos e orçamento](/docs/pt/agent-sdk/agent-loop#turns-and-budget) |651| Gastos | `maxBudgetUsd` em TypeScript, `max_budget_usd` em Python | Sem limite. Conta o gasto da própria chamada, incluindo solicitações de subagentes | Aplica o limite de três maneiras: recusa gerar mais subagentes, retornando `Budget limit reached`, interrompe subagentes em segundo plano que ainda estão em execução e encerra a consulta com o subtipo de resultado `error_max_budget_usd`. Para como os limites se comportam em uma sessão, veja [turnos e orçamento](/docs/pt/agent-sdk/agent-loop#turns-and-budget) |

652 652

653Os dois SDKs tratam a opção `env` de forma diferente: o SDK TypeScript substitui o ambiente do subprocesso por ela, portanto espalhe `process.env` nela para manter variáveis como `PATH`, enquanto o SDK Python a mescla no ambiente herdado. Este exemplo desativa o aninhamento, permite no máximo cinco subagentes por vez e interrompe a consulta uma vez que o gasto estimado atinja \$5:653Os dois SDKs tratam a opção `env` de forma diferente: o SDK TypeScript substitui o ambiente do subprocesso por ela, portanto espalhe `process.env` nela para manter variáveis como `PATH`, enquanto o SDK Python a mescla no ambiente herdado. Este exemplo desativa o aninhamento, permite no máximo cinco subagentes por vez e interrompe a consulta uma vez que o gasto estimado atinja \$5:

654 654

747 747

748Se Claude completa tarefas diretamente em vez de delegar para seu subagente:748Se Claude completa tarefas diretamente em vez de delegar para seu subagente:

749 749

750* **Use prompting explícito**: mencione o subagente pelo nome em seu prompt, por exemplo "Use o agente code-reviewer para..."750* **Use prompting explícito**: mencione o subagente pelo nome em seu prompt, por exemplo "Use o agente code-reviewer para verificar o módulo de autenticação"

751* **Escreva uma descrição clara**: explique exatamente quando usar o subagente para que Claude possa corresponder tarefas apropriadamente751* **Escreva uma descrição clara**: explique exatamente quando usar o subagente para que Claude possa corresponder tarefas apropriadamente

752 752

753<h3 id="filesystem-based-agents-not-loading">753<h3 id="filesystem-based-agents-not-loading">

agent-sdk/typescript.md +96 −74

Details

313| `parent_agent_id` | `string \| null` | Para mensagens de um [subagente aninhado](/docs/pt/sub-agents#let-subagents-spawn-their-own-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 |313| `parent_agent_id` | `string \| null` | Para mensagens de um [subagente aninhado](/docs/pt/sub-agents#let-subagents-spawn-their-own-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 |

314 314

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

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

505| `fallbackModel` | `string` | `undefined` | Modelo a usar se o primário falhar. Aceita uma lista separada por vírgula. Para a ordem e o limite, veja [Cadeias de modelo de fallback](/docs/pt/model-config#fallback-model-chains). Para orientação, veja [Escolher um modelo](/docs/pt/agent-sdk/configuration#choose-a-model) |505| `fallbackModel` | `string` | `undefined` | Modelo a usar se o primário falhar. Aceita uma lista separada por vírgula. Para a ordem e o limite, veja [Cadeias de modelo de fallback](/docs/pt/model-config#fallback-model-chains). Para orientação, veja [Escolher um modelo](/docs/pt/agent-sdk/configuration#choose-a-model) |

507| `forwardSubagentText` | `boolean` | `false` | Encaminhar blocos de texto e pensamento de subagentes como mensagens de assistente e usuário com `parent_tool_use_id` definido, para que os consumidores possam renderizar uma transcrição aninhada. Sem esta opção, Claude Code emite blocos `tool_use` e `tool_result` de subagentes mas não texto ou pensamento. Mensagens de subagentes em cada profundidade de aninhamento são encaminhadas no Claude Code v2.1.219 e posterior; antes de v2.1.219, apenas mensagens de subagentes de profundidade-1 apareciam |507| `forwardSubagentText` | `boolean` | `false` | Encaminhar blocos de texto e pensamento de subagentes como mensagens de assistente e usuário com `parent_tool_use_id` definido, para que os consumidores possam renderizar uma transcrição aninhada. Sem esta opção, Claude Code emite blocos `tool_use` e `tool_result` de subagentes mas não texto ou pensamento. Mensagens de subagentes em cada profundidade de aninhamento são encaminhadas no Claude Code v2.1.219 e posterior; antes de v2.1.219, apenas mensagens de subagentes de profundidade-1 apareciam. Mensagens de subagentes que uma skill bifurcada gera, e de skills bifurcadas aninhadas, requerem v2.1.275 ou posterior |

508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Callbacks de hook para eventos |508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Callbacks de hook para eventos |

509| `includeHookEvents` | `boolean` | `false` | Incluir eventos de ciclo de vida de hook no fluxo de mensagens como [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage), e [`SDKHookResponseMessage`](#sdkhookresponsemessage). Eventos de ciclo de vida para hooks `SessionStart` e `Setup` são sempre incluídos e não precisam desta opção. Alguns eventos de hook, como `Notification`, `SessionEnd`, `PreCompact`, e `PostCompact`, nunca produzem um `SDKHookStartedMessage`, mesmo com esta opção. Para esses eventos, Claude Code ainda emite um `SDKHookProgressMessage` enquanto um hook de comando que é executado por mais de um segundo produz saída, e emite um `SDKHookResponseMessage` apenas quando um hook [que é executado em segundo plano](/docs/pt/hooks#run-hooks-in-the-background) termina |509| `includeHookEvents` | `boolean` | `false` | Incluir eventos de ciclo de vida de hook no fluxo de mensagens como [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage), e [`SDKHookResponseMessage`](#sdkhookresponsemessage). Eventos de ciclo de vida para hooks `SessionStart` e `Setup` são sempre incluídos e não precisam desta opção. Alguns eventos de hook, como `Notification`, `SessionEnd`, `PreCompact`, e `PostCompact`, nunca produzem um `SDKHookStartedMessage`, mesmo com esta opção. Para esses eventos, Claude Code ainda emite um `SDKHookProgressMessage` enquanto um hook de comando que é executado por mais de um segundo produz saída, e emite um `SDKHookResponseMessage` apenas quando um hook [que é executado em segundo plano](/docs/pt/hooks#run-hooks-in-the-background) termina |

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

528| `projectConfigRoot` | `string` | `undefined` | Caminho absoluto do checkout confiável que `cwd` é uma worktree de. Claude Code lê configurações de projeto, `.mcp.json`, e os comandos, agentes, skills, workflows, rotinas e estilos de saída do projeto `.claude/` deste diretório em vez de `cwd`, e define `CLAUDE_PROJECT_DIR` para ele. Hooks, scripts auxiliares como `apiKeyHelper`, e servidores MCP stdio começam com este diretório como seu diretório de trabalho. Arquivos `CLAUDE.md` e `.claude/rules/` ainda carregam de `cwd`. Requer Claude Code v2.1.275 ou posterior |

528| `promptSuggestions` | `boolean` | `false` | Ativar sugestões de prompt. Após um turno, Claude Code emite uma mensagem `prompt_suggestion` carregando um prompt de usuário previsto. Claude Code não gera sugestão para alguns turnos, como quando sua conta está próxima ou no limite de uso. Veja [Quando Claude Code pula sugestões](/docs/pt/interactive-mode#when-claude-code-skips-suggestions) |529| `promptSuggestions` | `boolean` | `false` | Ativar sugestões de prompt. Após um turno, Claude Code emite uma mensagem `prompt_suggestion` carregando um prompt de usuário previsto. Claude Code não gera sugestão para alguns turnos, como quando sua conta está próxima ou no limite de uso. Veja [Quando Claude Code pula sugestões](/docs/pt/interactive-mode#when-claude-code-skips-suggestions) |

530| `resumeDropsTurn` | `string` | `undefined` | Com `resumeSessionAt`: o UUID do prompt do turno que a retomada truncada pretende descartar. Claude Code recusa a retomada quando o intervalo descartado contém algo não atribuível a esse turno, como mensagens enfileiradas absorvidas ou notificações de tarefas, e nomeia o sinalizador `--resume-drops-turn` na mensagem de rejeição. Apenas o Agent SDK e retomadas em modo de impressão leem o par. Requer Claude Code v2.1.223 ou posterior |531| `resumeDropsTurn` | `string` | `undefined` | Com `resumeSessionAt`: o UUID do prompt do turno que a retomada truncada pretende descartar. Claude Code recusa a retomada quando o intervalo descartado contém algo não atribuível a esse turno, como mensagens enfileiradas absorvidas ou notificações de tarefas, e nomeia o sinalizador `--resume-drops-turn` na mensagem de rejeição. Apenas o Agent SDK e retomadas em modo de impressão leem o par. Requer Claude Code v2.1.223 ou posterior |

600 : Settings[K] | null;601 : Settings[K] | null;

601 }): Promise<void>;602 }): Promise<void>;

602 updateSettings(603 updateSettings(

603 source: 'localSettings',604 source: 'localSettings' | 'userSettings',

604 settings: Record<string, unknown>,605 settings: Record<string, unknown>,

605 ): Promise<void>;606 ): Promise<void>;

606 initializationResult(): Promise<SDKControlInitializeResponse>;607 initializationResult(): Promise<SDKControlInitializeResponse>;

621 reconnectMcpServer(serverName: string): Promise<void>;622 reconnectMcpServer(serverName: string): Promise<void>;

622 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;623 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;

623 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;624 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;

625 readMcpResource(serverName: string, uri: string): Promise<SDKControlMcpReadResourceResponse>;

624 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;626 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;

625 stopTask(taskId: string): Promise<void>;627 stopTask(taskId: string): Promise<void>;

626 close(): void;628 close(): void;

639| `setModel()` | Altera o modelo (apenas disponível em modo de entrada de transmissão). Passar `undefined` ou a string `"default"` redefine para [o modelo padrão do Claude Code](/docs/pt/model-config) |641| `setModel()` | Altera o modelo (apenas disponível em modo de entrada de transmissão). Passar `undefined` ou a string `"default"` redefine para [o modelo padrão do Claude Code](/docs/pt/model-config) |

640| `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 |642| `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 |

641| `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) |643| `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) |

642| `updateSettings(source, settings)` | Mescla configurações no arquivo de configurações local do projeto, `.claude/settings.local.json`; elas entram em vigor na próxima solicitação. Aceita apenas `source: 'localSettings'` e um conjunto de chaves permitidas, atualmente `outputStyle`, com valores de string; deletar uma chave não é suportado. Rejeita em transportes remotos e em sessões cujos [`settingSources`](#options) excluem `local`. Requer TypeScript SDK v0.3.257 ou posterior, que agrupa Claude Code v2.1.257 |644| `updateSettings(source, settings)` | Escreve uma chave permitida no arquivo de configurações local do projeto ou no arquivo de configurações do usuário, para que o valor persista para sessões posteriores. Veja [`updateSettings()`](#updatesettings). Requer TypeScript SDK v0.3.257 ou posterior, que agrupa Claude Code v2.1.257 |

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

644| `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 |646| `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 |

645| `supportedCommands()` | Retorna comandos disponíveis. A partir do Agent SDK v0.3.216 a lista reflete mudanças de comando no meio da sessão; veja [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |647| `supportedCommands()` | Retorna comandos disponíveis. A partir do Agent SDK v0.3.216 a lista reflete mudanças de comando no meio da sessão; veja [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |

649| `getContextUsage(opts?)` | Retorna um [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) dividindo o uso da janela de contexto da sessão por categoria, skill e ferramenta. Com o `detail` padrão, é o mesmo dado que `/context` mostra em uma sessão interativa. A [opção `detail`](#sdkcontrolgetcontextusageresponse) requer Agent SDK v0.3.257 ou posterior |651| `getContextUsage(opts?)` | Retorna um [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) dividindo o uso da janela de contexto da sessão por categoria, skill e ferramenta. Com o `detail` padrão, é o mesmo dado que `/context` mostra em uma sessão interativa. A [opção `detail`](#sdkcontrolgetcontextusageresponse) requer Agent SDK v0.3.257 ou posterior |

650| `readFile(path, options?)` | Lê um arquivo do sistema de arquivos da sessão. Claude Code resolve o caminho contra `cwd`; [O que `readFile()` pode ler](#what-readfile-can-read) lista os arquivos que ele serve. Passe `{ maxBytes }` para alterar o limite de leitura (padrão 1 MB, teto 10 MB) e `{ encoding: 'base64' }` para arquivos binários como imagens. Resolve com um [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse), ou `null` em negação de permissão, arquivo ausente, ou erro de transporte. Requer TypeScript SDK v0.2.121 ou posterior |652| `readFile(path, options?)` | Lê um arquivo do sistema de arquivos da sessão. Claude Code resolve o caminho contra `cwd`; [O que `readFile()` pode ler](#what-readfile-can-read) lista os arquivos que ele serve. Passe `{ maxBytes }` para alterar o limite de leitura (padrão 1 MB, teto 10 MB) e `{ encoding: 'base64' }` para arquivos binários como imagens. Resolve com um [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse), ou `null` em negação de permissão, arquivo ausente, ou erro de transporte. Requer TypeScript SDK v0.2.121 ou posterior |

651| `reloadSkills()` | Recarrega skills do disco, para que skills que você adiciona ou edita no meio da sessão fiquem disponíveis para a sessão em execução. Resolve com um [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) listando as skills disponíveis após o recarregamento. Requer Agent SDK v0.3.163 ou posterior |653| `reloadSkills()` | Recarrega skills do disco, para que skills que você adiciona ou edita no meio da sessão fiquem disponíveis para a sessão em execução. Resolve com um [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) listando as skills disponíveis após o recarregamento. Requer Agent SDK v0.3.163 ou posterior |

653| `reconnectMcpServer(serverName)` | Reconectar um servidor MCP por nome. Se o nome também corresponder a uma entrada em um arquivo de configurações como `.mcp.json` ou `~/.claude.json`, Claude Code reconecta o servidor que você configurou através de [`mcpServers`](#options) ou `setMcpServers()`, não a entrada do arquivo de configurações. Essa ordem de resolução requer Claude Code v2.1.257 ou posterior |655| `reconnectMcpServer(serverName)` | Reconectar um servidor MCP por nome. Se o nome também corresponder a uma entrada em um arquivo de configurações como `.mcp.json` ou `~/.claude.json`, Claude Code reconecta o servidor que você configurou através de [`mcpServers`](#options) ou `setMcpServers()`, não a entrada do arquivo de configurações. Essa ordem de resolução requer Claude Code v2.1.257 ou posterior |

654| `toggleMcpServer(serverName, enabled)` | Ativar ou desativar um servidor MCP por nome, com a mesma resolução de nome que `reconnectMcpServer()`. Desativar desconecta o servidor |656| `toggleMcpServer(serverName, enabled)` | Ativar ou desativar um servidor MCP por nome, com a mesma resolução de nome que `reconnectMcpServer()`. Desativar desconecta o servidor |

655| `setMcpServers(servers)` | Substituir dinamicamente o conjunto de servidores MCP para esta sessão. Resolve com um [`McpSetServersResult`](#mcpsetserversresult) nomeando quais servidores foram adicionados e removidos, e quaisquer erros |657| `setMcpServers(servers)` | Substituir dinamicamente o conjunto de servidores MCP para esta sessão. Resolve com um [`McpSetServersResult`](#mcpsetserversresult) nomeando quais servidores foram adicionados e removidos, e quaisquer erros |

658| `readMcpResource(serverName, uri)` | *Alfa.* Lê um recurso MCP Apps `ui://` de um servidor MCP conectado para que sua aplicação possa renderizar um widget de ferramenta. Resolve com um [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Requer TypeScript Agent SDK v0.3.280 ou posterior |

671 674

672`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). `applyFlagSettings()` 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.675`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). `applyFlagSettings()` 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.

673 676

674Os 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. Esta é a mesma camada que a [seção de precedência na página](#settings-precedence) chama de opções programáticas.677Os valores são escritos na camada de configurações de flag, mesclados sobre o que a opção `settings` inline de `query()` definiu na inicialização. Esta é a mesma camada que a [seção de precedência na página](#settings-precedence) chama de opções programáticas.

675 678

676Chamadas 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, passe `null` para essa chave. A maioria das chaves então volta a fontes de precedência mais baixa. Um `model` limpo redefine para [o modelo padrão do Claude Code](/docs/pt/model-config), mesmo quando um arquivo de configurações define `model`. Passar `undefined` não tem efeito porque a serialização JSON a descarta.679Chamadas 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.

680

681Para limpar uma chave que você definiu com `applyFlagSettings()`, passe `null` para essa chave. A maioria das chaves então volta a um valor que a opção `settings` de `query()` definiu na inicialização, depois a fontes de precedência mais baixa. Um `model` limpo redefine para [o modelo padrão do Claude Code](/docs/pt/model-config), mesmo quando um arquivo de configurações define `model`. Passar `undefined` não tem efeito porque a serialização JSON a descarta.

682

683Três chaves além de `model` redefinem o estado da sessão em vez de voltar:

684

685* `effortLevel: null` retorna a sessão ao nível de esforço padrão do modelo, não à opção `effort` de `query()` ou um `effortLevel` de um arquivo de configurações.

686* `agent: null` executa a thread principal sem agente, começando com o próximo turno, em vez de restaurar a opção `agent` de `query()` ou um `agent` de um arquivo de configurações. Se o agente limpo tivesse aplicado seu próprio modelo, a sessão volta ao modelo que resolveu na inicialização.

687* `ultracode: null` desativa ultracode, como `false` faz, em vez de restaurar um valor `ultracode` de um arquivo de configurações. A sessão mantém seu nível de esforço atual, então passe `effortLevel` na mesma chamada para alterá-lo.

677 688

678Apenas disponível em modo de entrada de transmissão, a mesma restrição que `setModel()` e `setPermissionMode()`.689Apenas disponível em modo de entrada de transmissão, a mesma restrição que `setModel()` e `setPermissionMode()`.

679 690

695 `applyFlagSettings()` é apenas TypeScript. O SDK Python não expõe um método equivalente.706 `applyFlagSettings()` é apenas TypeScript. O SDK Python não expõe um método equivalente.

696</Note>707</Note>

697 708

709<h4 id="updatesettings">

710 `updateSettings()`

711</h4>

712

713Escreve uma chave permitida em um arquivo de configurações em disco, para que o valor persista para sessões posteriores que carregam essa fonte. Cada fonte aceita uma chave, com um valor de string:

714

715* **`"localSettings"`**: aceita `outputStyle` e mescla em um arquivo de configurações local do projeto, `.claude/settings.local.json`. O novo estilo entra em vigor na próxima solicitação da sessão.

716* **`"userSettings"`**: aceita `effortLevel` e o salva como o [nível de esforço](/docs/pt/model-config#adjust-effort-level) padrão para o modelo atual da sessão, sob [`modelSettings`](/docs/pt/settings-reference#modelsettings) no arquivo de configurações do usuário. Passar `max` não escreve nada, porque `max` é apenas de sessão. A sessão em execução mantém seu nível de esforço atual de qualquer forma, então chame [`applyFlagSettings()`](#applyflagsettings) quando você também quiser alterar isso. Esta fonte requer TypeScript SDK v0.3.277 ou posterior, que agrupa Claude Code v2.1.277.

717

718A chamada rejeita quando a solicitação carrega qualquer outra chave, quando a sessão é executada sobre um transporte remoto, e quando os [`settingSources`](#options) da sessão excluem a fonte que você nomeia. Deletar uma chave não é suportado.

719

698<h3 id="warmquery">720<h3 id="warmquery">

699 `WarmQuery`721 `WarmQuery`

700</h3>722</h3>

942 964

943`skills` lista as skills disponíveis após o recarregamento, na mesma forma [`SlashCommand`](#slashcommand) que `supportedCommands()` retorna.965`skills` lista as skills disponíveis após o recarregamento, na mesma forma [`SlashCommand`](#slashcommand) que `supportedCommands()` retorna.

944 966

967<h3 id="sdkcontrolmcpreadresourceresponse">

968 `SDKControlMcpReadResourceResponse`

969</h3>

970

971Tipo de retorno de [`readMcpResource()`](#query-object), carregando o resultado `resources/read` do servidor MCP. Requer TypeScript Agent SDK v0.3.280 ou posterior.

972

973```typescript theme={null}

974type SDKControlMcpReadResourceResponse = {

975 contents: {

976 uri: string;

977 mimeType?: string;

978 text?: string;

979 blob?: string;

980 _meta?: Record<string, unknown>;

981 }[];

982};

983```

984

985Passe `readMcpResource()` o nome do servidor conforme `mcpServerStatus()` o relata e um URI `ui://`, como o `ui.resourceUri` que uma ferramenta declara em sua [`_meta`](#mcpserverstatus). A chamada rejeita para qualquer outro esquema de URI, para um [servidor MCP SDK](#createsdkmcpserver) que sua aplicação hospeda a si mesma, e para um servidor que não está conectado. Está disponível quando a mensagem de inicialização [`capabilities`](#sdksystemmessage) incluem `mcp_read_resource_v1`.

986

987Cada entrada `contents` é um item de conteúdo conforme o servidor o enviou. `blob` contém dados base64 para um item binário, e `_meta` é o próprio `_meta` do item, onde um servidor MCP Apps coloca o `ui.csp` e `ui.permissions` do recurso. O conteúdo é HTML de terceiros não confiável, então renderize-o em um sandbox.

988

945<h3 id="agentdefinition">989<h3 id="agentdefinition">

946 `AgentDefinition`990 `AgentDefinition`

947</h3>991</h3>

1368 uuid?: UUID;1412 uuid?: UUID;

1369 session_id?: string;1413 session_id?: string;

1370 message: MessageParam; // Do SDK Anthropic1414 message: MessageParam; // Do SDK Anthropic

1415 pasted_content?: MessageParam["content"][];

1371 parent_tool_use_id: string | null;1416 parent_tool_use_id: string | null;

1372 isSynthetic?: boolean;1417 isSynthetic?: boolean;

1373 shouldQuery?: boolean;1418 shouldQuery?: boolean;

1374 tool_use_result?: unknown;1419 tool_use_result?: unknown;

1375 origin?: SDKMessageOrigin;1420 origin?: SDKMessageOrigin;

1421 inline_pastes?: string[];

1376};1422};

1377```1423```

1378 1424

1425Defina `pasted_content` para enviar conteúdo que o usuário colou em sua interface de prompt em vez de digitar, uma entrada por colagem, cada uma uma string ou um array de blocos de conteúdo. Claude Code anexa o texto de cada entrada após o texto digitado, em ordem, e pode envolver cada colagem em tags `<pasted_content>`. Blocos diferentes de texto são ignorados, portanto envie imagens e documentos em `message.content`. Requer Agent SDK v0.3.277 ou posterior.

1426

1379Defina `shouldQuery` como `false` para anexar a mensagem à transcrição sem acionar um turno do assistente. A mensagem é mantida e mesclada na próxima mensagem do usuário que aciona um turno. Use isso para injetar contexto, como a saída de um comando que você executou fora de banda, sem gastar uma chamada de modelo nela.1427Defina `shouldQuery` como `false` para anexar a mensagem à transcrição sem acionar um turno do assistente. A mensagem é mantida e mesclada na próxima mensagem do usuário que aciona um turno. Use isso para injetar contexto, como a saída de um comando que você executou fora de banda, sem gastar uma chamada de modelo nela.

1380 1428

1381Em uma mensagem que carrega um bloco `tool_result`, `tool_use_result` é o objeto de saída estruturada da ferramenta em vez do texto enviado ao modelo. Sua forma depende da ferramenta nomeada pelo bloco `tool_use` correspondente, portanto o campo é digitado como `unknown`; as formas integradas estão listadas em [Tipos de Saída de Ferramenta](#tool-output-types).1429Em uma mensagem que carrega um bloco `tool_result`, `tool_use_result` é o objeto de saída estruturada da ferramenta em vez do texto enviado ao modelo. Sua forma depende da ferramenta nomeada pelo bloco `tool_use` correspondente, portanto o campo é digitado como `unknown`; as formas integradas estão listadas em [Tipos de Saída de Ferramenta](#tool-output-types).

1384 1432

1385Para uma ferramenta MCP cujo resultado contém blocos `resource_link`, `tool_use_result` é um objeto com um array `resourceLinks` de entradas [`SDKMcpResourceLink`](#sdkmcpresourcelink). Claude recebe cada link como uma linha de texto no bloco `tool_result`, portanto leia `resourceLinks` para renderizar os arquivos que o servidor retornou em vez de analisar esse texto. Claude Code omite `resourceLinks` quando o resultado não tem links e em resultados de subagentes, mantém no máximo 50 links por resultado, e para de adicionar links quando o array atinge 64 KiB de JSON serializado. `resourceLinks` requer Agent SDK v0.3.257 ou posterior.1433Para uma ferramenta MCP cujo resultado contém blocos `resource_link`, `tool_use_result` é um objeto com um array `resourceLinks` de entradas [`SDKMcpResourceLink`](#sdkmcpresourcelink). Claude recebe cada link como uma linha de texto no bloco `tool_result`, portanto leia `resourceLinks` para renderizar os arquivos que o servidor retornou em vez de analisar esse texto. Claude Code omite `resourceLinks` quando o resultado não tem links e em resultados de subagentes, mantém no máximo 50 links por resultado, e para de adicionar links quando o array atinge 64 KiB de JSON serializado. `resourceLinks` requer Agent SDK v0.3.257 ou posterior.

1386 1434

1435Defina `inline_pastes` para informar ao Claude Code quais partes de `message.content` o usuário colou em vez de digitar, uma string por colagem. O texto do prompt fica onde o usuário o colocou. Claude Code pode envolver cada colagem listada em tags `<pasted_content>` onde ela está, para que Claude possa distinguir material colado das próprias palavras do usuário. Apenas colagens no último bloco de texto do prompt são envolvidas. Requer TypeScript Agent SDK v0.3.280 ou posterior.

1436

1387<h3 id="sdkusermessagereplay">1437<h3 id="sdkusermessagereplay">

1388 `SDKUserMessageReplay`1438 `SDKUserMessageReplay`

1389</h3>1439</h3>

1488* `first_content_frame_ms`: tempo em milissegundos até o primeiro evento de fluxo `content_block_start` ou `content_block_delta`, contando blocos de pensamento como conteúdo. Presente apenas no braço de sucesso, quando `is_error` é false. Requer Agent SDK v0.3.260 ou posterior.1538* `first_content_frame_ms`: tempo em milissegundos até o primeiro evento de fluxo `content_block_start` ou `content_block_delta`, contando blocos de pensamento como conteúdo. Presente apenas no braço de sucesso, quando `is_error` é false. Requer Agent SDK v0.3.260 ou posterior.

1489* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: cronometragens para fazer upload do primeiro evento de fluxo do turno. Claude Code os registra apenas em sessões que transmite para claude.ai, como [sessões em nuvem](/docs/pt/claude-code-on-the-web), e os resultados que `query()` produz não os carregam. Requer Agent SDK v0.3.260 ou posterior.1539* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: cronometragens para fazer upload do primeiro evento de fluxo do turno. Claude Code os registra apenas em sessões que transmite para claude.ai, como [sessões em nuvem](/docs/pt/claude-code-on-the-web), e os resultados que `query()` produz não os carregam. Requer Agent SDK v0.3.260 ou posterior.

1490* `usage`: apenas loop do agente principal. Exclui chamadas de subagente e modelo auxiliar, e é por turno em sessões de entrada de fluxo. Prefira `modelUsage` para contabilidade de token/custo.1540* `usage`: apenas loop do agente principal. Exclui chamadas de subagente e modelo auxiliar, e é por turno em sessões de entrada de fluxo. Prefira `modelUsage` para contabilidade de token/custo.

1491* `modelUsage`: totais por modelo para cada chamada de modelo feita através do pipeline de consulta durante esta chamada `query()`, incluindo o loop principal, subagentes e chamadas internas como compactação e agentes Workflow. Chamadas auxiliares fora desse pipeline, como o classificador de permissão e solicitações de contagem de tokens, são excluídas. Em sessões de entrada de fluxo os totais são cumulativos entre turnos, portanto leia o resultado mais recente em vez de somar entre resultados. Veja [Rastrear custos no modo de entrada de fluxo](/docs/pt/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) para redefinições e [Recuperar totais após uma falha de sessão](/docs/pt/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) para resultados zerados.1541* `modelUsage`: totais por modelo para cada chamada de modelo feita através do pipeline de consulta durante esta chamada `query()`, incluindo o loop principal, subagentes e chamadas internas como compactação e agentes Workflow. Chamadas auxiliares fora desse pipeline, como o classificador de permissão e solicitações de contagem de tokens, são excluídas. Uma chamada que retoma uma sessão também conta os [totais por modelo restaurados das chamadas anteriores da sessão](/docs/pt/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Em sessões de entrada de fluxo os totais são cumulativos entre turnos, portanto leia o resultado mais recente em vez de somar entre resultados. Veja [Rastrear custos no modo de entrada de fluxo](/docs/pt/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) para redefinições e [Recuperar totais após uma falha de sessão](/docs/pt/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) para resultados zerados.

1492* `total_cost_usd`: custo estimado cumulativo em USD para esta chamada `query()`, cobrindo as mesmas chamadas que `modelUsage` e redefinindo nos mesmos pontos. É uma estimativa, não uma declaração de faturamento. Veja [Rastrear custo e uso](/docs/pt/agent-sdk/cost-tracking) para ressalvas de precisão.1542* `total_cost_usd`: custo estimado cumulativo em USD, cobrindo as mesmas chamadas que `modelUsage` e redefinindo nos mesmos pontos. Uma chamada que retoma uma sessão também conta os [totais restaurados das chamadas anteriores da sessão](/docs/pt/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). É uma estimativa, não uma declaração de faturamento. Veja [Rastrear custo e uso](/docs/pt/agent-sdk/cost-tracking) para ressalvas de precisão.

1493* `queued_turn_count`: o número de mensagens que você enviou com `origin: { kind: "human" }` que ainda estão esperando quando Claude Code produziu o resultado. Veja [`queued_turn_count`](#queued_turn_count) para o que `0` e um campo ausente dizem a você.1543* `queued_turn_count`: o número de mensagens que você enviou com `origin: { kind: "human" }` que ainda estão esperando quando Claude Code produziu o resultado. Veja [`queued_turn_count`](#queued_turn_count) para o que `0` e um campo ausente dizem a você.

1494* `startup_failure_reason`: por que Claude Code recusou iniciar, na mensagem de resultado `error_during_execution` que escreve antes de sair em uma falha de inicialização conhecida. Veja [`startup_failure_reason`](#startup_failure_reason) para os valores e quais falhas o carregam. Requer Agent SDK v0.3.274 ou posterior.1544* `startup_failure_reason`: por que Claude Code recusou iniciar, na mensagem de resultado `error_during_execution` que escreve antes de sair em uma falha de inicialização conhecida. Veja [`startup_failure_reason`](#startup_failure_reason) para os valores e quais falhas o carregam. Requer Agent SDK v0.3.274 ou posterior.

1495* `terminal_reason`: por que o loop terminou. Um de `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"`, ou `"turn_setup_failed"`.1545* `terminal_reason`: por que o loop terminou. Um de `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"`, ou `"turn_setup_failed"`.

1513 1563

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

1515 1565

1516O campo `origin` encaminha a [`SDKMessageOrigin`](#sdkmessageorigin) da mensagem do usuário que acionou este resultado. Quando o SDK injeta um turno de acompanhamento sintético, como para uma tarefa em segundo plano concluída, a `SDKResultMessage` resultante carrega `origin: { kind: "task-notification" }`. Rotinas cujo gatilho disparou e mensagens verificadas pelo servidor de suas outras sessões chegam com este tipo também, cada uma com o `subkind` descrito em [Subtipos de notificação de tarefa](#task-notification-subkinds). Verifique `kind` para distinguir resultados que respondem ao seu prompt de acompanhamentos injetados antes de roteá-los ou suprimi-los.1566O campo `origin` encaminha a [`SDKMessageOrigin`](#sdkmessageorigin) da mensagem do usuário que acionou este resultado. Quando o SDK injeta um turno de acompanhamento sintético, como para uma tarefa em segundo plano concluída, a `SDKResultMessage` resultante carrega `origin: { kind: "task-notification" }`. Rotinas cujo gatilho disparou e mensagens verificadas pelo servidor de suas outras sessões chegam com este tipo também, cada uma com o `subkind` descrito em [Subtipos de notificação de tarefa](#task-notification-subkinds). Verifique `kind` para distinguir resultados que respondem ao seu prompt de acompanhamentos injetados antes de roteá-los ou suprimi-los. Se sua aplicação [declara execuções agendadas](#declare-a-scheduled-run), seus resultados carregam `kind: "task-notification"` também, portanto não suprima apenas em `kind`.

1567

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

1517 1569

1518O campo está ausente para resultados emitidos antes de qualquer turno do usuário, como erros de inicialização.1570O campo está ausente para resultados emitidos antes de qualquer turno do usuário, como erros de inicialização.

1519 1571

1939 | {1991 | {

1940 kind: "task-notification";1992 kind: "task-notification";

1941 subkind?: "scheduled-trigger" | "peer-send-message";1993 subkind?: "scheduled-trigger" | "peer-send-message";

1994 fireReason?: string;

1942 }1995 }

1943 | { kind: "coordinator" }1996 | { kind: "coordinator" }

1944 | { kind: "auto-continuation" }1997 | { kind: "auto-continuation" }

1959 Subtipos de notificação de tarefa2012 Subtipos de notificação de tarefa

1960</h3>2013</h3>

1961 2014

1962Quando Claude Code entrega uma notificação de tarefa em uma sessão, ele define `subkind` na `origin` da notificação apenas se servidores Anthropic verificaram de onde essa notificação veio. `subkind` requer Claude Code v2.1.213 ou posterior, e toma um de dois valores:2015Quando Claude Code entrega uma notificação de tarefa em uma sessão, ele define `subkind` na `origin` da notificação apenas se servidores Anthropic verificaram de onde essa notificação veio. Ele também define `subkind` quando sua aplicação [declara a mensagem como uma execução agendada](#declare-a-scheduled-run) a si mesma, o que requer TypeScript Agent SDK v0.3.280 ou posterior. `subkind` requer Claude Code v2.1.213 ou posterior, e toma um de dois valores:

1963 2016

1964* `scheduled-trigger`: a notificação é um prompt armazenado de uma [rotina](/docs/pt/routines), entregue porque um dos gatilhos da rotina disparou: seu cronograma, seu [gatilho de API](/docs/pt/routines#add-an-api-trigger), seu [gatilho GitHub](/docs/pt/routines#add-a-github-trigger), ou **Executar agora**. Claude Code enquadra estes para o modelo como a tarefa atribuída da sessão, com um aviso diferente do [aviso que outras notificações de tarefa carregam](#sdktasknotificationmessage).2017* `scheduled-trigger`: a notificação é um prompt armazenado de uma [rotina](/docs/pt/routines), entregue porque um dos gatilhos da rotina disparou: seu cronograma, seu [gatilho de API](/docs/pt/routines#add-an-api-trigger), seu [gatilho GitHub](/docs/pt/routines#add-a-github-trigger), ou **Executar agora**. Uma mensagem que sua aplicação [declara como uma execução agendada](#declare-a-scheduled-run) carrega este valor também. Claude Code enquadra estes para o modelo como a tarefa atribuída da sessão, com um aviso diferente do [aviso que outras notificações de tarefa carregam](#sdktasknotificationmessage).

1965*2018*

1966 2019

1967`peer-send-message`: a notificação é uma mensagem que outra de suas sessões enviou com a ferramenta `send_message` do lado do servidor que [Claude Code na web](/docs/pt/claude-code-on-the-web) sessões usam para se mensagear, não a [ferramenta `SendMessage` entre sessões](/docs/pt/cross-session-messaging), e servidores Anthropic verificaram que ambas as sessões pertencem ao mesmo grupo privado de sessões. Requer Claude Code v2.1.224 ou posterior. Uma entrega `send_message` que os servidores não verificaram dessa forma não tem `subkind`.2020`peer-send-message`: a notificação é uma mensagem que outra de suas sessões enviou com a ferramenta `send_message` do lado do servidor que [Claude Code na web](/docs/pt/claude-code-on-the-web) sessões usam para se mensagear, não a [ferramenta `SendMessage` entre sessões](/docs/pt/cross-session-messaging), e servidores Anthropic verificaram que ambas as sessões pertencem ao mesmo grupo privado de sessões. Requer Claude Code v2.1.224 ou posterior. Uma entrega `send_message` que os servidores não verificaram dessa forma não tem `subkind`.

1968 2021

1969Toda outra notificação de tarefa não tem `subkind`. Isso inclui [tarefas agendadas](/docs/pt/scheduled-tasks) que disparam em sua própria máquina, [atividade de PR](/docs/pt/claude-code-on-the-web#how-claude-responds-to-pr-activity) entregue em uma sessão, e eventos em segundo plano como uma tarefa concluída. Mensagens da [ferramenta `SendMessage` entre sessões](/docs/pt/cross-session-messaging) não são notificações de tarefa: independentemente de virem de uma sessão na mesma máquina ou através de servidores Anthropic de outra máquina, Claude Code lhes dá `kind: "peer"` e os [campos de origem de par](#peer-origin-fields).2022Toda outra notificação de tarefa não tem `subkind`. Isso inclui [tarefas agendadas](/docs/pt/scheduled-tasks) que disparam em sua própria máquina, [atividade de PR](/docs/pt/claude-code-on-the-web#how-claude-responds-to-pr-activity) entregue em uma sessão, e eventos em segundo plano como uma tarefa concluída. Mensagens da [ferramenta `SendMessage` entre sessões](/docs/pt/cross-session-messaging) não são notificações de tarefa: independentemente de virem de uma sessão na mesma máquina ou através de servidores Anthropic de outra máquina, Claude Code lhes dá `kind: "peer"` e os [campos de origem de par](#peer-origin-fields).

1970 2023

2024`fireReason` diz por que uma notificação `scheduled-trigger` disparou, como um token em minúsculas curto como `scheduled`, `manual`, `retry`, `catch_up`, ou `api`. Servidores Anthropic o definem nas entregas de uma [rotina](/docs/pt/routines), e sua aplicação o define quando declara uma execução agendada. Está ausente quando nenhum dos dois enviou um. Requer TypeScript Agent SDK v0.3.280 ou posterior.

2025

2026<h4 id="declare-a-scheduled-run">

2027 Declare a scheduled run

2028</h4>

2029

2030Se sua aplicação executa prompts em seu próprio cronograma, declare cada execução para que Claude Code enquadre o turno para o modelo como uma tarefa agendada em vez de como entrada ao vivo do usuário. Inicie a sessão com `CLAUDE_CODE_HOST_SCHEDULED_RUN` definido como `1` em [`env`](#options), depois envie a [`SDKUserMessage`](#sdkusermessage) da execução com `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` e sem `isSynthetic`. Claude Code ignora a declaração em um processo iniciado sem essa variável. Ele também a ignora em um processo cujo ambiente carrega [`CLAUDECODE`](/docs/pt/env-vars) ou `CLAUDE_CODE_CHILD_SESSION`. Claude Code mantém `fireReason` apenas quando o valor é 1 a 32 letras minúsculas ou underscores. Requer TypeScript Agent SDK v0.3.280 ou posterior.

2031

1971<h3 id="peer-origin-fields">2032<h3 id="peer-origin-fields">

1972 Campos de origem de par2033 Campos de origem de par

1973</h3>2034</h3>

2860 | ReadMcpResourceInput2921 | ReadMcpResourceInput

2861 | RefreshMcpToolsInput2922 | RefreshMcpToolsInput

2862 | RemoteTriggerInput2923 | RemoteTriggerInput

2863 | REPLInput

2864 | ReportFindingsInput2924 | ReportFindingsInput

2865 | ScheduleWakeupInput2925 | ScheduleWakeupInput

2866 | ShowOnboardingRolePickerInput2926 | ShowOnboardingRolePickerInput

2867 | TaskCreateInput2927 | TaskCreateInput

2868 | TaskGetInput2928 | TaskGetInput

2869 | TaskListInput2929 | TaskListInput

2870 | TaskOutputInput

2871 | TaskStopInput2930 | TaskStopInput

2872 | TaskUpdateInput2931 | TaskUpdateInput

2873 | TodoWriteInput2932 | TodoWriteInput

2962 3021

2963Executa 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.3022Executa 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.

2964 3023

2965`timeout_ms` é o prazo do watch em milissegundos. O padrão é 300000, e o prazo efetivo é no máximo 1800000, que é 30 minutos. No prazo, o watch termina e Claude recebe um aviso para que possa iniciar um novo watch se ainda precisar de um.3024`timeout_ms` é o prazo do watch em milissegundos. O padrão é 300000 e aceita valores até 3600000. O prazo efetivo é no máximo 1800000, que é 30 minutos, então um valor aceito maior é encurtado para isso. No prazo, o watch termina e Claude recebe um aviso para que possa iniciar um novo watch se ainda precisar de um.

2966 3025

2967O tipo exportado marca `timeout_ms` como obrigatório porque o esquema preenche o padrão; uma chamada que o omite valida.3026O tipo exportado marca `timeout_ms` como obrigatório porque o esquema preenche o padrão; uma chamada que o omite valida.

2968 3027

2972 TaskOutput3031 TaskOutput

2973</h3>3032</h3>

2974 3033

2975**Nome da ferramenta:** `TaskOutput`3034Removido no Claude Code v2.1.277, junto com seu tipo `TaskOutputInput`. Anteriormente recuperava saída de uma tarefa de background em execução ou concluída; Claude lê o arquivo de saída de uma tarefa de background com `Read` em vez disso.

~~2976~~

2977<Note>`TaskOutput` está descontinuado; prefira `Read` no caminho do arquivo de saída da tarefa. Os esquemas abaixo permanecem válidos para hooks e manipuladores de permissão que encontram a ferramenta.</Note>

~~2978~~

2979```typescript theme={null}

2980type TaskOutputInput = {

2981 task_id: string;

2982 block: boolean;

2983 timeout: number;

2984};

2985```

2986 3035

2987Recupera saída de uma tarefa de background em execução ou concluída.3036Uma entrada `disallowedTools` ou uma regra de negação que ainda nomeia `TaskOutput` é ignorada sem um aviso.

2988 3037

2989<h3 id="edit">3038<h3 id="edit">

2990 Edit3039 Edit

3479 REPL3528 REPL

3480</h3>3529</h3>

3481 3530

3482**Nome da ferramenta:** `REPL`3531Removido em v2.1.275. Através de v2.1.274, uma ferramenta `REPL` experimental poderia ser ativada com `CLAUDE_CODE_REPL=1` na [opção `env`](#options).

~~3483~~

3484```typescript theme={null}

3485type REPLInput = {

3486 code: string;

3487 description?: string;

3488 timeout?: number;

3489};

3490```

~~3491~~

3492Executa código JavaScript em um REPL persistente. O estado persiste entre chamadas e await de nível superior é suportado. `timeout` está em milissegundos, com um padrão de 30000 e um máximo de 600000.

~~3493~~

3494Os tipos são exportados, mas a ferramenta está desativada em sessões SDK a menos que você defina `CLAUDE_CODE_REPL=1` na [opção `env`](#options). Também requer o executável `claude` baseado em Bun que o instalador nativo fornece.

3495 3532

3496<h3 id="reportfindings">3533<h3 id="reportfindings">

3497 ReportFindings3534 ReportFindings

3537 action?: "publish" | "list";3574 action?: "publish" | "list";

3538 file_path?: string;3575 file_path?: string;

3539 favicon?: string;3576 favicon?: string;

3577 icon?: string;

3540 limit?: number;3578 limit?: number;

3541 scope?: "mine" | "shared" | "all";3579 scope?: "mine" | "shared" | "all";

3542 title?: string;3580 title?: string;

3549};3587};

3550```3588```

3551 3589

3552Publica um arquivo `.html` ou `.md` local como uma página de artefato hospedada, ou lista os artefatos publicados do usuário. Omita `action` ou passe `"publish"` para publicar `file_path`, que é obrigatório para a ação de publicação junto com `favicon`, um ou dois emoji que marcam o artefato na galeria do usuário. `title` nomeia a página publicada na aba do navegador e galeria quando o arquivo HTML não tem uma tag `<title>`. `url` visa um artefato existente para atualizar no local em vez de criar um novo.3590Publica um arquivo `.html` ou `.md` local como uma página de artefato hospedada, ou lista os artefatos publicados do usuário. Omita `action` ou passe `"publish"` para publicar `file_path`, que é obrigatório para a ação de publicação. Cada campo abaixo se aplica a uma publicação:

3591

3592* `icon`: uma palavra genérica curta para o ícone da aba do navegador do artefato, como `chart` ou `map`. Claude o inclui em uma primeira publicação e o omite em uma atualização, o que mantém o ícone armazenado do artefato.

3593* `favicon`: descontinuado, e Claude o omite.

3594* `title`: nomeia a página publicada na aba do navegador e galeria quando o arquivo HTML não tem uma tag `<title>`.

3595* `url`: visa um artefato existente para atualizar no local em vez de criar um novo.

3553 3596

3554`force` é uma sobrescrita de último recurso que descarta uma versão mais nova que outra sessão publicou. Em um conflito, a publicação falhada retorna o conteúdo mais novo; Claude mescla suas alterações nesse conteúdo, ou relê o artefato, e publica novamente. Passe `force` apenas quando o usuário explicitamente pedir para descartar essa versão.3597`force` é uma sobrescrita de último recurso que descarta uma versão mais nova que outra sessão publicou. Em um conflito, a publicação falhada retorna o conteúdo mais novo; Claude mescla suas alterações nesse conteúdo, ou relê o artefato, e publica novamente. Passe `force` apenas quando o usuário explicitamente pedir para descartar essa versão.

3555 3598

3686 | ReadMcpResourceOutput3729 | ReadMcpResourceOutput

3687 | RefreshMcpToolsOutput3730 | RefreshMcpToolsOutput

3688 | RemoteTriggerOutput3731 | RemoteTriggerOutput

3689 | REPLOutput

3690 | ReportFindingsOutput3732 | ReportFindingsOutput

3691 | ScheduleWakeupOutput3733 | ScheduleWakeupOutput

3692 | ShowOnboardingRolePickerOutput3734 | ShowOnboardingRolePickerOutput

4536 4578

4537Retorna detalhes de entrega, incluindo se uma notificação push ou local foi enviada e por que a entrega foi ignorada.4579Retorna detalhes de entrega, incluindo se uma notificação push ou local foi enviada e por que a entrega foi ignorada.

4538 4580

4539<h3 id="repl-2">

4540 REPL

4541</h3>

~~4542~~

4543**Nome da ferramenta:** `REPL`

~~4544~~

4545```typescript theme={null}

4546type REPLOutput = {

4547 code: string;

4548 result: {

4549 [k: string]: unknown;

4550 };

4551 stdout: string;

4552 stderr: string;

4553 error?: string;

4554 registeredTools?: string[];

4555 images?: {

4556 base64: string;

4557 mediaType: string;

4558 }[];

4559 documents?: {

4560 base64: string;

4561 }[];

4562};

4563```

~~4564~~

4565Retorna o resultado da execução, saída do console capturada e quaisquer imagens ou documentos surfados por chamadas internas de `Read`.

~~4566~~

4567<h3 id="reportfindings-2">4581<h3 id="reportfindings-2">

4568 ReportFindings4582 ReportFindings

4569</h3>4583</h3>

4887```4901```

4888 4902

4889<Warning>4903<Warning>

4890 O beta `context-1m-2025-08-07` foi descontinuado a partir de 30 de abril de 2026. Passar este valor com Claude Sonnet 4.5 ou Sonnet 4 não tem efeito, e requisições que excedem a janela de contexto padrão de 200k-token retornam um erro. Para usar uma janela de contexto de 1M-token, migre para [Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 ou Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), que incluem contexto de 1M a preço padrão sem header beta necessário.4904 O beta `context-1m-2025-08-07` foi descontinuado a partir de 30 de abril de 2026. Passar este valor com Claude Sonnet 4.5 ou Sonnet 4 não tem efeito, e requisições que excedem a janela de contexto padrão de 200k-token retornam um erro. Para usar uma janela de contexto de 1M-token, migre para [Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 ou Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), que incluem contexto de 1M a preço padrão sem header beta necessário.

4891</Warning>4905</Warning>

4892 4906

4893<h3 id="slashcommand">4907<h3 id="slashcommand">

4902 description: string;4916 description: string;

4903 argumentHint: string;4917 argumentHint: string;

4904 aliases?: string[];4918 aliases?: string[];

4919 builtin?: boolean;

4905};4920};

4906```4921```

4907 4922

4923`builtin` é `true` em uma linha quando o comando é próprio do Claude Code e digitar `/name` o executa. Está ausente para um comando definido por um usuário, projeto, plugin ou servidor MCP, e para um comando agrupado que um desses [substitui por nome](/docs/pt/skills#resolve-skills-that-share-a-name). Requer Agent SDK v0.3.277 ou posterior.

4924

4908<h3 id="modelinfo">4925<h3 id="modelinfo">

4909 `ModelInfo`4926 `ModelInfo`

4910</h3>4927</h3>

5011 destructive?: boolean;5028 destructive?: boolean;

5012 openWorld?: boolean;5029 openWorld?: boolean;

5013 };5030 };

5031 _meta?: Record<string, unknown>;

5014 }[];5032 }[];

5015};5033};

5016```5034```

5017 5035

5018`source` diz de onde a definição do servidor veio, com os mesmos valores e regra de confiança que o `source` de [`McpServerProvenance`](#mcpserverprovenance). O campo requer Agent SDK v0.3.274 ou posterior e está ausente em versões anteriores.5036`source` diz de onde a definição do servidor veio, com os mesmos valores e regra de confiança que o `source` de [`McpServerProvenance`](#mcpserverprovenance). O campo requer Agent SDK v0.3.274 ou posterior e está ausente em versões anteriores.

5019 5037

5038`_meta` em uma entrada `tools` carrega os membros MCP Apps de `_meta` dessa ferramenta, para que sua aplicação possa encontrar o recurso `ui://` para renderizar com [`readMcpResource()`](#query-object). Claude Code passa através do objeto `ui` e da string `ui/resourceUri` plana descontinuada, e retém todas as outras chaves. Dentro de `ui`, `resourceUri` é uma string `ui://` e `visibility` um array de `"model"` e `"app"` quando o servidor os define, e qualquer outro membro passa através inalterado. Claude Code descarta qualquer chave quando o valor é malformado, e omite `_meta` de uma ferramenta que não declara nenhum. O campo está presente apenas quando o [`capabilities`](#sdksystemmessage) da mensagem init incluem `mcp_tool_ui_meta_v1`, e requer TypeScript Agent SDK v0.3.280 ou posterior.

5039

5020<h3 id="mcpserverstatusconfig">5040<h3 id="mcpserverstatusconfig">

5021 `McpServerStatusConfig`5041 `McpServerStatusConfig`

5022</h3>5042</h3>

5761```5781```

5762 5782

5764| :-------------------------- | :---------------------------------------------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |5784| :-------------------------- | :---------------------------------------------------- | :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

5766| `failIfUnavailable` | `boolean` | `true` | Parar na inicialização se `enabled` for `true` mas o sandbox não conseguir iniciar. Defina como `false` para fazer fallback para execução sem sandbox com um aviso em stderr |5786| `failIfUnavailable` | `boolean` | `true` | Parar na inicialização se `enabled` for `true` mas o sandbox não conseguir iniciar. Defina como `false` para fazer fallback para execução sem sandbox com um aviso em stderr |

5768| `excludedCommands` | `string[]` | `[]` | Comandos que sempre contornam restrições de sandbox (por exemplo, `['docker']`). Esses são executados sem sandbox automaticamente sem envolvimento do modelo |5788| `excludedCommands` | `string[]` | `[]` | Comandos que contornam restrições de sandbox, como `['docker *']`. Esses são executados sem sandbox automaticamente sem envolvimento do modelo; [`sandbox.excludedCommands`](/docs/pt/settings-reference#sandbox-excludedcommands) cobre quando uma entrada se aplica |

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

5872 Fallback de Permissões para Comandos Sem Sandbox5892 Fallback de Permissões para Comandos Sem Sandbox

5873</h3>5893</h3>

5874 5894

5875Quando `allowUnsandboxedCommands` está habilitado, o modelo pode solicitar executar comandos fora do sandbox definindo `dangerouslyDisableSandbox: true` na entrada da ferramenta. Essas solicitações fazem fallback para o sistema de permissões existente, significando que seu manipulador `canUseTool` é invocado, permitindo que você implemente lógica de autorização personalizada. Comandos listados em `excludedCommands` em vez disso contornam o sandbox automaticamente, sem envolvimento do modelo; veja [`SandboxSettings`](#sandboxsettings).5895Quando `allowUnsandboxedCommands` está habilitado, o modelo pode solicitar executar comandos fora do sandbox definindo `dangerouslyDisableSandbox: true` na entrada da ferramenta. Essas solicitações fazem fallback para o sistema de permissões existente, significando que seu manipulador `canUseTool` é invocado, permitindo que você implemente lógica de autorização personalizada.

5896

5897Suas entradas `excludedCommands` em vez disso contornam o sandbox com nenhum envolvimento do modelo; [`sandbox.excludedCommands`](/docs/pt/settings-reference#sandbox-excludedcommands) cobre quando uma entrada se aplica.

5876 5898

5877No exemplo abaixo, `isCommandAuthorized` representa uma verificação de autorização que você define.5899No exemplo abaixo, `isCommandAuthorized` representa uma verificação de autorização que você define.

5878 5900

agent-teams.md +0 −4

Details

14 14

15Antes de configurar uma equipe, verifique se uma opção mais leve faz o trabalho. [Subagents](/docs/pt/sub-agents) funcionam dentro de uma única sessão, e com [mensagens entre sessões](/docs/pt/cross-session-messaging) Claude pode passar descobertas entre as sessões que você executa por conta própria.15Antes de configurar uma equipe, verifique se uma opção mais leve faz o trabalho. [Subagents](/docs/pt/sub-agents) funcionam dentro de uma única sessão, e com [mensagens entre sessões](/docs/pt/cross-session-messaging) Claude pode passar descobertas entre as sessões que você executa por conta própria.

16 16

~~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](/docs/pt/hooks#taskcreated) carrega o nome derivado da sessão e está descontinuado.

~~19</Note>~~

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

22 Quando usar equipes de agentes18 Quando usar equipes de agentes

23</h2>19</h2>

amazon-bedrock.md +6 −6

Details

291 291

292Defina estas variáveis de ambiente para IDs de modelo específicos do Amazon Bedrock.292Defina estas variáveis de ambiente para IDs de modelo específicos do Amazon Bedrock.

293 293

294Sem `ANTHROPIC_DEFAULT_OPUS_MODEL`, o alias `opus` no Amazon Bedrock resolve para Opus 5, e sem `ANTHROPIC_DEFAULT_SONNET_MODEL`, o alias `sonnet` resolve para Sonnet 4.5. Este exemplo fixa cada alias para uma versão específica:294Sem `ANTHROPIC_DEFAULT_OPUS_MODEL`, o alias `opus` no Amazon Bedrock resolve para Opus 5.5, e sem `ANTHROPIC_DEFAULT_SONNET_MODEL`, o alias `sonnet` resolve para Sonnet 4.5. Este exemplo fixa cada alias para uma versão específica:

295 295

296```bash theme={null}296```bash theme={null}

297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'

304Para manter os modelos padrão integrados e alterar apenas seu prefixo preferido, defina [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) em vez de fixar. A diferença aparece no que o alias `opus` resolve para:304Para manter os modelos padrão integrados e alterar apenas seu prefixo preferido, defina [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) em vez de fixar. A diferença aparece no que o alias `opus` resolve para:

305 305

307| :------------------------------------------------------------ | :------------------------------------------------------------------------- |307| :------------------------------------------------------------ | :--------------------------------------------------------------------------- |

308| `ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` | `us.anthropic.claude-opus-4-8`, o ID exato que você fixou |308| `ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` | `us.anthropic.claude-opus-4-8`, o ID exato que você fixou |

310 310

311Para IDs de modelo atuais e legados, veja [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Para a lista completa de variáveis de ambiente de fixação, veja [Configuração de modelo](/docs/pt/model-config#pin-models-for-third-party-deployments).311Para IDs de modelo atuais e legados, veja [Visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Para a lista completa de variáveis de ambiente de fixação, veja [Configuração de modelo](/docs/pt/model-config#pin-models-for-third-party-deployments).

312 312

314 314

315| Tipo de modelo | Modelo padrão |315| Tipo de modelo | Modelo padrão |

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

319 319

320Tarefas 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 Amazon Bedrock, Claude Code usa o modelo Sonnet padrão para tarefas em segundo plano porque Haiku pode não estar habilitado em todas as contas ou regiões. Duas seleções mudam qual modelo as carrega:320Tarefas 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 Amazon Bedrock, Claude Code usa o modelo Sonnet padrão para tarefas em segundo plano porque Haiku pode não estar habilitado em todas as contas ou regiões. Duas seleções mudam qual modelo as carrega:

326 Os modelos Opus têm um preço por token mais alto do que os 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.326 Os modelos Opus têm um preço por token mais alto do que os 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.

327</Warning>327</Warning>

328 328

329Na v2.1.207 através v2.1.218, o modelo primário no Amazon Bedrock era padrão para Opus 4.8 e o alias `opus` resolveu para Opus 4.8. Antes da v2.1.207, o modelo primário era padrão para Sonnet 4.5, o alias `opus` resolveu para Opus 4.6, e as tarefas em segundo plano sempre usavam o modelo primário.329Antes da v2.1.280, o modelo primário no Amazon Bedrock era padrão para Opus 5 e o alias `opus` resolveu para Opus 5 a partir da v2.1.219. Na v2.1.207 através v2.1.218, o modelo primário no Amazon Bedrock era padrão para Opus 4.8 e o alias `opus` resolveu para Opus 4.8. Antes da v2.1.207, o modelo primário era padrão para Sonnet 4.5, o alias `opus` resolveu para Opus 4.6, e as tarefas em segundo plano sempre usavam o modelo primário.

330 330

331Para personalizar modelos ainda mais, use um destes métodos:331Para personalizar modelos ainda mais, use um destes métodos:

332 332

405```bash theme={null}405```bash theme={null}

406export ANTHROPIC_BEDROCK_REGION_PREFIX=global406export ANTHROPIC_BEDROCK_REGION_PREFIX=global

407# Em uma região us-*, o modelo primário agora resolve para407# Em uma região us-*, o modelo primário agora resolve para

408# global.anthropic.claude-opus-5 em vez de us.anthropic.claude-opus-5408# global.anthropic.claude-opus-5-5 em vez de us.anthropic.claude-opus-5-5

409```409```

410 410

411O prefixo preferido é uma preferência, não uma garantia, quer venha de sua região ou da variável. Como Claude Code o aplica depende de se ele pode verificar a disponibilidade do perfil em sua conta:411O prefixo preferido é uma preferência, não uma garantia, quer venha de sua região ou da variável. Como Claude Code o aplica depende de se ele pode verificar a disponibilidade do perfil em sua conta:

artifacts.md +2 −2

Details

347Artefatos exigem todas as condições abaixo. Quando uma não é atendida, Claude escreve um arquivo HTML local ou diz que não pode publicar.347Artefatos exigem todas as condições abaixo. Quando uma não é atendida, Claude escreve um arquivo HTML local ou diz que não pode publicar.

348 348

349| Requisito | Disponível quando |349| Requisito | Disponível quando |

350| :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |350| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

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

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

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

355| 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. |355| Superfície | Claude Code CLI 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. |

356 356

357<h2 id="disable-artifacts">357<h2 id="disable-artifacts">

358 Desabilitar artefatos358 Desabilitar artefatos

authentication.md +2 −2

Details

53 53

54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) fornecem a melhor experiência para organizações usando Claude Code. Os membros da equipe obtêm acesso tanto ao Claude Code quanto ao Claude na web com faturamento centralizado e gerenciamento de equipe.54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) fornecem a melhor experiência para organizações usando Claude Code. Os membros da equipe obtêm acesso tanto ao Claude Code quanto ao Claude na web com faturamento centralizado e gerenciamento de equipe.

55 55

~~56* **Claude for Teams**: plano de autoatendimento com recursos de colaboração, ferramentas de administração e gerenciamento de faturamento. Melhor para equipes menores.~~56* **Claude for Teams**: plano de autoatendimento com recursos de colaboração, ferramentas de administração, SSO, gerenciamento de faturamento e [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) para configuração de Claude Code em toda a organização. Melhor para equipes menores.

57* **Claude for Enterprise**: adiciona SSO, captura de domínio, permissões baseadas em funções, API de conformidade e configurações de política gerenciada para configurações de Claude Code em toda a organização. Melhor para organizações maiores com requisitos de segurança e conformidade.57* **Claude for Enterprise**: adiciona captura de domínio, permissões baseadas em funções e a API de conformidade. Melhor para organizações maiores com requisitos de segurança e conformidade.

58 58

59<Steps>59<Steps>

60 <Step title="Assine">60 <Step title="Assine">

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

Details

250 250

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

252 252

253* **`/model`, `/effort`, `/color` e `/rename`**: passe o valor como um argumento, por exemplo `/model sonnet`, em vez de abrir o seletor do terminal ou controle deslizante. Os formulários de argumento exigem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as [notas de disponibilidade](/docs/pt/commands#all-commands) de cada comando: `/effort` relata `Not applied` enquanto um [launch-default effort hold](/docs/pt/model-config#adjust-effort-level) do modelo está em vigor.253* **`/model`, `/effort`, `/color` e `/rename`**: passe o valor como um argumento, por exemplo `/model sonnet`, em vez de abrir o seletor do terminal ou controle deslizante. Os formulários de argumento exigem Claude Code v2.1.205 ou posterior no ambiente da sessão e seguem as [notas de disponibilidade](/docs/pt/commands#all-commands) de cada comando.

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

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

256 256

claude-directory.md +26 −8

Details

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

1452 1452

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

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

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

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

1459 1459

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

1461 1461

1516| [`themes/*.json`](#ce-themes) | Apenas global | | Temas de cores personalizados | [Temas personalizados](/docs/pt/terminal-config#create-a-custom-theme) |1516| [`themes/*.json`](#ce-themes) | Apenas global | | Temas de cores personalizados | [Temas personalizados](/docs/pt/terminal-config#create-a-custom-theme) |

1517 1517

1518<h2 id="frontmatter-fields-by-file">

1519 Campos de frontmatter por arquivo

1520</h2>

1521

1522Skills, arquivos de comando, subagentes, estilos de saída e regras leem sua configuração do YAML [frontmatter](/docs/pt/glossary#frontmatter) no topo do arquivo, e cada um aceita seu próprio conjunto de campos. Esta tabela lista os nomes dos campos para cada arquivo e vincula à referência que os descreve.

1523

1524| Arquivo | Campos de frontmatter | Referência |

1525| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |

1526| `skills/<name>/SKILL.md` | `name`, `description`, `when_to_use`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `disallowed-tools`, `model`, `effort`, `context`, `agent`, `background`, `hooks`, `paths`, `shell`, `metadata`, `license`, `compatibility` | [Frontmatter de skill](/docs/pt/skills#frontmatter-reference) |

1527| `commands/*.md` | Os campos de skill exceto `name` e `paths` | [Frontmatter de skill](/docs/pt/skills#frontmatter-reference) |

1528| `agents/*.md` | `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental` | [Frontmatter de subagente](/docs/pt/sub-agents#supported-frontmatter-fields) |

1529| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [Frontmatter de estilo de saída](/docs/pt/output-styles#frontmatter) |

1530| `rules/*.md` | `paths` | [Frontmatter de regra](/docs/pt/memory#rules-frontmatter-reference) |

1531

1532Agentes fornecidos em um [plugin](/docs/pt/plugins-reference#plugin-agent-frontmatter) honram um subconjunto dos campos de subagente.

1533

1518<h2 id="troubleshoot-configuration">1534<h2 id="troubleshoot-configuration">

1519 Solucione problemas de configuração1535 Solucione problemas de configuração

1520</h2>1536</h2>

1534Claude Code deleta os arquivos nos caminhos abaixo uma vez que tenham mais de [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) de idade, desde que possa determinar com segurança o período de retenção. O padrão é 30 dias e o mínimo é 1; definir `0` falha com um erro de validação. O mesmo limite de idade se aplica à remoção automática de [worktrees órfãs](/docs/pt/worktrees#clean-up-subagent-and-background-session-worktrees).1550Claude Code deleta os arquivos nos caminhos abaixo uma vez que tenham mais de [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) de idade, desde que possa determinar com segurança o período de retenção. O padrão é 30 dias e o mínimo é 1; definir `0` falha com um erro de validação. O mesmo limite de idade se aplica à remoção automática de [worktrees órfãs](/docs/pt/worktrees#clean-up-subagent-and-background-session-worktrees).

1535 1551

1537| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1553| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1538| `projects/<project>/<session>.jsonl` | Transcrição completa da conversa: cada mensagem, chamada de ferramenta e resultado de ferramenta |1554| `projects/<project>/<session>.jsonl` | Transcrição completa da conversa: cada mensagem, chamada de ferramenta e resultado de ferramenta |

1539| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Uma transcrição anterior da sessão que Claude Code separou em vez de sobrescrever ou deletar. Não aparece no seletor de sessão |1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Uma transcrição anterior da sessão que Claude Code separou em vez de sobrescrever ou deletar. Não aparece no seletor de sessão |

1540| `projects/<project>/<session>/subagents/` | Transcrições de conversa de [Subagent](/docs/pt/sub-agents), removidas com a transcrição da sessão pai quando envelhece |1556| `projects/<project>/<session>/subagents/` | Transcrições de conversa de [Subagent](/docs/pt/sub-agents), removidas com a transcrição da sessão pai quando envelhece |

1543| `plans/` | Arquivos de plano escritos durante [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) |1559| `plans/` | Arquivos de plano escritos durante [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) |

1544| `debug/` | Logs de debug por sessão, escritos enquanto o debug logging está ativado, como quando você inicia com [`--debug`](/docs/pt/cli-reference#cli-flags) ou executa `/debug` |1560| `debug/` | Logs de debug por sessão, escritos enquanto o debug logging está ativado, como quando você inicia com [`--debug`](/docs/pt/cli-reference#cli-flags) ou executa `/debug` |

1546| `image-cache/<session>/` | Imagens anexadas. Em cada varredura, Claude Code remove os diretórios de todas as outras sessões, independentemente da idade. |1562| `image-cache/<session>/` | Imagens anexadas salvas por Claude Code v2.1.274 e anteriores. Versões posteriores salvam imagens coladas e anexadas fora de `~/.claude`, em um diretório `images/` para cada sessão sob o diretório temporário que [`CLAUDE_CODE_TMPDIR`](/docs/pt/env-vars) controla. A varredura remove diretórios restantes de outras sessões aqui, independentemente da idade. |

1547| `uploads/<session>/` | Arquivos que você anexa da web ou do aplicativo móvel, e fotos que você anexa do aplicativo móvel, ao enviar mensagens para uma sessão de [Remote Control](/docs/pt/remote-control). Um anexo a uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) é salvo no próprio ambiente em nuvem dessa sessão, não na sua máquina. |1563| `uploads/<session>/` | Arquivos que você anexa da web ou do aplicativo móvel, e fotos que você anexa do aplicativo móvel, ao enviar mensagens para uma sessão de [Remote Control](/docs/pt/remote-control). Um anexo a uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) é salvo no próprio ambiente em nuvem dessa sessão, não na sua máquina. |

1552| `feedback-bundles/` | Arquivos de transcrição reduzidos escritos por `/feedback` em provedores de terceiros ou quando nenhuma credencial Anthropic está configurada, para enviar à sua equipe de conta Anthropic |1568| `feedback-bundles/` | Arquivos de transcrição reduzidos escritos por `/feedback` em provedores de terceiros ou quando nenhuma credencial Anthropic está configurada, para enviar à sua equipe de conta Anthropic |

1553| `feedback/drafts/` | [Feedback redigido por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior) enfileirado aguardando sua revisão em `/feedback`. Varrido após `cleanupPeriodDays` ou 30 dias, o que for menor. Quando a fila está no seu limite de 10 rascunhos, Claude Code deleta o rascunho mais antigo para liberar espaço. |1569| `feedback/drafts/` | [Feedback redigido por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior) enfileirado aguardando sua revisão em `/feedback`. Varrido após `cleanupPeriodDays` ou 30 dias, o que for menor. Quando a fila está no seu limite de 10 rascunhos, Claude Code deleta o rascunho mais antigo para liberar espaço. |

1554| `usage-data/` | `report.html` e cópias de relatório com timestamp escritas por [`/insights`](/docs/pt/costs#analyze-your-usage-patterns), mais dados de análise em cache por sessão usados para construí-los |1570| `usage-data/` | `report.html` e cópias de relatório com timestamp escritas por [`/insights`](/docs/pt/costs#analyze-your-usage-patterns), mais dados de análise em cache por sessão usados para construí-los |

1555| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/pt/skills#how-synced-skills-behave) e [plugins](/docs/pt/plugins-reference#synced-plugins) sincronizados de claude.ai que Claude Code removeu. Movidos aqui em vez de deletados para que você possa recuperar os arquivos |1571| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/pt/skills#how-synced-skills-behave) e [plugins](/docs/pt/plugins-reference#synced-plugins) que a sincronização de claude.ai removeu, como depois que você desativa um em claude.ai ou para de sincronizar. Os arquivos ficam aqui para que você possa recuperá-los até a varredura deletá-los |

1556| `todos/`, `statsig/`, `logs/` | Diretórios legados de versões mais antigas. Não são mais escritos. A varredura remove seu conteúdo e depois o diretório vazio. |1572| `todos/`, `statsig/`, `logs/` | Diretórios legados de versões mais antigas. Não são mais escritos. A varredura remove seu conteúdo e depois o diretório vazio. |

1557 1573

1558Arquivos de sessão em `sessions/`, memória automática, e transcrições de Claude Desktop e Cowork seguem cada uma sua própria regra de retenção:1574Arquivos de sessão em `sessions/`, memória automática, e transcrições de Claude Desktop e Cowork seguem cada uma sua própria regra de retenção:

1610* Linhas de prompt correspondentes em `history.jsonl`1626* Linhas de prompt correspondentes em `history.jsonl`

1611* A entrada do projeto em `~/.claude.json`1627* A entrada do projeto em `~/.claude.json`

1612 1628

1629Imagens que você colou ou anexou nas sessões do projeto são armazenadas sob o diretório temporário de Claude Code em vez de `~/.claude`, então a limpeza não as remove. A [varredura de retenção](#cleaned-up-automatically) as deleta uma vez que tenham mais de `cleanupPeriodDays` de idade.

1630

1613O comando imprime o plano completo de exclusão e pede confirmação antes de remover qualquer coisa.1631O comando imprime o plano completo de exclusão e pede confirmação antes de remover qualquer coisa.

1614 1632

1615Os exemplos abaixo usam `~/work/my-repo` como um espaço reservado. Substitua-o pelo caminho para seu projeto. Se nenhum estado corresponder ao caminho, o comando imprime um erro e sai com status 1.1633Os exemplos abaixo usam `~/work/my-repo` como um espaço reservado. Substitua-o pelo caminho para seu projeto. Se nenhum estado corresponder ao caminho, o comando imprime um erro e sai com status 1.

1660Você também pode deletar qualquer um dos caminhos de dados da aplicação acima manualmente, além dos [arquivos de estado para manter](#state-files-to-keep). Novas sessões não são afetadas. A tabela abaixo mostra o que você perde para sessões passadas.1678Você também pode deletar qualquer um dos caminhos de dados da aplicação acima manualmente, além dos [arquivos de estado para manter](#state-files-to-keep). Novas sessões não são afetadas. A tabela abaixo mostra o que você perde para sessões passadas.

1661 1679

1662| Deletar | Você perde |1680| Deletar | Você perde |

1663| ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1681| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1665| `~/.claude/history.jsonl` | Recall de prompt com seta para cima, busca de histórico `Ctrl+R` e conclusão de comando shell `!` |1683| `~/.claude/history.jsonl` | Recall de prompt com seta para cima, busca de histórico `Ctrl+R` e conclusão de comando shell `!` |

1666| `~/.claude/paste-cache/` | Texto colado em prompts recuperados; veja [colar conteúdo grande](/docs/pt/terminal-config#paste-large-content) |1684| `~/.claude/paste-cache/` | Texto colado em prompts recuperados; veja [colar conteúdo grande](/docs/pt/terminal-config#paste-large-content) |

1677| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | A chance de recuperar [skills sincronizadas](/docs/pt/skills#how-synced-skills-behave) e [plugins sincronizados](/docs/pt/plugins-reference#synced-plugins) que Claude Code removeu |1695| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | A chance de recuperar [skills sincronizadas](/docs/pt/skills#how-synced-skills-behave) e [plugins sincronizados](/docs/pt/plugins-reference#synced-plugins) que Claude Code removeu |

1678| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/image-cache/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Nada voltado para o usuário |1696| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Nada voltado para o usuário |

1679| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/` | Nada. Diretórios legados não escritos pelas versões atuais. |1697| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Nada. Diretórios legados não escritos pelas versões atuais. |

1680 1698

1681Não delete `~/.claude.json`, `~/.claude/settings.json` ou `~/.claude/plugins/`: esses mantêm sua autenticação, preferências e plugins instalados.1699Não delete `~/.claude.json`, `~/.claude/settings.json` ou `~/.claude/plugins/`: esses mantêm sua autenticação, preferências e plugins instalados.

1682 1700

claude-platform-on-aws.md +1 −1

Details

284 284

285Claude Platform on AWS usa os mesmos IDs de modelo que a API Claude direta.285Claude Platform on AWS usa os mesmos IDs de modelo que a API Claude direta.

286 286

287Os 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 5. Antes da v2.1.219, ele resolvia para Opus 4.8, e antes da v2.1.207 para Opus 4.7.287Os 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 5.5. Antes da v2.1.280, ele resolvia para Opus 5 a partir da v2.1.219, para Opus 4.8 a partir da v2.1.207 e para Opus 4.7 antes disso.

288 288

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

290 290

claude-projects.md +7 −7

Details

56* **Threads**: os trabalhadores. Cada uma é uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) separada com sua própria janela de contexto que faz uma peça de trabalho em seu próprio branch, abre um pull request quando o trabalho exigir e relata de volta à conversa quando termina.56* **Threads**: os trabalhadores. Cada uma é uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) separada com sua própria janela de contexto que faz uma peça de trabalho em seu próprio branch, abre um pull request quando o trabalho exigir e relata de volta à conversa quando termina.

57* **O que cada thread começa com**:57* **O que cada thread começa com**:

58 * Os repositórios e arquivos do projeto, mais suas [instruções e memória](#give-a-project-standing-context)58 * Os repositórios e arquivos do projeto, mais suas [instruções e memória](#give-a-project-standing-context)

59 * O `CLAUDE.md`, skills e plugins em [cada um dos repositórios do projeto](#what-threads-pick-up-from-your-repositories), e em um projeto com um repositório, as regras de permissão e hooks desse repositório também59 * O `CLAUDE.md` e skills em [cada um dos repositórios do projeto](#what-threads-pick-up-from-your-repositories), e em um projeto com um repositório, as regras de permissão e hooks desse repositório também

60 * Os [connectors](#get-skills-plugins-connectors-and-tools-into-threads) na sua conta claude.ai60 * Os [connectors](#get-skills-plugins-connectors-and-tools-into-threads) na sua conta claude.ai

61 * Um [ambiente em nuvem](#choose-an-environment-for-threads) que define seu acesso à rede, variáveis de ambiente, credenciais de API e ferramentas instaladas61 * Um [ambiente em nuvem](#choose-an-environment-for-threads) que define seu acesso à rede, variáveis de ambiente, credenciais de API e ferramentas instaladas

62* **O painel Overview**: onde você [vê todas as threads de uma vez](#see-what-needs-you-in-overview) e quais delas precisam de você. Suas outras abas são **Library** para os arquivos que você adicionou e os arquivos que as threads produziram, **Pull requests** para os que as threads abriram, e **Routines** para trabalho agendado no projeto.62* **O painel Overview**: onde você [vê todas as threads de uma vez](#see-what-needs-you-in-overview) e quais delas precisam de você. Suas outras abas são **Library** para os arquivos que você adicionou e os arquivos que as threads produziram, **Pull requests** para os que as threads abriram, e **Routines** para trabalho agendado no projeto.

333 O que as threads pegam de seus repositórios333 O que as threads pegam de seus repositórios

334</h3>334</h3>

335 335

336Cada thread clona cada repositório no projeto e carrega `CLAUDE.md`, skills e plugins de todos eles. Regras de permissão, hooks e `env` vêm apenas do `.claude/settings.json` no diretório em que a thread começa: dentro do repositório quando o projeto tem um, e acima dos clones quando tem vários, onde nenhum arquivo de repositório é lido para eles.336Cada thread clona cada repositório no projeto e carrega `CLAUDE.md` e skills de todos eles. Regras de permissão, hooks e `env` vêm apenas do `.claude/settings.json` no diretório em que a thread começa: dentro do repositório quando o projeto tem um, e acima dos clones quando tem vários, onde nenhum arquivo de repositório é lido para eles.

337 337

339| :---------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |339| :---------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------ |

342| Plugins habilitados em `.claude/settings.json` | Carregado | Carregado de cada repositório. Se dois repositórios discordarem sobre um plugin, defina-o em **Project settings > Plugins**, que tem precedência |342| Plugins habilitados em `.claude/settings.json` | Não carregado. Adicione o plugin em **Project settings > Plugins** em vez disso | Não carregado. Adicione o plugin em **Project settings > Plugins** em vez disso |

343| Regras de permissão, hooks e `env` definidos em `.claude/settings.json` | Aplicam-se à thread, exceto as chaves `env` que [nenhuma sessão em nuvem honra](/docs/pt/cloud-environments#what-carries-over-from-your-setup) | Não se aplicam |343| Regras de permissão, hooks e `env` definidos em `.claude/settings.json` | Aplicam-se à thread, exceto as chaves `env` que [nenhuma sessão em nuvem honra](/docs/pt/cloud-environments#what-carries-over-from-your-setup) | Não se aplicam |

344 344

345Em um projeto com vários repositórios, cada clone é anexado à thread como um [diretório adicional](/docs/pt/memory#load-from-additional-directories) com carregamento de `CLAUDE.md` ligado, é por isso que o `CLAUDE.md` e skills de cada repositório carregam no início mesmo que a thread comece acima deles. Em qualquer caso, hooks que um plugin habilitado fornece ainda são executados, já que plugins carregam de cada repositório. Em um projeto com vários repositórios, coloque regras permanentes em instruções do projeto e dê às threads variáveis de ambiente através do [ambiente em nuvem](#choose-an-environment-for-threads).345Em um projeto com vários repositórios, cada clone é anexado à thread como um [diretório adicional](/docs/pt/memory#load-from-additional-directories) com carregamento de `CLAUDE.md` ligado, é por isso que o `CLAUDE.md` e skills de cada repositório carregam no início mesmo que a thread comece acima deles. Em tal projeto, coloque regras permanentes em instruções do projeto e dê às threads variáveis de ambiente através do [ambiente em nuvem](#choose-an-environment-for-threads).

346 346

347<h3 id="choose-an-environment-for-threads">347<h3 id="choose-an-environment-for-threads">

348 Escolher um ambiente para threads348 Escolher um ambiente para threads

359As threads são sessões em nuvem, então não têm os skills, servidores MCP, plugins e ferramentas instalados apenas na sua máquina. Para disponibilizar cada um desses para threads:359As threads são sessões em nuvem, então não têm os skills, servidores MCP, plugins e ferramentas instalados apenas na sua máquina. Para disponibilizar cada um desses para threads:

360 360

361* Skills, subagentes e comandos: confirme-os em um repositório que você adicionou ao projeto, por exemplo um skill em `.claude/skills/<skill-name>/SKILL.md`. Cada thread clona cada repositório no projeto e carrega `.claude/skills/`, `.claude/agents/` e `.claude/commands/` de cada um deles, então um skill confirmado em um repositório está disponível em cada nova thread. As threads também carregam os skills que você habilita para sua conta claude.ai.361* Skills, subagentes e comandos: confirme-os em um repositório que você adicionou ao projeto, por exemplo um skill em `.claude/skills/<skill-name>/SKILL.md`. Cada thread clona cada repositório no projeto e carrega `.claude/skills/`, `.claude/agents/` e `.claude/commands/` de cada um deles, então um skill confirmado em um repositório está disponível em cada nova thread. As threads também carregam os skills que você habilita para sua conta claude.ai.

362* Plugins: adicione-os em **Project settings > Plugins**; eles carregam em cada nova thread. Plugins que um repositório declara em seu `.claude/settings.json` também carregam; veja [O que se carrega de sua configuração](/docs/pt/cloud-environments#what-carries-over-from-your-setup).362* Plugins: adicione-os em **Project settings > Plugins**; eles carregam em cada nova thread. Plugins que um repositório declara em seu `.claude/settings.json` [não carregam em threads](/docs/pt/cloud-environments#what-carries-over-from-your-setup), porque threads são sessões em nuvem.

363* Servidores MCP: as threads obtêm suas ferramentas MCP dos connectors em sua conta claude.ai, que são servidores MCP que você conecta uma vez em [claude.ai/customize/connectors](https://claude.ai/customize/connectors) ou através do link **Manage connectors** em **Project settings > Environment**. Cada thread pode usar todos eles sem configuração por projeto. A conversa do projeto em si não tem connectors, então envie trabalho que precisa de um como uma tarefa para uma thread. Em um projeto com um repositório, as threads também carregam servidores MCP do [`.mcp.json`](/docs/pt/cloud-environments#what-carries-over-from-your-setup) desse repositório. [Como connectors alcançam Claude Code](/docs/pt/mcp#how-connectors-reach-claude-code) lista as regras para sessões em nuvem e as configurações que desligam connectors.363* Servidores MCP: as threads obtêm suas ferramentas MCP dos connectors em sua conta claude.ai, que são servidores MCP que você conecta uma vez em [claude.ai/customize/connectors](https://claude.ai/customize/connectors) ou através do link **Manage connectors** em **Project settings > Environment**. Cada thread pode usar todos eles sem configuração por projeto. A conversa do projeto em si não tem connectors, então envie trabalho que precisa de um como uma tarefa para uma thread. Em um projeto com um repositório, as threads também carregam servidores MCP do [`.mcp.json`](/docs/pt/cloud-environments#what-carries-over-from-your-setup) desse repositório. [Como connectors alcançam Claude Code](/docs/pt/mcp#how-connectors-reach-claude-code) lista as regras para sessões em nuvem e as configurações que desligam connectors.

364* Ferramentas de linha de comando e pacotes: instale-os no [script de configuração](/docs/pt/cloud-environments#setup-scripts) do ambiente.364* Ferramentas de linha de comando e pacotes: instale-os no [script de configuração](/docs/pt/cloud-environments#setup-scripts) do ambiente.

365 365

366Para ver quais connectors uma thread em execução tem em claude.ai/code, abra a thread e selecione **Connectors** no menu **+** ao lado de sua caixa de mensagem. Desligar um connector lá o remove dessa thread, e permanece desligado para threads iniciadas depois até que você o ligue novamente. Uma thread pega um connector que você adiciona ou reconecta após a próxima mensagem que você envia a ela.366Para ver quais connectors uma thread em execução tem em claude.ai/code, abra a thread e selecione **Connectors** no menu **+** ao lado de sua caixa de mensagem. Desligar um connector lá o remove dessa thread e salva isso como seu padrão de conta, então novas threads e chats claude.ai começam sem ele até que você o ligue novamente. Uma thread pega um connector que você adiciona ou reconecta após a próxima mensagem que você envia a ela.

367 367

368<h2 id="project-settings-reference">368<h2 id="project-settings-reference">

369 Referência de configurações do projeto369 Referência de configurações do projeto

cli-reference.md +5 −3

Details

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

61 61

63| :---------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |63| :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

64| `--add-dir` | Adicionar diretórios de trabalho adicionais para Claude ler e editar arquivos. Concede acesso a arquivos; Claude Code [não descobre](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) a maioria da configuração `.claude/` desses diretórios. Valida se cada caminho existe como um diretório. Você não pode adicionar a maioria dos [caminhos de rede](/docs/pt/errors#working-directory-is-a-network-path), como `\\server\share`. Para persistir esses diretórios entre sessões, defina [`permissions.additionalDirectories`](/docs/pt/settings-reference#permissions-additionaldirectories) nas configurações | `claude --add-dir ../apps ../lib` |64| `--add-dir` | Adicionar diretórios de trabalho adicionais para Claude ler e editar arquivos. Concede acesso a arquivos; Claude Code [não descobre](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) a maioria da configuração `.claude/` desses diretórios. Valida se cada caminho existe como um diretório. Você não pode adicionar a maioria dos [caminhos de rede](/docs/pt/errors#working-directory-is-a-network-path), como `\\server\share`. Para persistir esses diretórios entre sessões, defina [`permissions.additionalDirectories`](/docs/pt/settings-reference#permissions-additionaldirectories) nas configurações | `claude --add-dir ../apps ../lib` |

65| `--advisor <model>` | Ativar a [ferramenta advisor](/docs/pt/advisor) do lado do servidor para esta sessão com um alias de modelo, `fable`, `opus` ou `sonnet`, ou um ID de modelo completo. Tem precedência sobre a configuração `advisorModel` para a sessão. `fable` requer [acesso a Fable](/docs/pt/advisor#choose-an-advisor-model) | `claude --advisor opus` |65| `--advisor <model>` | Ativar a [ferramenta advisor](/docs/pt/advisor) do lado do servidor para esta sessão com um alias de modelo, `fable`, `opus` ou `sonnet`, ou um ID de modelo completo. Tem precedência sobre a configuração `advisorModel` para a sessão. `fable` requer [acesso a Fable](/docs/pt/advisor#choose-an-advisor-model) | `claude --advisor opus` |

93| `--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'` |93| `--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'` |

94| `--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-reference#fallbackmodel), que este sinalizador substitui | `claude --fallback-model sonnet,haiku` |94| `--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-reference#fallbackmodel), que este sinalizador substitui | `claude --fallback-model sonnet,haiku` |

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

96| `--forward-subagent-text` | Emitir blocos de texto e pensamento de [subagent](/docs/pt/sub-agents) no fluxo de saída como mensagens `assistant` e `user` com `parent_tool_use_id` definido, para que você possa reconstruir a transcrição de cada subagent. Sem este sinalizador, Claude Code omite os blocos de texto e pensamento de um subagent que é executado em [primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background). Requer `--print` e `--output-format stream-json`. Claude Code também encaminha mensagens de [subagents aninhados](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents), definindo `parent_tool_use_id` para o ID da chamada da ferramenta Agent que gerou cada um; isso requer Claude Code v2.1.219 ou posterior. A variável de ambiente [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/pt/env-vars) ativa o mesmo comportamento. Requer Claude Code v2.1.211 ou posterior | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |96| `--forward-subagent-text` | Emitir blocos de texto e pensamento de [subagent](/docs/pt/sub-agents) no fluxo de saída como mensagens `assistant` e `user` com `parent_tool_use_id` definido, para que você possa reconstruir a transcrição de cada subagent. Sem este sinalizador, Claude Code omite os blocos de texto e pensamento de um subagent que é executado em [primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background). Requer `--print` e `--output-format stream-json`. Claude Code também encaminha mensagens de [subagents aninhados](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents), definindo `parent_tool_use_id` para o ID da chamada da ferramenta Agent ou Skill que gerou cada um; isso requer Claude Code v2.1.219 ou posterior, e mensagens de subagents que uma skill bifurcada gera, e de skills bifurcadas aninhadas, requerem v2.1.275 ou posterior. A variável de ambiente [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/pt/env-vars) ativa o mesmo comportamento. Requer Claude Code v2.1.211 ou posterior | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |

97| `--from-pr` | Abrir o seletor de sessão filtrado para 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` |97| `--from-pr` | Abrir o seletor de sessão filtrado para 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` |

98| `--ide` | Conectar automaticamente ao IDE na inicialização se exatamente um IDE válido estiver disponível | `claude --ide` |98| `--ide` | Conectar automaticamente ao IDE na inicialização se exatamente um IDE válido estiver disponível | `claude --ide` |

104| `--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 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |104| `--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 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

105| `--maintenance` | Executar hooks de [Setup](/docs/pt/hooks#setup) com o matcher `maintenance` antes da sessão (apenas modo print) | `claude -p --maintenance "query"` |105| `--maintenance` | Executar hooks de [Setup](/docs/pt/hooks#setup) com o matcher `maintenance` antes da sessão (apenas modo print) | `claude -p --maintenance "query"` |

106| `--max-budget-usd` | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print). Gastos de [subagents](/docs/pt/sub-agents) contam para o limite. Uma vez que o gasto atinge o limite, gerar outro subagent falha com `Budget limit reached`, e Claude Code para subagents de fundo que ainda estão em execução; os comportamentos de aplicação de limite requerem Claude Code v2.1.217 ou posterior | `claude -p --max-budget-usd 5.00 "query"` |106| `--max-budget-usd` | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print). Gastos de [subagents](/docs/pt/sub-agents) contam para o limite. Quando você retorna a uma conversa com `--continue` ou `--resume`, totais [restaurados de execuções anteriores](/docs/pt/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) não contam para isso. Uma vez que o gasto atinge o limite, gerar outro subagent falha com `Budget limit reached`, e Claude Code para subagents de fundo que ainda estão em execução; os comportamentos de aplicação de limite requerem Claude Code v2.1.217 ou posterior | `claude -p --max-budget-usd 5.00 "query"` |

107| `--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 ainda enfileirada quando o limite termina um turno permanece enfileirada e inicia um novo turno com seu próprio limite | `claude -p --max-turns 3 "query"` |107| `--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 ainda enfileirada quando o limite termina um turno permanece enfileirada e inicia um novo turno com seu próprio limite | `claude -p --max-turns 3 "query"` |

108| `--mcp-config` | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço). Quando você passa este sinalizador com `-p`, Claude Code aguarda servidores ainda pendentes se conectarem antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão; um servidor com uma [lista de ferramentas em cache](/docs/pt/mcp#managing-your-servers) pula a espera e se conecta no primeiro uso. A espera requer Claude Code v2.1.221 ou posterior | `claude --mcp-config ./mcp.json` |108| `--mcp-config` | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço). Quando você passa este sinalizador com `-p`, Claude Code aguarda servidores ainda pendentes se conectarem antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão; um servidor com uma [lista de ferramentas em cache](/docs/pt/mcp#managing-your-servers) pula a espera e se conecta no primeiro uso. A espera requer Claude Code v2.1.221 ou posterior | `claude --mcp-config ./mcp.json` |

109| `--model` | Define o modelo para a sessão atual com um [alias de modelo](/docs/pt/model-config#model-aliases) como `sonnet`, `opus`, `haiku` ou `fable`, ou o nome completo de um modelo. Substitui a configuração [`model`](/docs/pt/settings-reference#model) e [`ANTHROPIC_MODEL`](/docs/pt/model-config#environment-variables) | `claude --model claude-sonnet-5` |109| `--model` | Define o modelo para a sessão atual com um [alias de modelo](/docs/pt/model-config#model-aliases) como `sonnet`, `opus`, `haiku` ou `fable`, ou o nome completo de um modelo. Substitui a configuração [`model`](/docs/pt/settings-reference#model) e [`ANTHROPIC_MODEL`](/docs/pt/model-config#environment-variables) | `claude --model claude-sonnet-5` |

157 157

158`--system-prompt` e `--system-prompt-file` são mutuamente exclusivos. Os sinalizadores de anexação podem ser combinados com qualquer sinalizador de substituição.158`--system-prompt` e `--system-prompt-file` são mutuamente exclusivos. Os sinalizadores de anexação podem ser combinados com qualquer sinalizador de substituição.

159 159

160Quando o texto de substituição combina instruções que são as mesmas em cada execução com contexto que muda por execução, adicione uma linha contendo apenas `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` entre as instruções e o contexto. Claude Code divide o prompt na primeira linha assim e remove essa linha, portanto a parte acima dela permanece em cache enquanto a parte abaixo muda. Requer Claude Code v2.1.275 ou posterior. [Cache a parte estática de um prompt personalizado](/docs/pt/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) lista as configurações onde a divisão se aplica.

161

160Escolha 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.162Escolha 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.

161 163

162Para 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.164Para 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.

cloud-environments.md +2 −2

Details

301| Seu `.claude/rules/` do repositório | Sim | Parte do clone |301| Seu `.claude/rules/` do repositório | Sim | Parte do clone |

302| Seu `.claude/skills/`, `.claude/agents/`, `.claude/commands/` do repositório | Sim | Parte do clone |302| Seu `.claude/skills/`, `.claude/agents/`, `.claude/commands/` do repositório | Sim | Parte do clone |

303| Plugins declarados em `.claude/settings.json` | Sim | Instalados no início da sessão a partir do [marketplace](/docs/pt/plugin-marketplaces) que você declarou. Requer acesso à rede para alcançar a fonte do marketplace |303| Plugins e marketplaces declarados em seu `.claude/settings.json` do repositório | Não | Uma sessão na nuvem não instala os plugins que um repositório ativa em [`enabledPlugins`](/docs/pt/settings-reference#enabledplugins), incluindo aqueles dos marketplaces que lista em [`extraKnownMarketplaces`](/docs/pt/settings-reference#extraknownmarketplaces). Ative o plugin para sua conta claude.ai em vez disso, para que Claude Code o carregue como um [plugin sincronizado](/docs/pt/plugins-reference#synced-plugins) |

304| As [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) de sua organização | Sim | Buscadas dos servidores da Anthropic quando a sessão é iniciada. Veja [Cobertura de superfície](/docs/pt/model-config#surface-coverage) para como `availableModels` é aplicado em sessões na nuvem. As configurações implantadas em seu dispositivo através de MDM ou arquivos de configurações gerenciadas não se aplicam, porque a sessão é executada em uma VM gerenciada pela Anthropic; em um [ambiente auto-hospedado](/docs/pt/self-hosted-environments), as sessões também leem o arquivo de configurações gerenciadas na imagem do executor, por [como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) |304| As [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) de sua organização | Sim | Buscadas dos servidores da Anthropic quando a sessão é iniciada. Veja [Cobertura de superfície](/docs/pt/model-config#surface-coverage) para como `availableModels` é aplicado em sessões na nuvem. As configurações implantadas em seu dispositivo através de MDM ou arquivos de configurações gerenciadas não se aplicam, porque a sessão é executada em uma VM gerenciada pela Anthropic; em um [ambiente auto-hospedado](/docs/pt/self-hosted-environments), as sessões também leem o arquivo de configurações gerenciadas na imagem do executor, por [como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) |

305| Seu `~/.claude/CLAUDE.md` do usuário | Não | Vive em sua máquina, não no repositório |305| Seu `~/.claude/CLAUDE.md` do usuário | Não | Vive em sua máquina, não no repositório |

306| Seu `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` do usuário | Não | Vivem em sua máquina, não no repositório. Confirme-os no diretório `.claude/` do repositório em vez disso. As sessões na nuvem carregam automaticamente skills que você ativa em claude.ai |306| Seu `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` do usuário | Não | Vivem em sua máquina, não no repositório. Confirme-os no diretório `.claude/` do repositório em vez disso. As sessões na nuvem carregam automaticamente skills que você ativa em claude.ai |

307| Plugins ativados apenas em suas configurações de usuário | Não | O `enabledPlugins` com escopo de usuário vive em `~/.claude/settings.json`. Declare-os em `.claude/settings.json` do repositório em vez disso, ou ative-os para sua conta claude.ai para que Claude Code os carregue como [plugins sincronizados](/docs/pt/plugins-reference#synced-plugins) |307| Plugins ativados apenas em suas configurações de usuário | Não | O `enabledPlugins` com escopo de usuário vive em `~/.claude/settings.json` em sua máquina. Ative-os para sua conta claude.ai em vez disso, para que Claude Code os carregue como [plugins sincronizados](/docs/pt/plugins-reference#synced-plugins) |

308| Servidores MCP que você adicionou com `claude mcp add` no escopo local padrão ou no escopo de usuário | Não | Aqueles escrevem em `~/.claude.json` em sua máquina, não no repositório. Adicione o servidor com `claude mcp add --scope project`, que escreve o [`.mcp.json`](/docs/pt/mcp#project-scope) do repositório, e confirme esse arquivo. Uma sessão com um repositório o carrega |308| Servidores MCP que você adicionou com `claude mcp add` no escopo local padrão ou no escopo de usuário | Não | Aqueles escrevem em `~/.claude.json` em sua máquina, não no repositório. Adicione o servidor com `claude mcp add --scope project`, que escreve o [`.mcp.json`](/docs/pt/mcp#project-scope) do repositório, e confirme esse arquivo. Uma sessão com um repositório o carrega |

309| Variáveis de transporte em seu bloco `env` `.claude/settings.json` do repositório, como `NODE_EXTRA_CA_CERTS` e as [variáveis de certificado de cliente mTLS](/docs/pt/network-config#mtls-authentication) | Não | O ambiente de hospedagem gerencia a conexão de API da sessão, portanto Claude Code ignora essas chaves e anota cada chave ignorada no log de depuração da sessão |309| Variáveis de transporte em seu bloco `env` `.claude/settings.json` do repositório, como `NODE_EXTRA_CA_CERTS` e as [variáveis de certificado de cliente mTLS](/docs/pt/network-config#mtls-authentication) | Não | O ambiente de hospedagem gerencia a conexão de API da sessão, portanto Claude Code ignora essas chaves e anota cada chave ignorada no log de depuração da sessão |

310| Chaves de API e tokens para serviços que Claude chama | Em planos Pro e Max, como [credenciais de API](#add-api-credentials) | Você adiciona a chave uma vez no ambiente e o proxy do agente a anexa às solicitações para os hosts que você lista. Uma chave que o proxy do agente [não pode anexar](#requests-that-never-get-the-credential), ou qualquer chave em um plano Team ou Enterprise, fica em uma variável de ambiente |310| Chaves de API e tokens para serviços que Claude chama | Em planos Pro e Max, como [credenciais de API](#add-api-credentials) | Você adiciona a chave uma vez no ambiente e o proxy do agente a anexa às solicitações para os hosts que você lista. Uma chave que o proxy do agente [não pode anexar](#requests-that-never-get-the-credential), ou qualquer chave em um plano Team ou Enterprise, fica em uma variável de ambiente |

commands.md +76 −75

Details

26 26

27**Execute 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 terminaram. `/background` desanexa a sessão inteira para continuar executando como um [agente em segundo plano](/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 sua própria [worktree](/docs/pt/worktrees). Veja [Executar agentes em paralelo](/docs/pt/agents) para entender como essas abordagens se relacionam.27**Execute 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 terminaram. `/background` desanexa a sessão inteira para continuar executando como um [agente em segundo plano](/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 sua própria [worktree](/docs/pt/worktrees). Veja [Executar agentes em paralelo](/docs/pt/agents) para entender como essas abordagens se relacionam.

28 28

29**Antes de você enviar.** `/diff` mostra o que mudou. `/code-review` verifica o diff atual quanto a bugs de correção e limpezas e pode aplicar as descobertas com `--fix`; passe um número de PR, como `/code-review high 1234`, para revisar uma solicitação de pull. `/review` é um alias. `/code-review ultra` executa uma revisão multi-agente na nuvem. `/security-review` verifica o diff quanto a vulnerabilidades de segurança.29**Antes de você enviar.** `/diff` mostra o que mudou. `/code-review` verifica o diff atual quanto a bugs de correção e pode aplicar as descobertas com `--fix`; passe um número de PR, como `/code-review high 1234`, para revisar uma solicitação de pull. `/review` é um alias. `/code-review ultra` executa uma revisão multi-agente na nuvem. `/security-review` verifica o diff quanto a vulnerabilidades de segurança.

30 30

31**Entre sessões.** `/clear` começa do zero em uma nova tarefa mantendo a memória do projeto. `/resume` retorna a uma conversa anterior, `/branch` ramifica a atual para tentar uma direção diferente, e `/fork` a copia em uma nova [sessão em segundo plano](/docs/pt/agent-view). `/teleport` puxa uma sessão web para este terminal, e `/remote-control` permite que você continue esta sessão local de outro dispositivo.31**Entre sessões.** `/clear` começa do zero em uma nova tarefa mantendo a memória do projeto. `/resume` retorna a uma conversa anterior, `/branch` ramifica a atual para tentar uma direção diferente, e `/fork` a copia em uma nova [sessão em segundo plano](/docs/pt/agent-view). `/teleport` puxa uma sessão web para este terminal, e `/remote-control` permite que você continue esta sessão local de outro dispositivo.

32 32

40 40

41* **[Skill](/docs/pt/skills#bundled-skills)**: uma skill agrupada. Funciona como skills que você escreve: um prompt entregue ao Claude.41* **[Skill](/docs/pt/skills#bundled-skills)**: uma skill agrupada. Funciona como skills que você escreve: um prompt entregue ao Claude.

42 * `/verify` é executado apenas quando você o invoca. Antes da v2.1.215, Claude também podia executar `/verify` por conta própria.42 * `/verify` é executado apenas quando você o invoca. Antes da v2.1.215, Claude também podia executar `/verify` por conta própria.

~~43* **[Workflow](/docs/pt/workflows#bundled-workflows)**: um [workflow dinâmico](/docs/pt/workflows) agrupado que distribui o trabalho entre muitos subagentes e é executado em segundo plano.~~43* **[Workflow](/docs/pt/workflows#bundled-workflows)**: um [workflow dinâmico](/docs/pt/workflows) agrupado que distribui trabalho entre muitos subagentes e é executado em segundo plano.

44 * `/deep-research` é executado apenas quando você o invoca. Antes da v2.1.218, Claude também podia iniciá-lo por conta própria.44 * `/deep-research` é executado apenas quando você o invoca. Antes da v2.1.218, Claude também podia iniciá-lo por conta própria.

45 45

46Para adicionar seus próprios comandos, consulte [skills](/docs/pt/skills).46Para adicionar seus próprios comandos, consulte [skills](/docs/pt/skills).

48Na tabela abaixo, `<arg>` indica um argumento obrigatório e `[arg]` indica um opcional.48Na tabela abaixo, `<arg>` indica um argumento obrigatório e `[arg]` indica um opcional.

49 49

50<Note>50<Note>

51 Nem todo comando aparece para todos os usuários. A disponibilidade depende da sua plataforma, plano e ambiente. Por exemplo, `/desktop` aparece apenas no macOS e Windows x64 quando conectado com uma assinatura Claude, e `/upgrade` não aparece em planos Enterprise.51 Nem todo comando aparece para todos os usuários. A disponibilidade depende da sua plataforma, plano e ambiente. Por exemplo, `/desktop` aparece apenas em macOS e Windows x64 quando conectado com uma assinatura Claude, e `/upgrade` não aparece em planos Enterprise.

52</Note>52</Note>

53 53

55| :----------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |55| :----------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

56| `/add-dir <path>` | Adicione um diretório de trabalho para acesso a arquivos durante a sessão atual. Digite um caminho parcial para ver sugestões de diretório correspondentes; pressione `Tab` para aceitar uma. A maioria da configuração `.claude/` [não é descoberta](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) do diretório adicionado. Você não pode adicionar a maioria dos [caminhos de rede](/docs/pt/errors#working-directory-is-a-network-path), como `\\server\share`. Após uma adição bem-sucedida, seus [hooks `DirectoryAdded`](/docs/pt/hooks#directoryadded) são executados. Quando você o executa enquanto Claude está respondendo, Claude Code pede que você confirme o diretório imediatamente, e uma vez confirmado, a próxima chamada de ferramenta do Claude na mesma volta pode acessá-lo. Antes da v2.1.234, Claude Code enfileirava o comando até que a volta terminasse |56| `/add-dir <path>` | Adicione um diretório de trabalho para acesso a arquivos durante a sessão atual. Digite um caminho parcial para ver sugestões de diretório correspondentes; pressione `Tab` para aceitar uma. A maioria da configuração `.claude/` [não é descoberta](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) do diretório adicionado. Você não pode adicionar a maioria dos [caminhos de rede](/docs/pt/errors#working-directory-is-a-network-path), como `\\server\share`. Após uma adição bem-sucedida, seus [hooks `DirectoryAdded`](/docs/pt/hooks#directoryadded) são executados. Quando você o executa enquanto Claude está respondendo, Claude Code pede que você confirme o diretório imediatamente, e uma vez confirmado, a próxima chamada de ferramenta do Claude na mesma volta pode acessá-lo. Antes da v2.1.234, Claude Code enfileirava o comando até que a volta terminasse |

57| `/advisor [model\|off]` | Ative ou desative a [ferramenta advisor](/docs/pt/advisor), que consulta um segundo modelo para orientação em momentos-chave durante uma tarefa. Aceita `fable`, `opus`, `sonnet` ou um ID de modelo completo. `fable` requer [acesso Fable](/docs/pt/advisor#choose-an-advisor-model). Sem um argumento, abre um seletor. Em uma sessão sem um terminal interativo, ou via [Remote Control](/docs/pt/remote-control#limitations), passe o modelo ou `off` como um argumento; sem argumento lá, o comando imprime o advisor atual como texto. Esses formulários requerem Claude Code v2.1.260 ou posterior |57| `/advisor [model\|off]` | Ative ou desative a [ferramenta advisor](/docs/pt/advisor), que consulta um segundo modelo para orientação em momentos-chave durante uma tarefa. Aceita `fable`, `opus`, `sonnet` ou um ID de modelo completo. `fable` requer [acesso a Fable](/docs/pt/advisor#choose-an-advisor-model). Sem um argumento, abre um seletor. Em uma sessão sem terminal interativo, ou sobre [Remote Control](/docs/pt/remote-control#limitations), passe o modelo ou `off` como um argumento; sem argumento lá, o comando imprime o advisor atual como texto. Esses formulários requerem Claude Code v2.1.260 ou posterior |

58| `/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 subagentes |58| `/agents` | A partir da v2.1.198, executar `/agents` imprime um lembrete para pedir ao Claude que crie ou gerencie [subagentes](/docs/pt/sub-agents), ou para editar `.claude/agents/` ou `~/.claude/agents/` diretamente. Na v2.1.197 e anterior, abre uma interface interativa para criar e gerenciar configurações de subagentes |

59| `/artifacts` | Liste os [artefatos](/docs/pt/artifacts#find-an-artifact-again) que você possui ou que são compartilhados com você, depois anexe um à sessão, abra-o no seu navegador ou copie seu link. Disponível onde [artefatos](/docs/pt/artifacts#availability) estão. Requer Claude Code v2.1.208 ou posterior; anexar com `Enter` requer v2.1.216 |59| `/artifacts` | Liste os [artefatos](/docs/pt/artifacts#find-an-artifact-again) que você possui ou que são compartilhados com você, depois anexe um à sessão, abra-o no seu navegador ou copie seu link. Disponível onde [artefatos](/docs/pt/artifacts#availability) estão. Requer Claude Code v2.1.208 ou posterior; anexar com `Enter` requer v2.1.216 |

60| `/auto-mode-setup` | [Rascunhe entradas `autoMode.environment`](/docs/pt/auto-mode-config#generate-environment-entries) do seu projeto e sessões recentes, depois revise o rascunho e salve-o nas suas configurações de usuário. Requer um plano Pro, Max ou Team e Claude Code v2.1.228 ou posterior. No Windows nativo, requer v2.1.233 ou posterior |60| `/auto-mode-setup` | [Rascunhe entradas `autoMode.environment`](/docs/pt/auto-mode-config#generate-environment-entries) do seu projeto e sessões recentes, depois revise o rascunho e salve-o nas suas configurações de usuário. Requer um plano Pro, Max ou Team e Claude Code v2.1.228 ou posterior. No Windows nativo, requer v2.1.233 ou posterior |

61| `/autocompact [auto\|<tokens>]` | Defina a janela auto-compact: o quão cheio fica a janela de contexto antes de Claude Code compactar automaticamente. Passe um tamanho como `500k` ou `auto` para retornar à janela ajustada para seu modelo. Claude Code salva o valor nas configurações de usuário e o aplica à sessão atual. Consulte [Definir a janela auto-compact](/docs/pt/model-config#set-the-auto-compact-window) para valores aceitos e o que a substitui. Sem um argumento, abre um diálogo que mostra a janela atual. Requer Claude Code v2.1.221 ou posterior |61| `/autocompact [auto\|<tokens>]` | Defina a janela de auto-compactação: o quão cheio fica a janela de contexto antes de Claude Code compactar automaticamente. Passe um tamanho como `500k`, ou `auto` para retornar à janela ajustada para seu modelo. Claude Code salva o valor nas configurações de usuário e o aplica à sessão atual. Consulte [Defina a janela de auto-compactação](/docs/pt/model-config#set-the-auto-compact-window) para valores aceitos e o que a substitui. Sem um argumento, abre um diálogo que mostra a janela atual. Requer Claude Code v2.1.221 ou posterior |

62| `/autofix-pr [prompt]` | Inicie 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 na nuvem é 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) |62| `/autofix-pr [prompt]` | Inicie uma [sessão em nuvem](/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 em nuvem é 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 [sessões em nuvem](/docs/pt/claude-code-on-the-web) |

63| `/background [prompt]` | Desanexe a sessão atual para ser executada como um [agente de fundo](/docs/pt/agent-view) e libere este terminal. Passe um prompt para enviar uma instrução adicional antes de desanexar. Monitore a sessão com `claude agents`. Para copiar a conversa em uma nova sessão de fundo enquanto esta continua em execução, use `/fork`. Alias: `/bg` |63| `/background [prompt]` | Desanexe a sessão atual para ser executada como um [agente de fundo](/docs/pt/agent-view) e libere este terminal. Passe um prompt para enviar uma instrução adicional antes de desanexar. Monitore a sessão com `claude agents`. Para copiar a conversa em uma nova sessão de fundo enquanto esta continua em execução, use `/fork`. Alias: `/bg` |

64| `/batch <instruction>` | **[Skill](/docs/pt/skills#bundled-skills).** Orquestre 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, inicia um [subagente de fundo](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) por unidade em um [git worktree](/docs/pt/worktrees) isolado. Cada subagente implementa sua unidade, executa testes e abre um pull request. Requer um repositório git. Exemplo: `/batch migrate src/ from JavaScript to TypeScript` |64| `/batch <instruction>` | **[Skill](/docs/pt/skills#bundled-skills).** Orquestre 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, inicia um [subagente de fundo](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) por unidade em um [git worktree](/docs/pt/worktrees) isolado. Cada subagente implementa sua unidade, executa testes e abre um pull request. Requer um repositório git. Exemplo: `/batch migrate src/ from JavaScript to TypeScript` |

65| `/branch [name]` | Crie um branch da conversa atual neste ponto, para que você possa tentar uma direção diferente sem perder a conversa como está. Muda você para o branch e preserva o original, ao qual você pode retornar com `/resume`. Para executar uma cópia como uma [sessão de fundo](/docs/pt/agent-view) separada em vez de mudar para ela, use `/fork`; para entregar uma tarefa lateral a um [subagente](/docs/pt/sub-agents) que relata de volta para esta conversa, use `/subtask` |65| `/branch [name]` | Crie um branch da conversa atual neste ponto, para que você possa tentar uma direção diferente sem perder a conversa como está. Muda você para o branch e preserva o original, ao qual você pode retornar com `/resume`. Para executar uma cópia como uma [sessão de fundo](/docs/pt/agent-view) separada em vez de mudar para ela, use `/fork`; para entregar uma tarefa lateral a um [subagente](/docs/pt/sub-agents) que relata de volta para esta conversa, use `/subtask` |

66| `/btw [question]` | Faça uma [pergunta lateral](/docs/pt/interactive-mode#side-questions-with-%2Fbtw) sobre a sessão atual sem adicionar à conversa. Se você executar `/btw` sem uma pergunta, Claude Code mostra sua pergunta lateral mais recente para que você possa procurar respostas anteriores; se você ainda não fez uma, Claude Code imprime uma linha de uso. Antes da v2.1.212, `/btw` exigia uma pergunta |66| `/btw [question]` | Faça uma [pergunta lateral](/docs/pt/interactive-mode#side-questions-with-%2Fbtw) sobre a sessão atual sem adicionar à conversa. Se você executar `/btw` sem uma pergunta, Claude Code mostra sua pergunta lateral mais recente para que você possa procurar respostas anteriores; se você ainda não fez uma, Claude Code imprime uma linha de uso. Antes da v2.1.212, `/btw` exigia uma pergunta |

67| `/bug [report]` | Relate um bug ou compartilhe sua conversa. Você escolhe quanto histórico de sessão incluir e confirma em uma tela de consentimento antes de qualquer coisa ser enviada. Quando você está conectado ao Anthropic em uma conexão de primeira parte, o relatório vai para Anthropic; em um provedor de terceiros ou sem credenciais Anthropic, Claude Code escreve o relatório em um [arquivo local sob `~/.claude/feedback-bundles/`](/docs/pt/data-usage#telemetry-services) que você encaminha você mesmo. Na [extensão VS Code](/docs/pt/vs-code#use-the-prompt-box), `/bug` abre o diálogo de feedback próprio da extensão; requer Claude Code v2.1.229 ou posterior. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente. Antes da v2.1.232, Claude Code enfileirava o comando até que a volta terminasse. Alias: `/share`. Antes da v2.1.212, `/bug` e `/share` eram aliases de `/feedback` |67| `/bug [report]` | Relate um bug ou compartilhe sua conversa. Você escolhe quanto histórico de sessão incluir e confirma em uma tela de consentimento antes de qualquer coisa ser enviada. Quando você está conectado ao Anthropic em uma conexão de primeira parte, o relatório vai para Anthropic; em um provedor de terceiros, ou sem credenciais Anthropic, Claude Code escreve o relatório em um [arquivo local sob `~/.claude/feedback-bundles/`](/docs/pt/data-usage#telemetry-services) que você encaminha você mesmo. Na [extensão VS Code](/docs/pt/vs-code#use-the-prompt-box), `/bug` abre o diálogo de feedback próprio da extensão; requer Claude Code v2.1.229 ou posterior. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente. Antes da v2.1.232, Claude Code enfileirava o comando até que a volta terminasse. Alias: `/share`. Antes da v2.1.212, `/bug` e `/share` eram aliases de `/feedback` |

68| `/cd <path>` | Mova esta sessão para um novo diretório de trabalho, mantendo a conversa. Digite um caminho parcial para ver sugestões de diretório correspondentes; pressione `Tab` para aceitar uma. As sugestões requerem Claude Code v2.1.206 ou posterior. Para o que Claude Code aplica do novo diretório assim que você se move e como `/cd` difere de `/add-dir`, consulte [Mover a sessão para outro diretório](/docs/pt/permissions#move-the-session-to-another-directory) |68| `/cd <path>` | Mova esta sessão para um novo diretório de trabalho, mantendo a conversa. Digite um caminho parcial para ver sugestões de diretório correspondentes; pressione `Tab` para aceitar uma. As sugestões requerem Claude Code v2.1.206 ou posterior. Para o que Claude Code aplica do novo diretório assim que você se move, e como `/cd` difere de `/add-dir`, consulte [Mova a sessão para outro diretório](/docs/pt/permissions#move-the-session-to-another-directory) |

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/pt/skills#bundled-skills).** Carregue material de referência [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) para a linguagem do seu projeto. Também ativa automaticamente quando seu código importa `anthropic` ou `@anthropic-ai/sdk`. Execute `migrate` para atualizar código Claude API existente para um modelo mais novo. Execute `upgrade` para mover a dependência Anthropic SDK do seu projeto através de uma versão principal, atualmente o pacote Python `anthropic` de 0.x para 1.x. Execute `managed-agents-onboard` para um passo a passo que cria um novo Managed Agent. Execute `prompt-audit` para sinalizar instruções escritas para modelos mais antigos em seus prompts, skills e descrições de ferramentas e propor correções como um diff. Execute `cost-optimize` para perfilar para onde vai o gasto Claude API do seu projeto e propor economias de opções como prompt caching, aparar tokens de entrada e saída desnecessários, processamento em lote, esforço e escolha de modelo, uma mudança por vez. Execute `build-eval` para construir um conjunto de eval para seu app alimentado por Claude, e `hillclimb` para melhorar iterativamente o app contra um eval existente. O subcomando `prompt-audit` requer Claude Code v2.1.221 ou posterior, `upgrade` requer v2.1.236 ou posterior, `cost-optimize` requer v2.1.247 ou posterior, e `build-eval` e `hillclimb` requerem v2.1.259 ou posterior |70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/pt/skills#bundled-skills).** Carregue material de referência de [Claude API](https://platform.claude.com/docs/en/api/overview) e [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) para a linguagem do seu projeto. Também ativa automaticamente quando seu código importa `anthropic` ou `@anthropic-ai/sdk`. Execute `migrate` para atualizar código Claude API existente para um modelo mais novo. Execute `upgrade` para mover a dependência do SDK Anthropic do seu projeto através de uma versão principal, atualmente o pacote Python `anthropic` de 0.x para 1.x. Execute `managed-agents-onboard` para um passo a passo que cria um novo Managed Agent. Execute `prompt-audit` para sinalizar instruções escritas para modelos mais antigos em seus prompts, skills e descrições de ferramentas e propor correções como um diff. Execute `cost-optimize` para perfilar para onde vai o gasto de Claude API do seu projeto e propor economias de opções como prompt caching, aparar tokens de entrada e saída desnecessários, processamento em lote, esforço e escolha de modelo, uma mudança por vez. Execute `build-eval` para construir um conjunto de avaliação para seu aplicativo alimentado por Claude, e `hillclimb` para melhorar iterativamente o aplicativo contra uma avaliação existente. O subcomando `prompt-audit` requer Claude Code v2.1.221 ou posterior, `upgrade` requer v2.1.236 ou posterior, `cost-optimize` requer v2.1.247 ou posterior, e `build-eval` e `hillclimb` requerem v2.1.259 ou posterior |

71| `/clear [name]` | Inicie 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 Claude Code, restaure-a [da entrada de sessão anterior do menu rewind](/docs/pt/checkpointing#rewind-past-a-cleared-conversation). A entrada rewind requer Claude Code v2.1.191 ou posterior. Aliases: `/reset`, `/new` |71| `/clear [name]` | Inicie 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`. Retome a conversa anterior com `/resume`, ou, no mesmo processo Claude Code, restaure-a do [menu de retrocesso da entrada de sessão anterior](/docs/pt/checkpointing#rewind-past-a-cleared-conversation). A entrada de retrocesso requer Claude Code v2.1.191 ou posterior. Aliases: `/reset`, `/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/pt/skills#bundled-skills).** Revise o diff atual, ou um número de PR, branch ou caminho que você passa, para bugs de correção e oportunidades de limpeza. Passe `--fix` para aplicar descobertas, `--comment` para postá-las no GitHub PR ou GitLab merge request, ou `ultra` para executar uma [revisão na nuvem](/docs/pt/ultrareview) profunda. Postar em um GitLab merge request requer Claude Code v2.1.257 ou posterior. Com `ultra` em um alvo de PR `github.com`, passe `--post` para pré-selecionar [postando as descobertas acabadas no PR](/docs/pt/ultrareview#post-findings-to-the-pull-request) no diálogo de lançamento; `--post` requer Claude Code v2.1.227 ou posterior. Consulte [Revisar um diff localmente](/docs/pt/code-review#review-a-diff-locally) para os níveis de esforço, direcionamento e como se relaciona com `/simplify`. Alias: `/review` |72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/pt/skills#bundled-skills).** Revise o diff atual, ou um número de PR, branch ou caminho que você passa, para bugs de correção. Dependendo do seu modelo e nível de esforço, a revisão também cobre oportunidades de limpeza. Passe `--fix` para aplicar descobertas, `--comment` para postá-las no GitHub PR ou GitLab merge request, ou `ultra` para executar uma [revisão em nuvem](/docs/pt/ultrareview) profunda. Postar em um GitLab merge request requer Claude Code v2.1.257 ou posterior. Com `ultra` em um alvo de PR `github.com`, passe `--post` para pré-selecionar [postando as descobertas concluídas no PR](/docs/pt/ultrareview#post-findings-to-the-pull-request) no diálogo de inicialização; `--post` requer Claude Code v2.1.227 ou posterior. Consulte [Revise um diff localmente](/docs/pt/code-review#review-a-diff-locally) para os níveis de esforço, direcionamento e como se relaciona com `/simplify`. Alias: `/review` |

73| `/color [color\|default]` | Defina 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 |73| `/color [color\|default]` | Defina 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 |

74| `/compact [instructions]` | Libere 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) |74| `/compact [instructions]` | Libere 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) |

75| `/config [key=value ...]` | Abra a interface [Configurações](/docs/pt/settings) para ajustar tema, modelo, [estilo de saída](/docs/pt/output-styles) e outras preferências. Passe um ou mais pares `key=value` para definir uma configuração diretamente sem abrir a interface, por exemplo `/config thinking=false`, `/config theme=dark` ou `/config model=sonnet`. O formulário `key=value` também funciona em modo não interativo (`-p`) e do app móvel Claude via [Remote Control](/docs/pt/remote-control). O formulário `key=value` não pode ativar uma configuração que precisa de sua confirmação no painel, como [`autoContinueAtUsageLimit`](/docs/pt/interactive-mode#turn-automatic-continue-off), embora possa desativá-la. Execute `/config --help` para listar as chaves que aceita. Alias: `/settings` |75| `/config [key=value ...]` | Abra a interface de [Configurações](/docs/pt/settings) para ajustar tema, modelo, [estilo de saída](/docs/pt/output-styles) e outras preferências. Passe um ou mais pares `key=value` para definir uma configuração diretamente sem abrir a interface, por exemplo `/config thinking=false`, `/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). O formulário `key=value` não pode ativar uma configuração que precisa de sua confirmação no painel, como [`autoContinueAtUsageLimit`](/docs/pt/interactive-mode#turn-automatic-continue-off), embora possa desativá-la. Execute `/config --help` para listar as chaves que aceita. Alias: `/settings` |

76| `/context [all]` | Visualize o uso de contexto atual como uma grade colorida. Mostra sugestões de otimização para ferramentas pesadas em contexto, inchaço de memória e avisos de capacidade. Quando a conversa excede a janela de contexto, a saída inclui um [aviso](/docs/pt/errors#context-exceeds-the-token-limit) mostrando o quão longe você está do limite e qual comando libera espaço. Em [modo tela cheia](/docs/pt/fullscreen), `/context` recolhe o detalhamento por item para manter a grade visível. Passe `all` para expandi-lo |76| `/context [all]` | Visualize o uso de contexto atual como uma grade colorida. Mostra sugestões de otimização para ferramentas pesadas em contexto, inchaço de memória e avisos de capacidade. Quando a conversa excede a janela de contexto, a saída inclui um [aviso](/docs/pt/errors#context-exceeds-the-token-limit) mostrando o quão longe você está do limite e qual comando libera espaço. Em [modo tela cheia](/docs/pt/fullscreen), `/context` recolhe o detalhamento por item para manter a grade visível. Passe `all` para expandi-lo |

77| `/copy [N]` | Copie a última resposta do assistente para a área de transferência. Passe um número `N` para copiar a resposta N-ésima mais recente: `/copy 2` copia a segunda mais recente. Quando blocos de código estão presentes, 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 |77| `/copy [N]` | Copie a última resposta do assistente para a área de transferência. Passe um número `N` para copiar a Nª-última resposta: `/copy 2` copia a segunda-última. Quando blocos de código estão presentes, 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 sobre SSH |

79| `/dataviz [request]` | **[Skill](/docs/pt/skills#bundled-skills).** Orientação de design para gráficos, gráficos e painéis. Claude escolhe a forma de gráfico para os dados, atribui cor por função, valida a paleta para segurança para daltônicos 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 |79| `/dataviz [request]` | **[Skill](/docs/pt/skills#bundled-skills).** Orientação de design para gráficos, gráficos 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 |

80| `/debug [description]` | **[Skill](/docs/pt/skills#bundled-skills).** Ative o registro de debug para a sessão atual e solucione problemas lendo o log de debug da sessão. O registro de debug 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 |80| `/debug [description]` | **[Skill](/docs/pt/skills#bundled-skills).** Ative o registro de debug para a sessão atual e solucione problemas lendo o log de debug da sessão. O registro de debug 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 |

81| `/deep-research <question>` | **[Workflow](/docs/pt/workflows#bundled-workflows).** Distribua buscas na web em uma pergunta, busque e verifique cruzadamente fontes e sintetize um relatório citado |81| `/deep-research <question>` | **[Workflow](/docs/pt/workflows#bundled-workflows).** Distribua buscas na web em uma pergunta, busque e verifique cruzadamente fontes e sintetize um relatório citado |

82| `/design [brief]` | **[Skill](/docs/pt/skills#bundled-skills).** Rascunhe mockups de UI, fluxos de tela, páginas de destino ou pôsteres como artboards em uma tela, publicados como um [artefato](/docs/pt/artifacts#draft-a-design-canvas) Design, por exemplo `/design a settings screen for a mobile banking app`. Você edita os artboards em um navegador de desktop e suas edições são salvas automaticamente. Você pode exportar cada artboard como PNG ou PDF. Requer uma sessão onde [artefatos estão disponíveis](/docs/pt/artifacts#availability) e Claude Code v2.1.265 ou posterior. Disponível na API Anthropic. No Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform no AWS, artefatos não estão disponíveis, então o comando não está disponível lá |82| `/design [brief]` | **[Skill](/docs/pt/skills#bundled-skills).** Rascunhe mockups de UI, fluxos de tela, páginas de destino ou pôsteres como artboards em uma tela, publicados como um [artefato](/docs/pt/artifacts#draft-a-design-canvas) Design, por exemplo `/design a settings screen for a mobile banking app`. Você edita os artboards em um navegador de desktop, e suas edições são salvas automaticamente. Você pode exportar cada artboard como PNG ou PDF. Requer uma sessão onde [artefatos estão disponíveis](/docs/pt/artifacts#availability) e Claude Code v2.1.265 ou posterior. Disponível na API Anthropic. No Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Claude Platform on AWS, artefatos não estão disponíveis, então o comando não está disponível lá |

84| `/design-sync [hint]` | **[Skill](/docs/pt/skills#bundled-skills).** Converta o sistema de design React do seu repositório e carregue-o em [Claude Design](https://claude.ai/design), para que os designs que produz usem seus componentes reais. Opcionalmente nomeie o sistema de design, por exemplo `/design-sync Acme DS`. Uma sincronização pela primeira vez verifica cada componente e pode levar algumas horas em um repositório grande. Disponível na API Anthropic. Precisa de claude.ai, que a CLI não contatará no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform no AWS, ou através de um [gateway de apps Claude](/docs/pt/claude-apps-gateway#availability-and-limitations), então o comando não está disponível lá |84| `/design-sync [hint]` | **[Skill](/docs/pt/skills#bundled-skills).** Converta o sistema de design React do seu repositório e carregue-o em [Claude Design](https://claude.ai/design), para que os designs que 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. Precisa de claude.ai, que a CLI não contatará no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform on AWS, ou através de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway#availability-and-limitations), então o comando não está disponível lá |

85| `/desktop` | Continue a sessão atual no app Claude Code Desktop. Requer macOS ou Windows x64 e uma assinatura Claude. Alias: `/app` |85| `/desktop` | Continue a sessão atual no aplicativo Claude Code Desktop. Requer macOS ou Windows x64 e uma assinatura Claude. Alias: `/app` |

86| `/diff` | Revise as mudanças em sua árvore de trabalho, incluindo as edições que Claude fez até agora. Consulte [Revisar mudanças com /diff](/docs/pt/interactive-mode#review-changes-with-%2Fdiff) |86| `/diff` | Revise as mudanças em sua árvore de trabalho, incluindo as edições que Claude fez até agora. Consulte [Revise mudanças com /diff](/docs/pt/interactive-mode#review-changes-with-%2Fdiff) |

87| `/doctor` | **[Skill](/docs/pt/skills#bundled-skills).** Execute 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, servidores MCP e plugins não utilizados versus seu custo de contexto, sinaliza [hooks](/docs/pt/hooks) lentos e verifica uma versão mais nova em seu [canal de lançamento](/docs/pt/setup#configure-release-channel). Deduplica arquivos `CLAUDE.md` locais contra os verificados, aparas arquivos [`CLAUDE.md`](/docs/pt/memory#my-claude-md-is-too-large) verificados cortando conteúdo que Claude poderia derivar do codebase e migra a orientação sempre carregada que permanece em [skills](/docs/pt/skills) e arquivos `CLAUDE.md` aninhados que carregam sob demanda. Também oferece fazer [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 mudar 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 aparas `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 para Claude |87| `/doctor` | **[Skill](/docs/pt/skills#bundled-skills).** Execute 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ção não analisáveis. Encontra skills, servidores MCP e plugins não utilizados versus seu custo de contexto, sinaliza [hooks](/docs/pt/hooks) lentos e verifica uma versão mais nova no seu [canal de lançamento](/docs/pt/setup#configure-release-channel). Deduplica arquivos `CLAUDE.md` locais contra os verificados, aparas arquivos [`CLAUDE.md`](/docs/pt/memory#my-claude-md-is-too-large) verificados cortando conteúdo que Claude poderia derivar do codebase, e migra a orientação sempre carregada que permanece em [skills](/docs/pt/skills) e arquivos `CLAUDE.md` aninhados que carregam sob demanda. Também oferece fazer [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 aparas `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 para Claude |

88| `/effort [level\|auto\|status]` | Defina o [nível de esforço](/docs/pt/model-config#adjust-effort-level): `low` a `xhigh`, `max`, [`ultracode`](/docs/pt/workflows#let-claude-decide-with-ultracode) ou `auto`; `status` o imprime. `max` e `ultracode` são apenas de sessão; a chave [`ultracode`](/docs/pt/settings-reference#ultracode) persiste. Execute-o enquanto Claude está respondendo e, uma vez que você confirme o [aviso de cache](/docs/pt/prompt-caching#changing-effort-level), se Claude Code mostrar um, Claude Code aplica o novo nível à próxima solicitação nessa volta. Antes da v2.1.242, Claude Code decidiu de um sinalizador de recurso que buscou do Anthropic se executaria o comando no meio da volta ou o enfileiraria até que a volta terminasse, e sempre o enfileirava em uma sessão que não [busca sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), como em um [provedor de terceiros](/docs/pt/third-party-integrations). Funciona em `-p` fora da [retenção de esforço](/docs/pt/model-config#adjust-effort-level) |88| `/effort [level\|auto\|status]` | Defina o [nível de esforço](/docs/pt/model-config#adjust-effort-level): `low` a `xhigh`, `max`, [`ultracode`](/docs/pt/workflows#let-claude-decide-with-ultracode), ou `auto`; `status` o imprime. `max` e `ultracode` são apenas de sessão; a chave [`ultracode`](/docs/pt/settings-reference#ultracode) persiste. Execute-o enquanto Claude está respondendo e, uma vez que você confirme o [aviso de cache](/docs/pt/prompt-caching#changing-effort-level), se Claude Code mostrar um, Claude Code aplica o novo nível à próxima solicitação nessa volta. Antes da v2.1.242, Claude Code decidiu de um sinalizador de recurso que buscou do Anthropic se executaria o comando no meio da volta ou o enfileiraria até que a volta terminasse, e sempre o enfileirava em uma sessão que não [busca sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), como em um [provedor de terceiros](/docs/pt/third-party-integrations). Funciona em `-p` |

89| `/exit` | Saia 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` |89| `/exit` | Saia 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` |

90| `/export [filename]` | Exporte 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 |90| `/export [filename]` | Exporte a conversa atual como texto simples. Com um nome de arquivo, escreve diretamente nesse arquivo. Sem, abre um diálogo para copiar para a área de transferência ou salvar em um arquivo |

91| `/fast [on\|off]` | Alterne [modo rápido](/docs/pt/fast-mode) ativado ou desativado. Execute-o enquanto Claude está respondendo e Claude Code alterna o modo rápido sem esperar que a volta termine, embora a volta em execução termine em sua velocidade original. Antes da v2.1.242, Claude Code decidiu de um sinalizador de recurso que buscou do Anthropic se executaria o comando no meio da volta ou o enfileiraria até que a volta terminasse, e sempre o enfileirava em uma sessão que não [busca sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching). A disponibilidade em modo não interativo com `-p` é limitada; consulte [Alternar modo rápido](/docs/pt/fast-mode#toggle-fast-mode). Requer Claude Code v2.1.205 ou posterior |91| `/fast [on\|off]` | Alterne o [modo rápido](/docs/pt/fast-mode) ativado ou desativado. Execute-o enquanto Claude está respondendo e Claude Code alterna o modo rápido sem esperar que a volta termine, embora a volta em execução termine na sua velocidade original. Antes da v2.1.242, Claude Code decidiu de um sinalizador de recurso que buscou do Anthropic se executaria o comando no meio da volta ou o enfileiraria até que a volta terminasse, e sempre o enfileirava em uma sessão que não [busca sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching). A disponibilidade em modo não interativo com `-p` é limitada; consulte [Alterne o modo rápido](/docs/pt/fast-mode#toggle-fast-mode). Requer Claude Code v2.1.205 ou posterior |

92| `/feedback [report]` | Envie feedback de produto sobre Claude Code. Abre o mesmo diálogo que [`/bug`](#all-commands), com a mesma etapa de consentimento, regras de envio e comportamento no meio da volta. Em sessões com [feedback rascunhado por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior), `/feedback` sem argumento abre a fila de rascunhos em vez disso, onde você revisa, edita, envia ou descarta os rascunhos que Claude enfileirou; a fila inclui uma opção para escrever um novo relatório no diálogo. Com um argumento, e para `/bug` sempre, o diálogo abre diretamente |92| `/feedback [report]` | Envie feedback de produto sobre Claude Code. Abre o mesmo diálogo que [`/bug`](#all-commands), com a mesma etapa de consentimento, regras de envio e comportamento no meio da volta. Em sessões com [feedback rascunhado por Claude](/docs/pt/tools-reference#sendfeedback-tool-behavior), `/feedback` sem argumento abre a fila de rascunhos, onde você revisa, edita, envia ou descarta os rascunhos que Claude enfileirou; a fila inclui uma opção para escrever um novo relatório no diálogo. Com um argumento, e para `/bug` sempre, o diálogo abre diretamente |

93| `/fewer-permission-prompts` | **[Skill](/docs/pt/skills#bundled-skills).** Escaneie seus transcritos para chamadas de ferramentas Bash e MCP somente leitura comuns, depois adicione uma lista de permissões priorizada ao projeto `.claude/settings.json` para reduzir prompts de permissão |93| `/fewer-permission-prompts` | **[Skill](/docs/pt/skills#bundled-skills).** Escaneie suas transcrições para chamadas de ferramentas Bash e MCP somente leitura comuns, depois adicione uma lista de permissões priorizada ao `.claude/settings.json` do projeto para reduzir prompts de permissão |

94| `/focus` | Alterne a visualização de foco, que mostra apenas seu último prompt, um resumo de chamada de ferramenta de uma linha com estatísticas de diff de edição e a resposta final. O resumo de chamada de ferramenta também conta os subagentes lançados na volta 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-reference#viewmode) nas configurações para substituí-la. Disponível apenas em [renderização tela cheia](/docs/pt/fullscreen). A [extensão VS Code](/docs/pt/vs-code#use-the-prompt-box) oferece sua própria visualização Focus como um toggle de menu de comando, armazenado como uma configuração de extensão, independente de `viewMode` |94| `/focus` | Alterne a visualização de foco, que mostra apenas seu último prompt, um resumo de chamada de ferramenta de uma linha com estatísticas de diff de edição e a resposta final. O resumo de chamada de ferramenta também conta os subagentes iniciados na volta 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-reference#viewmode) nas configurações para substituí-la. Disponível apenas em [renderização tela cheia](/docs/pt/fullscreen). A [extensão VS Code](/docs/pt/vs-code#use-the-prompt-box) oferece sua própria visualização Focus como um toggle de menu de comando, armazenado como uma configuração de extensão, independente de `viewMode` |

95| `/fork [prompt]` | [Copie a conversa atual](/docs/pt/agent-view#copy-the-session-with-%2Ffork) em uma nova sessão de fundo e continue trabalhando aqui. Passe um prompt e a cópia começa a trabalhar nele imediatamente; sem um, espera em agent view por seu primeiro prompt. Exceto quando a cópia [edita no local](/docs/pt/agent-view#how-file-edits-are-isolated), Claude Code a instrui a criar um worktree próprio antes de fazer mudanças de código; a instrução de isolamento requer Claude Code v2.1.221 ou posterior. Para entregar uma tarefa lateral a um subagente cujo resultado volta para esta conversa, use `/subtask`; para mudar para uma cópia você mesmo, use `/branch`. Requer Claude Code v2.1.212 ou posterior; na v2.1.161 através v2.1.211, e sempre que [agent view está desativado](/docs/pt/agent-view#turn-off-agent-view), `/fork` inicia um [subagente bifurcado](/docs/pt/sub-agents#fork-the-current-conversation) em vez disso |95| `/fork [prompt]` | [Copie a conversa atual](/docs/pt/agent-view#copy-the-session-with-%2Ffork) em uma nova sessão de fundo e continue trabalhando aqui. Passe um prompt e a cópia começa a trabalhar nele imediatamente; sem um, aguarda na visualização de agente para seu primeiro prompt. Exceto quando a cópia [edita no local](/docs/pt/agent-view#how-file-edits-are-isolated), Claude Code a instrui a criar um worktree próprio antes de fazer mudanças de código; a instrução de isolamento requer Claude Code v2.1.221 ou posterior. Para entregar uma tarefa lateral a um subagente cujo resultado volta para esta conversa, use `/subtask`; para mudar para uma cópia você mesmo, use `/branch`. Requer Claude Code v2.1.212 ou posterior; na v2.1.161 através v2.1.211, e sempre que [a visualização de agente está desativada](/docs/pt/agent-view#turn-off-agent-view), `/fork` inicia um [subagente bifurcado](/docs/pt/sub-agents#fork-the-current-conversation) |

96| `/goal [condition\|clear]` | Defina um [objetivo](/docs/pt/goal): Claude continua trabalhando entre voltas até que a condição seja atendida ou o objetivo [limpe por outro motivo](/docs/pt/goal#how-evaluation-works). Sem argumento, mostra o objetivo atual ou mais recentemente alcançado. `clear`, `stop`, `off`, `reset`, `none` ou `cancel` remove um objetivo ativo antecipadamente |96| `/goal [condition\|clear]` | Defina uma [meta](/docs/pt/goal): Claude continua trabalhando entre voltas até que a condição seja atendida ou a meta [limpe por outro motivo](/docs/pt/goal#how-evaluation-works). Sem argumento, mostra a meta atual ou mais recentemente alcançada. `clear`, `stop`, `off`, `reset`, `none` ou `cancel` remove uma meta ativa antecipadamente |

97| `/heapdump` | Escreva um snapshot de heap JavaScript e um detalhamento de memória em `~/Desktop`, ou seu diretório inicial no Linux sem uma pasta Desktop, para diagnosticar alto uso de memória. Anexe apenas o arquivo `-diagnostics.json` ao relatar um problema de memória; o `.heapsnapshot` contém sua conversa completa e credenciais, então não o compartilhe. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type); digite-o por completo. Consulte [o que fazer com a saída](/docs/pt/troubleshooting#high-cpu-or-memory-usage) |97| `/heapdump` | Escreva um snapshot de heap JavaScript e um detalhamento de memória em `~/Desktop`, ou seu diretório inicial no Linux sem uma pasta Desktop, para diagnosticar alto uso de memória. Anexe apenas o arquivo `-diagnostics.json` ao relatar um problema de memória; o `.heapsnapshot` contém sua conversa completa e credenciais, então não o compartilhe. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type); digite-o por completo. Consulte [o que fazer com a saída](/docs/pt/troubleshooting#high-cpu-or-memory-usage) |

100| `/ide` | Gerencie integrações IDE e mostre status |100| `/ide` | Gerencie integrações de IDE e mostre status |

101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Traga configuração de OpenAI Codex, Google Gemini CLI ou Cursor em sua máquina para Claude Code, incluindo arquivos de instrução, servidores MCP, comandos, subagentes e skills. Em [modo não interativo](/docs/pt/headless) com `-p`, `/import` lista o que encontrou e fornece o comando que confirma a importação. Adicione `--dry-run` para visualizar sem escrever nada, ou `--yes` para pular o seletor interativo. Não disponível no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform no AWS, ou através de um [gateway de apps Claude](/docs/pt/claude-apps-gateway#availability-and-limitations). Também indisponível quando você desativa [busca de sinalizador de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Requer Claude Code v2.1.213 ou posterior. Importar de Cursor requer v2.1.265 ou posterior |101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Traga configuração do OpenAI Codex, Google Gemini CLI ou Cursor em sua máquina para Claude Code, incluindo arquivos de instrução, servidores MCP, comandos, subagentes e skills. Em [modo não interativo](/docs/pt/headless) com `-p`, `/import` lista o que encontrou e fornece o comando que confirma a importação. Adicione `--dry-run` para visualizar sem escrever nada, ou `--yes` para pular o seletor interativo. Não disponível no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform on AWS, ou através de um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway#availability-and-limitations). Também indisponível quando você desativa [busca de sinalizador de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Requer Claude Code v2.1.213 ou posterior. Importar do Cursor requer v2.1.265 ou posterior |

102| `/init` | Inicialize o projeto com um guia `CLAUDE.md`. Defina `CLAUDE_CODE_NEW_INIT=1` para um fluxo interativo que também percorre skills, hooks e arquivos de memória pessoal. Se `/init` encontrar configuração de OpenAI Codex ou Google Gemini CLI, oferece carregá-la com `/import` |102| `/init` | Inicialize o projeto com um guia `CLAUDE.md`. Defina `CLAUDE_CODE_NEW_INIT=1` para um fluxo interativo que também percorre skills, hooks e arquivos de memória pessoal. Se `/init` encontrar configuração do OpenAI Codex ou Google Gemini CLI, oferece carregá-la com `/import` |

103| `/insights` | Gere um relatório HTML analisando suas sessões recentes nesta máquina: em quais projetos você trabalha, como você usa Claude Code, onde as coisas dão errado e recursos para tentar. Não disponível em [sessões na nuvem](/docs/pt/claude-code-on-the-web). Consulte [Analise seus padrões de uso](/docs/pt/costs#analyze-your-usage-patterns) para a localização do relatório, retenção e custo |103| `/insights` | Gere um relatório HTML analisando suas sessões recentes nesta máquina: em quais projetos você trabalha, como você usa Claude Code, onde as coisas dão errado e recursos para tentar. Não disponível em [sessões em nuvem](/docs/pt/claude-code-on-the-web). Consulte [Analise seus padrões de uso](/docs/pt/costs#analyze-your-usage-patterns) para a localização do relatório, retenção e custo |

104| `/install-github-app` | Instale o Claude GitHub App para um repositório, com uma etapa opcional para configurar fluxos de trabalho [GitHub Actions](/docs/pt/github-actions) e segredos. Orienta você na seleção de um repositório e configuração da integração. Funciona apenas com repositórios github.com. Quando o git remote do seu repositório está em gitlab.com ou bitbucket.org, o comando imprime um aviso e sai em vez de iniciar a configuração. Para executar Claude Code a partir de pipelines GitLab, consulte [GitLab CI/CD](/docs/pt/gitlab-ci-cd) |104| `/install-github-app` | Instale o Claude GitHub App para um repositório, com uma etapa opcional para configurar fluxos de trabalho [GitHub Actions](/docs/pt/github-actions) e segredos. Orienta você através da seleção de um repositório e configuração da integração. Funciona apenas com repositórios github.com. Quando o git remote do seu repositório está em gitlab.com ou bitbucket.org, o comando imprime um aviso e sai em vez de iniciar a configuração. Para executar Claude Code a partir de pipelines GitLab, consulte [GitLab CI/CD](/docs/pt/gitlab-ci-cd) |

107| `/list-agents` | Liste os subagentes, colegas [equipe de agentes](/docs/pt/agent-teams) e outras sessões Claude Code que Claude pode enviar mensagens, com o nome a usar para cada. Consulte [mensagens entre sessões](/docs/pt/cross-session-messaging). Também disponível como `/peers`. Requer Claude Code v2.1.224 ou posterior; versões anteriores relatam `Unknown command: /list-agents`. Linhas de colega e a primeira linha mostrando o nome desta sessão requerem v2.1.239 ou posterior. Disponível apenas em sessões onde [mensagens entre sessões estão habilitadas](/docs/pt/cross-session-messaging#availability) |107| `/list-agents` | Liste os subagentes, colegas da [equipe de agentes](/docs/pt/agent-teams) e outras sessões Claude Code que Claude pode enviar mensagens, com o nome a usar para cada. Consulte [mensagens entre sessões](/docs/pt/cross-session-messaging). Também disponível como `/peers`. Requer Claude Code v2.1.224 ou posterior; versões anteriores relatam `Unknown command: /list-agents`. Linhas de colegas e a primeira linha mostrando o nome da própria sessão requerem v2.1.239 ou posterior. Disponível apenas em sessões onde [mensagens entre sessões estão ativadas](/docs/pt/cross-session-messaging#availability) |

110| `/loop [interval] [prompt]` | **[Skill](/docs/pt/skills#bundled-skills).** Execute um prompt repetidamente enquanto a sessão permanece aberta. Omita o intervalo e Claude [auto-marca entre iterações](/docs/pt/scheduled-tasks#let-claude-choose-the-interval). Omita o prompt e Claude executa o [prompt de manutenção integrado](/docs/pt/scheduled-tasks#run-the-built-in-maintenance-prompt) ou seu [`loop.md`](/docs/pt/scheduled-tasks#customize-the-default-prompt-with-loop-md). Exemplo: `/loop 5m check if the deploy finished`. Consulte [Execute prompts em um cronograma](/docs/pt/scheduled-tasks). Alias: `/proactive` |110| `/loop [interval] [prompt]` | **[Skill](/docs/pt/skills#bundled-skills).** Execute um prompt repetidamente enquanto a sessão permanece aberta. Omita o intervalo e Claude [auto-marca entre iterações](/docs/pt/scheduled-tasks#let-claude-choose-the-interval). Omita o prompt e Claude executa o [prompt de manutenção integrado](/docs/pt/scheduled-tasks#run-the-built-in-maintenance-prompt) ou seu [`loop.md`](/docs/pt/scheduled-tasks#customize-the-default-prompt-with-loop-md). Exemplo: `/loop 5m check if the deploy finished`. Consulte [Execute prompts em um cronograma](/docs/pt/scheduled-tasks). Alias: `/proactive` |

111| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gerencie 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 mudar 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 |111| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Gerencie 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 |

112| `/memory` | Edite arquivos `CLAUDE.md`, ative ou desative [memória automática](/docs/pt/memory#auto-memory) e veja entradas de memória automática |112| `/memory` | Edite arquivos `CLAUDE.md`, ative ou desative [memória automática](/docs/pt/memory#auto-memory) e veja entradas de memória automática |

114| `/model [model]` | Mude o modelo de IA e salve-o como seu padrão para novas sessões. Para modelos que suportam, use setas esquerda/direita para [ajustar nível de esforço](/docs/pt/model-config#adjust-effort-level). Sem argumento, abre um seletor; pressione `s` em uma linha para mudar apenas para a sessão atual. Consulte [quando Claude Code pede que você confirme a mudança](/docs/pt/prompt-caching#switching-models). Uma vez que você confirme a mudança, se Claude Code pedir, Claude Code aplica a mudança sem esperar que a resposta atual termine. Antes da v2.1.242, Claude Code decidiu de um sinalizador de recurso que buscou do Anthropic se executaria o comando no meio da volta ou o enfileiraria até que a volta terminasse, e sempre o enfileirava em uma sessão que não [busca sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), como em um [provedor de terceiros](/docs/pt/third-party-integrations). 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 |114| `/model [model]` | Mude o modelo de IA e salve-o como seu padrão para novas sessões. Para modelos que suportam, use setas esquerda/direita para [ajustar nível de esforço](/docs/pt/model-config#adjust-effort-level). Sem argumento, abre um seletor; pressione `s` em uma linha para mudar apenas para a sessão atual. Consulte [quando Claude Code pede que você confirme a mudança](/docs/pt/prompt-caching#switching-models). Uma vez que você confirme a mudança, se Claude Code pedir, Claude Code aplica a mudança sem esperar que a resposta atual termine. Antes da v2.1.242, Claude Code decidiu de um sinalizador de recurso que buscou do Anthropic se executaria o comando no meio da volta ou o enfileiraria até que a volta terminasse, e sempre o enfileirava em uma sessão que não [busca sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), como em um [provedor de terceiros](/docs/pt/third-party-integrations). 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 |

115| `/output-style [style]` | Liste [estilos de saída](/docs/pt/output-styles) ou mude para um, por exemplo `/output-style concise`. Consulte [Mude seu estilo de saída](/docs/pt/output-styles#change-your-output-style). Requer Claude Code v2.1.269 ou posterior |115| `/output-style [style]` | Liste [estilos de saída](/docs/pt/output-styles) ou mude para um, por exemplo `/output-style concise`. Consulte [Altere seu estilo de saída](/docs/pt/output-styles#change-your-output-style). Requer Claude Code v2.1.269 ou posterior |

117| `/permissions` | Gerencie regras de permissão de ferramentas permitir, perguntar e negar. 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). Você também pode visualizar e editar [regras do classificador de modo automático](/docs/pt/auto-mode-config#edit-rules-from-permissions) da aba **Auto mode** do diálogo. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente e aplica suas mudanças começando com a próxima chamada de ferramenta do Claude na mesma volta. Antes da v2.1.234, Claude Code enfileirava o comando até que a volta terminasse. Alias: `/allowed-tools` |117| `/permissions` | Gerencie regras de permissão de ferramentas permitir, perguntar e negar. 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). Você também pode visualizar e editar [regras do classificador de modo automático](/docs/pt/auto-mode-config#edit-rules-from-permissions) da aba **Auto mode** do diálogo. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente e aplica suas mudanças começando com a próxima chamada de ferramenta do Claude na mesma volta. Antes da v2.1.234, Claude Code enfileirava o comando até que a volta terminasse. Alias: `/allowed-tools` |

118| `/plan [description]` | Entre no modo plano diretamente do prompt. Passe uma descrição opcional para entrar no modo plano e começar imediatamente com essa tarefa, por exemplo `/plan fix the auth bug` |118| `/plan [description]` | Entre no modo de plano diretamente do prompt. Passe uma descrição opcional para entrar no modo de plano e começar imediatamente com essa tarefa, por exemplo `/plan fix the auth bug` |

119| `/plugin [subcommand]` | Gerencie Claude Code [plugins](/docs/pt/plugins). Execute sem argumento para abrir o menu de plugin, ou passe um subcomando como `list`, `install`, `enable` ou `disable` para agir diretamente. Claude Code pode ativar um plugin durante a instalação; o [resumo de instalação](/docs/pt/discover-plugins#install-plugins) diz se fez ou se deve executar `/reload-plugins` |119| `/plugin [subcommand]` | Gerencie [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. Claude Code pode ativar um plugin durante a instalação; o [resumo de instalação](/docs/pt/discover-plugins#install-plugins) diz se fez ou se você deve executar `/reload-plugins` |

121| `/pr-comments [PR]` | Removido na v2.1.91. Peça ao Claude diretamente para visualizar comentários de pull request em vez disso. Em versões anteriores, busca e exibe comentários de um pull request GitHub; detecta automaticamente o PR para o branch atual, ou passe uma URL ou número de PR. Requer a CLI `gh` |121| `/pr-comments [PR]` | Removido na v2.1.91. Peça ao Claude diretamente para visualizar comentários de pull request. Em versões anteriores, buscava e exibia comentários de um pull request GitHub; detecta automaticamente o PR para o branch atual, ou passe uma URL ou número de PR. Requer a CLI `gh` |

122| `/privacy-settings` | Veja e atualize suas configurações de privacidade. Disponível apenas para assinantes de plano Pro e Max |122| `/privacy-settings` | Veja e atualize suas configurações de privacidade. Disponível apenas para assinantes de planos Pro e Max |

123| `/radio` | Abra Claude FM lo-fi radio no seu navegador. Imprime a URL do stream quando nenhum navegador está disponível |123| `/radio` | Abra Claude FM lo-fi radio no seu navegador. Imprime a URL do stream quando nenhum navegador está disponível |

124| `/rate-limit-options` | Mostre maneiras de continuar trabalhando quando um limite de uso claude.ai bloqueia uma solicitação: espere e [continue automaticamente quando o limite for redefinido](/docs/pt/interactive-mode#wait-for-a-usage-limit-to-reset), adicione [créditos de uso](/docs/pt/costs#add-usage-credits-to-your-subscription) ou atualize seu plano. Claude Code também pode abrir este menu por conta própria quando você atinge um limite em seu próprio terminal. Consulte [Desative a continuação automática](/docs/pt/interactive-mode#turn-automatic-continue-off). Requer uma assinatura claude.ai. Não aparece no menu de comando; digite-o por completo. As linhas de espera e continuação requerem Claude Code v2.1.234 ou posterior |124| `/rate-limit-options` | Mostre maneiras de continuar trabalhando quando um limite de uso claude.ai bloqueia uma solicitação: aguarde e [continue automaticamente quando o limite for redefinido](/docs/pt/interactive-mode#wait-for-a-usage-limit-to-reset), adicione [créditos de uso](/docs/pt/costs#add-usage-credits-to-your-subscription) ou atualize seu plano. Claude Code também pode abrir este menu por conta própria quando você atinge um limite no seu próprio terminal. Consulte [Desative a continuação automática](/docs/pt/interactive-mode#turn-automatic-continue-off). Requer uma assinatura claude.ai. Não aparece no menu de comando; digite-o por completo. As linhas de espera e continuação requerem Claude Code v2.1.234 ou posterior |

125| `/recap` | Gere um resumo de uma linha da sessão atual sob demanda. Consulte [Recapitulação de sessão](/docs/pt/interactive-mode#session-recap) para a recapitulação automática que aparece depois que você esteve ausente |125| `/recap` | Gere um resumo de uma linha da sessão atual sob demanda. Consulte [Recapitulação de sessão](/docs/pt/interactive-mode#session-recap) para o recapitulação automática que aparece depois que você esteve ausente |

126| `/release-notes` | Veja 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ê |126| `/release-notes` | Veja 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ê |

127| `/reload-plugins [--force]` | Recarregue todos os [plugins](/docs/pt/plugins) ativos para aplicar mudanças pendentes sem reiniciar. Relata contagens para cada componente recarregado e sinaliza quaisquer erros de carregamento. Quando o recarregamento mudaria quais ferramentas MCP são carregadas e invalidaria o cache de prompt, o comando avisa e pula a menos que você passe `--force`. Também disponível em modo não interativo (`-p`), o Agent SDK e o app desktop, onde é executado apenas em entrada digitada diretamente na sessão e não aplica mudanças de servidor MCP de plugin; requer Claude Code v2.1.260 ou posterior. Consulte [Aplique mudanças de plugin sem reiniciar](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) |127| `/reload-plugins [--force]` | Recarregue todos os [plugins](/docs/pt/plugins) ativos para aplicar mudanças pendentes sem reiniciar. Relata contagens para cada componente recarregado e sinaliza 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`. Também disponível em modo não interativo (`-p`), o Agent SDK e o aplicativo de desktop, onde é executado apenas em entrada digitada diretamente na sessão e não aplica mudanças de servidor MCP de plugin; requer Claude Code v2.1.260 ou posterior. Consulte [Aplique mudanças de plugin sem reiniciar](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) |

128| `/reload-skills` | Rescaneie diretórios [skill](/docs/pt/skills) e 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 |128| `/reload-skills` | Rescaneie diretórios de [skill](/docs/pt/skills) e 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 |

129| `/remote-control` | Disponibilize esta sessão para [Remote Control](/docs/pt/remote-control) de claude.ai. Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como conectar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |129| `/remote-control` | Disponibilize esta sessão para [Remote Control](/docs/pt/remote-control) de claude.ai. Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como conectar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |

130| `/remote-env` | Escolha o ambiente padrão [cloud](/docs/pt/cloud-environments#select-an-environment-from-the-cli) para sessões na nuvem que você inicia a partir da CLI |130| `/remote-env` | Escolha o [ambiente em nuvem](/docs/pt/cloud-environments#select-an-environment-from-the-cli) padrão para sessões em nuvem que você inicia a partir da CLI |

131| `/rename [name]` | Renomeie a sessão atual e mostre 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. De cada superfície de renomeação, incluindo claude.ai e o app desktop, Claude Code substitui caracteres de controle e invisíveis no novo nome com espaços e limita o nome a 200 caracteres. Se o nome estiver vazio uma vez que caracteres invisíveis são removidos, Claude Code o rejeita e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. A substituição de caracteres e limite de comprimento requerem Claude Code v2.1.221 ou posterior. Se outra sessão ao vivo nesta máquina já usar um nome que você passa, Claude Code aplica [uma variante dele](/docs/pt/sessions#name-your-sessions) em vez disso |131| `/rename [name]` | Renomeie a sessão atual e mostre o nome na barra de prompt. Sem um nome, auto-gera 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. De cada superfície de renomeação, incluindo claude.ai e o aplicativo de desktop, Claude Code substitui caracteres de controle e invisíveis no novo nome com espaços e limita o nome a 200 caracteres. Se o nome estiver vazio uma vez que caracteres invisíveis são removidos, Claude Code o rejeita e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. A substituição de caracteres e limite de comprimento requerem Claude Code v2.1.221 ou posterior. Se outra sessão ativa nesta máquina já usar um nome que você passa, Claude Code aplica [uma variante dele](/docs/pt/sessions#name-your-sessions) |

132| `/resume [session]` | Retome uma conversa por ID ou nome, ou abra o seletor de sessão. [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` |132| `/resume [session]` | Retome uma conversa por ID ou nome, ou abra o seletor de sessão. [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` |

133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/pt/code-review#review-a-diff-locally): revisa o diff atual, ou um número de PR, branch ou caminho que você passa, como `/review 1234`, e toma os mesmos níveis de esforço e sinalizadores. Sem um nível dado, a revisão reutiliza o último nível `low` através `max` que você digitou; consulte [Revisar um diff localmente](/docs/pt/code-review#review-a-diff-locally) para as regras exatas. Para uma revisão na nuvem profunda, use [`/code-review ultra`](/docs/pt/ultrareview). Antes da v2.1.223, `/review` era um comando separado que executava uma revisão de pull request GitHub de passagem única e somente leitura por número, listando PRs abertos para escolher quando executado sem argumento; de v2.1.186 através v2.1.201, executava o mesmo mecanismo multi-agente que `/code-review medium` |133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/pt/code-review#review-a-diff-locally): revisa o diff atual, ou um número de PR, branch ou caminho que você passa, como `/review 1234`, e toma os mesmos níveis de esforço e sinalizadores. Sem um nível dado, a revisão reutiliza o último nível `low` através `max` que você digitou; consulte [Revise um diff localmente](/docs/pt/code-review#review-a-diff-locally) para as regras exatas. Para uma revisão em nuvem profunda, use [`/code-review ultra`](/docs/pt/ultrareview). Antes da v2.1.223, `/review` era um comando separado que executava uma revisão de uma única passagem, somente leitura de um pull request GitHub por número, listando PRs abertos para escolher quando executado sem argumento; de v2.1.186 através v2.1.201, executava o mesmo mecanismo multi-agente que `/code-review medium` |

134| `/rewind` | Rebobine a conversa e/ou código para um ponto anterior, ou resuma a partir de uma mensagem selecionada. Consulte [checkpointing](/docs/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |134| `/rewind` | Retroceda a conversa e/ou código para um ponto anterior, ou resuma a partir de uma mensagem selecionada. Consulte [checkpointing](/docs/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |

135| `/run` | **[Skill](/docs/pt/skills#bundled-skills).** Lance e dirija o app do seu projeto para ver uma mudança funcionando, não apenas passando testes. Consulte [Execute e verifique seu app](/docs/pt/skills#run-and-verify-your-app) |135| `/run` | **[Skill](/docs/pt/skills#bundled-skills).** Inicie e dirija o aplicativo do seu projeto para ver uma mudança funcionando, não apenas passando testes. Consulte [Execute e verifique seu aplicativo](/docs/pt/skills#run-and-verify-your-app) |

136| `/run-skill-generator` | **[Skill](/docs/pt/skills#bundled-skills).** Ensine `/run` e `/verify` como construir, lançar e dirigir o app do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/docs/pt/skills#run-and-verify-your-app) por projeto |136| `/run-skill-generator` | **[Skill](/docs/pt/skills#bundled-skills).** Ensine `/run` e `/verify` como construir, iniciar e dirigir o aplicativo do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/docs/pt/skills#run-and-verify-your-app) por projeto |

138| `/schedule [description]` | Crie, atualize, liste ou execute [rotinas](/docs/pt/routines), que são executadas na nuvem. Claude o orienta através da configuração conversacionalmente. Você também pode perguntar sobre [execuções recentes de uma rotina](/docs/pt/routines#manage-routines-from-the-cli). Alias: `/routines` |138| `/schedule [description]` | Crie, atualize, liste ou execute [rotinas](/docs/pt/routines), que são executadas na nuvem. Claude o orienta através da configuração conversacionalmente. Você também pode perguntar sobre [execuções recentes de uma rotina](/docs/pt/routines#manage-routines-from-the-cli). Alias: `/routines` |

139| `/scroll-speed` | Ajuste 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 mudança. Disponível em [renderização tela cheia](/docs/pt/fullscreen) apenas e não no terminal IDE JetBrains |139| `/scroll-speed` | Ajuste a [velocidade de rolagem](/docs/pt/fullscreen#mouse-wheel-scrolling) da roda do mouse interativamente, com uma régua que você pode rolar enquanto o diálogo está aberto para visualizar a mudança. Disponível em [renderização tela cheia](/docs/pt/fullscreen) apenas e não no terminal IDE JetBrains |

140| `/security-review` | Analise as mudanças em seu branch atual para vulnerabilidades de segurança. Revisa o diff entre seu branch e o branch padrão da origem, identificando riscos como injeção, problemas de autenticação e exposição de dados. Precisa de um remoto `origin`; se a revisão falhar com um erro `ambiguous argument`, consulte a [referência de erro](/docs/pt/errors#security-review-fails-without-origin-head) |140| `/security-review` | Analise as mudanças em seu branch atual para vulnerabilidades de segurança. Revisa o diff entre seu branch e o branch padrão da origem, identificando riscos como injeção, problemas de autenticação e exposição de dados. Precisa de um remoto `origin`; se a revisão falhar com um erro `ambiguous argument`, consulte a [referência de erro](/docs/pt/errors#security-review-fails-without-origin-head) |

141| `/setup-bedrock` | Configure autenticação, região e pinos de modelo [Amazon Bedrock](/docs/pt/amazon-bedrock) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_BEDROCK=1` seja definido; digite-o por completo. Usuários do Amazon Bedrock pela primeira vez também podem acessar este assistente da tela de login |141| `/setup-bedrock` | Configure autenticação, região e pinos de modelo [Amazon Bedrock](/docs/pt/amazon-bedrock) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_BEDROCK=1` seja definido; digite-o por completo. Usuários do Amazon Bedrock pela primeira vez também podem acessar este assistente da tela de login |

142| `/setup-vertex` | Configure autenticação, projeto, região e pinos de modelo [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_VERTEX=1` seja definido; digite-o por completo. Usuários do Google Cloud's Agent Platform pela primeira vez também podem acessar este assistente da tela de login |142| `/setup-vertex` | Configure autenticação, projeto, região e pinos de modelo [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_VERTEX=1` seja definido; digite-o por completo. Usuários do Google Cloud's Agent Platform pela primeira vez também podem acessar este assistente da tela de login |

143| `/simplify [target]` | **[Skill](/docs/pt/skills#bundled-skills).** Revise o código alterado para oportunidades de limpeza e aplique 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 mudança está no nível certo de abstração. A revisão não procura por bugs de correção. Use `/code-review` para encontrar bugs. Passe um caminho ou referência de PR para revisar um alvo específico |143| `/simplify [target]` | **[Skill](/docs/pt/skills#bundled-skills).** Revise o código alterado para oportunidades de limpeza e aplique 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 mudança está no nível certo de abstração. A revisão não procura por bugs de correção. Use `/code-review` para encontrar bugs. Passe um caminho ou referência de PR para revisar um alvo específico |

144| `/skill-doctor` | Mostre o que cada uma de suas [skills](/docs/pt/skills) custa em contexto e com que frequência é usada, para que você possa [encontrar skills para desativar](/docs/pt/skills#find-unused-skills). Requer Claude Code v2.1.252 ou posterior e [busca de sinalizador de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching) |144| `/skill-doctor` | Mostre o que cada uma de suas [skills](/docs/pt/skills) custa em contexto e com que frequência é usada, para que você possa [encontrar skills para desativar](/docs/pt/skills#find-unused-skills). Requer Claude Code v2.1.252 ou posterior e [busca de sinalizador de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching) |

145| `/skills` | Liste [skills](/docs/pt/skills) disponíveis. Digite para filtrar a lista por nome, descrição ou fonte. Pressione `t` para ordenar por contagem de token, `Space` ou `Enter` para [ciclar a visibilidade de uma skill para Claude e o menu `/`](/docs/pt/skills#override-skill-visibility-from-settings) e `Esc` para salvar e fechar. Você não pode ciclar skills de plugin, skills cuja frontmatter define `disable-model-invocation: true` ou skills com uma entrada `skillOverrides` em configurações gerenciadas ou o sinalizador `--settings` |145| `/skills` | Liste [skills](/docs/pt/skills) disponíveis. Digite para filtrar a lista por nome, descrição ou fonte. Pressione `t` para classificar por contagem de token, `Space` ou `Enter` para [ciclar a visibilidade de uma skill para Claude e o menu `/`](/docs/pt/skills#override-skill-visibility-from-settings), e `Esc` para salvar e fechar. Você não pode ciclar skills de plugin, skills cuja frontmatter define `disable-model-invocation: true` ou skills com uma entrada `skillOverrides` em configurações gerenciadas ou o sinalizador `--settings` |

147| `/status` | Abra a interface Configurações na aba Status, mostrando versão, modelo, conta e conectividade. Uma linha `Session kind` lê `background job · attached` ou `background job · unattended` em uma [sessão de fundo](/docs/pt/agent-view), dependendo se um terminal está anexado, e `interactive` em qualquer outra sessão. Antes da v2.1.221, `/status` não mostrava esta linha. Funciona enquanto Claude está respondendo |147| `/status` | Abra a interface de Configurações na aba Status, mostrando versão, modelo, conta e conectividade. Uma linha `Session kind` lê `background job · attached` ou `background job · unattended` em uma [sessão de fundo](/docs/pt/agent-view), dependendo se um terminal está anexado, e `interactive` em qualquer outra sessão. Antes da v2.1.221, `/status` não mostrava esta linha. Funciona enquanto Claude está respondendo |

148| `/statusline` | Configure 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 |148| `/statusline` | Configure 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 |

150| `/stop` | Pare 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 `←` |150| `/stop` | Pare 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 `←` |

151| `/subtask <task>` | Inicie um [subagente bifurcado](/docs/pt/sub-agents#fork-the-current-conversation): um subagente de fundo que herda a conversa completa e trabalha na tarefa enquanto você continua trabalhando. Seu resultado retorna para esta conversa quando termina. Para copiar a conversa em uma sessão de fundo separada em vez disso, use `/fork`. Requer Claude Code v2.1.212 ou posterior; na v2.1.161 através v2.1.211 este comando é `/fork`. Quando [agent view está desativado](/docs/pt/agent-view#turn-off-agent-view), `/subtask` não está disponível e `/fork` mantém o comportamento de subagente bifurcado |151| `/subtask <task>` | Inicie um [subagente bifurcado](/docs/pt/sub-agents#fork-the-current-conversation): um subagente de fundo que herda a conversa completa e trabalha na tarefa enquanto você continua trabalhando. Seu resultado retorna para esta conversa quando termina. Para copiar a conversa em uma sessão de fundo separada, use `/fork`. Requer Claude Code v2.1.212 ou posterior; na v2.1.161 através v2.1.211 este comando é `/fork`. Quando [a visualização de agente está desativada](/docs/pt/agent-view#turn-off-agent-view), `/subtask` não está disponível e `/fork` mantém o comportamento de subagente bifurcado |

152| `/tasks` | Veja e gerencie trabalho de fundo na sessão atual, incluindo subagentes que terminaram. Também disponível como `/bashes` |152| `/tasks` | Veja e gerencie trabalho de fundo na sessão atual, incluindo subagentes que terminaram. Também disponível como `/bashes` |

153| `/team-onboarding` | Gere um guia de integração de equipe a partir do seu histórico de uso 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 pode colar como primeira mensagem para se configurar rapidamente. Para assinantes claude.ai em planos Pro, Max, Team e Enterprise, também retorna um link de compartilhamento que colegas podem abrir diretamente em Claude Code |153| `/team-onboarding` | Gere 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 pode colar como primeira mensagem para se configurar rapidamente. Para assinantes claude.ai em planos Pro, Max, Team e Enterprise, também retorna um link de compartilhamento que colegas podem abrir diretamente em Claude Code |

154| `/teleport` | Puxe uma sessão [Claude Code na web](/docs/pt/claude-code-on-the-web#from-cloud-to-terminal) para este terminal. Abre um seletor, depois busca o branch e conversa. Também disponível como `/tp`. Requer uma assinatura claude.ai |154| `/teleport` | Puxe uma [sessão em nuvem](/docs/pt/claude-code-on-the-web#from-cloud-to-terminal) para este terminal. Abre um seletor, depois busca o branch e conversa. Também disponível como `/tp`. Requer uma assinatura claude.ai |

155| `/terminal-setup` | [Instale um atalho de teclado Shift+Enter para novas linhas](/docs/pt/terminal-config#enter-multiline-prompts) em VS Code, Cursor, Devin Desktop, Alacritty ou Zed. No Apple Terminal, [ative Option+Enter para novas linhas e desative o sino audível](/docs/pt/terminal-config#enable-option-key-shortcuts-on-macos) em vez disso. No iTerm2, [ative acesso à área de transferência para que `/copy` funcione](/docs/pt/terminal-config#enable-option-key-shortcuts-on-macos) |155| `/terminal-setup` | [Instale um atalho de teclado Shift+Enter para novas linhas](/docs/pt/terminal-config#enter-multiline-prompts) em VS Code, Cursor, Devin Desktop, Alacritty ou Zed. No Apple Terminal, [ative Option+Enter para novas linhas e desative o sino audível](/docs/pt/terminal-config#enable-option-key-shortcuts-on-macos). No iTerm2, [ative acesso à área de transferência para que `/copy` funcione](/docs/pt/terminal-config#enable-option-key-shortcuts-on-macos) |

156| `/theme` | Mude o tema de cor. Inclui uma opção `auto` que corresponde ao fundo claro ou escuro do seu terminal, variantes claras e escuras, 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 |156| `/theme` | Altere o tema de cor. Inclui uma opção `auto` que corresponde ao fundo claro ou escuro do seu terminal, variantes claras e escuras, temas acessíveis para daltonismo (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 |

157| `/tui [default\|fullscreen]` | Defina o renderizador de UI de terminal e relance nele com sua conversa intacta. `fullscreen` ativa o [renderizador alt-screen sem cintilação](/docs/pt/fullscreen). Sem argumento, imprime o renderizador ativo |157| `/tui [default\|fullscreen]` | Defina o renderizador de UI de terminal e reinicie nele com sua conversa intacta. `fullscreen` ativa o [renderizador alt-screen sem cintilação](/docs/pt/fullscreen). Sem argumento, imprime o renderizador ativo |

158| `/ultraplan <prompt>` | Removido. Use [modo plano](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) em vez disso. Anteriormente enviava uma tarefa de planejamento para uma sessão [Claude Code na web](/docs/pt/claude-code-on-the-web) para revisão no seu navegador |158| `/ultraplan <prompt>` | Removido. Use [modo de plano](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode). Anteriormente enviava uma tarefa de planejamento para uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) para revisão no seu navegador |

159| `/ultrareview [PR or branch]` | Execute uma revisão de código profunda e multi-agente em uma sandbox na nuvem com [ultrareview](/docs/pt/ultrareview). Passe uma referência de PR para revisar esse pull request, ou um nome de branch para mudar a base de comparação. 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) |159| `/ultrareview [PR or branch]` | Execute uma revisão de código profunda e multi-agente em uma sandbox em nuvem com [ultrareview](/docs/pt/ultrareview). Passe uma referência de PR para revisar esse pull request, ou um branch base ou commit para alterar a base de comparação. A invocação preferida é `/code-review ultra`, e `/ultrareview` é 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) |

160| `/update-config [request]` | **[Skill](/docs/pt/skills#bundled-skills).** Descreva uma mudança de configurações, como permitir um comando, definir uma variável de ambiente ou adicionar um [hook](/docs/pt/hooks), e Claude edita o arquivo [`settings.json`](/docs/pt/settings) correspondente. Para opções como tema e modelo, use `/config` |

160| `/upgrade` | Abra a página de atualização no seu navegador para mudar para um nível de plano superior. Quando o navegador falha em abrir, o comando mostra um prompt de login sem imprimir a URL |161| `/upgrade` | Abra a página de atualização no seu navegador para mudar para um nível de plano superior. Quando o navegador falha em abrir, o comando mostra um prompt de login sem imprimir a URL |

161| `/usage` | Mostre custo de sessão, limites de uso do plano e estatísticas de atividade. Em um plano Pro, Max, Team ou Enterprise, inclui um [detalhamento do que conta contra seus limites de plano](/docs/pt/costs#plan-usage-breakdown). `/cost` e `/stats` são aliases |162| `/usage` | Mostre custo de sessão, limites de uso do plano e estatísticas de atividade. Em um plano Pro, Max, Team ou Enterprise, inclui um [detalhamento do que conta contra seus limites de plano](/docs/pt/costs#plan-usage-breakdown). `/cost` e `/stats` são aliases |

162| `/usage-credits` | Configure créditos de uso, ou solicite-os do seu admin, quando você atinge um limite. Abre suas [configurações de faturamento de créditos de uso](/docs/pt/costs#add-usage-credits-to-your-subscription) no navegador, exceto que membros de Team e Enterprise sem acesso de faturamento enviam uma solicitação de créditos de uso para seu admin da CLI, após confirmar em um diálogo que a solicitação notifica seus admins. 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 mostravam nada nesse caso. Anteriormente `/extra-usage` |163| `/usage-credits` | Configure créditos de uso, ou solicite-os do seu administrador, quando você atinge um limite. Abre suas [configurações de faturamento de créditos de uso](/docs/pt/costs#add-usage-credits-to-your-subscription) no navegador, exceto que membros de Team e Enterprise sem acesso de faturamento enviam uma solicitação de créditos de uso para seu administrador a partir da CLI, após confirmar em um diálogo que a solicitação notifica seus administradores. Quando nenhum navegador pode abrir a página de faturamento, por exemplo sobre SSH, o comando imprime a URL para visitar; isso requer Claude Code v2.1.205 ou posterior, e versões anteriores não mostravam nada nesse caso. Anteriormente `/extra-usage` |

163| `/verify` | **[Skill](/docs/pt/skills#bundled-skills).** Confirme que uma mudança de código faz o que deveria construindo o app do seu projeto, executando-o e observando o resultado, em vez de confiar em testes ou verificações de tipo. Consulte [Execute e verifique seu app](/docs/pt/skills#run-and-verify-your-app) |164| `/verify` | **[Skill](/docs/pt/skills#bundled-skills).** Confirme que uma mudança de código faz o que deveria construindo o aplicativo do seu projeto, executando-o e observando o resultado, em vez de confiar em testes ou verificações de tipo. Consulte [Execute e verifique seu aplicativo](/docs/pt/skills#run-and-verify-your-app) |

164| `/vim` | Removido na v2.1.92. Para alternar entre modos de edição Vim e Normal, use `/config` → Editor mode |165| `/vim` | Removido na v2.1.92. Para alternar entre modos de edição Vim e Normal, use `/config` → Editor mode |

165| `/voice [hold\|tap\|off]` | Alterne [ditado por voz](/docs/pt/voice-dictation) ou ative-o em um modo específico. Requer uma conta Claude.ai |166| `/voice [hold\|tap\|off]` | Alterne [ditado por voz](/docs/pt/voice-dictation), ou ative-o em um modo específico. Requer uma conta Claude.ai |

166| `/web-setup` | Conecte sua conta GitHub a [Claude Code na web](/docs/pt/web-quickstart#connect-from-your-terminal) usando suas credenciais locais da CLI `gh` |167| `/web-setup` | Conecte sua conta GitHub para [sessões em nuvem](/docs/pt/web-quickstart#connect-from-your-terminal) usando suas credenciais locais de CLI `gh` |

167| `/workflow-authoring` | **[Skill](/docs/pt/skills#bundled-skills).** Carregue a referência para escrever scripts [dynamic workflow](/docs/pt/workflows): a API de script, comportamento de retomada, padrões de qualidade e exemplos trabalhados. Claude normalmente o carrega por conta própria antes de escrever um script; execute-o você mesmo antes de [editar um script salvo manualmente](/docs/pt/workflows#edit-a-saved-script). Disponível quando workflows dinâmicos estão habilitados e requer Claude Code v2.1.248 ou posterior |168| `/workflow-authoring` | **[Skill](/docs/pt/skills#bundled-skills).** Carregue a referência para escrever scripts de [workflow dinâmico](/docs/pt/workflows): a API de script, comportamento de retomada, padrões de qualidade e exemplos trabalhados. Claude normalmente o carrega por conta própria antes de escrever um script; execute-o você mesmo antes de [editar um script salvo manualmente](/docs/pt/workflows#edit-a-saved-script). Disponível quando workflows dinâmicos estão ativados e requer Claude Code v2.1.248 ou posterior |

168| `/workflows` | Abra 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 |169| `/workflows` | Abra 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 |

169 170

170<h2 id="how-the-command-menu-matches-what-you-type">171<h2 id="how-the-command-menu-matches-what-you-type">

171 Como o menu de comandos corresponde ao que você digita172 Como o menu de comandos corresponde ao que você digita

common-workflows.md +1 −1

Details

329 329

330 1. Arraste e solte uma imagem na janela do Claude Code330 1. Arraste e solte uma imagem na janela do Claude Code

331 2. Copie uma imagem e cole-a no CLI com `Ctrl+V`, ou com [`Alt+V` no Windows e WSL](/docs/pt/interactive-mode#general-controls)331 2. Copie uma imagem e cole-a no CLI com `Ctrl+V`, ou com [`Alt+V` no Windows e WSL](/docs/pt/interactive-mode#general-controls)

332 3. Forneça um caminho de imagem ao Claude. Por exemplo, "Analyze this image: /path/to/your/image.png"332 3. Forneça um caminho de imagem ao Claude, por exemplo "Analyze this image: /path/to/your/image.png"

333 </Step>333 </Step>

334 334

335 <Step title="Peça ao Claude para analisar a imagem">335 <Step title="Peça ao Claude para analisar a imagem">

communications-kit.md +6 −6

Details

102 📚 Guia de início rápido · VS Code · Curso gratuito de 1 hora102 📚 Guia de início rápido · VS Code · Curso gratuito de 1 hora

103 https://code.claude.com/docs/pt/quickstart103 https://code.claude.com/docs/pt/quickstart

104 https://code.claude.com/docs/pt/vs-code104 https://code.claude.com/docs/pt/vs-code

105 https://anthropic.skilljar.com/claude-code-in-action105 https://academy.claude.com/courses/claude-code-in-action

106 106

107 Perguntas → esta thread. [Proprietário] está na ponta.107 Perguntas → esta thread. [Proprietário] está na ponta.

108 ```108 ```

230*Fable* é o modelo mais230*Fable* é o modelo mais

231capaz para suas tarefas mais difíceis e de longa duração; não é o231capaz para suas tarefas mais difíceis e de longa duração; não é o

232padrão, então selecione-o com `/model fable`, e observe que conteúdo de cibersegurança e232padrão, então selecione-o com `/model fable`, e observe que conteúdo de cibersegurança e

233biologia volta automaticamente para Opus. Opus 5 executa suas próprias233biologia volta automaticamente para Opus. Opus 5.5 e Opus 5 executam

234verificações, então conteúdo de cibersegurança sinalizado muda de modelos e conteúdo234suas próprias verificações também: conteúdo sinalizado muda para um Opus anterior, exceto

235de biologia sinalizado é recusado.235que conteúdo de biologia sinalizado no Opus 5 é recusado.

236 236

237*Tente agora:* digite `/model` e escolha Sonnet se você ainda não o fez. É237*Tente agora:* digite `/model` e escolha Sonnet se você ainda não o fez. É

238o padrão certo para a maioria das tarefas.238o padrão certo para a maioria das tarefas.

241```241```

242 242

243| Modelo | Melhor para |243| Modelo | Melhor para |

244| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |244| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

245| Fable | As tarefas mais difíceis e de longa duração. Apenas com opt-in: selecione com `/model fable`. Conteúdo de cibersegurança ou biologia dispara [fallback automático de modelo para Opus](/docs/pt/model-config#automatic-model-fallback) |245| Fable | As tarefas mais difíceis e de longa duração. Apenas com opt-in: selecione com `/model fable`. Conteúdo de cibersegurança ou biologia dispara [fallback automático de modelo para Opus](/docs/pt/model-config#automatic-model-fallback) |

246| Opus | Refatorações em larga escala, depuração complexa, decisões de arquitetura, mudanças de alto risco. No Opus 5, conteúdo de cibersegurança ou biologia dispara [fallback automático de modelo ou uma recusa](/docs/pt/model-config#automatic-model-fallback) |246| Opus | Refatorações em larga escala, depuração complexa, decisões de arquitetura, mudanças de alto risco. No Opus 5.5 e Opus 5, conteúdo de cibersegurança ou biologia dispara [fallback automático de modelo ou uma recusa](/docs/pt/model-config#automatic-model-fallback) |

247| Sonnet | Trabalho de recursos cotidianos, correções de bugs, testes, documentação, revisão de código. Padrão recomendado. |247| Sonnet | Trabalho de recursos cotidianos, correções de bugs, testes, documentação, revisão de código. Padrão recomendado. |

248| Haiku | Perguntas rápidas, formatação, edições mecânicas, iteração rápida |248| Haiku | Perguntas rápidas, formatação, edições mecânicas, iteração rápida |

249 249

context-window.md +3 −2

Details

35 tokens: 280,35 tokens: 280,

36 color: '#6B6964',36 color: '#6B6964',

37 vis: 'hidden',37 vis: 'hidden',

~~38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block at the very end of the system prompt.',~~38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block.',

39 link: null39 link: null

40 }, {40 }, {

41 t: 0.08,41 t: 0.08,

1589* **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. [Arquivos AGENTS.md](/docs/pt/memory#agents-md) também podem ser carregados, por conta própria ou junto com CLAUDE.md. 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).1589* **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. [Arquivos AGENTS.md](/docs/pt/memory#agents-md) também podem ser carregados, por conta própria ou junto com CLAUDE.md. 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).

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

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

1592* **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.1592* **No final da apresentação**: você executa `/compact`, que 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.

1593 1593

1594<h2 id="what-survives-compaction">1594<h2 id="what-survives-compaction">

1595 O que sobrevive à compactação1595 O que sobrevive à compactação

1602| Prompt do sistema e estilo de saída | Ambos ainda se aplicam |1602| Prompt do sistema e estilo de saída | Ambos ainda se aplicam |

1603| CLAUDE.md na raiz do projeto e regras sem escopo | Re-injetado do disco |1603| CLAUDE.md na raiz do projeto e regras sem escopo | Re-injetado do disco |

1604| Memória automática | Re-injetado do disco |1604| Memória automática | Re-injetado do disco |

1605| [Snapshot de status do Git](/docs/pt/settings-reference#includegitinstructions) | Claude Code lê um novo do seu repositório |

1605| O plano que Claude escreveu em [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) | Re-injetado do disco |1606| O plano que Claude escreveu em [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) | Re-injetado do disco |

1607| CLAUDE.md aninhado em subdiretórios | Claude Code as recarrega conforme Claude lê arquivos nesse subdiretório |1608| CLAUDE.md aninhado em subdiretórios | Claude Code as recarrega conforme Claude lê arquivos nesse subdiretório |

costs.md +3 −3

Details

37 37

38Esses totais são redefinidos quando `/clear` inicia uma nova sessão, portanto, o custo total da próxima sessão começa em \$0. Antes da v2.1.211, eles continuavam acumulando em `/clear` durante a vida útil do processo Claude Code.38Esses totais são redefinidos quando `/clear` inicia uma nova sessão, portanto, o custo total da próxima sessão começa em \$0. Antes da v2.1.211, eles continuavam acumulando em `/clear` durante a vida útil do processo Claude Code.

39 39

40Para uma resposta da API Claude faturada na [taxa de residência de dados](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) de 1,1×, Claude Code multiplica o preço de tabela dos tokens dessa resposta por 1,1 na figura de custo da sessão. Claude Code relata o mesmo total na [linha de status do campo de custo](/docs/pt/statusline#cost-and-duration-tracking) e o compara com [`--max-budget-usd`](/docs/pt/cli-reference#cli-flags). Antes da v2.1.239, Claude Code não aplicava o 1,1× a essas respostas, portanto, a figura de custo da sessão era menor que a fatura.40Para uma resposta da API Claude faturada na [taxa de residência de dados](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) de 1,1×, Claude Code multiplica o preço de tabela dos tokens dessa resposta por 1,1 na figura de custo da sessão. O mesmo total aparece na [linha de status do campo de custo](/docs/pt/statusline#cost-and-duration-tracking), e a figura multiplicada também conta para [`--max-budget-usd`](/docs/pt/cli-reference#cli-flags). Antes da v2.1.239, Claude Code não aplicava o 1,1× a essas respostas, portanto, a figura de custo da sessão era menor que a fatura.

41 41

42<h4 id="prompt-cache-statistics">42<h4 id="prompt-cache-statistics">

43 Estatísticas de cache de prompt43 Estatísticas de cache de prompt

275 Escolha o modelo certo275 Escolha o modelo certo

276</h3>276</h3>

277 277

278Sonnet lida bem com a maioria das tarefas de codificação e custa menos que Opus. Reserve Opus para decisões arquitetônicas complexas ou raciocínio em múltiplas etapas. Use `/model` para alternar modelos no meio da sessão, ou defina um padrão em `/config`. Para tarefas simples de subagente, especifique `model: haiku` em sua [configuração de subagente](/docs/pt/sub-agents#choose-a-model).278Sonnet lida bem com a maioria das tarefas de codificação e custa menos que Opus. Reserve Opus para decisões arquitetônicas complexas ou raciocínio em múltiplas etapas. Use `/model` para alternar modelos no meio da sessão, ou defina um padrão em `/config`. Uma mudança para Opus também se aplica aos [subagentes que herdam o modelo da sua sessão](/docs/pt/model-config#setting-your-model). Para tarefas simples de subagente, especifique `model: haiku` em sua [configuração de subagente](/docs/pt/sub-agents#choose-a-model).

279 279

280<h3 id="reduce-mcp-server-overhead">280<h3 id="reduce-mcp-server-overhead">

281 Reduza a sobrecarga do servidor MCP281 Reduza a sobrecarga do servidor MCP

359 359

360O pensamento estendido é habilitado por padrão porque melhora significativamente o desempenho em tarefas complexas de planejamento e raciocínio. Tokens de pensamento são faturados como tokens de saída, e o orçamento padrão pode ser dezenas de milhares de tokens por solicitação dependendo do modelo.360O pensamento estendido é habilitado por padrão porque melhora significativamente o desempenho em tarefas complexas de planejamento e raciocínio. Tokens de pensamento são faturados como tokens de saída, e o orçamento padrão pode ser dezenas de milhares de tokens por solicitação dependendo do modelo.

361 361

362Para tarefas mais simples onde raciocínio profundo não é necessário, você pode reduzir custos baixando o [nível de esforço](/docs/pt/model-config#adjust-effort-level) com `/effort` ou em `/model`, ou desabilitando pensamento em `/config`. Você não pode desativar pensamento em modelos Fable, que sempre usam pensamento estendido.362Para tarefas mais simples onde raciocínio profundo não é necessário, você pode reduzir custos baixando o [nível de esforço](/docs/pt/model-config#adjust-effort-level) com `/effort` ou em `/model`, ou desabilitando pensamento em `/config`. Você não pode desativar pensamento em Opus 5.5 ou nos modelos Fable, que sempre usam pensamento estendido.

363 363

364Em modelos com um [orçamento de pensamento fixo](/docs/pt/model-config#adaptive-reasoning-and-fixed-thinking-budgets), você também pode baixar o orçamento definindo a [variável de ambiente](/docs/pt/env-vars) `MAX_THINKING_TOKENS`, por exemplo `MAX_THINKING_TOKENS=8000`. Modelos de raciocínio adaptativo ignoram orçamentos diferentes de zero, portanto use níveis de esforço lá em vez disso.364Em modelos com um [orçamento de pensamento fixo](/docs/pt/model-config#adaptive-reasoning-and-fixed-thinking-budgets), você também pode baixar o orçamento definindo a [variável de ambiente](/docs/pt/env-vars) `MAX_THINKING_TOKENS`, por exemplo `MAX_THINKING_TOKENS=8000`. Modelos de raciocínio adaptativo ignoram orçamentos diferentes de zero, portanto use níveis de esforço lá em vez disso.

365 365

desktop.md +2 −2

Details

508 508

509Você pode escopar plugins 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.509Você pode escopar plugins 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.

510 510

511O navegador de plugins não está disponível em sessões cloud, e plugins que você instala do aplicativo desktop não estão disponíveis para sessões cloud. Para usar um plugin em uma sessão cloud, declare-o no `.claude/settings.json` do repositório sob [`enabledPlugins`](/docs/pt/settings-reference#enabledplugins) para que Claude Code [o instale no início da sessão](/docs/pt/cloud-environments#what-carries-over-from-your-setup), ou habilite-o para sua conta claude.ai para que Claude Code o carregue como um [plugin sincronizado](/docs/pt/plugins-reference#synced-plugins). Plugins não estão disponíveis em sessões WSL. Para a referência completa de plugins incluindo criar seus próprios plugins, veja [plugins](/docs/pt/plugins).511O navegador de plugins não está disponível em sessões cloud, e plugins que você instala do aplicativo desktop não estão disponíveis para sessões cloud. Uma sessão cloud também não instala plugins que o `.claude/settings.json` do repositório declara, como [O que é transferido de sua configuração](/docs/pt/cloud-environments#what-carries-over-from-your-setup) explica. Para usar um plugin em uma sessão cloud, habilite-o para sua conta claude.ai para que Claude Code o carregue como um [plugin sincronizado](/docs/pt/plugins-reference#synced-plugins). Plugins não estão disponíveis em sessões WSL. Para a referência completa de plugins incluindo criar seus próprios plugins, veja [plugins](/docs/pt/plugins).

512 512

513<h3 id="configure-preview-servers">513<h3 id="configure-preview-servers">

514 Configurar servidores de visualização514 Configurar servidores de visualização

735 735

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

737 737

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

739 739

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

741 741

desktop-linux.md +1 −1

Details

16 Requisitos16 Requisitos

17</h2>17</h2>

18 18

~~19* Ubuntu 22.04 ou posterior, ou Debian 12 ou posterior~~19* Uma distribuição baseada em Debian: Ubuntu 22.04 ou posterior, ou Debian 12 ou posterior

20* x86\_64 ou arm6420* x86\_64 ou arm64

21 21

22Outras distribuições baseadas em Debian que atendem a esses requisitos podem funcionar, mas não são oficialmente testadas. Em distribuições que não são baseadas em Debian, como Fedora ou Arch, execute a [CLI](/docs/pt/setup#system-requirements) em vez disso. Se você trabalha no Windows com WSL 2, instale o aplicativo de desktop do Windows e execute sessões dentro de sua distribuição; consulte [Claude Code Desktop em WSL](/docs/pt/desktop-wsl).22Outras distribuições baseadas em Debian que atendem a esses requisitos podem funcionar, mas não são oficialmente testadas. Em distribuições que não são baseadas em Debian, como Fedora ou Arch, execute a [CLI](/docs/pt/setup#system-requirements) em vez disso. Se você trabalha no Windows com WSL 2, instale o aplicativo de desktop do Windows e execute sessões dentro de sua distribuição; consulte [Claude Code Desktop em WSL](/docs/pt/desktop-wsl).

discover-plugins.md +7 −3

Details

42/plugin install github@claude-plugins-official42/plugin install github@claude-plugins-official

43```43```

44 44

45`/plugin` abre um painel interativo no CLI do terminal. Se Claude responder que `/plugin` não está disponível neste ambiente, use o [navegador de plugins](/docs/pt/desktop#install-plugins) no aplicativo desktop do Claude, ou declare o plugin em [`enabledPlugins`](/docs/pt/settings-reference#enabledplugins) em `.claude/settings.json` para sessões na nuvem.45`/plugin` abre um painel interativo no CLI do terminal. Se Claude responder que `/plugin` não está disponível neste ambiente, instale o plugin de outra forma:

47* **Aplicativo desktop do Claude**: use o [navegador de plugins](/docs/pt/desktop#install-plugins).

48* **Extensão VS Code**: instale a partir do [diálogo **Manage plugins**](/docs/pt/vs-code#manage-plugins).

49* **Sessões na nuvem**: ative o plugin para sua conta claude.ai para que o Claude Code o carregue como um [plugin sincronizado](/docs/pt/plugins-reference#synced-plugins).

46 50

47Se a instalação falhar, corresponda a mensagem que o Claude Code relata:51Se a instalação falhar, corresponda a mensagem que o Claude Code relata:

48 52

360Claude Code procura o plugin em sua cópia local do catálogo de marketplace. Como você nomeia o plugin controla se Claude Code atualiza essa cópia primeiro:364Claude Code procura o plugin em sua cópia local do catálogo de marketplace. Como você nomeia o plugin controla se Claude Code atualiza essa cópia primeiro:

361 365

362* **Com um nome de marketplace**: quando você instala `plugin-name@marketplace-name`, em uma sessão ou com `claude plugin install`, Claude Code atualiza esse marketplace antes da busca. Claude Code executa a atualização mesmo se você desativou [auto-update](#configure-auto-updates) para o marketplace ou definiu `DISABLE_AUTOUPDATER`. Antes da v2.1.232, Claude Code não atualizava o marketplace antes da busca. Claude Code pula essa atualização quando:366* **Com um nome de marketplace**: quando você instala `plugin-name@marketplace-name`, em uma sessão ou com `claude plugin install`, Claude Code atualiza esse marketplace antes da busca. Claude Code executa a atualização mesmo se você desativou [auto-update](#configure-auto-updates) para o marketplace ou definiu `DISABLE_AUTOUPDATER`. Antes da v2.1.232, Claude Code não atualizava o marketplace antes da busca. Claude Code pula essa atualização quando:

363 * O marketplace não foi [adicionado do GitHub, outro host Git ou uma URL remota](#add-marketplaces).367 * O marketplace não foi [adicionado do GitHub, outro host Git ou uma URL remota](#add-marketplaces), ou [claude.ai](#add-from-claude-ai).

364 * Um [diretório seed](/docs/pt/plugin-marketplaces#pre-populate-plugins-for-containers) fornece o marketplace.368 * Um [diretório seed](/docs/pt/plugin-marketplaces#pre-populate-plugins-for-containers) fornece o marketplace.

365 * Claude Code atualizou o marketplace nos últimos 30 segundos.369 * Claude Code atualizou o marketplace nos últimos 30 segundos.

366 * Você definiu [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars).370 * Você definiu [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars).

395 399

396A fonte assume [as mesmas formas que `/plugin marketplace add`](#add-marketplaces), como GitHub `owner/repo`, uma URL git ou um caminho local, exceto que não pode conter espaços. Dê o nome do plugin sem um sufixo `@marketplace`.400A fonte assume [as mesmas formas que `/plugin marketplace add`](#add-marketplaces), como GitHub `owner/repo`, uma URL git ou um caminho local, exceto que não pode conter espaços. Dê o nome do plugin sem um sufixo `@marketplace`.

397 401

398Se você ainda não adicionou esse marketplace, Claude Code mostra a fonte que resolveu e pede que você confirme antes de adicioná-lo. Recusar cancela a instalação e não adiciona nada. Uma vez que o marketplace é adicionado, os detalhes do plugin abrem e você escolhe um [escopo de instalação](/docs/pt/settings#where-settings-live).402Claude Code mostra a fonte que resolveu e pede que você confirme antes de adicionar o marketplace. Recusar cancela a instalação e não adiciona nada. Uma vez que o marketplace é adicionado, os detalhes do plugin abrem e você escolhe um [escopo de instalação](/docs/pt/settings#where-settings-live). Se a fonte corresponder a um marketplace que você já adicionou, Claude Code pula a confirmação e abre os detalhes do plugin nesse marketplace.

399 403

400<h2 id="manage-installed-plugins">404<h2 id="manage-installed-plugins">

401 Gerencie plugins instalados405 Gerencie plugins instalados

env-vars.md +7 −3

Details

271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Defina como `1` para desabilitar registro automático do marketplace de plugin oficial. Claude Code lê a variável quando está prestes a registrar o marketplace, geralmente durante o primeiro lançamento interativo de uma máquina. Se a variável estiver definida nesse ponto, Claude Code pula o registro permanentemente. Desconfigurar a variável depois não desfaz o pulo. Execute `claude plugin marketplace add anthropics/claude-plugins-official` para registrar o marketplace a qualquer momento |271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Defina como `1` para desabilitar registro automático do marketplace de plugin oficial. Claude Code lê a variável quando está prestes a registrar o marketplace, geralmente durante o primeiro lançamento interativo de uma máquina. Se a variável estiver definida nesse ponto, Claude Code pula o registro permanentemente. Desconfigurar a variável depois não desfaz o pulo. Execute `claude plugin marketplace add anthropics/claude-plugins-official` para registrar o marketplace a qualquer momento |

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

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Defina como `1` para pular carregamento de skills do diretório de skills gerenciado em todo o sistema. Útil para sessões de container ou CI que não devem carregar skills provisionadas por operador |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Defina como `1` para pular carregamento de skills do diretório de skills gerenciado em todo o sistema. Útil para sessões de container ou CI que não devem carregar skills provisionadas por operador |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Defina como `1` para desabilitar atualizações automáticas de título de terminal com base no contexto de conversa. Em sessões Agent SDK e `claude -p`, isso também pula a solicitação de modelo pequeno/rápido em segundo plano que gera o título da sessão |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Defina como `1` para desabilitar atualizações automáticas de título de terminal com base no contexto de conversa. Isso também pula a solicitação de modelo pequeno/rápido em segundo plano que [gera um título de sessão](/docs/pt/sessions#name-your-sessions) |

275| `CLAUDE_CODE_DISABLE_THINKING` | Defina como `1` para omitir o parâmetro `thinking` de solicitações de API inteiramente. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. Em modelos que pensam por padrão, omitir o parâmetro significa 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`. Nenhuma variável desativa pensamento em modelos Fable, que não podem ter pensamento desativado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `MAX_THINKING_TOKENS=0` igualmente omite o parâmetro, para que as duas variáveis se comportem igual lá |275| `CLAUDE_CODE_DISABLE_THINKING` | Defina como `1` para omitir o parâmetro `thinking` de solicitações de API inteiramente. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. Em modelos que pensam por padrão, omitir o parâmetro significa 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`. Nenhuma variável desativa pensamento em modelos Fable, que não podem ter pensamento desativado. Em [provedores de terceiros](/docs/pt/third-party-integrations), `MAX_THINKING_TOKENS=0` igualmente omite o parâmetro, para que as duas variáveis se comportem igual lá |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Defina como `1` para pular [auto-compactação](/docs/pt/costs#reduce-token-usage) proativa quando Claude Code não reconhece o ID do modelo, como um alias de [gateway LLM](/docs/pt/llm-gateway). Sem essa variável, Claude Code compacta na janela de contexto que assume para o ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` pode corrigir a janela assumida; veja [Corrigir a janela para um ID de modelo gateway ou personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) para quando cada variável se aplica. Requer Claude Code v2.1.223 ou posterior |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Defina como `1` para pular [auto-compactação](/docs/pt/costs#reduce-token-usage) proativa quando Claude Code não reconhece o ID do modelo, como um alias de [gateway LLM](/docs/pt/llm-gateway). Sem essa variável, Claude Code compacta na janela de contexto que assume para o ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` pode corrigir a janela assumida; veja [Corrigir a janela para um ID de modelo gateway ou personalizado](/docs/pt/model-config#correct-the-window-for-a-gateway-or-custom-model-id) para quando cada variável se aplica. Requer Claude Code v2.1.223 ou posterior |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Defina como `1` para desabilitar rolagem virtual em [renderização fullscreen](/docs/pt/fullscreen) e renderizar cada mensagem na transcrição. Use isso se a rolagem no modo fullscreen mostrar regiões em branco onde mensagens deveriam aparecer |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Defina como `1` para desabilitar rolagem virtual em [renderização fullscreen](/docs/pt/fullscreen) e renderizar cada mensagem na transcrição. Use isso se a rolagem no modo fullscreen mostrar regiões em branco onde mensagens deveriam aparecer |

298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Defina como `1` para forçar ativação do modo privado DEC 2026 [saída sincronizada](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando seu terminal o suporta mas não é auto-detectado. Útil para emuladores como `eat` do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux. Diferentemente de `CLAUDE_CODE_NO_FLICKER`, que muda para [renderização fullscreen](/docs/pt/fullscreen), isso não muda o renderizador |298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Defina como `1` para forçar ativação do modo privado DEC 2026 [saída sincronizada](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando seu terminal o suporta mas não é auto-detectado. Útil para emuladores como `eat` do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux. Diferentemente de `CLAUDE_CODE_NO_FLICKER`, que muda para [renderização fullscreen](/docs/pt/fullscreen), isso não muda o renderizador |

299| `CLAUDE_CODE_FORK_SUBAGENT` | Controla [modo fork](/docs/pt/sub-agents#turn-fork-mode-on-or-off), que permite Claude gerar [subagentes bifurcados](/docs/pt/sub-agents#fork-the-current-conversation) e está ativo por padrão apenas em sessões interativas. Defina como `1` para ativá-lo em `claude -p` e Agent SDK também, ou `0` para desativá-lo em todo tipo de sessão. Você pode executar `/subtask` independentemente de modo fork estar ativo. O padrão interativo requer Claude Code v2.1.232 ou posterior; em versões anteriores, defina a variável como `1` para ativar modo fork |299| `CLAUDE_CODE_FORK_SUBAGENT` | Controla [modo fork](/docs/pt/sub-agents#turn-fork-mode-on-or-off), que permite Claude gerar [subagentes bifurcados](/docs/pt/sub-agents#fork-the-current-conversation) e está ativo por padrão apenas em sessões interativas. Defina como `1` para ativá-lo em `claude -p` e Agent SDK também, ou `0` para desativá-lo em todo tipo de sessão. Você pode executar `/subtask` independentemente de modo fork estar ativo. O padrão interativo requer Claude Code v2.1.232 ou posterior; em versões anteriores, defina a variável como `1` para ativar modo fork |

300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Defina como `1` para emitir blocos de texto e pensamento de [subagente](/docs/pt/sub-agents) na saída `claude -p --output-format stream-json`, o mesmo comportamento que a flag [`--forward-subagent-text`](/docs/pt/cli-reference#cli-flags). Use a variável quando um harness invoca `claude` e não pode passar a flag. Diferentemente da flag, que sai com um erro fora do modo não interativo com saída stream-json, a variável é ignorada lá para que invocações aninhadas continuem funcionando quando está definida em todo o processo. Requer Claude Code v2.1.211 ou posterior |300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Defina como `1` para emitir blocos de texto e pensamento de [subagente](/docs/pt/sub-agents) na saída `claude -p --output-format stream-json`, o mesmo comportamento que a flag [`--forward-subagent-text`](/docs/pt/cli-reference#cli-flags). Use a variável quando um harness invoca `claude` e não pode passar a flag. Diferentemente da flag, que sai com um erro fora do modo não interativo com saída stream-json, a variável é ignorada lá para que invocações aninhadas continuem funcionando quando está definida em todo o processo. Requer Claude Code v2.1.211 ou posterior |

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

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

302| `CLAUDE_CODE_GIT_BASH_PATH` | Apenas Windows: caminho para o executável Git Bash (`bash.exe`). Use quando Git Bash está instalado mas não em seu PATH. Se o caminho não existir ou o arquivo não for nomeado `bash.exe`, `sh.exe`, `bash`, ou `sh`, Claude Code ignora a variável e auto-detecta Git Bash como se estivesse não definida, registrando um aviso visível com `--debug`. Antes da v2.1.219, Claude Code saía na inicialização quando o caminho não existia, e usava qualquer arquivo existente como shell sem verificar que era bash ou sh. Veja [Configuração Windows](/docs/pt/setup#set-up-on-windows) |303| `CLAUDE_CODE_GIT_BASH_PATH` | Apenas Windows: caminho para o executável Git Bash (`bash.exe`). Use quando Git Bash está instalado mas não em seu PATH. Se o caminho não existir ou o arquivo não for nomeado `bash.exe`, `sh.exe`, `bash`, ou `sh`, Claude Code ignora a variável e auto-detecta Git Bash como se estivesse não definida, registrando um aviso visível com `--debug`. Antes da v2.1.219, Claude Code saía na inicialização quando o caminho não existia, e usava qualquer arquivo existente como shell sem verificar que era bash ou sh. Veja [Configuração Windows](/docs/pt/setup#set-up-on-windows) |

303| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles de resultados quando Claude invoca a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). Incluído por padrão. Não afeta autocompletar `@` de arquivo, `ls`, Grep, ou Read |304| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles de resultados quando Claude invoca a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). Incluído por padrão. Não afeta autocompletar `@` de arquivo, `ls`, Grep, ou Read |

472| `MCP_SDK_GENERATION` | Fixe qual [runtime de cliente MCP](/docs/pt/mcp#mcp-client-runtimes) este processo se conecta a servidores MCP com: `v1`, construído no MCP TypeScript SDK 1.x, ou `v2`, construído no [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sem a variável, Claude Code usa v2 no Claude Code v2.1.232 ou posterior, exceto onde essa seção diz que usa v1. No Claude Code v2.1.221 ou posterior, o runtime v2 verifica o emissor que um servidor MCP OAuth retorna em sua resposta de autorização e falha a entrada com um erro que começa `Issuer mismatch in authorization response` quando não corresponde. O runtime v1 não executa essa verificação. Se você definir um valor não reconhecido, Claude Code o ignora e escreve um aviso no log de depuração. Claude Code lê o valor uma vez por processo. Requer Claude Code v2.1.218 ou posterior |473| `MCP_SDK_GENERATION` | Fixe qual [runtime de cliente MCP](/docs/pt/mcp#mcp-client-runtimes) este processo se conecta a servidores MCP com: `v1`, construído no MCP TypeScript SDK 1.x, ou `v2`, construído no [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Sem a variável, Claude Code usa v2 no Claude Code v2.1.232 ou posterior, exceto onde essa seção diz que usa v1. No Claude Code v2.1.221 ou posterior, o runtime v2 verifica o emissor que um servidor MCP OAuth retorna em sua resposta de autorização e falha a entrada com um erro que começa `Issuer mismatch in authorization response` quando não corresponde. O runtime v1 não executa essa verificação. Se você definir um valor não reconhecido, Claude Code o ignora e escreve um aviso no log de depuração. Claude Code lê o valor uma vez por processo. Requer Claude Code v2.1.218 ou posterior |

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

475| `MCP_TOOL_TIMEOUT` | Timeout em milissegundos para execução de ferramenta MCP (padrão: 100000000, aproximadamente 28 horas). Para um servidor HTTP, SSE, ou conector claude.ai, cada solicitação também expira após 60 segundos por padrão; defina essa variável, ou o `timeout` por servidor, acima de 60000 para aumentar esse limite por solicitação. Um valor mais baixo ainda encurta o timeout de execução de ferramenta geral mas deixa o timer por solicitação em 60 segundos. Servidores stdio e WebSocket não têm timer por solicitação. Um campo `timeout` por servidor em `.mcp.json` substitui isso para esse servidor. Um `timeout` por servidor de pelo menos 1000 também define a janela de inatividade mínima para chamadas de ferramenta desse servidor, para que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborte mais cedo; este piso requer Claude Code v2.1.203 ou posterior. Para a variável env, valores abaixo de 1000 são limitados a um segundo; para o campo por servidor, valores abaixo de 1000 são ignorados |476| `MCP_TOOL_TIMEOUT` | Timeout em milissegundos para execução de ferramenta MCP (padrão: 100000000, aproximadamente 28 horas). Para um servidor HTTP, SSE, ou conector claude.ai, cada solicitação também expira após 60 segundos por padrão; defina essa variável, ou o `timeout` por servidor, acima de 60000 para aumentar esse limite por solicitação. Um valor mais baixo ainda encurta o timeout de execução de ferramenta geral mas deixa o timer por solicitação em 60 segundos. Servidores stdio e WebSocket não têm timer por solicitação. Um campo `timeout` por servidor em `.mcp.json` substitui isso para esse servidor. Um `timeout` por servidor de pelo menos 1000 também define a janela de inatividade mínima para chamadas de ferramenta desse servidor, para que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborte mais cedo; este piso requer Claude Code v2.1.203 ou posterior. Para a variável env, valores abaixo de 1000 são floored a um segundo; para o campo por servidor, valores abaixo de 1000 são ignorados |

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

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

480| `OTEL_LOG_MANAGED_SETTINGS` | Defina como `1` para adicionar as configurações gerenciadas redatadas, e um resumo SHA-256 das configurações antes da redação, a eventos de log OpenTelemetry `managed_settings_resolved`. Desabilitado por padrão. Defina em seu shell, configurações de usuário, ou configurações gerenciadas; um valor em configurações de projeto ou local não o ativa. Requer Claude Code v2.1.274 ou posterior. Veja [Monitoramento](/docs/pt/monitoring-usage#managed-settings-resolved-event) |

479| `OTEL_LOG_RAW_API_BODIES` | Emita JSON de solicitação e resposta da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados no limite de conteúdo, ou `file:<dir>` para escrever corpos não truncados em disco e emitir um caminho `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de conteúdo, 60 KB por padrão. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Defina em seu shell, configurações de usuário, ou configurações gerenciadas. Ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Veja [Monitoramento](/docs/pt/monitoring-usage#api-request-body-event) |481| `OTEL_LOG_RAW_API_BODIES` | Emita JSON de solicitação e resposta da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados no limite de conteúdo, ou `file:<dir>` para escrever corpos não truncados em disco e emitir um caminho `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de conteúdo, 60 KB por padrão. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Defina em seu shell, configurações de usuário, ou configurações gerenciadas. Ignorado em [configurações de projeto e local](/docs/pt/settings-reference#variables-claude-code-ignores-in-env). Veja [Monitoramento](/docs/pt/monitoring-usage#api-request-body-event) |

480| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir conteúdo de ferramenta no evento de span OpenTelemetry `tool.output`. Atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](/docs/pt/monitoring-usage#new-context-gates). Requer [rastreamento](/docs/pt/monitoring-usage#traces-beta). Desabilitado por padrão para proteger dados sensíveis. Veja [Monitoramento](/docs/pt/monitoring-usage#tool-output-span-event) |482| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir conteúdo de ferramenta no evento de span OpenTelemetry `tool.output`. Atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](/docs/pt/monitoring-usage#new-context-gates). Requer [rastreamento](/docs/pt/monitoring-usage#traces-beta). Desabilitado por padrão para proteger dados sensíveis. Veja [Monitoramento](/docs/pt/monitoring-usage#tool-output-span-event) |

481| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, nomes de fluxo de trabalho redigidos pelo usuário, strings de erro bruto em falhas de ferramenta, a `category` de recusa em eventos `api_refusal`, e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja [Monitoramento](/docs/pt/monitoring-usage) |483| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, nomes de fluxo de trabalho redigidos pelo usuário, strings de erro bruto em falhas de ferramenta, a `category` de recusa em eventos `api_refusal`, e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja [Monitoramento](/docs/pt/monitoring-usage) |

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

488| `OTEL_METRICS_INCLUDE_VERSION` | Defina como `true` para incluir versão de Claude Code em atributos de métricas (padrão: excluído). Veja [Monitoramento](/docs/pt/monitoring-usage) |490| `OTEL_METRICS_INCLUDE_VERSION` | Defina como `true` para incluir versão de Claude Code em atributos de métricas (padrão: excluído). Veja [Monitoramento](/docs/pt/monitoring-usage) |

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

490| `TASK_MAX_OUTPUT_LENGTH` | Número máximo de caracteres de saída de uma [tarefa em segundo plano](/docs/pt/tools-reference#background-commands) que a ferramenta `TaskOutput` mantém (padrão: 32000; máximo: 160000). Se você definir a configuração [`taskOutputMaxChars`](/docs/pt/settings-reference#taskoutputmaxchars), Claude Code ignora essa variável |492| `TASK_MAX_OUTPUT_LENGTH` | Removido na v2.1.277 e agora é um no-op, junto com a ferramenta `TaskOutput` que dimensionava. Anteriormente definia o número máximo de caracteres de saída de uma [tarefa em segundo plano](/docs/pt/tools-reference#background-commands) que a ferramenta `TaskOutput` mantinha. Claude lê a saída de uma tarefa em segundo plano com `Read` |

506| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Substitua região para Claude Opus 5.5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.280 |

504| `VERTEX_REGION_CLAUDE_5_OPUS` | Substitua região para Claude Opus 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.219 |507| `VERTEX_REGION_CLAUDE_5_OPUS` | Substitua região para Claude Opus 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.219 |

505| `VERTEX_REGION_CLAUDE_5_SONNET` | Substitua região para Claude Sonnet 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.197 |508| `VERTEX_REGION_CLAUDE_5_SONNET` | Substitua região para Claude Sonnet 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.197 |

506| `VERTEX_REGION_CLAUDE_FABLE_5` | Substitua região para Claude Fable 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.170 |509| `VERTEX_REGION_CLAUDE_FABLE_5` | Substitua região para Claude Fable 5 ao usar Google Cloud's Agent Platform. Adicionado na v2.1.170 |

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

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

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

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

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

539 543

540<h3 id="first-session-after-an-install-or-upgrade">544<h3 id="first-session-after-an-install-or-upgrade">

fast-mode.md +12 −7

Details

12 12

13O modo rápido é uma configuração de alta velocidade para Claude Opus, tornando o modelo até 2,5x mais rápido a um custo maior por token. Ative-o com `/fast` quando você precisar de velocidade para trabalho interativo como iteração rápida ou depuração ao vivo, e desative-o quando o custo importa mais do que a latência.13O modo rápido é uma configuração de alta velocidade para Claude Opus, tornando o modelo até 2,5x mais rápido a um custo maior por token. Ative-o com `/fast` quando você precisar de velocidade para trabalho interativo como iteração rápida ou depuração ao vivo, e desative-o quando o custo importa mais do que a latência.

14 14

15O modo rápido não é um modelo diferente. Ele usa Claude Opus com uma configuração de API diferente que prioriza a velocidade sobre a eficiência de custo. Você obtém qualidade e capacidades idênticas com respostas mais rápidas. O modo rápido é suportado no Opus 5 e Opus 4.8. Não está disponível no Sonnet, Haiku ou outros modelos.15O modo rápido não é um modelo diferente. Ele usa Claude Opus com uma configuração de API diferente que prioriza a velocidade sobre a eficiência de custo. Você obtém qualidade e capacidades idênticas com respostas mais rápidas. O modo rápido é suportado no Opus 5.5, Opus 5 e Opus 4.8. Não está disponível no Sonnet, Haiku ou outros modelos.

16 16

17O Claude Code trata o Opus 4.7 como qualquer outro modelo sem suporte a modo rápido: alternar para ele desativa o modo rápido. O modo rápido para Opus 4.7 foi descontinuado em 25 de junho de 2026 e removido em 24 de julho de 2026.17O Opus 4.7 não suporta modo rápido, portanto alternar para ele desativa o modo rápido. O modo rápido para Opus 4.7 foi descontinuado em 25 de junho de 2026 e removido em 24 de julho de 2026.

18 18

19O que você precisa saber:19O que você precisa saber:

20 20

21* Use `/fast` para alternar o modo rápido no CLI do Claude Code. A extensão VS Code segue sua configuração [`fastMode`](#toggle-fast-mode) e oferece um comando **Toggle fast mode** quando o modelo selecionado suporta modo rápido.21* Use `/fast` para alternar o modo rápido no CLI do Claude Code. A [extensão VS Code](/docs/pt/vs-code) oferece um comando **Toggle fast mode** quando o modelo selecionado suporta modo rápido. O Claude Code salva essa alternância na sua configuração [`fastMode`](#toggle-fast-mode).

~~22* O preço do modo rápido por MTok de entrada/saída é \$10/\$50 no Opus 5 e Opus 4.8.~~22* O preço do modo rápido por MTok de entrada/saída é \$8/\$40 no Opus 5.5 e \$10/\$50 no Opus 5 e Opus 4.8.

23* Disponível para usuários do Claude Code em planos de assinatura (Pro/Max/Team/Enterprise) e no Claude Console. Organizações Team e Enterprise precisam que um Owner ative primeiro, e organizações Console precisam ter acesso provisionado primeiro, ambos descritos em [Requisitos](#requirements).23* Disponível para usuários do Claude Code em planos de assinatura (Pro/Max/Team/Enterprise) e no Claude Console. Organizações Team e Enterprise precisam que um Owner ative primeiro, e organizações Console precisam ter acesso provisionado primeiro, ambos descritos em [Requisitos](#requirements).

24* Para usuários do Claude Code em planos de assinatura (Pro/Max/Team/Enterprise), o modo rápido está disponível apenas via créditos de uso e não está incluído nos limites de taxa de assinatura.24* Para usuários do Claude Code em planos de assinatura (Pro/Max/Team/Enterprise), o modo rápido está disponível apenas via créditos de uso e não está incluído nos limites de taxa de assinatura.

25 25

29 29

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

31 31

~~32* Digite `/fast` e pressione Tab para alternar ativado ou desativado~~32* Execute `/fast`, pressione Space para alternar ativado ou desativado, depois pressione Enter para confirmar

33* Defina `"fastMode": true` no seu [arquivo de configurações do usuário](/docs/pt/settings)33* Defina `"fastMode": true` no seu [arquivo de configurações do usuário](/docs/pt/settings)

34 34

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

47* Um pequeno ícone `↯` aparece ao lado do prompt enquanto o modo rápido está ativo47* Um pequeno ícone `↯` aparece ao lado do prompt enquanto o modo rápido está ativo

48* Execute `/fast` novamente a qualquer momento para verificar se o modo rápido está ativado ou desativado48* Execute `/fast` novamente a qualquer momento para verificar se o modo rápido está ativado ou desativado

49 49

50Opus 5 é o padrão do modo rápido no Claude Code v2.1.219 e posterior. Antes da v2.1.219, o modo rápido usava como padrão Opus 4.8 na v2.1.154 até v2.1.218, e Opus 4.7 na v2.1.142 até v2.1.153.50Opus 5.5 é o padrão do modo rápido no Claude Code v2.1.280 e posterior. Antes da v2.1.280, o modo rápido usava como padrão Opus 5 a partir da v2.1.219, Opus 4.8 na v2.1.154 até v2.1.218, e Opus 4.7 na v2.1.142 até v2.1.153.

51 51

52Quando você desativa o modo rápido com `/fast` novamente, você permanece no Opus. Para alternar para um modelo diferente, use `/model`.52Quando você desativa o modo rápido com `/fast` novamente, você permanece no Opus. Para alternar para um modelo diferente, use `/model`.

53 53

80 80

82| -------- | -------------- | ------------ |82| -------- | -------------- | ------------ |

83| Opus 5.5 | \$8 | \$40 |

83| Opus 5 | \$10 | \$50 |84| Opus 5 | \$10 | \$50 |

84| Opus 4.8 | \$10 | \$50 |85| Opus 4.8 | \$10 | \$50 |

85 86

145* **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.146* **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.

146 147

147<Note>148<Note>

148 Duas configurações de organização podem bloquear a ativação do modo rápido com `/fast`:149 Quatro configurações de organização podem bloquear a ativação do modo rápido com `/fast`:

149 150

150 * **Modo rápido não ativado**: se o modo rápido não tiver sido ativado para sua organização, ativar o modo rápido com `/fast` mostra "Fast mode has been disabled by your organization."151 * **Modo rápido não ativado**: se o modo rápido não tiver sido ativado para sua organização, ativar o modo rápido com `/fast` mostra "Fast mode has been disabled by your organization."

152 * **Modo rápido desativado por configurações gerenciadas**: se sua organização implanta [configurações gerenciadas](/docs/pt/managed-settings) que definem [`fastMode: false`](/docs/pt/settings-reference#fastmode), ativar o modo rápido com `/fast` mostra a mesma mensagem "Fast mode has been disabled by your organization".

153 * **Opt-in obrigatório por sessão**: configurações gerenciadas que definem [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) recusam `/fast on` com a mesma mensagem em todos os lugares, exceto em uma sessão de terminal interativa.

151 * **Modelo de modo rápido não permitido**: 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, ativá-lo é recusado com "is not in your organization's allowed models". Em 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 sem alternar modelos.154 * **Modelo de modo rápido não permitido**: 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, ativá-lo é recusado com "is not in your organization's allowed models". Em 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 sem alternar modelos.

152</Note>155</Note>

153 156

204 207

205Isso é útil para controlar custos em organizações onde os usuários executam várias sessões simultâneas. A preferência de modo rápido do usuário ainda é salva, portanto remover essa configuração restaura o comportamento padrão persistente.208Isso é útil para controlar custos em organizações onde os usuários executam várias sessões simultâneas. A preferência de modo rápido do usuário ainda é salva, portanto remover essa configuração restaura o comportamento padrão persistente.

206 209

210Quando configurações gerenciadas definem a chave, `/fast on` funciona apenas em uma sessão de terminal interativa. Em todos os outros lugares, incluindo [modo não interativo](/docs/pt/headless), a [extensão VS Code](/docs/pt/vs-code) e [sessões em nuvem](#use-fast-mode-in-cloud-sessions), é recusado com uma mensagem de que sua organização desativou o modo rápido.

211

207<h2 id="handle-rate-limits">212<h2 id="handle-rate-limits">

208 Lidar com limites de taxa213 Lidar com limites de taxa

209</h2>214</h2>

features-overview.md +25 −5

Details

21As extensões se conectam a diferentes partes do loop agentic:21As extensões se conectam a diferentes partes do loop agentic:

22 22

23* **[CLAUDE.md](/docs/pt/memory)** adiciona contexto persistente que Claude vê a cada sessão23* **[CLAUDE.md](/docs/pt/memory)** adiciona contexto persistente que Claude vê a cada sessão

24* **[Output styles](/docs/pt/output-styles)** definem o papel, tom e formato de resposta de Claude para cada resposta em uma sessão

24* **[Skills](/docs/pt/skills)** adicionam conhecimento reutilizável e fluxos de trabalho invocáveis25* **[Skills](/docs/pt/skills)** adicionam conhecimento reutilizável e fluxos de trabalho invocáveis

25* **[Code intelligence](/docs/pt/tools-reference#lsp-tool-behavior)** conecta Claude a um language server para navegação em nível de símbolo e erros de tipo em tempo real26* **[Code intelligence](/docs/pt/tools-reference#lsp-tool-behavior)** conecta Claude a um language server para navegação em nível de símbolo e erros de tipo em tempo real

26* **[MCP](/docs/pt/mcp)** conecta Claude a serviços e ferramentas externas27* **[MCP](/docs/pt/mcp)** conecta Claude a serviços e ferramentas externas

39Os recursos variam de contexto sempre ativo que Claude vê a cada sessão, a capacidades sob demanda que você ou Claude podem invocar, a automação em segundo plano que é executada em eventos específicos. A tabela abaixo mostra o que está disponível e quando cada um faz sentido.40Os recursos variam de contexto sempre ativo que Claude vê a cada sessão, a capacidades sob demanda que você ou Claude podem invocar, a automação em segundo plano que é executada em eventos específicos. A tabela abaixo mostra o que está disponível e quando cada um faz sentido.

40 41

42| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |43| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |

45| **[Output style](/docs/pt/output-styles)** | Instruções que definem o papel, tom e formato de resposta de Claude para uma sessão inteira | Uma voz, comprimento ou formato que você quer em cada resposta, ou Claude trabalhando como algo diferente de um engenheiro de software | O estilo Concise integrado para respostas mais curtas; um estilo personalizado que responde cada pergunta com um diagrama primeiro |

44| **Skill** | Instruções, conhecimento e fluxos de trabalho que Claude pode usar | Conteúdo reutilizável, documentos de referência, tarefas repetíveis | `/deploy` executa sua lista de verificação de implantação; skill de documentação de API com padrões de endpoint |46| **Skill** | Instruções, conhecimento e fluxos de trabalho que Claude pode usar | Conteúdo reutilizável, documentos de referência, tarefas repetíveis | `/deploy` executa sua lista de verificação de implantação; skill de documentação de API com padrões de endpoint |

45| **Subagent** | Contexto de execução isolado que retorna resultados resumidos | Isolamento de contexto, tarefas paralelas, trabalhadores especializados | Tarefa de pesquisa que lê muitos arquivos mas retorna apenas descobertas principais |47| **Subagent** | Contexto de execução isolado que retorna resultados resumidos | Isolamento de contexto, tarefas paralelas, trabalhadores especializados | Tarefa de pesquisa que lê muitos arquivos mas retorna apenas descobertas principais |

46| **[Dynamic workflow](/docs/pt/workflows)** | Script que Claude escreve que executa muitos subagents em segundo plano | Trabalho que cresce além de um punhado de subagents, ou descobertas que você quer verificadas | Auditar uma base de código inteira, com um segundo conjunto de agentes verificando cada descoberta |48| **[Dynamic workflow](/docs/pt/workflows)** | Script que Claude escreve que executa muitos subagents em segundo plano | Trabalho que cresce além de um punhado de subagents, ou descobertas que você quer verificadas | Auditar uma base de código inteira, com um segundo conjunto de agentes verificando cada descoberta |

59Você não precisa configurar tudo antecipadamente. Cada recurso tem um gatilho reconhecível, e a maioria das equipes os adiciona aproximadamente nesta ordem:61Você não precisa configurar tudo antecipadamente. Cada recurso tem um gatilho reconhecível, e a maioria das equipes os adiciona aproximadamente nesta ordem:

60 62

61| Gatilho | Adicionar |63| Gatilho | Adicionar |

~~62| :--------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |~~64| :---------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

63| Claude erra uma convenção ou comando duas vezes | Adicione a [CLAUDE.md](/docs/pt/memory) |65| Claude erra uma convenção ou comando duas vezes | Adicione a [CLAUDE.md](/docs/pt/memory) |

66| Você continua pedindo a Claude para ser mais breve, explicar mais ou responder no mesmo formato | Defina um [output style](/docs/pt/output-styles) |

64| Você continua digitando o mesmo prompt para iniciar uma tarefa | Salve como uma [skill](/docs/pt/skills) invocável pelo usuário |67| Você continua digitando o mesmo prompt para iniciar uma tarefa | Salve como uma [skill](/docs/pt/skills) invocável pelo usuário |

65| Você cola o mesmo playbook ou procedimento de múltiplas etapas no chat pela terceira vez | Capture como uma [skill](/docs/pt/skills) |68| Você cola o mesmo playbook ou procedimento de múltiplas etapas no chat pela terceira vez | Capture como uma [skill](/docs/pt/skills) |

66| Você continua copiando dados de uma aba do navegador que Claude não consegue ver | Conecte esse sistema como um [servidor MCP](/docs/pt/mcp) |69| Você continua copiando dados de uma aba do navegador que Claude não consegue ver | Conecte esse sistema como um [servidor MCP](/docs/pt/mcp) |

112 115

113 **Coloque em uma skill** se for material de referência que Claude precisa às vezes (documentação de API, guias de estilo) ou um fluxo de trabalho que você dispara com `/<name>` (deploy, review, release).116 **Coloque em uma skill** se for material de referência que Claude precisa às vezes (documentação de API, guias de estilo) ou um fluxo de trabalho que você dispara com `/<name>` (deploy, review, release).

114 117

115 **Regra prática:** Mantenha CLAUDE.md com menos de 200 linhas. Se estiver crescendo, mova conteúdo de referência para skills ou divida em arquivos [`.claude/rules/`](/docs/pt/memory#organize-rules-with-claude%2Frules%2F).118 **Regra prática:** Mantenha CLAUDE.md com menos de 200 linhas. Se estiver crescendo, mova conteúdo de referência para skills ou divida em arquivos [`.claude/rules/`](/docs/pt/memory#organize-rules-with-claude/rules/).

119 </Tab>

120

121 <Tab title="CLAUDE.md vs Output style">

122 Ambos dão a Claude instruções permanentes. CLAUDE.md carrega o que Claude deve saber, e um output style define como Claude responde.

123

124 | Aspecto | CLAUDE.md | Output style |

125 | --------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |

126 | **Contém** | Fatos e regras sobre seu projeto | Um papel, tom e formato de resposta |

127 | **Alternância** | Sempre carregado | Um ativo por vez; [alterne estilos](/docs/pt/output-styles#change-your-output-style) sempre que quiser |

128 | **Melhor para** | Comandos de compilação, convenções, regras "nunca faça X" | Respostas mais curtas, explicações junto com código, um papel não-engenharia |

129

130 **Coloque em CLAUDE.md** se for verdade do projeto em qualquer estilo que você esteja: convenções de codificação, comandos de compilação, estrutura do projeto.

131

132 **Use um output style** se for sobre a resposta em si e você pode querer desativá-lo novamente: comprimento, formato, quanto Claude explica, ou um papel diferente como um assistente de escrita. Claude Code inclui [estilos integrados](/docs/pt/output-styles#built-in-output-styles), e você pode escrever os seus próprios.

133

134 **Eles se combinam.** CLAUDE.md permanece carregado qualquer estilo que você escolha. Claude segue ambos como instruções, então nenhum é imposto. Para qualquer coisa que deve acontecer toda vez, use um [hook](/docs/pt/hooks-guide).

116 </Tab>135 </Tab>

117 136

118 <Tab title="CLAUDE.md vs Rules vs Skills">137 <Tab title="CLAUDE.md vs Rules vs Skills">

187 206

188Os recursos podem ser definidos em múltiplos níveis: em toda a máquina, por projeto, via plugins ou através de políticas gerenciadas. Você também pode aninhar arquivos CLAUDE.md em subdiretórios ou colocar skills em pacotes específicos de um monorepo. Quando o mesmo recurso existe em múltiplos níveis, aqui está como eles se sobrepõem:207Os recursos podem ser definidos em múltiplos níveis: em toda a máquina, por projeto, via plugins ou através de políticas gerenciadas. Você também pode aninhar arquivos CLAUDE.md em subdiretórios ou colocar skills em pacotes específicos de um monorepo. Quando o mesmo recurso existe em múltiplos níveis, aqui está como eles se sobrepõem:

189 208

190* **Arquivos CLAUDE.md** são aditivos: todos os níveis contribuem conteúdo ao contexto de Claude simultaneamente. Arquivos do seu diretório de trabalho e acima carregam no lançamento; subdiretórios carregam conforme você trabalha neles. Quando as instruções entram em conflito, Claude usa julgamento para reconciliá-las, com instruções mais específicas tipicamente tendo precedência. Consulte [como arquivos CLAUDE.md carregam](/docs/pt/memory#how-claude-md-files-load).209* **Arquivos CLAUDE.md** são aditivos: todos os níveis contribuem conteúdo ao contexto de Claude simultaneamente. Arquivos do seu diretório de trabalho e acima carregam no lançamento; subdiretórios carregam conforme você trabalha neles. Quando as instruções entram em conflito, Claude usa julgamento para reconciliá-las. Consulte [como arquivos CLAUDE.md carregam](/docs/pt/memory#how-claude-md-files-load).

191* **Skills e subagents** substituem por nome: quando o mesmo nome existe em múltiplos níveis, uma definição vence com base na prioridade (gerenciado > usuário > projeto para skills; gerenciado > sinalizador CLI > projeto > usuário > plugin para subagents). Skills de plugin são [nomeadas](/docs/pt/plugins#add-skills-to-your-plugin) para evitar conflitos. Consulte [descoberta de skill](/docs/pt/skills#resolve-skills-that-share-a-name) e [escopo de subagent](/docs/pt/sub-agents#choose-the-subagent-scope).210* **Skills e subagents** substituem por nome: quando o mesmo nome existe em múltiplos níveis, uma definição vence com base na prioridade (gerenciado > usuário > projeto para skills; gerenciado > sinalizador CLI > projeto > usuário > plugin para subagents). Skills de plugin são [nomeadas](/docs/pt/plugins#add-skills-to-your-plugin) para evitar conflitos. Consulte [descoberta de skill](/docs/pt/skills#resolve-skills-that-share-a-name) e [escopo de subagent](/docs/pt/sub-agents#choose-the-subagent-scope).

192* **Servidores MCP** substituem por nome: local > projeto > usuário. Consulte [escopo MCP](/docs/pt/mcp#scope-hierarchy-and-precedence).211* **Servidores MCP** substituem por nome: local > projeto > usuário. Consulte [escopo MCP](/docs/pt/mcp#scope-hierarchy-and-precedence).

193* **Hooks** se mesclam: todos os hooks registrados disparam para seus eventos correspondentes independentemente da fonte. Consulte [hooks](/docs/pt/hooks-guide).212* **Hooks** se mesclam: todos os hooks registrados disparam para seus eventos correspondentes independentemente da fonte. Consulte [hooks](/docs/pt/hooks-guide).

220Cada recurso tem uma estratégia de carregamento e custo de contexto diferentes:239Cada recurso tem uma estratégia de carregamento e custo de contexto diferentes:

221 240

223| --------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |242| --------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |

fullscreen.md +2 −2

Details

234 234

235Execute `/clear` para iniciar uma nova conversa.235Execute `/clear` para iniciar uma nova conversa.

236 236

237Para limpar a tela e manter a conversa, pressione `Ctrl+L`. As mensagens anteriores rolam para fora da vista, e você pode rolar para trás com `PgUp` ou a roda do mouse para lê-las novamente. Antes da v2.1.260, `Ctrl+L` redesenhava a tela sem limpá-la. Antes da v2.1.238, pressioná-lo duas vezes em dois segundos executava `/clear`.237Se a exibição parecer distorcida ou parcialmente em branco, pressione `Ctrl+L` para redesenhar a tela. O redesenho mantém a conversa e sua entrada no lugar.

238 238

239`Cmd+K` faz o mesmo que `Ctrl+L` quando seu terminal o passa para Claude Code. iTerm2 e Terminal.app lidam com `Cmd+K` por conta própria, e Claude Code redesenha a conversa em vez de limpá-la, então pressione `Ctrl+L` nesses terminais.239`Cmd+K` faz o mesmo que `Ctrl+L` quando seu terminal o passa para Claude Code. iTerm2 e Terminal.app lidam com `Cmd+K` por conta própria e limpam sua própria tela, e Claude Code detecta a tela limpa e repinta a conversa. Antes da v2.1.280, começando com v2.1.260, pressionar `Ctrl+L` ou `Cmd+K` onde chega a Claude Code limpava a tela na renderização em tela cheia. Antes da v2.1.238, pressionar `Ctrl+L` duas vezes em dois segundos executava `/clear`.

240 240

241<h2 id="use-with-tmux">241<h2 id="use-with-tmux">

242 Usar com tmux242 Usar com tmux

github-actions.md +1 −1

Details

300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

301 prompt: "Generate a summary of yesterday's commits and open issues"301 prompt: "Generate a summary of yesterday's commits and open issues"

302 claude_args: |302 claude_args: |

303 --model claude-opus-4-8303 --model claude-opus-5-5

304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

305```305```

306 306

glossary.md +12 −0

Details

208 208

209Saiba mais: [Use extended thinking](/docs/pt/model-config#extended-thinking)209Saiba mais: [Use extended thinking](/docs/pt/model-config#extended-thinking)

210 210

211<h2 id="f">

212 F

213</h2>

214

215<h3 id="frontmatter">

216 Frontmatter

217</h3>

218

219Um bloco de configurações YAML no topo de um arquivo Markdown, entre uma linha de abertura `---` e uma linha de fechamento `---`. Skills, subagents, output styles e rules leem sua configuração a partir do frontmatter, como a `description` de uma skill ou as `tools` de um subagent, e tratam tudo após o `---` de fechamento como as instruções. O `---` de abertura deve ser a primeira linha do arquivo. Cada tipo de arquivo aceita seu próprio conjunto de campos.

220

221Saiba mais: [Skill frontmatter](/docs/pt/skills#frontmatter-reference), [Subagent frontmatter](/docs/pt/sub-agents#supported-frontmatter-fields), [Output style frontmatter](/docs/pt/output-styles#frontmatter), [Rule frontmatter](/docs/pt/memory#rules-frontmatter-reference)

222

211<h2 id="h">223<h2 id="h">

212 H224 H

213</h2>225</h2>

google-vertex-ai.md +3 −3

Details

238 238

239Defina estas variáveis de ambiente para IDs de modelo específicos da Plataforma de Agentes do Google Cloud.239Defina estas variáveis de ambiente para IDs de modelo específicos da Plataforma de Agentes do Google Cloud.

240 240

241Sem `ANTHROPIC_DEFAULT_OPUS_MODEL`, o alias `opus` na Plataforma de Agentes do Google Cloud resolve para Opus 5, e sem `ANTHROPIC_DEFAULT_SONNET_MODEL`, o alias `sonnet` resolve para Sonnet 4.5. Este exemplo fixa cada alias a uma versão específica:241Sem `ANTHROPIC_DEFAULT_OPUS_MODEL`, o alias `opus` na Plataforma de Agentes do Google Cloud resolve para Opus 5.5, e sem `ANTHROPIC_DEFAULT_SONNET_MODEL`, o alias `sonnet` resolve para Sonnet 4.5. Este exemplo fixa cada alias a uma versão específica:

242 242

243```bash theme={null}243```bash theme={null}

244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'

252 252

253| Tipo de modelo | Valor padrão |253| Tipo de modelo | Valor padrão |

254| :-------------------- | :--------------------------- |254| :-------------------- | :--------------------------- |

257 257

258Tarefas em segundo plano, como geração de título de sessão, usam o modelo pequeno/rápido, normalmente um modelo da classe Haiku. Na Plataforma de Agentes do Google Cloud, Claude Code usa o modelo Sonnet padrão para tarefas em segundo plano porque Haiku pode não estar ativado em todos os projetos ou regiões. Duas seleções mudam qual modelo as executa:258Tarefas em segundo plano, como geração de título de sessão, usam o modelo pequeno/rápido, normalmente um modelo da classe Haiku. Na Plataforma de Agentes do Google Cloud, Claude Code usa o modelo Sonnet padrão para tarefas em segundo plano porque Haiku pode não estar ativado em todos os projetos ou regiões. Duas seleções mudam qual modelo as executa:

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

265</Warning>265</Warning>

266 266

267Em v2.1.207 através de v2.1.218, o modelo primário na Plataforma de Agentes do Google Cloud era padrão para Opus 4.8 e o alias `opus` resolvia para Opus 4.8. Antes de v2.1.207, o modelo primário 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.267Antes de v2.1.280, o modelo primário na Plataforma de Agentes do Google Cloud era padrão para Opus 5 e o alias `opus` resolvia para Opus 5 a partir de v2.1.219. Em v2.1.207 através de v2.1.218, o modelo primário na Plataforma de Agentes do Google Cloud era padrão para Opus 4.8 e o alias `opus` resolvia para Opus 4.8. Antes de v2.1.207, o modelo primário 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.

268 268

269Para personalizar modelos ainda mais:269Para personalizar modelos ainda mais:

270 270

headless.md +2 −2

Details

109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

110```110```

111 111

112Com `--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). Ambas as figuras são [estimativas do lado do cliente](/docs/pt/agent-sdk/cost-tracking) e podem diferir da sua fatura real.112Com `--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 sem consultar o [painel de uso](/docs/pt/costs). Quando você continua uma conversa anterior com `--continue` ou `--resume`, a execução relata o total da conversa, [gastos de execuções anteriores inclusos](/docs/pt/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Ambas as figuras são [estimativas do lado do cliente](/docs/pt/agent-sdk/cost-tracking) e podem diferir da sua fatura real.

113 113

114<Note>114<Note>

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

212* **Por padrão**: os blocos `tool_use` e `tool_result` do subagente.212* **Por padrão**: os blocos `tool_use` e `tool_result` do subagente.

213* **Com [`--forward-subagent-text`](/docs/pt/cli-reference#cli-flags) ou [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/pt/env-vars)**: os blocos de texto e pensamento do subagente também, para que você possa reconstruir a transcrição de cada subagente. Isso requer Claude Code v2.1.211 ou posterior.213* **Com [`--forward-subagent-text`](/docs/pt/cli-reference#cli-flags) ou [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/pt/env-vars)**: os blocos de texto e pensamento do subagente também, para que você possa reconstruir a transcrição de cada subagente. Isso requer Claude Code v2.1.211 ou posterior.

214 214

215Quando você habilita uma das opções, Claude Code encaminha mensagens de [subagentes em cada profundidade de aninhamento](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents): quando um subagente gera seu próprio subagente, as mensagens do subagente aninhado carregam o ID da chamada de ferramenta Agent que o gerou em `parent_tool_use_id`, para que você possa reconstruir a árvore de aninhamento completa seguindo esses IDs. Antes da v2.1.219, mensagens de subagentes aninhados não apareciam no stream.215Quando você habilita uma das opções, Claude Code encaminha mensagens de [subagentes em cada profundidade de aninhamento](/docs/pt/sub-agents#let-subagents-spawn-their-own-subagents), independentemente de cada um ter sido gerado com a ferramenta Agent ou iniciado como uma [skill bifurcada](/docs/pt/skills#run-skills-in-a-subagent). Mensagens de subagentes que uma skill bifurcada gera, e de skills bifurcadas iniciadas dentro de um subagente ou outra skill bifurcada, requerem Claude Code v2.1.275 ou posterior. Em `parent_tool_use_id`, as mensagens do subagente aninhado carregam o ID da chamada de ferramenta Agent ou Skill que o iniciou, para que você possa reconstruir a árvore de aninhamento completa seguindo esses IDs. Antes da v2.1.219, mensagens de subagentes aninhados não apareciam no stream.

216 216

217Skills que [executam em um subagente](/docs/pt/skills#run-skills-in-a-subagent) aparecem no stream da mesma forma: a primeira mensagem da skill bifurcada é uma mensagem `user` carregando o conteúdo da skill que conduz a execução. Se você habilitar uma das opções, o stream também carrega os blocos de texto e pensamento da skill bifurcada. Antes da v2.1.265, apenas os blocos `tool_use` e `tool_result` de uma skill bifurcada apareciam no stream.217Skills que [executam em um subagente](/docs/pt/skills#run-skills-in-a-subagent) aparecem no stream da mesma forma: a primeira mensagem da skill bifurcada é uma mensagem `user` carregando o conteúdo da skill que conduz a execução. Se você habilitar uma das opções, o stream também carrega os blocos de texto e pensamento da skill bifurcada. Antes da v2.1.265, apenas os blocos `tool_use` e `tool_result` de uma skill bifurcada apareciam no stream.

218 218

hooks.md +9 −4

Details

268| Frontmatter de [Skill](/docs/pt/skills) | O resto da sessão uma vez que a skill é invocada. Consulte [Hooks em skills e agentes](#hooks-in-skills-and-agents) | Sim, definido no arquivo da skill |268| Frontmatter de [Skill](/docs/pt/skills) | O resto da sessão uma vez que a skill é invocada. Consulte [Hooks em skills e agentes](#hooks-in-skills-and-agents) | Sim, definido no arquivo da skill |

270 270

271Sessões em nuvem em [Claude Code na web](/docs/pt/claude-code-on-the-web) não leem seu `~/.claude/settings.json` local; hooks lá vêm do repositório, significando seu `.claude/settings.json` em uma sessão com um repositório e os plugins que declara em qualquer sessão, e das configurações gerenciadas pelo servidor da sua organização. Em um [ambiente auto-hospedado](/docs/pt/self-hosted-environments-configuration#permissions-and-tool-approval), Claude Code também executa os hooks que o operador propagou do `~/.claude/` do host do runner, e executa os hooks no arquivo de configurações gerenciadas da imagem do runner quando esse arquivo está entre as [fontes gerenciadas que Claude Code aplica](/docs/pt/managed-settings#how-claude-code-combines-managed-sources), o que por padrão significa apenas quando nem configurações gerenciadas pelo servidor nem uma política Claude Code entregue por MDM fornece o nível gerenciado. Consulte [o que é transferido da sua configuração](/docs/pt/cloud-environments#what-carries-over-from-your-setup) para saber quais arquivos chegam a uma sessão em nuvem.271Sessões em nuvem em [Claude Code na web](/docs/pt/claude-code-on-the-web) não leem seu `~/.claude/settings.json` local; hooks lá vêm do repositório `.claude/settings.json` em uma sessão com um repositório, dos plugins [sincronizados da sua conta claude.ai](/docs/pt/plugins-reference#synced-plugins) e das configurações gerenciadas pelo servidor da sua organização. Em um [ambiente auto-hospedado](/docs/pt/self-hosted-environments-configuration#permissions-and-tool-approval), Claude Code também executa os hooks que o operador propagou do `~/.claude/` do host do runner, e executa os hooks no arquivo de configurações gerenciadas da imagem do runner quando esse arquivo está entre as [fontes gerenciadas que Claude Code aplica](/docs/pt/managed-settings#how-claude-code-combines-managed-sources), o que por padrão significa apenas quando nem configurações gerenciadas pelo servidor nem uma política Claude Code entregue por MDM fornece o nível gerenciado. Consulte [o que é transferido da sua configuração](/docs/pt/cloud-environments#what-carries-over-from-your-setup) para saber quais arquivos chegam a uma sessão em nuvem.

272 272

273Para detalhes sobre resolução de arquivo de configurações, consulte [settings](/docs/pt/settings).273Para detalhes sobre resolução de arquivo de configurações, consulte [settings](/docs/pt/settings).

274 274

1436 Entrada UserPromptSubmit1436 Entrada UserPromptSubmit

1437</h4>1437</h4>

1438 1438

1439Além dos [campos de entrada comuns](#common-input-fields), os hooks UserPromptSubmit recebem o campo `prompt` contendo o texto que o usuário enviou.1439Além dos [campos de entrada comuns](#common-input-fields), os hooks UserPromptSubmit recebem o campo `prompt` contendo o texto que o usuário enviou. Conteúdo colado que colapsou para um espaço reservado `[Pasted text #N]` chega expandido no lugar. Em sessões onde Claude Code [marca texto colado para Claude](/docs/pt/terminal-config#how-claude-treats-pasted-text), esse conteúdo expandido fica entre uma linha `<pasted_content id="…">` e uma linha `</pasted_content id="…">`, portanto leve em conta essas linhas se seu hook analisa o prompt.

1440 1440

1441```json theme={null}1441```json theme={null}

1442{1442{

2578 2578

2579Além dos [campos de entrada comuns](#common-input-fields), os hooks SubagentStop recebem `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` e `last_assistant_message`. O campo `agent_type` é o valor usado para filtragem de matcher. O `transcript_path` é a transcrição da sessão principal, enquanto `agent_transcript_path` é a própria transcrição do subagente armazenada em uma pasta `subagents/` aninhada. O campo `last_assistant_message` contém o conteúdo de texto da resposta final do subagente, portanto hooks podem acessá-lo sem analisar o arquivo de transcrição.2579Além dos [campos de entrada comuns](#common-input-fields), os hooks SubagentStop recebem `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` e `last_assistant_message`. O campo `agent_type` é o valor usado para filtragem de matcher. O `transcript_path` é a transcrição da sessão principal, enquanto `agent_transcript_path` é a própria transcrição do subagente armazenada em uma pasta `subagents/` aninhada. O campo `last_assistant_message` contém o conteúdo de texto da resposta final do subagente, portanto hooks podem acessá-lo sem analisar o arquivo de transcrição.

2580 2580

2581Não há eventos de hook de subagente Claude Code que não sejam de subagente. Claude Code também executa agentes internos para alguns de seus próprios recursos, como [sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) e [perguntas laterais `/btw`](/docs/pt/interactive-mode#side-questions-with-%2Fbtw), e SubagentStop é disparado quando um desses termina também. Para esses eventos, `agent_type` é o nome do agente que a sessão em si executa, como um definido com [`--agent`](/docs/pt/cli-reference#cli-flags) ou a configuração [`agent`](/docs/pt/settings-reference#agent), e uma string vazia quando a sessão é executada sem um.

2582

2583Um `matcher` que nomeia tipos de agente não corresponde a um `agent_type` vazio. Um hook cujo matcher é omitido, `""`, ou `"*"`, ou é uma expressão regular que corresponde a uma string vazia, é executado para eventos com um `agent_type` vazio também.

2584

2581No Claude Code v2.1.271 ou posterior, um subagente que é executado com a ferramenta [`SubagentHandback`](/docs/pt/tools-reference) entrega seu relatório através dessa ferramenta antes de parar. O campo `last_assistant_message` então contém o texto de fechamento do subagente, se houver, que não é o relatório entregue. O relatório é a entrada `message` dessa chamada, que um hook `PreToolUse` ou `PostToolUse` correspondente a `SubagentHandback` recebe como `tool_input.message`.2585No Claude Code v2.1.271 ou posterior, um subagente que é executado com a ferramenta [`SubagentHandback`](/docs/pt/tools-reference) entrega seu relatório através dessa ferramenta antes de parar. O campo `last_assistant_message` então contém o texto de fechamento do subagente, se houver, que não é o relatório entregue. O relatório é a entrada `message` dessa chamada, que um hook `PreToolUse` ou `PostToolUse` correspondente a `SubagentHandback` recebe como `tool_input.message`.

2582 2586

2583Os hooks SubagentStop também recebem os arrays `background_tasks` e `session_crons` descritos em [entrada Stop](#stop-input). Ambos os arrays estão no escopo da sessão pai, não do subagente.2587Os hooks SubagentStop também recebem os arrays `background_tasks` e `session_crons` descritos em [entrada Stop](#stop-input). Ambos os arrays estão no escopo da sessão pai, não do subagente.

3759Eventos que suportam todos os cinco tipos de hook (`command`, `http`, `mcp_tool`, `prompt` e `agent`):3763Eventos que suportam todos os cinco tipos de hook (`command`, `http`, `mcp_tool`, `prompt` e `agent`):

3760 3764

3761* `PermissionDenied`3765* `PermissionDenied`

3762* `PermissionRequest`

3763* `PostToolBatch`3766* `PostToolBatch`

3764* `PostToolUse`3767* `PostToolUse`

3765* `PostToolUseFailure`3768* `PostToolUseFailure`

3772* `UserPromptExpansion`3775* `UserPromptExpansion`

3773* `UserPromptSubmit`3776* `UserPromptSubmit`

3774 3777

3778`PermissionRequest` suporta hooks `command`, `http`, `mcp_tool` e `prompt` mas não hooks `agent`. Se você configurar um hook de agente neste evento, Claude Code o ignora e o fluxo de permissão prossegue inalterado. Para permitir ou negar de um hook, retorne o [objeto de decisão](#permissionrequest-decision-control) de um hook de comando ou HTTP.

3779

3775Eventos que suportam hooks `command`, `http` e `mcp_tool` mas não `prompt` ou `agent`:3780Eventos que suportam hooks `command`, `http` e `mcp_tool` mas não `prompt` ou `agent`:

3776 3781

3777* `ConfigChange`3782* `ConfigChange`

3904 Hooks de agente são experimentais. O comportamento e a configuração podem mudar em versões futuras. Para fluxos de trabalho em produção, prefira [command hooks](#command-hook-fields).3909 Hooks de agente são experimentais. O comportamento e a configuração podem mudar em versões futuras. Para fluxos de trabalho em produção, prefira [command hooks](#command-hook-fields).

3905</Warning>3910</Warning>

3906 3911

3907Hooks baseados em agente (`type: "agent"`) são como hooks baseados em prompt mas com acesso a ferramentas de múltiplos turnos. Em vez de uma única chamada LLM, um hook de agente gera um subagente que pode ler arquivos, pesquisar código e inspecionar o codebase para verificar condições. Hooks de agente suportam os mesmos eventos que hooks baseados em prompt.3912Hooks baseados em agente (`type: "agent"`) são como hooks baseados em prompt mas com acesso a ferramentas de múltiplos turnos. Em vez de uma única chamada LLM, um hook de agente gera um subagente que pode ler arquivos, pesquisar código e inspecionar o codebase para verificar condições. Hooks de agente suportam os mesmos eventos que [hooks baseados em prompt](#prompt-based-hooks), exceto `PermissionRequest`.

3908 3913

3909<h3 id="how-agent-hooks-work">3914<h3 id="how-agent-hooks-work">

3910 Como hooks de agente funcionam3915 Como hooks de agente funcionam

how-claude-code-works.md +3 −3

Details

24 24

25Você também faz parte deste loop. Você pode interromper em qualquer ponto para orientar Claude em uma direção diferente, fornecer contexto adicional ou pedir que tente uma abordagem diferente. Claude trabalha autonomamente, mas permanece responsivo à sua entrada.25Você também faz parte deste loop. Você pode interromper em qualquer ponto para orientar Claude em uma direção diferente, fornecer contexto adicional ou pedir que tente uma abordagem diferente. Claude trabalha autonomamente, mas permanece responsivo à sua entrada.

26 26

27O loop agentic é alimentado por dois componentes: [modelos](#models) que raciocinam e [ferramentas](#tools) que agem. Claude Code serve como o **agentic harness** ao redor de Claude: fornece as ferramentas, gerenciamento de contexto e ambiente de execução que transformam um modelo de linguagem em um agente de codificação capaz.27O loop agentic é alimentado por dois componentes: [modelos](#models) que raciocinam e [ferramentas](#tools) que agem. Claude Code é a camada ao redor do modelo que fornece as ferramentas e gerencia o contexto que o modelo vê. Essa camada envolvente é o que o termo agentic harness se refere.

28 28

29<h3 id="models">29<h3 id="models">

30 Models30 Models

238 Interrompa e oriente238 Interrompa e oriente

239</h4>239</h4>

240 240

241Você pode redirecionar Claude em qualquer ponto sem esperar que o turno termine ou começar do zero:241Você pode redirecionar Claude em qualquer ponto sem começar do zero. Faça um destes:

242 242

243* **Pressione `Esc`** para parar Claude imediatamente. A chamada de ferramenta em execução é cancelada e Claude aguarda sua próxima instrução. Se você tiver mensagens na fila, Claude Code [as envia em seguida](/docs/pt/interactive-mode#queue-messages-while-claude-works).243* **Pressione `Esc`** para parar Claude imediatamente. A chamada de ferramenta em execução é cancelada e Claude aguarda sua próxima instrução. Se você tiver mensagens na fila, Claude Code [as envia em seguida](/docs/pt/interactive-mode#queue-messages-while-claude-works).

244* **Digite uma correção e pressione `Enter`** para enviá-la sem parar a ferramenta em execução. Claude a lê assim que a ação atual é concluída e se ajusta antes de decidir seu próximo passo.244* **Digite uma correção e pressione `Enter`** sem parar Claude. A mensagem aparece como enfileirada acima da caixa de entrada. Se Claude estiver executando chamadas de ferramenta, ele lê a mensagem assim que essas chamadas terminarem, dentro do mesmo turno, e se ajusta antes de seu próximo passo. [Enfileire mensagens enquanto Claude trabalha](/docs/pt/interactive-mode#queue-messages-while-claude-works) aborda quando outras entradas enfileiradas são enviadas.

245 245

246<h3 id="delegate-don’t-dictate">246<h3 id="delegate-don’t-dictate">

247 Delegue, não dite247 Delegue, não dite

interactive-mode.md +14 −4

Details

21</h3>21</h3>

22 22

24| :-------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |24| :--------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

26| `Ctrl+X Ctrl+K` | Parar todos os [subagentes em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) nesta sessão e desativar [respostas automáticas de artefatos](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own) para o resto dela. Pressione duas vezes em 3 segundos para confirmar | Controle de subagente |26| `Ctrl+X Ctrl+K` | Parar todos os [subagentes em segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) nesta sessão e desativar [respostas automáticas de artefatos](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own) para o resto dela. Pressione duas vezes em 3 segundos para confirmar | Controle de subagente |

27| `Ctrl+D` | Sair da sessão do Claude Code | O primeiro pressionamento mostra uma dica de confirmação e um segundo pressionamento em 800ms sai. Quando o prompt tem texto, `Ctrl+D` deleta o caractere após o cursor |27| `Ctrl+D` | Sair da sessão do Claude Code | O primeiro pressionamento mostra uma dica de confirmação e um segundo pressionamento em 800ms sai. Quando o prompt tem texto, `Ctrl+D` deleta o caractere após o cursor |

28| `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 vinculação nativa do readline. Ative **Mostrar última resposta no editor externo** em `/config` para adicionar a resposta anterior do Claude como contexto comentado com `#` acima do seu prompt; Claude Code remove o bloco de comentário quando você salva |28| `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 vinculação nativa do readline. Ative **Mostrar última resposta no editor externo** em `/config` para adicionar a resposta anterior do Claude como contexto comentado com `#` acima do seu prompt; Claude Code remove o bloco de comentário quando você salva |

29| `Ctrl+L` | Redesenhar ou limpar a tela | Força um redesenho completo do terminal, mantendo a entrada e o histórico de conversa. Use isso para recuperar se a exibição ficar corrompida ou parcialmente em branco. Na [renderização em tela cheia](/docs/pt/fullscreen#clear-the-conversation), também limpa a tela e você pode rolar para cima para ver as mensagens anteriores |29| `Ctrl+L` | Redesenhar a tela | Força um redesenho completo do terminal, mantendo a entrada e o histórico de conversa. Use isso para recuperar se a exibição ficar corrompida ou parcialmente em branco. Consulte [Limpar a conversa](/docs/pt/fullscreen#clear-the-conversation) para renderização em tela cheia |

30| `Ctrl+O` | Alternar visualizador de transcrição | Mostra uso detalhado de ferramentas e execução, com um timestamp e o modelo usado em cada mensagem do assistente. Também expande linhas que são recolhidas por padrão, como chamadas MCP, mostradas como uma única linha `Called slack 3 times`, e [mensagens de suas outras sessões](/docs/pt/cross-session-messaging#what-a-message-looks-like), mostradas como uma visualização de uma linha `Message from @<sender>` |30| `Ctrl+O` | Alternar visualizador de transcrição | Mostra uso detalhado de ferramentas e execução, com um timestamp e o modelo usado em cada mensagem do assistente. Também expande linhas que são recolhidas por padrão, como chamadas MCP, mostradas como uma única linha `Called slack 3 times`, e [mensagens de suas outras sessões](/docs/pt/cross-session-messaging#what-a-message-looks-like), mostradas como uma visualização de uma linha `Message from @<sender>` |

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

40| `Esc` | Interromper Claude ou fechar um diálogo | Pare a resposta atual ou chamada de ferramenta no meio da volta para que você possa redirecionar. Claude mantém o trabalho feito até agora. Se você tiver [mensagens enfileiradas](#queue-messages-while-claude-works), Claude Code as envia a seguir. Quando um diálogo está aberto, `Esc` fecha o diálogo. Em um prompt de permissão, `Esc` recusa a ação, o mesmo que [**Não** sem um comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) |40| `Esc` | Interromper Claude ou fechar um diálogo | Pare a resposta atual ou chamada de ferramenta no meio da volta para que você possa redirecionar. Claude mantém o trabalho feito até agora. Se você tiver [mensagens enfileiradas](#queue-messages-while-claude-works), Claude Code as envia a seguir. Quando um diálogo está aberto, `Esc` fecha o diálogo. Em um prompt de permissão, `Esc` recusa a ação, o mesmo que [**Não** sem um comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

41| `Esc` + `Esc` | Limpar rascunho de entrada ou retroceder | Quando a entrada do prompt contém texto, duplo `Esc` limpa-o e salva o rascunho no histórico para que `Para Cima` 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 |41| `Esc` + `Esc` | Limpar rascunho de entrada ou retroceder | Quando a entrada do prompt contém texto, duplo `Esc` limpa-o e salva o rascunho no histórico para que `Para Cima` 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 |

42| `Ctrl+Enter` ou `Ctrl+X Ctrl+S` | Enviar mensagens enfileiradas agora | Interrompe a volta atual para que suas [mensagens enfileiradas](#queue-messages-while-claude-works) e seu rascunho com elas saiam imediatamente em vez de quando a volta terminar. No [modo shell](#shell-mode-with-prefix), a tecla enfileira seu comando sem interromper. Em terminais que não relatam chaves estendidas, `Ctrl+Enter` chega como `Enter` simples; `Ctrl+X Ctrl+S` funciona em qualquer terminal. Requer Claude Code v2.1.275 ou posterior |42| `Ctrl+Enter` ou `Ctrl+X Ctrl+S` | Enviar mensagens enfileiradas agora | Interrompe a volta atual para que suas [mensagens enfileiradas](#queue-messages-while-claude-works) e seu rascunho com elas saiam imediatamente em vez de quando a volta terminar. No [modo shell](#shell-mode-with-prefix), a tecla enfileira seu comando sem interromper. Em terminais que não relatam chaves estendidas, `Ctrl+Enter` chega como `Enter` simples; `Ctrl+X Ctrl+S` funciona em qualquer terminal. Requer Claude Code v2.1.275 ou posterior |

43| `Shift+Tab` ou `Alt+M` no Windows quando o runtime Node ou Bun não ativa o modo de entrada VT | Ciclar modos de permissão | Cicle através de `default` (rotulado Manual no indicador de modo), `acceptEdits`, `plan` e, quando disponível, `bypassPermissions` e depois `auto`. De `auto`, o primeiro pressionamento muda para `default`. Consulte [modos de permissão](/docs/pt/permission-modes). Em um prompt de permissão de arquivo, a mesma tecla fecha um [campo de comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) aberto. Sem campo aberto, seleciona a opção que permite a ação para o resto da sessão, quando o prompt oferece essa opção |43| `Shift+Tab`, ou `Alt+M` no Windows quando o runtime Node ou Bun não ativa o modo de entrada VT | Ciclar modos de permissão | Cicle através de `default` (rotulado Manual no indicador de modo), `acceptEdits`, `plan` e, quando disponível, `bypassPermissions` e depois `auto`. De `auto`, o primeiro pressionamento muda para `default`. Consulte [modos de permissão](/docs/pt/permission-modes). Em um prompt de permissão de arquivo, a mesma tecla fecha um [campo de comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) aberto. Sem campo aberto, seleciona a opção que permite a ação para o resto da sessão, quando o prompt oferece essa opção |

45| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Alternar pensamento estendido | Ativar ou desativar o modo de pensamento estendido. Não tem efeito no Fable 5.1 ou Fable 5, que sempre usam pensamento estendido. Funciona no macOS sem configurar Option como Meta |45| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Alternar pensamento estendido | Ativar ou desativar o modo de pensamento estendido. Não tem efeito no Opus 5.5 ou nos modelos Fable, que sempre usam pensamento estendido. Funciona no macOS sem configurar Option como Meta |

47 47

48<h3 id="text-editing">48<h3 id="text-editing">

593 593

594Para descobrir qual desses aconteceu, inicie `claude --debug` com a verificação de ortografia ativada e digite uma palavra. Em seguida, procure pelas linhas `[spellcheck]` no log de depuração em `~/.claude/debug/<session-id>.txt`. Uma linha nomeia o programa que Claude Code iniciou ou lista os que procurou e não encontrou. Linhas posteriores dizem por que parou. Um erro de dicionário ausente lá significa que o verificador não tem dicionário para seu valor `language`, ou nenhum padrão quando `language` não está definido. Instale um ou defina `language` para um dicionário que você tenha.594Para descobrir qual desses aconteceu, inicie `claude --debug` com a verificação de ortografia ativada e digite uma palavra. Em seguida, procure pelas linhas `[spellcheck]` no log de depuração em `~/.claude/debug/<session-id>.txt`. Uma linha nomeia o programa que Claude Code iniciou ou lista os que procurou e não encontrou. Linhas posteriores dizem por que parou. Um erro de dicionário ausente lá significa que o verificador não tem dicionário para seu valor `language`, ou nenhum padrão quando `language` não está definido. Instale um ou defina `language` para um dicionário que você tenha.

595 595

596<h2 id="invisible-characters-in-prompts">

597 Caracteres invisíveis em prompts

598</h2>

599

600O texto colado pode conter caracteres Unicode que um terminal desenha como nada, como caracteres de tag, controles bidirecionais e espaços de largura zero, portanto um prompt pode conter texto que você nunca vê. Para evitar que o texto copiado carregue instruções que seu terminal não desenha, Claude Code remove esses caracteres quando você pressiona Enter, antes de enviar qualquer coisa. Ele limpa tanto o prompt quanto o conteúdo de qualquer [referência de texto colado](/docs/pt/terminal-config#paste-large-content) que o prompt inclui. Claude Code mantém os juntadores que scripts persa e índico escrevem e os seletores dentro de sequências de emoji.

601

602Se Claude Code removeu algo, esse Enter não envia nada. O prompt limpo volta para a caixa de entrada com um aviso como `Removed 3 invisible characters · review and press Enter to send`, e pressionar Enter novamente envia o texto conforme mostrado.

603

604Quando você passa um prompt na linha de comando, como em `claude "fix the login bug"`, ou canaliza um para uma sessão interativa, Claude Code não espera por um segundo Enter. Ele remove os caracteres, mostra um aviso e envia o prompt limpo. Se o prompt limpo começaria com `/`, Claude Code o coloca na caixa de entrada para você revisar e enviar.

605

596<h2 id="review-changes-with-/diff">606<h2 id="review-changes-with-/diff">

597 Revise alterações com /diff607 Revise alterações com /diff

598</h2>608</h2>

keybindings.md +30 −4

Details

115| :-------------------- | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |115| :-------------------- | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

118| `chat:clearScreen` | Cmd+K | Mesmo que `chat:clearInput`. Veja [Limpar a conversa](/docs/pt/fullscreen#clear-the-conversation) para saber como Cmd+K se comporta no iTerm2 e Terminal.app |118| `chat:clearScreen` | Cmd+K | Mesmo que `chat:clearInput`. Veja [Limpar a conversa](/docs/pt/fullscreen#clear-the-conversation) para saber como Cmd+K se comporta no iTerm2 e Terminal.app |

119| `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 e desativar [respostas automáticas de artefatos](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own) para o resto dela |119| `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 e desativar [respostas automáticas de artefatos](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own) para o resto dela |

153 153

155| :---------------------- | :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |155| :---------------------- | :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

158| `confirm:previous` | Up | Opção anterior |158| `confirm:previous` | Up | Opção anterior |

160| `confirm:nextField` | Tab | Próximo campo |160| `confirm:nextField` | Tab | Próximo campo |

166 166

167Antes da v2.1.257, uma ação `confirm:toggleExplanation`, vinculada a `Ctrl+E` por padrão, mostrava uma explicação gerada por modelo do comando em prompts de permissão Bash e PowerShell.167Antes da v2.1.257, uma ação `confirm:toggleExplanation`, vinculada a `Ctrl+E` por padrão, mostrava uma explicação gerada por modelo do comando em prompts de permissão Bash e PowerShell.

168 168

169Os diálogos usam `confirm:yes` e `confirm:no` para aceitar e cancelar mesmo quando não fazem uma pergunta sim-ou-não. Se você vincular uma letra simples como `y` ou `n` neste contexto, a letra também atua em diálogos que nunca a mostram como uma chave. Um diálogo que mostra `y` e `n` como suas chaves lê essas letras em si e não precisa de vinculação.

170

171Este exemplo vincula `y` a `confirm:yes` e `n` a `confirm:no`:

172

173```json theme={null}

174{

175 "bindings": [

176 {

177 "context": "Confirmation",

178 "bindings": {

179 "y": "confirm:yes",

180 "n": "confirm:no"

181 }

182 }

183 ]

184}

185```

186

187Antes da v2.1.280, `y` também estava vinculado a `confirm:yes` e `n` a `confirm:no` por padrão. Se você criou seu `keybindings.json` com `/keybindings` antes da v2.1.280, o arquivo lista ambas as vinculações e elas permanecem em vigor até que você delete essas duas linhas.

188

169<h3 id="permission-actions">189<h3 id="permission-actions">

170 Ações de permissão190 Ações de permissão

171</h3>191</h3>

276| `footer:dismiss` | Backspace, Delete | Descartar o link de [artefato](/docs/pt/artifacts) selecionado do rodapé; o artefato publicado em si não é afetado. Em outras linhas do rodapé, essas teclas não têm efeito. Requer v2.1.217 ou posterior |296| `footer:dismiss` | Backspace, Delete | Descartar o link de [artefato](/docs/pt/artifacts) selecionado do rodapé; o artefato publicado em si não é afetado. Em outras linhas do rodapé, essas teclas não têm efeito. Requer v2.1.217 ou posterior |

277 297

298Enquanto um item do rodapé está selecionado, como uma linha no painel do agente abaixo do prompt, `Enter` o abre mesmo quando você rebinda `Enter` no contexto `Chat` para `chat:queueSubmit` ou `chat:newline`.

299

300As vinculações `Chat` em teclas que o contexto `Footer` não vincula, como `Shift+Tab` para `chat:cycleMode`, continuam funcionando enquanto um item está selecionado.

301

278<h3 id="message-selector-actions">302<h3 id="message-selector-actions">

279 Ações do seletor de mensagem303 Ações do seletor de mensagem

280</h3>304</h3>

372 396

373Claude Code aplica suas vinculações `select:pageUp`, `select:pageDown`, `select:first` e `select:last` no menu `/skills`. Na maioria das outras listas, como o seletor `/model`, Claude Code pagina com PageUp e PageDown independentemente de suas vinculações e ignora Home e End.397Claude Code aplica suas vinculações `select:pageUp`, `select:pageDown`, `select:first` e `select:last` no menu `/skills`. Na maioria das outras listas, como o seletor `/model`, suas vinculações `select:first` e `select:last` se aplicam. PageUp e PageDown pagina através das opções nessas listas independentemente de suas vinculações.

398

399Antes da v2.1.280, essas outras listas ignoravam Home, End e suas vinculações `select:first` e `select:last`.

374 400

375<h3 id="plugin-actions">401<h3 id="plugin-actions">

376 Ações de plugin402 Ações de plugin

large-codebases.md +19 −19

Details

222Isso funciona bem com `claudeMdExcludes` e as regras de negação `Read` acima. Aqueles mantêm conteúdo irrelevante fora do contexto, e a inteligência de código impede que Claude leia o que permanece para localizar uma definição.222Isso funciona bem com `claudeMdExcludes` e as regras de negação `Read` acima. Aqueles mantêm conteúdo irrelevante fora do contexto, e a inteligência de código impede que Claude leia o que permanece para localizar uma definição.

223 223

224<h2 id="scope-worktrees-and-file-access">224<h2 id="scope-worktrees-and-file-access">

225 Escopo worktrees e acesso a arquivos225 Escopo de worktrees e acesso a arquivos

226</h2>226</h2>

227 227

228Essas configurações controlam o que está no disco em worktrees e quais diretórios Claude pode ler e escrever além do seu ponto inicial.228Essas configurações controlam o que está no disco em worktrees e quais diretórios Claude pode ler e escrever além do seu ponto de partida.

229 229

230<h3 id="check-out-only-the-directories-you-need">230<h3 id="check-out-only-the-directories-you-need">

231 Verifique apenas os diretórios que você precisa231 Faça checkout apenas dos diretórios que você precisa

232</h3>232</h3>

233 233

234A flag `--worktree` inicia uma sessão em um novo git worktree para que as mudanças fiquem isoladas do seu checkout principal. Por padrão, ela verifica todo o repositório. Em um repositório grande, a configuração `worktree.sparsePaths` usa git sparse-checkout para escrever apenas os diretórios listados mais arquivos em nível raiz no disco, para que worktrees iniciem mais rápido e usem menos espaço.234A flag `--worktree` inicia uma sessão em uma nova git worktree para que as alterações fiquem isoladas do seu checkout principal. Por padrão, ela faz checkout de todo o repositório. Em um repositório grande, a configuração `worktree.sparsePaths` usa git sparse-checkout para escrever apenas os diretórios listados mais arquivos no nível raiz no disco, para que worktrees iniciem mais rapidamente e usem menos espaço.

235 235

236Se todos que trabalham neste diretório precisam dos mesmos caminhos, confirme a configuração em `.claude/settings.json`. Para adicionar caminhos para você, use `.claude/settings.local.json`: as listas se mesclam entre escopos, então um arquivo local pode adicionar caminhos à lista confirmada mas não removê-los.236Se todos que trabalham neste diretório precisam dos mesmos caminhos, confirme a configuração em `.claude/settings.json`. Para adicionar caminhos para você mesmo, use `.claude/settings.local.json`: as listas se mesclam entre escopos, então um arquivo local pode adicionar caminhos à lista confirmada, mas não removê-los.

237 237

238Os exemplos JSON nesta página mostram uma configuração por vez. Se seu `.claude/settings.json` já contém outras chaves, como as regras `permissions.deny` acima, adicione a chave `worktree` ao lado delas em vez de substituir o arquivo. [Coloque tudo junto](#put-it-together) mostra o resultado combinado.238Os exemplos JSON nesta página mostram uma configuração por vez. Se seu `.claude/settings.json` já contiver outras chaves, como as regras `permissions.deny` acima, adicione a chave `worktree` ao lado delas em vez de substituir o arquivo. [Coloque tudo junto](#put-it-together) mostra o resultado combinado.

239 239

240O exemplo abaixo mostra o arquivo confirmado:240O exemplo abaixo mostra o arquivo confirmado:

241 241

251}251}

252```252```

253 253

254Quando Claude cria um worktree, ele verifica apenas `.claude/`, `packages/api/` e `packages/shared/` em vez da árvore completa. Os caminhos em `sparsePaths` são relativos à raiz do repositório, independentemente de qual subdiretório você inicia Claude. Qualquer caminho de diretório funciona aqui, não apenas raízes de pacote.254Quando Claude cria uma worktree, ele faz checkout apenas de `.claude/`, `packages/api/` e `packages/shared/` em vez da árvore completa. Os caminhos em `sparsePaths` são relativos à raiz do repositório, independentemente de qual subdiretório você inicia Claude. Qualquer caminho de diretório funciona aqui, não apenas raízes de pacotes.

255 255

256Isso é particularmente útil para [isolamento de worktree de subagente](/docs/pt/worktrees#isolate-subagents-with-worktrees). Subagentes são instâncias Claude paralelas geradas para subtarefas, e cada uma que executa em um worktree obtém um checkout leve em vez da árvore completa. Todos os worktrees em uma sessão compartilham o mesmo `sparsePaths`, então se um subagente precisa de `packages/api/` e outro precisa de `packages/web/`, liste ambos.256Isso é particularmente útil para [isolamento de worktree de subagentes](/docs/pt/worktrees#isolate-subagents-with-worktrees). Subagentes são instâncias paralelas de Claude geradas para subtarefas, e cada uma que é executada em uma worktree obtém um checkout leve em vez da árvore completa. Todas as worktrees em uma sessão compartilham o mesmo `sparsePaths`, então se um subagente precisa de `packages/api/` e outro precisa de `packages/web/`, liste ambos.

257 257

258Liste diretórios em `sparsePaths`, não arquivos individuais. Arquivos em nível raiz como `package.json`, `tsconfig.base.json` e arquivos de lock são sempre verificados ao lado dos diretórios que você lista. Diretórios em nível raiz não são, então inclua `.claude` na lista se você quer o `.claude/settings.json`, `.claude/rules/` ou `.claude/skills/` da raiz do repositório disponível dentro do worktree.258Liste diretórios em `sparsePaths`, não arquivos individuais. Arquivos no nível raiz como `package.json`, `tsconfig.base.json` e arquivos de lock são sempre feitos checkout ao lado dos diretórios que você lista. Diretórios no nível raiz não são, então inclua `.claude` na lista se você quiser que o `.claude/settings.json` da raiz do repositório ou `.claude/rules/` estejam disponíveis dentro da worktree. Para skills de projeto, agentes e comandos, veja [O que worktrees compartilham com o checkout principal](/docs/pt/worktrees#what-worktrees-share-with-the-main-checkout).

259 259

260Sparse checkout requer que git habilite `extensions.worktreeConfig` no `.git/config` compartilhado do repositório enquanto um worktree esparso existe. Claude Code remove essa entrada após o último worktree ser removido, mas apenas se Claude Code a adicionou. Nunca remove um valor que você definiu você mesmo. Antes da v2.1.207, a entrada permanecia após o último worktree ser removido, e ferramentas baseadas em go-git como `tea` falhavam ao abrir o repositório até você executar `git config --unset extensions.worktreeConfig`.260O sparse checkout requer que o git habilite `extensions.worktreeConfig` no `.git/config` compartilhado do repositório enquanto uma worktree esparsa existe. Claude Code remove essa entrada após a última worktree ser removida, mas apenas se Claude Code a adicionou. Nunca remove um valor que você definiu você mesmo. Antes da v2.1.207, a entrada permanecia após a última worktree ser removida, e ferramentas baseadas em go-git como `tea` falhavam ao abrir o repositório até que você executasse `git config --unset extensions.worktreeConfig`.

261 261

262Para evitar duplicar diretórios grandes como `node_modules` entre worktrees, emparelhe `sparsePaths` com `symlinkDirectories` no mesmo `.claude/settings.json`:262Para evitar duplicar diretórios grandes como `node_modules` entre worktrees, combine `sparsePaths` com `symlinkDirectories` no mesmo `.claude/settings.json`:

263 263

264```json .claude/settings.json theme={null}264```json .claude/settings.json theme={null}

265{265{

276}276}

277```277```

278 278

279Isso cria um symlink do `node_modules/` de cada worktree de volta para a cópia do repositório principal em vez de duplicá-lo no disco.279Isso cria um symlink de cada `node_modules/` da worktree de volta para a cópia do repositório principal em vez de duplicá-lo no disco.

280 280

281<Note>281<Note>

282 As configurações `sparsePaths` e `symlinkDirectories` são lidas do seu diretório inicial antes do worktree ser criado. Após a criação, o diretório de trabalho da sessão é a raiz do worktree, não o subdiretório do qual você iniciou. As configurações de projeto dentro do worktree portanto carregam do `.claude/settings.json` da raiz do worktree, a cópia verificada do arquivo da raiz do repositório. Coloque qualquer outra configuração que você precisa dentro de worktrees, como regras de permissão ou hooks, no `.claude/settings.json` da raiz do repositório.282 As configurações `sparsePaths` e `symlinkDirectories` são lidas do seu diretório inicial antes da worktree ser criada. Após a criação, o diretório de trabalho da sessão é a raiz da worktree, não o subdiretório do qual você iniciou. As configurações de projeto dentro da worktree, portanto, carregam do `.claude/settings.json` da raiz da worktree, a cópia verificada do arquivo da raiz do repositório. Coloque qualquer outra configuração que você precise dentro de worktrees, como regras de permissão ou hooks, no `.claude/settings.json` da raiz do repositório.

283</Note>283</Note>

284 284

285Para a referência completa de configurações de worktree, veja [Configurações de Worktree](/docs/pt/settings-reference#worktree).285Para a referência completa de configurações de worktree, veja [Configurações de Worktree](/docs/pt/settings-reference#worktree).

288 Conceda acesso entre pacotes ou repositórios288 Conceda acesso entre pacotes ou repositórios

289</h3>289</h3>

290 290

291Esta seção se aplica quando você inicia Claude de um subdiretório, ou quando uma tarefa abrange múltiplos checkouts. Se você inicia da raiz do repositório em uma grande árvore única, Claude já tem acesso a cada arquivo e você pode pular isso.291Esta seção se aplica quando você inicia Claude de um subdiretório, ou quando uma tarefa abrange múltiplos checkouts. Se você iniciar da raiz do repositório em uma única árvore grande, Claude já tem acesso a todos os arquivos e você pode pular isso.

292 292

293Quando você inicia Claude de `packages/api/`, ele pode ler e escrever arquivos dentro desse diretório. Se uma tarefa requer mudanças entre pacotes, como atualizar um tipo compartilhado que tanto `api` quanto `web` importam, você precisa conceder acesso ao diretório irmão. O mesmo mecanismo concede acesso a um repositório separadamente verificado.293Quando você inicia Claude de `packages/api/`, ele pode ler e escrever arquivos dentro desse diretório. Se uma tarefa requer alterações entre pacotes, como atualizar um tipo compartilhado que tanto `api` quanto `web` importam, você precisa conceder acesso ao diretório irmão. O mesmo mecanismo concede acesso a um repositório separadamente verificado.

294 294

295A configuração `additionalDirectories` em `.claude/settings.json` dá ao Claude acesso a diretórios fora do diretório de trabalho. O exemplo abaixo concede acesso a dois pacotes irmãos:295A configuração `additionalDirectories` em `.claude/settings.json` dá a Claude acesso a diretórios fora do diretório de trabalho. O exemplo abaixo concede acesso a dois pacotes irmãos:

296 296

297```json packages/api/.claude/settings.json theme={null}297```json packages/api/.claude/settings.json theme={null}

298{298{

305}305}

306```306```

307 307

308Os caminhos relativos resolvem contra o diretório do qual você inicia Claude. Com essa configuração, Claude pode ler e editar arquivos em `packages/shared/` e `packages/web/` enquanto trabalha de `packages/api/`.308Os caminhos relativos são resolvidos em relação ao diretório do qual você inicia Claude. Com essa configuração, Claude pode ler e editar arquivos em `packages/shared/` e `packages/web/` enquanto trabalha de `packages/api/`.

309 309

310Você também pode conceder acesso em tempo de execução sem editar configurações passando `--add-dir` quando você inicia Claude:310Você também pode conceder acesso em tempo de execução sem editar configurações passando `--add-dir` quando você inicia Claude:

311 311

321| Flag `--add-dir` ou comando `/add-dir` | Apenas com a variável de ambiente abaixo | Sim |321| Flag `--add-dir` ou comando `/add-dir` | Apenas com a variável de ambiente abaixo | Sim |

322 322

323Para carregar arquivos CLAUDE.md e regras de um diretório adicionado com `--add-dir` ou `/add-dir`, defina a variável de ambiente `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`:323Para carregar arquivos CLAUDE.md e rules de um diretório adicionado com `--add-dir` ou `/add-dir`, defina a variável de ambiente `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`:

324 324

325```bash theme={null}325```bash theme={null}

326CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared326CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared

328 328

329A variável de ambiente não tem efeito em diretórios listados na configuração `additionalDirectories`. Veja [Carregar de diretórios adicionais](/docs/pt/memory#load-from-additional-directories) para detalhes.329A variável de ambiente não tem efeito em diretórios listados na configuração `additionalDirectories`. Veja [Carregar de diretórios adicionais](/docs/pt/memory#load-from-additional-directories) para detalhes.

330 330

331Para diretórios irmãos que todos nesta área precisam, confirme `additionalDirectories` em `.claude/settings.json`. Para uma seleção pessoal ou acesso único, use `.claude/settings.local.json` ou passe `--add-dir` na inicialização.331Para diretórios irmãos que todos nesta área precisam, confirme `additionalDirectories` em `.claude/settings.json`. Para uma seleção pessoal ou acesso único, use `.claude/settings.local.json` ou passe `--add-dir` no lançamento.

332 332

333<h2 id="add-per-directory-skills">333<h2 id="add-per-directory-skills">

334 Adicione skills por diretório334 Adicione skills por diretório

llm-gateway-connect.md +2 −1

Details

578Estes são os erros mais comuns ao executar Claude Code através de um gateway, com a causa do lado do gateway e a correção:578Estes são os erros mais comuns ao executar Claude Code através de um gateway, com a causa do lado do gateway e a correção:

579 579

581| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |581| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

584| `Your apiKeyHelper script is failing`, ou `apiKeyHelper failed:` no stderr em modo não interativo | O comando na configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) não produziu uma chave utilizável, 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) |584| `Your apiKeyHelper script is failing`, ou `apiKeyHelper failed:` no stderr em modo não interativo | O comando na configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) não produziu uma chave utilizável, 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) |

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

589| 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 Claude Code não o reconheça como um [erro muito longo](/docs/pt/errors#prompt-is-too-long) e não compacte e tente novamente automaticamente | Execute `/compact` para recuperar a sessão. Para evitar, defina `CLAUDE_CODE_AUTO_COMPACT_WINDOW` para o limite do gateway; Claude Code fixa o valor 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 |589| 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 Claude Code não o reconheça como um [erro muito longo](/docs/pt/errors#prompt-is-too-long) e não compacte e tente novamente automaticamente | Execute `/compact` para recuperar a sessão. Para evitar, defina `CLAUDE_CODE_AUTO_COMPACT_WINDOW` para o limite do gateway; Claude Code fixa o valor 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 |

590| Erros `400` em cada solicitação, nas próprias palavras do gateway rejeitando um esquema de entrada de ferramenta ou seu `pattern`, em Claude Code v2.1.265 até v2.1.267 | Em um lançamento gradual nessas versões, o esquema da [ferramenta Artifact](/docs/pt/artifacts#availability) carrega uma expressão regular com classes de caracteres Unicode `\p{...}`. A API Anthropic aceita, mas um gateway ou upstream que verifica o `pattern` de cada esquema de ferramenta com seu próprio mecanismo de regex rejeita toda a solicitação | Atualize para v2.1.268 ou posterior, que não envia a expressão regular. Em uma versão afetada, [desative artefatos](/docs/pt/artifacts#disable-artifacts), que remove a ferramenta e seu esquema das solicitações |590| Erros `400` em cada solicitação, nas próprias palavras do gateway rejeitando um esquema de entrada de ferramenta ou seu `pattern`, em Claude Code v2.1.265 até v2.1.267 | Em um lançamento gradual nessas versões, o esquema da [ferramenta Artifact](/docs/pt/artifacts#availability) carrega uma expressão regular com classes de caracteres Unicode `\p{...}`. A API Anthropic aceita, mas um gateway ou upstream que verifica o `pattern` de cada esquema de ferramenta com seu próprio mecanismo de regex rejeita toda a solicitação | Atualize para v2.1.268 ou posterior, que não envia a expressão regular. Em uma versão afetada, [desative artefatos](/docs/pt/artifacts#disable-artifacts), que remove a ferramenta e seu esquema das solicitações |

591| Erros `400` em cada solicitação, nas próprias palavras do gateway rejeitando um tipo de ferramenta não reconhecido, como `Input tag 'advisor_20260301'`, em Claude Code v2.1.275 | Em um lançamento gradual nessa versão, as solicitações carregam uma entrada de [ferramenta advisor](/docs/pt/advisor) mesmo com o advisor desativado. A API Anthropic aceita, mas um gateway ou upstream que valida tipos de ferramenta rejeita toda a solicitação; um que [encaminha campos de corpo de solicitação inalterados](/docs/pt/llm-gateway-protocol#forward-as-open-lists) passa sem ser afetado. A entrada é uma declaração que não carrega conteúdo de conversa | Atualize para v2.1.276 ou posterior, que não envia a entrada atrás de um gateway `ANTHROPIC_BASE_URL` a menos que você ative o advisor. Em v2.1.275, defina [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](/docs/pt/env-vars), que remove a entrada das solicitações |

591| Modelos faltando do seletor `/model` | Nomes de modelo de gateway não estão na lista integrada de Claude Code, ou Claude Code está mostrando um lineup [`modelPicker`](/docs/pt/settings-reference#modelpicker) que substitui as opções integradas | 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). Se Claude Code mostrar um lineup `modelPicker` substituto, adicione os modelos de gateway a ele, ou peça ao seu administrador para adicioná-los quando as configurações gerenciadas o fornecerem |592| Modelos faltando do seletor `/model` | Nomes de modelo de gateway não estão na lista integrada de Claude Code, ou Claude Code está mostrando um lineup [`modelPicker`](/docs/pt/settings-reference#modelpicker) que substitui as opções integradas | 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). Se Claude Code mostrar um lineup `modelPicker` substituto, adicione os modelos de gateway a ele, ou peça ao seu administrador para adicioná-los quando as configurações gerenciadas o fornecerem |

592| `/fast` relata `Fast mode unavailable due to network connectivity issues` enquanto as solicitações de inferência funcionam | A verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode) vai diretamente para `api.anthropic.com` e não segue `ANTHROPIC_BASE_URL`, portanto a saída direta bloqueada falha na verificação. A mesma mensagem aparece em uma rede aberta quando a verificação apresenta uma chave emitida por gateway de `ANTHROPIC_API_KEY` ou um `apiKeyHelper` e Anthropic a rejeita | Coloque na lista de permissões `api.anthropic.com` se a saída estiver bloqueada, ou defina uma variável de skip; para uma chave de gateway rejeitada apenas as variáveis de skip ajudam. Consulte [usar modo rápido atrás de proxies e gateways LLM](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |593| `/fast` relata `Fast mode unavailable due to network connectivity issues` enquanto as solicitações de inferência funcionam | A verificação de disponibilidade do [modo rápido](/docs/pt/fast-mode) vai diretamente para `api.anthropic.com` e não segue `ANTHROPIC_BASE_URL`, portanto a saída direta bloqueada falha na verificação. A mesma mensagem aparece em uma rede aberta quando a verificação apresenta uma chave emitida por gateway de `ANTHROPIC_API_KEY` ou um `apiKeyHelper` e Anthropic a rejeita | Coloque na lista de permissões `api.anthropic.com` se a saída estiver bloqueada, ou defina uma variável de skip; para uma chave de gateway rejeitada apenas as variáveis de skip ajudam. Consulte [usar modo rápido atrás de proxies e gateways LLM](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

593| `/fast` relata `Fast mode has been disabled by your organization` em uma sessão autenticada com `ANTHROPIC_AUTH_TOKEN`, mesmo que a organização tenha modo rápido ativado | A verificação de disponibilidade requer um login claude.ai ou uma chave de API Anthropic; com apenas um token de portador, Claude Code trata o modo rápido como desativado sem enviar a verificação | Defina `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; consulte [usar modo rápido atrás de proxies e gateways LLM](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |594| `/fast` relata `Fast mode has been disabled by your organization` em uma sessão autenticada com `ANTHROPIC_AUTH_TOKEN`, mesmo que a organização tenha modo rápido ativado | A verificação de disponibilidade requer um login claude.ai ou uma chave de API Anthropic; com apenas um token de portador, Claude Code trata o modo rápido como desativado sem enviar a verificação | Defina `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; consulte [usar modo rápido atrás de proxies e gateways LLM](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

llm-gateway-protocol.md +34 −0

Details

144 144

145Se seus desenvolvedores definirem `ANTHROPIC_CUSTOM_HEADERS`, esses headers também aparecem em solicitações.145Se seus desenvolvedores definirem `ANTHROPIC_CUSTOM_HEADERS`, esses headers também aparecem em solicitações.

146 146

147<h3 id="gateway-hint-headers">

148 Headers de dica de gateway

149</h3>

150

151Claude Code também pode enviar dicas de roteamento: fatos por solicitação que um gateway ou roteador pode usar para agendar, armazenar em cache ou atribuir uma solicitação. Requer Claude Code v2.1.273 ou posterior.

152

153Se uma solicitação as carrega depende de onde Claude Code as envia:

154

155* Conexão direta com a API Anthropic: enviado por padrão

156* URL base personalizada: desativado por padrão, porque um proxy que rejeita headers desconhecidos falharia na solicitação. Para recebê-los, defina [`CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`](/docs/pt/env-vars) para seus desenvolvedores, por exemplo no bloco `env` de [configurações gerenciadas](/docs/pt/managed-settings)

157* Qualquer outro backend, incluindo Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e Claude Platform on AWS: enviado apenas quando `CLAUDE_CODE_GATEWAY_HINT_HEADERS=1` está definido

158

159Definir `CLAUDE_CODE_GATEWAY_HINT_HEADERS` para `0` interrompe os headers em cada conexão.

160

161Os headers carregam apenas o que as linhas abaixo listam: vocabulários fixos, nomes de ferramentas e durações, nunca texto de prompt ou conteúdo de arquivo. Cada valor é ASCII imprimível.

162

163| Header | Descrição |

164| :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

165| `x-claude-code-request-class` | Que tipo de solicitação é esta: `main` para uma volta da conversa principal, `subagent` para uma volta de um [subagente](/docs/pt/sub-agents), `workflow` para um agente executando dentro de um workflow, `compaction` para a solicitação de resumo que compacta uma conversa, ou `auxiliary` para solicitações laterais como títulos de sessão, classificadores e resumos. Enviado em cada solicitação |

166| `x-claude-code-agent-type` | O tipo de subagente que emitiu a solicitação: um nome de tipo de agente integrado como `Explore`, `Plan` ou `general-purpose`, ou `custom` para um agente definido pelo usuário, `teammate` para um membro da [equipe de agentes](/docs/pt/agent-teams) executando no processo do líder, ou `fork` para um [fork](/docs/pt/sub-agents#fork-the-current-conversation). Presente apenas nas próprias voltas de um subagente; solicitações de compactação ou laterais de um subagente mantêm o ID do agente mas não carregam tipo. Um nome de agente escolhido pelo usuário nunca é enviado |

167| `x-claude-code-compaction` | Presente na solicitação que resume a conversa durante uma [compactação](/docs/pt/prompt-caching#compacting-the-conversation). O valor diz o que a acionou: `auto` quando a janela de contexto se aproximava da capacidade, `manual` para `/compact`, ou `reactive` quando a API rejeitou uma solicitação como muito longa. Ausente em todas as outras solicitações |

168| `x-claude-code-context-compacted` | Presente uma vez, na primeira solicitação de conversa principal após uma compactação, com os mesmos valores que `x-claude-code-compaction`. O prefixo de conversa antes desta solicitação não é mais usado, então um cache com chave nele pode ser descartado |

169| `x-claude-code-prev-tool-durations` | Tempo de execução medido das chamadas de ferramenta cujos resultados esta solicitação carrega, como `<name>=<ms>;<name>=<ms>`, por exemplo `Bash=742;Read=9`. Enviado na próxima solicitação da mesma conversa após um lote de chamadas de ferramenta, da sessão principal ou de um subagente |

170

171Antes de analisar `x-claude-code-prev-tool-durations`, verifique como Claude Code constrói o valor e o que deixa de fora:

172

173* Entradas: uma por chamada de ferramenta que foi executada, na ordem em que seu resultado foi coletado, em milissegundos inteiros

174* Limite: Claude Code envia no máximo 32 entradas e 4 KB, mantendo as primeiras entradas

175* Codificação: nomes de ferramentas são codificados em percentual, cobrindo `%`, `;`, `=`, vírgula, espaço e qualquer caractere fora do ASCII imprimível

176* Análise: dividir em `;`, depois em `=`, e decodificar cada nome

177* Ausência: chamadas de compactação, solicitações laterais e a primeira solicitação de um novo prompt nunca a carregam. Não leia um header ausente como uma volta que não executou ferramentas

178* Tempos: cada um exclui prompts de permissão e hooks, e chamadas de ferramenta paralelas cada uma relata seu próprio tempo, então as entradas não somam a lacuna entre solicitações

179

147<h3 id="forward-as-open-lists">180<h3 id="forward-as-open-lists">

148 Encaminhar como listas abertas181 Encaminhar como listas abertas

149</h3>182</h3>

221 254

222* Quando o upstream rejeita o campo `thinking`, uma mensagem de sistema no meio da conversa, ou o marcador `cache_control` em tal mensagem, Claude Code tenta novamente a solicitação e desabilita a capacidade rejeitada pelo resto da conversa255* Quando o upstream rejeita o campo `thinking`, uma mensagem de sistema no meio da conversa, ou o marcador `cache_control` em tal mensagem, Claude Code tenta novamente a solicitação e desabilita a capacidade rejeitada pelo resto da conversa

223* Quando o upstream rejeita uma [assinatura de pensamento](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), incluindo com um `400` cuja mensagem diz que o bloco está `bound to a different conversation`, Claude Code remove blocos de pensamento anteriores da solicitação, tenta novamente, e os mantém fora de cada solicitação posterior. Novas respostas ainda incluem pensamento256* Quando o upstream rejeita uma [assinatura de pensamento](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), incluindo com um `400` cuja mensagem diz que o bloco está `bound to a different conversation`, Claude Code remove blocos de pensamento anteriores da solicitação, tenta novamente, e os mantém fora de cada solicitação posterior. Novas respostas ainda incluem pensamento

257* Quando o gateway ou seu upstream rejeita a entrada da [ferramenta advisor](/docs/pt/advisor) em `tools` como um tipo de ferramenta não reconhecido, Claude Code tenta novamente a solicitação uma vez sem essa entrada e seu valor `anthropic-beta`. Solicitações posteriores para essa URL base deixam o advisor de fora até Claude Code sair, e `/advisor` fica indisponível para o desenvolvedor por esse tempo. Claude Code reconhece essa rejeição por uma resposta `400` ou `422` cuja mensagem nomeia o tipo de ferramenta após `Input tag`, como `Input tag 'advisor_20260301'`. Antes da v2.1.280, Claude Code não tentava novamente essa rejeição

224* Claude Code não tenta novamente rejeições de gerenciamento de contexto ou campos de schema de ferramenta, então esses erros `400` chegam ao desenvolvedor258* Claude Code não tenta novamente rejeições de gerenciamento de contexto ou campos de schema de ferramenta, então esses erros `400` chegam ao desenvolvedor

225 259

226A rejeição `bound to a different conversation` vem da verificação de [pensamento preservado](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) da API, que falha quando conteúdo de `system`, `tools`, ou `messages` anteriores difere da solicitação que produziu o pensamento. Um gateway que reescreve qualquer um desses conteúdos pode causar a rejeição em si; [Bibliotecas, proxies e gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) cobre o que passar inalterado.260A rejeição `bound to a different conversation` vem da verificação de [pensamento preservado](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) da API, que falha quando conteúdo de `system`, `tools`, ou `messages` anteriores difere da solicitação que produziu o pensamento. Um gateway que reescreve qualquer um desses conteúdos pode causar a rejeição em si; [Bibliotecas, proxies e gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) cobre o que passar inalterado.

llm-gateway-rollout.md +1 −0

Details

185| `apiKeyHelper`, ou uma credencial em `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_API_KEY` | Autentica cada solicitação ao gateway. O auxiliar executa um comando para buscar a chave; as variáveis mantêm uma chave estática, enviada como `Authorization: Bearer` e `x-api-key` respectivamente | Sempre; uma das três |185| `apiKeyHelper`, ou uma credencial em `ANTHROPIC_AUTH_TOKEN` ou `ANTHROPIC_API_KEY` | Autentica cada solicitação ao gateway. O auxiliar executa um comando para buscar a chave; as variáveis mantêm uma chave estática, enviada como `Authorization: Bearer` e `x-api-key` respectivamente | Sempre; uma das três |

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_GATEWAY_HINT_HEADERS` | Envia os [cabeçalhos de dica de gateway](/docs/pt/llm-gateway-protocol#gateway-hint-headers), que classificam cada solicitação para decisões de roteamento e agendamento no gateway. Requer Claude Code v2.1.273 ou posterior | Seu gateway lê os cabeçalhos de dica |

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_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. [Desabilite capacidades pré-lançamento](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) cobre o escopo exato | Seu gateway encaminha para um Amazon Bedrock ou Google Cloud's Agent Platform upstream que rejeita campos beta. Consulte [Requisitos do gateway](#gateway-requirements) |189| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Para Claude Code de enviar cabeçalhos de capacidade pré-lançamento e campos de corpo. [Desabilite capacidades pré-lançamento](/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) cobre o escopo exato | Seu gateway encaminha para um Amazon Bedrock ou Google Cloud's Agent Platform upstream que rejeita campos beta. Consulte [Requisitos do gateway](#gateway-requirements) |

189| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` ou `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Restaura [fast mode](/docs/pt/fast-mode) quando sua verificação de disponibilidade, que chama `api.anthropic.com` diretamente em vez de seguir `ANTHROPIC_BASE_URL`, falha, é interceptada ou é ignorada por falta de uma credencial Anthropic | Sua organização usa fast mode, e os desenvolvedores autenticam com `ANTHROPIC_AUTH_TOKEN` sozinho, com uma chave emitida pelo gateway em `ANTHROPIC_API_KEY` ou de um `apiKeyHelper`, ou sua rede bloqueia ou intercepta solicitações diretas para `api.anthropic.com`; [use fast mode atrás de proxies e gateways LLM](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) cobre qual das duas variáveis corresponde à sua configuração |190| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` ou `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Restaura [fast mode](/docs/pt/fast-mode) quando sua verificação de disponibilidade, que chama `api.anthropic.com` diretamente em vez de seguir `ANTHROPIC_BASE_URL`, falha, é interceptada ou é ignorada por falta de uma credencial Anthropic | Sua organização usa fast mode, e os desenvolvedores autenticam com `ANTHROPIC_AUTH_TOKEN` sozinho, com uma chave emitida pelo gateway em `ANTHROPIC_API_KEY` ou de um `apiKeyHelper`, ou sua rede bloqueia ou intercepta solicitações diretas para `api.anthropic.com`; [use fast mode atrás de proxies e gateways LLM](/docs/pt/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) cobre qual das duas variáveis corresponde à sua configuração |

managed-settings.md +8 −2

Details

361Algumas chaves de aplicação não são descartadas quando inválidas. Claude Code aplica um fallback mais restritivo até que o valor seja corrigido; a tabela mostra o que aplica para cada chave:361Algumas chaves de aplicação não são descartadas quando inválidas. Claude Code aplica um fallback mais restritivo até que o valor seja corrigido; a tabela mostra o que aplica para cada chave:

362 362

364| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |364| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

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

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

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

369| `strictKnownMarketplaces` | Aplicado como uma lista de permissões vazia até que o valor seja corrigido, portanto nenhuma [fonte de marketplace](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) é admitida. Uma entrada individual que é inválida ou não pode ser aplicada, como um regex `hostPattern` que não compila, é removida e o subconjunto válido é aplicado. |

369| `allowManagedHooksOnly` | Tratado como `true` até ser corrigido: as [restrições de hook](/docs/pt/settings-reference#allowmanagedhooksonly) se aplicam e, a menos que `disableCommandPluginSources` seja explicitamente `false`, plugins de origem de comando são desabilitados. |370| `allowManagedHooksOnly` | Tratado como `true` até ser corrigido: as [restrições de hook](/docs/pt/settings-reference#allowmanagedhooksonly) se aplicam e, a menos que `disableCommandPluginSources` seja explicitamente `false`, plugins de origem de comando são desabilitados. |

371| `disableCommandPluginSources` | Tratado como `true`, portanto plugins de origem de comando permanecem desabilitados até que o valor seja corrigido. |372| `disableCommandPluginSources` | Tratado como `true`, portanto plugins de origem de comando permanecem desabilitados até que o valor seja corrigido. |

373| `disableSideloadFlags` | Tratado como `true` até que o valor seja corrigido, com os efeitos listados para [`disableSideloadFlags`](/docs/pt/settings-reference#disablesideloadflags). |

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

376| `syncClaudeAiPlugins` | Tratado como `false`, portanto a sincronização de [plugins claude.ai](/docs/pt/settings-reference#syncclaudeaiplugins) está desativada até que o valor seja corrigido. |

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

376| `crossSessionInbound` | Tratado como `refuse`, o valor mais restritivo, portanto [mensagens entre sessões](/docs/pt/cross-session-messaging#control-inbound-messages) de entrada são recusadas até que o valor seja corrigido. O desenvolvedor vê [um aviso](/docs/pt/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |379| `crossSessionInbound` | Tratado como `refuse`, o valor mais restritivo, portanto [mensagens entre sessões](/docs/pt/cross-session-messaging#control-inbound-messages) de entrada são recusadas até que o valor seja corrigido. O desenvolvedor vê [um aviso](/docs/pt/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |

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

381| `blockedMarketplaces` | Uma entrada individual inválida é removida e o subconjunto válido é aplicado. Uma entrada que analisa mas nunca pode corresponder, como um regex `hostPattern` que não compila, é mantida com um aviso. Ela bloqueia nada até ser corrigida, mas [restrições de marketplace](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) permanecem ativas. Um valor totalmente inválido é descartado com um aviso, já que bloquear cada marketplace bloquearia fontes que a política nunca nomeou. |

378| `sandbox.credentials` | Uma entrada inválida recuperável é degradada para `mode: "deny"` com um aviso; uma irrecuperável é removida; entradas válidas permanecem aplicadas. Consulte [entradas de credencial inválidas](/docs/pt/settings-reference#invalid-credential-entries-in-managed-settings) |382| `sandbox.credentials` | Uma entrada inválida recuperável é degradada para `mode: "deny"` com um aviso; uma irrecuperável é removida; entradas válidas permanecem aplicadas. Consulte [entradas de credencial inválidas](/docs/pt/settings-reference#invalid-credential-entries-in-managed-settings) |

379 383

380`allowedHttpHookUrls` e `httpHookAllowedEnvVars` mesclam entre arquivos de configurações, portanto entradas em suas configurações de usuário, projeto ou local ainda se aplicam enquanto a lista gerenciada está vazia. Os fallbacks para essas duas chaves e para `allowedChannelPlugins` requerem Claude Code v2.1.267 ou posterior; versões anteriores descartam a chave inteira quando seu valor ou qualquer entrada é inválida.384`allowedHttpHookUrls` e `httpHookAllowedEnvVars` mesclam entre arquivos de configurações, portanto entradas em suas configurações de usuário, projeto ou local ainda se aplicam enquanto a lista gerenciada está vazia.

385

386Os fallbacks para essas duas chaves e para `allowedChannelPlugins` requerem Claude Code v2.1.267 ou posterior; versões anteriores descartam a chave inteira quando seu valor ou qualquer entrada é inválida. Os fallbacks para `strictKnownMarketplaces`, `blockedMarketplaces` e `disableSideloadFlags` requerem Claude Code v2.1.277 ou posterior; versões anteriores descartam a chave inteira quando seu valor ou qualquer entrada é inválida.

381 387

382`requiredMinimumVersion` e `requiredMaximumVersion` falham abertos por design: um valor inválido é descartado em vez de ser aplicado.388`requiredMinimumVersion` e `requiredMaximumVersion` falham abertos por design: um valor inválido é descartado em vez de ser aplicado.

383 389

memory.md +24 −9

Details

82<Tip>82<Tip>

83 Execute `/init` para gerar um CLAUDE.md inicial automaticamente. Claude analisa seu codebase e cria um arquivo com comandos de compilação, instruções de teste e convenções de projeto que descobre. Se um CLAUDE.md já existe, `/init` sugere melhorias em vez de sobrescrever. Refine a partir daí com instruções que Claude não descobriria por conta própria.83 Execute `/init` para gerar um CLAUDE.md inicial automaticamente. Claude analisa seu codebase e cria um arquivo com comandos de compilação, instruções de teste e convenções de projeto que descobre. Se um CLAUDE.md já existe, `/init` sugere melhorias em vez de sobrescrever. Refine a partir daí com instruções que Claude não descobriria por conta própria.

84 84

85 Defina `CLAUDE_CODE_NEW_INIT=1` para ativar um fluxo interativo de várias fases. `/init` pergunta quais artefatos configurar: arquivos CLAUDE.md, skills e hooks. Em seguida, explora seu codebase com um subagente, preenche lacunas por meio de perguntas de acompanhamento e apresenta uma proposta revisável antes de escrever qualquer arquivo.85 Para um fluxo interativo de várias fases em vez disso, defina a variável de ambiente `CLAUDE_CODE_NEW_INIT` como `1` antes de executar `/init`. Defina-a em seu shell ou no bloco `env` de um arquivo de configurações, conforme mostrado em [Defina variáveis de ambiente](/docs/pt/env-vars#set-environment-variables). Com ela definida, `/init` pergunta quais artefatos configurar: arquivos CLAUDE.md, skills e hooks. Em seguida, explora seu codebase com um subagente, preenche lacunas por meio de perguntas de acompanhamento e apresenta uma proposta revisável antes de escrever qualquer arquivo. A variável apenas muda como `/init` é executado, portanto você pode deixá-la definida.

86</Tip>86</Tip>

87 87

88<h3 id="write-effective-instructions">88<h3 id="write-effective-instructions">

124 124

125Para preferências pessoais por projeto que não devem ser verificadas no controle de versão, crie um `CLAUDE.local.md` na raiz do projeto. Ele carrega junto com `CLAUDE.md` e é tratado da mesma forma. Adicione `CLAUDE.local.md` ao seu `.gitignore` para que não seja confirmado. Com `CLAUDE_CODE_NEW_INIT=1` definido, executar `/init` e escolher a opção pessoal faz isso para você.125Para preferências pessoais por projeto que não devem ser verificadas no controle de versão, crie um `CLAUDE.local.md` na raiz do projeto. Ele carrega junto com `CLAUDE.md` e é tratado da mesma forma. Adicione `CLAUDE.local.md` ao seu `.gitignore` para que não seja confirmado. Com `CLAUDE_CODE_NEW_INIT=1` definido, executar `/init` e escolher a opção pessoal faz isso para você.

126 126

127Se você trabalha em várias worktrees git do mesmo repositório, um `CLAUDE.local.md` ignorado pelo git existe apenas na worktree onde você o criou. Para compartilhar instruções pessoais entre worktrees, importe um arquivo do seu diretório inicial em vez disso:127Se você trabalha em várias Git Worktrees do mesmo repositório, um `CLAUDE.local.md` ignorado pelo git existe apenas na worktree onde você o criou. Para compartilhar instruções pessoais entre worktrees, importe um arquivo do seu diretório inicial em vez disso:

128 128

129```text theme={null}129```text theme={null}

130# Preferências Individuais130# Preferências Individuais

165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

166```166```

167 167

168O formulário inline define a variável para esse único lançamento em Bash ou Zsh. Para mantê-la ativada para cada sessão, adicione-a ao bloco `env` em `~/.claude/settings.json` conforme mostrado em [Defina variáveis de ambiente](/docs/pt/env-vars#set-environment-variables).

169

168Isso 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).170Isso 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).

169 171

170<h3 id="organize-rules-with-claude/rules/">172<h3 id="organize-rules-with-claude/rules/">

244 246

245A sintaxe 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: 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.247A sintaxe 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: 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.

246 248

249<h4 id="rules-frontmatter-reference">

250 Referência de frontmatter de regra

251</h4>

252

253Configure uma regra com [frontmatter](/docs/pt/glossary#frontmatter) YAML entre marcadores `---` no topo do arquivo. `paths` é o único campo que Claude Code lê de uma regra; qualquer outro campo é ignorado sem um erro. Claude Code remove o frontmatter antes de carregar a regra em contexto.

254

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

256| :------ | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |

257| `paths` | Não | Padrões glob que [escopo a regra para arquivos correspondentes](#path-specific-rules). Aceita uma lista YAML ou uma string separada por vírgulas |

258

259Se o YAML entre os marcadores não for analisado, Claude Code ignora o frontmatter e carrega a regra como se não tivesse `paths`. Execute `claude --debug` para ver o erro de análise.

260

247<h4 id="share-rules-across-projects-with-symlinks">261<h4 id="share-rules-across-projects-with-symlinks">

248 Compartilhe regras entre projetos com symlinks262 Compartilhe regras entre projetos com symlinks

249</h4>263</h4>

250 264

251O diretório `.claude/rules/` suporta symlinks, portanto você pode manter um conjunto compartilhado de regras e vinculá-las em vários projetos. Symlinks circulares são detectados e tratados graciosamente.265O diretório `.claude/rules/` suporta symlinks, portanto você pode manter um conjunto compartilhado de regras e vinculá-las em vários projetos. Symlinks circulares são detectados e tratados graciosamente.

252 266

253Claude Code trata um symlink cujo alvo está fora do seu diretório de trabalho como uma [importação externa](#import-additional-files). As regras vinculadas não carregam até que você aprove importações externas para o projeto, e depois apenas as sem um campo [`paths`](#path-specific-rules) carregam. Claude Code pede essa aprovação apenas quando um arquivo de memória do projeto importa um arquivo fora do diretório de trabalho com `@path`, não apenas para symlinks. Para carregar regras compartilhadas sem essa aprovação, mantenha-as em [`~/.claude/rules/`](#user-level-rules), onde se aplicam a cada projeto em sua máquina.267Claude Code trata um symlink cujo alvo está fora do seu diretório de trabalho como uma [importação externa](#import-additional-files). As regras vinculadas não carregam até que você aprove importações externas para o projeto, e depois apenas as sem um campo [`paths`](#path-specific-rules) carregam. Claude Code pede essa aprovação apenas quando um arquivo de memória do projeto importa um arquivo fora do diretório de trabalho com `@path`, não para symlinks sozinhos. Para carregar regras compartilhadas sem essa aprovação, mantenha-as em [`~/.claude/rules/`](#user-level-rules), onde se aplicam a cada projeto em sua máquina.

254 268

255Este exemplo vincula um diretório compartilhado e um arquivo individual:269Este exemplo vincula um diretório compartilhado e um arquivo individual:

256 270

271└── workflows.md # Seus fluxos de trabalho preferidos285└── workflows.md # Seus fluxos de trabalho preferidos

272```286```

273 287

274As regras em nível de usuário são carregadas antes das regras do projeto, dando às regras do projeto prioridade mais alta.288Claude Code carrega regras em nível de usuário antes das regras do projeto, portanto uma regra do projeto aparece mais tarde no contexto do Claude do que uma regra do usuário. Nenhum conjunto sobrescreve o outro: se uma regra do usuário e uma regra do projeto conflitarem, Claude pode seguir qualquer uma, portanto mantenha as duas consistentes.

275 289

276<h3 id="manage-claude-md-for-large-teams">290<h3 id="manage-claude-md-for-large-teams">

277 Gerencie CLAUDE.md para grandes equipes291 Gerencie CLAUDE.md para grandes equipes

424* Você está em uma versão Claude Code anterior à v2.1.277438* Você está em uma versão Claude Code anterior à v2.1.277

425* Sua sessão não [busca sinalizadores de recursos da Anthropic](/docs/pt/env-vars#features-that-need-feature-flag-fetching), por exemplo, porque você usa Amazon Bedrock ou outro provedor de terceiros, ou desabilitou a telemetria. A seção vinculada tem a lista completa439* Sua sessão não [busca sinalizadores de recursos da Anthropic](/docs/pt/env-vars#features-that-need-feature-flag-fetching), por exemplo, porque você usa Amazon Bedrock ou outro provedor de terceiros, ou desabilitou a telemetria. A seção vinculada tem a lista completa

426* É sua [primeira sessão depois que você instala ou atualiza](/docs/pt/env-vars#first-session-after-an-install-or-upgrade) para uma versão com suporte a `AGENTS.md`. Claude lê `AGENTS.md` a partir de sua próxima sessão440* É sua [primeira sessão depois que você instala ou atualiza](/docs/pt/env-vars#first-session-after-an-install-or-upgrade) para uma versão com suporte a `AGENTS.md`. Claude lê `AGENTS.md` a partir de sua próxima sessão

427* Você ou sua organização definiram [`disableAllHooks`](/docs/pt/settings-reference#disableallhooks) ou [`allowManagedHooksOnly`](/docs/pt/settings-reference#allowmanagedhooksonly), ou você desabilitou o plugin `agents-md` integrado em `/plugin`441* Você desabilitou o plugin `agents-md` integrado em `/plugin`

428 442

429Para dar ao Claude seu `AGENTS.md` nessas sessões, [importe-o de um `CLAUDE.md`](#share-one-file-with-other-coding-tools).443Para dar ao Claude seu `AGENTS.md` nessas sessões, [importe-o de um `CLAUDE.md`](#share-one-file-with-other-coding-tools).

430 444

435Um `AGENTS.md` que Claude lê através da configuração **Project instructions** difere de um `CLAUDE.md` nestes lugares:449Um `AGENTS.md` que Claude lê através da configuração **Project instructions** difere de um `CLAUDE.md` nestes lugares:

436 450

438| :------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |452| :------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------- |

439| `/memory` e a lista **Memory files** em `/context` | Listado | Não listado. Para confirmar que Claude o leu, procure pela [linha `AGENTS.md loaded`](#when-claude-code-reads-agents-md) sob o valor padrão, ou pergunte ao Claude o que suas instruções de projeto dizem |

440| [Hooks `InstructionsLoaded`](/docs/pt/hooks#instructionsloaded) | Disparam | Não disparam. Eles disparam normalmente para um `AGENTS.md` que um `CLAUDE.md` importa ou cria um symlink para |453| [Hooks `InstructionsLoaded`](/docs/pt/hooks#instructionsloaded) | Disparam | Não disparam. Eles disparam normalmente para um `AGENTS.md` que um `CLAUDE.md` importa ou cria um symlink para |

441| Diretórios que você adiciona com `--add-dir` enquanto [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) está definido | Seu `CLAUDE.md` carrega | Seu `AGENTS.md` não carrega |454| Diretórios que você adiciona com `--add-dir` enquanto [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) está definido | Seu `CLAUDE.md` carrega | Seu `AGENTS.md` não carrega |

442| Uma importação `@path` de um arquivo fora de seu diretório de trabalho | Claude Code pede que você aprove [importações externas](#import-additional-files) | Carrega apenas se você já aprovou importações externas para este projeto, sem prompt |455| Uma importação `@path` de um arquivo fora de seu diretório de trabalho | Claude Code pede que você aprove [importações externas](#import-additional-files) | Carrega apenas se você já aprovou importações externas para este projeto, sem prompt |

604 617

605Para depurar:618Para depurar:

606 619

607* Execute `/context` e verifique a lista sob **Memory files** para verificar se seus arquivos CLAUDE.md e CLAUDE.local.md foram carregados. Se um arquivo `CLAUDE.md` estiver faltando lá, Claude não pode vê-lo. Um `AGENTS.md` aparece lá apenas quando um `CLAUDE.md` o importa, não quando Claude [o lê diretamente](#where-agents-md-differs-from-claude-md). Use `/memory` para abrir e editar os arquivos.620* Execute `/context` e verifique a lista sob **Memory files** para verificar se seus arquivos CLAUDE.md e CLAUDE.local.md foram carregados. Se um arquivo `CLAUDE.md` estiver faltando lá, Claude não pode vê-lo. Use `/memory` para abrir e editar os arquivos.

608* Verifique se o CLAUDE.md relevante está em um local que é carregado para sua sessão (veja [Escolha onde colocar arquivos CLAUDE.md](#choose-where-to-put-claude-md-files)).621* Verifique se o CLAUDE.md relevante está em um local que é carregado para sua sessão (veja [Escolha onde colocar arquivos CLAUDE.md](#choose-where-to-put-claude-md-files)).

609* Torne as instruções mais específicas. "Use indentação de 2 espaços" funciona melhor do que "formate o código adequadamente."622* Torne as instruções mais específicas. "Use indentação de 2 espaços" funciona melhor do que "formate o código adequadamente."

610* 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.623* 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.

6283. Verifique se sua sessão é uma que [não pode carregar `AGENTS.md`](#when-agents-md-support-is-unavailable), como uma sessão em um provedor de terceiros ou com telemetria desabilitada.6413. Verifique se sua sessão é uma que [não pode carregar `AGENTS.md`](#when-agents-md-support-is-unavailable), como uma sessão em um provedor de terceiros ou com telemetria desabilitada.

6294. Digite `/config` em sua sessão para abrir o painel de configurações e confirme que **Project instructions** não está definido como `claude-md` ou `managed-only`. Se você não vir a configuração lá em absoluto, sua sessão é uma que [não pode carregar `AGENTS.md`](#when-agents-md-support-is-unavailable).6424. Digite `/config` em sua sessão para abrir o painel de configurações e confirme que **Project instructions** não está definido como `claude-md` ou `managed-only`. Se você não vir a configuração lá em absoluto, sua sessão é uma que [não pode carregar `AGENTS.md`](#when-agents-md-support-is-unavailable).

630 643

631`AGENTS.md` não aparece em `/memory` ou `/context` quando Claude o lê diretamente, então procure pela linha `AGENTS.md loaded` ou pergunte a Claude quais são suas instruções de projeto em vez disso.644Para verificar se Claude leu seu `AGENTS.md`, execute `/memory` e procure por seu caminho na lista.

645

646Antes da v2.1.280, `/memory` e `/context` não listavam um `AGENTS.md` que Claude leu diretamente. Nessas versões, pergunte a Claude o que suas instruções de projeto dizem em vez disso.

632 647

633Se você quiser manter o `CLAUDE.md` que encontrou, ou sua sessão não pode carregar `AGENTS.md`, [adicione um `CLAUDE.md` ao lado de seu `AGENTS.md` que o importa](#share-one-file-with-other-coding-tools).648Se você quiser manter o `CLAUDE.md` que encontrou, ou sua sessão não pode carregar `AGENTS.md`, [adicione um `CLAUDE.md` ao lado de seu `AGENTS.md` que o importa](#share-one-file-with-other-coding-tools).

634 649

model-config.md +35 −37

Details

47 47

49| :--------------------------------------------------- | :------- | :--------- |49| :--------------------------------------------------- | :------- | :--------- |

54 54

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

60 60

61Onde um alias é resolvido para um modelo mais antigo, modelos mais novos estão disponíveis selecionando o nome completo do modelo explicitamente ou definindo `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.61Onde um alias é resolvido para um modelo mais antigo, modelos mais novos estão disponíveis selecionando o nome completo do modelo explicitamente ou definindo `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.

62 62

63Antes da v2.1.219, `opus` era resolvido para Opus 4.8 na API Anthropic a partir da v2.1.154, e no Claude Platform on AWS, Amazon Bedrock e Agent Platform do Google Cloud a partir da v2.1.207. Antes da v2.1.207, `opus` era resolvido para Opus 4.7 no Claude Platform on AWS e para Opus 4.6 no Amazon Bedrock e Agent Platform do Google Cloud.63Antes da v2.1.280, `opus` era resolvido para Opus 5 na API Anthropic, Claude Platform on AWS, Amazon Bedrock e Agent Platform do Google Cloud a partir da v2.1.219. Antes da v2.1.219, `opus` era resolvido para Opus 4.8 na API Anthropic a partir da v2.1.154, e no Claude Platform on AWS, Amazon Bedrock e Agent Platform do Google Cloud a partir da v2.1.207. Antes da v2.1.207, `opus` era resolvido para Opus 4.7 no Claude Platform on AWS e para Opus 4.6 no Amazon Bedrock e Agent Platform do Google Cloud.

64 64

65Os 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-5`, ou defina a variável de ambiente correspondente como `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Os 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-5-5`, ou defina a variável de ambiente correspondente como `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66

67<Note>67<Note>

~~68 Opus 5 requer Claude Code v2.1.219 ou posterior. Sonnet 5 requer v2.1.197 ou posterior. Opus 4.8 requer v2.1.154 ou posterior. Execute `claude update` para atualizar.~~68 Opus 5.5 requer Claude Code v2.1.280 ou posterior. Opus 5 requer v2.1.219 ou posterior. Sonnet 5 requer v2.1.197 ou posterior. Execute `claude update` para atualizar.

69</Note>69</Note>

70 70

71<h3 id="work-with-fable">71<h3 id="work-with-fable">

94 Fable 5.1 requer Claude Code v2.1.257 ou posterior. Se uma solicitação para ele de uma versão mais antiga falhar, consulte [Claude Code não suporta este modelo](/docs/pt/errors#claude-code-does-not-support-this-model). Execute `claude update` para atualizar. Para disponibilidade sob retenção zero de dados, consulte [Disponibilidade de modelo sob ZDR](/docs/pt/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 requer Claude Code v2.1.257 ou posterior. Se uma solicitação para ele de uma versão mais antiga falhar, consulte [Claude Code não suporta este modelo](/docs/pt/errors#claude-code-does-not-support-this-model). Execute `claude update` para atualizar. Para disponibilidade sob retenção zero de dados, consulte [Disponibilidade de modelo sob ZDR](/docs/pt/zero-data-retention#model-availability-under-zdr).

95</Note>95</Note>

96 96

97Na API Anthropic, o seletor `/model` lista um modelo Fable apenas depois que o servidor relata que está disponível para sua organização. Quando você digita `/model fable` ou um ID de modelo Fable, Claude Code verifica a disponibilidade com o servidor diretamente, então uma seleção digitada pode ter sucesso mesmo quando o seletor não lista a entrada.97Na API Anthropic, um modelo Fable aparece no seletor `/model` a menos que [`availableModels`](#restrict-model-selection) ou [restrições de modelo de organização](#organization-model-restrictions) o excluam. Quando sua organização não consegue usar Fable em absoluto, por exemplo sob [retenção zero de dados](/docs/pt/zero-data-retention#model-availability-under-zdr), a linha permanece no seletor acinzentada, com uma nota sobre o motivo.

98 98

99<h4 id="fable-and-usage-credits">99<h4 id="fable-and-usage-credits">

100 Fable e créditos de uso100 Fable e créditos de uso

138 138

139Digitar `/model <name>` diretamente se comporta como `Enter`. Para mudar apenas para esta sessão, abra o seletor com `/model` e pressione `s` na linha do modelo.139Digitar `/model <name>` diretamente se comporta como `Enter`. Para mudar apenas para esta sessão, abra o seletor com `/model` e pressione `s` na linha do modelo.

140 140

141Se você mudar modelos com `/model`, a mudança também alcança [subagentos que herdam o modelo da conversa principal](/docs/pt/sub-agents#choose-a-model), porque Claude Code resolve seu modelo a partir daquele que sua sessão está usando quando Claude os inicia. Mude para Opus antes de Claude delegar pesquisa ou execuções de teste para um deles, e esse trabalho é executado no Opus também. Para manter um subagentos personalizado em um modelo menor, defina `model` em sua definição.

142

141Se você definir um modelo com `/model` no [modo não interativo](/docs/pt/headless), com a flag `-p`, sua escolha se aplica apenas à sessão atual e não é salva como seu padrão; `/model` nesse modo requer Claude Code v2.1.205 ou posterior. As configurações de projeto e gerenciadas ainda têm precedência e se reaplicam no próximo lançamento. Um [modelo padrão de organização](#organization-default-model) que seu administrador configurou para substituir a seleção do usuário também se reaplica no próximo lançamento.143Se você definir um modelo com `/model` no [modo não interativo](/docs/pt/headless), com a flag `-p`, sua escolha se aplica apenas à sessão atual e não é salva como seu padrão; `/model` nesse modo requer Claude Code v2.1.205 ou posterior. As configurações de projeto e gerenciadas ainda têm precedência e se reaplicam no próximo lançamento. Um [modelo padrão de organização](#organization-default-model) que seu administrador configurou para substituir a seleção do usuário também se reaplica no próximo lançamento.

142 144

143Na v2.1.144 até v2.1.152, `/model` se aplicava apenas à sessão atual e `d` no seletor salvava um padrão.145Na v2.1.144 até v2.1.152, `/model` se aplicava apenas à sessão atual e `d` no seletor salvava um padrão.

443 445

444O comportamento de `default` depende do tipo de sua conta:446O comportamento de `default` depende do tipo de sua conta:

445 447

446* **Max, Team Premium, Enterprise e Anthropic API**: padrão para Opus 5448* **Pro, Max, Team, Enterprise e Anthropic API**: padrão para Opus 5.5

447* **Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform**: padrão para Opus 5449* **Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform**: padrão para Opus 5.5

448* **Pro e Team Standard**: padrão para Sonnet 5

449* **Microsoft Foundry**: padrão para Sonnet 4.5450* **Microsoft Foundry**: padrão para Sonnet 4.5

450 451

451Antes da v2.1.219, `default` era resolvido para Opus 4.8 na Anthropic API, Max, Team Premium e Enterprise com pagamento conforme o uso a partir de v2.1.154, e na Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform a partir de v2.1.207. Antes da v2.1.207, `default` era resolvido para Opus 4.7 na Claude Platform on AWS e para Sonnet 4.5 no Amazon Bedrock e Google Cloud's Agent Platform.452Antes da v2.1.280, `default` era resolvido para Sonnet 5 em Pro e Team Standard, e para Opus 5 em Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform a partir de v2.1.219. Antes da v2.1.219, `default` era resolvido para Opus 4.8 na Anthropic API, Max, Team Premium e Enterprise com pagamento conforme o uso a partir de v2.1.154, e na Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform a partir de v2.1.207. Antes da v2.1.207, `default` era resolvido para Opus 4.7 na Claude Platform on AWS e para Sonnet 4.5 no Amazon Bedrock e Google Cloud's Agent Platform.

452 453

453Quando um administrador definiu um [modelo padrão da organização](#organization-default-model), `default` é resolvido para esse modelo em vez do padrão do tipo de conta acima. Requer Claude Code v2.1.196 ou posterior. `default` também pode ser resolvido para o modelo que você definiu com [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), sob as condições listadas em sua seção.454Quando um administrador definiu um [modelo padrão da organização](#organization-default-model), `default` é resolvido para esse modelo em vez do padrão do tipo de conta acima. Requer Claude Code v2.1.196 ou posterior. `default` também pode ser resolvido para o modelo que você definiu com [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), sob as condições listadas em sua seção.

454 455

512 Fallback automático de modelo513 Fallback automático de modelo

513</h3>514</h3>

514 515

515Esta seção cobre fallback baseado em conteúdo de modelos Fable e Opus 5. Para fallback baseado em disponibilidade quando um modelo está sobrecarregado ou indisponível, consulte [Cadeias de modelo de fallback](#fallback-model-chains).516Esta seção cobre fallback baseado em conteúdo de modelos Fable, Opus 5.5 e Opus 5. Para fallback baseado em disponibilidade quando um modelo está sobrecarregado ou indisponível, consulte [Cadeias de modelo de fallback](#fallback-model-chains).

516 517

517Os modelos Fable e Opus 5 são executados com classificadores de segurança, que na maioria das vezes sinalizam conteúdo de cibersegurança e biologia. Quando um classificador sinaliza uma solicitação e a categoria sinalizada tem um modelo de fallback, Claude Code executa novamente a solicitação nesse modelo e mostra um aviso na transcrição. Para essas duas categorias, o modelo de fallback depende de qual modelo recusou:518Os modelos Fable, Opus 5.5 e Opus 5 são executados com classificadores de segurança, que na maioria das vezes sinalizam conteúdo de cibersegurança e biologia. Quando um classificador sinaliza uma solicitação e a categoria sinalizada tem um modelo de fallback, Claude Code executa novamente a solicitação nesse modelo e mostra um aviso na transcrição. Para essas duas categorias, o modelo de fallback depende de qual modelo recusou:

518 519

519* **Fable 5.1 e Fable 5**: solicitações sinalizadas por biologia são executadas novamente em Opus 5, e solicitações sinalizadas por cibersegurança são executadas novamente em Opus 4.8.520* **Fable 5.1, Fable 5 e Opus 5.5**: solicitações sinalizadas por biologia são executadas novamente em Opus 5, e solicitações sinalizadas por cibersegurança são executadas novamente em Opus 4.8.

520* **Opus 5**: solicitações sinalizadas por cibersegurança são executadas novamente em Opus 4.8. Solicitações sinalizadas por biologia terminam com uma recusa, porque Opus 5 executa seus próprios classificadores de biologia sem modelo de fallback.521* **Opus 5**: solicitações sinalizadas por cibersegurança são executadas novamente em Opus 4.8. Solicitações sinalizadas por biologia terminam com uma recusa, porque Opus 5 executa seus próprios classificadores de biologia sem modelo de fallback.

521 522

522No Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code resolve esses destinos através de sua implantação, e se você definir `ANTHROPIC_DEFAULT_OPUS_MODEL`, categorias que têm um fallback são executadas novamente no modelo fixado; consulte [Ativar fallback no Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).523No Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code resolve esses destinos através de sua implantação, e se você definir `ANTHROPIC_DEFAULT_OPUS_MODEL`, categorias que têm um fallback são executadas novamente no modelo fixado; consulte [Ativar fallback no Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

545 546

546* Quando a categoria sinalizada não tem modelo de fallback, como um sinalizador de biologia em Opus 5, Claude Code não mostra o prompt e a solicitação termina com a recusa.547* Quando a categoria sinalizada não tem modelo de fallback, como um sinalizador de biologia em Opus 5, Claude Code não mostra o prompt e a solicitação termina com a recusa.

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

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

549* 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 termina o turno com uma recusa.550* 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 termina o turno com uma recusa.

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

551 552

555 556

556No [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:557No [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:

557 558

558* Claude Code deve reconhecer o modelo atual como uma fonte de fallback. Fable 5.1 e Fable 5 são reconhecidos quando 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). Opus 5 é reconhecido por seu ID de modelo do provedor ou um mapeamento [`modelOverrides`](#override-model-ids-per-version).559* Claude Code deve reconhecer o modelo atual como uma fonte de fallback. Fable 5.1 e Fable 5 são reconhecidos quando 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). Opus 5.5 e Opus 5 são reconhecidos por seu ID de modelo do provedor ou um mapeamento [`modelOverrides`](#override-model-ids-per-version).

559* O modelo de fallback deve ser resolvido em sua implantação. Se você definir `ANTHROPIC_DEFAULT_OPUS_MODEL`, solicitações sinalizadas são executadas novamente nesse modelo para cada categoria que tem um fallback; um sinalizador de biologia em Opus 5 ainda termina com uma recusa. Se você não o definir, solicitações sinalizadas por cibersegurança são executadas novamente em uma entrada Opus 4.8 na lista de modelos do provedor, e solicitações sinalizadas por biologia de um modelo Fable em uma entrada Opus 5.560* O modelo de fallback deve ser resolvido em sua implantação. Se você definir `ANTHROPIC_DEFAULT_OPUS_MODEL`, solicitações sinalizadas são executadas novamente nesse modelo para cada categoria que tem um fallback; um sinalizador de biologia em Opus 5 ainda termina com uma recusa. Se você não o definir, solicitações sinalizadas por cibersegurança são executadas novamente em uma entrada Opus 4.8 na lista de modelos do provedor, e solicitações sinalizadas por biologia de um modelo Fable ou Opus 5.5 em uma entrada Opus 5.

560 561

561Se nenhum dos modelos puder ser identificado, Claude Code não alterna automaticamente. A solicitação sinalizada termina com uma mensagem de recusa, e você pode alternar modelos com [`/model`](#setting-your-model) e tentar novamente. Definir `ANTHROPIC_DEFAULT_FABLE_MODEL` para seu ID de modelo Fable ativa o reconhecimento de Fable. Definir `ANTHROPIC_DEFAULT_OPUS_MODEL` para um ID de modelo Opus fornece às categorias sinalizadas um destino de fallback, a menos que o pino nomeie um modelo fora da família Opus ou o modelo que recusou; então Claude Code não alterna e a recusa permanece.562Se nenhum dos modelos puder ser identificado, Claude Code não alterna automaticamente. A solicitação sinalizada termina com uma mensagem de recusa, e você pode alternar modelos com [`/model`](#setting-your-model) e tentar novamente. Definir `ANTHROPIC_DEFAULT_FABLE_MODEL` para seu ID de modelo Fable ativa o reconhecimento de Fable. Definir `ANTHROPIC_DEFAULT_OPUS_MODEL` para um ID de modelo Opus fornece às categorias sinalizadas um destino de fallback, a menos que o pino nomeie um modelo fora da família Opus ou o modelo que recusou; então Claude Code não alterna e a recusa permanece.

562 563

564 Pesquisa de segurança e cargas de trabalho de biologia565 Pesquisa de segurança e cargas de trabalho de biologia

565</h4>566</h4>

566 567

567Cargas de trabalho em segurança ofensiva ou biologia, incluindo testes de penetração, exercícios Capture the Flag (CTF) e bases de código adjacentes à biologia, acionam fallback frequentemente, geralmente na primeira solicitação. Para trabalho substantivo de biologia em Fable 5.1 ou Fable 5, Claude Code move a sessão para Opus 5 na primeira solicitação sinalizada, e solicitações posteriores sinalizadas por biologia terminam em recusas lá, porque Opus 5 não tem fallback de biologia. Em Opus 5, você recebe essas recusas da primeira solicitação sinalizada.568Cargas de trabalho em segurança ofensiva ou biologia, incluindo testes de penetração, exercícios Capture the Flag (CTF) e bases de código adjacentes à biologia, acionam fallback frequentemente, geralmente na primeira solicitação. Para trabalho substantivo de biologia em Fable 5.1, Fable 5 ou Opus 5.5, Claude Code move a sessão para Opus 5 na primeira solicitação sinalizada, e solicitações posteriores sinalizadas por biologia terminam em recusas lá, porque Opus 5 não tem fallback de biologia. Em Opus 5, você recebe essas recusas da primeira solicitação sinalizada.

568 569

569Este é o roteamento esperado para esses domínios, não um sinalizador de conta. Se sua organização precisar de capacidade de classe Fable para este trabalho, peça ao seu time de contas da Anthropic sobre programas de acesso confiável.570Este é o roteamento esperado para esses domínios, não um sinalizador de conta. Se sua organização precisar de capacidade de classe Fable para este trabalho, peça ao seu time de contas da Anthropic sobre programas de acesso confiável.

570 571

577Os níveis de esforço disponíveis dependem do modelo. Modelos não listados aqui não suportam esforço:578Os níveis de esforço disponíveis dependem do modelo. Modelos não listados aqui não suportam esforço:

578 579

579| Modelo | Níveis |580| Modelo | Níveis |

580| :------------------------------------ | :-------------------------------------- |581| :---------------------------------------------- | :-------------------------------------- |

584 585

585Se você definir um nível que o modelo ativo não suporta, Claude Code volta para o nível mais alto suportado no ou abaixo do que você definiu. Por exemplo, `xhigh` é executado como `high` em Opus 4.6. Sua organização ou suas próprias configurações também podem limitar os níveis que um modelo oferece; consulte [Limites de esforço da organização](#organization-effort-limits).586Se você definir um nível que o modelo ativo não suporta, Claude Code volta para o nível mais alto suportado no ou abaixo do que você definiu. Por exemplo, `xhigh` é executado como `high` em Opus 4.6. Sua organização ou suas próprias configurações também podem limitar os níveis que um modelo oferece; consulte [Limites de esforço da organização](#organization-effort-limits).

587Com a configuração [`ultracode`](/docs/pt/settings-reference#ultracode) desativada, Claude Code resolve o nível de esforço da sessão nesta ordem, tomando o primeiro que se aplica:588Com a configuração [`ultracode`](/docs/pt/settings-reference#ultracode) desativada, Claude Code resolve o nível de esforço da sessão nesta ordem, tomando o primeiro que se aplica:

588 589

5891. Uma escolha explícita: a variável de ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/pt/env-vars#variables), lançamento com `--effort`, ou `/effort` na sessão ([um `/effort` não interativo tem efeito mais estreito](#non-interactive-effort))5901. Uma escolha explícita: a variável de ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/pt/env-vars#variables), lançamento com `--effort`, ou `/effort` na sessão ([um `/effort` não interativo tem efeito mais estreito](#non-interactive-effort))

5902. O esforço padrão do modelo, em Fable 5, Opus 4.8 ou Opus 4.7: a partir da primeira vez que você executa um desses modelos, Claude Code mantém o esforço padrão desse modelo entre sessões, mesmo quando suas configurações resolvem um nível diferente. Opus 5 e Fable 5.1 não têm tal retenção. Se um nível que você define termina a retenção depende de como você o define, por exemplo:5912. Suas configurações: o nível que você salvou para o modelo ou uma chave [`effortLevel`](/docs/pt/settings-reference#effortlevel), com a precedência entre eles e entre arquivos de configurações declarada em [`modelSettings`](/docs/pt/settings-reference#modelsettings)

591 * **Termina a retenção**: confirmando um nível interativamente, com `Enter` no controle deslizante `/effort` ou no seletor `/model` ou com um nível digitado após `/effort`, ou escolhendo um nível de um controle de esforço [Remote Control](/docs/pt/remote-control#what-connected-devices-see) de um dispositivo conectado5923. O esforço padrão do modelo: `high` em cada modelo que suporta esforço, exceto que Opus 5.5 padrão para `medium`, Opus 4.7 padrão para `xhigh` e, quando sua organização define um nível de esforço padrão para seu [modelo padrão da organização](#organization-default-model), esse nível é o padrão quando você executa esse modelo

592 * **Deixa a retenção em vigor para sessões posteriores**: `--effort` no lançamento, ou `s` no controle deslizante `/effort` ou no seletor `/model`593

5933. Suas configurações: o nível que você salvou para o modelo ou uma chave [`effortLevel`](/docs/pt/settings-reference#effortlevel), com a precedência entre eles e entre arquivos de configurações declarada em [`modelSettings`](/docs/pt/settings-reference#modelsettings)594Opus 5.5 começa em `medium` a menos que uma das fontes acima defina um nível para ele, e um `effortLevel` de nível superior em seu arquivo de configurações de usuário não conta para Opus 5.5. Essa chave é a forma mais antiga que `/effort` escreveu antes de Claude Code salvar níveis por modelo: continua se aplicando onde se aplicava antes, em Opus 5, Fable 5.1 e modelos anteriores, enquanto Opus 5.5 e modelos lançados após ele começam em seu próprio padrão até você escolher um nível para eles com `/effort` ou o seletor `/model`. Um `effortLevel` de nível superior em configurações de projeto, local ou gerenciadas, ou um passado com `--settings`, se aplica a cada modelo.

5944. O esforço padrão do modelo: `high` em cada modelo que suporta esforço, exceto que Opus 4.7 padrão para `xhigh` e, quando sua organização define um nível de esforço padrão para seu [modelo padrão da organização](#organization-default-model), esse nível é o padrão quando você executa esse modelo

595 595

596Quando você define `low`, `medium`, `high` ou `xhigh` em uma sessão interativa em sua máquina, você escolhe quanto tempo dura confirmando-o:596Quando você define `low`, `medium`, `high` ou `xhigh` em uma sessão interativa em sua máquina, você escolhe quanto tempo dura confirmando-o:

597 597

608 608

609<span id="non-interactive-effort" />609<span id="non-interactive-effort" />

610 610

611Quando você define um nível com `/effort` em uma execução [`-p`](/docs/pt/headless), Claude Code o aplica apenas a essa sessão e não o salva como seu padrão. Em Fable 5, Opus 4.8 e Opus 4.7, esse nível também não termina a retenção no esforço padrão do modelo nem o substitui pela sessão. Enquanto essa retenção está em vigor, um `/effort` não interativo relata `Not applied`, portanto passe `--effort` no lançamento.611Quando você define um nível com `/effort` em uma execução [`-p`](/docs/pt/headless), Claude Code o aplica apenas a essa sessão e não o salva como seu padrão.

612 612

613O 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 substantivas. Para onde pode ser definido persistentemente, consulte a configuração [`ultracode`](/docs/pt/settings-reference#ultracode).613O 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 substantivas. Para onde pode ser definido persistentemente, consulte a configuração [`ultracode`](/docs/pt/settings-reference#ultracode).

614 614

642| Nível | Quando usá-lo |642| Nível | Quando usá-lo |

643| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |643| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |

644| `low` | Reserve para tarefas curtas, escopo definido, sensíveis à latência que não são sensíveis à inteligência |644| `low` | Reserve para tarefas curtas, escopo definido, sensíveis à latência que não são sensíveis à inteligência |

648| `max` | Pode melhorar o desempenho em tarefas exigentes, mas pode mostrar retornos decrescentes e é propenso a excesso de pensamento. Teste antes de adotar amplamente |648| `max` | Pode melhorar o desempenho em tarefas exigentes, mas pode mostrar retornos decrescentes e é propenso a excesso de pensamento. Teste antes de adotar amplamente |

649| `ultracode` | Uma configuração de Claude Code que planeja um [fluxo de trabalho dinâmico](/docs/pt/workflows) para cada tarefa substantiva com raciocínio `xhigh` por mensagem |649| `ultracode` | Uma configuração de Claude Code que planeja um [fluxo de trabalho dinâmico](/docs/pt/workflows) para cada tarefa substantiva com raciocínio `xhigh` por mensagem |

667* **Sinalizador `--effort`**: passe um nome de nível para defini-lo para uma única sessão ao lançar Claude Code667* **Sinalizador `--effort`**: passe um nome de nível para defini-lo para uma única sessão ao lançar Claude Code

668* **Variável de ambiente**: defina `CLAUDE_CODE_EFFORT_LEVEL` para um nome de nível ou `auto`668* **Variável de ambiente**: defina `CLAUDE_CODE_EFFORT_LEVEL` para um nome de nível ou `auto`

669* **Configurações**: defina um nível por modelo em [`modelSettings`](/docs/pt/settings-reference#modelsettings), ou defina [`effortLevel`](/docs/pt/settings-reference#effortlevel) para `low`, `medium`, `high` ou `xhigh` como o padrão para modelos sem um. `max` não é aceito como um nível em nenhuma chave, e `ultracode` tem sua própria chave [`ultracode`](/docs/pt/settings-reference#ultracode)669* **Configurações**: defina um nível por modelo em [`modelSettings`](/docs/pt/settings-reference#modelsettings), ou defina [`effortLevel`](/docs/pt/settings-reference#effortlevel) para `low`, `medium`, `high` ou `xhigh` como o padrão para modelos sem um. `max` não é aceito como um nível em nenhuma chave, e `ultracode` tem sua própria chave [`ultracode`](/docs/pt/settings-reference#ultracode)

670* **De um dispositivo conectado**: em uma sessão [Remote Control](/docs/pt/remote-control#what-connected-devices-see), escolha um nível no controle de esforço em seu telefone ou em seu navegador. O nível se aplica apenas à sessão atual, embora também termine a [retenção no esforço padrão do modelo](#adjust-effort-level). Requer Claude Code v2.1.234 ou posterior670* **De um dispositivo conectado**: em uma sessão [Remote Control](/docs/pt/remote-control#what-connected-devices-see), escolha um nível no controle de esforço em seu telefone ou em seu navegador. O nível se aplica apenas à sessão atual. Requer Claude Code v2.1.234 ou posterior

671* **Frontmatter de skill e subagente**: defina `effort` em um arquivo markdown [skill](/docs/pt/skills#frontmatter-reference) ou [subagente](/docs/pt/sub-agents#supported-frontmatter-fields) para substituir o nível de esforço quando esse skill ou subagente é executado671* **Frontmatter de skill e subagente**: defina `effort` em um arquivo markdown [skill](/docs/pt/skills#frontmatter-reference) ou [subagente](/docs/pt/sub-agents#supported-frontmatter-fields) para substituir o nível de esforço quando esse skill ou subagente é executado

672 672

673O esforço de frontmatter se aplica quando esse skill ou subagente está ativo, substituindo o nível de sessão, mas não a variável de ambiente. Um [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) ou [limite de esforço da organização](#organization-effort-limits) ainda limita o nível em que o skill ou subagente é executado.673O esforço de frontmatter se aplica quando esse skill ou subagente está ativo, substituindo o nível de sessão, mas não a variável de ambiente. Um [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) ou [limite de esforço da organização](#organization-effort-limits) ainda limita o nível em que o skill ou subagente é executado.

674 674

675Em Fable 5, Opus 4.8 e Opus 4.7, o esforço de frontmatter também se aplica enquanto a [retenção no esforço padrão do modelo](#adjust-effort-level) está em vigor. Antes da v2.1.267, a retenção tinha precedência e Claude Code ignorava o nível de frontmatter enquanto a retenção estava ativa.

~~676~~

677Se você definir `effortLevel` em [configurações gerenciadas](/docs/pt/managed-settings), Claude Code o aplica na etapa de configurações da [ordem de resolução de esforço](#adjust-effort-level), e os usuários ainda podem alterar o nível com `/effort` ou `--effort`. Para manter os usuários em ou abaixo de um nível, defina [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel).675Se você definir `effortLevel` em [configurações gerenciadas](/docs/pt/managed-settings), Claude Code o aplica na etapa de configurações da [ordem de resolução de esforço](#adjust-effort-level), e os usuários ainda podem alterar o nível com `/effort` ou `--effort`. Para manter os usuários em ou abaixo de um nível, defina [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel).

678 676

679O controle deslizante de esforço aparece em `/model` quando um modelo suportado é selecionado. O nível de esforço atual também é mostrado no cabeçalho da sessão ao lado do nome do modelo, por exemplo "with low effort", para que você possa confirmar qual configuração está ativa sem abrir `/model`. O rodapé também mostra brevemente o nível de esforço na inicialização e quando muda.677O controle deslizante de esforço aparece em `/model` quando um modelo suportado é selecionado. O nível de esforço atual também é mostrado no cabeçalho da sessão ao lado do nome do modelo, por exemplo "with low effort", para que você possa confirmar qual configuração está ativa sem abrir `/model`. O rodapé também mostra brevemente o nível de esforço na inicialização e quando muda.

695Pensamento estendido é o raciocínio que Claude emite antes de responder. Em modelos que suportam [raciocínio adaptativo](#adjust-effort-level), o nível de esforço é o controle primário para quanto pensamento acontece; as configurações abaixo ativam ou desativam o pensamento e controlam como ele é exibido. Com o pensamento desativado na Anthropic API, Claude Code envia esforço `high` em vez de um nível mais alto para modelos que sabe [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5.693Pensamento estendido é o raciocínio que Claude emite antes de responder. Em modelos que suportam [raciocínio adaptativo](#adjust-effort-level), o nível de esforço é o controle primário para quanto pensamento acontece; as configurações abaixo ativam ou desativam o pensamento e controlam como ele é exibido. Com o pensamento desativado na Anthropic API, Claude Code envia esforço `high` em vez de um nível mais alto para modelos que sabe [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5.

696 694

697| Controle | Como defini-lo |695| Controle | Como defini-lo |

698| :-------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |696| :-------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

702 700

703Você não pode desativar o pensamento em modelos Fable. O alternador de sessão, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` não têm efeito lá, e um modelo Fable decide por etapa quanto pensar com base no nível de esforço.701Você não pode desativar o pensamento em Opus 5.5 ou nos modelos Fable. O alternador de sessão, `alwaysThinkingEnabled` e `MAX_THINKING_TOKENS=0` não têm efeito lá, e o modelo decide por etapa quanto pensar com base no nível de esforço.

704 702

705Claude Code recolhe a saída de pensamento por padrão. Pressione `Ctrl+O` para alternar o modo detalhado e ver o raciocínio como texto itálico cinzento. Sessões interativas na Anthropic API recebem blocos de pensamento redigidos por padrão, portanto defina `showThinkingSummaries: true` em [configurações](/docs/pt/settings) se quiser os resumos completos disponíveis quando expandir. Você é cobrado por todos os tokens de pensamento gerados, mesmo quando recolhidos ou redigidos.703Claude Code recolhe a saída de pensamento por padrão. Pressione `Ctrl+O` para alternar o modo detalhado e ver o raciocínio como texto itálico cinzento. Sessões interativas na Anthropic API recebem blocos de pensamento redigidos por padrão, portanto defina `showThinkingSummaries: true` em [configurações](/docs/pt/settings) se quiser os resumos completos disponíveis quando expandir. Você é cobrado por todos os tokens de pensamento gerados, mesmo quando recolhidos ou redigidos.

706 704

786Se você não definir uma janela de auto-compactação, Claude Code compacta quando a conversa atinge o limite de contexto do modelo, exceto nestas sessões:784Se você não definir uma janela de auto-compactação, Claude Code compacta quando a conversa atinge o limite de contexto do modelo, exceto nestas sessões:

787 785

788* [Sessões em nuvem](/docs/pt/claude-code-on-the-web) compactam conforme a conversa se aproxima do limite do modelo786* [Sessões em nuvem](/docs/pt/claude-code-on-the-web) compactam conforme a conversa se aproxima do limite do modelo

789* Sonnet 4.6 e Opus 4.6 sem [contexto estendido](#extended-context) compactam no limite de 200K, e assim fazem Opus 4.8 e Opus 5 quando executam com uma janela de contexto de 200K, como no Amazon Bedrock, na Plataforma de Agentes do Google Cloud e no Microsoft Foundry787* Sonnet 4.6 e Opus 4.6 sem [contexto estendido](#extended-context) compactam no limite de 200K, e assim fazem Opus 4.8 e posteriores quando executam com uma janela de contexto de 200K, como no Amazon Bedrock, na Plataforma de Agentes do Google Cloud e no Microsoft Foundry

790* Quando você define [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/pt/env-vars), modelos com uma janela nativa de 1M, como Sonnet 5 e os modelos Fable, compactam no limite de 200K788* Quando você define [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/pt/env-vars), modelos com uma janela nativa de 1M, como Sonnet 5 e os modelos Fable, compactam no limite de 200K

791* Modelos executando com uma janela nativa de 1M, como Sonnet 5, os modelos Fable e Opus 4.7 e posteriores na API Anthropic, compactam antes da janela se encher, em aproximadamente 967K tokens por padrão. No Amazon Bedrock, na Plataforma de Agentes do Google Cloud e no Microsoft Foundry, [Fixar modelos para implantações de terceiros](#pin-models-for-third-party-deployments) diz quais modelos executam com essa janela; para as configurações que orçam Sonnet 5 em 200K em vez disso, consulte [Janela de contexto Sonnet 5](#sonnet-5-context-window)789* Modelos executando com uma janela nativa de 1M, como Sonnet 5, os modelos Fable e Opus 4.7 e posteriores na API Anthropic, compactam antes da janela se encher, em aproximadamente 967K tokens por padrão. No Amazon Bedrock, na Plataforma de Agentes do Google Cloud e no Microsoft Foundry, [Fixar modelos para implantações de terceiros](#pin-models-for-third-party-deployments) diz quais modelos executam com essa janela; para as configurações que orçam Sonnet 5 em 200K em vez disso, consulte [Janela de contexto Sonnet 5](#sonnet-5-context-window)

792* Sessões em um ID de modelo que Claude Code não reconhece, como um alias de [gateway LLM](/docs/pt/llm-gateway), compactam na janela de contexto que Claude Code assume para o ID; consulte [Corrigir a janela para um gateway ou ID de modelo personalizado](#correct-the-window-for-a-gateway-or-custom-model-id)790* Sessões em um ID de modelo que Claude Code não reconhece, como um alias de [gateway LLM](/docs/pt/llm-gateway), compactam na janela de contexto que Claude Code assume para o ID; consulte [Corrigir a janela para um gateway ou ID de modelo personalizado](#correct-the-window-for-a-gateway-or-custom-model-id)

831Este exemplo define todas as três variáveis para tornar uma implantação Opus roteada por gateway selecionável. Claude Code lê variáveis de ambiente na inicialização, portanto execute as exportações antes de iniciar `claude`, ou reinicie uma sessão existente para aplicá-las:829Este exemplo define todas as três variáveis para tornar uma implantação Opus roteada por gateway selecionável. Claude Code lê variáveis de ambiente na inicialização, portanto execute as exportações antes de iniciar `claude`, ou reinicie uma sessão existente para aplicá-las:

832 830

833```bash theme={null}831```bash theme={null}

834export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"832export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5-5"

835export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"833export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"

836export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"834export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

837```835```

847 845

848Quando [`availableModels`](#restrict-model-selection) está definido, inclua o ID do modelo personalizado na lista de permissões também. Caso contrário, Claude Code filtra a entrada personalizada do seletor e rejeita uma seleção `--model` dela como qualquer outro modelo excluído.846Quando [`availableModels`](#restrict-model-selection) está definido, inclua o ID do modelo personalizado na lista de permissões também. Caso contrário, Claude Code filtra a entrada personalizada do seletor e rejeita uma seleção `--model` dela como qualquer outro modelo excluído.

849 847

850Um ID personalizado que incorpora um nome de família, como `my-gateway/claude-opus-5`, conta como uma entrada específica para essa família e desabilita seu curinga, portanto também liste as versões que você pretende manter selecionáveis. Consulte [Comportamento de mesclagem](#merge-behavior).848Um ID personalizado que incorpora um nome de família, como `my-gateway/claude-opus-5-5`, conta como uma entrada específica para essa família e desabilita seu curinga, portanto também liste as versões que você pretende manter selecionáveis. Consulte [Comportamento de mesclagem](#merge-behavior).

851 849

852<h2 id="environment-variables">850<h2 id="environment-variables">

853 Variáveis de ambiente851 Variáveis de ambiente

monitoring-usage.md +275 −214

Details

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

124| `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, nomes de workflow criados pelo usuário e entrada de ferramenta. Também ativa nomes de comando customizado, plugin e MCP em eventos `user_prompt` (padrão: desativado). Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, `mcp_server_name`/`mcp_tool_name` são emitidos em `tool_decision`/`tool_result` mesmo com o sinalizador desativado. A exceção requer Claude Code v2.1.214 ou posterior | `1` para ativar |124| `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, nomes de workflow criados pelo usuário e entrada de ferramenta. Também ativa nomes de comando customizado, plugin e MCP em eventos `user_prompt` (padrão: desativado). Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, `mcp_server_name`/`mcp_tool_name` são emitidos em `tool_decision`/`tool_result` mesmo com o sinalizador desativado. A exceção requer Claude Code v2.1.214 ou posterior | `1` para ativar |

125| `OTEL_LOG_TOOL_CONTENT` | Ativar registro de conteúdo de ferramenta no [evento de span `tool.output`](#tool-output-span-event) (padrão: desativado). Os atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](#new-context-gates). Requer [rastreamento](#traces-beta). O conteúdo é truncado no limite de conteúdo (60 KB por padrão) | `1` para ativar |125| `OTEL_LOG_TOOL_CONTENT` | Ativar registro de conteúdo de ferramenta no [evento de span `tool.output`](#tool-output-span-event) (padrão: desativado). Os atributos de span carregam conteúdo de ferramenta sob [seus próprios gates](#new-context-gates). Requer [rastreamento](#traces-beta). O conteúdo é truncado no limite de conteúdo (60 KB por padrão) | `1` para ativar |

126| `OTEL_LOG_MANAGED_SETTINGS` | Adicionar as configurações gerenciadas reduzidas e um resumo SHA-256 das configurações antes da redução aos eventos [managed settings resolved](#managed-settings-resolved-event) (padrão: desativado). Um valor em configurações de projeto ou local não o ativa. Requer Claude Code v2.1.274 ou posterior | `1` para ativar |

126| `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 no limite de conteúdo (60 KB por padrão), ou `file:<dir>` para corpos não truncados em disco com um ponteiro `body_ref` no evento |127| `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 no limite de conteúdo (60 KB por padrão), ou `file:<dir>` para corpos não truncados em disco com um ponteiro `body_ref` no evento |

127| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite de conteúdo: o comprimento máximo de atributos que contêm conteúdo, como respostas de modelo, conteúdo de ferramenta, prompts do sistema e corpos de API brutos, marcador de truncamento incluído, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). O padrão é dimensionado para backends que limitam valores de atributo a 64 KB; aumente-o apenas se seu backend aceitar valores maiores, ou diminua-o para reduzir o volume de telemetria. Quando um limite de atributo do SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou uma de suas variantes de logrecord e span, é definido como menor, Claude Code trunca nesse valor menor para que o marcador `[TRUNCATED ...]` permaneça dentro do limite do SDK. Requer Claude Code v2.1.214 ou posterior | `262144` |128| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Limite de conteúdo: o comprimento máximo de atributos que contêm conteúdo, como respostas de modelo, conteúdo de ferramenta, prompts do sistema e corpos de API brutos, marcador de truncamento incluído, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). O padrão é dimensionado para backends que limitam valores de atributo a 64 KB; aumente-o apenas se seu backend aceitar valores maiores, ou diminua-o para reduzir o volume de telemetria. Quando um limite de atributo do SDK OpenTelemetry, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` ou uma de suas variantes de logrecord e span, é definido como menor, Claude Code trunca nesse valor menor para que o marcador `[TRUNCATED ...]` permaneça dentro do limite do SDK. Requer Claude Code v2.1.214 ou posterior | `262144` |

128| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferência de temporalidade de métricas (padrão: `delta`). Defina como `cumulative` se seu backend espera temporalidade cumulativa | `delta`, `cumulative` |129| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Preferência de temporalidade de métricas (padrão: `delta`). Defina como `cumulative` se seu backend espera temporalidade cumulativa | `delta`, `cumulative` |

241| `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 | |242| `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 | |

242| `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` |243| `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` |

245| `effort` | [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação: `low`, `medium`, `high`, `xhigh` ou `max`. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço. Requer Claude Code v2.1.274 ou posterior | |

385echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"387echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

386```388```

387 389

388Se o auxiliar falhar ou imprimir saída que não atenda a esses requisitos, Claude Code relata o erro em:390Se o auxiliar falhar ou imprimir saída que não atenda a esses requisitos, as exportações falham e seu backend de telemetria não recebe nada da sessão até que o auxiliar funcione novamente. Claude Code relata a falha em:

389 391

392* Uma notificação de aviso em sessões interativas, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/pt/errors#otelheadershelper-failed), mostrada uma vez por sessão quando o auxiliar falha pela primeira vez

390* Saída de `/status`393* Saída de `/status`

391* O log de depuração, ao executar com [`--debug`](/docs/pt/cli-reference#cli-flags) ou após executar `/debug` na sessão394* O log de depuração, ao executar com [`--debug`](/docs/pt/cli-reference#cli-flags) ou após executar `/debug` na sessão

392* stderr, em sessões não-interativas iniciadas com `-p`395* stderr, em sessões não-interativas iniciadas com `-p`

521 Atributos padrão524 Atributos padrão

522</h3>525</h3>

523 526

524Todas as métricas e eventos compartilham esses atributos padrão:527Todas as métricas e eventos compartilham estes atributos padrão:

525 528

527| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |530| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |

533| `user.account_id` | ID da conta em formato marcado correspondendo às APIs de administrador Anthropic (quando autenticado), como `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (padrão: true) |536| `user.account_id` | ID da conta em formato marcado correspondendo às APIs de administração da Anthropic (quando autenticado), como `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (padrão: true) |

534| `user.id` | Identificador anônimo aleatório gerado na primeira execução e persistido em `~/.claude.json`. Não contém informações pessoais e não é derivado da sua conta Claude. Deletar o arquivo produz um novo valor não relacionado na próxima execução. | Sempre incluído |537| `user.id` | Identificador anônimo aleatório gerado na primeira execução e persistido em `~/.claude.json`. Não contém informações pessoais e não é derivado da sua conta Claude. Deletar o arquivo produz um novo valor não relacionado na próxima execução. | Sempre incluído |

535| `user.email` | Endereço de email do usuário, do seu login ou, em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), das credenciais da própria sessão | Sempre incluído quando disponível |538| `user.email` | Endereço de email do usuário, do seu login ou, em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web), das credenciais da própria sessão | Sempre incluído quando disponível |

537| 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) |540| 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) |

538| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | A identidade do repositório da sessão, derivada do seu remote `origin`. Veja [Atributos de repositório](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (padrão: false). Requer Claude Code v2.1.269 ou posterior |541| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | A identidade do repositório da sessão, derivada do seu remote `origin`. Veja [Atributos de repositório](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (padrão: false). Requer Claude Code v2.1.269 ou posterior |

539 542

540Quando 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.543Quando 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írgulas. 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.

541 544

542Os eventos incluem adicionalmente os seguintes atributos. Estes nunca são anexados a métricas porque causariam cardinalidade ilimitada:545Os eventos incluem adicionalmente os seguintes atributos. Estes nunca são anexados a métricas porque causariam cardinalidade ilimitada:

543 546

544* `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).547* `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 eventos](#event-correlation-attributes).

545* `workspace.host_paths`: diretórios de workspace do host selecionados no aplicativo desktop, como um array de string548* `workspace.host_paths`: diretórios do workspace do host selecionados no aplicativo desktop, como um array de strings

546* `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 posterior549* `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). Filtrar eventos por um `workflow.run_id` reconstrói as requisiçõ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 skills. 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

547* `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 posterior550* `workflow.name`: nome do workflow, o `meta.name` do seu script, emitido junto com `workflow.run_id`. Os nomes de workflow integrados aparecem literalmente quando a execução executa o script integrado não modificado. Nomes de autoria do 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

548 551

549<h4 id="repository-attributes">552<h4 id="repository-attributes">

550 Atributos de repositório553 Atributos de repositório

552 555

553Defina `OTEL_METRICS_INCLUDE_REPOSITORY=true` para marcar métricas e eventos com a identidade do repositório da sessão, para que um coletor compartilhado possa atribuir uso por repositório. Requer Claude Code v2.1.269 ou posterior.556Defina `OTEL_METRICS_INCLUDE_REPOSITORY=true` para marcar métricas e eventos com a identidade do repositório da sessão, para que um coletor compartilhado possa atribuir uso por repositório. Requer Claude Code v2.1.269 ou posterior.

554 557

555Claude Code deriva esses atributos uma vez por sessão a partir do remote `origin` do repositório. Os remotes HTTPS e SSH de um repositório produzem valores idênticos:558Claude Code deriva esses atributos uma vez por sessão do remote `origin` do repositório. Os remotes HTTPS e SSH de um repositório produzem valores idênticos:

556 559

557| Atributo | Valor |560| Atributo | Valor |

558| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |561| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |

559| `vcs.repository.url.full` | A URL do navegador do repositório sem `.git`, como `https://github.com/example-org/example-repo` |562| `vcs.repository.url.full` | A URL do navegador do repositório sem `.git`, como `https://github.com/example-org/example-repo` |

560| `vcs.owner.name` | O caminho do proprietário ou grupo, como `example-org`; omitido quando o caminho remoto tem um único segmento |563| `vcs.owner.name` | O caminho do proprietário ou grupo, como `example-org`; omitido quando o caminho remoto tem um único segmento |

562| `vcs.provider.name` | `github`, `gitlab`, `bitbucket` ou `gitea` quando Claude Code reconhece o host remoto ou forma de URL como um desses provedores; omitido caso contrário |565| `vcs.provider.name` | `github`, `gitlab`, `bitbucket`, ou `gitea` quando Claude Code reconhece o host remoto ou a forma da URL como um desses provedores; omitido caso contrário |

563 566

564Os valores são minúsculos, e credenciais, strings de consulta e fragmentos do URL remoto nunca aparecem neles. Os atributos são omitidos quando a sessão não tem um remote `origin`, quando o remote não é em forma de URL ou quando o único repositório envolvente é seu diretório home.567Os valores são convertidos para minúsculas, e credenciais, strings de consulta e fragmentos da URL remota nunca aparecem neles. Os atributos são omitidos quando a sessão não tem um remote `origin`, quando o remote não é em forma de URL, ou quando o único repositório envolvente é seu diretório home.

565 568

566Uma chave `vcs.*` que você declara em [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) substitui o valor derivado para essa chave. Se você declarar `vcs.repository.url.full`, Claude Code nunca lê o remote e relata apenas as chaves que você declara.569Uma chave `vcs.*` que você declara em [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) substitui o valor derivado para essa chave. Se você declarar `vcs.repository.url.full`, Claude Code nunca lê o remote e relata apenas as chaves que você declara.

567 570

568Os atributos fluem apenas para seus próprios exportadores; a telemetria Anthropic descarta cada chave `vcs.*`.571Os atributos fluem apenas para seus próprios exportadores; a telemetria da Anthropic descarta todas as chaves `vcs.*`.

569 572

570<h3 id="metrics">573<h3 id="metrics">

571 Métricas574 Métricas

575 578

577| ------------------------------------- | ------------------------------------------------------------------- | ------- |580| ------------------------------------- | ------------------------------------------------------------------- | ------- |

582| `claude_code.cost.usage` | Custo da sessão Claude Code | USD |585| `claude_code.cost.usage` | Custo da sessão Claude Code | USD |

585| `claude_code.active_time.total` | Tempo ativo total | s |588| `claude_code.active_time.total` | Tempo ativo total | s |

586 589

587Quando `prometheus` é o único exportador listado em `OTEL_METRICS_EXPORTER`, Claude Code omite as unidades `USD`, `tokens` e `s` das métricas exportadas para que o scrape permaneça em formato de texto Prometheus válido. Os nomes das métricas não mudam, e configurações que combinam exportadores, como `otlp,prometheus`, mantêm as unidades. Antes da v2.1.216, o scrape Prometheus incluía linhas `# UNIT` apenas de OpenMetrics que alguns scrapers rejeitavam.590Quando `prometheus` é o único exportador listado em `OTEL_METRICS_EXPORTER`, Claude Code omite as unidades `USD`, `tokens`, e `s` das métricas exportadas para que o scrape permaneça em formato de texto Prometheus válido. Os nomes das métricas não mudam, e configurações que combinam exportadores, como `otlp,prometheus`, mantêm as unidades. Antes da v2.1.216, o scrape do Prometheus incluía linhas `# UNIT` apenas do OpenMetrics que alguns scrapers rejeitavam.

588 591

589<h3 id="metric-details">592<h3 id="metric-details">

590 Detalhes das métricas593 Detalhes das métricas

591</h3>594</h3>

592 595

593Cada métrica inclui os atributos padrão listados acima. Métricas com atributos adicionais específicos do contexto são observadas abaixo.596Cada métrica inclui os atributos padrão listados acima. Métricas com atributos adicionais específicos do contexto são anotadas abaixo.

594 597

595<h4 id="session-counter">598<h4 id="session-counter">

596 Contador de sessão599 Contador de sessão

601**Atributos**:604**Atributos**:

602 605

603* Todos os [atributos padrão](#standard-attributes)606* Todos os [atributos padrão](#standard-attributes)

604* `start_type`: Como a sessão foi iniciada. Um de `"fresh"`, `"resume"`, `"continue"` ou `"agents_view"`. O valor `"agents_view"` identifica o processo do painel `claude agents`, uma UI local lançada pelo usuário em vez de uma sessão conversacional. Filtre neste valor para separar lançamentos de processo de UI de sessões conversacionais em seus painéis.607* `start_type`: Como a sessão foi iniciada. Um de `"fresh"`, `"resume"`, `"continue"`, ou `"agents_view"`. O valor `"agents_view"` identifica o processo do dashboard `claude agents`, uma UI local iniciada pelo usuário em vez de uma sessão conversacional. Filtre neste valor para separar inicializações de processo de UI de sessões conversacionais em seus dashboards.

605 608

606<h4 id="lines-of-code-counter">609<h4 id="lines-of-code-counter">

607 Contador de linhas de código610 Contador de linhas de código

619 Contador de pull request622 Contador de pull request

620</h4>623</h4>

621 624

622Incrementado quando Claude Code cria um pull request ou merge request através de um comando shell ou uma ferramenta MCP.625Incrementado quando Claude Code cria uma pull request ou merge request através de um comando shell ou uma ferramenta MCP.

623 626

624**Atributos**:627**Atributos**:

625 628

639 Contador de custo642 Contador de custo

640</h4>643</h4>

641 644

642Incrementado após cada solicitação de API.645Incrementado após cada requisição de API.

643 646

644**Atributos**:647**Atributos**:

645 648

646* Todos os [atributos padrão](#standard-attributes)649* Todos os [atributos padrão](#standard-attributes)

647* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")650* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

648* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`651* `query_source`: Categoria do subsistema que emitiu a requisição. Um de `"main"`, `"subagent"`, ou `"auxiliary"`

649* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário652* `speed`: `"fast"` quando a requisição usou modo rápido. Ausente caso contrário

650* `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.653* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição: `"low"`, `"medium"`, `"high"`, `"xhigh"`, ou `"max"`. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

651* `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.654* `agent.name`: Tipo de subagente que emitiu a requisição. Nomes de agentes integrados e agentes de plugins do marketplace oficial aparecem literalmente. Outros nomes de agentes definidos pelo usuário são substituídos por `"custom"`. Ausente quando a requisição não foi emitida por um tipo de subagente nomeado.

652* `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.655* `skill.name`: Skill ativa para a requisição, definida pela ferramenta Skill, um comando `/`, ou herdada por um subagente gerado. Nomes de skills integrados, agrupados, definidos pelo usuário e de plugins do marketplace oficial aparecem literalmente. Nomes de skills de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nenhuma skill está ativa.

653* `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.656* `plugin.name`: Plugin proprietário quando a skill ativa ou subagente é fornecido por um plugin. Nomes de plugins do marketplace oficial aparecem literalmente. Nomes de plugins de terceiros são substituídos por `"third-party"`. Ausente quando nem a skill nem o subagente tem um plugin proprietário.

654* `marketplace.name`: Marketplace do qual o plugin proprietário foi instalado. Emitido apenas para plugins do marketplace oficial. Ausente caso contrário.657* `marketplace.name`: Marketplace do qual o plugin proprietário foi instalado. Emitido apenas para plugins do marketplace oficial. Ausente caso contrário.

655* `mcp_server.name`: Servidor MCP cuja ferramenta resultado esta solicitação consumiu. Nomes de servidor integrados, proxied por claude.ai e do registro oficial aparecem verbatim. Nomes de servidor configurados pelo usuário são substituídos por `"custom"`. Ausente quando a solicitação não consumiu nenhum resultado de ferramenta MCP. Antes da v2.1.222, Claude Code definia este atributo em cada solicitação após uma chamada de ferramenta MCP, não apenas em solicitações que consumiram um resultado de ferramenta, então painéis que o agregam mostram uma queda após você atualizar.658* `mcp_server.name`: Servidor MCP cujo resultado de ferramenta esta requisição consumiu. Nomes de servidores integrados, proxied por claude.ai e do registro oficial aparecem literalmente. Nomes de servidores configurados pelo usuário são substituídos por `"custom"`. Ausente quando a requisição não consumiu resultado de ferramenta MCP. Antes da v2.1.222, Claude Code definia este atributo em cada requisição após uma chamada de ferramenta MCP, não apenas em requisições que consumiram um resultado de ferramenta, então dashboards que o agregam mostram uma queda após você atualizar.

656* `mcp_tool.name`: Ferramenta MCP cujo resultado esta solicitação consumiu, com a mesma redação e comportamento de versão que `mcp_server.name`. Ausente quando a solicitação não consumiu nenhum resultado de ferramenta MCP.659* `mcp_tool.name`: Ferramenta MCP cujo resultado esta requisição consumiu, com o mesmo comportamento de redação e versão que `mcp_server.name`. Ausente quando a requisição não consumiu resultado de ferramenta MCP.

657 660

658<h4 id="token-counter">661<h4 id="token-counter">

659 Contador de token662 Contador de tokens

660</h4>663</h4>

661 664

662Incrementado após cada solicitação de API.665Incrementado após cada requisição de API.

663 666

664**Atributos**:667**Atributos**:

665 668

666* Todos os [atributos padrão](#standard-attributes)669* Todos os [atributos padrão](#standard-attributes)

667* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)670* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)

668* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")671* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

669* `query_source`: Categoria do subsistema que emitiu a solicitação. Um de `"main"`, `"subagent"` ou `"auxiliary"`672* `query_source`: Categoria do subsistema que emitiu a requisição. Um de `"main"`, `"subagent"`, ou `"auxiliary"`

670* `speed`: `"fast"` quando a solicitação usou modo rápido. Ausente caso contrário673* `speed`: `"fast"` quando a requisição usou modo rápido. Ausente caso contrário

671* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à solicitação. Veja [Contador de custo](#cost-counter) para detalhes.674* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição. Veja [Contador de custo](#cost-counter) para detalhes.

672* `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.675* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

673 676

674<h4 id="code-edit-tool-decision-counter">677<h4 id="code-edit-tool-decision-counter">

675 Contador de decisão da ferramenta de edição de código678 Contador de decisão da ferramenta de edição de código

676</h4>679</h4>

677 680

678Incrementado quando o usuário aceita ou rejeita o uso da ferramenta Edit, Write ou NotebookEdit.681Incrementado quando o usuário aceita ou rejeita o uso da ferramenta Edit, Write, ou NotebookEdit.

679 682

680**Atributos**:683**Atributos**:

681 684

682* Todos os [atributos padrão](#standard-attributes)685* Todos os [atributos padrão](#standard-attributes)

683* `tool_name`: Nome da ferramenta (`"Edit"`, `"Write"`, `"NotebookEdit"`)686* `tool_name`: Nome da ferramenta (`"Edit"`, `"Write"`, `"NotebookEdit"`)

684* `decision`: Decisão do usuário (`"accept"`, `"reject"`)687* `decision`: Decisão do usuário (`"accept"`, `"reject"`)

685* `source`: Onde a decisão veio. Um de `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"` ou `"user_reject"`. Veja o [Evento de decisão da ferramenta](#tool-decision-event) para o que cada valor significa.688* `source`: De onde a decisão veio. Um de `"config"`, `"hook"`, `"user_permanent"`, `"user_temporary"`, `"user_abort"`, ou `"user_reject"`. Veja o [evento de decisão de ferramenta](#tool-decision-event) para o que cada valor significa.

686* `language`: Linguagem de programação do arquivo editado, como `"TypeScript"`, `"Python"`, `"JavaScript"` ou `"Markdown"`. Retorna `"unknown"` para extensões de arquivo não reconhecidas.689* `language`: Linguagem de programação do arquivo editado, como `"TypeScript"`, `"Python"`, `"JavaScript"`, ou `"Markdown"`. Retorna `"unknown"` para extensões de arquivo não reconhecidas.

687 690

688<h4 id="active-time-counter">691<h4 id="active-time-counter">

689 Contador de tempo ativo692 Contador de tempo ativo

690</h4>693</h4>

691 694

692Rastreia o tempo real gasto usando ativamente Claude Code, excluindo tempo ocioso. Essa métrica é incrementada durante interações do usuário, como digitação e leitura de respostas, e durante processamento CLI, como execução de ferramentas e geração de resposta de IA.695Rastreia o tempo real gasto usando ativamente Claude Code, excluindo tempo ocioso. Esta métrica é incrementada durante interações do usuário, como digitação e leitura de respostas, e durante processamento da CLI, como execução de ferramentas e geração de resposta de IA.

693 696

694**Atributos**:697**Atributos**:

695 698

703Claude Code exporta os seguintes eventos via logs/eventos OpenTelemetry (quando `OTEL_LOGS_EXPORTER` está configurado):706Claude Code exporta os seguintes eventos via logs/eventos OpenTelemetry (quando `OTEL_LOGS_EXPORTER` está configurado):

704 707

705<h4 id="event-correlation-attributes">708<h4 id="event-correlation-attributes">

706 Atributos de correlação de evento709 Atributos de correlação de eventos

707</h4>710</h4>

708 711

709Quando um usuário envia um prompt, Claude Code pode fazer múltiplas chamadas de API e executar várias ferramentas. O atributo `prompt.id` permite vincular todos esses eventos de volta ao único prompt que os acionou.712Quando um usuário envia um prompt, Claude Code pode fazer múltiplas chamadas de API e executar várias ferramentas. O atributo `prompt.id` permite vincular todos esses eventos de volta ao único prompt que os acionou.

710 713

712| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |715| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

715| `message.uuid` | UUID da mensagem conforme persistida na transcrição da sessão, os arquivos `~/.claude/projects/*/*.jsonl`. Presente em `assistant_response` e em `user_prompt` exceto para despachos de comando, que podem produzir zero ou muitas mensagens. Em `assistant_response`, esta é a entrada de transcrição final da resposta, da qual o `parentUuid` da próxima rodada se encadeia. Requer Claude Code v2.1.214 ou posterior |718| `message.uuid` | UUID da mensagem conforme persistida na transcrição da sessão, os arquivos `~/.claude/projects/*/*.jsonl`. Presente em `assistant_response`, em `api_response_body`, e em `user_prompt` exceto para dispatches de comando, que podem produzir zero ou muitas mensagens. Em `assistant_response` e `api_response_body`, esta é a entrada final da transcrição da resposta, da qual o `parentUuid` do próximo turno se encadeia. Requer Claude Code v2.1.214 ou posterior, ou v2.1.274 ou posterior em `api_response_body` |

716| `client_request_id` | UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`. Presente em `api_request` e `api_error` em conexões de API de primeira parte; ausente em backends de provedor de terceiros e quando a solicitação foi repetida através do fallback não-streaming. Emparelha uma solicitação com sua resposta e permanece disponível para falhas como timeouts que nunca produziram um `request_id` do servidor. Corresponde ao mesmo atributo no span de rastreamento `llm_request`. Requer Claude Code v2.1.214 ou posterior |719| `client_request_id` | UUID gerado pelo cliente enviado como o header de requisição `x-client-request-id`. Presente em `api_request` e `api_error` em conexões de API de primeira parte; ausente em backends de provedores de terceiros e quando a requisição foi retentada através do fallback não-streaming. Emparelha uma requisição com sua resposta e permanece disponível para falhas como timeouts que nunca produziram um `request_id` do servidor. Corresponde ao mesmo atributo no span de rastreamento `llm_request`. Requer Claude Code v2.1.214 ou posterior |

717 720

718Para rastrear toda a atividade acionada por um único prompt, filtre seus eventos por um valor específico de `prompt.id`. Isso retorna o evento user\_prompt, quaisquer eventos api\_request e quaisquer eventos tool\_result que ocorreram ao processar esse prompt.721Para rastrear toda atividade acionada por um único prompt, filtre seus eventos por um valor específico de `prompt.id`. Isto retorna o evento user\_prompt, quaisquer eventos api\_request, e quaisquer eventos tool\_result que ocorreram ao processar esse prompt.

719 722

720`event.sequence` começa em 0 cada vez que um processo Claude Code inicia e conta para cima pela vida desse processo. Ele continua contando através de `/clear`, que atribui um novo `session.id`. Se você [retomar uma sessão sem fazer fork](/docs/pt/how-claude-code-works#resume-or-fork-sessions), a sessão mantém seu `session.id` mas toma seus valores de `event.sequence` do processo que a retomou, então dentro de uma sessão um evento posterior pode carregar um valor menor que um anterior, ou repetir um. Para ordenar os eventos de uma sessão, classifique por `event.timestamp` e use `event.sequence` para ordenar eventos que compartilham um timestamp.723`event.sequence` começa em 0 cada vez que um processo Claude Code inicia e conta para cima pela vida desse processo. Continua contando através de `/clear`, que atribui um novo `session.id`. Se você [retomar uma sessão sem fazer fork](/docs/pt/how-claude-code-works#resume-or-fork-sessions), a sessão mantém seu `session.id` mas toma seus valores de `event.sequence` do processo que a retomou, então dentro de uma sessão um evento posterior pode carregar um valor menor que um anterior, ou repetir um. Para ordenar os eventos de uma sessão, ordene por `event.timestamp` e use `event.sequence` para ordenar eventos que compartilham um timestamp.

721 724

722Para reconstrução em nível de mensagem, cada classe de evento carrega uma chave que corresponde a um campo na transcrição da sessão. O formato de entrada de transcrição é [interno ao Claude Code](/docs/pt/sessions#where-transcripts-are-stored) e muda entre versões, então um pipeline que se une nestes campos pode quebrar em qualquer versão; trate as uniões como específicas da versão em vez de um contrato estável:725Para reconstrução em nível de mensagem, cada classe de evento carrega uma chave que corresponde a um campo na transcrição da sessão. O formato de entrada da transcrição é [interno ao Claude Code](/docs/pt/sessions#where-transcripts-are-stored) e muda entre versões, então um pipeline que se une nestes campos pode quebrar em qualquer release; trate as uniões como específicas da versão em vez de um contrato estável:

723 726

724* `message.uuid` em `user_prompt` e `assistant_response`727* `message.uuid` em `user_prompt`, `assistant_response`, e `api_response_body`

725* `request_id` nos eventos de API, persistido como `requestId` nas entradas do assistente da transcrição728* `request_id` nos eventos de API, persistido como `requestId` nas entradas de assistente da transcrição

726* `tool_use_id` em eventos `tool_result` e `tool_decision`729* `tool_use_id` em eventos `tool_result` e `tool_decision`

727 730

728<h4 id="user-prompt-event">731<h4 id="user-prompt-event">

738* Todos os [atributos padrão](#standard-attributes)741* Todos os [atributos padrão](#standard-attributes)

739* `event.name`: `"user_prompt"`742* `event.name`: `"user_prompt"`

740* `event.timestamp`: Timestamp ISO 8601743* `event.timestamp`: Timestamp ISO 8601

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

742* `prompt_length`: Comprimento do prompt745* `prompt_length`: Comprimento do prompt

743* `prompt`: Conteúdo do prompt. Reduzido por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo746* `prompt`: Conteúdo do prompt. Redatado por padrão. Defina `OTEL_LOG_USER_PROMPTS=1` para incluí-lo

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

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

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

747 750

748<h4 id="assistant-response-event">751<h4 id="assistant-response-event">

749 Evento de resposta do assistente752 Evento de resposta do assistente

750</h4>753</h4>

751 754

752Registrado 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.755Registrado após cada requisiçã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.

753 756

754**Nome do Evento**: `claude_code.assistant_response`757**Nome do Evento**: `claude_code.assistant_response`

755 758

758* Todos os [atributos padrão](#standard-attributes)761* Todos os [atributos padrão](#standard-attributes)

759* `event.name`: `"assistant_response"`762* `event.name`: `"assistant_response"`

760* `event.timestamp`: Timestamp ISO 8601763* `event.timestamp`: Timestamp ISO 8601

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

762* `response_length`: Comprimento do texto de resposta em caracteres765* `response_length`: Comprimento do texto de resposta em caracteres

763* `response`: Texto de resposta, truncado no limite de conteúdo (60 KB por padrão). Reduzido para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` controla isso em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas reduzidas enquanto o registro de prompt está ativado766* `response`: Texto de resposta, truncado no limite de conteúdo (60 KB por padrão). Redatado para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` o controla em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas redatadas enquanto o log de prompt está ativado

764* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")767* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

765* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta. Presente apenas quando a API retorna um768* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta. Presente apenas quando a API retorna um

766* `message.uuid`: UUID da entrada de transcrição final da resposta. Uma resposta de API é persistida como uma entrada de transcrição por bloco de conteúdo; esta é a última, da qual o `parentUuid` da próxima rodada se encadeia. Requer Claude Code v2.1.214 ou posterior769* `message.uuid`: UUID da entrada final da transcrição da resposta. Uma resposta de API é persistida como uma entrada de transcrição por bloco de conteúdo; esta é a última, da qual o `parentUuid` do próximo turno se encadeia. Requer Claude Code v2.1.214 ou posterior

767* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente770* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente

768 771

769<h4 id="tool-result-event">772<h4 id="tool-result-event">

770 Evento de resultado da ferramenta773 Evento de resultado de ferramenta

771</h4>774</h4>

772 775

773Registrado quando uma ferramenta conclui a execução. Não é emitido se a chamada da ferramenta foi rejeitada; veja o [Evento de decisão da ferramenta](#tool-decision-event) para rejeições.776Registrado quando uma ferramenta completa a execução. Não emitido se a chamada de ferramenta foi rejeitada; veja o [evento de decisão de ferramenta](#tool-decision-event) para rejeições.

774 777

775**Nome do Evento**: `claude_code.tool_result`778**Nome do Evento**: `claude_code.tool_result`

776 779

779* Todos os [atributos padrão](#standard-attributes)782* Todos os [atributos padrão](#standard-attributes)

780* `event.name`: `"tool_result"`783* `event.name`: `"tool_result"`

781* `event.timestamp`: Timestamp ISO 8601784* `event.timestamp`: Timestamp ISO 8601

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

783* `tool_name`: Nome da ferramenta786* `tool_name`: Nome da ferramenta

784* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.787* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.

785* `success`: `"true"` ou `"false"`788* `success`: `"true"` ou `"false"`

787* `error_type`: String de categoria de erro quando a ferramenta falhou, como `"Error:ENOENT"` ou `"ShellError"`790* `error_type`: String de categoria de erro quando a ferramenta falhou, como `"Error:ENOENT"` ou `"ShellError"`

788* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a ferramenta falhou791* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a ferramenta falhou

789* `decision_type`: Sempre `"accept"`, já que este evento é emitido apenas após a ferramenta ser executada. Chamadas rejeitadas não produzem um resultado de ferramenta792* `decision_type`: Sempre `"accept"`, já que este evento é emitido apenas após a ferramenta ser executada. Chamadas rejeitadas não produzem um resultado de ferramenta

790* `decision_source`: Onde a decisão de permissão veio. Um de `"config"`, `"hook"`, `"user_permanent"` ou `"user_temporary"`. Veja o [Evento de decisão da ferramenta](#tool-decision-event) para o que cada valor significa. As fontes apenas de rejeição `"user_abort"` e `"user_reject"` nunca aparecem neste evento.793* `decision_source`: De onde a decisão de permissão veio. Um de `"config"`, `"hook"`, `"user_permanent"`, ou `"user_temporary"`. Veja o [evento de decisão de ferramenta](#tool-decision-event) para o que cada valor significa. As fontes apenas de rejeição `"user_abort"` e `"user_reject"` nunca aparecem neste evento.

791* `tool_input_size_bytes`: Tamanho da entrada da ferramenta serializada em JSON em bytes794* `tool_input_size_bytes`: Tamanho da entrada de ferramenta serializada em JSON em bytes

792* `tool_result_size_bytes`: Tamanho do resultado da ferramenta em bytes795* `tool_result_size_bytes`: Tamanho do resultado da ferramenta em bytes

793* `mcp_server_scope`: Identificador de escopo do servidor MCP (para ferramentas MCP)796* `mcp_server_scope`: Identificador de escopo do servidor MCP (para ferramentas MCP)

794* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quando `OTEL_LOG_TOOL_DETAILS=1`): a identidade do commit de uma execução bem-sucedida de `git commit` executada pela ferramenta Bash ou PowerShell. `vcs.ref.head.revision` é o SHA do commit, `vcs.ref.head.name` é o branch no qual foi feito o commit, e `vcs.ref.head.type` é `branch`. O nome e tipo são omitidos quando o commit foi feito em um HEAD desanexado. Requer Claude Code v2.1.269 ou posterior797* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (quando `OTEL_LOG_TOOL_DETAILS=1`): a identidade do commit de uma execução bem-sucedida de `git commit` executada pela ferramenta Bash ou PowerShell. `vcs.ref.head.revision` é o SHA do commit, `vcs.ref.head.name` é o branch no qual foi feito o commit, e `vcs.ref.head.type` é `branch`. O nome e tipo são omitidos quando o commit foi feito em um HEAD desanexado. Requer Claude Code v2.1.269 ou posterior

795* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Para servidores integrados do Claude Desktop, em sessões que o Claude Desktop possui, o par `mcp_server_name`/`mcp_tool_name` é incluído mesmo com a flag desligada, a mesma exceção de autoria do host que o [Evento de decisão da ferramenta](#tool-decision-event), requerendo Claude Code v2.1.214 ou posterior. Os parâmetros variam por ferramenta:798* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Para servidores integrados do Claude Desktop, em sessões que Claude Desktop possui, o par `mcp_server_name`/`mcp_tool_name` é incluído mesmo com a flag desativada, a mesma exceção de autoria do host que o [evento de decisão de ferramenta](#tool-decision-event), requerendo Claude Code v2.1.214 ou posterior. Os parâmetros variam por ferramenta:

796 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description` e `dangerouslyDisableSandbox`, mais `git_commit_id` e `git_branch` quando um comando `git commit` é bem-sucedido. `git_commit_id` é o SHA do commit completo quando o commit é o HEAD do diretório de trabalho da sessão, e o SHA abreviado do git caso contrário. `git_branch` é o branch no qual foi feito o commit, omitido em um HEAD desanexado799 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description`, e `dangerouslyDisableSandbox`, mais `git_commit_id` e `git_branch` quando um comando `git commit` é bem-sucedido. `git_commit_id` é o SHA completo do commit quando o commit é o HEAD do diretório de trabalho da sessão, e o SHA abreviado do git caso contrário. `git_branch` é o branch no qual foi feito o commit, omitido em um HEAD desanexado

797 * Para a ferramenta Bash de workspace do aplicativo desktop, que também relata `tool_name` como `Bash`: inclui apenas `bash_command`, `full_command` e `timeout`800 * Para a ferramenta Bash do workspace do aplicativo desktop, que também relata `tool_name` como `Bash`: inclui apenas `bash_command`, `full_command`, e `timeout`

798 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`801 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`

799 * Para ferramenta Skill: inclui `skill_name`802 * Para ferramenta Skill: inclui `skill_name`

800 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`803 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`

801* `tool_input` (quando `OTEL_LOG_TOOL_DETAILS=1`): Argumentos de ferramenta serializados em JSON. Valores individuais com mais de 512 caracteres são truncados, e a carga útil completa é limitada a \~4 K caracteres. Aplica-se a todas as ferramentas, incluindo ferramentas MCP.804* `tool_input` (quando `OTEL_LOG_TOOL_DETAILS=1`): Argumentos de ferramenta serializados em JSON. Valores individuais acima de 512 caracteres são truncados, e o payload completo é limitado a \~4 K caracteres. Aplica-se a todas as ferramentas incluindo ferramentas MCP.

802 805

803<h4 id="api-request-event">806<h4 id="api-request-event">

804 Evento de solicitação de API807 Evento de requisição de API

805</h4>808</h4>

806 809

807Registrado para cada solicitação de API para Claude.810Registrado para cada requisição de API para Claude.

808 811

809**Nome do Evento**: `claude_code.api_request`812**Nome do Evento**: `claude_code.api_request`

810 813

813* Todos os [atributos padrão](#standard-attributes)816* Todos os [atributos padrão](#standard-attributes)

814* `event.name`: `"api_request"`817* `event.name`: `"api_request"`

815* `event.timestamp`: Timestamp ISO 8601818* `event.timestamp`: Timestamp ISO 8601

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

817* `model`: Modelo usado (por exemplo, "claude-sonnet-5")820* `model`: Modelo usado (por exemplo, "claude-sonnet-5")

818* `cost_usd`: Custo estimado em USD821* `cost_usd`: Custo estimado em USD

819* `cost_usd_micros`: Custo estimado em milionésimos de dólar americano, emitido como um inteiro822* `cost_usd_micros`: Custo estimado em milionésimos de dólar americano, emitido como um inteiro

820* `duration_ms`: Duração da solicitação em milissegundos823* `duration_ms`: Duração da requisição em milissegundos

821* `input_tokens`: Número de tokens de entrada824* `input_tokens`: Número de tokens de entrada

822* `output_tokens`: Número de tokens de saída825* `output_tokens`: Número de tokens de saída

823* `cache_read_tokens`: Número de tokens lidos do cache826* `cache_read_tokens`: Número de tokens lidos do cache

824* `cache_creation_tokens`: Número de tokens usados para criação de cache827* `cache_creation_tokens`: Número de tokens usados para criação de cache

825* `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.828* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

826* `client_request_id`: UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`; veja a tabela [atributos de correlação de evento](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior829* `client_request_id`: UUID gerado pelo cliente enviado como o header de requisição `x-client-request-id`; veja a tabela [atributos de correlação de eventos](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior

827* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo830* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo

828* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente831* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente

829* `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.832* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição: `"low"`, `"medium"`, `"high"`, `"xhigh"`, ou `"max"`. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

830* `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.833* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

831 834

832<h4 id="api-error-event">835<h4 id="api-error-event">

833 Evento de erro de API836 Evento de erro de API

834</h4>837</h4>

835 838

836Registrado quando uma solicitação de API para Claude falha.839Registrado quando uma requisição de API para Claude falha.

837 840

838**Nome do Evento**: `claude_code.api_error`841**Nome do Evento**: `claude_code.api_error`

839 842

842* Todos os [atributos padrão](#standard-attributes)845* Todos os [atributos padrão](#standard-attributes)

843* `event.name`: `"api_error"`846* `event.name`: `"api_error"`

844* `event.timestamp`: Timestamp ISO 8601847* `event.timestamp`: Timestamp ISO 8601

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

846* `model`: Modelo usado (por exemplo, "claude-sonnet-5")849* `model`: Modelo usado (por exemplo, "claude-sonnet-5")

847* `error`: Mensagem de erro850* `error`: Mensagem de erro

848* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP, como falhas de conexão.851* `status_code`: Código de status HTTP como um número. Ausente para erros não-HTTP como falhas de conexão.

849* `duration_ms`: Duração da solicitação em milissegundos852* `duration_ms`: Duração da requisição em milissegundos

850* `attempt`: Número total de tentativas feitas, incluindo a solicitação inicial (`1` significa que nenhuma tentativa ocorreu)853* `attempt`: Número total de tentativas feitas, incluindo a requisição inicial (`1` significa que nenhuma retentativa ocorreu)

851* `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.854* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

852* `client_request_id`: UUID gerado pelo cliente enviado como o cabeçalho de solicitação `x-client-request-id`. Disponível mesmo quando uma falha como timeout ou erro de conexão nunca produziu um `request_id` do servidor; veja a tabela [atributos de correlação de evento](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior855* `client_request_id`: UUID gerado pelo cliente enviado como o header de requisição `x-client-request-id`. Disponível mesmo quando uma falha como timeout ou erro de conexão nunca produziu um `request_id` do servidor; veja a tabela [atributos de correlação de eventos](#event-correlation-attributes) para quando está presente. Requer Claude Code v2.1.214 ou posterior

853* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo856* `speed`: `"fast"` ou `"normal"`, indicando se o modo rápido estava ativo

854* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente857* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente

855* `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.858* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

856* `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.859* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

857 860

858<h4 id="api-refusal-event">861<h4 id="api-refusal-event">

859 Evento de recusa de API862 Evento de recusa de API

860</h4>863</h4>

861 864

862Registrado quando uma solicitação de API retorna `stop_reason: "refusal"`. Recusas chegam em um fluxo de resposta bem-sucedido em vez de como um erro HTTP, então o evento `api_error` não dispara para elas. Este evento permite rastrear a frequência de recusa e agrupar recusas pelos mesmos atributos que `api_request` e `api_error`.865Registrado quando uma requisição de API retorna `stop_reason: "refusal"`. Recusas chegam em um stream de resposta bem-sucedido em vez de como um erro HTTP, então o evento `api_error` não dispara para elas. Este evento permite rastrear a frequência de recusa e agrupar recusas pelos mesmos atributos que `api_request` e `api_error`.

863 866

864**Nome do Evento**: `claude_code.api_refusal`867**Nome do Evento**: `claude_code.api_refusal`

865 868

868* Todos os [atributos padrão](#standard-attributes)871* Todos os [atributos padrão](#standard-attributes)

869* `event.name`: `"api_refusal"`872* `event.name`: `"api_refusal"`

870* `event.timestamp`: Timestamp ISO 8601873* `event.timestamp`: Timestamp ISO 8601

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

872* `model`: Identificador do modelo da solicitação875* `model`: Identificador do modelo da requisição

873* `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.876* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

874* `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.877* `query_source`: Subsistema que emitiu a requisição, como `"repl_main_thread"`, `"compact"`, ou um nome de subagente. Veja [`api_request`](#api-request-event) para definições.

875* `speed`: Ou `"fast"` quando [Fast mode](/docs/pt/fast-mode) está ativo, ou `"normal"`878* `speed`: Ou `"fast"` quando [Modo rápido](/docs/pt/fast-mode) está ativo, ou `"normal"`

876* `attempt`: Número de tentativa de repetição. A primeira tentativa é `1`.879* `attempt`: Número de tentativa de retentativa. A primeira tentativa é `1`.

877* `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.880* `effort`: [Nível de esforço](/docs/pt/model-config#adjust-effort-level) aplicado à requisição. Ausente quando Claude Code não envia nível de esforço, por exemplo em um modelo que não suporta esforço.

878* `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.881* `server_fallback_hop`: `true` quando o fallback de modelo do lado do servidor da API já retentou esta recusa em um modelo diferente, então o usuário não viu esta recusa particular. `false` quando a requisição terminou em uma recusa. Um único turno pode emitir tanto um evento de hop `true` quanto um evento final `false` posterior quando o modelo de fallback também recusa.

879* `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`.882* `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 de hop não carregam `stop_details`.

880* `has_explanation`: `true` quando a resposta da API carregava um `stop_details.explanation`, caso contrário `false`. Ausente quando `server_fallback_hop` é `true`.883* `has_explanation`: `true` quando a resposta da API carregava um `stop_details.explanation`, caso contrário `false`. Ausente quando `server_fallback_hop` é `true`.

881* `category`: O valor `stop_details.category` da resposta da API. Um de `"cyber"`, `"bio"`, `"frontier_llm"` ou `"reasoning_extraction"`. Presente apenas quando `OTEL_LOG_TOOL_DETAILS=1` está definido e `has_category` é `true`.884* `category`: O valor `stop_details.category` da resposta da API. Um de `"cyber"`, `"bio"`, `"frontier_llm"`, ou `"reasoning_extraction"`. Presente apenas quando `OTEL_LOG_TOOL_DETAILS=1` está definido e `has_category` é `true`.

882* `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.885* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a requisição. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

883 886

884<h4 id="api-request-body-event">887<h4 id="api-request-body-event">

885 Evento de corpo de solicitação de API888 Evento de corpo de requisição de API

886</h4>889</h4>

887 890

888Registrado para cada tentativa de solicitação de API quando `OTEL_LOG_RAW_API_BODIES` está definido. Um evento é emitido por tentativa, então tentativas com parâmetros ajustados cada uma produzem seu próprio evento.891Registrado para cada tentativa de requisição de API quando `OTEL_LOG_RAW_API_BODIES` está definido. Um evento é emitido por tentativa, então retentativas com parâmetros ajustados cada uma produz seu próprio evento.

889 892

890**Nome do Evento**: `claude_code.api_request_body`893**Nome do Evento**: `claude_code.api_request_body`

891 894

894* Todos os [atributos padrão](#standard-attributes)897* Todos os [atributos padrão](#standard-attributes)

895* `event.name`: `"api_request_body"`898* `event.name`: `"api_request_body"`

896* `event.timestamp`: Timestamp ISO 8601899* `event.timestamp`: Timestamp ISO 8601

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

898* `body`: Parâmetros de solicitação da API Messages serializados em JSON, como o prompt do sistema, mensagens e ferramentas, truncados no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido em turnos anteriores do assistente é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).901* `body`: Parâmetros de requisição da API Messages serializados em JSON, como o prompt do sistema, mensagens e ferramentas, truncados no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido em turnos anteriores do assistente é redatado. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).

899* `body_ref`: Caminho absoluto para um arquivo `<dir>/<uuid>.request.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).902* `body_ref`: Caminho absoluto para um arquivo `<dir>/<uuid>.request.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

900* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`903* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`

901* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.904* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.

902* `model`: Identificador do modelo dos parâmetros de solicitação905* `model`: Identificador do modelo dos parâmetros de requisição

903* `query_source`: Subsistema que emitiu a solicitação (por exemplo, `"compact"`)906* `query_source`: Subsistema que emitiu a requisição (por exemplo, `"compact"`)

904* `request_body_id`: UUID que identifica o corpo de solicitação desta tentativa. O evento [`api_response_body`](#api-response-body-event) para a tentativa que é bem-sucedida carrega o mesmo valor, para que você possa emparelhar uma resposta com a solicitação exata que a produziu. Requer Claude Code v2.1.274 ou posterior907* `request_body_id`: UUID que identifica o corpo de requisição desta tentativa. O evento [`api_response_body`](#api-response-body-event) para a tentativa que é bem-sucedida carrega o mesmo valor, então você pode emparelhar uma resposta com a requisição exata que a produziu. Requer Claude Code v2.1.274 ou posterior

905 908

906<h4 id="api-response-body-event">909<h4 id="api-response-body-event">

907 Evento de corpo de resposta de API910 Evento de corpo de resposta de API

909 912

910Registrado para cada resposta de API bem-sucedida quando `OTEL_LOG_RAW_API_BODIES` está definido.913Registrado para cada resposta de API bem-sucedida quando `OTEL_LOG_RAW_API_BODIES` está definido.

911 914

912Em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code também anexa uma linha JSON a `<dir>/index.jsonl` para cada resposta bem-sucedida, com os campos `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` e `response_file`. Leia-o para encontrar os arquivos de solicitação e resposta atrás de uma determinada mensagem de transcrição sem consultar seu backend de telemetria. O arquivo de índice requer Claude Code v2.1.274 ou posterior.915Em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code também anexa uma linha JSON a `<dir>/index.jsonl` para cada resposta bem-sucedida, com os campos `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file`, e `response_file`. Leia-o para encontrar os arquivos de requisição e resposta atrás de uma determinada mensagem de transcrição sem consultar seu backend de telemetria. O arquivo de índice requer Claude Code v2.1.274 ou posterior.

913 916

914**Nome do Evento**: `claude_code.api_response_body`917**Nome do Evento**: `claude_code.api_response_body`

915 918

918* Todos os [atributos padrão](#standard-attributes)921* Todos os [atributos padrão](#standard-attributes)

919* `event.name`: `"api_response_body"`922* `event.name`: `"api_response_body"`

920* `event.timestamp`: Timestamp ISO 8601923* `event.timestamp`: Timestamp ISO 8601

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

922* `body`: Resposta da API Messages serializada em JSON, incluindo o id, blocos de conteúdo, uso e razão de parada, truncada no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido é reduzido. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).925* `body`: Resposta da API Messages serializada em JSON, incluindo o id, blocos de conteúdo, uso e razão de parada, truncada no limite de conteúdo (60 KB por padrão). Conteúdo de pensamento estendido é redatado. Emitido apenas em modo inline (`OTEL_LOG_RAW_API_BODIES=1`).

923* `body_ref`: Caminho absoluto para um arquivo `<dir>/<request_id>.response.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).926* `body_ref`: Caminho absoluto para um arquivo `<dir>/<request_id>.response.json` contendo o corpo não truncado. Emitido apenas em modo arquivo (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

924* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`927* `body_length`: Comprimento do corpo não truncado. Bytes UTF-8 quando `OTEL_LOG_RAW_API_BODIES=file:<dir>`, ou unidades de código UTF-16 quando `=1`

925* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.928* `body_truncated`: `"true"` quando truncamento inline ocorreu. Ausente em modo arquivo e quando nenhum truncamento ocorreu.

926* `model`: Identificador do modelo929* `model`: Identificador do modelo

927* `query_source`: Subsistema que emitiu a solicitação930* `query_source`: Subsistema que emitiu a requisição

928* `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.931* `request_id`: ID de requisição de API da Anthropic do header `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

929* `request_body_id`: O `request_body_id` do evento [`api_request_body`](#api-request-body-event) que esta resposta responde. Requer Claude Code v2.1.274 ou posterior932* `request_body_id`: O `request_body_id` do evento [`api_request_body`](#api-request-body-event) que esta resposta responde. Requer Claude Code v2.1.274 ou posterior

930* `message.id`: ID da mensagem que a API atribuiu à resposta, o campo `id` do corpo da resposta. Requer Claude Code v2.1.274 ou posterior933* `message.id`: ID de mensagem que a API atribuiu à resposta, o campo `id` do corpo da resposta. Requer Claude Code v2.1.274 ou posterior

931* `message.uuid`: UUID da entrada de transcrição final da resposta. Junto com `request_body_id`, ele vincula uma mensagem de transcrição aos corpos de solicitação e resposta atrás dela. Requer Claude Code v2.1.274 ou posterior934* `message.uuid`: UUID da entrada final da transcrição da resposta. Junto com `request_body_id`, vincula uma mensagem de transcrição aos corpos de requisição e resposta atrás dela. Requer Claude Code v2.1.274 ou posterior

932 935

933<h4 id="tool-decision-event">936<h4 id="tool-decision-event">

934 Evento de decisão da ferramenta937 Evento de decisão de ferramenta

935</h4>938</h4>

936 939

937Registrado quando uma decisão de permissão da ferramenta é feita (aceitar/rejeitar).940Registrado quando uma decisão de permissão de ferramenta é feita (aceitar/rejeitar).

938 941

939**Nome do Evento**: `claude_code.tool_decision`942**Nome do Evento**: `claude_code.tool_decision`

940 943

943* Todos os [atributos padrão](#standard-attributes)946* Todos os [atributos padrão](#standard-attributes)

944* `event.name`: `"tool_decision"`947* `event.name`: `"tool_decision"`

945* `event.timestamp`: Timestamp ISO 8601948* `event.timestamp`: Timestamp ISO 8601

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

947* `tool_name`: Nome da ferramenta (por exemplo, "Read", "Edit", "Write", "NotebookEdit")950* `tool_name`: Nome da ferramenta (por exemplo, "Read", "Edit", "Write", "NotebookEdit")

948* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.951* `tool_use_id`: Identificador único para esta invocação de ferramenta. Corresponde ao `tool_use_id` passado para hooks, permitindo correlação entre eventos OTel e dados capturados por hook.

949* `decision`: Ou `"accept"` ou `"reject"`952* `decision`: Ou `"accept"` ou `"reject"`

950* `tool_source`: Sempre presente. A proveniência da ferramenta, como um conjunto fechado de valores criados pela CLI. Requer Claude Code v2.1.214 ou posterior953* `tool_source`: Sempre presente. A proveniência da ferramenta, como um conjunto fechado de valores de autoria da CLI. Requer Claude Code v2.1.214 ou posterior

951 * `"builtin"`: as próprias ferramentas da CLI954 * `"builtin"`: as próprias ferramentas da CLI

952 * `"mcp"`: servidores MCP em geral955 * `"mcp"`: servidores MCP em geral

953 * `"sdk_host_builtin_mcp"`: um servidor em processo integrado ao próprio Claude Desktop, em uma sessão que Claude Desktop possui. Claude Desktop possui uma sessão que iniciou a partir de um de seus próprios pontos de entrada, `claude-desktop`, `claude-desktop-3p` ou `local-agent`, quando essa sessão não é uma criança aninhada; sessões aninhadas, incluindo sessões que o próprio Claude Code gera, relatam esses servidores como `"mcp"`956 * `"sdk_host_builtin_mcp"`: um servidor em processo integrado ao próprio Claude Desktop, em uma sessão que Claude Desktop possui. Claude Desktop possui uma sessão que iniciou de um de seus próprios pontos de entrada, `claude-desktop`, `claude-desktop-3p`, ou `local-agent`, quando essa sessão não é um filho aninhado; sessões aninhadas, incluindo sessões que Claude Code gera, relatam esses servidores como `"mcp"`

954* `source`: Onde a decisão veio:957* `source`: De onde a decisão veio:

955 * `"config"`: Decidido automaticamente sem avisar, baseado em configurações de projeto, regras de permissão nas configurações pessoais do usuário, política gerenciada corporativa, sinalizadores `--allowedTools` ou `--disallowedTools`, o modo de permissão ativo, uma concessão com escopo de sessão de um prompt anterior na mesma sessão CLI interativa, ou porque a ferramenta é inerentemente segura. O evento não indica qual dessas fontes correspondeu. Claude Code também relata `"config"` quando a própria solicitação de aviso de permissão falha, por exemplo quando o callback [`canUseTool`](/docs/pt/agent-sdk/typescript#canusetool) do Agent SDK ou a ferramenta [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) retorna um resultado inválido, ou quando o fluxo de entrada fecha enquanto a solicitação está pendente. Antes da v2.1.216, Claude Code relatava essas falhas como `"user_reject"`.958 * `"config"`: Decidido automaticamente sem solicitar, baseado em configurações de projeto, regras de permissão ou negação nas configurações pessoais do usuário, política gerenciada pela empresa, flags `--allowedTools` ou `--disallowedTools`, o modo de permissão ativo, uma concessão com escopo de sessão de um prompt anterior na mesma sessão CLI interativa, ou porque a ferramenta é inerentemente segura. O evento não indica qual dessas fontes correspondeu. Claude Code também relata `"config"` quando a própria requisição de prompt de permissão falha, por exemplo quando o callback [`canUseTool`](/docs/pt/agent-sdk/typescript#canusetool) do Agent SDK ou a ferramenta [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) retorna um resultado inválido, ou quando o stream de entrada fecha enquanto a requisição está pendente. Antes da v2.1.216, Claude Code relatava essas falhas como `"user_reject"`.

956 * `"hook"`: Um hook `PreToolUse` ou `PermissionRequest` retornou a decisão.959 * `"hook"`: Um hook `PreToolUse` ou `PermissionRequest` retornou a decisão.

957 * `"user_permanent"`: Emitido quando o usuário escolheu "Sim, e não pergunte novamente para ..." em um aviso de permissão, que salva uma regra de permissão em suas configurações pessoais. Na CLI interativa isso é emitido apenas para essa escolha em si; chamadas posteriores que correspondem à regra salva emitem `"config"` em vez disso. No Agent SDK ou sessões não-interativas `-p`, tanto a escolha inicial quanto correspondências de regra posteriores emitem `"user_permanent"`. Tratado como uma aceitação.960 * `"user_permanent"`: Emitido quando o usuário escolheu "Sim, e não pergunte novamente para ..." em um prompt de permissão, que salva uma regra de permissão em suas configurações pessoais. Na CLI interativa isto é emitido apenas para essa escolha em si; chamadas posteriores que correspondem à regra salva emitem `"config"` em vez disso. Em sessões Agent SDK ou não-interativas `-p`, tanto a escolha inicial quanto correspondências posteriores de regra emitem `"user_permanent"`. Tratado como uma aceitação.

958 * `"user_temporary"`: Emitido quando o usuário escolheu "Sim" em um aviso de permissão para uma aprovação única, ou escolheu uma opção que concede acesso pelo resto da sessão em um aviso de edição ou leitura de arquivo. Na CLI interativa isso é emitido apenas para a escolha em si; chamadas posteriores permitidas por essa concessão com escopo de sessão emitem `"config"` em vez disso. No Agent SDK ou sessões não-interativas `-p`, tanto a escolha quanto correspondências posteriores emitem `"user_temporary"`. Tratado como uma aceitação.961 * `"user_temporary"`: Emitido quando o usuário escolheu "Sim" em um prompt de permissão para uma aprovação única, ou escolheu uma opção que concede acesso pelo resto da sessão em um prompt de edição ou leitura de arquivo. Na CLI interativa isto é emitido apenas para a escolha em si; chamadas posteriores permitidas por essa concessão com escopo de sessão emitem `"config"` em vez disso. Em sessões Agent SDK ou não-interativas `-p`, tanto a escolha quanto correspondências posteriores emitem `"user_temporary"`. Tratado como uma aceitação.

959 * `"user_abort"`: Emitido quando o usuário descartou o aviso de permissão sem responder. No Agent SDK e sessões não-interativas `-p`, isso inclui interromper a rodada enquanto uma solicitação de permissão `canUseTool` ou `--permission-prompt-tool` está pendente; antes da v2.1.216, Claude Code relatava essa interrupção como `"user_reject"`. Tratado como uma rejeição.962 * `"user_abort"`: Emitido quando o usuário descartou o prompt de permissão sem responder. Em sessões Agent SDK e não-interativas `-p`, isto inclui interromper o turno enquanto uma requisição de permissão `canUseTool` ou `--permission-prompt-tool` está pendente; antes da v2.1.216, Claude Code relatava essa interrupção como `"user_reject"`. Tratado como uma rejeição.

960 * `"user_reject"`: Emitido quando o usuário escolheu "Não" quando solicitado. Na CLI interativa isso é emitido apenas para essa escolha em si; chamadas que correspondem a uma regra de negação nas configurações pessoais do usuário emitem `"config"` em vez disso. No Agent SDK ou sessões não-interativas `-p`, chamadas que correspondem a uma regra de negação em configurações pessoais emitem `"user_reject"`. Tratado como uma rejeição.963 * `"user_reject"`: Emitido quando o usuário escolheu "Não" quando solicitado. Na CLI interativa isto é emitido apenas para essa escolha em si; chamadas que correspondem a uma regra de negação nas configurações pessoais do usuário emitem `"config"` em vez disso. Em sessões Agent SDK ou não-interativas `-p`, chamadas que correspondem a uma regra de negação em configurações pessoais emitem `"user_reject"`. Tratado como uma rejeição.

961* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Mesma forma que o [Evento de resultado da ferramenta](#tool-result-event), menos campos pós-execução como `git_commit_id`. Os valores podem diferir de `tool_result` para uma chamada aceita se a decisão de permissão reescrever a entrada da ferramenta via `updatedInput`. Use este atributo para ver qual comando foi rejeitado quando `decision` é `"reject"`.964* `tool_parameters` (quando `OTEL_LOG_TOOL_DETAILS=1`): String JSON contendo parâmetros específicos da ferramenta. Mesma forma que o [evento de resultado de ferramenta](#tool-result-event), menos campos pós-execução como `git_commit_id`. Os valores podem diferir de `tool_result` para uma chamada aceita se a decisão de permissão reescreve a entrada da ferramenta via `updatedInput`. Use este atributo para ver qual comando foi rejeitado quando `decision` é `"reject"`.

962 * Para ferramentas `"sdk_host_builtin_mcp"`: `mcp_server_name` e `mcp_tool_name` são incluídos mesmo quando `OTEL_LOG_TOOL_DETAILS` está desligado, porque a aplicação host define esses nomes; sem eles, uma chamada rejeitada para um desses servidores integrados seria não atribuível no fluxo padrão. Para servidores MCP configurados pelo usuário, o `tool_name` do evento é sempre o literal `"mcp_tool"`, e os nomes do servidor e ferramenta aparecem apenas em `tool_parameters` com a flag ligada; conteúdo de argumento requer a flag em todos os lugares. Requer Claude Code v2.1.214 ou posterior965 * Para ferramentas `"sdk_host_builtin_mcp"`: `mcp_server_name` e `mcp_tool_name` são incluídos mesmo quando `OTEL_LOG_TOOL_DETAILS` está desativado, porque a aplicação host define esses nomes; sem eles, uma chamada rejeitada para um desses servidores integrados seria não atribuível no stream padrão. Para servidores MCP configurados pelo usuário, o `tool_name` do evento é sempre o literal `"mcp_tool"`, e os nomes do servidor e ferramenta aparecem apenas em `tool_parameters` com a flag ativada; conteúdo de argumento requer a flag em todos os lugares. Requer Claude Code v2.1.214 ou posterior

963 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. A ferramenta bash de workspace do aplicativo desktop também relata `tool_name` como `Bash`, mas inclui apenas `bash_command`, `full_command` e `timeout`966 * Para ferramenta Bash: inclui `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. A ferramenta bash do workspace do aplicativo desktop também relata `tool_name` como `Bash`, mas inclui apenas `bash_command`, `full_command`, e `timeout`

964 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`967 * Para ferramentas MCP: inclui `mcp_server_name`, `mcp_tool_name`

965 * Para ferramenta Skill: inclui `skill_name`968 * Para ferramenta Skill: inclui `skill_name`

966 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`969 * Para ferramenta Agent ou ferramenta Task legada: inclui `subagent_type`

967 970

968<h4 id="permission-mode-changed-event">971<h4 id="permission-mode-changed-event">

969 Evento de modo de permissão alterado972 Evento de mudança de modo de permissão

970</h4>973</h4>

971 974

972Registrado quando o modo de permissão muda, por exemplo de ciclagem Shift+Tab, saída do Plan Mode ou verificação de gate de modo automático.975Registrado quando o modo de permissão muda, por exemplo de ciclagem `Shift+Tab`, saída do modo de plano, ou uma verificação de gate de modo automático.

973 976

974**Nome do Evento**: `claude_code.permission_mode_changed`977**Nome do Evento**: `claude_code.permission_mode_changed`

975 978

978* Todos os [atributos padrão](#standard-attributes)981* Todos os [atributos padrão](#standard-attributes)

979* `event.name`: `"permission_mode_changed"`982* `event.name`: `"permission_mode_changed"`

980* `event.timestamp`: Timestamp ISO 8601983* `event.timestamp`: Timestamp ISO 8601

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

982* `from_mode`: O modo de permissão anterior, por exemplo `"default"`, `"plan"`, `"acceptEdits"`, `"auto"` ou `"bypassPermissions"`985* `from_mode`: O modo de permissão anterior, por exemplo `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, ou `"bypassPermissions"`

983* `to_mode`: O novo modo de permissão986* `to_mode`: O novo modo de permissão

984* `trigger`: O que causou a mudança. Um de `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"` ou `"auto_opt_in"`. Ausente quando a transição se origina do SDK ou bridge987* `trigger`: O que causou a mudança. Um de `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, ou `"auto_opt_in"`. Ausente quando a transição origina do SDK ou bridge

985 988

986<h4 id="auth-event">989<h4 id="auth-event">

987 Evento de autenticação990 Evento de autenticação

996* Todos os [atributos padrão](#standard-attributes)999* Todos os [atributos padrão](#standard-attributes)

997* `event.name`: `"auth"`1000* `event.name`: `"auth"`

998* `event.timestamp`: Timestamp ISO 86011001* `event.timestamp`: Timestamp ISO 8601

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

1000* `action`: `"login"` ou `"logout"`1003* `action`: `"login"` ou `"logout"`

1001* `success`: `"true"` ou `"false"`1004* `success`: `"true"` ou `"false"`

1002* `auth_method`: Método de autenticação, como `"oauth"`1005* `auth_method`: Método de autenticação, como `"oauth"`

1003* `error_category`: Tipo de erro categórico quando a ação falhou. A mensagem de erro bruta nunca é incluída1006* `error_category`: Tipo de erro categórico quando a ação falhou. A mensagem de erro bruta nunca é incluída

1004* `status_code`: Código de status HTTP como string quando a ação falhou com um erro HTTP1007* `status_code`: Código de status HTTP como uma string quando a ação falhou com um erro HTTP

1005 1008

1006<h4 id="mcp-server-connection-event">1009<h4 id="mcp-server-connection-event">

1007 Evento de conexão do servidor MCP1010 Evento de conexão do servidor MCP

1008</h4>1011</h4>

1009 1012

1010Registrado quando um servidor MCP se conecta, desconecta ou falha ao conectar.1013Registrado quando um servidor MCP se conecta, desconecta, ou falha em conectar.

1011 1014

1012**Nome do Evento**: `claude_code.mcp_server_connection`1015**Nome do Evento**: `claude_code.mcp_server_connection`

1013 1016

1016* Todos os [atributos padrão](#standard-attributes)1019* Todos os [atributos padrão](#standard-attributes)

1017* `event.name`: `"mcp_server_connection"`1020* `event.name`: `"mcp_server_connection"`

1018* `event.timestamp`: Timestamp ISO 86011021* `event.timestamp`: Timestamp ISO 8601

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

1020* `status`: `"connected"`, `"failed"` ou `"disconnected"`1023* `status`: `"connected"`, `"failed"`, ou `"disconnected"`

1021* `transport_type`: Transporte do servidor, como `"stdio"`, `"sse"` ou `"http"`1024* `transport_type`: Transporte do servidor, como `"stdio"`, `"sse"`, ou `"http"`

1022* `server_scope`: Escopo em que o servidor está configurado, como `"user"`, `"project"` ou `"local"`1025* `server_scope`: Escopo no qual o servidor está configurado, como `"user"`, `"project"`, ou `"local"`

1023* `duration_ms`: Duração da tentativa de conexão em milissegundos1026* `duration_ms`: Duração da tentativa de conexão em milissegundos

1024* `error_code`: Código de erro quando a conexão falhou1027* `error_code`: Código de erro quando a conexão falhou

1025* `is_plugin`: `true` quando o servidor é fornecido por um plugin, `false` caso contrário1028* `is_plugin`: `true` quando o servidor é fornecido por um plugin, `false` caso contrário

1026* `plugin_id_hash` (quando `is_plugin` é `true`): Hash estável do nome do plugin e marketplace, para agrupar eventos por plugin sem expor o nome. Claude Code o computa conforme descrito sob o [evento de plugin carregado](#plugin-loaded-event)1029* `plugin_id_hash` (quando `is_plugin` é `true`): Hash estável do nome do plugin e marketplace, para agrupar eventos por plugin sem expor o nome. Claude Code o computa conforme descrito no [evento de plugin carregado](#plugin-loaded-event)

1027* `plugin.name` (quando `is_plugin` é `true`): Nome do plugin que fornece o servidor. Para plugins de terceiros isso é a string literal `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`; isso protege nomes de plugins de terceiros de aparecerem em logs por padrão. Plugins de fontes oficiais Anthropic são sempre identificados por nome. Os atributos `plugin_id_hash` e `plugin.name` fluem para seu próprio backend de monitoramento e não são enviados para Anthropic1030* `plugin.name` (quando `is_plugin` é `true`): Nome do plugin que fornece o servidor. Para plugins de terceiros isto é a string literal `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`; isto protege nomes de plugins de terceiros de aparecerem em logs por padrão. Plugins de fontes oficiais da Anthropic são sempre identificados por nome. Os atributos `plugin_id_hash` e `plugin.name` fluem para seu próprio backend de monitoramento e não são enviados para a Anthropic

1028* `server_name` (quando `OTEL_LOG_TOOL_DETAILS=1`): Nome do servidor configurado1031* `server_name` (quando `OTEL_LOG_TOOL_DETAILS=1`): Nome do servidor configurado

1029* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a conexão falhou1032* `error` (quando `OTEL_LOG_TOOL_DETAILS=1`): Mensagem de erro completa quando a conexão falhou

1030 1033

1032 Evento de erro interno1035 Evento de erro interno

1033</h4>1036</h4>

1034 1037

1035Registrado quando Claude Code captura um erro interno inesperado. Apenas o nome da classe de erro e um código estilo errno são registrados. A mensagem de erro e rastreamento de pilha nunca são incluídos. Este evento não é emitido ao executar contra Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, ou quando `DISABLE_ERROR_REPORTING` está definido.1038Registrado quando Claude Code captura um erro interno inesperado. Apenas o nome da classe de erro e um código estilo errno são registrados. A mensagem de erro e stack trace nunca são incluídos. Este evento não é emitido ao executar contra Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry, ou quando `DISABLE_ERROR_REPORTING` está definido.

1036 1039

1037**Nome do Evento**: `claude_code.internal_error`1040**Nome do Evento**: `claude_code.internal_error`

1038 1041

1041* Todos os [atributos padrão](#standard-attributes)1044* Todos os [atributos padrão](#standard-attributes)

1042* `event.name`: `"internal_error"`1045* `event.name`: `"internal_error"`

1043* `event.timestamp`: Timestamp ISO 86011046* `event.timestamp`: Timestamp ISO 8601

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

1045* `error_name`: Nome da classe de erro, como `"TypeError"` ou `"SyntaxError"`1048* `error_name`: Nome da classe de erro, como `"TypeError"` ou `"SyntaxError"`

1046* `error_code`: Código errno Node.js como `"ENOENT"` quando presente no erro1049* `error_code`: Código errno do Node.js como `"ENOENT"` quando presente no erro

1047 1050

1048<h4 id="plugin-installed-event">1051<h4 id="plugin-installed-event">

1049 Evento de plugin instalado1052 Evento de plugin instalado

1058* Todos os [atributos padrão](#standard-attributes)1061* Todos os [atributos padrão](#standard-attributes)

1059* `event.name`: `"plugin_installed"`1062* `event.name`: `"plugin_installed"`

1060* `event.timestamp`: Timestamp ISO 86011063* `event.timestamp`: Timestamp ISO 8601

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

1062* `marketplace.is_official`: `"true"` se o marketplace é um marketplace oficial Anthropic, `"false"` caso contrário1065* `marketplace.is_official`: `"true"` se o marketplace é um marketplace oficial da Anthropic, `"false"` caso contrário

1063* `install.trigger`: `"cli"` ou `"ui"`1066* `install.trigger`: `"cli"` ou `"ui"`

1064* `plugin.name`: Nome do plugin instalado. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`1067* `plugin.name`: Nome do plugin instalado. Para marketplaces de terceiros isto é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`

1065* `plugin.version`: Versão do plugin quando declarada na entrada do marketplace. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`1068* `plugin.version`: Versão do plugin quando declarada na entrada do marketplace. Para marketplaces de terceiros isto é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`

1066* `marketplace.name`: Marketplace do qual o plugin foi instalado. Para marketplaces de terceiros isso é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`1069* `marketplace.name`: Marketplace do qual o plugin foi instalado. Para marketplaces de terceiros isto é incluído apenas quando `OTEL_LOG_TOOL_DETAILS=1`

1067 1070

1068<h4 id="plugin-loaded-event">1071<h4 id="plugin-loaded-event">

1069 Evento de plugin carregado1072 Evento de plugin carregado

1070</h4>1073</h4>

1071 1074

1072Registrado uma vez por plugin ativado no início da sessão. Use este evento para inventariar quais plugins estão ativos em toda a sua frota, como complemento ao `plugin_installed` que registra a ação de instalação em si.1075Registrado uma vez por plugin habilitado no início da sessão. Use este evento para inventariar quais plugins estão ativos em sua frota, como complemento a `plugin_installed` que registra a ação de instalação em si.

1073 1076

1074**Nome do Evento**: `claude_code.plugin_loaded`1077**Nome do Evento**: `claude_code.plugin_loaded`

1075 1078

1078* Todos os [atributos padrão](#standard-attributes)1081* Todos os [atributos padrão](#standard-attributes)

1079* `event.name`: `"plugin_loaded"`1082* `event.name`: `"plugin_loaded"`

1080* `event.timestamp`: Timestamp ISO 86011083* `event.timestamp`: Timestamp ISO 8601

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

1082* `plugin.name`: nome do plugin. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1085* `plugin.name`: nome do plugin. Para plugins fora do marketplace oficial e pacote integrado o valor é `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1083* `marketplace.name`: marketplace do qual o plugin foi instalado, quando conhecido. Reduzido para `"third-party"` sob a mesma condição que `plugin.name`1086* `marketplace.name`: marketplace do qual o plugin foi instalado, quando conhecido. Redatado para `"third-party"` sob a mesma condição que `plugin.name`

1084* `plugin.version`: versão do manifesto do plugin. Incluído apenas quando o nome não é reduzido e o manifesto declara uma versão1087* `plugin.version`: versão do manifesto do plugin. Incluído apenas quando o nome não é redatado e o manifesto declara uma versão

1085* `plugin.scope`: categoria de proveniência para o plugin: `"official"`, `"community"`, `"org"`, `"user-local"` ou `"default-bundle"`1088* `plugin.scope`: categoria de proveniência para o plugin: `"official"`, `"community"`, `"org"`, `"user-local"`, ou `"default-bundle"`

1086* `enabled_via`: como o plugin veio a ser ativado: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` ou `"user-install"`. O valor `"admin-install"` significa que o plugin está definido como obrigatório ou auto-instalação para sua organização em [**Configurações da Organização > Plugins**](https://claude.ai/admin-settings/plugins). Antes da v2.1.246, Claude Code relatava esses plugins como `"user-install"` ou `"seed-mount"`1089* `enabled_via`: como o plugin veio a ser habilitado: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"`, ou `"user-install"`. O valor `"admin-install"` significa que o plugin está definido como obrigatório ou auto-instalação para sua organização em [**Configurações da Organização > Plugins**](https://claude.ai/admin-settings/plugins). Antes da v2.1.246, Claude Code relatava esses plugins como `"user-install"` ou `"seed-mount"`

1087* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar os plugins de terceiros distintos carregados em toda a sua frota sem registrar seus nomes. Para [plugins sincronizados de claude.ai](/docs/pt/plugins-reference#synced-plugins), Claude Code faz hash do nome do plugin com o nome do marketplace que claude.ai relata para o plugin, ou com `synced` caso contrário. Antes da v2.1.246, Claude Code não usava o nome do marketplace que claude.ai relata no hash1090* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite contar os plugins de terceiros distintos carregados em sua frota sem registrar seus nomes. Para [plugins sincronizados de claude.ai](/docs/pt/plugins-reference#synced-plugins), Claude Code faz hash do nome do plugin com o nome do marketplace que claude.ai relata para o plugin, ou com `synced` caso contrário. Antes da v2.1.246, Claude Code não usava o nome do marketplace que claude.ai relata no hash

1088* `has_hooks`: se o plugin contribui hooks1091* `has_hooks`: se o plugin contribui hooks

1089* `has_mcp`: se o plugin contribui servidores MCP1092* `has_mcp`: se o plugin contribui servidores MCP

1090* `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 posterior1093* `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

1094* `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 posterior1097* `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

1095 1098

1096<h4 id="skill-activated-event">1099<h4 id="skill-activated-event">

1097 Evento de skill ativado1100 Evento de skill ativada

1098</h4>1101</h4>

1099 1102

1100Registrado quando uma skill é invocada, seja Claude a chama através da ferramenta Skill ou você a executa como um comando `/`.1103Registrado quando uma skill é invocada, seja Claude a chama através da ferramenta Skill ou você a executa como um comando `/`.

1106* Todos os [atributos padrão](#standard-attributes)1109* Todos os [atributos padrão](#standard-attributes)

1107* `event.name`: `"skill_activated"`1110* `event.name`: `"skill_activated"`

1108* `event.timestamp`: Timestamp ISO 86011111* `event.timestamp`: Timestamp ISO 8601

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

1110* `skill.name`: Nome da skill. Para skills definidas pelo usuário e de plugin de terceiros o valor é o placeholder `"custom_skill"` a menos que `OTEL_LOG_TOOL_DETAILS=1`1113* `skill.name`: Nome da skill. Para skills definidas pelo usuário e de plugins de terceiros o valor é o placeholder `"custom_skill"` a menos que `OTEL_LOG_TOOL_DETAILS=1`

1111* `invocation_trigger`: Como a skill foi acionada (`"user-slash"`, `"claude-proactive"` ou `"nested-skill"`)1114* `invocation_trigger`: Como a skill foi acionada (`"user-slash"`, `"claude-proactive"`, ou `"nested-skill"`)

1112* `skill.source`: De onde a skill foi carregada (por exemplo, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1115* `skill.source`: De onde a skill foi carregada (por exemplo, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1113* `skill.kind`: `"workflow"` quando a skill é uma skill de workflow. Ausente caso contrário1116* `skill.kind`: `"workflow"` quando a skill é uma skill de workflow. Ausente caso contrário

1114* `plugin.name` (quando `OTEL_LOG_TOOL_DETAILS=1` ou o plugin é de um marketplace oficial): Nome do plugin proprietário quando a skill é fornecida por um plugin1117* `plugin.name` (quando `OTEL_LOG_TOOL_DETAILS=1` ou o plugin é de um marketplace oficial): Nome do plugin proprietário quando a skill é fornecida por um plugin

1118 Evento de menção @1121 Evento de menção @

1119</h4>1122</h4>

1120 1123

1121Registrado quando Claude Code resolve uma menção `@` em um prompt. Nem toda menção emite um evento: caminhos de saída antecipada, como negações de permissão, arquivos superdimensionados, anexos de referência PDF e falhas de listagem de diretório retornam sem registrar.1124Registrado quando Claude Code resolve uma menção `@` em um prompt. Nem toda menção emite um evento: caminhos de saída antecipada como negações de permissão, arquivos superdimensionados, anexos de referência PDF e falhas de listagem de diretório retornam sem registrar.

1122 1125

1123**Nome do Evento**: `claude_code.at_mention`1126**Nome do Evento**: `claude_code.at_mention`

1124 1127

1127* Todos os [atributos padrão](#standard-attributes)1130* Todos os [atributos padrão](#standard-attributes)

1128* `event.name`: `"at_mention"`1131* `event.name`: `"at_mention"`

1129* `event.timestamp`: Timestamp ISO 86011132* `event.timestamp`: Timestamp ISO 8601

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

1131* `mention_type`: Tipo de menção (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). O valor `"peer"` significa que você mencionou [uma de suas outras sessões Claude Code](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.232 ou posterior1134* `mention_type`: Tipo de menção (`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). O valor `"peer"` significa que você mencionou [uma de suas outras sessões Claude Code](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.232 ou posterior

1132* `success`: Se a menção foi resolvida com sucesso (`"true"` ou `"false"`)1135* `success`: Se a menção foi resolvida com sucesso (`"true"` ou `"false"`)

1133 1136

1134<h4 id="api-retries-exhausted-event">1137<h4 id="api-retries-exhausted-event">

1135 Evento de tentativas de API esgotadas1138 Evento de retentativas de API esgotadas

1136</h4>1139</h4>

1137 1140

1138Registrado uma vez quando uma solicitação de API falha após mais de uma tentativa. Emitido junto com o evento `api_error` final.1141Registrado uma vez quando uma requisição de API falha após mais de uma tentativa. Emitido junto com o evento `api_error` final.

1139 1142

1140**Nome do Evento**: `claude_code.api_retries_exhausted`1143**Nome do Evento**: `claude_code.api_retries_exhausted`

1141 1144

1144* Todos os [atributos padrão](#standard-attributes)1147* Todos os [atributos padrão](#standard-attributes)

1145* `event.name`: `"api_retries_exhausted"`1148* `event.name`: `"api_retries_exhausted"`

1146* `event.timestamp`: Timestamp ISO 86011149* `event.timestamp`: Timestamp ISO 8601

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

1148* `model`: Modelo usado1151* `model`: Modelo usado

1149* `error`: Mensagem de erro final1152* `error`: Mensagem de erro final

1150* `status_code`: Código de status HTTP como número. Ausente para erros não-HTTP.1153* `status_code`: Código de status HTTP como um número. Ausente para erros não-HTTP.

1151* `total_attempts`: Número total de tentativas feitas1154* `total_attempts`: Número total de tentativas feitas

1152* `total_retry_duration_ms`: Tempo total de parede em todas as tentativas1155* `total_retry_duration_ms`: Tempo total de wall-clock em todas as tentativas

1153* `speed`: `"fast"` ou `"normal"`1156* `speed`: `"fast"` ou `"normal"`

1154 1157

1155<h4 id="hook-registered-event">1158<h4 id="hook-registered-event">

1156 Evento de hook registrado1159 Evento de hook registrado

1157</h4>1160</h4>

1158 1161

1159Registrado uma vez por hook configurado no início da sessão. Use este evento para inventariar quais hooks estão ativos em toda a sua frota, como complemento aos eventos `hook_execution_start` e `hook_execution_complete` por execução.1162Registrado uma vez por hook configurado no início da sessão. Use este evento para inventariar quais hooks estão ativos em sua frota, como complemento aos eventos por execução `hook_execution_start` e `hook_execution_complete`.

1160 1163

1161**Nome do Evento**: `claude_code.hook_registered`1164**Nome do Evento**: `claude_code.hook_registered`

1162 1165

1165* Todos os [atributos padrão](#standard-attributes)1168* Todos os [atributos padrão](#standard-attributes)

1166* `event.name`: `"hook_registered"`1169* `event.name`: `"hook_registered"`

1167* `event.timestamp`: Timestamp ISO 86011170* `event.timestamp`: Timestamp ISO 8601

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

1169* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`1172* `hook_event`: tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`

1170* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` ou `"agent"`1173* `hook_type`: tipo de implementação de hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, ou `"agent"`

1171* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` ou `"pluginHook"`1174* `hook_source`: onde o hook é definido: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, ou `"pluginHook"`

1172* `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 posterior1175* `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

1173* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): a string matcher da configuração do hook, quando uma está definida1176* `hook_matcher` (quando `OTEL_LOG_TOOL_DETAILS=1`): a string de matcher da configuração do hook, quando uma está definida

1174* `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`1177* `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`

1175* `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. Claude Code o computa conforme descrito sob o [evento de plugin carregado](#plugin-loaded-event)1178* `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. Claude Code o computa conforme descrito no [evento de plugin carregado](#plugin-loaded-event)

1176 1179

1177<h4 id="hook-execution-start-event">1180<h4 id="hook-execution-start-event">

1178 Evento de início de execução de hook1181 Evento de início de execução de hook

1187* Todos os [atributos padrão](#standard-attributes)1190* Todos os [atributos padrão](#standard-attributes)

1188* `event.name`: `"hook_execution_start"`1191* `event.name`: `"hook_execution_start"`

1189* `event.timestamp`: Timestamp ISO 86011192* `event.timestamp`: Timestamp ISO 8601

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

1191* `hook_event`: Tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`1194* `hook_event`: Tipo de evento de hook, como `"PreToolUse"` ou `"PostToolUse"`

1192* `hook_name`: Nome completo do hook incluindo matcher, como `"PreToolUse:Write"`1195* `hook_name`: Nome completo do hook incluindo matcher, como `"PreToolUse:Write"`

1193* `num_hooks`: Número de comandos de hook correspondentes1196* `num_hooks`: Número de comandos de hook correspondentes

1194* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos1197* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos

1195* `hook_source`: `"policySettings"` ou `"merged"`1198* `hook_source`: `"policySettings"` ou `"merged"`

1196* `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 posterior1199* `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

1197* `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 ativados1200* `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 habilitados

1198 1201

1199<h4 id="hook-execution-complete-event">1202<h4 id="hook-execution-complete-event">

1200 Evento de conclusão de execução de hook1203 Evento de conclusão de execução de hook

1209* Todos os [atributos padrão](#standard-attributes)1212* Todos os [atributos padrão](#standard-attributes)

1210* `event.name`: `"hook_execution_complete"`1213* `event.name`: `"hook_execution_complete"`

1211* `event.timestamp`: Timestamp ISO 86011214* `event.timestamp`: Timestamp ISO 8601

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

1213* `hook_event`: Tipo de evento de hook1216* `hook_event`: Tipo de evento de hook

1214* `hook_name`: Nome completo do hook incluindo matcher1217* `hook_name`: Nome completo do hook incluindo matcher

1215* `num_hooks`: Número de comandos de hook correspondentes1218* `num_hooks`: Número de comandos de hook correspondentes

1217* `num_blocking`: Contagem que retornou uma decisão de bloqueio1220* `num_blocking`: Contagem que retornou uma decisão de bloqueio

1218* `num_non_blocking_error`: Contagem que falhou sem bloquear1221* `num_non_blocking_error`: Contagem que falhou sem bloquear

1219* `num_cancelled`: Contagem cancelada antes da conclusão1222* `num_cancelled`: Contagem cancelada antes da conclusão

1220* `total_duration_ms`: Duração de parede de todos os hooks correspondentes1223* `total_duration_ms`: Duração de wall-clock de todos os hooks correspondentes

1221* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos1224* `managed_only`: `"true"` quando apenas hooks de política gerenciada são permitidos

1222* `hook_source`: `"policySettings"` ou `"merged"`1225* `hook_source`: `"policySettings"` ou `"merged"`

1223* `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 posterior1226* `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

1224* `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 ativados1227* `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 habilitados

1225 1228

1226<h4 id="hook-plugin-metrics-event">1229<h4 id="hook-plugin-metrics-event">

1227 Evento de métricas de plugin de hook1230 Evento de métricas de plugin de hook

1228</h4>1231</h4>

1229 1232

1230Registrado quando um hook de plugin do marketplace oficial emite métricas por invocação. Apenas plugins instalados de um marketplace oficial Anthropic podem emitir esses dados. Plugins de marketplace de terceiros e hooks configurados pelo usuário não emitem para este evento. Use este evento para monitorar o comportamento do plugin, como taxas de descoberta, custos e durações de sua própria pilha de observabilidade.1233Registrado quando um hook de plugin do marketplace oficial emite métricas por invocação. Apenas plugins instalados de um marketplace oficial da Anthropic podem emitir estes. Plugins de marketplace de terceiros e hooks configurados pelo usuário não emitem para este evento. Use este evento para monitorar comportamento de plugin como taxas de descoberta, custos e durações de sua própria pilha de observabilidade.

1231 1234

1232**Nome do Evento**: `claude_code.hook_plugin_metrics`1235**Nome do Evento**: `claude_code.hook_plugin_metrics`

1233 1236

1236* Todos os [atributos padrão](#standard-attributes)1239* Todos os [atributos padrão](#standard-attributes)

1237* `event.name`: `"hook_plugin_metrics"`1240* `event.name`: `"hook_plugin_metrics"`

1238* `event.timestamp`: Timestamp ISO 86011241* `event.timestamp`: Timestamp ISO 8601

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

1240* `plugin_id`: identificador do plugin em forma `<name>@<marketplace>`1243* `plugin_id`: identificador do plugin em forma `<name>@<marketplace>`

1241* `hook_event`: tipo de evento de hook que emitiu as métricas1244* `hook_event`: tipo de evento de hook que emitiu as métricas

1242* Até 20 chaves de métrica emitidas pelo plugin. Os nomes correspondem a `^[a-z][a-z0-9_]{0,39}$`. Os valores são booleanos ou números.1245* Até 20 chaves de métrica emitidas pelo plugin. Os nomes correspondem a `^[a-z][a-z0-9_]{0,39}$`. Os valores são booleano ou número.

1243 1246

1244<h4 id="compaction-event">1247<h4 id="compaction-event">

1245 Evento de compactação1248 Evento de compactação

1254* Todos os [atributos padrão](#standard-attributes)1257* Todos os [atributos padrão](#standard-attributes)

1255* `event.name`: `"compaction"`1258* `event.name`: `"compaction"`

1256* `event.timestamp`: Timestamp ISO 86011259* `event.timestamp`: Timestamp ISO 8601

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

1258* `trigger`: `"auto"` ou `"manual"`1261* `trigger`: `"auto"` ou `"manual"`

1259* `success`: `"true"` ou `"false"`1262* `success`: `"true"` ou `"false"`

1260* `duration_ms`: Duração da compactação1263* `duration_ms`: Duração da compactação

1261* `pre_tokens`: Contagem aproximada de tokens antes da compactação1264* `pre_tokens`: Contagem aproximada de tokens antes da compactação

1262* `post_tokens`: Contagem aproximada de tokens após compactação1265* `post_tokens`: Contagem aproximada de tokens após compactação

1263* `error`: Mensagem de erro quando a compactação falhou1266* `error`: Mensagem de erro quando a compactação falhou

1264* `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 posterior1267* `precompute_reuse`: Definido apenas quando `trigger` é `"manual"`. A compactação automática pode preparar um resumo em background antes da janela de contexto ficar cheia, 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

1265 1268

1266<h4 id="subagent-completed-event">1269<h4 id="subagent-completed-event">

1267 Evento de subagente concluído1270 Evento de conclusão de subagente

1268</h4>1271</h4>

1269 1272

1270Registrado quando um [subagente](/docs/pt/sub-agents) termina e retorna seu resultado para a conversa que o iniciou. Use-o para agregar uso de ferramenta e tempo de execução por tipo de subagente; para agregações de token ou custo, use o [contador de token](#token-counter) e [contador de custo](#cost-counter) filtrados para `query_source` `"subagent"`, já que o `total_tokens` deste evento cobre apenas a solicitação final. A categoria `"subagent"` também conta solicitações de hooks baseados em agentes, que não emitem nenhum evento de subagente.1273Registrado quando um [subagente](/docs/pt/sub-agents) termina e retorna seu resultado para a conversa que o iniciou. Use-o para agregar uso de ferramenta e tempo de execução por tipo de subagente; para agregações de token ou custo, use o [contador de tokens](#token-counter) e [contador de custo](#cost-counter) filtrados para `query_source` `"subagent"`, já que o `total_tokens` deste evento cobre apenas a requisição final. A categoria `"subagent"` também conta requisições de hooks baseados em agente, que não emitem evento de subagente.

1271 1274

1272**Nome do Evento**: `claude_code.subagent_completed`1275**Nome do Evento**: `claude_code.subagent_completed`

1273 1276

1276* Todos os [atributos padrão](#standard-attributes)1279* Todos os [atributos padrão](#standard-attributes)

1277* `event.name`: `"subagent_completed"`1280* `event.name`: `"subagent_completed"`

1278* `event.timestamp`: Timestamp ISO 86011281* `event.timestamp`: Timestamp ISO 8601

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

1280* `agent_type`: O tipo de subagente. Nomes de agente integrados e agentes de plugins do marketplace oficial aparecem verbatim; outros nomes de agente são substituídos por `"custom"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido1283* `agent_type`: O tipo de subagente. Nomes de agentes integrados e agentes de plugins do marketplace oficial aparecem literalmente; outros nomes de agente são substituídos por `"custom"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido

1281* `agent.source`: De onde a definição do agente veio: `built-in`, `plugin` ou a fonte de configurações que definiu um agente customizado, como `userSettings` ou `projectSettings`1284* `agent.source`: De onde a definição do agente veio: `built-in`, `plugin`, ou a fonte de configurações que definiu um agente personalizado, como `userSettings` ou `projectSettings`

1282* `is_built_in`: Se o subagente é um tipo de agente integrado1285* `is_built_in`: Se o subagente é um tipo de agente integrado

1283* `is_async`: Se o subagente foi executado em [segundo plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background)1286* `is_async`: Se o subagente executou em [background](/docs/pt/sub-agents#run-subagents-in-foreground-or-background)

1284* `total_tokens`: A pegada de token da solicitação final de API do subagente: tokens de entrada, criação de cache, leitura de cache e saída dessa solicitação, aproximadamente o tamanho do contexto do subagente na conclusão. Não é uma soma em toda a execução1287* `total_tokens`: A pegada de token da requisição final de API do subagente: tokens de entrada, criação de cache, leitura de cache e saída dessa única requisição, aproximadamente o tamanho do contexto do subagente na conclusão. Não uma soma em toda a execução

1285* `total_tool_uses`: Número de chamadas de ferramenta que o subagente fez em toda a execução1288* `total_tool_uses`: Número de chamadas de ferramenta que o subagente fez em toda a execução

1286* `duration_ms`: Tempo de execução em milissegundos1289* `duration_ms`: Tempo de execução em milissegundos

1287* `model`: O modelo que o subagente foi resolvido para executar1290* `model`: O modelo que o subagente foi resolvido para executar

1288* `final_model`: O modelo que produziu a resposta final do subagente, que difere de `model` após uma mudança no meio da execução, como um fallback. Requer Claude Code v2.1.212 ou posterior1291* `final_model`: O modelo que produziu a resposta final do subagente, que difere de `model` após uma mudança no meio da execução como um fallback. Requer Claude Code v2.1.212 ou posterior

1289* `model_swapped`: Se mais de um modelo serviu as solicitações do subagente. Requer Claude Code v2.1.212 ou posterior1292* `model_swapped`: Se mais de um modelo serviu as requisições do subagente. Requer Claude Code v2.1.212 ou posterior

1290* `plugin_id_hash`, `plugin.name`: Presente para agentes fornecidos por plugin. Nomes de plugin do marketplace oficial aparecem verbatim; outros nomes de plugin são substituídos por `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido1293* `plugin_id_hash`, `plugin.name`: Presente para agentes fornecidos por plugin. Nomes de plugins do marketplace oficial aparecem literalmente; outros nomes de plugin são substituídos por `"third-party"` a menos que `OTEL_LOG_TOOL_DETAILS=1` esteja definido

1291 1294

1292<h4 id="feedback-survey-event">1295<h4 id="feedback-survey-event">

1293 Evento de pesquisa de feedback1296 Evento de pesquisa de feedback

1302* Todos os [atributos padrão](#standard-attributes)1305* Todos os [atributos padrão](#standard-attributes)

1303* `event.name`: `"feedback_survey"`1306* `event.name`: `"feedback_survey"`

1304* `event.timestamp`: Timestamp ISO 86011307* `event.timestamp`: Timestamp ISO 8601

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

1306* `event_type`: Evento do ciclo de vida da pesquisa, por exemplo `"appeared"`, `"responded"` ou `"transcript_prompt_appeared"`1309* `event_type`: Evento do ciclo de vida da pesquisa, por exemplo `"appeared"`, `"responded"`, ou `"transcript_prompt_appeared"`

1307* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa1310* `appearance_id`: ID único vinculando os eventos emitidos para uma instância de pesquisa

1308* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"1311* `survey_type`: Qual pesquisa produziu o evento. `"session"` é o prompt de classificação "Como Claude está se saindo?"

1309* `response`: A seleção do usuário em eventos `responded`1312* `response`: A seleção do usuário em eventos `responded`

1310* `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 frota1313* `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 uma frota

1311 1314

1312<h4 id="retention-sweep-event">1315<h4 id="retention-sweep-event">

1313 Evento de varredura de retenção1316 Evento de varredura de retenção

1314</h4>1317</h4>

1315 1318

1316Registrado uma vez por execução da varredura de limpeza de retenção, que deleta [transcrições de sessão e outros dados de aplicação](/docs/pt/claude-directory#cleaned-up-automatically) mais antigos que a configuração [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays). Claude Code executa a varredura em segundo plano no máximo uma vez por sessão, e uma execução que não deleta nada ainda emite o evento. Se Claude Code executou a varredura em qualquer sessão na mesma máquina nas últimas 24 horas, ele atrasa a varredura desta sessão por pelo menos 10 minutos, então uma sessão que sai mais cedo não emite nada. Quando você executa `claude -p` com `--bare`, Claude Code não executa a varredura e não emite nada.1319Registrado uma vez por execução da varredura de limpeza de retenção, que deleta [transcrições de sessão e outros dados de aplicação](/docs/pt/claude-directory#cleaned-up-automatically) mais antigos que a configuração [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays). Claude Code executa a varredura em background no máximo uma vez por sessão, e uma execução que não deleta nada ainda emite o evento. Se Claude Code executou a varredura em qualquer sessão na mesma máquina nos últimos 24 horas, ele atrasa a varredura desta sessão por pelo menos 10 minutos, então uma sessão que sai mais cedo não emite nada. Quando você executa `claude -p` com `--bare`, Claude Code não executa a varredura e não emite nada.

1317 1320

1318Como todo evento OTel nesta página, ele vai apenas para o backend de telemetria que você configura. Requer Claude Code v2.1.227 ou posterior.1321Como todo evento OTel nesta página, ele vai apenas para o backend de telemetria que você configura. Requer Claude Code v2.1.227 ou posterior.

1319 1322

1320Quando Claude Code não consegue determinar com segurança o período de retenção, ele pausa a varredura e emite o evento com `result` definido como `"skipped"` e um `skip_reason`. Quando [configurações gerenciadas](/docs/pt/server-managed-settings) definem `cleanupPeriodDays`, o valor gerenciado fixa o período de retenção e a varredura é executada mesmo quando um arquivo de configurações em um escopo de prioridade mais baixa está quebrado ou inválido. Quando `managed-settings.json` em si não consegue ser lido, Claude Code ainda pausa a varredura a menos que o [nível gerenciado](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) forneça `cleanupPeriodDays` de outro lugar, como configurações gerenciadas pelo servidor ou um drop-in `managed-settings.d/` ao lado do arquivo quebrado. Os atributos do contador de exclusão estão presentes apenas quando `result` é `"complete"`.1323Quando Claude Code não pode determinar com segurança o período de retenção, ele pausa a varredura e emite o evento com `result` definido para `"skipped"` e um `skip_reason`. Quando [configurações gerenciadas](/docs/pt/server-managed-settings) definem `cleanupPeriodDays`, o valor gerenciado fixa o período de retenção e a varredura é executada mesmo quando um arquivo de configurações em um escopo de prioridade mais baixa está quebrado ou inválido. Quando `managed-settings.json` em si não pode ser lido, Claude Code ainda pausa a varredura a menos que o [nível gerenciado](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) forneça `cleanupPeriodDays` de outro lugar, como configurações gerenciadas pelo servidor ou um drop-in `managed-settings.d/` ao lado do arquivo quebrado. Os atributos do contador de exclusão estão presentes apenas quando `result` é `"complete"`.

1321 1324

1322**Nome do Evento**: `claude_code.retention_sweep`1325**Nome do Evento**: `claude_code.retention_sweep`

1323 1326

1326* Todos os [atributos padrão](#standard-attributes)1329* Todos os [atributos padrão](#standard-attributes)

1327* `event.name`: `"retention_sweep"`1330* `event.name`: `"retention_sweep"`

1328* `event.timestamp`: Timestamp ISO 86011331* `event.timestamp`: Timestamp ISO 8601

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

1330* `result`: `"complete"` quando a varredura foi executada, `"skipped"` quando Claude Code a pausou1333* `result`: `"complete"` quando a varredura foi executada, `"skipped"` quando Claude Code a pausou

1331* `period_days`: O valor `cleanupPeriodDays` das configurações mescladas, em dias, ou `30` quando nenhuma fonte o define. Em eventos ignorados, o valor que a varredura teria usado, computado a partir das fontes de configurações que Claude Code conseguiu ler1334* `period_days`: O valor `cleanupPeriodDays` das configurações mescladas, em dias, ou `30` quando nenhuma fonte o define. Em eventos pulados, o valor que a varredura teria usado, computado das fontes de configurações que Claude Code pôde ler

1332* `used_default`: `"true"` quando nenhuma fonte de configurações legível define `cleanupPeriodDays`, `"false"` caso contrário. Em eventos completos, `"true"` significa que o padrão de 30 dias foi aplicado1335* `used_default`: `"true"` quando nenhuma fonte de configurações legível define `cleanupPeriodDays`, `"false"` caso contrário. Em eventos completos, `"true"` significa que o padrão de 30 dias foi aplicado

1333* `skip_reason`: Por que Claude Code pausou a varredura. Presente apenas quando `result` é `"skipped"`:1336* `skip_reason`: Por que Claude Code pausou a varredura. Presente apenas quando `result` é `"skipped"`:

1334 * `"user_source_disabled"`: Configurações de usuário são excluídas, por exemplo pela flag [`--setting-sources`](/docs/pt/cli-reference#cli-flags) ou a opção [`settingSources`](/docs/pt/agent-sdk/typescript#options) do SDK, e nenhuma fonte ativada fornece `cleanupPeriodDays`1337 * `"user_source_disabled"`: Configurações do usuário são excluídas, por exemplo pela flag [`--setting-sources`](/docs/pt/cli-reference#cli-flags) ou opção [`settingSources`](/docs/pt/agent-sdk/typescript#options) do SDK, e nenhuma fonte habilitada fornece `cleanupPeriodDays`

1335 * `"settings_unknowable"`: Um arquivo de configurações não conseguiu ser lido ou analisado, então `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` pode estar definido para um valor que Claude Code não consegue ver1338 * `"settings_unknowable"`: Um arquivo de configurações não pôde ser lido ou analisado, então `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` pode estar definido para um valor que Claude Code não pode ver

1336 * `"settings_invalid_key_set"`: Configurações têm erros de validação e `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` está explicitamente definido, então fazer fallback para o padrão poderia deletar ou manter arquivos contra essa configuração1339 * `"settings_invalid_key_set"`: Configurações têm erros de validação e `cleanupPeriodDays` ou `desktopSessionCleanupPeriodDays` está explicitamente definido, então fazer fallback para o padrão poderia deletar ou manter arquivos contra essa configuração

1337* `transcripts_deleted`: Número de transcrições de sessão, os arquivos de nível superior `~/.claude/projects/*/*.jsonl`, que a varredura deletou1340* `transcripts_deleted`: Número de transcrições de sessão, os arquivos `~/.claude/projects/*/*.jsonl` de nível superior, que a varredura deletou

1338* `transcripts_exempted_desktop`: Número de transcrições passadas do período de retenção que a varredura manteve sob a [regra Claude Desktop e Cowork](/docs/pt/claude-directory#cleaned-up-automatically). Estes não contam para `files_past_cutoff`. Requer Claude Code v2.1.248 ou posterior1341* `transcripts_exempted_desktop`: Número de transcrições passadas do período de retenção que a varredura manteve sob a [regra de Claude Desktop e Cowork](/docs/pt/claude-directory#cleaned-up-automatically). Estes não contam para `files_past_cutoff`. Requer Claude Code v2.1.248 ou posterior

1339* `session_files_deleted`: Número de artefatos que a varredura de arquivos de sessão deletou: transcrições mais arquivos complementares por sessão, como sidecars, gravações e resultados de ferramentas1342* `session_files_deleted`: Número de artefatos que a varredura de arquivos de sessão deletou: transcrições mais arquivos complementares por sessão como sidecars, gravações e resultados de ferramentas

1340* `artifacts_deleted`: Total de itens que a varredura deletou em todos os diretórios de dados que cobre, incluindo os arquivos de sessão. Algumas varreduras contam uma árvore de diretório removida inteira como um item e algumas passagens de limpeza não contribuem para o contador, então trate o valor como um piso em vez de uma contagem exata de arquivos1343* `artifacts_deleted`: Total de itens que a varredura deletou em todos os diretórios de dados que cobre, incluindo os arquivos de sessão. Algumas varreduras contam uma árvore de diretório removida inteira como um item e algumas passagens de limpeza não contribuem para o contador, então trate o valor como um piso em vez de uma contagem exata de arquivos

1341* `files_retained_fresh`: Arquivos inspecionados e deixados no lugar porque ainda estão dentro do período de retenção. Apenas varreduras por arquivo contam estes, então o valor é um piso; um valor diferente de zero é o estado estável normal1344* `files_retained_fresh`: Arquivos inspecionados e deixados em lugar porque ainda estão dentro do período de retenção. Apenas varreduras por arquivo contam estes, então o valor é um piso; um valor diferente de zero é o estado estável normal

1342* `files_past_cutoff`: Arquivos mais antigos que o período de retenção que a varredura falhou em deletar, por exemplo por causa de um erro de permissão ou um arquivo mantido aberto. Um valor acima de zero significa que arquivos sobreviveram ao período de retenção configurado; zero não é prova de que nenhum fez, porque uma remoção falhada de um diretório inteiro conta para `error_count` em vez disso1345* `files_past_cutoff`: Arquivos mais antigos que o período de retenção que a varredura falhou em deletar, por exemplo por causa de um erro de permissão ou um arquivo mantido aberto. Um valor acima de zero significa que arquivos sobreviveram ao período de retenção configurado; zero não é prova de que nenhum fez, porque uma remoção falhada de um diretório inteiro conta para `error_count` em vez disso

1343* `error_count`: Número de erros que a varredura encontrou ao listar ou deletar arquivos1346* `error_count`: Número de erros que a varredura encontrou ao listar ou deletar arquivos

1344 1347

1348<h4 id="managed-settings-resolved-event">

1349 Evento de configurações gerenciadas resolvidas

1350</h4>

1351

1352Registrado com as [configurações gerenciadas](/docs/pt/managed-settings) que uma sessão resolveu: uma vez no início da sessão, novamente quando as configurações gerenciadas ou o [auxiliar de política](/docs/pt/managed-settings#compute-the-policy-with-a-helper-program) mudam de estado durante a sessão, e quando Claude Code recusa iniciar ou termina a sessão por uma das razões que o atributo `error.type` lista.

1353Use este evento para encontrar máquinas executando em uma fonte gerenciada inesperada, máquinas cujo auxiliar de política está falhando, e a razão pela qual uma máquina recusou iniciar.

1354Requer Claude Code v2.1.274 ou posterior.

1355

1356Por padrão, o evento carrega as fontes gerenciadas e o estado do auxiliar de política mas não as configurações em si. Para adicionar o atributo `managed_settings.settings` redatado e o digest `managed_settings.resolved_sha256`, defina `OTEL_LOG_MANAGED_SETTINGS=1`:

1357

1358* Defina-o no bloco `env` de configurações gerenciadas, configurações do usuário, ou `--settings`, ou no ambiente com o qual você inicia Claude Code. Um valor em configurações de projeto ou local não o ativa, porque um repositório clonado pode escrevê-los.

1359* Configurações gerenciadas pelo servidor podem defini-lo sem mostrar o [diálogo de aprovação de segurança](/docs/pt/server-managed-settings#security-approval-dialogs), porque a variável apenas adiciona sua própria política redatada da organização a um evento que sua organização já recebe.

1360

1361Em uma sessão interativa em uma pasta que você não [confiou](/docs/pt/permissions#what-runs-before-you-trust-a-folder), Claude Code não exporta o evento de recusa, porque configurações de projeto e local poderiam apontar a exportação para um coletor diferente antes da confiança.

1362

1363**Nome do Evento**: `claude_code.managed_settings_resolved`

1364

1365**Atributos**:

1366

1367* Todos os [atributos padrão](#standard-attributes)

1368* `event.name`: `"managed_settings_resolved"`

1369* `event.timestamp`: Timestamp ISO 8601

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

1371* `managed_settings.trigger`: `"startup"` para o evento de início de sessão, `"change"` quando as configurações gerenciadas ou o estado do auxiliar de política mudaram mais tarde na sessão, ou `"refused"` quando uma política de configurações gerenciadas parou a sessão. Claude Code envia um evento `change` apenas quando um atributo difere do último evento que enviou, e um valor de configuração alterado conta mesmo quando `OTEL_LOG_MANAGED_SETTINGS` está desativado

1372* `error.type`: por que Claude Code parou a sessão. Presente apenas em eventos `refused`:

1373 * `"helper_failed"`: uma [execução do auxiliar de política falhou](/docs/pt/settings-reference#helper-failures)

1374 * `"policy_invalid"`: as configurações gerenciadas contêm um erro que impede Claude Code de iniciar, ou uma fonte de administrador falhou em carregar, então Claude Code não pode verificar a imposição de login da organização

1375 * `"consent_rejected"`: o usuário rejeitou o [diálogo de aprovação de segurança](/docs/pt/server-managed-settings#security-approval-dialogs) para configurações gerenciadas pelo servidor

1376 * `"force_refresh_failed"`: a busca de configurações que [`forceRemoteSettingsRefresh`](/docs/pt/settings-reference#forceremotesettingsrefresh) requer falhou

1377 * `"gateway_rejected"`: um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) respondeu ao carregamento de configurações gerenciadas com HTTP 403

1378 * `"version_below_minimum"`: esta versão de Claude Code está abaixo de [`requiredMinimumVersion`](/docs/pt/settings-reference#requiredminimumversion) ou acima de [`requiredMaximumVersion`](/docs/pt/settings-reference#requiredmaximumversion)

1379 * `"_OTHER"`: o carregamento de configurações gerenciadas do gateway de aplicativos Claude falhou por outro motivo

1380* `managed_settings.sources`: cada fonte gerenciada que entrega pelo menos uma [chave de política](/docs/pt/managed-settings#how-claude-code-combines-managed-sources), prioridade mais alta primeiro, incluindo fontes cujas chaves não entram em efeito sob `first-wins`. Os valores são `"remote"`, `"plist"` ou `"hklm"` para a política MDM ou nível de SO, `"file"` para arquivos de configurações gerenciadas e drop-ins, `"parent"` quando um [host de incorporação](/docs/pt/managed-settings#let-an-embedding-host-add-policy) fornece configurações, e `"hkcu"` para o [valor de registro HKCU do Windows](/docs/pt/managed-settings#where-each-mechanism-stores-the-policy) quando Claude Code o [lê](/docs/pt/managed-settings#how-claude-code-combines-managed-sources). Uma fonte que carrega apenas chaves de controle, ou que Claude Code não pôde ler, não está listada. Emitido como um array de strings, vazio quando nenhuma fonte gerenciada entrega uma chave de política

1381* `managed_settings.source_behavior`: o valor [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) que Claude Code leu, `"first-wins"` ou `"merge"`. `"first-wins"` quando nenhuma fonte define a chave

1382* `managed_settings.helper.state`: estado do auxiliar de política que a fonte MDM ou arquivo selecionada configura:

1383 * `"ok"`: a saída do auxiliar serve como as configurações gerenciadas

1384 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"`, ou `"schema_rejected"`: a última execução do auxiliar falhou. [Falhas do auxiliar](/docs/pt/settings-reference#helper-failures) descreve os casos

1385 * `"none"`: nenhum auxiliar está configurado, ou a fonte que o configura não é uma política MDM ou arquivo de configurações gerenciadas

1386* `managed_settings.helper.applied`: `"output"` enquanto a saída do próprio auxiliar serve como as configurações gerenciadas, `"none"` quando não serve

1387* `managed_settings.helper.entry`: `"policyHelper"` quando Claude Code selecionou um [`policyHelper`](/docs/pt/settings-reference#policyhelper). Ausente quando selecionou nenhum auxiliar

1388* `managed_settings.helper.path`: o [`path`](/docs/pt/settings-reference#policyhelper-path) configurado do auxiliar. Presente sempre que Claude Code selecionou um auxiliar, independentemente de `OTEL_LOG_MANAGED_SETTINGS` estar definido

1389* `managed_settings.resolved_sha256` (quando `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 das configurações gerenciadas resolvidas antes da redação, serializadas como JSON com chaves ordenadas recursivamente e sem espaço em branco. Máquinas com o mesmo digest executam a mesma política. Claude Code envia o digest apenas com o opt-in porque uma política curta pode ser recuperada fazendo hash de suposições. Ausente quando nenhuma configuração gerenciada foi resolvida, e em eventos `refused`

1390* `managed_settings.settings` (quando `OTEL_LOG_MANAGED_SETTINGS=1`): os nomes e forma das configurações gerenciadas resolvidas como uma string JSON, com os valores redatados. Ausente em eventos `refused`. Claude Code o constrói a partir de seu esquema de configurações:

1391

1392 * Um nome de configuração que o esquema declara é exportado, e uma chave que não declara é deixada de fora

1393 * Booleanos, números e valores de string que o esquema restringe a um conjunto fixo de opções, como `permissions.defaultMode`, são exportados como estão. `sandbox.network.httpProxyPort` e `sandbox.network.socksProxyPort` são exportados como `"[REDACTED]"`

1394 * Toda outra string, como `model`, `apiKeyHelper`, todo valor `env`, toda URL e todo comando, é exportado como `"[REDACTED]"`

1395 * Os nomes de entrada de mapas, como nomes de variáveis `env` e IDs de plugin, são exportados como estão. Uma configuração cujas entradas o esquema não digita, como `vimInsertModeRemaps`, é exportada como um único `"[REDACTED]"`, e `sandbox.ignoreViolations` é exportado como uma lista de suas listas de caminho sem os padrões de comando

1396 * Uma lista mantém seu comprimento, com cada entrada redatada pelas mesmas regras

1397 * Uma regra `permissions.allow`, `permissions.deny`, ou `permissions.ask` é exportada como seu nome de ferramenta com o conteúdo redatado, como `Read([REDACTED])`, quando a ferramenta é integrada nesta versão de Claude Code ou é uma referência `mcp__` como `mcp__jira__create_issue`. Qualquer outra regra é exportada como `"[REDACTED]"`

1398 * Hooks seguem as mesmas regras, então campos de opção fixa e numéricos como `type` e `timeout` mostram, enquanto cada comando, URL, `matcher`, e condição `if` é exportada como `"[REDACTED]"`

1399

1400 Por exemplo, configurações gerenciadas com `apiKeyHelper`, duas variáveis `env`, e uma regra de negação são exportadas como `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1401

1402 Claude Code corta o valor em 8 KB de UTF-8, e o valor cortado não é JSON válido

1403* `managed_settings.settings_truncated` (quando `managed_settings.settings` está presente): `true` quando Claude Code cortou `managed_settings.settings` em 8 KB, `false` caso contrário. Emitido como um booleano, não uma string

1404

1345<h2 id="interpret-metrics-and-events-data">1405<h2 id="interpret-metrics-and-events-data">

1346 Interpretar dados de métricas e eventos1406 Interpretar dados de métricas e eventos

1347</h2>1407</h2>

1461Ao construir regras de detecção, procure o sinal que você deseja monitorar e consulte seu backend para o evento correspondente e atributos:1521Ao construir regras de detecção, procure o sinal que você deseja monitorar e consulte seu backend para o evento correspondente e atributos:

1462 1522

1464| ---------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------ |1524| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1471| Comandos executados e arquivos tocados | `tool_result` (executado) ou `tool_decision` (rejeitado) com `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (apenas `tool_result`) |1531| Comandos executados e arquivos tocados | `tool_result` (executado) ou `tool_decision` (rejeitado) com `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (apenas `tool_result`) |

1532| Quais fontes de configurações gerenciadas uma máquina executa, se seu auxiliar de política está saudável e por que uma máquina recusou iniciar | `managed_settings_resolved` | `managed_settings.trigger`, `managed_settings.sources`, `managed_settings.source_behavior`, `managed_settings.helper.state`, `error.type`; `managed_settings.settings` e `managed_settings.resolved_sha256` com `OTEL_LOG_MANAGED_SETTINGS=1` |

1472 1533

1473Claude Code emite apenas o fluxo de eventos bruto. Detecção de anomalias, linha de base, correlação entre sessões e alertas são responsabilidade do seu SIEM ou backend de observabilidade.1534Claude Code emite apenas o fluxo de eventos bruto. Detecção de anomalias, linha de base, correlação entre sessões e alertas são responsabilidade do seu SIEM ou backend de observabilidade.

1474 1535

network-config.md +1 −0

Details

245| `registry.npmjs.org` | Instalações de plugins (buscando pacotes de plugins de origem npm e instalando dependências de pacotes Node.js de plugins), servidores MCP iniciados com `npx` e o registro de pacotes para instalações npm e bun do próprio Claude Code |245| `registry.npmjs.org` | Instalações de plugins (buscando pacotes de plugins de origem npm e instalando dependências de pacotes Node.js de plugins), servidores MCP iniciados com `npx` e o registro de pacotes para instalações npm e bun do próprio Claude Code |

247| `*.frame.claudeusercontent.com` | Leituras de conteúdo de [Artifact](/docs/pt/artifacts). A CLI busca os arquivos de um artifact deste host quando Claude abre um, e apenas quando a ferramenta Artifact está [disponível](/docs/pt/artifacts#availability) para sua conta. Para desativar a ferramenta e remover este requisito, defina [`"enableArtifact": false`](/docs/pt/settings-reference#enableartifact) ou [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/pt/env-vars); Claude Code também honra a configuração [`disableArtifact`](/docs/pt/settings-reference#disableartifact) descontinuada. Consulte [Desabilitar artifacts](/docs/pt/artifacts#disable-artifacts) para saber como essas configurações interagem |247| `*.frame.claudeusercontent.com` | Leituras de conteúdo de [Artifact](/docs/pt/artifacts). A CLI busca os arquivos de um artifact deste host quando Claude abre um, e apenas quando a ferramenta Artifact está [disponível](/docs/pt/artifacts#availability) para sua conta. Para desativar a ferramenta e remover este requisito, defina [`"enableArtifact": false`](/docs/pt/settings-reference#enableartifact) ou [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/pt/env-vars); Claude Code também honra a configuração [`disableArtifact`](/docs/pt/settings-reference#disableartifact) descontinuada. Consulte [Desabilitar artifacts](/docs/pt/artifacts#disable-artifacts) para saber como essas configurações interagem |

248| `github.com` | Clonagem de [marketplaces de plugins](/docs/pt/plugin-marketplaces) e plugins hospedados no GitHub, incluindo o marketplace oficial da Anthropic, via HTTPS ou SSH. Para clonar fontes `owner/repo` do GitHub apenas via HTTPS, defina [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/pt/env-vars) |

248| `raw.githubusercontent.com` | Feed de changelog para [`/release-notes`](/docs/pt/commands). Em sessões interativas, Claude Code também o busca em segundo plano na inicialização quando seu changelog em cache ainda não cobre a versão em execução, como na primeira inicialização após uma atualização; sessões não interativas e em nuvem nunca o buscam |249| `raw.githubusercontent.com` | Feed de changelog para [`/release-notes`](/docs/pt/commands). Em sessões interativas, Claude Code também o busca em segundo plano na inicialização quando seu changelog em cache ainda não cobre a versão em execução, como na primeira inicialização após uma atualização; sessões não interativas e em nuvem nunca o buscam |

249| `*-review.googlesource.com` | Pesquisa de alteração Gerrit em checkouts `googlesource.com`. Quando uma sessão de guia Claude Desktop Code inicia ou retoma em um checkout [confiável](/docs/pt/permissions#project-allow-rules-and-workspace-trust) cujo `origin` é um host `googlesource.com`, Claude Code pergunta anonimamente ao servidor `-review` desse host pela alteração aberta correspondente ao `Change-Id` do HEAD, uma vez por inicialização ou retomada. Outros tipos de sessão pulam a pesquisa, e nenhum outro host Gerrit é contatado. Opcional: desabilite com [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars) |250| `*-review.googlesource.com` | Pesquisa de alteração Gerrit em checkouts `googlesource.com`. Quando uma sessão de guia Claude Desktop Code inicia ou retoma em um checkout [confiável](/docs/pt/permissions#project-allow-rules-and-workspace-trust) cujo `origin` é um host `googlesource.com`, Claude Code pergunta anonimamente ao servidor `-review` desse host pela alteração aberta correspondente ao `Change-Id` do HEAD, uma vez por inicialização ou retomada. Outros tipos de sessão pulam a pesquisa, e nenhum outro host Gerrit é contatado. Opcional: desabilite com [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars) |

250| `http-intake.logs.us5.datadoghq.com` | Eventos de telemetria operacional, enviados apenas quando a CLI usa a API Anthropic diretamente, nunca para Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry. Opcional: desabilite com [`DISABLE_TELEMETRY`](/docs/pt/data-usage#telemetry-services) ou `DO_NOT_TRACK` |251| `http-intake.logs.us5.datadoghq.com` | Eventos de telemetria operacional, enviados apenas quando a CLI usa a API Anthropic diretamente, nunca para Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry. Opcional: desabilite com [`DISABLE_TELEMETRY`](/docs/pt/data-usage#telemetry-services) ou `DO_NOT_TRACK` |

output-styles.md +123 −41

Details

4 4

5# Estilos de saída5# Estilos de saída

6 6

~~7> Adapte Claude Code para usos além da engenharia de software~~7> Altere o papel, tom e formato de resposta do Claude Code com um estilo de saída integrado, como Conciso ou Explicativo, ou escreva um estilo personalizado.

8 8

9Os estilos de saída alteram como Claude responde, não o que Claude sabe. Eles definem o papel, tom e formato de saída do Claude para cada resposta. Use um quando você continua re-solicitando a mesma voz ou formato a cada turno, ou quando você quer que Claude atue como algo diferente de um engenheiro de software.9Um estilo de saída é um conjunto de instruções que define o papel, tom e formato de resposta do Claude para cada resposta em uma sessão. Claude Code inclui quatro estilos integrados além do padrão, e você pode escrever o seu próprio.

10 10

11Um estilo de saída personalizado fornece ao Claude suas próprias instruções 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.11Use um estilo de saída para alterar a forma como Claude responde e trabalha com você durante toda uma sessão, para que você não repita a solicitação em cada prompt. Por exemplo, um estilo integrado pode tornar as respostas mais curtas, adicionar uma explicação de cada alteração, ou fazer com que Claude comece o trabalho sem fazer perguntas rotineiras. Um estilo personalizado também pode transformar Claude em algo diferente de um engenheiro de software, como um assistente de redação ou um analista de dados.

12 12

~~13Para instruções sobre seu projeto, convenções ou base de código, use [CLAUDE.md](/docs/pt/memory) em vez disso.~~13* Para usar um estilo integrado, escolha um dos [estilos de saída integrados](#built-in-output-styles) e [mude para ele](#change-your-output-style).

14* Para escrever suas próprias instruções, [crie um estilo de saída personalizado](#create-a-custom-output-style).

16<Note>

17 Um estilo de saída fornece instruções ao Claude para seguir. Não garante que algo sempre aconteça ou nunca aconteça. Algumas necessidades se encaixam em um recurso diferente:

19 * Para o que Claude deve saber sobre seu projeto, use [CLAUDE.md](/docs/pt/memory).

20 * Para algo que tem que acontecer toda vez, como formatação após cada edição ou bloqueio de um comando, use um [hook](/docs/pt/hooks-guide).

21 * Para skills, subagentes e outras opções, consulte [Escolha entre um estilo de saída e outros recursos](#choose-between-an-output-style-and-other-features).

22</Note>

14 23

15<h2 id="built-in-output-styles">24<h2 id="built-in-output-styles">

16 Estilos de saída integrados25 Estilos de saída integrados

17</h2>26</h2>

18 27

~~19O estilo de saída **Default** do Claude Code é seu conjunto padrão de instruções, projetado para ajudá-lo a completar tarefas de engenharia de software com eficiência.~~28O Claude Code começa no estilo [**Default**](#default), suas instruções padrão para completar tarefas de engenharia de software. Cada um dos outros quatro estilos integrados mantém essas instruções e adiciona as suas próprias.

30Esta tabela mostra o que cada estilo muda em uma sessão e quando se encaixa:

32| Estilo | O que muda | Use quando |

33| :-------------------------- | :-------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |

34| [Proactive](#proactive) | Claude começa o trabalho imediatamente e faz suposições razoáveis em vez de perguntar sobre decisões rotineiras | Você quer que Claude continue trabalhando através de decisões rotineiras, e você corrigirá o curso se uma suposição estiver errada |

35| [Concise](#concise) | As respostas começam com o resultado e omitem preâmbulo, narração e recapitulações | As respostas padrão são mais longas do que você quer |

36| [Explanatory](#explanatory) | Claude adiciona blocos `Insight` curtos que explicam as escolhas por trás do código que escreve | Você está conhecendo uma base de código ou quer o raciocínio junto com a mudança |

37| [Learning](#learning) | Claude explica suas escolhas e deixa pequenos pedaços de código para você escrever você mesmo | Você quer prática de codificação prática enquanto a tarefa ainda é concluída |

39<h3 id="default">

40 Default

41</h3>

43Default significa que nenhum estilo de saída está selecionado. O Claude Code não adiciona instruções de estilo, e Claude trabalha a partir do prompt do sistema padrão do Claude Code, que é escrito para tarefas de engenharia de software.

45`default` aparece na lista `/output-style` com os outros estilos, então você [o seleciona da mesma forma](#change-your-output-style).

47<h3 id="proactive">

48 Proactive

49</h3>

51No estilo Proactive, Claude começa a implementar assim que você envia uma tarefa. Ele faz suposições razoáveis sobre decisões rotineiras em vez de parar para perguntar, e não muda para o modo de plano a menos que você peça um plano. Você pode redirecioná-lo em qualquer ponto.

53As instruções do estilo também dizem ao Claude para verificar com você na conversa antes de uma ação que exclui dados ou altera um sistema compartilhado ou de produção. Essa verificação é uma instrução que Claude segue e é separada dos prompts de permissão.

55Mudar para o estilo Proactive não altera seu [modo de permissão](/docs/pt/permission-modes). Seu modo de permissão ainda decide quais chamadas de ferramenta são executadas sem perguntar a você, então os prompts de permissão aparecem da mesma forma que antes de você mudar.

57<h3 id="concise">

58 Concise

59</h3>

61No estilo Concise, a primeira frase de uma resposta afirma o que aconteceu ou qual é a resposta. Claude omite a introdução, a narração passo a passo e o recapitulação de fechamento, e responde uma pergunta simples em uma a três frases. Ele faz o trabalho de engenharia tão completamente quanto no estilo Default. Requer Claude Code v2.1.237 ou posterior.

63Claude ainda escreve em comprimento total nestes casos:

65* **Qualquer coisa que você pedir**: quando você pedir uma explicação ou mais detalhes, Claude responde completamente.

66* **Qualquer coisa que você precisa para agir com segurança**: relatórios de erro, saída de teste falhando, avisos de segurança e confirmações para ações destrutivas mantêm seu conteúdo completo.

68<h3 id="explanatory">

69 Explanatory

70</h3>

72No estilo Explanatory, Claude faz a tarefa da forma como faz no estilo Default e adiciona explicações curtas sobre por que fez as escolhas que fez. Cada explicação aparece na conversa, antes ou depois do código sobre o qual se trata, em um bloco rotulado `Insight`. As explicações não são escritas em seus arquivos como comentários.

20 73

~~21Existem quatro estilos de saída integrados adicionais:~~74Um bloco `Insight` carrega dois ou três pontos sobre sua base de código ou o código que Claude escreveu, como este após adicionar um endpoint de API:

22 75

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 seu modo de permissão ainda decide o que é executado sem perguntar.76```text theme={null}

77★ Insight ─────────────────────────────────────

78- Every route in this repo goes through the withAuth wrapper, so the new endpoint gets session checks without its own middleware.

79- Rate limits are set per route in limits.ts, which is why this change adds an entry there rather than a global default.

80─────────────────────────────────────────────────

81```

83<h3 id="learning">

84 Learning

85</h3>

24 86

25* **Concise**: Claude começa com o resultado, pula preâmbulo e narração, e mantém respostas curtas por padrão, enquanto faz o trabalho de engenharia tão completamente quanto no estilo Default. Quando você pede uma explicação ou mais detalhes, Claude responde completamente. Claude sempre mantém o conteúdo completo de relatórios de erro, avisos de segurança e confirmações de ações destrutivas. Requer Claude Code v2.1.237 ou posterior.87No estilo Learning, Claude adiciona os mesmos blocos `Insight` que o [estilo Explanatory](#explanatory) e também pede que você escreva parte do código. Claude lida com a implementação rotineira em si. Quando chega a uma peça com uma decisão de design real, como tratamento de erro, uma estrutura de dados ou lógica de negócios com mais de uma abordagem válida, ele deixa algumas linhas para você.

26 88

27* **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.89Claude marca o local com um comentário `TODO(human)` no arquivo, depois envia uma solicitação que diz o que já foi construído, o que escrever e o que pesar:

28 90

29* **Learning**: Modo colaborativo de aprender fazendo, onde Claude não apenas compartilhará "Insights" enquanto codifica, mas também pedirá que você contribua com pequenos e estratégicos pedaços de código. Claude Code adicionará marcadores `TODO(human)` no seu código para você implementar.91```text theme={null}

92● Learn by Doing

94Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

96Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

98Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

99```

100

101Claude então para e espera. Escreva seu código no comentário `TODO(human)` e diga ao Claude quando terminar. Claude responde com um `Insight` sobre seu código e continua a tarefa.

30 102

31<h2 id="change-your-output-style">103<h2 id="change-your-output-style">

32 Altere seu estilo de saída104 Altere seu estilo de saída

33</h2>105</h2>

34 106

~~35Escolha um estilo de uma destas formas:~~107Escolha um estilo com o comando, um menu ou um arquivo de configurações. O comando e ambos os menus salvam sua escolha em `.claude/settings.local.json` no [nível do projeto local](/docs/pt/settings).

36 108

37* **Comando `/output-style`**: execute `/output-style <style>` para alternar, por exemplo `/output-style concise`. Sem argumentos, o comando lista os estilos que você pode escolher e marca o atual. Claude Code salva sua seleção em `.claude/settings.local.json` no [nível do projeto local](/docs/pt/settings).109* **Comando `/output-style`**: execute `/output-style <style>` para alternar, por exemplo `/output-style concise`. Sem argumentos, o comando lista os estilos que você pode escolher e marca o atual.

38 110

39 O comando também funciona em [modo não interativo](/docs/pt/headless) e sessões do Agent SDK, e do aplicativo móvel ou web via [Controle Remoto](/docs/pt/remote-control#limitations), onde você pode listar e selecionar apenas [estilos integrados](#built-in-output-styles). Requer Claude Code v2.1.269 ou posterior.111 O comando também funciona em [modo não interativo](/docs/pt/headless) e sessões do Agent SDK, e do aplicativo móvel ou web via [Controle Remoto](/docs/pt/remote-control#limitations), onde você pode listar e selecionar apenas [estilos integrados](#built-in-output-styles). Requer Claude Code v2.1.269 ou posterior.

40* **Terminal**: execute `/config` e selecione **Output style** para escolher um estilo de um menu. Claude Code salva sua seleção em `.claude/settings.local.json` no [nível do projeto local](/docs/pt/settings).112* **Menu do Terminal**: execute `/config` e selecione **Output style** para escolher um estilo de um menu.

41* **Extensão VS Code**: abra o [menu de comandos](/docs/pt/vs-code#use-the-prompt-box) com `/` e selecione **Output styles** para escolher um estilo, incluindo seus estilos personalizados. Claude Code salva sua seleção em `.claude/settings.local.json`, o mesmo arquivo que o menu do terminal escreve. Requer Claude Code v2.1.257 ou posterior.113* **Extensão VS Code**: abra o [menu de comandos](/docs/pt/vs-code#use-the-prompt-box) com `/` e selecione **Output styles** para escolher um estilo, incluindo seus estilos personalizados. Requer Claude Code v2.1.257 ou posterior.

42* **Aplicativo Desktop**: defina o campo `outputStyle` em um arquivo de configurações, por exemplo `.claude/settings.local.json`, o arquivo que o menu do terminal escreve. Quando você executa `/config` lá, Claude Code [abre **Settings > Claude Code**](/docs/pt/desktop#what%E2%80%99s-not-available-in-desktop) em vez de um menu.114* **Aplicativo Desktop**: defina o campo `outputStyle` em um arquivo de configurações, por exemplo `.claude/settings.local.json`, o arquivo que o menu do terminal escreve. Quando você executa `/config` lá, Claude Code [abre **Settings > Claude Code**](/docs/pt/desktop#what%E2%80%99s-not-available-in-desktop) em vez de um menu.

43 115

44Para definir um estilo sem o menu, edite o campo `outputStyle` diretamente em um arquivo de configurações:116Para definir um estilo sem o menu, edite o campo `outputStyle` diretamente em um arquivo de configurações:

49}121}

50```122```

51 123

124O valor é sensível a maiúsculas e minúsculas, portanto escreva os nomes integrados como `Proactive`, `Concise`, `Explanatory` e `Learning`. Um valor que não corresponde exatamente a um nome de estilo, como `explanatory`, oferece o estilo Padrão. O comando `/output-style` ignora maiúsculas e minúsculas.

125

126Para tornar um estilo seu padrão em todos os projetos, defina `outputStyle` em `~/.claude/settings.json`. Os arquivos de configurações próprios de um projeto [têm precedência](/docs/pt/settings#settings-precedence) sobre esse valor.

127

52Quando você alterna estilos no meio da sessão, Claude usa o novo estilo a partir da sua próxima mensagem. Para o custo dessa primeira mensagem em cache de prompt, consulte [Alterando estilo de saída](/docs/pt/prompt-caching#changing-output-style). Antes da v2.1.251, o novo estilo era aplicado apenas após você executar `/clear` ou iniciar uma nova sessão.128Quando você alterna estilos no meio da sessão, Claude usa o novo estilo a partir da sua próxima mensagem. Para o custo dessa primeira mensagem em cache de prompt, consulte [Alterando estilo de saída](/docs/pt/prompt-caching#changing-output-style). Antes da v2.1.251, o novo estilo era aplicado apenas após você executar `/clear` ou iniciar uma nova sessão.

53 129

54<h2 id="create-a-custom-output-style">130<h2 id="create-a-custom-output-style">

98[Plugins](/docs/pt/plugins-reference) também podem enviar estilos de saída em um diretório `output-styles/`.174[Plugins](/docs/pt/plugins-reference) também podem enviar estilos de saída em um diretório `output-styles/`.

99 175

100<h3 id="frontmatter">176<h3 id="frontmatter">

101 Frontmatter177 Referência de frontmatter

102</h3>178</h3>

103 179

104Os arquivos de estilo de saída suportam estes campos de frontmatter:180Configure um estilo de saída com [frontmatter](/docs/pt/glossary#frontmatter) YAML entre marcadores `---` no topo do arquivo. Todos os campos são opcionais, e os nomes dos campos usam palavras minúsculas separadas por hífens. Um campo digitado incorretamente é ignorado sem um erro. Se o YAML não for analisado, o estilo ainda será carregado com seu nome de arquivo sem campos definidos; execute `claude --debug` para ver o erro de análise.

181

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

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

184| `name` | Não | Nome do estilo de saída, mostrado no seletor `/config`. Padrão: o nome do arquivo |

185| `description` | Não | Descrição do estilo de saída, mostrada no seletor `/config` |

186| `keep-coding-instructions` | Não | Defina como `true` para manter as instruções integradas de engenharia de software do Claude Code junto com seu estilo. Padrão: `false` |

187| `force-for-plugin` | Não | Apenas estilos de saída de plugin. Defina como `true` para aplicar este estilo automaticamente sempre que o plugin estiver habilitado, sem exigir que os usuários o selecionem. Substitui a configuração `outputStyle` do usuário. Se vários plugins habilitados definirem isso, Claude Code usa o primeiro carregado. Padrão: `false` |

105 188

106| Frontmatter | Propósito | Padrão |189<span id="comparisons-to-related-features" />

107| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------- |190

108| `name` | Nome do estilo de saída, se não for o nome do arquivo | Herda do nome do arquivo |191<h2 id="choose-between-an-output-style-and-other-features">

109| `description` | Descrição do estilo de saída, mostrada no seletor `/config` | Nenhum |192 Escolha entre um estilo de saída e outros recursos

110| `keep-coding-instructions` | Manter as instruções integradas de engenharia de software do Claude Code | `false` |193</h2>

111| `force-for-plugin` | Apenas estilos de saída de plugin: aplique este estilo automaticamente sempre que o plugin estiver habilitado, sem exigir que os usuários o selecionem. Substitui a configuração `outputStyle` do usuário. Se vários plugins habilitados definirem isso, Claude Code usa o primeiro carregado. | `false` |194

195Um estilo de saída se aplica a cada resposta em uma sessão. É uma instrução que Claude segue, portanto nada a impõe. Quando o que você quer é mais restrito do que cada resposta, ou precisa acontecer sem falha, outro recurso se encaixa melhor.

196

197Esta tabela corresponde o que você quer ao recurso que faz isso:

198

199| O que você quer | Use | Por que se encaixa |

200| :----------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |

201| Cada resposta em uma certa voz, comprimento ou formato, ou Claude em um papel diferente | Um estilo de saída | Ele se aplica a toda a sessão, e você muda de estilos com um comando |

202| Claude conhecer as convenções, comandos e estrutura do seu projeto | [CLAUDE.md](/docs/pt/memory) | Ele contém o que Claude deve saber sobre a base de código, e permanece carregado qualquer que seja o estilo que você escolha |

203| Instruções para um tipo de tarefa, como uma lista de verificação de lançamento ou um procedimento de revisão | Uma [skill](/docs/pt/skills) | Claude a carrega apenas quando você a invoca ou a tarefa corresponde, portanto não molda respostas não relacionadas |

204| Algo que deve acontecer toda vez sem exceção, como formatação após cada edição ou bloqueio de um comando | Um [hook](/docs/pt/hooks-guide) | Claude Code executa um hook em um evento do ciclo de vida, portanto não depende de Claude seguir uma instrução |

205| Um assistente com suas próprias instruções, modelo e ferramentas para uma tarefa focada | Um [subagent](/docs/pt/sub-agents) | Ele é executado em um contexto separado com seu próprio prompt do sistema e retorna um resumo para sua conversa |

206| Uma adição às instruções do Claude que você passa quando inicia Claude Code | [`--append-system-prompt`](/docs/pt/cli-reference#system-prompt-flags) | Ele acrescenta ao prompt do sistema sem remover nada |

207

208Esses recursos se combinam. Por exemplo, você pode usar CLAUDE.md para o que Claude deve saber, um estilo de saída para como ele responde, e um hook para qualquer coisa que tenha que ser garantida. [Estenda Claude Code](/docs/pt/features-overview) compara o restante dos recursos de extensão.

112 209

113<h2 id="how-output-styles-work">210<h2 id="how-output-styles-work">

114 Como os estilos de saída funcionam211 Como os estilos de saída funcionam

117Um estilo de saída altera as instruções que Claude Code fornece ao Claude.214Um estilo de saída altera as instruções que Claude Code fornece ao Claude.

118 215

119* Claude Code envia as instruções do estilo ativo com cada solicitação.216* Claude Code envia as instruções do estilo ativo com cada solicitação.

120* Quando você [seleciona um estilo diferente de Default](#change-your-output-style), Claude Code também lembra Claude do estilo durante a conversa.217* Os estilos de saída personalizados omitem as instruções de engenharia de software integradas do Claude Code, como como definir o escopo das alterações, escrever comentários e verificar o trabalho, a menos que `keep-coding-instructions` seja definido como `true`.

121* Os estilos de saída personalizados deixam de fora as instruções integradas de engenharia de software do Claude Code, como como escopar mudanças, escrever comentários e verificar trabalho, a menos que `keep-coding-instructions` seja definido como `true`.

~~122~~

123Os estilos de saída se aplicam à conversa principal e a um [fork](/docs/pt/sub-agents#fork-the-current-conversation), que herda a conversa completa e o prompt do sistema do pai. Outros [subagents executam seu próprio prompt do sistema](/docs/pt/sub-agents#what-loads-at-startup), portanto os estilos não alteram como eles respondem.

~~124~~

125O uso de tokens depende do estilo. As instruções de um estilo adicionam tokens de entrada, embora o prompt caching reduza esse custo após a primeira solicitação em uma sessão.

126 218

127Os estilos integrados Explanatory e Learning produzem respostas mais longas que Default por design, o que aumenta os tokens de saída. O estilo Concise faz o oposto ao instruir Claude a manter as respostas curtas por padrão. Para estilos personalizados, o uso de tokens de saída depende do que suas instruções dizem ao Claude para produzir.219Os estilos de saída se aplicam à conversa principal e a um [fork](/docs/pt/sub-agents#fork-the-current-conversation), que herda a conversa completa e o prompt do sistema do pai. Outros [subagentes executam seu próprio prompt do sistema](/docs/pt/sub-agents#what-loads-at-startup), portanto os estilos não alteram como eles respondem.

~~128~~

129<h2 id="comparisons-to-related-features">

130 Comparações com recursos relacionados

131</h2>

132 220

133Vários recursos personalizam como Claude Code se comporta. Os estilos de saída modificam as instruções padrão do Claude Code e se aplicam a cada resposta. Os outros adicionam instruções sem alterar os padrões, ou os limitam a uma tarefa específica.221O uso de tokens depende do estilo. As instruções de um estilo adicionam tokens de entrada, embora o cache de prompt reduza esse custo após a primeira solicitação em uma sessão.

134 222

135| Recurso | Como funciona | Use-o quando |223Os estilos Explanatory e Learning integrados produzem respostas mais longas do que Default por design, o que aumenta os tokens de saída. O estilo Concise faz o oposto ao instruir Claude a manter as respostas curtas por padrão. Para estilos personalizados, o uso de tokens de saída depende do que suas instruções dizem ao Claude para produzir.

136| :----------------------- | :--------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------- |

137| Estilos de saída | Modifica as instruções padrão do Claude Code | Você quer um papel, tom ou formato de resposta padrão diferente a cada turno |

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

139| `--append-system-prompt` | Anexa ao prompt do sistema sem remover nada | Você quer uma adição única passada como um [sinalizador CLI](/docs/pt/cli-reference#system-prompt-flags) no lançamento |

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

141| [Skills](/docs/pt/skills) | Carrega instruções específicas de tarefas quando invocadas ou relevantes | Você tem um fluxo de trabalho reutilizável |

142 224

143<h2 id="related-resources">225<h2 id="related-resources">

144 Recursos relacionados226 Recursos relacionados

overview.md +2 −1

Details

226 226

227Além dos ambientes [Terminal](/docs/pt/quickstart), [VS Code](/docs/pt/vs-code), [JetBrains](/docs/pt/jetbrains), [Desktop](/docs/pt/desktop) e [Web](/docs/pt/claude-code-on-the-web) acima, Claude Code se integra com CI/CD, chat e fluxos de trabalho do navegador:227Além dos ambientes [Terminal](/docs/pt/quickstart), [VS Code](/docs/pt/vs-code), [JetBrains](/docs/pt/jetbrains), [Desktop](/docs/pt/desktop) e [Web](/docs/pt/claude-code-on-the-web) acima, Claude Code se integra com CI/CD, chat e fluxos de trabalho do navegador:

228 228

229| Eu quero... | Melhor opção |229| O que eu quero fazer | Melhor opção |

230| --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |230| --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |

231| Continuar uma sessão local do meu telefone ou outro dispositivo | [Remote Control](/docs/pt/remote-control) |231| Continuar uma sessão local do meu telefone ou outro dispositivo | [Remote Control](/docs/pt/remote-control) |

232| Enviar eventos do Telegram, Discord, iMessage ou meus próprios webhooks para uma sessão | [Channels](/docs/pt/channels) |232| Enviar eventos do Telegram, Discord, iMessage ou meus próprios webhooks para uma sessão | [Channels](/docs/pt/channels) |

247* [Quickstart](/docs/pt/quickstart): caminhe através de sua primeira tarefa real, desde explorar uma base de código até fazer commit de uma correção247* [Quickstart](/docs/pt/quickstart): caminhe através de sua primeira tarefa real, desde explorar uma base de código até fazer commit de uma correção

248* [Armazene instruções e memórias](/docs/pt/memory): dê ao Claude instruções persistentes com arquivos CLAUDE.md e memória automática248* [Armazene instruções e memórias](/docs/pt/memory): dê ao Claude instruções persistentes com arquivos CLAUDE.md e memória automática

249* [Fluxos de trabalho comuns](/docs/pt/common-workflows) e [melhores práticas](/docs/pt/best-practices): padrões para aproveitar ao máximo Claude Code249* [Fluxos de trabalho comuns](/docs/pt/common-workflows) e [melhores práticas](/docs/pt/best-practices): padrões para aproveitar ao máximo Claude Code

250* [Claude Academy](https://academy.claude.com/): cursos gratuitos no seu próprio ritmo, incluindo [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action)

250* [Um harness para cada tarefa](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): como o time Claude Code usa [fluxos de trabalho dinâmicos](/docs/pt/workflows) para orquestrar subagentes em escala251* [Um harness para cada tarefa](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): como o time Claude Code usa [fluxos de trabalho dinâmicos](/docs/pt/workflows) para orquestrar subagentes em escala

251* [Configurações](/docs/pt/settings): personalize Claude Code para seu fluxo de trabalho252* [Configurações](/docs/pt/settings): personalize Claude Code para seu fluxo de trabalho

252* [Troubleshooting](/docs/pt/troubleshooting): soluções para problemas comuns253* [Troubleshooting](/docs/pt/troubleshooting): soluções para problemas comuns

permission-modes.md +115 −100

Details

267 267

268Quando o plano estiver pronto, Claude o apresenta e pergunta como proceder. A partir desse prompt você pode escolher:268Quando o plano estiver pronto, Claude o apresenta e pergunta como proceder. A partir desse prompt você pode escolher:

269 269

270* **Sim, e usar modo automático**: aprove e inicie em [modo automático](#eliminate-prompts-with-auto-mode). Quando o modo automático não está disponível, esta opção lê **Sim, auto-aceitar edições**. Se você iniciou a sessão com permissões de bypass habilitadas, a opção lê **Sim, e alternar para BYPASS PERMISSIONS (sem prompts adicionais) para esta sessão** em vez disso.270* **Sim, e usar modo automático**: aprove e inicie em [modo automático](#eliminate-prompts-with-auto-mode). Se o modo automático não está [disponível para sua sessão](#eliminate-prompts-with-auto-mode), por exemplo porque sua organização o desativou, esta opção lê **Sim, auto-aceitar edições**. Se você iniciou a sessão com permissões de bypass habilitadas, a opção lê **Sim, e alternar para BYPASS PERMISSIONS (sem prompts adicionais) para esta sessão** em vez disso.

271* **Sim, aprovar edições manualmente**: aprove e revise cada edição individualmente.271* **Sim, aprovar edições manualmente**: aprove e revise cada edição individualmente.

272* **Não, continuar planejando**: permaneça no modo plan e diga a Claude o que alterar.272* **Não, continuar planejando**: permaneça no modo plan e diga a Claude o que alterar.

273 273

287 Elimine prompts de permissão com modo automático287 Elimine prompts de permissão com modo automático

288</h2>288</h2>

289 289

290O modo automático permite que Claude execute sem prompts de permissão rotineiros. Um modelo classificador separado revisa 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. [Regras de solicitação](/docs/pt/permissions#manage-permissions) explícitas ainda forçam um prompt.290O 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.

291 291

292Nos planos Pro, Max e Team, o modo automático é o [modo de permissão inicial integrado](#which-mode-a-session-starts-in).292Nos planos Pro, Max e Team, o modo automático é o [modo de permissão inicial integrado](#which-mode-a-session-starts-in).

293 293

294O classificador também revisa cada mensagem que Claude envia para outro agente com [`SendMessage`](/docs/pt/tools-reference), seja texto simples ou uma mensagem estruturada de [equipe de agentes](/docs/pt/agent-teams), antes de Claude Code entregá-la, tanto em modo automático quanto em [modo plan enquanto o classificador revisa comandos](#analyze-before-you-edit-with-plan-mode); a revisão de envio requer Claude Code v2.1.222 ou posterior.294O classificador também revisa cada mensagem que Claude envia para outro agente com [`SendMessage`](/docs/pt/tools-reference), seja texto simples ou uma mensagem estruturada de [equipe de agentes](/docs/pt/agent-teams), antes que Claude Code a entregue, tanto no modo automático quanto no [modo de plano enquanto o classificador revisa comandos](#analyze-before-you-edit-with-plan-mode); a revisão de envio requer Claude Code v2.1.222 ou posterior.

295 295

296O classificador também revisa e aprova ou bloqueia remoções `rm` e `rmdir` direcionadas a um [caminho crítico](#critical-paths), como `rm -rf /` e `rm -rf ~`, incluindo quando a remoção está dentro de substituição de comando ou processo.296O classificador também revisa e aprova ou bloqueia remoções `rm` e `rmdir` direcionadas a um [caminho crítico](#critical-paths), como `rm -rf /` e `rm -rf ~`, inclusive quando a remoção está dentro de substituição de comando ou processo.

297 297

298O 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 comportamento autônomo mais forte em um modo que ainda o solicita, defina o [estilo de saída Proativo](/docs/pt/output-styles) em vez disso.298O modo automático também incentiva Claude a continuar trabalhando sem parar para fazer perguntas de esclarecimento, embora Claude ainda pergunte quando sua solicitação ou uma skill depende explicitamente disso. Para um comportamento mais autônomo em um modo que ainda o solicita, defina o [estilo de saída Proativo](/docs/pt/output-styles).

299 299

300<Warning>300<Warning>

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

304O modo automático está disponível apenas quando sua conta atende a todos esses requisitos:304O modo automático está disponível apenas quando sua conta atende a todos esses requisitos:

305 305

306* **Plano**: Todos os planos.306* **Plano**: Todos os planos.

307* **Organização**: em Team e Enterprise, o modo automático está disponível por padrão. Administradores podem desativá-lo para a organização definindo `permissions.disableAutoMode` como `"disable"` em [configurações gerenciadas](/docs/pt/managed-settings).307* **Organização**: no Team e Enterprise, o modo automático está disponível por padrão. Os administradores podem desativá-lo para a organização definindo `permissions.disableAutoMode` como `"disable"` em [configurações gerenciadas](/docs/pt/managed-settings).

308* **Modelo**: na API Anthropic e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Claude Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou um [modelo Fable](/docs/pt/model-config#work-with-fable). No Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas, apenas Claude Sonnet 5, Opus 4.7 ou posterior, e os modelos Fable. Modelos mais antigos, incluindo Sonnet 4.5, Opus 4.5, Haiku e modelos claude-3, não são suportados em nenhum provedor.308* **Modelo**: na API Anthropic e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Claude Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou um [modelo Fable](/docs/pt/model-config#work-with-fable). No Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry e em sessões [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) conectadas, apenas Claude Sonnet 5, Opus 4.7 ou posterior e os modelos Fable. Modelos mais antigos, incluindo Sonnet 4.5, Opus 4.5, Haiku e modelos claude-3, não são suportados em nenhum provedor.

309* **Provedor**: disponível por padrão na API Anthropic, Claude Platform on AWS, Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões gateway de aplicativos Claude conectadas.309* **Provedor**: disponível por padrão na API Anthropic, Claude Platform on AWS, Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e sessões gateway de aplicativos Claude conectadas.

310 310

311Se Claude Code relatar o modo automático como indisponível, primeiro verifique esses requisitos e se algum arquivo de configurações define [`disableAutoMode`](/docs/pt/settings-reference#disableautomode). Anthropic também pode ter desativado o modo automático no lado do servidor, ou o servidor pode ter rejeitado o modo automático para sua conta. Uma sessão que recebeu uma resposta mantém o modo automático desativado até que a sessão termine, então inicie uma nova sessão depois.311Se Claude Code relatar o modo automático como indisponível, primeiro verifique esses requisitos e se algum arquivo de configurações define [`disableAutoMode`](/docs/pt/settings-reference#disableautomode). A Anthropic também pode ter desativado o modo automático no servidor, ou o servidor pode ter rejeitado o modo automático para sua conta. Uma sessão que recebeu qualquer uma das respostas mantém o modo automático desativado até o final da sessão, portanto, inicie uma nova sessão depois.

312 312

313Uma mensagem separada que nomeia um modelo e diz que o modo automático "não consegue determinar a segurança" de uma ação significa que uma solicitação do classificador falhou. Essa falha é geralmente transitória, mas no Amazon Bedrock pode se repetir até que sua conta possa invocar o modelo nomeado. Veja a [referência de erros](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action) para as causas e o que fazer.313Uma mensagem separada que nomeia um modelo e diz que o modo automático "não pode determinar a segurança" de uma ação significa que uma solicitação do classificador falhou. Essa falha geralmente é transitória, mas no Amazon Bedrock pode se repetir até que sua conta possa invocar o modelo nomeado. Consulte a [referência de erros](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action) para as causas e o que fazer.

314 314

315Se você definir `defaultMode: "auto"` em [configurações](/docs/pt/settings-reference#all-settings) e uma sessão de terminal inicia no modo Manual sem erro, a configuração provavelmente está em `.claude/settings.json` ou `.claude/settings.local.json`. `auto` não entra em vigor desses arquivos. Mova-o para `~/.claude/settings.json`. Para uma conversa que a extensão VS Code iniciou, verifique a lista própria da extensão em [Alternar modos de permissão](#switch-permission-modes) em vez disso.315Se você definir `defaultMode: "auto"` em [configurações](/docs/pt/settings-reference#all-settings) e uma sessão de terminal iniciar no modo Manual sem erro, a configuração provavelmente está em `.claude/settings.json` ou `.claude/settings.local.json`. `auto` não entra em vigor nesses arquivos. Mova-o para `~/.claude/settings.json`. Para uma conversa que a extensão VS Code iniciou, verifique a lista própria da extensão em [Alternar modos de permissão](#switch-permission-modes).

316 316

317<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">317<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

318 Modo automático em Bedrock, Agent Platform ou Foundry318 Modo automático no Bedrock, Agent Platform ou Foundry

319</h3>319</h3>

320 320

321Em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e sessões [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 de permissão em que uma sessão inicia: nesses provedores, sessões de terminal iniciam em seu [`defaultMode`](/docs/pt/settings-reference#permissions-defaultmode), que é Manual a menos que você o altere, e conversas na [extensão VS Code](/docs/pt/vs-code) iniciam em Manual a menos que `claudeCode.initialPermissionMode` ou um modo que você escolheu na extensão defina um. Apenas Claude Sonnet 5, Opus 4.7 ou posterior, e os modelos Fable são suportados nesses provedores.321No [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e sessões [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 altera o modo de permissão em que uma sessão inicia: nesses provedores, sessões de terminal iniciam em seu [`defaultMode`](/docs/pt/settings-reference#permissions-defaultmode), que é Manual a menos que você o altere, e conversas na [extensão VS Code](/docs/pt/vs-code) iniciam em Manual a menos que `claudeCode.initialPermissionMode` ou um modo que você escolheu na extensão defina um. Apenas Claude Sonnet 5, Opus 4.7 ou posterior e os modelos Fable são suportados nesses provedores.

322 322

323Para tornar o modo automático o modo de permissão inicial padrão, defina `"permissions": {"defaultMode": "auto"}` em configurações de usuário ou gerenciadas. Em sessões que a extensão VS Code inicia, selecione **Auto** no indicador de modo em vez disso. [Alternar modos de permissão](#switch-permission-modes) cobre o que supera essa escolha.323Para tornar o modo automático o modo de permissão inicial padrão, defina `"permissions": {"defaultMode": "auto"}` em configurações de usuário ou gerenciadas. Em sessões que a extensão VS Code inicia, selecione **Auto** no indicador de modo. [Alternar modos de permissão](#switch-permission-modes) cobre o que supera essa escolha.

324 324

325O checkup [`/doctor`](/docs/pt/commands#all-commands) propõe este padrão de configurações de usuário nesses provedores da mesma forma que faz na API Anthropic.325O checkup [`/doctor`](/docs/pt/commands#all-commands) propõe esse padrão de configurações de usuário nesses provedores da mesma forma que faz na API Anthropic.

326 326

327Para impedir que desenvolvedores usem o modo automático, defina `disableAutoMode` como `"disable"` em [configurações gerenciadas](/docs/pt/managed-settings). Isso remove `auto` do ciclo `Shift+Tab`, e uma sessão iniciada com `--permission-mode auto` inicia em Manual em vez disso. Uma sessão já em execução no modo automático o deixa quando a configuração chega a essa sessão de uma [fonte implantada por administrador](/docs/pt/managed-settings#which-managed-source-claude-code-uses), e mostra `auto mode disabled by settings`. Antes de v2.1.251, uma sessão em execução mantinha o modo automático até que terminasse.327Para impedir que desenvolvedores usem o modo automático, defina `disableAutoMode` como `"disable"` em [configurações gerenciadas](/docs/pt/managed-settings). Isso remove `auto` do ciclo `Shift+Tab`, e uma sessão iniciada com `--permission-mode auto` inicia em Manual. Uma sessão já em execução no modo automático o deixa quando a configuração chega a essa sessão de uma [fonte implantada por administrador](/docs/pt/managed-settings#which-managed-source-claude-code-uses) e mostra `auto mode disabled by settings`. Antes da v2.1.251, uma sessão em execução mantinha o modo automático até o final.

328 328

329Em 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.329Na v2.1.158 até v2.1.206, o modo automático estava desativado nesses provedores até você definir `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 da v2.1.207.

330 330

331<h3 id="server-side-classifier-review">331<h3 id="server-side-classifier-review">

332 Revisão do classificador no lado do servidor332 Revisão do classificador no servidor

333</h3>333</h3>

334 334

335Em planos Enterprise e em contas que usam a API Claude, em [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry, e sempre que você aponta `ANTHROPIC_BASE_URL` para um [gateway LLM ou proxy](/docs/pt/llm-gateway), Claude Code em modo automático pede ao servidor para revisar [as ações que vão para o classificador](#how-the-classifier-evaluates-actions) como parte das solicitações do modelo da sessão. Onde o servidor as revisa, seus veredictos decidem essas ações. Onde não revisa, tipicamente porque um gateway LLM ou proxy interfere no tráfego, ou porque a plataforma, região ou credencial ainda não tem verificações no lado do servidor, Claude Code volta para suas próprias solicitações do classificador, e uma vez que esse fallback se mantém pelo resto da sessão, mostra um [aviso sobre cobranças de solicitações do classificador](/docs/pt/auto-mode-classifier-billing) em contas onde essas solicitações são cobradas. Para pular pedir ao servidor e sempre usar as próprias solicitações do classificador do Claude Code, defina [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/pt/env-vars). A variável não é lida em uma conexão direta com a API Anthropic. Se você definir `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e deixar `CLAUDE_CODE_AUTO_MODE_SERVER` indefinido, Claude Code também para de pedir ao servidor.335Em planos Enterprise e contas que usam a API Claude, no [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry, e sempre que você aponta `ANTHROPIC_BASE_URL` para um [gateway LLM ou proxy](/docs/pt/llm-gateway), Claude Code no modo automático pede ao servidor para revisar [as ações que vão para o classificador](#how-the-classifier-evaluates-actions) como parte das solicitações de modelo da sessão. Onde o servidor as revisa, seus vereditos decidem essas ações. Onde não revisa, na maioria das vezes porque um gateway LLM ou proxy interfere no tráfego, ou porque a plataforma, região ou credencial ainda não tem verificações no servidor, Claude Code volta para suas próprias solicitações do classificador, e uma vez que esse fallback se mantém pelo resto da sessão, mostra um [aviso sobre cobranças de solicitação do classificador](/docs/pt/auto-mode-classifier-billing) em contas onde essas solicitações são cobradas. Para pular a solicitação ao servidor e sempre usar as próprias solicitações do classificador de Claude Code, defina [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/pt/env-vars). A variável não é lida em uma conexão direta com a API Anthropic. Se você definir `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e deixar `CLAUDE_CODE_AUTO_MODE_SERVER` indefinido, Claude Code também para de solicitar ao servidor.

336 336

337Pedir ao servidor por padrão requer Claude Code v2.1.278 ou posterior.337Solicitar ao servidor por padrão requer Claude Code v2.1.278 ou posterior.

338 338

339<h3 id="what-the-classifier-blocks-by-default">339<h3 id="what-the-classifier-blocks-by-default">

340 O que o classificador bloqueia por padrão340 O que o classificador bloqueia por padrão

341</h3>341</h3>

342 342

343O 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.343O classificador confia em seu diretório de trabalho e nos remotos que foram configurados para ele quando a sessão iniciou. Um remoto adicionado ou redirecionado durante a sessão com `git remote add` ou `git remote set-url` não é confiável, e tudo o mais é tratado como externo até você [configurar infraestrutura confiável](/docs/pt/auto-mode-config). Antes da v2.1.200, remotos adicionados no meio da sessão também eram confiáveis.

344 344

345**Bloqueado por padrão**:345**Bloqueado por padrão**:

346 346

347* Download e execução de código, como `curl | bash`347* Baixar e executar código, como `curl | bash`

348* Envio de dados sensíveis para endpoints externos348* Enviar dados sensíveis para endpoints externos

349* Implantações e migrações de produção349* Implantações e migrações de produção

350* Exclusão em massa no armazenamento em nuvem350* Exclusão em massa no armazenamento em nuvem

351* Concessão de permissões de IAM ou repositório351* Concessão de permissões IAM ou repositório

352* Modificação de infraestrutura compartilhada352* Modificação de infraestrutura compartilhada

353* Destruição irreversível de arquivos que existiam antes da sessão353* Destruição irreversível de arquivos que existiam antes da sessão

354* Force push354* Force push

355* Committing ou pushing uma mudança que enviaria segredos ou dados sensíveis fora do repositório quando é executada, ou ampliaria o que um deploy expõe. Isso cobre um workflow de CI ou configuração de deploy que passa um segredo para um destino que não o recebe, um script ou etapa de configuração que lê um armazenamento de segredos e envia os dados, e uma mudança de configuração que amplia o que um deploy publica, como um registro, visibilidade, artefato ou configuração de sourcemap. A verificação se aplica em qualquer branch, se aplica mesmo quando o repositório é público, e dispara quando a mudança chega, independentemente de isso disparar o pipeline; limpá-la requer nomear o efeito de execução, não apenas o commit ou push. Antes de v2.1.211, essa verificação era escopo para o branch padrão em vez disso: um push lá era bloqueado quando carregava conteúdo sensível, mudanças ocultadas ou mal descritas em relação ao que você pediu, conteúdo portado de fora do repositório ou roteado em torno de uma revisão que você pediu355* Fazer commit ou fazer push de uma alteração que enviaria segredos ou dados sensíveis para fora do repositório quando executado, ou ampliar o que uma implantação expõe. Isso cobre um fluxo de trabalho CI ou configuração de implantação que passa um segredo para um destino que ainda não o recebe, um script ou etapa de configuração que lê um armazenamento de segredos e envia os dados para fora, e uma alteração de configuração que amplia o que uma implantação publica, como um registro, visibilidade, artefato ou configuração de sourcemap. A verificação se aplica em qualquer branch, se aplica mesmo quando o repositório é público e dispara quando a alteração é feita commit ou push, independentemente de esse commit ou push disparar o pipeline; limpá-la requer nomear o efeito de execução, não apenas o commit ou push. Antes da v2.1.211, essa verificação era limitada ao branch padrão: um push lá era bloqueado quando carregava conteúdo sensível, alterações encobertas ou mal descritas em relação ao que você pediu, conteúdo portado de fora do repositório ou roteado em torno de uma revisão que você pediu

356* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` ou `git stash clear`, que o classificador presume descartaria mudanças não confirmadas356* `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

357* `git commit --amend` quando o commit no HEAD não foi criado nesta sessão357* `git commit --amend` quando o commit no HEAD não foi criado nesta sessão

358* 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ão358* A partir da v2.1.198, `git commit --amend` quando o commit no HEAD já foi feito push. 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

359* `terraform destroy`, `pulumi destroy`, `cdk destroy` ou `terragrunt destroy`, e aplicação de um plano que destrói recursos359* `terraform destroy`, `pulumi destroy`, `cdk destroy` ou `terragrunt destroy`, e aplicar um plano que destrói recursos

360 360

361Claude 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.361Claude 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 IaC protegidos, que você pode restringir a nomes concretos.

362 362

363* Escrita em um gerenciador de segredos, ou alteração de registros DNS ou certificados TLS363* Escrever em um gerenciador de segredos, ou alterar registros DNS ou certificados TLS

364* 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 CI364* Mesclar uma solicitação de pull que nenhum humano aprovou, aprovar a própria solicitação de pull de Claude ou desabilitar verificações CI

365* Postagem de um comentário que é em si um comando para automação, como `atlantis apply` ou `/deploy` ou `/merge` de um bot365* Postar um comentário que é em si um comando para automação, como `atlantis apply` ou `/deploy` ou `/merge` de um bot

366* Alternância, aumento gradual ou exclusão de um sinalizador de recurso de produção366* Alternar, ramificar ou excluir um sinalizador de recurso de produção

367* Aplicação de mudanças de infraestrutura a um escopo de IaC protegido, ou drenagem e remoção de nós de cluster367* Aplicar alterações de infraestrutura a um escopo IaC protegido, ou drenar e remover nós de cluster

368* Gravações em um cluster de computação compartilhado que vão além do recurso que você nomeou, como um seletor de rótulo ou `--all` que captura trabalhos de outros usuários368* Gravações em um cluster de computação compartilhado que vão além do recurso que você nomeou, como um seletor de rótulo ou `--all` que captura trabalhos de outros usuários

369* Criação de recursos Kubernetes que executam em cada nó ou interceptam tráfego de cluster, como DaemonSets e webhooks de admissão369* Criar recursos Kubernetes que executam em cada nó ou interceptam tráfego de cluster, como DaemonSets e webhooks de admissão

370* Shells interativos ou port-forwards em um destino remoto sensível370* Shells interativos ou port-forwards para um destino remoto sensível

371* Abertura de um túnel ou shell reverso que torna um serviço local acessível da internet pública371* Abrir um túnel ou shell reverso que torna um serviço local acessível da internet pública

372* Impressão de uma credencial ou token ao vivo na transcrição ou em um arquivo372* Imprimir uma credencial ou token ao vivo na transcrição ou em um arquivo

373* 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 exclui373* Acessar um local listado como local de dados sensíveis em seu [ambiente](/docs/pt/auto-mode-config#define-trusted-infrastructure), ou copiar dados de um. A partir da v2.1.198, isso também bloqueia enviar dados de um para um público que a entrada exclui

374* 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 ambiente374* Rotear uma instalação de pacote em torno de seu registro de pacotes interno para um registro público. A partir da 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

375* Execução de um comando com um sinalizador que desativa uma proteção de segurança, como `--insecure`375* Executar um comando com um sinalizador que desativa uma proteção de segurança, como `--insecure`

376* 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`376* Iniciar 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 da v2.1.198, isso também cobre executar 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`

377* Ações do [Claude no Chrome](/docs/pt/chrome) que poderiam enviar conteúdo da página, cookies ou credenciais fora da origem377* Ações do [Claude no Chrome](/docs/pt/chrome) que poderiam enviar conteúdo da página, cookies ou credenciais fora da origem

378 378

379Claude Code v2.1.198 e posterior também bloqueiam estes por padrão:379Claude Code v2.1.198 e posterior também bloqueiam estes por padrão:

380 380

381* 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ífico381* Excluir 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

382* 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 posterior382* Incluir 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 emails 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 email, 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

383* 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ão383* Enviar pressionamentos de tecla para o próprio painel tmux de Claude Code para conduzir sua própria interface, que o classificador trata como Claude alterando suas próprias permissões ou supervisão

384 384

385Claude Code v2.1.200 e posterior também bloqueiam estes por padrão:385Claude Code v2.1.200 e posterior também bloqueiam estes por padrão:

386 386

387* Comentário, exclusão ou aprovação forçada de um teste ou asserção que protege comportamento de segurança, como autenticação, controle de acesso, validação de entrada ou sandboxing387* Comentar, excluir ou forçar a aprovação de um teste ou asserção que protege comportamento de segurança, como autenticação, controle de acesso, validação de entrada ou sandboxing

388* 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 recurso388* Excluir ou desmontar 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

389* 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`389* Redirecionar uma URL de base de API, endpoint de proxy, receptor de webhook ou espelho de registro para um host de terceiros que não se encaixa na tarefa, inclusive em arquivos de exemplo como `.env.example`

390* 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 remote390* Alterar para onde os pushes vão com `git remote set-url` ou `git remote add`, a menos que você tenha nomeado o novo remoto

391* 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 disso391* Fazer push de segredos ou dados pessoais ou confiados para um repositório conhecido como público, ou fazer push 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 da 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

392* 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 externo392* Abrir uma solicitação de pull contra um repositório ou organização diferente, fazer fork com `gh repo fork` ou fazer push para um repositório de terceiros, a menos que você tenha nomeado esse alvo externo

393 393

394Claude Code v2.1.203 e posterior também bloqueiam estes por padrão:394Claude Code v2.1.203 e posterior também bloqueiam estes por padrão:

395 395

396* Conteúdo de um armazenamento local sensível, ou de um arquivo cujo nome, caminho ou tipo o marca como sensível, entrando em um commit, um push, texto de PR ou issue, um gist ou paste, ou um package publish, a menos que você tenha nomeado tanto a origem quanto o destino. Transcrições de sessão e logs de conversa, pastas com ponto de credenciais e configuração, como chaves SSH, credenciais em nuvem, perfis de navegador e histórico de shell, e exportações de dados do usuário contam, e o repositório ser privado não o limpa396* Conteúdo de um armazenamento local sensível, ou de um arquivo cujo nome, caminho ou tipo o marca como sensível, entrando em um commit, um push, texto de PR ou issue, um gist ou paste, ou uma publicação de pacote, a menos que você tenha nomeado tanto a origem quanto o destino. Transcrições de sessão e logs de conversa, pastas de ponto de credencial e configuração como chaves SSH, credenciais em nuvem, perfis de navegador e histórico de shell, e exportações de dados de usuário contam, e o repositório ser privado não o limpa

397 397

398Claude Code v2.1.205 e posterior também bloqueiam estes por padrão:398Claude Code v2.1.205 e posterior também bloqueiam estes por padrão:

399 399

400* Escrita em transcrições de sessão do Claude Code, os arquivos de histórico `.jsonl` sob `~/.claude/projects/` ou seu diretório de configuração configurado, seja diretamente ou através de um comando de shell. A regra também cobre as linhas de metadados que Claude Code acrescenta a cada entrada de transcrição para suas próprias verificações. Ler uma transcrição não é bloqueado400* Escrever em transcrições de sessão de Claude Code, os arquivos de histórico `.jsonl` em `~/.claude/projects/` ou seu diretório de configuração configurado, seja diretamente ou através de um comando de shell. A regra também cobre as linhas de metadados que Claude Code acrescenta a cada entrada de transcrição para suas próprias verificações. Ler uma transcrição não é bloqueado

401* Uma exclusão forçada recursiva, como `rm -rf "$VAR"` ou `Remove-Item -Recurse -Force $dir` cujo alvo é uma variável de shell, ou um glob enraizado em uma, que não é atribuído em nenhum lugar na conversa que o classificador vê. O valor veio apenas da saída de comando anterior, que o classificador nunca recebe, então o classificador não consegue verificar o alvo de exclusão contra as outras regras de exclusão. O bloqueio é limpo quando você nomeia o caminho exato sendo deletado, ou quando Claude re-executa a exclusão com o caminho literal resolvido escrito no comando. Exclusões cujo alvo o classificador consegue resolver não são afetadas. Alvos `Remove-Item` que são um `*` nu ou terminam em `/*` ou `\*` nunca chegam ao classificador: Claude Code [nega-os imediatamente](#remove-item-in-powershell)401* Uma exclusão forçada recursiva como `rm -rf "$VAR"` ou `Remove-Item -Recurse -Force $dir` cujo alvo é uma variável de shell, ou um glob enraizado em uma, que não é atribuído em nenhum lugar na conversa que o classificador vê. O valor veio apenas da saída de comando anterior, que o classificador nunca recebe, portanto o classificador não pode verificar o alvo de exclusão contra as outras regras de exclusão. O bloqueio se limpa quando você nomeia o caminho exato sendo excluído, ou quando Claude re-executa a exclusão com o caminho literal resolvido escrito no comando. Exclusões cujo alvo o classificador pode resolver não são afetadas. Alvos `Remove-Item` que são um `*` simples ou terminam em `/*` ou `\*` nunca chegam ao classificador: Claude Code [nega-os imediatamente](#remove-item-in-powershell)

402 402

403Claude Code v2.1.257 e posterior também bloqueiam estes por padrão:403Claude Code v2.1.257 e posterior também bloqueiam estes por padrão:

404 404

405* Solicitação de credenciais do endpoint de metadados da instância em nuvem, como `169.254.169.254`, ou autenticação explícita de uma chamada de nuvem, cluster ou registro com a identidade de conta de serviço ou nó da máquina405* Solicitar credenciais do endpoint de metadados da instância em nuvem, como `169.254.169.254`, ou autenticar explicitamente uma chamada de nuvem, cluster ou registro com a identidade de conta de serviço ou nó da máquina

406* Alcance de um host público por uma rota diferente de uma solicitação direta, como um túnel, um shell reverso ou uma configuração de resolver ou proxy reescrita para apontar para fora406* Alcançar um host público por uma rota diferente de uma solicitação direta, como um túnel, um shell reverso, ou uma configuração de resolvedor ou proxy reescrita para apontar para fora

407* Leitura de credenciais que pertencem ao host em vez de à sua tarefa, como certificados de nó ou auth de registro de contêiner do nó407* Ler credenciais que pertencem ao host em vez de à sua tarefa, como certificados de nó ou auth de registro de contêiner do nó

408* Conexão ou varredura de contêineres, pods ou VMs irmãos que Claude não iniciou, ou o nó sob o contêiner408* Conectar a ou escanear contêineres, pods ou VMs irmãos que Claude não iniciou, ou o nó sob o contêiner

409 409

410Se Claude Code é executado em algum lugar que se destina a permitir um destes, descreva essa configuração em uma entrada [Host containment](/docs/pt/auto-mode-config#define-trusted-infrastructure) em `autoMode.environment`.410Se Claude Code executar em algum lugar que se destine a permitir um desses, descreva essa configuração em uma entrada [Host containment](/docs/pt/auto-mode-config#define-trusted-infrastructure) em `autoMode.environment`.

411 411

412Claude Code v2.1.261 e posterior também bloqueiam estes por padrão:412Claude Code v2.1.261 e posterior também bloqueiam estes por padrão:

413 413

414* Postagem ou escrita de um link para um serviço público de paste, diagrama ou compartilhamento de dados em uma mensagem, texto de PR ou issue, um documento ou em qualquer outro lugar onde o link será aberto ou buscado, quando a própria URL carrega o conteúdo sendo compartilhado, a menos que você tenha nomeado esse serviço414* Postar ou escrever um link para um serviço público de paste, diagrama ou compartilhamento de dados em uma mensagem, texto de PR ou issue, um documento, ou em qualquer outro lugar onde o link será aberto ou buscado, quando a própria URL carrega o conteúdo sendo compartilhado, a menos que você tenha nomeado esse serviço

415 415

416**Permitido por padrão**:416**Permitido por padrão**:

417 417

419* Instalação de dependências declaradas em seus arquivos de lock ou manifestos419* Instalação de dependências declaradas em seus arquivos de lock ou manifestos

420* Leitura de `.env` e envio de credenciais para sua API correspondente420* Leitura de `.env` e envio de credenciais para sua API correspondente

421* Solicitações HTTP somente leitura421* Solicitações HTTP somente leitura

422* Pushing para qualquer branch do repositório em que você está trabalhando, incluindo o branch padrão. Um branch não padrão cujo nome o marca como um destino de deploy ou publicação, como `production` ou `gh-pages`, não é coberto: o classificador julga um push lá em seus próprios termos. O conteúdo do push ainda é verificado contra as outras regras, [regras `permissions.deny`](/docs/pt/permissions#manage-permissions) ainda podem bloquear comandos push [conforme escrito](/docs/pt/permissions#bash-rule-limits) em todos os modos, e a proteção de branch do próprio remote ainda se aplica. Antes de v2.1.211, apenas pushes para o branch em que você começou, branches que Claude criou e pushes rotineiros para o branch padrão eram permitidos por padrão, e antes de v2.1.203 qualquer push direto para o branch padrão era bloqueado422* Fazer push para qualquer branch do repositório em que você está trabalhando, incluindo o branch padrão. Um branch não padrão cujo nome o marca como alvo de implantação ou publicação, como `production` ou `gh-pages`, não é coberto: o classificador julga um push lá em seus próprios termos. O conteúdo do push ainda é verificado contra as outras regras, regras [`permissions.deny`](/docs/pt/permissions#manage-permissions) ainda podem bloquear comandos push [conforme escrito](/docs/pt/permissions#bash-rule-limits) em todos os modos, e a proteção de branch própria do remoto ainda se aplica. Antes da v2.1.211, apenas pushes para o branch em que você iniciou, branches que Claude criou e pushes rotineiros para o branch padrão eram permitidos por padrão, e antes da v2.1.203 qualquer push direto para o branch padrão era bloqueado

423 423

424Claude Code v2.1.195 e posterior também permitem estes por padrão:424Claude Code v2.1.195 e posterior também permitem estes por padrão:

425 425

426* Exclusão dos trabalhos exatos que Claude criou anteriormente na mesma sessão426* Excluir os trabalhos exatos que Claude criou anteriormente na mesma sessão

427* Leitura, revisão ou escrita de código, configs e modelos de ameaça relacionados à segurança como parte de sua tarefa427* Ler, revisar ou escrever código relacionado à segurança, configs e modelos de ameaça como parte de sua tarefa

428* Mensagens entre agentes trabalhando juntos na mesma sessão multi-agente428* Mensagens entre agentes trabalhando juntos na mesma sessão multi-agente

429* 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 infraestrutura429* Enviar 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

430* [Claude no Chrome](/docs/pt/chrome) navegação para um domínio interno confiável, localhost ou uma URL que você nomeou430* [Claude no Chrome](/docs/pt/chrome) navegação para um domínio interno confiável, localhost ou uma URL que você nomeou

431 431

432Comandos em sandbox não obtêm acesso à rede por padrão. Claude nomeia os hosts que um comando precisa no próprio comando, o classificador os revisa com o comando, e uma lista aprovada abre esses hosts apenas para esse comando. [Domínios permitidos por comando](/docs/pt/sandboxing#per-command-allowed-domains-in-auto-mode) cobre o que uma lista pode e não pode abrir e o que acontece quando um comando tenta acessar um host não listado.432Comandos em sandbox não obtêm acesso à rede por padrão. Claude nomeia os hosts que um comando precisa no próprio comando, o classificador os revisa com o comando, e uma lista aprovada abre esses hosts apenas para esse comando. [Domínios permitidos por comando](/docs/pt/sandboxing#per-command-allowed-domains-in-auto-mode) cobre o que uma lista pode e não pode abrir e o que acontece quando um comando alcança um host não listado.

433 433

434Execute `claude auto-mode defaults` para imprimir as listas de regras completas como JSON. Se ações rotineiras forem bloqueadas, um administrador pode adicionar repos, buckets e serviços confiáveis via configuração `autoMode.environment`: veja [Configurar modo automático](/docs/pt/auto-mode-config).434Execute `claude auto-mode defaults` para imprimir as listas de regras completas como JSON. Se ações rotineiras forem bloqueadas, um administrador pode adicionar repositórios, buckets e serviços confiáveis via configuração `autoMode.environment`: consulte [Configurar modo automático](/docs/pt/auto-mode-config).

435 435

436Pushing para qualquer branch do repositório em que você está trabalhando e criando uma pull request que corresponde à sua solicitação são executados sem um prompt, a menos que o push ou pull request caia sob a [lista bloqueada](#what-the-classifier-blocks-by-default), como segredos ou dados sensíveis deixando o repositório, ou uma pull request que tenha como alvo um repositório ou organização diferente. Para exigir um checkpoint humano antes dessas ações enquanto permanece em modo automático, adicione regras `permissions.ask`, que correspondem ao comando [conforme escrito](/docs/pt/permissions#bash-rule-limits): veja [Limites comuns](/docs/pt/auto-mode-config#common-boundaries).436Fazer push para qualquer branch do repositório em que você está trabalhando e criar uma solicitação de pull que corresponda à sua solicitação executam sem um prompt, a menos que o push ou solicitação de pull se enquadre na [lista bloqueada](#what-the-classifier-blocks-by-default), como segredos ou dados sensíveis saindo do repositório, ou uma solicitação de pull que tenha como alvo um repositório ou organização diferente. Para exigir um checkpoint humano antes desses comandos enquanto permanece no modo automático, adicione regras `permissions.ask`, que correspondem ao comando [conforme escrito](/docs/pt/permissions#bash-rule-limits): consulte [Limites comuns](/docs/pt/auto-mode-config#common-boundaries).

437 437

438<h3 id="first-read-outside-the-working-directories">438<h3 id="first-read-outside-the-working-directories">

439 A primeira leitura fora dos diretórios de trabalho439 A primeira leitura fora dos diretórios de trabalho

440</h3>440</h3>

441 441

442Enquanto [`permissions.blockReadsOutsideWorkingDirectories`](/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) está desativado, leituras de arquivo são executadas sem um prompt em modo automático, incluindo leituras fora dos [diretórios de trabalho](/docs/pt/permissions#working-directories). A primeira vez que Claude usa a ferramenta Read, Grep ou Glob em um caminho fora deles, Claude Code pergunta se você quer continuar permitindo essas leituras.442Enquanto [`permissions.blockReadsOutsideWorkingDirectories`](/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) está desativado, leituras de arquivo executam sem um prompt no modo automático, incluindo leituras fora dos [diretórios de trabalho](/docs/pt/permissions#working-directories). A primeira vez que Claude usa a ferramenta Read, Grep ou Glob em um caminho fora deles, Claude Code pergunta se você deseja continuar permitindo essas leituras.

443 443

444O prompt não aparece em execuções não-interativas `-p` ou sessões em segundo plano; leituras lá são executadas como antes.444O prompt não aparece em execuções `-p` não interativas ou sessões em segundo plano; leituras lá executam como antes.

445 445

446Qualquer que seja sua resposta, Claude continua trabalhando:446Qualquer que seja sua resposta, Claude continua trabalhando:

447 447

448* **Continuar permitindo**: a leitura é executada, leituras posteriores fora dos diretórios de trabalho são executadas como antes, e Claude Code registra sua resposta para que o prompt não apareça novamente448* **Continuar permitindo**: a leitura é executada, leituras posteriores fora dos diretórios de trabalho executam como antes, e Claude Code registra sua resposta para que o prompt não apareça novamente

449* **Bloquear a partir de agora**: a leitura é recusada, e Claude Code define [`permissions.blockReadsOutsideWorkingDirectories`](/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) como `true` em suas configurações de usuário, o que faz as ferramentas de arquivo recusarem tais leituras em cada sessão posterior e cada modo de permissão. Para deixar Claude ler tal caminho depois, adicione seu diretório com `/add-dir` ou remova a configuração.449* **Bloquear a partir de agora**: a leitura é recusada, e Claude Code define [`permissions.blockReadsOutsideWorkingDirectories`](/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) como `true` em suas configurações de usuário, o que faz as ferramentas de arquivo recusarem essas leituras em todas as sessões posteriores e em todos os modos de permissão. Para deixar Claude ler esse caminho depois, adicione seu diretório com `/add-dir` ou remova a configuração.

450* **Pergunte novamente na próxima vez**: a leitura é recusada, e a próxima leitura fora dos diretórios de trabalho solicita novamente450* **Perguntar novamente na próxima vez**: a leitura é recusada, e a próxima leitura fora dos diretórios de trabalho solicita novamente

451 451

452<h3 id="boundaries-you-state-in-conversation">452<h3 id="boundaries-you-state-in-conversation">

453 Limites que você declara na conversa453 Limites que você declara na conversa

454</h3>454</h3>

455 455

456O 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.456O classificador trata limites que você declara na conversa como um sinal de bloqueio. Se você disser a Claude "não faça push" ou "aguarde até eu revisar antes de implantar", o classificador bloqueia ações correspondentes mesmo quando as regras padrão as permitiriam. Um limite permanece em vigor até você levantá-lo em uma mensagem posterior. O próprio julgamento de Claude de que uma condição foi atendida não o levanta.

457 457

458Os 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.458Limites não são armazenados como regras. O classificador os relê da transcrição em cada verificação, portanto um limite pode ser perdido se [compactação de contexto](/docs/pt/costs#reduce-token-usage) remover a mensagem que o declarou. Para uma garantia firme, adicione uma [regra de negação](/docs/pt/permissions#permission-rule-syntax).

459

460<h3 id="approvals-you-state-in-conversation">

461 Aprovações que você declara na conversa

462</h3>

463

464Se você disser a Claude que uma ação bloqueada é permitida, o classificador lê isso como sua aprovação e pode limpar o bloqueio. Como você o expressou decide se a ação é executada e até onde a aprovação chega:

465

466* **Nomeie a ação e seus detalhes**: sua mensagem tem que nomear a ação e a coisa específica que a torna perigosa, como o branch de um force push. Nomear apenas o verbo não limpa nada, portanto "você pode fazer force-push" deixa o bloqueio em vigor.

467* **Espere que cubra uma ação**: uma aprovação cobre a ação destrutiva que você nomeou, portanto uma ação posterior é bloqueada novamente a menos que você tenha concedido a aprovação como permanente. Para parar de aprovar um padrão rotineiro uma ação por vez, adicione-o a [`autoMode.allow`](/docs/pt/auto-mode-config#override-the-block-and-allow-rules).

468* **Alguns bloqueios permanecem em vigor**: [a ordem de precedência do classificador](/docs/pt/auto-mode-config#override-the-block-and-allow-rules) estabelece quais bloqueios sua aprovação pode alcançar. Para executar uma etapa que não limpará, [saia do modo automático](#switch-permission-modes) e responda ao prompt de permissão.

459 469

460<h3 id="when-auto-mode-falls-back">470<h3 id="when-auto-mode-falls-back">

461 Quando o modo automático volta471 Quando o modo automático volta

462</h3>472</h3>

463 473

464Quando o modo automático não consegue aprovar as ações de sua sessão, o que acontece depende do caso:474Quando o modo automático não pode aprovar as ações de sua sessão, o que acontece depende do caso:

465 475

466* **Uma ação bloqueada**: Claude Code mostra uma notificação e lista a ação em `/permissions` sob a aba **Recently denied**, onde você pode pressionar `r` para tentar novamente com uma aprovação manual. Quando o classificador produz [nenhum veredicto na ação](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action), porque uma verificação de segurança separada do modo automático recusou a solicitação do classificador ou sua resposta não foi analisada, Claude Code nega a ação sem a notificação ou a entrada **Recently denied**.476* **Uma ação bloqueada**: Claude Code mostra uma notificação e lista a ação em `/permissions` na aba **Recently denied**, onde você pode pressionar `r` para tentar novamente com uma aprovação manual. Quando o classificador produz [nenhum veredito sobre a ação](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action), porque uma verificação de segurança separada do modo automático recusou a própria solicitação do classificador ou sua resposta não foi analisada, Claude Code nega a ação sem a notificação ou a entrada **Recently denied**.

467* **Bloqueios repetidos**: se 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. Claude Code não conta uma negação para nenhum limite quando [uma verificação de segurança separada do modo automático recusa a solicitação do classificador](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action); a entrada vinculada cobre como Claude Code lida com essas negações.477* **Bloqueios repetidos**: se o classificador bloqueia uma ação 3 vezes seguidas ou 20 vezes no total, o modo automático pausa e Claude Code retoma a solicitação. 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. Claude Code não conta uma negação para nenhum limite quando [uma verificação de segurança separada do modo automático recusa a solicitação do classificador](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action); a entrada vinculada cobre como Claude Code lida com essas negações.

468* **Sessões que não conseguem solicitar**: uma execução não-interativa `-p` sem um [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) não tem um prompt para voltar. Quando bloqueios repetidos atingem um limite, a ação não é executada e Claude continua trabalhando. O mesmo se aplica quando [uma verificação de segurança separada do modo automático recusa a solicitação do classificador](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code não para a execução em nenhum caso.478* **Sessões que não podem solicitar**: uma execução `-p` [não interativa](/docs/pt/headless) sem um [`--permission-prompt-tool`](/docs/pt/cli-reference#cli-flags) não tem prompt para voltar. Quando bloqueios repetidos atingem um limite, a ação não é executada e Claude continua trabalhando. O mesmo se aplica quando [uma verificação de segurança separada do modo automático recusa a solicitação do classificador](/docs/pt/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code não para a execução em nenhum dos casos.

469* **Uma mudança de modo durante uma verificação**: se você alternar modos de permissão enquanto uma verificação do classificador está pendente, Claude Code descarta um veredicto que o novo modo não teria solicitado em vez de aplicá-lo: você é solicitado para aprovação em vez disso, ou a ação é auto-negada no modo [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).479* **Uma mudança de modo durante uma verificação**: se você alternar modos de permissão enquanto uma verificação do classificador está pendente, Claude Code descarta um veredito que o novo modo não teria solicitado em vez de aplicá-lo: você é solicitado para aprovação, ou a ação é auto-negada no [modo `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).

470 480

471Bloqueios 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).481Bloqueios 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).

472 482

476 <Accordion title="Como o classificador avalia ações">486 <Accordion title="Como o classificador avalia ações">

477 Cada ação passa por uma ordem de decisão fixa. O primeiro passo correspondente vence:487 Cada ação passa por uma ordem de decisão fixa. O primeiro passo correspondente vence:

478 488

479 1. Ações correspondentes a suas [regras de permissão, solicitação ou negação](/docs/pt/permissions#manage-permissions) resolvem imediatamente, com estas exceções:489 1. Ações que correspondem a suas [regras de permitir, solicitar ou negar](/docs/pt/permissions#manage-permissions) resolvem imediatamente, com essas exceções:

480 * Gravações em [caminhos protegidos](#protected-paths) são roteadas para o classificador mesmo quando uma regra de permissão corresponde, e assim como remoções `rm` e `rmdir` direcionadas a um [caminho crítico](#critical-paths) em Claude Code v2.1.218 e posterior490 * Gravações em [caminhos protegidos](#protected-paths) são roteadas para o classificador mesmo quando uma regra de permissão corresponde, e assim são remoções `rm` e `rmdir` direcionadas a um [caminho crítico](#critical-paths) em Claude Code v2.1.218 e posterior

481 * Ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) o solicitam diretamente mesmo quando uma regra de permissão corresponde, e assim como ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) em sessões onde essa configuração chega a Claude Code491 * Ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) o solicitam diretamente mesmo quando uma regra de permissão corresponde, e assim fazem ferramentas de conector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) em sessões onde essa configuração chega a Claude Code

482 * Um comando shell que carrega [domínios permitidos por comando](/docs/pt/sandboxing#per-command-allowed-domains-in-auto-mode) também é roteado para o classificador mesmo quando uma regra de permissão corresponde, porque uma regra aprova o comando, não seus hosts492 * Um comando de shell que carrega [domínios permitidos por comando](/docs/pt/sandboxing#per-command-allowed-domains-in-auto-mode) também é roteado para o classificador mesmo quando uma regra de permissão corresponde, porque uma regra aprova o comando, não seus hosts

483 * Regras de solicitação que correspondem no conteúdo de um comando, como `Bash(git push *)`, voltam para um prompt de permissão493 * Regras de solicitação que correspondem no conteúdo de um comando, como `Bash(git push *)`, voltam para um prompt de permissão

484 2. Ações somente leitura e edições de arquivo em seu diretório de trabalho são auto-aprovadas, exceto gravações em [caminhos protegidos](#protected-paths) e [a primeira leitura fora dos diretórios de trabalho](#first-read-outside-the-working-directories), que o solicita494 2. Ações somente leitura e edições de arquivo em seu diretório de trabalho são auto-aprovadas, exceto gravações em [caminhos protegidos](#protected-paths) e [a primeira leitura fora dos diretórios de trabalho](#first-read-outside-the-working-directories), que o solicita

485 3. Tudo mais vai para o classificador. As ferramentas de conector e ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) que o solicitam diretamente na etapa 1 nunca chegam ao classificador, então uma aprovação exigida pela organização nem uma etapa de consentimento é auto-aprovada495 3. Tudo o mais vai para o classificador. As ferramentas de conector e ferramentas MCP `requiresUserInteraction` que o solicitam diretamente na etapa 1 nunca chegam ao classificador, portanto nem uma aprovação exigida pela organização nem uma etapa de consentimento é auto-aprovada

486 4. Se o classificador bloquear, Claude recebe o motivo e tenta uma alternativa. Na maioria das sessões o motivo nomeia a regra que o classificador correspondeu, como `[Data Exfiltration]`, em vez de dar uma explicação escrita; veja [Revisar negações](/docs/pt/auto-mode-config#review-denials)496 4. Se o classificador bloqueia, Claude recebe o motivo e tenta uma alternativa. Na maioria das sessões o motivo nomeia a regra que o classificador correspondeu, como `[Data Exfiltration]`, em vez de dar uma explicação escrita; consulte [Revisar negações](/docs/pt/auto-mode-config#review-denials)

487 497

488 Ao entrar no modo automático, regras de permissão amplas que concedem execução de código arbitrária são descartadas:498 Ao entrar no modo automático, regras de permissão amplas que concedem execução de código arbitrária são descartadas:

489 499

491 * Intérpretes com wildcard como `Bash(python*)`501 * Intérpretes com wildcard como `Bash(python*)`

492 * Comandos de execução do gerenciador de pacotes502 * Comandos de execução do gerenciador de pacotes

493 * Regras de permissão `Agent`503 * Regras de permissão `Agent`

494 * [`Monitor`](/docs/pt/tools-reference#monitor-tool) regras de permissão, porque Claude Code executa comandos Monitor através do shell504 * Regras de permissão [`Monitor`](/docs/pt/tools-reference#monitor-tool), porque Claude Code executa comandos Monitor através do shell

495 505

496 Regras estreitas como `Bash(npm test)` permanecem em vigor. Claude Code restaura as regras descartadas quando você sai do modo automático. Antes de v2.1.236, Claude Code deixou regras de permissão `Monitor` em vigor no modo automático, então uma regra que correspondia à ferramenta inteira aprovava comandos Monitor sem revisão do classificador.506 Regras estreitas como `Bash(npm test)` permanecem em vigor. Claude Code restaura as regras descartadas quando você sai do modo automático. Antes da v2.1.236, Claude Code deixava regras de permissão `Monitor` em vigor no modo automático, portanto uma regra que correspondesse à ferramenta inteira aprovava comandos Monitor sem revisão do classificador.

497 507

498 Claude Code também executa `git status` ele mesmo antes de um comando que descartaria trabalho não confirmado, como `git reset --hard` ou `rm -rf`, e mostra ao classificador se há trabalho preparado, modificado ou não rastreado presente. Claude Code relata arquivos não rastreados nessa verificação mesmo quando a configuração git do repositório define `status.showUntrackedFiles=no`.508 Claude Code também executa `git status` em si antes de um comando que descartaria trabalho não confirmado, como `git reset --hard` ou `rm -rf`, e mostra ao classificador se há trabalho preparado, modificado ou não rastreado presente. Claude Code relata arquivos não rastreados nessa verificação mesmo quando a configuração git do repositório define `status.showUntrackedFiles=no`.

499 509

500 Nas solicitações do classificador enviadas por Claude Code, o classificador vê mensagens de usuário, chamadas de ferramenta diferentes de lookups somente leitura como leituras de arquivo e pesquisas, e seu conteúdo CLAUDE.md. Os resultados da ferramenta são removidos, então conteúdo hostil em um arquivo ou página da web não consegue manipular o classificador diretamente.510 Nas solicitações do classificador enviadas pelo próprio Claude Code, o classificador vê mensagens de usuário, chamadas de ferramenta diferentes de buscas somente leitura como leituras de arquivo e buscas, e seu conteúdo CLAUDE.md. Resultados de ferramenta são removidos dessas solicitações, portanto conteúdo hostil em um arquivo ou página da web não pode manipular o classificador diretamente.

501 511

502 Você pode anotar o resultado de uma chamada com um campo [`classifierContext`](/docs/pt/hooks#annotate-a-result-for-the-auto-mode-classifier) do hook PostToolUse, que o classificador lê como contexto fornecido pela aplicação. O campo requer Claude Code v2.1.236 ou posterior.512 Você pode anotar o resultado de uma chamada com um campo [`classifierContext`](/docs/pt/hooks#annotate-a-result-for-the-auto-mode-classifier) do hook PostToolUse, que o classificador lê como contexto fornecido pela aplicação. O campo requer Claude Code v2.1.236 ou posterior.

503 513

504 Uma sonda separada no lado do servidor verifica os resultados da ferramenta recebidos e sinaliza conteúdo suspeito antes que Claude o leia. Para mais sobre como essas camadas funcionam juntas, veja o [anúncio do modo automático](https://claude.com/blog/auto-mode) e o [aprofundamento de engenharia](https://www.anthropic.com/engineering/claude-code-auto-mode).514 Uma sonda separada no servidor escaneia resultados de ferramenta recebidos e sinaliza conteúdo suspeito antes de Claude lê-lo. Para mais sobre como essas camadas funcionam juntas, consulte o [anúncio do modo automático](https://claude.com/blog/auto-mode) e o [aprofundamento de engenharia](https://www.anthropic.com/engineering/claude-code-auto-mode).

505 </Accordion>515 </Accordion>

506 516

507 <Accordion title="Como o modo automático lida com subagentes">517 <Accordion title="Como o modo automático lida com subagentos">

508 O classificador verifica o trabalho do [subagente](/docs/pt/sub-agents) em três pontos:518 O classificador verifica o trabalho de [subagentos](/docs/pt/sub-agents) em três pontos:

509 519

510 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.520 1. Antes de um subagentos iniciar, a descrição da tarefa delegada é avaliada, portanto uma tarefa com aparência perigosa é bloqueada no tempo de spawn.

511 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.521 2. Enquanto o subagentos 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 subagentos é ignorado.

512 3. Quando o subagente termina, o classificador revisa seu trabalho e seu relatório final antes que o pai leia o relatório. Quando o classificador sinaliza o trabalho ou relatório do subagente, ou uma verificação de segurança de API separada recusa a revisão, o relatório ainda é entregue, precedido por um aviso de segurança. Quando o classificador não está disponível para a revisão, o relatório chega com uma nota para verificar o trabalho do subagente antes de agir com base nele.522 3. Quando o subagentos termina, o classificador revisa seu trabalho e seu relatório final antes que o pai leia o relatório. Quando o classificador sinaliza o trabalho ou relatório do subagentos, ou uma verificação de segurança de API separada recusa a revisão, o relatório ainda é entregue, precedido por um aviso de segurança. Quando o classificador não está disponível para a revisão, o relatório chega com uma nota para verificar o trabalho do subagentos antes de agir com base nele.

~~513~~

514 A etapa 1 requer Claude Code v2.1.178 ou posterior. Versões anteriores aplicavam o classificador nas etapas 2 e 3, mas não avaliavam a descrição da tarefa antes do subagente começar.

515 </Accordion>523 </Accordion>

516 524

517 <Accordion title="Custo e latência">525 <Accordion title="Custo e latência">

518 O classificador é executado em Claude Sonnet 5 por padrão em vez de em sua seleção `/model`. Um modelo de classificador que Anthropic configura no lado do servidor tem precedência sobre esse padrão. Quando o modelo de sua sessão é Claude Sonnet 4.6, ou quando [`availableModels`](/docs/pt/model-config#restrict-model-selection) exclui Sonnet 5, o classificador é executado no modelo de sua sessão em vez disso, ou em um modelo Opus quando a sessão é executada em um [modelo Fable](/docs/pt/model-config#work-with-fable); em provedores diferentes da API Anthropic, esse fallback Opus é o modelo Opus padrão do provedor.526 O classificador executa em Claude Sonnet 5 por padrão em vez de em sua seleção `/model`. Um modelo classificador que Anthropic configura no servidor tem precedência sobre esse padrão. Quando o modelo de sua sessão é Claude Sonnet 4.6, ou quando [`availableModels`](/docs/pt/model-config#restrict-model-selection) exclui Sonnet 5, o classificador executa no modelo de sua sessão, ou em um modelo Opus quando a sessão executa em um [modelo Fable](/docs/pt/model-config#work-with-fable); em provedores diferentes da API Anthropic, esse fallback Opus é o modelo Opus padrão do provedor.

519 527

520 A primeira solicitação de modo automático da sessão valida o padrão Sonnet 5: se a solicitação for bem-sucedida, Sonnet 5 permanece o modelo de classificador da sessão, e se falhar porque o modelo não está disponível, a sessão usa o fallback em vez disso. Depois que essa validação se resolve, o modelo do classificador não muda para a sessão.528 A primeira solicitação de modo automático da sessão valida o padrão Sonnet 5: se a solicitação for bem-sucedida, Sonnet 5 permanece o modelo classificador da sessão, e se falhar porque o modelo não está disponível, a sessão usa o fallback. Depois que essa validação se resolve, o modelo do classificador não muda para a sessão.

521 529

522 Em planos Enterprise e em contas que usam a API Claude, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry, chamadas do classificador contam para seu uso de token. Cada verificação envia uma porção da transcrição mais a ação pendente, adicionando uma volta antes da execução. Leituras e edições de diretório de trabalho fora de caminhos protegidos pulam o classificador, então a sobrecarga vem principalmente de comandos shell e operações de rede. Onde o servidor revisa as ações como parte das solicitações do modelo da sessão, não há solicitações separadas do classificador para contar; veja [Revisão do classificador no lado do servidor](#server-side-classifier-review).530 Em planos Enterprise e em contas que usam a API Claude, [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry, chamadas do classificador contam para seu uso de token. Cada verificação envia uma porção da transcrição mais a ação pendente, adicionando uma volta antes da execução. Leituras e edições de diretório de trabalho fora de caminhos protegidos pulam o classificador, portanto a sobrecarga vem principalmente de comandos de shell e operações de rede. Onde o servidor revisa as ações como parte das solicitações de modelo da sessão, não há chamadas de classificador separadas para contar; consulte [Revisão do classificador no servidor](#server-side-classifier-review).

523 531

524 O acesso à rede em sandbox não adiciona solicitações do classificador por conexão. O classificador julga [os hosts que um comando nomeia](/docs/pt/sandboxing#per-command-allowed-domains-in-auto-mode) junto com o comando em uma revisão, e Claude Code verifica cada conexão contra a lista aprovada sem chamar o classificador novamente.532 O acesso à rede em sandbox não adiciona solicitações de classificador por conexão. O classificador julga [os hosts que um comando nomeia](/docs/pt/sandboxing#per-command-allowed-domains-in-auto-mode) junto com o comando em uma revisão, e Claude Code verifica cada conexão contra a lista aprovada sem chamar o classificador novamente.

525 </Accordion>533 </Accordion>

526</AccordionGroup>534</AccordionGroup>

527 535

662 670

663Claude Code também trata um glob ou barra à direita diretamente sob uma variável de shell, como `rm -rf "$DIR"/*`, como uma remoção de caminho crítico, porque o comando se torna uma remoção da raiz do sistema de arquivos quando a variável está vazia.671Claude Code também trata um glob ou barra à direita diretamente sob uma variável de shell, como `rm -rf "$DIR"/*`, como uma remoção de caminho crítico, porque o comando se torna uma remoção da raiz do sistema de arquivos quando a variável está vazia.

664 672

673O prompt para este caso de variável nomeia o `rm` sinalizado e diz como reescrevê-lo para que a verificação passe:

674

675* Para uma variável como `$DIR`, proteja cada expansão para que o shell pare com um erro quando a variável não estiver definida ou vazia, como em `rm -rf "${DIR:?}"/*`, ou use um caminho literal

676* Para uma variável que normalmente está definida, como `$HOME`, use um caminho literal

677

678Uma remoção cujas expansões estão todas protegidas dessa forma não é uma remoção de caminho crítico, então em modo `bypassPermissions` ela é executada sem um prompt.

679

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

666 681

667<h3 id="remove-item-in-powershell">682<h3 id="remove-item-in-powershell">

permissions.md +14 −20

Details

26 26

27Antes da v2.1.211, Claude Code sempre salvava a regra no diretório inicial, então uma aprovação concedida em uma worktree ou subdiretório não se aplicava ao resto do repositório. Regras que versões anteriores salvaram em um subdiretório ou worktree ainda se aplicam a sessões iniciadas lá.27Antes da v2.1.211, Claude Code sempre salvava a regra no diretório inicial, então uma aprovação concedida em uma worktree ou subdiretório não se aplicava ao resto do repositório. Regras que versões anteriores salvaram em um subdiretório ou worktree ainda se aplicam a sessões iniciadas lá.

28 28

29Às vezes um prompt de permissão oferece apenas uma aprovação única, sem opção de "não pergunte novamente" e sem opção de permitir a ação pelo resto da sessão. Claude Code oferece essas opções apenas quando o prompt pode mostrar a você tudo o que elas permitiriam, então uma regra que você salva de um prompt cobre apenas o que sua opção nomeada.29Às vezes um prompt de permissão oferece apenas uma aprovação única, sem opção de "não pergunte novamente" e sem opção de permitir a ação pelo resto da sessão. Claude Code oferece essas opções apenas quando o prompt pode mostrar a você tudo o que elas permitiriam, então uma regra que você salva de um prompt cobre apenas o que sua opção nomeada. Quando um prompt oferece apenas a aprovação única, aprove a ação uma vez, ou adicione a regra você mesmo em [`/permissions`](#manage-permissions).

31Quando o diretório em que você iniciou Claude Code é o que torna o rótulo da opção muito longo, Claude Code o encurta no rótulo, substituindo seu diretório inicial por `~` e depois o final do caminho por `…`, e mantém a opção. Você ainda salva a mesma regra. Claude Code deixa as opções de fora em três casos:

~~33* **Comando ou edição:** muito grande para mostrar na íntegra.~~

~~34* **Comandos ou caminhos que a regra cobriria:** o rótulo não pode caber em todos eles.~~

~~35* **Diretório inicial muito longo, não encurtado:** contém caracteres que Claude Code não pode exibir com segurança, ou mesmo seu início não cabe.~~

~~37Aprove a ação uma vez, ou adicione a regra você mesmo em [`/permissions`](#manage-permissions).~~

38 30

39<h3 id="add-a-comment-when-you-answer-a-permission-prompt">31<h3 id="add-a-comment-when-you-answer-a-permission-prompt">

40 Adicione um comentário quando você responder a um prompt de permissão32 Adicione um comentário quando você responder a um prompt de permissão

224 216

225As regras de permissão aceitam globs de nome de ferramenta apenas após um prefixo literal `mcp__<server>__`. O segmento do servidor deve estar livre de glob para que a regra nomeie um servidor específico que você configurou. `mcp__puppeteer__*` corresponde a todas as ferramentas do servidor `puppeteer`, e `mcp__github__get_*` corresponde às suas ferramentas `get_`. Um glob de permissão desancorado como `"*"`, `"B*"` ou `"mcp__*"` é ignorado com um aviso e não aprova automaticamente nada.217As regras de permissão aceitam globs de nome de ferramenta apenas após um prefixo literal `mcp__<server>__`. O segmento do servidor deve estar livre de glob para que a regra nomeie um servidor específico que você configurou. `mcp__puppeteer__*` corresponde a todas as ferramentas do servidor `puppeteer`, e `mcp__github__get_*` corresponde às suas ferramentas `get_`. Um glob de permissão desancorado como `"*"`, `"B*"` ou `"mcp__*"` é ignorado com um aviso e não aprova automaticamente nada.

226 218

227Uma 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.219Uma 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, e também estão os nomes de ferramentas que Claude Code removeu, como `TaskOutput`.

228 220

229O 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) não correspondem ao rótulo, 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).221O 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) não correspondem ao rótulo, 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).

230 222

517}509}

518```510```

519 511

520Quando você pede a Claude para fazer fetch de uma página, ele faz fetch sem um prompt. Quando você pede a ele para executar um `curl` [em sandbox](/docs/pt/sandboxing) contra um host fora da lista de permissões do sandbox, Claude Code ainda solicita você para esse host, ou em [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) envia a solicitação para o classificador, porque a regra simples não adicionou o host à lista de permissões.512Quando você pede a Claude para fazer fetch de uma página, ele faz fetch sem um prompt. Quando você pede a ele para executar um `curl` [em sandbox](/docs/pt/sandboxing) contra um host fora da lista de permissões do sandbox, Claude Code ainda solicita você para esse host, porque a regra simples não adicionou o host à lista de permissões.

513

514Em [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), Claude em vez disso nomeia o host no [domínios permitidos por comando](/docs/pt/sandboxing#per-command-allowed-domains-in-auto-mode) do comando para o classificador revisar.

521 515

522<h3 id="mcp">516<h3 id="mcp">

523 MCP517 MCP

656 650

657Permissões e [sandboxing](/docs/pt/sandboxing) são camadas de segurança complementares:651Permissões e [sandboxing](/docs/pt/sandboxing) são camadas de segurança complementares:

658 652

659* **Permissões** controlam quais ferramentas Claude Code pode usar e quais arquivos ou domínios pode acessar. Elas se aplicam a Bash, Read, Edit, WebFetch, MCP e todas as outras ferramentas, exceto que uma regra deny ou ask não pode bloquear [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) enquanto qualquer outra ferramenta permanecer.653* **Permissões** controlam quais ferramentas o Claude Code pode usar e quais arquivos ou domínios ele pode acessar. Elas se aplicam a Bash, Read, Edit, WebFetch, MCP e todas as outras ferramentas, exceto que uma regra de negação ou pergunta não pode bloquear [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) enquanto qualquer outra ferramenta permanecer.

660* **Sandboxing** fornece imposição em nível de SO que restringe o acesso do Bash, PowerShell e comandos [Monitor](/docs/pt/tools-reference#monitor-tool) e seus processos filhos à rede e sistema de arquivos. Aplica-se apenas a comandos Bash, PowerShell e [Monitor](/docs/pt/tools-reference#monitor-tool) e seus processos filhos.654* **Sandboxing** fornece imposição em nível do SO que restringe o acesso ao sistema de arquivos e rede dos comandos shell. Aplica-se apenas a comandos Bash, PowerShell e [Monitor](/docs/pt/tools-reference#monitor-tool) e seus processos filhos.

661 655

662Use ambos para defesa em profundidade, já que as restrições de sandbox ainda se aplicam mesmo se uma injeção de prompt contornar a tomada de decisão de Claude. Caminhos e domínios das configurações de sandbox e regras de permissão são [mesclados na configuração final de sandbox](/docs/pt/sandboxing#permission-rules).656Use ambos para defesa em profundidade, já que as restrições de sandbox ainda se aplicam mesmo se uma injeção de prompt contornar a tomada de decisão do Claude. Caminhos e domínios tanto das configurações de sandbox quanto das regras de permissão são [mesclados na configuração final de sandbox](/docs/pt/sandboxing#permission-rules).

663 657

664Quando você ativa sandboxing e deixa `autoAllowBashIfSandboxed` em seu padrão de `true`, 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.658Quando você ativa sandboxing e deixa `autoAllowBashIfSandboxed` em seu padrão de `true`, comandos Bash em sandbox são executados sem solicitação mesmo se suas permissões incluem uma regra de pergunta simples `Bash`, ou a [forma equivalente `Bash(*)`](#match-all-uses-of-a-tool): o limite de sandbox substitui esse prompt de ferramenta inteira.

665 659

666Em [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), Claude Code pula essa substituição. Sem uma regra ask, os [comandos somente leitura integrados](#read-only-commands) ainda são executados sem solicitar, e qualquer outro comando shell passa pelo fluxo de permissão regular enquanto você ainda está planejando; veja [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) para como Claude Code controla comandos lá. Com uma regra ask simples `Bash`, cada comando Bash solicita, incluindo comandos somente leitura em sandbox, o mesmo que fora do sandboxing. Antes da v2.1.212, a substituição se aplicava em plan mode também.660Em [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), o Claude Code pula essa substituição. Sem uma regra de pergunta, os [comandos somente leitura integrados](#read-only-commands) ainda são executados sem solicitação, e qualquer outro comando shell passa pelo fluxo de permissão regular enquanto você ainda está planejando; veja [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) para como o Claude Code controla comandos lá. Com uma regra de pergunta simples `Bash`, cada comando Bash solicita, incluindo comandos somente leitura em sandbox, o mesmo que fora do sandboxing. Antes da v2.1.212, a substituição também se aplicava em plan mode.

667 661

668Estas verificações ainda se aplicam:662Essas verificações ainda se aplicam:

669 663

670* Regras ask com escopo de conteúdo como `Bash(git push *)` ainda forçam um prompt664* Regras de pergunta com escopo de conteúdo como `Bash(git push *)` ainda forçam uma solicitação

671* Regras deny explícitas ainda se aplicam665* Regras de negação explícitas ainda se aplicam

672* Comandos `rm` ou `rmdir` que visam um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda passam pelo fluxo de permissão regular666* Comandos `rm` ou `rmdir` que visam um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda passam pelo fluxo de permissão regular

673 667

674Comandos 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.668Comandos que não serão executados em sandbox, como comandos excluídos, respeitam a regra de pergunta simples `Bash` como de costume. Veja [sandbox modes](/docs/pt/sandboxing#sandbox-modes) para alterar esse comportamento.

675 669

676<span id="managed-only-settings" />670<span id="managed-only-settings" />

677 671

plugin-evals.md +3 −1

Details

339 Conceda ferramentas339 Conceda ferramentas

340</h3>340</h3>

341 341

342As execuções nunca param para pedir permissão. Ferramentas integradas que precisam de uma concessão que você não deu, como `Bash`, `Write`, `Edit`, `WebFetch` e `WebSearch`, são removidas da sessão, então Claude não pode chamá-las. A lista de permissões é as ferramentas somente leitura que o caso lista em `allowed_tools`, de `Read`, `Glob`, `Grep`, `NotebookRead`, `Skill`, `Agent`, `TodoWrite` e as ferramentas de tarefa `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate`, `TaskStop` e `TaskOutput`, mais o que você conceder com `--allow-tools`, que se aplica a cada caso na execução. Para deixar casos usar `Bash`, `Write`, `Edit`, `WebFetch` ou `WebSearch`, conceda-os você mesmo:342As execuções nunca param para pedir permissão. Ferramentas integradas que precisam de uma concessão que você não deu, como `Bash`, `Write`, `Edit`, `WebFetch` e `WebSearch`, são removidas da sessão, então Claude não pode chamá-las.

343

344A lista de permissões é as ferramentas somente leitura que o caso lista em `allowed_tools`, de `Read`, `Glob`, `Grep`, `NotebookRead`, `Skill`, `Agent`, `TodoWrite` e as ferramentas de tarefa `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate` e `TaskStop`, mais o que você conceder com `--allow-tools`. Essa concessão se aplica a cada caso na execução. Para deixar casos usar `Bash`, `Write`, `Edit`, `WebFetch` ou `WebSearch`, conceda-os você mesmo:

343 345

344```bash theme={null}346```bash theme={null}

345claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"347claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"

plugins-reference.md +86 −36

Details

71Prompt de sistema detalhado para o agent descrevendo seu papel, expertise e comportamento.71Prompt de sistema detalhado para o agent descrevendo seu papel, expertise e comportamento.

72```72```

73 73

74Plugin agents suportam campos frontmatter `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background`, [`omitClaudeMd`](/docs/pt/sub-agents#supported-frontmatter-fields) e `isolation`. O único valor válido de `isolation` é `"worktree"`.74<h4 id="plugin-agent-frontmatter">

75 Frontmatter de agent de plugin

76</h4>

78Um arquivo de agent de plugin usa os mesmos [campos frontmatter que um arquivo de subagent](/docs/pt/sub-agents#supported-frontmatter-fields), exceto que Claude Code honra apenas alguns deles quando o agent vem de um plugin:

80* **Suportados**: `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background`, `omitClaudeMd`, `isolation`, `color` e `experimental`. O único valor válido de `isolation` é `"worktree"`.

81* **Não suportados, por razões de segurança**: `hooks`, `mcpServers` e `permissionMode`. Claude Code ignora estes quando carrega um agent de um plugin. Para usá-los, copie o arquivo de agent para `.claude/agents/` ou `~/.claude/agents/`.

82* **Não suportados**: `initialPrompt`.

75 83

~~76Por razões de segurança, agents fornecidos por plugin não suportam `hooks`, `mcpServers` ou `permissionMode`.~~84Você pode colocar arquivos de agent de plugin em subpastas de `agents/`. Claude Code [os carrega recursivamente](/docs/pt/sub-agents#choose-the-subagent-scope) e une o nome do plugin, cada nome de subpasta e o nome do arquivo com dois-pontos para formar o nome com escopo do agent. Por exemplo, `agents/review/security.md` em um plugin chamado `my-plugin` carrega como `my-plugin:review:security`. Duas configurações mudam esse nome:

86* Frontmatter `name`: ele substitui apenas o nome do arquivo, então `name: audit` em `agents/review/security.md` carrega como `my-plugin:review:audit`

87* Campo manifest [`agents`](#component-path-fields): um arquivo que você lista lá carrega sem nomes de subpasta, então `"agents": "./custom/review/security.md"` carrega como `my-plugin:security`

77 88

78Claude Code carrega um agent de plugin mesmo quando seu frontmatter não tem `name` ou não faz parse:89Claude Code carrega um agent de plugin mesmo quando seu frontmatter não tem `name` ou não faz parse:

79 90

527| :----- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------- |538| :----- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------- |

528| `name` | string | Identificador único em kebab-case, sem espaços, caracteres de controle ou caracteres de formatação bidirecional. Quando uma [entrada de marketplace](/docs/pt/plugin-marketplaces#plugin-entries) lista o plugin com um nome diferente, o nome da entrada de marketplace é o que `enabledPlugins` e `/plugin` usam | `"deployment-tools"` |539| `name` | string | Identificador único em kebab-case, sem espaços, caracteres de controle ou caracteres de formatação bidirecional. Quando uma [entrada de marketplace](/docs/pt/plugin-marketplaces#plugin-entries) lista o plugin com um nome diferente, o nome da entrada de marketplace é o que `enabledPlugins` e `/plugin` usam | `"deployment-tools"` |

529 540

530Este nome é usado para namespacing de componentes. Por exemplo, na interface do usuário, o agente `agent-creator` para o plugin com nome `plugin-dev` aparecerá como `plugin-dev:agent-creator`.541Este nome é usado para namespacing de componentes. Por exemplo, na UI, o agente `agent-creator` para o plugin com nome `plugin-dev` aparecerá como `plugin-dev:agent-creator`.

531 542

532<h3 id="unrecognized-fields">543<h3 id="unrecognized-fields">

533 Campos não reconhecidos544 Campos não reconhecidos

534</h3>545</h3>

535 546

536Claude Code ignora campos de nível superior que não reconhece. Você pode manter metadados de outro ecossistema em `plugin.json` e o plugin ainda carrega. Isso torna prático manter um manifesto que funciona como manifesto de extensão VS Code ou Cursor, um `package.json` npm, ou um manifesto de bundle MCPB/DXT.547Claude Code ignora campos de nível superior que não reconhece. Você pode manter metadados de outro ecossistema em `plugin.json` e o plugin ainda carrega. Isso torna prático manter um manifesto que funciona como um manifesto de extensão VS Code ou Cursor, um `package.json` npm, ou um manifesto de bundle MCPB/DXT.

537 548

538`claude plugin validate` relata campos não reconhecidos como avisos, não erros. Se um campo está um ou dois caracteres diferente de um reconhecido, o aviso sugere o nome provavelmente pretendido. Um plugin com apenas avisos de campos não reconhecidos ainda passa na validação e carrega em tempo de execução.549`claude plugin validate` relata campos não reconhecidos como avisos, não erros. Se um campo está um ou dois caracteres diferente de um reconhecido, o aviso sugere o nome provavelmente pretendido. Um plugin com apenas avisos de campo não reconhecido ainda passa na validação e carrega em tempo de execução.

539 550

540Como Claude Code lida com um campo reconhecido cujo valor tem o tipo errado depende do campo:551Como Claude Code lida com um campo reconhecido cujo valor tem o tipo errado depende do campo:

541 552

542* **Maioria dos campos**: o plugin falha ao carregar. Por exemplo, um valor `keywords` que é uma string em vez de um array é um erro de carregamento, e `claude plugin validate` o relata como tal.553* **Maioria dos campos**: o plugin falha ao carregar. Por exemplo, um valor `keywords` que é uma string em vez de um array é um erro de carregamento, e `claude plugin validate` o relata como tal.

543* **`experimental` e `metadata`**: Claude Code ignora um valor não-objeto, e `claude plugin validate` relata um aviso.554* **`experimental` e `metadata`**: Claude Code ignora um valor não-objeto, e `claude plugin validate` relata um aviso.

544 555

545Passe `--strict` para tratar avisos como erros. Use-o em CI para detectar um nome de campo digitado incorretamente ou um campo deixado de outra ferramenta de manifesto antes de publicar, mesmo que o plugin carregasse em tempo de execução.556Passe `--strict` para tratar avisos como erros. Use em CI para detectar um nome de campo digitado incorretamente ou um campo deixado de outra ferramenta de manifesto antes de publicar, mesmo que o plugin carregasse em tempo de execução.

546 557

547```bash theme={null}558```bash theme={null}

548claude plugin validate ./my-plugin --strict559claude plugin validate ./my-plugin --strict

553</h3>564</h3>

554 565

556| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------- |567| :--------------- | :------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

558| `displayName` | string | Nome legível por humanos mostrado no seletor `/plugin` e outras superfícies de interface do usuário. Para um plugin instalado a partir de um marketplace, um `displayName` na [entrada de marketplace](/docs/pt/plugin-marketplaces#optional-plugin-fields) tem precedência sobre este valor. Quando nenhum nome de exibição é definido em nenhum dos dois lugares, os usuários veem `name`. Ao contrário de `name`, pode conter espaços e qualquer capitalização. Não é usado para namespacing ou busca. | `"Deployment Tools"` |569| `displayName` | string | Nome legível por humanos mostrado no seletor `/plugin` e outras superfícies de UI. Para um plugin instalado do marketplace, um `displayName` na [entrada de marketplace](/docs/pt/plugin-marketplaces#optional-plugin-fields) tem precedência sobre este valor. Quando nenhum nome de exibição é definido em nenhum lugar, os usuários veem `name`. Ao contrário de `name`, pode conter espaços e qualquer capitalização. Não é usado para namespacing ou lookup. | `"Deployment Tools"` |

559| `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, exceto para uma [`command` source](/docs/pt/plugin-marketplaces#command-sources) ou um plugin [carregado no local](#plugin-caching-and-file-resolution); veja [Gerenciamento de versão](#version-management). Se também definido na entrada de marketplace, `plugin.json` vence. Se omitido, a versão vem da próxima fonte em [Gerenciamento de versão](#version-management). | `"2.1.0"` |570| `version` | string | Opcional. Versão semântica. Definir isso fixa o plugin nessa string de versão, então os usuários só recebem atualizações quando você a incrementa, exceto para uma [`command` source](/docs/pt/plugin-marketplaces#command-sources) ou um plugin [carregado no local](#plugin-caching-and-file-resolution); veja [Gerenciamento de versão](#version-management). Se também definido na entrada de marketplace, `plugin.json` vence. Se omitido, a versão vem da próxima fonte em [Gerenciamento de versão](#version-management). | `"2.1.0"` |

561| `author` | object | Informações do autor | `{"name": "Dev Team", "email": "dev@company.com"}` |572| `author` | object | Informações do autor | `{"name": "Dev Team", "email": "dev@company.com"}` |

566| `metadata` | object | Objeto de forma livre para seus próprios dados, como campos de direito ou catálogo. Claude Code não lê, então os valores nunca afetam o comportamento do plugin. Claude Code ignora um valor não-objeto, e `claude plugin validate` o relata como um aviso. Antes de v2.1.222, Claude Code tratava a chave como um [campo não reconhecido](#unrecognized-fields). | `{"catalogId": "cat-123"}` |577| `metadata` | object | Objeto de forma livre para seus próprios dados, como campos de direito ou catálogo. Claude Code não o lê, então os valores nunca afetam o comportamento do plugin. Claude Code ignora um valor não-objeto, e `claude plugin validate` o relata como um aviso. Antes de v2.1.222, Claude Code tratava a chave como um [campo não reconhecido](#unrecognized-fields). | `{"catalogId": "cat-123"}` |

568 579

569<h3 id="default-enablement">580<h3 id="default-enablement">

570 Habilitação padrão581 Habilitação padrão

571</h3>582</h3>

572 583

573Defina `defaultEnabled: false` em `plugin.json` para enviar um plugin que instala desabilitado. O usuário o ativa com `claude plugin enable <plugin>` ou a interface `/plugin`. Use isso para plugins que adicionam custo ou escopo que um usuário deve optar por usar, como um que se conecta a um serviço externo.584Defina `defaultEnabled: false` em `plugin.json` para enviar um plugin que instala desabilitado. O usuário o ativa com `claude plugin enable <plugin>` ou a interface `/plugin`. Use isso para plugins que adicionam custo ou escopo que um usuário deve optar por participar, como um que se conecta a um serviço externo.

574 585

575`defaultEnabled` é o fallback quando nada mais decidiu o estado do plugin. A configuração do usuário e um requisito de dependência têm precedência sobre ele:586`defaultEnabled` é o fallback quando nada mais decidiu o estado do plugin. A configuração do usuário e um requisito de dependência têm precedência sobre ele:

576 587

598| `experimental.evals` | string\|array | Diretório abaixo da raiz do plugin que contém os [casos de eval](/docs/pt/plugin-evals#use-a-different-eval-directory) do plugin, quando não é o padrão `evals/`. `claude plugin eval --eval-dir` o substitui | `"quality/evals"` |609| `experimental.evals` | string\|array | Diretório abaixo da raiz do plugin que contém os [casos de eval](/docs/pt/plugin-evals#use-a-different-eval-directory) do plugin, quando não é o padrão `evals/`. `claude plugin eval --eval-dir` o substitui | `"quality/evals"` |

601| `dependencies` | array | Outros plugins que este plugin requer, opcionalmente com restrições de versão semver. Veja [Restringir versões de dependência de plugin](/docs/pt/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |612| `dependencies` | array | Outros plugins que este plugin requer, opcionalmente com restrições de versão semver. Veja [Restringir versões de dependência de plugin](/docs/pt/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |

602 613

603<h3 id="experimental-components">614<h3 id="experimental-components">

604 Componentes experimentais615 Componentes experimentais

605</h3>616</h3>

606 617

607Componentes sob a chave `experimental`, `themes` e `monitors`, têm um esquema de manifesto que pode mudar entre versões enquanto estabilizam. Onde você os declara é uma migração separada: o nível superior ainda funciona, `claude plugin validate` avisa, e uma versão futura exigirá `experimental.*`.618Componentes sob a chave `experimental`, `themes` e `monitors`, têm um esquema de manifesto que pode mudar entre versões enquanto se estabilizam. Onde você os declara é uma migração separada: o nível superior ainda funciona, `claude plugin validate` avisa, e uma versão futura exigirá `experimental.*`.

608 619

609<h3 id="user-configuration">620<h3 id="user-configuration">

610 Configuração do usuário621 Configuração do usuário

633As chaves devem ser identificadores válidos. Cada opção suporta estes campos:644As chaves devem ser identificadores válidos. Cada opção suporta estes campos:

634 645

636| :------------ | :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |647| :------------ | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

637| `type` | Sim | Um de `string`, `number`, `boolean`, `directory`, ou `file` |648| `type` | Sim | Um de `string`, `number`, `boolean`, `directory`, ou `file` |

638| `title` | Sim | Rótulo mostrado no diálogo de configuração |649| `title` | Sim | Rótulo mostrado no diálogo de configuração |

639| `description` | Sim | Texto de ajuda mostrado abaixo do campo |650| `description` | Sim | Texto de ajuda mostrado abaixo do campo |

640| `sensitive` | Não | Se `true`, mascara entrada e armazena o valor em armazenamento seguro em vez de `settings.json` |651| `sensitive` | Não | Se `true`, mascara entrada e armazena o valor em armazenamento seguro em vez de `settings.json` |

641| `required` | Não | Se `true`, a validação falha quando o campo está vazio |652| `required` | Não | Se `true`, a validação falha quando o campo está vazio |

642| `default` | Não | Valor usado quando o usuário não fornece nada |653| `default` | Não | Valor usado quando o usuário não fornece nada |

643| `options` | Não | Para tipo `string`, os valores que o campo aceita, mostrados em `/config` como um seletor sobre eles. Requer Claude Code v2.1.271 ou posterior |654| `options` | Não | Para tipo `string`, os valores que o campo aceita, mostrados em `/config` como um seletor sobre eles. Veja [Limitar um campo a opções fixas](#limit-a-field-to-fixed-options). Requer Claude Code v2.1.271 ou posterior |

644| `multiple` | Não | Para tipo `string`, permite um array de strings |655| `multiple` | Não | Para tipo `string`, permitir um array de strings |

645| `min` / `max` | Não | Limites para tipo `number` |656| `min` / `max` | Não | Limites para tipo `number` |

646 657

647Exceto campos `sensitive` e listas `multiple`, cada campo de cada plugin habilitado também aparece como uma linha no painel `/config`. As linhas requerem Claude Code v2.1.269 ou posterior.658Exceto campos `sensitive` e listas `multiple`, cada campo de cada plugin habilitado também aparece como uma linha no painel `/config`. As linhas requerem Claude Code v2.1.269 ou posterior.

660 671

661Valores não-sensíveis são armazenados sob a chave [`pluginConfigs`](/docs/pt/settings-reference#pluginconfigs) em seu `settings.json` de usuário como `pluginConfigs[<plugin-id>].options`.672Valores não-sensíveis são armazenados sob a chave [`pluginConfigs`](/docs/pt/settings-reference#pluginconfigs) em seu `settings.json` de usuário como `pluginConfigs[<plugin-id>].options`.

662 673

663No macOS, Claude Code armazena valores sensíveis no Keychain do macOS, voltando para `~/.claude/.credentials.json` quando o Keychain rejeita a escrita. Em plataformas sem um keychain suportado, ele os armazena em `~/.claude/.credentials.json`. O armazenamento em Keychain é compartilhado com tokens OAuth e tem um limite total de aproximadamente 2 KB, então mantenha valores sensíveis pequenos.674No macOS, Claude Code armazena valores sensíveis no Keychain do macOS, voltando para `~/.claude/.credentials.json` quando o Keychain rejeita a escrita. Em plataformas sem um keychain suportado, ele os armazena em `~/.claude/.credentials.json`. O armazenamento em Keychain é compartilhado com tokens OAuth e tem um limite total aproximado de 2 KB, então mantenha valores sensíveis pequenos.

664 675

665Claude Code lê todos os valores `pluginConfigs` de apenas três fontes de configurações:676Claude Code lê todos os valores `pluginConfigs` de apenas três fontes de configurações:

666 677

667* **Configurações do usuário**: `~/.claude/settings.json`, o arquivo que o prompt em tempo de habilitação escreve678* **Configurações do usuário**: `~/.claude/settings.json`, o arquivo que o prompt de tempo de habilitação escreve

668* **`--settings`**: a flag CLI ou configurações inline do SDK679* **`--settings`**: o sinalizador CLI ou configurações inline do SDK

669* **Configurações gerenciadas**: [política controlada pela organização](/docs/pt/permissions#managed-settings)680* **Configurações gerenciadas**: [política controlada pela organização](/docs/pt/permissions#managed-settings)

670 681

671Quando mais de uma fonte define a mesma chave, configurações gerenciadas têm precedência, depois `--settings`, depois configurações do usuário. A única fonte que você pode remover desta lista é configurações do usuário: passe [`--setting-sources`](/docs/pt/cli-reference#cli-flags) sem `user` e Claude Code as ignora. Configurações gerenciadas e `--settings` permanecem o que você passar. A opção [`settingSources`](/docs/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) do SDK define a mesma lista.682Quando mais de uma fonte define a mesma chave, as configurações gerenciadas têm precedência, depois `--settings`, depois configurações do usuário. A única fonte que você pode remover desta lista é configurações do usuário: passe [`--setting-sources`](/docs/pt/cli-reference#cli-flags) sem `user` e Claude Code as ignora. Configurações gerenciadas e `--settings` permanecem o que você passar. A opção [`settingSources`](/docs/pt/agent-sdk/claude-code-features#what-settingsources-does-not-control) do SDK define a mesma lista.

672 683

673Entradas em `.claude/settings.json` ou `.claude/settings.local.json` de um projeto são ignoradas. Ambos os arquivos vivem no workspace, então um repositório clonado poderia fornecer valores lá, e esses valores fluiriam para comandos de hook de plugin, configurações de servidor MCP, comandos LSP e comandos de monitor. Antes de v2.1.207, essas entradas eram lidas. A restrição é específica para `pluginConfigs`: [`enabledPlugins`](/docs/pt/settings-reference#enabledplugins) ainda honra configurações de projeto e local.684Entradas em `.claude/settings.json` ou `.claude/settings.local.json` de um projeto são ignoradas. Ambos os arquivos vivem no workspace, então um repositório clonado poderia fornecer valores lá, e esses valores fluiriam para comandos de hook de plugin, configurações de servidor MCP, comandos LSP e comandos de monitor. Antes de v2.1.207, essas entradas eram lidas. A restrição é específica para `pluginConfigs`: [`enabledPlugins`](/docs/pt/settings-reference#enabledplugins) ainda honra configurações de projeto e local.

674 685

686<h4 id="limit-a-field-to-fixed-options">

687 Limitar um campo a opções fixas

688</h4>

689

690Defina `options` em um campo `userConfig` para fazer os usuários escolherem seu valor de uma lista fixa.

691

692Para limitar um campo `tone` a três opções, liste-as em `options` e defina `default` para uma delas:

693

694```json theme={null}

695{

696 "userConfig": {

697 "tone": {

698 "type": "string",

699 "title": "Tone",

700 "description": "Voice for generated replies",

701 "options": ["neutral", "warm", "formal"],

702 "default": "neutral"

703 }

704 }

705}

706```

707

708Se você declarar `options` em qualquer campo, usuários em versões Claude Code anteriores a v2.1.271 não podem carregar o plugin.

709

710Quando você define `options` em um campo, siga estas regras:

711

712* Defina `type` para `string`

713* Não defina `multiple` ou `sensitive` para `true`

714* Defina `default` para uma das opções

715* Se você deixar `default` indefinido, defina `required` para `true`

716* Liste pelo menos uma opção, cada uma com 1 a 64 caracteres de comprimento

717* Não comece ou termine uma opção com um espaço

718* Não use caracteres de controle, caracteres invisíveis, caracteres que mudam a direção do texto, ou espaços diferentes de um espaço regular em uma opção

719* Não liste a mesma opção duas vezes, mesmo em uma capitalização diferente

720

721Se você quebrar qualquer uma dessas regras, o plugin falha ao carregar. Execute `claude plugin validate` para ver qual campo quebra qual regra.

722

675<h3 id="channels">723<h3 id="channels">

676 Canais724 Canais

677</h3>725</h3>

710Se um caminho personalizado substitui ou estende o diretório padrão do plugin depende do campo:758Se um caminho personalizado substitui ou estende o diretório padrão do plugin depende do campo:

711 759

712* **Substitui o padrão**: `commands`, `agents`, `workflows`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Por exemplo, quando o manifesto especifica `commands`, o diretório padrão `commands/` não é verificado. Para manter o padrão e adicionar mais, liste-o explicitamente: `"commands": ["./commands/", "./extras/"]`760* **Substitui o padrão**: `commands`, `agents`, `workflows`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Por exemplo, quando o manifesto especifica `commands`, o diretório padrão `commands/` não é verificado. Para manter o padrão e adicionar mais, liste-o explicitamente: `"commands": ["./commands/", "./extras/"]`

713* **Adiciona ao padrão**: `skills`. O diretório padrão `skills/` é sempre verificado, e diretórios listados em `skills` são carregados junto com ele. Exceção: para uma [entrada de marketplace cuja `source` resolve para a raiz de marketplace](/docs/pt/plugin-marketplaces#advanced-plugin-entries), declarar subdiretórios específicos substitui a varredura padrão `skills/`761* **Adiciona ao padrão**: `skills`. O diretório padrão `skills/` é sempre verificado, e diretórios listados em `skills` são carregados junto com ele. Exceção: para uma [entrada de marketplace cuja `source` resolve para a raiz do marketplace](/docs/pt/plugin-marketplaces#advanced-plugin-entries), declarar subdiretórios específicos substitui a varredura padrão `skills/`

714* **Regras de mesclagem próprias**: [hooks](#hooks), [servidores MCP](#mcp-servers), e [servidores LSP](#lsp-servers). Veja cada seção para como múltiplas fontes se combinam762* **Regras de mesclagem próprias**: [hooks](#hooks), [servidores MCP](#mcp-servers), e [servidores LSP](#lsp-servers). Veja cada seção para como múltiplas fontes se combinam

715 763

716Quando um plugin tem tanto uma pasta padrão quanto a chave de manifesto correspondente, Claude Code avisa sobre a pasta ignorada em `claude plugin list` e a visualização de detalhes `/plugin`. O plugin ainda carrega usando os caminhos de manifesto. Claude Code não avisa quando a chave de manifesto aponta para dentro da pasta padrão, por exemplo `"commands": ["./commands/deploy.md"]`, porque esse caminho nomeia a pasta explicitamente.764Quando um plugin tem tanto uma pasta padrão quanto a chave de manifesto correspondente, Claude Code avisa sobre a pasta ignorada em `claude plugin list` e na visualização de detalhes `/plugin`. O plugin ainda carrega usando os caminhos de manifesto. Claude Code não avisa quando a chave de manifesto aponta para dentro da pasta padrão, por exemplo `"commands": ["./commands/deploy.md"]`, porque esse caminho nomeia a pasta explicitamente.

717 765

718Para todos os campos de caminho:766Para todos os campos de caminho:

719 767

720* Todos os caminhos devem ser relativos à raiz do plugin e começar com `./`, exceto que o campo `skills` também aceita `"."`768* Todos os caminhos devem ser relativos à raiz do plugin e começar com `./`, exceto que o campo `skills` também aceita `"."`

721 * Ambos `"."` e `"./"` denotam a raiz do plugin em si769 * Ambos `"."` e `"./"` denotam a raiz do plugin em si

722 * Antes de v2.1.221, `"."` falhava na validação de manifesto e o plugin não carregava, então use `"./"` para suportar versões anteriores770 * Antes de v2.1.221, `"."` falhava na validação de manifesto e o plugin não carregava, então use `"./"` para suportar versões anteriores

723* Componentes de caminhos personalizados usam as mesmas regras de nomenclatura e namespacing771* Componentes de caminhos personalizados usam as mesmas regras de nomenclatura e namespacing, exceto arquivos de agente. Veja [Agentes](#agents) para como nomes de agente funcionam

724* Múltiplos caminhos podem ser especificados como arrays772* Múltiplos caminhos podem ser especificados como arrays

725* Um caminho de skill pode apontar para um diretório que contém um `SKILL.md` diretamente, por exemplo `"skills": ["."]` para a raiz do plugin773* Um caminho de skill pode apontar para um diretório que contém um `SKILL.md` diretamente, por exemplo `"skills": ["."]` para a raiz do plugin

726 * Claude Code pega o nome de invocação do skill do campo `name` do frontmatter em `SKILL.md`, então o nome permanece estável qualquer que seja o nome do diretório de instalação774 * Claude Code pega o nome de invocação da skill do campo `name` do frontmatter em `SKILL.md`, então o nome permanece estável qualquer que seja o nome do diretório de instalação

727 * Se `name` não estiver definido no frontmatter, Claude Code volta para o basename do diretório775 * Se `name` não estiver definido no frontmatter, Claude Code volta para o basename do diretório

728 776

729Um plugin que tem um `SKILL.md` em sua raiz, nenhum subdiretório `skills/`, e nenhum campo de manifesto `skills` é automaticamente carregado como um plugin de skill único. Você não precisa definir `"skills": ["./"]` em `plugin.json` para este layout.777Um plugin que tem um `SKILL.md` em sua raiz, nenhum subdiretório `skills/`, e nenhum campo de manifesto `skills` é automaticamente carregado como um plugin de skill único. Você não precisa definir `"skills": ["./"]` em `plugin.json` para este layout.

755| `${CLAUDE_PLUGIN_DATA}` | [Diretório persistente](#persistent-data-directory) que sobrevive a atualizações de plugin, criado na primeira referência | Dependências instaladas como `node_modules` ou ambientes virtuais Python, código gerado e caches |803| `${CLAUDE_PLUGIN_DATA}` | [Diretório persistente](#persistent-data-directory) que sobrevive a atualizações de plugin, criado na primeira referência | Dependências instaladas como `node_modules` ou ambientes virtuais Python, código gerado e caches |

756| `${CLAUDE_PROJECT_DIR}` | A raiz do projeto | Scripts e arquivos de configuração locais do projeto |804| `${CLAUDE_PROJECT_DIR}` | A raiz do projeto | Scripts e arquivos de configuração locais do projeto |

757 805

758Todos os três são exportados como variáveis de ambiente para processos de hook e para subprocessos de servidor MCP e LSP. Eles não estão presentes no ambiente de comandos que Claude executa através da ferramenta Bash, na sessão principal ou em um subagente. Em conteúdo de plugin, escreva o placeholder em vez disso, e Claude Code substitui o caminho inline quando carrega o conteúdo. Quais campos substituem eles inline depende do componente do plugin:806Todos os três são exportados como variáveis de ambiente para processos de hook e para subprocessos de servidor MCP e LSP. Eles não estão presentes no ambiente de comandos que Claude executa através da ferramenta Bash, na sessão principal ou em um subagente. Em conteúdo de plugin, escreva o placeholder em vez disso, e Claude Code substitui o caminho inline quando carrega o conteúdo. Quais campos substituem eles inline depende do componente de plugin:

759 807

760| Componente do plugin | Campos onde placeholders resolvem |808| Componente de plugin | Campos onde placeholders resolvem |

761| :--------------------------------- | :------------------------------------------- |809| :--------------------------------- | :------------------------------------------- |

762| Conteúdo de skill e agente | Em qualquer lugar onde o placeholder aparece |810| Conteúdo de skill e agente | Em qualquer lugar onde o placeholder aparece |

763| Comandos de hook e monitor | Em qualquer lugar onde o placeholder aparece |811| Comandos de hook e monitor | Em qualquer lugar onde o placeholder aparece |

786 834

787Para um plugin copiado, `${CLAUDE_PLUGIN_ROOT}` muda quando o plugin é atualizado. O diretório da versão anterior permanece no disco por um período de carência após uma atualização, mas trate-o como efêmero e não escreva estado lá. Para um plugin carregado no local de um marketplace de diretório local, a variável aponta para o diretório de origem estável. Veja [plugin caching](#plugin-caching-and-file-resolution) para quais plugins são copiados e para semântica de limpeza.835Para um plugin copiado, `${CLAUDE_PLUGIN_ROOT}` muda quando o plugin é atualizado. O diretório da versão anterior permanece no disco por um período de carência após uma atualização, mas trate-o como efêmero e não escreva estado lá. Para um plugin carregado no local de um marketplace de diretório local, a variável aponta para o diretório de origem estável. Veja [plugin caching](#plugin-caching-and-file-resolution) para quais plugins são copiados e para semântica de limpeza.

788 836

789Quando um plugin copiado é atualizado no meio da sessão, comandos de hook, monitores, servidores MCP e servidores LSP continuam usando o caminho da versão anterior. Execute `/reload-plugins` para mudar hooks, servidores MCP e servidores LSP para o novo caminho; monitores exigem reinicialização de sessão. Em uma sessão sem terminal interativo, o reload deixa servidores MCP de plugin no caminho antigo até a próxima sessão.837Quando um plugin copiado é atualizado no meio da sessão, comandos de hook, monitores, servidores MCP e servidores LSP continuam usando o caminho da versão anterior. Execute `/reload-plugins` para mudar hooks, servidores MCP e servidores LSP para o novo caminho; monitores requerem uma reinicialização de sessão. Em uma sessão sem um terminal interativo, o recarregamento deixa servidores MCP de plugin no caminho antigo até a próxima sessão.

790 838

791Para um plugin com uma `command` source, Claude Code [pode recarregar o plugin em si](/docs/pt/plugin-marketplaces#when-claude-code-re-runs-the-command).839Para um plugin com uma `command` source, Claude Code [pode recarregar o plugin em si](/docs/pt/plugin-marketplaces#when-claude-code-re-runs-the-command).

792 840

798 846

799O diretório `${CLAUDE_PLUGIN_DATA}` resolve para `~/.claude/plugins/data/{id}/`, onde `{id}` é o identificador do plugin com caracteres fora de `a-z`, `A-Z`, `0-9`, `_`, e `-` substituídos por `-`. Para um plugin instalado como `formatter@my-marketplace`, o diretório é `~/.claude/plugins/data/formatter-my-marketplace/`.847O diretório `${CLAUDE_PLUGIN_DATA}` resolve para `~/.claude/plugins/data/{id}/`, onde `{id}` é o identificador do plugin com caracteres fora de `a-z`, `A-Z`, `0-9`, `_`, e `-` substituídos por `-`. Para um plugin instalado como `formatter@my-marketplace`, o diretório é `~/.claude/plugins/data/formatter-my-marketplace/`.

800 848

801Um uso comum é instalar dependências de linguagem uma vez e reutilizá-las entre sessões e atualizações de plugin. Use para dependências Python, dependências bloqueadas com Yarn ou pnpm, e pacotes cujos scripts de ciclo de vida devem executar. Para um plugin instalado a partir de um marketplace, talvez você nem precise dele: Claude Code instala automaticamente [dependências de pacote Node.js](#node-js-package-dependencies) elegíveis quando armazena em cache o plugin.849Um uso comum é instalar dependências de linguagem uma vez e reutilizá-las entre sessões e atualizações de plugin. Use para dependências Python, dependências bloqueadas com Yarn ou pnpm, e pacotes cujos scripts de ciclo de vida devem executar. Para um plugin instalado do marketplace, você pode não precisar dele: Claude Code instala automaticamente [dependências de pacote Node.js](/docs/pt/plugin-dependencies#node-js-package-dependencies) elegíveis quando armazena em cache o plugin.

802 850

803Como o diretório de dados sobrevive a qualquer versão única de plugin, uma verificação de existência de diretório sozinha não pode detectar quando uma atualização muda o manifesto de dependência do plugin. O padrão recomendado compara o manifesto agrupado contra uma cópia no diretório de dados e reinstala quando diferem.851Como o diretório de dados sobrevive a qualquer versão única de plugin, uma verificação de existência de diretório sozinha não pode detectar quando uma atualização muda o manifesto de dependência do plugin. O padrão recomendado compara o manifesto agrupado contra uma cópia no diretório de dados e reinstala quando diferem.

804 852

821}869}

822```870```

823 871

824O `diff` sai com código diferente de zero quando a cópia armazenada está faltando ou difere da agrupada, cobrindo tanto primeira execução quanto atualizações que mudam dependências. Se `npm install` falhar, o `rm` final remove o manifesto copiado para que a próxima sessão tente novamente.872O `diff` sai com código diferente de zero quando a cópia armazenada está faltando ou difere da agrupada, cobrindo tanto a primeira execução quanto atualizações que mudam dependências. Se `npm install` falhar, o `rm` final remove o manifesto copiado para que a próxima sessão tente novamente.

825 873

826Scripts agrupados em `${CLAUDE_PLUGIN_ROOT}` podem então executar contra o `node_modules` persistido:874Scripts agrupados em `${CLAUDE_PLUGIN_ROOT}` podem então executar contra o `node_modules` persistido:

827 875

839}887}

840```888```

841 889

842O diretório de dados é deletado automaticamente quando você desinstala o plugin do último escopo onde está instalado. A interface `/plugin` mostra o tamanho do diretório e solicita antes de deletar. A CLI deleta por padrão; passe [`--keep-data`](#plugin-uninstall) para preservá-lo.890O diretório de dados é deletado automaticamente quando você desinstala o plugin do último escopo onde está instalado. A interface `/plugin` mostra o tamanho do diretório e solicita antes de deletar. O CLI deleta por padrão; passe [`--keep-data`](#plugin-uninstall) para preservá-lo.

843 891

844***892***

845 893

959├── agents/ # Definições de subagentes1007├── agents/ # Definições de subagentes

960│ ├── security-reviewer.md1008│ ├── security-reviewer.md

961│ ├── performance-tester.md1009│ ├── performance-tester.md

962│ └── compliance-checker.md1010│ ├── compliance-checker.md

1011│ └── review/ # Agentes aqui carregam como enterprise-plugin:review:<name>

1012│ └── accessibility.md

963├── workflows/ # Scripts de fluxo de trabalho1013├── workflows/ # Scripts de fluxo de trabalho

964│ └── release-audit.js1014│ └── release-audit.js

965├── output-styles/ # Definições de estilo de saída1015├── output-styles/ # Definições de estilo de saída

prompt-caching.md +1 −1

Details

96 96

97A [`opusplan` model setting](/docs/pt/model-config#opusplan-model-setting) resolve para Opus durante o modo de plano e Sonnet durante a execução, então cada alternância de modo de plano é uma mudança de modelo e inicia um cache novo.97A [`opusplan` model setting](/docs/pt/model-config#opusplan-model-setting) resolve para Opus durante o modo de plano e Sonnet durante a execução, então cada alternância de modo de plano é uma mudança de modelo e inicia um cache novo.

98 98

99[Automatic model fallback](/docs/pt/model-config#automatic-model-fallback) em modelos Fable e Opus 5 também é uma mudança de modelo. Quando um classificador de segurança sinaliza uma solicitação em uma categoria que tem um modelo de fallback, Claude Code executa novamente a solicitação nesse modelo e a sessão continua lá.99[Automatic model fallback](/docs/pt/model-config#automatic-model-fallback) em modelos Fable, Opus 5.5 e Opus 5 também é uma mudança de modelo. Quando um classificador de segurança sinaliza uma solicitação em uma categoria que tem um modelo de fallback, Claude Code executa novamente a solicitação nesse modelo e a sessão continua lá.

100 100

101Quando a frontmatter de uma skill ou comando nomeia um [`model`](/docs/pt/skills#frontmatter-reference) diferente do modelo atual da sessão, esse turno também é uma mudança de modelo: a próxima solicitação lê todo o histórico de conversa sem acertos de cache. O modelo de sessão retoma no seu próximo prompt. Uma skill `context: fork` define o [modelo do subagente bifurcado](/docs/pt/skills#run-skills-in-a-subagent) em vez disso.101Quando a frontmatter de uma skill ou comando nomeia um [`model`](/docs/pt/skills#frontmatter-reference) diferente do modelo atual da sessão, esse turno também é uma mudança de modelo: a próxima solicitação lê todo o histórico de conversa sem acertos de cache. O modelo de sessão retoma no seu próximo prompt. Uma skill `context: fork` define o [modelo do subagente bifurcado](/docs/pt/skills#run-skills-in-a-subagent) em vez disso.

102 102

prompt-library.md +1 −1

Details

1384* [Como os times da Anthropic usam Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code): fluxos de trabalho reais de times de engenharia, produto, design e dados, com aprofundamentos em [jurídico](https://claude.com/blog/how-anthropic-uses-claude-legal), [marketing](https://claude.com/blog/how-anthropic-uses-claude-marketing) e [segurança cibernética](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)1384* [Como os times da Anthropic usam Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code): fluxos de trabalho reais de times de engenharia, produto, design e dados, com aprofundamentos em [jurídico](https://claude.com/blog/how-anthropic-uses-claude-legal), [marketing](https://claude.com/blog/how-anthropic-uses-claude-marketing) e [segurança cibernética](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)

1385* [Guia de codificação agentic em escala](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): o guia de adoção empresarial1385* [Guia de codificação agentic em escala](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): o guia de adoção empresarial

1386 1386

1387Para passo a passo em vídeo desses padrões, veja o curso gratuito [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action) na Anthropic Academy.1387Para passo a passo em vídeo desses padrões, veja o curso gratuito [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action) na [Claude Academy](https://academy.claude.com/).

1388 1388

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

1390 Recursos relacionados1390 Recursos relacionados

quickstart.md +1 −0

Details

379 379

380* **Em Claude Code**: Digite `/help` ou pergunte "how do I..."380* **Em Claude Code**: Digite `/help` ou pergunte "how do I..."

381* **Documentação**: Você está aqui! Navegue por outros guias381* **Documentação**: Você está aqui! Navegue por outros guias

382* **Cursos**: Faça [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e outros cursos gratuitos no seu próprio ritmo em [Claude Academy](https://academy.claude.com/)

382* **Comunidade**: Junte-se ao nosso [Discord](https://www.anthropic.com/discord) para dicas e suporte383* **Comunidade**: Junte-se ao nosso [Discord](https://www.anthropic.com/discord) para dicas e suporte

remote-control.md +1 −1

Details

187* **Puxando uma sessão com `/teleport`**: quando você puxa uma [sessão Claude Code na web](/docs/pt/claude-code-on-the-web#from-cloud-to-terminal) para seu terminal com `/teleport`, o dispositivo conectado não recebe o histórico anterior da conversa puxada. Novas mensagens em ambas as direções vão para e vêm da conversa puxada, que agora é a que está aberta no seu terminal.187* **Puxando uma sessão com `/teleport`**: quando você puxa uma [sessão Claude Code na web](/docs/pt/claude-code-on-the-web#from-cloud-to-terminal) para seu terminal com `/teleport`, o dispositivo conectado não recebe o histórico anterior da conversa puxada. Novas mensagens em ambas as direções vão para e vêm da conversa puxada, que agora é a que está aberta no seu terminal.

188* **Mensagens de suas outras sessões**: com [mensagens entre sessões](/docs/pt/cross-session-messaging), a mesma conexão carrega mensagens entre suas próprias sessões em diferentes máquinas e de suas sessões [Claude Code na web](/docs/pt/claude-code-on-the-web), através de servidores Anthropic como o resto do tráfego Remote Control. [Mensagens de sessões em outras máquinas](/docs/pt/cross-session-messaging#message-sessions-on-other-machines) cobre as regras de entrega e [Controlar mensagens de entrada](/docs/pt/cross-session-messaging#control-inbound-messages) cobre os controles de entrada. Requer Claude Code v2.1.224 ou posterior.188* **Mensagens de suas outras sessões**: com [mensagens entre sessões](/docs/pt/cross-session-messaging), a mesma conexão carrega mensagens entre suas próprias sessões em diferentes máquinas e de suas sessões [Claude Code na web](/docs/pt/claude-code-on-the-web), através de servidores Anthropic como o resto do tráfego Remote Control. [Mensagens de sessões em outras máquinas](/docs/pt/cross-session-messaging#message-sessions-on-other-machines) cobre as regras de entrega e [Controlar mensagens de entrada](/docs/pt/cross-session-messaging#control-inbound-messages) cobre os controles de entrada. Requer Claude Code v2.1.224 ou posterior.

189* **Prompts que você envia no meio do turno**: quando você envia um prompt de um dispositivo conectado antes do turno atual terminar, Claude Code o coloca na fila e o mantém na transcrição do dispositivo depois que esse turno termina.189* **Prompts que você envia no meio do turno**: quando você envia um prompt de um dispositivo conectado antes do turno atual terminar, Claude Code o coloca na fila e o mantém na transcrição do dispositivo depois que esse turno termina.

190* **Diff de suas alterações**: quando o diretório da sessão está em um repositório git, o painel de diff de um dispositivo conectado mostra o diff de suas alterações não confirmadas. O dispositivo solicita o diff pela conexão, e Claude Code o computa em sua máquina. Quando sua árvore de trabalho está limpa, Claude Code em vez disso serve as alterações do seu branch desde que divergiu do branch padrão. Antes da v2.1.247, Claude Code relatava o diff para dispositivos conectados apenas em sessões servidas por `claude remote-control`.190* **Diff de suas alterações**: quando o diretório da sessão está em um repositório git, o painel de diff de um dispositivo conectado mostra suas alterações. O dispositivo solicita o diff pela conexão, e Claude Code o computa em sua máquina. Em um branch que tem commits à frente do branch padrão do repositório, o painel mostra as alterações desde que o branch divergiu dele, incluindo suas edições não confirmadas. No branch padrão em si, ou em um branch que não está à frente dele, o painel mostra apenas suas alterações não confirmadas. Antes da v2.1.247, Claude Code relatava o diff para dispositivos conectados apenas em sessões servidas por `claude remote-control`.

191* **Modelo**: quando você escolhe um [modelo](/docs/pt/model-config) de um dispositivo conectado, Claude Code executa a sessão nesse modelo. O seletor `/model` do terminal, `/status` e `/config` mostram esse modelo. Requer Claude Code v2.1.238 ou posterior.191* **Modelo**: quando você escolhe um [modelo](/docs/pt/model-config) de um dispositivo conectado, Claude Code executa a sessão nesse modelo. O seletor `/model` do terminal, `/status` e `/config` mostram esse modelo. Requer Claude Code v2.1.238 ou posterior.

192 * Um modelo que você escolhe do controle de modelo do dispositivo se aplica apenas à sessão atual. Quando você envia `/model <name>` do dispositivo para uma sessão interativa, Claude Code também define seu padrão para novas sessões.192 * Um modelo que você escolhe do controle de modelo do dispositivo se aplica apenas à sessão atual. Quando você envia `/model <name>` do dispositivo para uma sessão interativa, Claude Code também define seu padrão para novas sessões.

193 * Se você enviar um nome que Claude Code não reconheça, como um nome de exibição onde um ID de modelo é esperado, Claude Code [recusa a escolha](/docs/pt/errors#model-is-not-a-recognized-model-id) e a sessão mantém seu modelo atual. Antes da v2.1.260, Claude Code salvava uma escolha não reconhecida do controle de modelo do dispositivo, e sua próxima mensagem falhava.193 * Se você enviar um nome que Claude Code não reconheça, como um nome de exibição onde um ID de modelo é esperado, Claude Code [recusa a escolha](/docs/pt/errors#model-is-not-a-recognized-model-id) e a sessão mantém seu modelo atual. Antes da v2.1.260, Claude Code salvava uma escolha não reconhecida do controle de modelo do dispositivo, e sua próxima mensagem falhava.

security-guidance.md +6 −5

Details

31/plugin install security-guidance@claude-plugins-official31/plugin install security-guidance@claude-plugins-official

32```32```

33 33

~~34`/plugin` abre um painel interativo e está disponível apenas no CLI do terminal. Se Claude responder que `/plugin` não está disponível neste ambiente, instale de outra forma:~~34`/plugin` abre um painel interativo no CLI do terminal. Se Claude responder que `/plugin` não está disponível neste ambiente, instale de outra forma:

35 35

36* **Aplicativo Claude desktop, sessão local ou SSH**: abra o [navegador de plugins](/docs/pt/desktop#install-plugins) clicando no botão **+** ao lado do prompt, depois em **Plugins**, depois em **Adicionar plugin**36* **Aplicativo Claude desktop, sessão local ou SSH**: abra o [navegador de plugins](/docs/pt/desktop#install-plugins) clicando no botão **+** ao lado do prompt, depois em **Plugins**, depois em **Adicionar plugin**

37* **Sessões na nuvem**: declare o plugin em `.claude/settings.json` conforme mostrado em [Ativar em sessões na nuvem e repositórios compartilhados](#enable-in-cloud-sessions-and-shared-repositories)37* **Extensão VS Code**: instale do [diálogo **Gerenciar plugins**](/docs/pt/vs-code#manage-plugins)

38* **Sessões na nuvem**: ative o plugin para sua conta claude.ai para que Claude Code o carregue como um [plugin sincronizado](/docs/pt/plugins-reference#synced-plugins). Uma sessão na nuvem não carrega plugins de suas configurações de usuário ou do arquivo `.claude/settings.json` do repositório, conforme [O que é transferido de sua configuração](/docs/pt/cloud-environments#what-carries-over-from-your-setup) explica

38 39

39A instalação no terminal solicita um escopo. Escolha escopo de usuário para escrever o plugin em suas configurações de usuário, para que seja carregado em cada nova sessão local que você inicia nesta máquina.40A instalação no terminal solicita um escopo. Escolha escopo de usuário para escrever o plugin em suas configurações de usuário, para que seja carregado em cada nova sessão local que você inicia nesta máquina.

40 41

45 46

46Verifique o resumo da instalação. Se relatar `Run /reload-plugins to activate.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) para ativar o plugin em sua sessão atual.47Verifique o resumo da instalação. Se relatar `Run /reload-plugins to activate.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) para ativar o plugin em sua sessão atual.

47 48

~~48<h3 id="enable-in-cloud-sessions-and-shared-repositories">~~49<h3 id="enable-for-your-team-in-local-sessions">

~~49 Ativar em sessões na nuvem e repositórios compartilhados~~50 Ativar para sua equipe em sessões locais

50</h3>51</h3>

51 52

52Plugins com escopo de usuário não são transferidos para [sessões na nuvem](/docs/pt/claude-code-on-the-web), porque essas sessões não são executadas em 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:53Para ativar o plugin nas sessões locais que seus colegas de equipe iniciam no repositório, declare-o nas configurações verificadas do projeto:

53 54

54```json .claude/settings.json theme={null}55```json .claude/settings.json theme={null}

55{56{

self-hosted-environments-deploy.md +2 −2

Details

184 184

185O proxy requer `--capacity 1` porque a URL do proxy é por sessão, e git 2.32 ou mais recente porque git mais antigo ignora o mecanismo de configuração que o proxy usa para isolar sessões uma da outra. O runner se recusa a iniciar se qualquer requisito não for atendido. Como o proxy busca do lado da Anthropic, seu host git deve ser alcançável a partir da infraestrutura da Anthropic, o mesmo requisito que as sessões hospedadas pela Anthropic têm; para um host git que é apenas roteável dentro de sua rede, use um [hook de ciclo de vida `checkout`](/docs/pt/self-hosted-environments-configuration#checkout) em vez disso. Cada processo runner lida com uma sessão por vez, então execute mais réplicas para paralelismo. Quando o proxy está habilitado, `--git-host-rewrite` e `--git-ssh-rewrite` não têm efeito: a URL do proxy aponta para `api.anthropic.com`, não seu host git.185O proxy requer `--capacity 1` porque a URL do proxy é por sessão, e git 2.32 ou mais recente porque git mais antigo ignora o mecanismo de configuração que o proxy usa para isolar sessões uma da outra. O runner se recusa a iniciar se qualquer requisito não for atendido. Como o proxy busca do lado da Anthropic, seu host git deve ser alcançável a partir da infraestrutura da Anthropic, o mesmo requisito que as sessões hospedadas pela Anthropic têm; para um host git que é apenas roteável dentro de sua rede, use um [hook de ciclo de vida `checkout`](/docs/pt/self-hosted-environments-configuration#checkout) em vez disso. Cada processo runner lida com uma sessão por vez, então execute mais réplicas para paralelismo. Quando o proxy está habilitado, `--git-host-rewrite` e `--git-ssh-rewrite` não têm efeito: a URL do proxy aponta para `api.anthropic.com`, não seu host git.

186 186

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

188 188

189<h3 id="rewrite-git-urls-for-private-networks">189<h3 id="rewrite-git-urls-for-private-networks">

190 Reescrever URLs git para redes privadas190 Reescrever URLs git para redes privadas

223Troque `linux-x64` por `linux-arm64` se seus nós forem ARM, ou por `linux-x64-musl` ou `linux-arm64-musl` em uma imagem baseada em musl, como Alpine; consulte [Configuração Alpine Linux](/docs/pt/setup#alpine-linux-and-musl-based-distributions) para os pacotes extras que imagens musl precisam. A URL é o local de lançamento padrão do Claude Code, para que você possa verificar o binário baixado contra o manifesto assinado do lançamento conforme descrito em [Integridade binária e assinatura de código](/docs/pt/setup#binary-integrity-and-code-signing). Construa a imagem com Claude Code versão 2.1.224 ou posterior, depois envie-a para seu registro e a referencie nas receitas abaixo:223Troque `linux-x64` por `linux-arm64` se seus nós forem ARM, ou por `linux-x64-musl` ou `linux-arm64-musl` em uma imagem baseada em musl, como Alpine; consulte [Configuração Alpine Linux](/docs/pt/setup#alpine-linux-and-musl-based-distributions) para os pacotes extras que imagens musl precisam. A URL é o local de lançamento padrão do Claude Code, para que você possa verificar o binário baixado contra o manifesto assinado do lançamento conforme descrito em [Integridade binária e assinatura de código](/docs/pt/setup#binary-integrity-and-code-signing). Construa a imagem com Claude Code versão 2.1.224 ou posterior, depois envie-a para seu registro e a referencie nas receitas abaixo:

224 224

225```bash theme={null}225```bash theme={null}

226docker build --build-arg CLAUDE_CODE_VERSION=2.1.224 -t <your-registry>/claude-runner:latest .226docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .

227```227```

228 228

229<h2 id="size-cpu-and-memory-for-sessions">229<h2 id="size-cpu-and-memory-for-sessions">

server-managed-settings.md +1 −1

Details

171* **O bloco `env`**: além da unidade de telemetria e variáveis de roteamento emparelhadas com uma chave de credencial, ambas cobertas abaixo, ele se mescla por chave entre as fontes controladas por administrador. Para cada variável de ambiente, a fonte de prioridade mais alta que a define vence, e as fontes de administrador inferiores preenchem variáveis que as fontes superiores deixam não definidas. Uma entrada `env` gerenciada pelo endpoint, portanto, se aplica sempre que a configuração gerenciada pelo servidor deixa essa variável não definida, ou enquanto um valor de servidor em cache para ela é [retido pendente de confirmação do servidor](#fetch-and-caching-behavior). Requer Claude Code v2.1.223 ou posterior. Antes da v2.1.223, o Claude Code aplica apenas o bloco `env` da fonte selecionada.171* **O bloco `env`**: além da unidade de telemetria e variáveis de roteamento emparelhadas com uma chave de credencial, ambas cobertas abaixo, ele se mescla por chave entre as fontes controladas por administrador. Para cada variável de ambiente, a fonte de prioridade mais alta que a define vence, e as fontes de administrador inferiores preenchem variáveis que as fontes superiores deixam não definidas. Uma entrada `env` gerenciada pelo endpoint, portanto, se aplica sempre que a configuração gerenciada pelo servidor deixa essa variável não definida, ou enquanto um valor de servidor em cache para ela é [retido pendente de confirmação do servidor](#fetch-and-caching-behavior). Requer Claude Code v2.1.223 ou posterior. Antes da v2.1.223, o Claude Code aplica apenas o bloco `env` da fonte selecionada.

172 * **Unidade de telemetria**: as chaves do exportador `OTEL_EXPORTER_OTLP_*`, os toggles de captura de conteúdo `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` e as variáveis de rastreamento beta `ENABLE_BETA_TRACING_DETAILED` e `BETA_TRACING_ENDPOINT` seguem a fonte mais alta que define qualquer uma delas como uma unidade. Uma fonte que entrega a chave de credencial `otelHeadersHelper` também reclama a unidade, mas coloca essas variáveis apenas quando é a fonte selecionada: uma fonte que não é selecionada mas entrega a chave não contribui com nenhuma delas e ainda bloqueia fontes inferiores de preenchê-las. De qualquer forma, um endpoint do exportador de uma fonte nunca pode ser emparelhado com credenciais de outra.172 * **Unidade de telemetria**: as chaves do exportador `OTEL_EXPORTER_OTLP_*`, os toggles de captura de conteúdo `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` e as variáveis de rastreamento beta `ENABLE_BETA_TRACING_DETAILED` e `BETA_TRACING_ENDPOINT` seguem a fonte mais alta que define qualquer uma delas como uma unidade. Uma fonte que entrega a chave de credencial `otelHeadersHelper` também reclama a unidade, mas coloca essas variáveis apenas quando é a fonte selecionada: uma fonte que não é selecionada mas entrega a chave não contribui com nenhuma delas e ainda bloqueia fontes inferiores de preenchê-las. De qualquer forma, um endpoint do exportador de uma fonte nunca pode ser emparelhado com credenciais de outra.

173 * **Roteamento emparelhado com credencial**: uma fonte que emparelha variáveis de roteamento com uma chave de credencial somente de fonte selecionada, como `apiKeyHelper` ou `otelHeadersHelper`, contribui com essas variáveis de roteamento apenas quando vence o slot.173 * **Roteamento emparelhado com credencial**: uma fonte que emparelha variáveis de roteamento com uma chave de credencial somente de fonte selecionada, como `apiKeyHelper` ou `otelHeadersHelper`, contribui com essas variáveis de roteamento apenas quando vence o slot.

174* **Chaves de login do gateway**: o Claude Code nunca lê [`forceLoginGatewayUrl`](/docs/pt/settings-reference#forcelogingatewayurl) ou o valor `"gateway"` de [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) das configurações gerenciadas pelo servidor, portanto selecionar configurações gerenciadas pelo servidor não fornece um login do gateway nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) diz qual fonte de administrador na máquina as fornece.174* **Chaves de login do gateway**: o Claude Code nunca lê [`forceLoginGatewayUrl`](/docs/pt/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/pt/settings-reference#gatewayinternalnetworks) ou o valor `"gateway"` de [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) das configurações gerenciadas pelo servidor, portanto um valor lá não se aplica nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. A entrada [`managedSourcesBehavior`](/docs/pt/settings-reference#managedsourcesbehavior) diz qual fonte de administrador na máquina as fornece.

175 175

176<h3 id="fetch-and-caching-behavior">176<h3 id="fetch-and-caching-behavior">

177 Comportamento de busca e cache177 Comportamento de busca e cache

sessions.md +7 −1

Details

147Sessões que você não nomeia ainda recebem dois rótulos que Claude Code atribui. Apenas o título gerado funciona como um identificador de retomada:147Sessões que você não nomeia ainda recebem dois rótulos que Claude Code atribui. Apenas o título gerado funciona como um identificador de retomada:

148 148

149* Nome de exibição padrão: 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`. O padrão não é um identificador de retomada. Se você o passar para `claude --resume` ou `/resume`, Claude Code não encontra a sessão. Nomear a sessão substitui o padrão nessas listagens, e assim faz aceitar um plano.149* Nome de exibição padrão: 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`. O padrão não é um identificador de retomada. Se você o passar para `claude --resume` ou `/resume`, Claude Code não encontra a sessão. Nomear a sessão substitui o padrão nessas listagens, e assim faz aceitar um plano.

150* Título gerado: se você não nomear uma sessão, Claude Code gera um título de sessão para ela. O título é um resumo breve do seu primeiro prompt, escrito por uma solicitação em background para o modelo pequeno/rápido, normalmente um modelo da classe Haiku. Aceitar um plano o substitui por um título baseado no plano. Nomear a sessão substitui o título gerado. Você vê o título do primeiro prompt no [seletor de sessão](#use-the-session-picker) e no campo [`session_name`](/docs/pt/statusline) da statusline quando nenhum nome está definido. O título do plano aparece nos mesmos dois lugares e também nas listagens de sessões em execução, onde substitui o nome de exibição padrão. Você pode passar qualquer um dos títulos para `claude --resume` ou `/resume`, e Claude Code o resolve da mesma forma que um nome que você definiu.150* Título gerado: se você não nomear uma sessão, Claude Code gera um título de sessão para ela. O título é um resumo breve do seu primeiro prompt, escrito por uma solicitação em background para o modelo pequeno/rápido, normalmente um modelo da classe Haiku. Um `claude -p` executado que você inicia diretamente de um shell ou script não recebe um.

151

152 Aceitar um plano substitui o título do primeiro prompt por um título baseado no plano. Nomear a sessão também o substitui.

153

154 Você vê o título do primeiro prompt no [seletor de sessão](#use-the-session-picker) e no campo [`session_name`](/docs/pt/statusline) da statusline quando nenhum nome está definido. O título do plano aparece nos mesmos dois lugares e também nas listagens de sessões em execução, onde substitui o nome de exibição padrão.

155

156 Você pode passar qualquer um dos títulos para `claude --resume` ou `/resume`, e Claude Code o resolve da mesma forma que um nome que você definiu.

151 157

152<h2 id="use-the-session-picker">158<h2 id="use-the-session-picker">

153 Use o seletor de sessão159 Use o seletor de sessão

settings.md +3 −3

Details

468 Mantenha configurações pessoais fora de um repositório468 Mantenha configurações pessoais fora de um repositório

469</h3>469</h3>

470 470

471Para alterar uma configuração para você em um projeto sem alterá-la para seus colegas de equipe, salve-a em `.claude/settings.local.json` dentro do projeto. O Claude Code aplica esse arquivo sobre o `.claude/settings.json` confirmado, então se o arquivo da sua equipe define `"model": "claude-sonnet-5"` e você quer Opus, coloque `"model": "claude-opus-4-8"` no seu arquivo local e apenas suas sessões mudam.471Para alterar uma configuração para você em um projeto sem alterá-la para seus colegas de equipe, salve-a em `.claude/settings.local.json` dentro do projeto. O Claude Code aplica esse arquivo sobre o `.claude/settings.json` confirmado, então se o arquivo da sua equipe define `"model": "claude-sonnet-5"` e você quer Opus, coloque `"model": "claude-opus-5-5"` no seu arquivo local e apenas suas sessões mudam.

472 472

473O Claude Code também escreve neste arquivo, o mantém fora de seus commits e aplica suas regras de permissão sem a etapa de confiança:473O Claude Code também escreve neste arquivo, o mantém fora de seus commits e aplica suas regras de permissão sem a etapa de confiança:

474 474

598Por exemplo, para iniciar uma sessão em Opus sem alterar seu padrão:598Por exemplo, para iniciar uma sessão em Opus sem alterar seu padrão:

599 599

600```bash theme={null}600```bash theme={null}

601claude --settings '{"model": "claude-opus-4-8"}'601claude --settings '{"model": "claude-opus-5-5"}'

602```602```

603 603

604<h3 id="when-edits-take-effect">604<h3 id="when-edits-take-effect">

803 803

804Uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) é executada em um [ambiente em nuvem](/docs/pt/cloud-environments) em um clone fresco do seu repositório, não em sua máquina. Isso muda quais configurações a alcançam:804Uma [sessão em nuvem](/docs/pt/claude-code-on-the-web) é executada em um [ambiente em nuvem](/docs/pt/cloud-environments) em um clone fresco do seu repositório, não em sua máquina. Isso muda quais configurações a alcançam:

805 805

806* **Configurações compartilhadas de projeto** (`.claude/settings.json`): lidas em uma sessão com um repositório, porque o arquivo faz parte do clone e a sessão começa dentro dele. Confirme uma configuração lá para aplicá-la nessas sessões. Uma sessão com vários repositórios começa acima dos clones, então de cada `.claude/settings.json` do repositório ela carrega apenas os plugins e marketplaces que o arquivo declara, não regras de permissão, hooks, `env` ou outras chaves; veja [O que é transferido de sua configuração](/docs/pt/cloud-environments#what-carries-over-from-your-setup).806* **Configurações compartilhadas de projeto** (`.claude/settings.json`): lidas em uma sessão com um repositório, porque o arquivo faz parte do clone e a sessão começa dentro dele. Confirme uma configuração lá para aplicá-la nessas sessões. Uma sessão com vários repositórios começa acima dos clones e lê apenas as chaves `enabledPlugins` e `extraKnownMarketplaces` do `.claude/settings.json` de cada repositório, não regras de permissão, hooks, `env` ou outras chaves. Os marketplaces e plugins que essas duas chaves declaram ainda [não carregam em uma sessão em nuvem](/docs/pt/cloud-environments#what-carries-over-from-your-setup).

807* **Configurações de usuário e projeto local** (`~/.claude/settings.json` e `.claude/settings.local.json`): não lidas. Ambas permanecem em sua máquina, e o arquivo local não está no clone.807* **Configurações de usuário e projeto local** (`~/.claude/settings.json` e `.claude/settings.local.json`): não lidas. Ambas permanecem em sua máquina, e o arquivo local não está no clone.

808* **Configurações gerenciadas**: apenas [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) alcançam uma sessão em nuvem; um arquivo `managed-settings.json` ou perfil MDM em seu dispositivo não. Um [ambiente auto-hospedado](/docs/pt/self-hosted-environments) também lê o arquivo de configurações gerenciadas em sua imagem de runner. [Como o Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) diz quando esse arquivo se aplica.808* **Configurações gerenciadas**: apenas [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) alcançam uma sessão em nuvem; um arquivo `managed-settings.json` ou perfil MDM em seu dispositivo não. Um [ambiente auto-hospedado](/docs/pt/self-hosted-environments) também lê o arquivo de configurações gerenciadas em sua imagem de runner. [Como o Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) diz quando esse arquivo se aplica.

809* **`/config`**: no seu navegador em claude.ai/code, abre a seção Claude Code de suas configurações claude.ai em vez de alterar um valor. Para alterar uma configuração para uma sessão em nuvem, defina uma [variável de ambiente](/docs/pt/cloud-environments#set-environment-variables) no ambiente, ou em uma sessão com um repositório, confirme a chave no `.claude/settings.json` desse repositório.809* **`/config`**: no seu navegador em claude.ai/code, abre a seção Claude Code de suas configurações claude.ai em vez de alterar um valor. Para alterar uma configuração para uma sessão em nuvem, defina uma [variável de ambiente](/docs/pt/cloud-environments#set-environment-variables) no ambiente, ou em uma sessão com um repositório, confirme a chave no `.claude/settings.json` desse repositório.

settings-example.md +7 −3

Details

29 ```json ~/.claude/settings.json theme={null}29 ```json ~/.claude/settings.json theme={null}

30 {30 {

31 "model": "claude-sonnet-5",31 "model": "claude-sonnet-5",

~~32 "effortLevel": "xhigh",~~32 "modelSettings": {

33 "claude-sonnet-5": { "effortLevel": "xhigh" }

34 },

33 "editorMode": "vim",35 "editorMode": "vim",

34 "theme": "light-daltonized",36 "theme": "light-daltonized",

35 "statusLine": {37 "statusLine": {

58 {60 {

59 // Inicie cada sessão no Sonnet 561 // Inicie cada sessão no Sonnet 5

60 "model": "claude-sonnet-5",62 "model": "claude-sonnet-5",

~~61 // Raciocine mais profundamente do que o nível alto padrão em modelos sem um nível salvo; /effort salva um nível por modelo, e --effort define um para uma única sessão~~63 // Execute Sonnet 5 acima de seu nível alto padrão; /effort salva um nível por modelo, e --effort define um para uma única sessão

~~62 "effortLevel": "xhigh",~~64 "modelSettings": {

65 "claude-sonnet-5": { "effortLevel": "xhigh" }

66 },

63 // Atalhos de teclado Vim no prompt67 // Atalhos de teclado Vim no prompt

64 "editorMode": "vim",68 "editorMode": "vim",

65 // O tema claro amigável para daltônicos69 // O tema claro amigável para daltônicos

settings-reference.md +44 −33

Details

689| [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Receba uma [notificação push](/docs/pt/remote-control#mobile-push-notifications) quando Claude estiver esperando por você | Remoto, desktop e notificações | Any file |689| [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Receba uma [notificação push](/docs/pt/remote-control#mobile-push-notifications) quando Claude estiver esperando por você | Remoto, desktop e notificações | Any file |

690| [`isolatePeerMachines`](#isolatepeermachines) | Peça-lhe antes de Claude [enviar mensagem para uma de suas sessões em outra máquina](/docs/pt/cross-session-messaging#require-approval-for-cross-machine-messages) | Agentes, sessões e worktrees | Any file |690| [`isolatePeerMachines`](#isolatepeermachines) | Peça-lhe antes de Claude [enviar mensagem para uma de suas sessões em outra máquina](/docs/pt/cross-session-messaging#require-approval-for-cross-machine-messages) | Agentes, sessões e worktrees | Any file |

691| [`keybindingFlavor`](#keybindingflavor) | Descontinuado e sem efeito; os atalhos de edição de palavras sempre [seguem as convenções readline](/docs/pt/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface e terminal | Any file |691| [`keybindingFlavor`](#keybindingflavor) | Descontinuado e sem efeito; os atalhos de edição de palavras sempre [seguem as convenções readline](/docs/pt/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface e terminal | Any file |

797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Pare de carregar os [plugins ativados em sua conta claude.ai](/docs/pt/plugins-reference#synced-plugins) e pare de baixar novos | Plugins e skills | User, local, or managed |797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Pare de carregar os [plugins ativados em sua conta claude.ai](/docs/pt/plugins-reference#synced-plugins) e pare de baixar novos | Plugins e skills | User, local, or managed |

798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Pare de carregar as [skills ativadas em sua conta claude.ai](/docs/pt/skills#how-synced-skills-behave) e pare de baixar novas | Plugins e skills | User, local, or managed |798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Pare de carregar as [skills ativadas em sua conta claude.ai](/docs/pt/skills#how-synced-skills-behave) e pare de baixar novas | Plugins e skills | User, local, or managed |

801| [`teammateDefaultModel`](#teammatedefaultmodel) | Removido na v2.1.234; veja [Especificar companheiros de equipe e modelos](/docs/pt/agent-teams#specify-teammates-and-models) para como Claude Code escolhe o modelo de um companheiro de equipe | Configurações de config global | Global config |801| [`teammateDefaultModel`](#teammatedefaultmodel) | Removido na v2.1.234; veja [Especificar companheiros de equipe e modelos](/docs/pt/agent-teams#specify-teammates-and-models) para como Claude Code escolhe o modelo de um companheiro de equipe | Configurações de config global | Global config |

840Se sua conta exigir o [consentimento de créditos de uso](/docs/pt/advisor#fable-advisor-and-usage-credits), aceite-o primeiro executando `/model fable`. Até fazer isso, escolher Fable em `/advisor` não salva nada e Claude Code diz para executar `/model fable` primeiro.840Se sua conta exigir o [consentimento de créditos de uso](/docs/pt/advisor#fable-advisor-and-usage-credits), aceite-o primeiro executando `/model fable`. Até fazer isso, escolher Fable em `/advisor` não salva nada e Claude Code diz para executar `/model fable` primeiro.

841 841

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

843* **Tipo**: string, um dos aliases `"fable"`, `"opus"` ou `"sonnet"`, que resolvem para a versão padrão atual do Claude Code dessa família de modelos, ou um ID de modelo completo como `"claude-opus-5"`843* **Tipo**: string, um dos aliases `"fable"`, `"opus"` ou `"sonnet"`, que resolvem para a versão padrão atual do Claude Code dessa família de modelos, ou um ID de modelo completo como `"claude-opus-5-5"`

844* **Padrão**: sem definir, então o advisor está desativado844* **Padrão**: sem definir, então o advisor está desativado

845* **Substituições por sessão**: `--advisor` tem precedência sobre essa chave para uma sessão. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/pt/env-vars) desativa o advisor, e essa chave não pode ativá-lo novamente845* **Substituições por sessão**: `--advisor` tem precedência sobre essa chave para uma sessão. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/pt/env-vars) desativa o advisor, e essa chave não pode ativá-lo novamente

846 846

858 858

859Desative o [pensamento estendido](/docs/pt/model-config#extended-thinking) para cada sessão definindo isso como `false`. O pensamento está ativado por padrão, então `true` não muda nada. A maioria das pessoas define isso através de `/config` em vez de editar o arquivo.859Desative o [pensamento estendido](/docs/pt/model-config#extended-thinking) para cada sessão definindo isso como `false`. O pensamento está ativado por padrão, então `true` não muda nada. A maioria das pessoas define isso através de `/config` em vez de editar o arquivo.

860 860

861Em modelos que sempre pensam, como os modelos Fable, `false` não tem efeito. Em [provedores de terceiros](/docs/pt/third-party-integrations), Claude Code omite o parâmetro `thinking` em vez de desativar o pensamento, então modelos de raciocínio adaptativo podem ainda pensar. Com o pensamento desativado na API Anthropic, Claude Code envia esforço `high` em vez de um nível superior para modelos que sabe [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5.861Em modelos que sempre pensam, como Opus 5.5 e os modelos Fable, `false` não tem efeito. Em [provedores de terceiros](/docs/pt/third-party-integrations), Claude Code omite o parâmetro `thinking` em vez de desativar o pensamento, então modelos de raciocínio adaptativo podem ainda pensar. Com o pensamento desativado na API Anthropic, Claude Code envia esforço `high` em vez de um nível superior para modelos que sabe [não aceitam essa combinação](/docs/pt/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5.

862 862

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

864* **Tipo**: Boolean864* **Tipo**: Boolean

903 903

904Dentro do mesmo arquivo de configurações, Claude Code usa o nível salvo de um modelo em vez dessa chave. [`modelSettings`](#modelsettings) indica a precedência entre arquivos.904Dentro do mesmo arquivo de configurações, Claude Code usa o nível salvo de um modelo em vez dessa chave. [`modelSettings`](#modelsettings) indica a precedência entre arquivos.

905 905

906Em uma sessão anexada a um worker remoto, `/effort` se aplica apenas a essa sessão. Em uma execução `-p` ou no Agent SDK, também se aplica apenas a essa sessão, [a menos que haja uma retenção no esforço padrão do modelo](/docs/pt/model-config#non-interactive-effort). [Ajuste o nível de esforço](/docs/pt/model-config#adjust-effort-level) lista as escolhas interativas que também se aplicam apenas a essa sessão. A mensagem que `/effort` imprime diz qual aconteceu.906Em uma sessão anexada a um worker remoto, em uma execução `-p` e no Agent SDK, `/effort` se aplica apenas a essa sessão. [Ajuste o nível de esforço](/docs/pt/model-config#adjust-effort-level) lista as escolhas interativas que também se aplicam apenas a essa sessão. A mensagem que `/effort` imprime diz qual aconteceu.

907 907

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

909* **Tipo**: string, um de:909* **Tipo**: string, um de:

920}920}

921```921```

922 922

923Em Opus 4.7, Opus 4.8 e Fable 5, Claude Code retém o esforço padrão desse modelo, definido pela organização ou integrado; [Ajuste o nível de esforço](/docs/pt/model-config#adjust-effort-level) indica quais maneiras de definir um nível terminam a retenção e quais a deixam em vigor. Depois que a retenção termina, Claude Code resolve o esforço pela precedência indicada em [`modelSettings`](#modelsettings).923Em suas configurações de usuário, `~/.claude/settings.json`, essa chave é a forma mais antiga que `/effort` escrevia antes de salvar níveis por modelo, e continua se aplicando onde se aplicava antes, em Opus 5, Fable 5.1 e modelos anteriores. Opus 5.5 e modelos lançados após ele a ignoram e começam em seu próprio padrão até você salvar um nível para eles, que `/effort` escreve em [`modelSettings`](#modelsettings). Em configurações de projeto, local e gerenciada, e com `--settings`, essa chave se aplica a cada modelo.

924 924

925<h3 id="enforceavailablemodels">925<h3 id="enforceavailablemodels">

926 `enforceAvailableModels`926 `enforceAvailableModels`

974 `fastMode`974 `fastMode`

975</h3>975</h3>

976 976

977Ative o [modo rápido](/docs/pt/fast-mode) para sessões onde está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo onde você quer velocidade a um custo mais alto por token. Você normalmente não edita essa chave manualmente: executar `/fast` escreve `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave. O modo rápido funciona apenas em Opus 5 e Opus 4.8: ativá-lo de outro modelo o muda para Opus, e mudar para um modelo não suportado o desativa. Consulte [Mude de modelos enquanto o modo rápido está ativado](/docs/pt/fast-mode#switch-models-while-fast-mode-is-on).977Ative o [modo rápido](/docs/pt/fast-mode) para sessões onde está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo onde você quer velocidade a um custo mais alto por token. Você normalmente não edita essa chave manualmente: executar `/fast` escreve `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave. O modo rápido funciona apenas em Opus 5.5, Opus 5 e Opus 4.8: ativá-lo de outro modelo o muda para Opus, e mudar para um modelo não suportado o desativa. Consulte [Mude de modelos enquanto o modo rápido está ativado](/docs/pt/fast-mode#switch-models-while-fast-mode-is-on).

978 978

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

980* **Tipo**: Boolean980* **Tipo**: Boolean

993 `fastModePerSessionOptIn`993 `fastModePerSessionOptIn`

994</h3>994</h3>

995 995

996Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário de uma pessoa, então o modo rápido está ativado no início de cada sessão posterior. Defina essa chave como `true` para parar isso: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, e cada pessoa tem que executar `/fast` em cada sessão que o quer. Claude Code deixa a chave `fastMode` em seu arquivo, então desativar essa chave restaura o comportamento antigo. Proprietários em planos Team ou Enterprise podem implantá-lo em toda a organização através de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings).996Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário de uma pessoa, então o modo rápido está ativado no início de cada sessão posterior. Defina essa chave como `true` para parar isso: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, e cada pessoa tem que executar `/fast` em cada sessão que o quer. Claude Code deixa a chave `fastMode` em seu arquivo, então desativar essa chave restaura o comportamento antigo.

997

998Proprietários em planos Team ou Enterprise podem implantá-lo em toda a organização através de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings). Quando as configurações gerenciadas definem a chave, `/fast on` é recusado fora de sessões de terminal interativas e relata que sua organização desativou o modo rápido. Isso cobre [modo não interativo](/docs/pt/headless), a [extensão VS Code](/docs/pt/vs-code) e [sessões na nuvem](/docs/pt/claude-code-on-the-web).

997 999

998* **Escopo**: [`Qualquer arquivo`](#scopes)1000* **Escopo**: [`Qualquer arquivo`](#scopes)

999* **Tipo**: Boolean1001* **Tipo**: Boolean

1013 `language`1015 `language`

1014</h3>1016</h3>

1015 1017

1016Faça Claude responder em um idioma diferente do inglês por padrão. Não há lista fixa para respostas: Claude Code adiciona o valor verbatim ao prompt do sistema como uma instrução para sempre responder nesse idioma, então qualquer nome de idioma que Claude possa ler funciona. Claude Code não verifica o valor, então um nome digitado incorretamente chega a Claude como escrito em vez de produzir um erro. O mesmo valor define o idioma para [ditado de voz](/docs/pt/voice-dictation#change-the-dictation-language), que tem uma lista fixa de [idiomas de ditado suportados](/docs/pt/voice-dictation#change-the-dictation-language), e para títulos de sessão gerados automaticamente.1018Faça Claude responder em um idioma diferente do inglês por padrão. Não há lista fixa para respostas: Claude Code passa o valor verbatim para Claude como uma instrução para sempre responder nesse idioma, então qualquer nome de idioma que Claude possa ler funciona. Claude Code não verifica o valor, então um nome digitado incorretamente chega a Claude como escrito em vez de produzir um erro. O mesmo valor define o idioma para [ditado de voz](/docs/pt/voice-dictation#change-the-dictation-language), que tem uma lista fixa de [idiomas de ditado suportados](/docs/pt/voice-dictation#change-the-dictation-language), e para títulos de sessão gerados automaticamente.

1017 1019

1018* **Escopo**: [`Qualquer arquivo`](#scopes)1020* **Escopo**: [`Qualquer arquivo`](#scopes)

1019* **Tipo**: string, qualquer nome de idioma, como `"japanese"`, `"spanish"` ou `"french"`; Claude Code não o valida1021* **Tipo**: string, qualquer nome de idioma, como `"japanese"`, `"spanish"` ou `"french"`; Claude Code não o valida

1208 `modelSettings`1210 `modelSettings`

1209</h3>1211</h3>

1210 1212

1211Salve um [nível de esforço](/docs/pt/model-config#adjust-effort-level) para cada modelo que você usa. Em uma sessão interativa em sua máquina, quando você salva `low`, `medium`, `high` ou `xhigh` como seu padrão com `/effort` ou o controle deslizante de esforço do seletor `/model`, Claude Code escreve esse nível aqui sob o modelo que você está usando, então você raramente edita essa chave você mesmo. A entrada [`effortLevel`](#effortlevel) lista as sessões onde `/effort` se aplica apenas a essa sessão. Requer Claude Code v2.1.251 ou posterior.1213Salve um [nível de esforço](/docs/pt/model-config#adjust-effort-level) para cada modelo que você usa. Requer Claude Code v2.1.251 ou posterior.

1214

1215Em uma sessão interativa em sua máquina, quando você salva `low`, `medium`, `high` ou `xhigh` como seu padrão com `/effort` ou o controle deslizante de esforço do seletor `/model`, Claude Code escreve esse nível aqui sob o modelo que você está usando, então você raramente edita essa chave você mesmo. Quando você escolhe um desses níveis no [seletor de modelo da extensão VS Code](/docs/pt/vs-code#use-the-prompt-box), Claude Code salva-o aqui da mesma forma. A entrada [`effortLevel`](#effortlevel) lista as sessões onde `/effort` se aplica apenas a essa sessão.

1212 1216

1213Edite a chave manualmente para alterar ou remover um nível que você salvou.1217Edite a chave manualmente para alterar ou remover um nível que você salvou.

1214 1218

1215Um `effortLevel` de um modelo aqui tem precedência sobre o [`effortLevel`](#effortlevel) de nível superior no mesmo arquivo de configurações. Entre arquivos, Claude Code resolve cada modelo separadamente: o arquivo de configurações de maior precedência [settings file](/docs/pt/settings#settings-precedence) que define um `effortLevel` para esse modelo ou o `effortLevel` de nível superior decide, então um `effortLevel` em configurações gerenciadas supera um nível que você salvou em configurações de usuário. [Ajuste o nível de esforço](/docs/pt/model-config#adjust-effort-level) lista o que mais pode substituir um nível salvo, como `--effort` no lançamento.1219Um `effortLevel` de um modelo aqui tem precedência sobre o [`effortLevel`](#effortlevel) de nível superior no mesmo arquivo de configurações. Entre arquivos, Claude Code resolve cada modelo separadamente: o arquivo de configurações de maior precedência [settings file](/docs/pt/settings#settings-precedence) que define um `effortLevel` para esse modelo ou o `effortLevel` de nível superior que [se aplica a esse modelo](#effortlevel) decide, então um `effortLevel` em configurações gerenciadas supera um nível que você salvou em configurações de usuário. [Ajuste o nível de esforço](/docs/pt/model-config#adjust-effort-level) lista o que mais pode substituir um nível salvo, como `--effort` no lançamento.

1216 1220

1217Para limitar o esforço de um modelo em vez de definir seu nível, adicione um campo [`maxEffortLevel`](#maxeffortlevel) à entrada desse modelo. O campo requer Claude Code v2.1.267 ou posterior.1221Para limitar o esforço de um modelo em vez de definir seu nível, adicione um campo [`maxEffortLevel`](#maxeffortlevel) à entrada desse modelo. O campo requer Claude Code v2.1.267 ou posterior.

1218 1222

1220* **Tipo**: objeto mapeando um nome de modelo para um objeto com um campo `effortLevel`, um de `"low"`, `"medium"`, `"high"` ou `"xhigh"`, um campo [`maxEffortLevel`](#maxeffortlevel) ou ambos1224* **Tipo**: objeto mapeando um nome de modelo para um objeto com um campo `effortLevel`, um de `"low"`, `"medium"`, `"high"` ou `"xhigh"`, um campo [`maxEffortLevel`](#maxeffortlevel) ou ambos

1221* **Padrão**: sem definir1225* **Padrão**: sem definir

1222 1226

1223Claude Code escreve cada entrada sob o nome canônico do modelo, como `claude-opus-5`, e corresponde ao alias desse modelo, com sufixo de data, `[1m]` e IDs específicos do provedor reconhecidos à mesma entrada.1227Claude Code escreve cada entrada sob o nome canônico do modelo, como `claude-opus-5-5`, e corresponde ao alias desse modelo, com sufixo de data, `[1m]` e IDs específicos do provedor reconhecidos à mesma entrada.

1224 1228

1225Este exemplo mantém Opus 5 em `medium` enquanto outros modelos usam seus próprios níveis salvos ou padrão:1229Este exemplo mantém Opus 5.5 em `high` enquanto outros modelos usam seus próprios níveis salvos ou padrão:

1226 1230

1227```json settings.json theme={null}1231```json settings.json theme={null}

1228{1232{

1229 "modelSettings": {1233 "modelSettings": {

1230 "claude-opus-5": {1234 "claude-opus-5-5": {

1231 "effortLevel": "medium"1235 "effortLevel": "high"

1232 }1236 }

1233 }1237 }

1234}1238}

1839 `sandbox.excludedCommands`1843 `sandbox.excludedCommands`

1840</h3>1844</h3>

1841 1845

1842Nomeie comandos que Claude Code sempre executa fora do sandbox, como ferramentas que não funcionam sob ele. Cada entrada usa a mesma sintaxe do conteúdo de uma [regra de permissão](/docs/pt/permissions#permission-rule-syntax) `Bash(...)`: um comando exato, um prefixo como `docker *` ou um padrão curinga. Quando qualquer parte de um comando composto corresponde a uma entrada, Claude Code executa o comando inteiro sem sandbox.1846Nomeie comandos que Claude Code executa fora do sandbox, como ferramentas que não funcionam sob ele. Cada entrada usa a mesma sintaxe do conteúdo de uma [regra de permissão](/docs/pt/permissions#permission-rule-syntax) `Bash(...)`: um comando exato, um prefixo como `docker *` ou um padrão curinga.

1847

1848Suas entradas tiram uma chamada Bash do sandbox apenas quando cobrem cada comando nela, e algumas formas de chamada permanecem em sandbox mesmo assim. Uma entrada `docker *` sozinha não tira `npm ci && docker build .` do sandbox.

1843 1849

1844* **Scope**: [`Any file`](#scopes)1850* **Scope**: [`Any file`](#scopes)

1845* **Type**: array de padrões de comando1851* **Type**: array de padrões de comando

1853}1859}

1854```1860```

1855 1861

1862Claude Code mantém uma chamada Bash em sandbox quando ela tem uma destas formas, entre outras:

1863

1864* Um comando começando com `sudo`, `eval` ou `xargs`

1865* Um `cd`, `pushd` ou `popd`, onde quer que apareça na chamada

1866* Uma substituição de comando, um subshell ou um bloco de fluxo de controle como `if` ou `for`

1867* Um redirecionamento, como `docker build . > build.log`, outro que não apenas duplica um descritor de arquivo, como `2>&1` faz

1868* Um nome de comando que vem de uma variável

1869

1870Por exemplo, `cd build && docker compose up` permanece em sandbox sob uma entrada `docker *`, e adicionar uma entrada `cd` não muda isso.

1871

1856Comandos excluídos ainda passam pelo fluxo de permissão regular. Exclusão é uma conveniência, não uma barreira de segurança: prefira [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite) quando uma ferramenta só precisa escrever em algum lugar específico. Claude Code mescla entradas em todos os escopos de configurações que a sessão carrega, e não há bloqueio somente gerenciado para essa lista, então mantenha uma lista gerenciada estreita.1872Comandos excluídos ainda passam pelo fluxo de permissão regular. Exclusão é uma conveniência, não uma barreira de segurança: prefira [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite) quando uma ferramenta só precisa escrever em algum lugar específico. Claude Code mescla entradas em todos os escopos de configurações que a sessão carrega, e não há bloqueio somente gerenciado para essa lista, então mantenha uma lista gerenciada estreita.

1857 1873

1858<h3 id="sandbox-allowunsandboxedcommands">1874<h3 id="sandbox-allowunsandboxedcommands">

1905}1921}

1906```1922```

1907 1923

1908Claude Code impõe essas listas no limite do sandbox do SO, então elas se aplicam a cada subprocesso que um comando em sandbox inicia, como `kubectl`, `terraform` ou `npm`, não apenas às ferramentas de arquivo do Claude. Claude Code adiciona suas [regras de permissão](/docs/pt/sandboxing#permission-rules) às mesmas listas: regras `Edit` allow e deny para `allowWrite` e `denyWrite`, regras `Read` deny para `denyRead` e regras `WebFetch(domain:...)` allow e deny para as listas de domínio [`network`](#sandbox-network).1924Claude Code impõe essas listas no limite do sandbox do SO, então elas se aplicam a cada subprocesso que um comando em sandbox inicia, como `kubectl`, `terraform` ou `npm`. Claude Code adiciona suas [regras de permissão](/docs/pt/sandboxing#permission-rules) às mesmas listas: regras `Edit` allow e deny para `allowWrite` e `denyWrite`, regras `Read` deny para `denyRead` e regras `WebFetch(domain:...)` allow e deny para as listas de domínio [`network`](#sandbox-network).

1909 1925

1910A menos que um bloqueio somente gerenciado seja definido, Claude Code mescla cada lista nos arquivos de configurações que a sessão carrega. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) limita `allowRead` a entradas de configurações gerenciadas, e [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) faz o mesmo para domínios permitidos.1926A menos que um bloqueio somente gerenciado seja definido, Claude Code mescla cada lista nos arquivos de configurações que a sessão carrega. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) limita `allowRead` a entradas de configurações gerenciadas, e [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) faz o mesmo para domínios permitidos.

1911 1927

3066 `taskOutputMaxChars`3082 `taskOutputMaxChars`

3067</h3>3083</h3>

3068 3084

3069Defina quantos caracteres da saída de uma [tarefa de background](/docs/pt/tools-reference#background-commands) Claude recebe inline quando Claude lê a tarefa com a ferramenta `TaskOutput`. Quando a saída de uma tarefa concluída é mais longa, Claude recebe os caracteres mais recentes. Aumente o limite quando suas tarefas de background rotineiramente produzem mais saída que o padrão. Requer Claude Code v2.1.261 ou posterior.3085<Warning>

~~3070~~ 3086 Removido em v2.1.277, junto com a ferramenta `TaskOutput` que ele dimensionava. Defini-lo não tem efeito nas versões atuais. Claude lê um [arquivo de saída](/docs/pt/tools-reference#background-commands) de tarefa de background com `Read` em vez disso.

3071* **Scope**: [`Any file`](#scopes)3087</Warning>

3072* **Type**: número de caracteres, um inteiro positivo. Claude Code limita o valor ao intervalo `4000` a `128000`

3073* **Default**: não definido, então Claude recebe até 32.000 caracteres inline

~~3074~~

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

3076{

3077 "taskOutputMaxChars": 100000

3078}

3079```

3080 3088

3081Quando você define essa chave, Claude Code ignora a variável de ambiente [`TASK_MAX_OUTPUT_LENGTH`](/docs/pt/env-vars).3089Até v2.1.276, você definia essa chave para o número de caracteres da saída de uma [tarefa de background](/docs/pt/tools-reference#background-commands) que Claude recebia inline quando lia a tarefa com a ferramenta `TaskOutput`.

3082 3090

3083<h2 id="interface-and-terminal">3091<h2 id="interface-and-terminal">

3084 Interface e terminal3092 Interface e terminal

3994 4002

3995Para ocultar toda a atribuição, defina [`commit`](#attribution-commit) e [`pr`](#attribution-pr) como strings vazias e [`sessionUrl`](#attribution-sessionurl) como `false`. Depois que você definir `commit` ou `pr`, Claude Code ignora a configuração `includeCoAuthoredBy` descontinuada e usa seu texto padrão para qualquer um dos dois que você deixou não definido.4003Para ocultar toda a atribuição, defina [`commit`](#attribution-commit) e [`pr`](#attribution-pr) como strings vazias e [`sessionUrl`](#attribution-sessionurl) como `false`. Depois que você definir `commit` ou `pr`, Claude Code ignora a configuração `includeCoAuthoredBy` descontinuada e usa seu texto padrão para qualquer um dos dois que você deixou não definido.

3996 4004

4005Claude Code informa a Claude que suas próprias instruções sobre atribuição, como uma regra CLAUDE.md ou [memory](/docs/pt/memory), têm precedência sobre essas linhas de commit e PR, a menos que a linha esteja definida em [managed settings](/docs/pt/managed-settings).

4006

3997<h3 id="includecoauthoredby">4007<h3 id="includecoauthoredby">

3998 `includeCoAuthoredBy`4008 `includeCoAuthoredBy`

3999</h3>4009</h3>

4022 `includeGitInstructions`4032 `includeGitInstructions`

4023</h3>4033</h3>

4024 4034

4025No início da sessão, Claude Code adiciona duas partes relacionadas a git ao prompt de Claude: suas instruções integradas sobre como escrever commits e pull requests, na descrição da ferramenta Bash, e um snapshot de status git do seu repositório no prompt do sistema, significando o branch atual, o branch principal, saída de `git status` e commits recentes. Defina esta chave como `false` para deixar ambas de fora, por exemplo quando você usa suas próprias skills de fluxo de trabalho git.4035Claude Code fornece a Claude duas partes relacionadas a git de contexto: suas instruções integradas sobre como escrever commits e pull requests, na descrição da ferramenta Bash, e um snapshot de status git do seu repositório. O snapshot contém o branch atual, o branch principal, saída de `git status` e commits recentes. Claude Code o lê quando uma conversa começa.

4036

4037Defina esta chave como `false` para deixar ambas de fora, por exemplo quando você usa suas próprias skills de fluxo de trabalho git.

4026 4038

4027* **Escopo**: [`Qualquer arquivo`](#scopes)4039* **Escopo**: [`Qualquer arquivo`](#scopes)

4028* **Tipo**: Boolean4040* **Tipo**: Boolean

4627| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` obrigatório; `ref` é um branch ou tag; `path` é um subdiretório |4639| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` obrigatório; `ref` é um branch ou tag; `path` é um subdiretório |

4628| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` obrigatório; `ref` e `path` como para `github` |4640| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` obrigatório; `ref` e `path` como para `github` |

4629| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` obrigatório; `headers` adiciona cabeçalhos HTTP para acesso autenticado |4641| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` obrigatório; `headers` adiciona cabeçalhos HTTP para acesso autenticado |

4630| `npm` | `{ "source": "npm", "package": "@acme-corp/claude-plugins" }` | `package` obrigatório, o pacote npm que contém `marketplace.json` |

4631| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` obrigatório, o caminho absoluto para um arquivo `marketplace.json` |4642| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` obrigatório, o caminho absoluto para um arquivo `marketplace.json` |

4632| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` obrigatório, o caminho absoluto para um diretório contendo `.claude-plugin/marketplace.json` |4643| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` obrigatório, o caminho absoluto para um diretório contendo `.claude-plugin/marketplace.json` |

4633| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` obrigatório, um regex correspondido contra o host do marketplace |4644| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` obrigatório, um regex correspondido contra o host do marketplace |

5905}5916}

5906```5917```

5907 5918

5908Defina 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) para os requisitos do script e onde Claude Code relata um auxiliar com falha.5919Defina 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) para os requisitos do script e o que acontece quando o auxiliar falha.

5909 5920

5910<h2 id="updates-and-versioning">5921<h2 id="updates-and-versioning">

5911 Atualizações e versionamento5922 Atualizações e versionamento

5940Impeça que atualizações automáticas em segundo plano e `claude update` instalem qualquer versão abaixo desta, para que mudar para o canal `"stable"` não o faça fazer downgrade de um build `"latest"` mais recente. Claude Code escreve esta chave para você quando você escolhe permanecer em sua versão atual ao mudar de canais em `/config`, e a limpa quando você volta para `"latest"`.5951Impeça que atualizações automáticas em segundo plano e `claude update` instalem qualquer versão abaixo desta, para que mudar para o canal `"stable"` não o faça fazer downgrade de um build `"latest"` mais recente. Claude Code escreve esta chave para você quando você escolhe permanecer em sua versão atual ao mudar de canais em `/config`, e a limpa quando você volta para `"latest"`.

5941 5952

5942* **Escopo**: [`Any file`](#scopes). Defina-o em configurações gerenciadas para fixar um mínimo em toda a organização que as configurações de usuário e projeto não possam reduzir.5953* **Escopo**: [`Any file`](#scopes). Defina-o em configurações gerenciadas para fixar um mínimo em toda a organização que as configurações de usuário e projeto não possam reduzir.

5943* **Tipo**: string, um número de versão como `"2.1.100"`5954* **Tipo**: string, um número de versão como `"2.1.100"`; um valor que não é uma versão válida é ignorado

5944* **Padrão**: não definido, então as atualizações podem instalar qualquer versão que o canal oferece5955* **Padrão**: não definido, então as atualizações podem instalar qualquer versão que o canal oferece

5945 5956

5946Este exemplo segue o canal stable e recusa instalar qualquer versão abaixo de 2.1.100:5957Este exemplo segue o canal stable e recusa instalar qualquer versão abaixo de 2.1.100:

skills.md +51 −47

Details

120 Escolha onde as skills carregam120 Escolha onde as skills carregam

121</h2>121</h2>

122 122

123Onde você salva uma skill decide quais sessões a carregam. Salve-a em seu diretório inicial para obtê-la em todos os projetos, confirme-a em um repositório para compartilhá-la com todos que trabalham lá, ou distribua-a através de um plugin ou configurações gerenciadas para alcançar toda uma equipe.123Onde você salva uma skill decide quais sessões a carregam. Salve-a no seu diretório inicial para obtê-la em todos os projetos, confirme-a em um repositório para compartilhá-la com todos que trabalham lá, ou distribua-a através de um plugin ou configurações gerenciadas para alcançar um time inteiro.

124 124

126| :------------------ | :--------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |126| :------------------ | :--------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

127| Enterprise | `.claude/skills/<skill-name>/SKILL.md` no [diretório de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms) | Todos os usuários em máquinas onde sua organização a implanta |127| Enterprise | `.claude/skills/<skill-name>/SKILL.md` no [diretório de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms) | Todos os usuários em máquinas onde sua organização a implanta |

128| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Todos os seus projetos nesta máquina, mas não em [sessões Cowork ou cloud](#skills-in-cowork-and-cloud-sessions) |128| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Todos os seus projetos nesta máquina, mas não em [sessões Cowork ou cloud](#skills-in-cowork-and-cloud-sessions) |

130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Sessões iniciadas em ou abaixo de `<subdir>`. Uma sessão iniciada acima dela carrega a skill uma vez que Claude trabalha em arquivos lá. Veja [monorepos e subdiretórios](#discovery-from-parent-and-nested-directories) |130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Sessões iniciadas em ou abaixo de `<subdir>`. Uma sessão iniciada acima dela carrega a skill uma vez que Claude trabalha em arquivos lá. Veja [monorepos e subdiretórios](#discovery-from-parent-and-nested-directories) |

131| Diretório adicional | `.claude/skills/<skill-name>/SKILL.md` em um diretório que você passa com `--add-dir` | Essa sessão. Veja [diretórios fora do projeto](#skills-from-additional-directories) |131| Diretório adicional | `.claude/skills/<skill-name>/SKILL.md` em um diretório que você passa com `--add-dir` | Essa sessão. Veja [diretórios fora do projeto](#skills-from-additional-directories) |

133| Conta claude.ai | Skills habilitadas para sua conta claude.ai | Sessões Cowork, sessões cloud e sessões de terminal onde você faz login com essa conta. Veja [Skills sincronizadas do claude.ai](#how-synced-skills-behave) |133| Conta claude.ai | Skills habilitadas para sua conta claude.ai | Sessões Cowork, sessões cloud e sessões de terminal onde você entra com essa conta. Veja [Skills sincronizadas do claude.ai](#how-synced-skills-behave) |

134 134

135As pastas de skill também seguem estas regras:135As pastas de skill também seguem estas regras:

136 136

137* **Pastas com symlink**: uma entrada `<skill-name>` no local enterprise, personal ou project pode ser um symlink para um diretório em outro lugar no disco. Claude Code lê `SKILL.md` do alvo e carrega a skill uma vez mesmo que vários locais apontem para o mesmo alvo. Skills de plugin [lidam com symlinks de forma diferente](/docs/pt/plugins-reference#share-files-within-a-marketplace-with-symlinks).137* **Pastas com symlink**: uma entrada `<skill-name>` na localização enterprise, personal ou project pode ser um symlink para um diretório em outro lugar no disco. Claude Code lê `SKILL.md` do alvo e carrega a skill uma vez mesmo que vários locais apontem para o mesmo alvo. Skills de plugin [lidam com symlinks de forma diferente](/docs/pt/plugins-reference#share-files-within-a-marketplace-with-symlinks).

138* **Nome reservado**: não nomeie uma pasta de skill como `synced`, em qualquer capitalização. Claude Code usa `~/.claude/skills/synced/` para [skills baixadas do claude.ai](#where-synced-skills-load) e pula uma skill que você cria com esse nome nos locais enterprise, personal e project.138* **Nome reservado**: não nomeie uma pasta de skill como `synced`, em qualquer capitalização. Claude Code usa `~/.claude/skills/synced/` para [skills baixadas do claude.ai](#where-synced-skills-load) e pula uma skill que você cria com esse nome nas localizações enterprise, personal e project.

139* **Arquivos de comando**: um arquivo Markdown em `.claude/commands/` é o formato mais antigo e ainda funciona. Ele suporta o mesmo [frontmatter](#frontmatter-reference) exceto `name` e `paths`. Para encontrar o nome que você digita para invocá-lo, veja [Como uma skill obtém seu nome de comando](#how-a-skill-gets-its-command-name). Prefira uma skill para novo trabalho, já que skills também suportam [arquivos de suporte](#add-supporting-files).139* **Arquivos de comando**: um arquivo Markdown em `.claude/commands/` é o formato mais antigo e ainda funciona. Ele suporta o mesmo [frontmatter](#frontmatter-reference) exceto `name` e `paths`. Para encontrar o nome que você digita para invocá-lo, veja [Como uma skill obtém seu nome de comando](#how-a-skill-gets-its-command-name). Prefira uma skill para novo trabalho, já que skills também suportam [arquivos de suporte](#add-supporting-files).

140* **Pasta de skill como um plugin**: 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 um projeto, isso requer aceitar primeiro o diálogo de confiança do workspace.140* **Pasta de skill como um plugin**: 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 primeiro o diálogo de confiança do workspace.

141 141

142<h3 id="discovery-from-parent-and-nested-directories">142<h3 id="discovery-from-parent-and-nested-directories">

143 Carregue skills em monorepos e subdiretórios143 Carregue skills em monorepos e subdiretórios

144</h3>144</h3>

145 145

146Claude Code carrega skills de projeto de `.claude/skills/` no diretório onde você o inicia e em cada diretório pai até a raiz do repositório, então iniciar em `packages/frontend/` ainda pega skills definidas na raiz. Quando você [move a sessão com `/cd`](/docs/pt/permissions#move-the-session-to-another-directory) na v2.1.246 ou posterior, Claude Code adiciona as skills de projeto do novo diretório.146Claude Code carrega skills de projeto de `.claude/skills/` no diretório onde você o inicia e em todos os diretórios pai até a raiz do repositório, então iniciar em `packages/frontend/` ainda pega skills definidas na raiz. Quando você [move a sessão com `/cd`](/docs/pt/permissions#move-the-session-to-another-directory) na v2.1.246 ou posterior, Claude Code adiciona as skills de projeto do novo diretório.

147 147

148Skills em um diretório `.claude/skills/` abaixo de onde você iniciou não carregam na inicialização. Elas carregam na primeira vez que Claude lê ou edita um arquivo naquele subdiretório e permanecem disponíveis pelo resto da sessão. Até então elas não aparecem no menu `/` e você não pode invocá-las pelo nome. Para carregá-las mais cedo, execute `/add-dir` com o caminho do subdiretório, o que requer Claude Code v2.1.257 ou posterior.148Em uma sessão executada em um [git worktree](/docs/pt/worktrees) vinculado, Claude Code pesquisa diretórios pai apenas até a raiz do worktree. No Claude Code v2.1.277 ou posterior, quando o checkout do worktree não tem um diretório `.claude/skills` em sua raiz, Claude Code carrega as skills de projeto do checkout principal. Veja [O que worktrees compartilham com o checkout principal](/docs/pt/worktrees#what-worktrees-share-with-the-main-checkout).

149

150Skills em um diretório `.claude/skills/` abaixo de onde você iniciou não carregam na inicialização. Elas carregam na primeira vez que Claude lê ou edita um arquivo naquele subdiretório e permanecem disponíveis pelo resto da sessão. Até então elas não aparecem no menu `/` e você não pode invocá-las por nome. Para carregá-las mais cedo, execute `/add-dir` com o caminho do subdiretório, o que requer Claude Code v2.1.257 ou posterior.

149 151

150Quando uma skill aninhada compartilha um nome com outra skill, ambas permanecem disponíveis. Com uma skill `deploy` na raiz do repositório e outra em `apps/web/.claude/skills/`:152Quando uma skill aninhada compartilha um nome com outra skill, ambas permanecem disponíveis. Com uma skill `deploy` na raiz do repositório e outra em `apps/web/.claude/skills/`:

151 153

152* `/deploy` executa a skill raiz. Claude Code também lista as variantes qualificadas por diretório para Claude, com uma instrução para invocar aquela cujo diretório contém os arquivos em que está trabalhando, para que a skill aninhada ainda se aplique ao trabalho em `apps/web/`.154* `/deploy` executa a skill da raiz. Claude Code também lista as variantes qualificadas por diretório para Claude, com uma instrução para invocar aquela cujo diretório contém os arquivos em que está trabalhando, então a skill aninhada ainda se aplica ao trabalho em `apps/web/`.

153* `/apps/web:deploy` executa a skill aninhada por conta própria. Sua descrição nomeia o diretório ao qual se aplica.155* `/apps/web:deploy` executa a skill aninhada por conta própria. Sua descrição nomeia o diretório ao qual se aplica.

154 156

155<h3 id="skills-from-additional-directories">157<h3 id="skills-from-additional-directories">

158 160

159Quando você adiciona um diretório com `--add-dir` ou `/add-dir`, Claude Code carrega as skills no `.claude/skills/` daquele diretório, junto com seu `.claude/commands/` e `.claude/agents/`. Diretórios que o Agent SDK adiciona através de [`additionalDirectories`](/docs/pt/agent-sdk/typescript#options) em TypeScript ou [`add_dirs`](/docs/pt/agent-sdk/python#claudeagentoptions) em Python carregam da mesma forma, porque o SDK os passa como `--add-dir`. A configuração `permissions.additionalDirectories` em `settings.json` concede apenas acesso a arquivos e não carrega nenhum destes.161Quando você adiciona um diretório com `--add-dir` ou `/add-dir`, Claude Code carrega as skills no `.claude/skills/` daquele diretório, junto com seu `.claude/commands/` e `.claude/agents/`. Diretórios que o Agent SDK adiciona através de [`additionalDirectories`](/docs/pt/agent-sdk/typescript#options) em TypeScript ou [`add_dirs`](/docs/pt/agent-sdk/python#claudeagentoptions) em Python carregam da mesma forma, porque o SDK os passa como `--add-dir`. A configuração `permissions.additionalDirectories` em `settings.json` concede apenas acesso a arquivos e não carrega nenhum destes.

160 162

161Claude Code observa `.claude/skills/` em um diretório que você passa com `--add-dir` na inicialização, como [Edite uma skill durante uma sessão](#live-change-detection) descreve. Ele não observa `.claude/commands/` ou `.claude/agents/` do diretório adicionado, então reinicie a sessão após alterar um arquivo lá.163Claude Code observa `.claude/skills/` em um diretório que você passa com `--add-dir` na inicialização, como [Edite uma skill durante uma sessão](#live-change-detection) descreve. Ele não observa o `.claude/commands/` ou `.claude/agents/` do diretório adicionado, então reinicie a sessão após alterar um arquivo lá.

162 164

163Esses carregamentos dependem da [fonte de configuração](/docs/pt/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) `project`, que está ativada por padrão. Uma política [`strictPluginOnlyCustomization`](/docs/pt/settings-reference#strictpluginonlycustomization), [modo bare](/docs/pt/headless#start-faster-with-bare-mode) e [`--safe-mode`](/docs/pt/cli-reference#cli-flags) cada uma as restringe ainda mais, como essas páginas descrevem. Veja [Diretórios adicionais concedem acesso a arquivos, não configuração](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) para a tabela completa do que um diretório adicionado carrega, incluindo `CLAUDE.md` e configurações de plugin.165Esses carregamentos dependem da [fonte de configuração](/docs/pt/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) `project`, que está ativada por padrão. Uma política [`strictPluginOnlyCustomization`](/docs/pt/settings-reference#strictpluginonlycustomization), [modo bare](/docs/pt/headless#start-faster-with-bare-mode) e [`--safe-mode`](/docs/pt/cli-reference#cli-flags) cada uma as restringe ainda mais, como essas páginas descrevem. Veja [Diretórios adicionais concedem acesso a arquivos, não configuração](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) para a tabela completa do que um diretório adicionado carrega, incluindo `CLAUDE.md` e configurações de plugin.

164 166

166 Resolva skills que compartilham um nome168 Resolva skills que compartilham um nome

167</h3>169</h3>

168 170

169Quando duas skills compartilham um nome, de onde cada uma veio decide qual `/name` executa. A tabela cobre os locais enterprise, personal, project, nested, plugin e claude.ai, skills agrupadas e arquivos de comando:171Quando duas skills compartilham um nome, de onde cada uma veio decide qual `/name` executa. A tabela cobre as localizações enterprise, personal, project, nested, plugin e claude.ai, skills agrupadas e arquivos de comando:

170 172

171| Mesmo nome em | Qual executa |173| Mesmo nome em | Qual executa |

172| :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |174| :-------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

173| Dois de enterprise, personal e project | Enterprise sobre personal, e personal sobre project. Com `deploy` em ambos `~/.claude/skills/` e `.claude/skills/` do projeto, `/deploy` executa a pessoal |175| Dois de enterprise, personal e project | Enterprise sobre personal, e personal sobre project. Com `deploy` em ambos `~/.claude/skills/` e o `.claude/skills/` do projeto, `/deploy` executa a pessoal |

174| Qualquer um desses locais e uma [skill agrupada](#bundled-skills) | Sua skill substitui o comando agrupado, mas não seus aliases. Uma skill `code-review` de projeto substitui `/code-review`, e o alias agrupado `/review` nunca executa sua skill |176| Qualquer uma dessas localizações e uma [skill agrupada](#bundled-skills) | Sua skill substitui o comando agrupado, mas não seus aliases. Uma skill `code-review` de projeto substitui `/code-review`, e o alias agrupado `/review` nunca executa sua skill |

176| Uma skill raiz de projeto e uma skill aninhada | Ambas carregam. Veja [monorepos e subdiretórios](#discovery-from-parent-and-nested-directories) |178| Uma skill de raiz de projeto e uma skill aninhada | Ambas carregam. Veja [monorepos e subdiretórios](#discovery-from-parent-and-nested-directories) |

177| Uma skill de plugin e uma skill em qualquer um dos locais acima | Ambas carregam, porque skills de plugin são nomeadas como `/plugin-name:skill-name` |179| Uma skill de plugin e uma skill em qualquer uma das localizações acima | Ambas carregam, porque skills de plugin são nomeadas como `/plugin-name:skill-name` |

178| Qualquer um dos acima e uma skill [sincronizada do seu claude.ai](#how-synced-skills-behave) | A outra skill ou comando. A skill sincronizada ainda executa como `/anthropic-skills:<name>`. Veja [Quando um nome de skill sincronizada corresponde a outro comando](#when-a-synced-skill-name-matches-another-command) |180| Qualquer uma das acima e uma skill [sincronizada de sua conta claude.ai](#how-synced-skills-behave) | A outra skill ou comando. A skill sincronizada ainda executa como `/anthropic-skills:<name>`. Veja [Quando um nome de skill sincronizada corresponde a outro comando](#when-a-synced-skill-name-matches-another-command) |

179 181

180<h3 id="skills-in-cowork-and-cloud-sessions">182<h3 id="skills-in-cowork-and-cloud-sessions">

181 Use skills em sessões Cowork e cloud183 Use skills em sessões Cowork e cloud

182</h3>184</h3>

183 185

184Sessões [Cowork](https://claude.com/product/cowork) e [sessões cloud](/docs/pt/cloud-environments#what-carries-over-from-your-setup), incluindo [rotinas](/docs/pt/routines), não leem `~/.claude/skills/` em sua máquina. Sessões Cowork interativas e agendadas carregam as skills habilitadas para sua conta claude.ai, sincronizadas no início da sessão; gerencie-as em **Customize** na barra lateral do aplicativo Desktop ou nas configurações de skills em claude.ai. Sessões cloud adicionalmente carregam skills de projeto confirmadas no `.claude/skills/` do repositório clonado.186Sessões [Cowork](https://claude.com/product/cowork) e [sessões cloud](/docs/pt/cloud-environments#what-carries-over-from-your-setup), incluindo [rotinas](/docs/pt/routines), não leem `~/.claude/skills/` em sua máquina. Tanto sessões Cowork interativas quanto agendadas carregam as skills habilitadas para sua conta claude.ai, sincronizadas no início da sessão; gerencie-as em **Customize** na barra lateral do aplicativo Desktop ou nas configurações de skills no claude.ai. Sessões cloud adicionalmente carregam skills de projeto confirmadas no `.claude/skills/` do repositório clonado.

185 187

186Se uma skill existe apenas em `~/.claude/skills/` em sua máquina, Claude Code relata que a skill não foi encontrada quando uma [rotina](/docs/pt/routines) a invoca, porque cada execução de rotina começa como uma sessão cloud nova. Para disponibilizar uma skill pessoal nessas sessões:188Se uma skill existe apenas em `~/.claude/skills/` em sua máquina, Claude Code relata que a skill não foi encontrada quando uma [rotina](/docs/pt/routines) a invoca, porque cada execução de rotina inicia como uma sessão cloud nova. Para disponibilizar uma skill pessoal nessas sessões:

187 189

188* Para sessões Cowork e cloud, habilite a skill para sua conta claude.ai.190* Para sessões Cowork e cloud, habilite a skill para sua conta claude.ai.

189* Para sessões cloud, você pode em vez disso confirmar a skill no `.claude/skills/` do repositório, ou enviá-la em um plugin declarado no `.claude/settings.json` do repositório. Plugins declarados no repositório [instalam no início da sessão](/docs/pt/cloud-environments#what-carries-over-from-your-setup); plugins habilitados apenas em suas configurações de usuário não são transferidos.191* Para sessões cloud, você pode em vez disso confirmar a skill no `.claude/skills/` do repositório. Plugins declarados no `.claude/settings.json` do repositório e plugins habilitados apenas em suas configurações de usuário [não carregam em sessões cloud](/docs/pt/cloud-environments#what-carries-over-from-your-setup).

190 192

191[Tarefas agendadas do Desktop](/docs/pt/desktop-scheduled-tasks) executam localmente em sua máquina, então elas carregam `~/.claude/skills/`.193[Tarefas agendadas do Desktop](/docs/pt/desktop-scheduled-tasks) executam localmente em sua máquina, então elas carregam `~/.claude/skills/`.

192 194

194 Skills sincronizadas do claude.ai196 Skills sincronizadas do claude.ai

195</h3>197</h3>

196 198

197Esta seção se aplica a você se você usar sessões Cowork ou cloud, ou fizer login no Claude Code em seu terminal com uma conta claude.ai. Nessas sessões, Claude Code carrega as skills habilitadas para sua conta claude.ai, sem qualquer configuração em sua parte, como [Onde as skills sincronizadas carregam](#where-synced-skills-load) descreve. Essas skills incluem as que você cria ou ativa em suas configurações claude.ai, skills que sua organização fornece lá, e skills integradas da Anthropic como `pdf` e `xlsx`.199Esta seção se aplica a você se usar sessões Cowork ou cloud, ou entrar no Claude Code em seu terminal com uma conta claude.ai. Nessas sessões, Claude Code carrega as skills habilitadas para sua conta claude.ai, sem nenhuma configuração da sua parte, como [Onde as skills sincronizadas carregam](#where-synced-skills-load) descreve. Essas skills incluem aquelas que você cria ou ativa em suas configurações claude.ai, skills que sua organização fornece lá, e skills integradas da Anthropic como `pdf` e `xlsx`.

198 200

199Claude Code baixa uma skill sincronizada de sua conta em vez de ler um arquivo que você escreveu na máquina onde a sessão executa, então aplica regras a skills sincronizadas que não se aplicam às skills que você armazena nos [locais de skills](#where-skills-live).201Claude Code baixa uma skill sincronizada de sua conta em vez de ler um arquivo que você escreveu na máquina onde a sessão executa, então aplica regras a skills sincronizadas que não se aplicam às skills que você armazena nas [localizações de skills](#where-skills-live).

200 202

201<h4 id="where-synced-skills-load">203<h4 id="where-synced-skills-load">

202 Onde as skills sincronizadas carregam204 Onde as skills sincronizadas carregam

204 206

205Em uma sessão Cowork ou cloud, Claude Code carrega as skills habilitadas para sua conta claude.ai, e [Skills em sessões Cowork e cloud](#skills-in-cowork-and-cloud-sessions) diz como escolher quais skills essas sessões obtêm.207Em uma sessão Cowork ou cloud, Claude Code carrega as skills habilitadas para sua conta claude.ai, e [Skills em sessões Cowork e cloud](#skills-in-cowork-and-cloud-sessions) diz como escolher quais skills essas sessões obtêm.

206 208

207Em seu terminal, Claude Code sincroniza essas skills em sessões onde você faz login com sua conta claude.ai. Quando a sessão começa, Claude Code baixa as skills de sua conta em `~/.claude/skills/synced/` em segundo plano, então verifica claude.ai para mudanças a cada 10 minutos enquanto a sessão executa. Quando uma verificação descobre que uma skill foi adicionada, editada ou desativada em claude.ai, Claude Code adiciona, atualiza ou remove ela na sessão em execução sem uma reinicialização. A sincronização em sessões de terminal requer Claude Code v2.1.273 ou posterior.209Em seu terminal, Claude Code sincroniza essas skills em sessões onde você entra com sua conta claude.ai. Quando a sessão inicia, Claude Code baixa as skills de sua conta em `~/.claude/skills/synced/` em segundo plano, então verifica claude.ai para mudanças a cada 10 minutos enquanto a sessão executa. Quando uma verificação encontra que uma skill foi adicionada, editada ou desativada no claude.ai, Claude Code a adiciona, atualiza ou remove na sessão em execução sem uma reinicialização. A sincronização em sessões de terminal requer Claude Code v2.1.273 ou posterior.

208 210

209A sincronização nunca atrasa a inicialização, porque Claude aguarda o download de uma skill apenas quando a invoca. Uma execução curta [não interativa](/docs/pt/headless) pode portanto terminar antes que uma skill recém-adicionada baixe, caso em que uma sessão posterior a baixa. Para fazer uma execução não interativa baixar suas skills e aguardar a lista antes de responder ao prompt, defina [`CLAUDE_CODE_SYNC_SKILLS`](/docs/pt/env-vars#variables) como `1`.211A sincronização nunca atrasa a inicialização, porque Claude aguarda o download de uma skill apenas quando a invoca. Uma execução [não-interativa](/docs/pt/headless) curta pode portanto terminar antes que uma skill recém-adicionada baixe, caso em que uma sessão posterior a baixa. Para fazer uma execução não-interativa baixar suas skills e aguardar a lista antes de responder ao prompt, defina [`CLAUDE_CODE_SYNC_SKILLS`](/docs/pt/env-vars#variables) como `1`.

210 212

211Claude Code sincroniza apenas em uma sessão que faz login com sua conta claude.ai e [busca sinalizadores de recurso da Anthropic](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Ele não sincroniza nessas sessões:213Claude Code sincroniza apenas em uma sessão que entra com sua conta claude.ai e [busca sinalizadores de recurso da Anthropic](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Ele não sincroniza nessas sessões:

212 214

213* Uma sessão que não usa um login armazenado por `/login`, como uma que autentica com uma chave de API, ou uma onde `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` ou um script `apiKeyHelper` fornece a credencial215* Uma sessão que não usa um sign-in armazenado por `/login`, como uma que autentica com uma chave de API, ou uma onde `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` ou um script `apiKeyHelper` fornece a credencial

214* Uma sessão que não busca sinalizadores de recurso, como uma em Amazon Bedrock ou uma onde você define `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`216* Uma sessão que não busca sinalizadores de recurso, como uma no Amazon Bedrock ou uma onde você define `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

215* Uma sessão em [modo bare](/docs/pt/headless#start-faster-with-bare-mode) ou uma que você inicia com `--safe-mode`217* Uma sessão em [modo bare](/docs/pt/headless#start-faster-with-bare-mode) ou uma que você inicia com `--safe-mode`

216* Uma sessão onde as configurações gerenciadas de sua organização [bloqueiam skills para fontes de plugin](/docs/pt/settings-reference#strictpluginonlycustomization-skills), ou uma que você inicia com uma lista [`--setting-sources`](/docs/pt/cli-reference#cli-flags) que deixa de fora `user`218* Uma sessão onde as configurações gerenciadas de sua organização [bloqueiam skills para fontes de plugin](/docs/pt/settings-reference#strictpluginonlycustomization-skills), ou uma que você inicia com uma lista [`--setting-sources`](/docs/pt/cli-reference#cli-flags) que deixa de fora `user`

217 219

218Se você fizer login com `/login` durante uma sessão, reinicie Claude Code para começar a sincronizar.220Se você entrar com `/login` durante uma sessão, reinicie Claude Code para começar a sincronizar.

219 221

220Skills que uma sessão anterior sincronizou permanecem no disco. Claude Code as carrega em sessões posteriores conectadas à mesma conta, mesmo quando não consegue alcançar claude.ai.222Skills que uma sessão anterior sincronizou permanecem no disco. Claude Code as carrega em sessões posteriores conectadas à mesma conta, mesmo quando não consegue alcançar claude.ai.

221 223

222Para ver quais skills sincronizaram, execute `/skills`. O menu as lista em `claude.ai sync`.224Claude Code baixa skills sincronizadas e nunca as carrega. Se você ou Claude editar um arquivo sob `~/.claude/skills/synced/`, a alteração não é salva em sua conta claude.ai, e uma sincronização posterior pode sobrescrevê-la ou removê-la. Para alterar uma skill sincronizada, atualize-a no claude.ai; a próxima sincronização baixa a nova versão.

225

226Para ver quais skills sincronizaram, execute `/skills`. O menu as lista sob `claude.ai sync`.

223 227

224Algumas skills da Anthropic, como `pdf` e `xlsx`, sempre sincronizam. Para o resto, ative ou desative uma skill em suas configurações de skills em claude.ai para alterar se ela sincroniza.228Algumas skills da Anthropic, como `pdf` e `xlsx`, sempre sincronizam. Para o resto, ative ou desative uma skill em suas configurações de skills no claude.ai para alterar se ela sincroniza.

225 229

226Para parar de sincronizar em uma máquina, defina [`syncClaudeAiSkills`](/docs/pt/settings-reference#syncclaudeaiskills) como `false` em suas configurações de usuário. Claude Code para de baixar, e na próxima vez que inicia move as skills que já sincronizou para `~/.claude/skills/.trash/` e não as carrega mais. Sua organização pode desativar a sincronização para todos desativando Skills em claude.ai. Para parar de sincronizar enquanto deixa Skills ativado, ela pode definir a mesma chave em [configurações gerenciadas](/docs/pt/managed-settings).230Para parar de sincronizar em uma máquina, defina [`syncClaudeAiSkills`](/docs/pt/settings-reference#syncclaudeaiskills) como `false` em suas configurações de usuário. Claude Code para de baixar, e na próxima vez que inicia move as skills que já sincronizou para `~/.claude/skills/.trash/` e não as carrega mais. Sua organização pode desativar a sincronização para todos desativando Skills no claude.ai. Para parar de sincronizar deixando Skills ativado, pode definir a mesma chave em [configurações gerenciadas](/docs/pt/managed-settings).

227 231

228Se sua organização desativar Skills em claude.ai, Claude Code remove as skills baixadas e elas param de carregar. As skills removidas se movem para `~/.claude/skills/.trash/`, onde você pode recuperar os arquivos até a [limpeza de retenção](/docs/pt/claude-directory#cleaned-up-automatically) deletá-los. Uma vez que sua organização ativa Skills novamente, Claude Code baixa as skills que você habilitou na próxima sincronização.232Se sua organização desativar Skills no claude.ai, Claude Code remove as skills baixadas e elas param de carregar. As skills removidas se movem para `~/.claude/skills/.trash/`, onde você pode recuperar os arquivos até que a [varredura de retenção](/docs/pt/claude-directory#cleaned-up-automatically) os delete. Uma vez que sua organização ativa Skills novamente, Claude Code baixa as skills que você habilitou na próxima sincronização.

229 233

230<h4 id="when-a-synced-skill-name-matches-another-command">234<h4 id="when-a-synced-skill-name-matches-another-command">

231 Quando um nome de skill sincronizada corresponde a outro comando235 Quando um nome de skill sincronizada corresponde a outro comando

232</h4>236</h4>

233 237

234Você pode invocar uma skill sincronizada pelo seu nome completo, `/anthropic-skills:<name>`, ou pelo seu nome curto, `/<name>`. Quando outro comando usa esse nome curto, `/<name>` executa o outro comando, e a skill sincronizada executa apenas como `/anthropic-skills:<name>`. Com uma skill `deploy` local e uma `deploy` sincronizada, `/deploy` executa a skill local e `/anthropic-skills:deploy` executa a sincronizada. Antes da v2.1.269, uma skill sincronizada tinha apenas seu nome curto.238Você pode invocar uma skill sincronizada por seu nome completo, `/anthropic-skills:<name>`, ou por seu nome curto, `/<name>`. Quando outro comando usa esse nome curto, `/<name>` executa o outro comando, e a skill sincronizada executa apenas como `/anthropic-skills:<name>`. Com uma skill `deploy` local e uma `deploy` sincronizada, `/deploy` executa a skill local e `/anthropic-skills:deploy` executa a sincronizada. Antes da v2.1.269, uma skill sincronizada tinha apenas seu nome curto.

235 239

236O outro comando pode ser qualquer um destes:240O outro comando pode ser qualquer um destes:

237 241

238* Um comando integrado ou uma [skill agrupada](#bundled-skills), incluindo uma que não está disponível em sua sessão, por exemplo após você desativar skills agrupadas242* Um comando integrado ou uma [skill agrupada](#bundled-skills), incluindo uma que está indisponível em sua sessão, por exemplo após desativar skills agrupadas

239* Uma skill em qualquer [nível local](#where-skills-live) ou um arquivo em `.claude/commands/`243* Uma skill em qualquer [nível local](#where-skills-live) ou um arquivo em `.claude/commands/`

240* Uma skill de plugin244* Uma skill de plugin

241* Um [prompt MCP](/docs/pt/mcp#use-mcp-prompts-as-commands)245* Um [prompt MCP](/docs/pt/mcp#use-mcp-prompts-as-commands)

242 246

243Claude Code rotula skills sincronizadas para que você possa dizer de onde vieram. O menu `/skills` e `/context` agrupam skills sincronizadas em `claude.ai sync`, e o menu de comando `/` as marca como vindo do claude.ai.247Claude Code rotula skills sincronizadas para que você possa dizer de onde vieram. O menu `/skills` e `/context` agrupam skills sincronizadas sob `claude.ai sync`, e o menu de comando `/` as marca como vindo do claude.ai.

244 248

245Quando compara nomes, Claude Code ignora maiúsculas, espaçamento e caracteres invisíveis, e trata formas de compatibilidade como letras de largura completa e variantes de travessão como seus equivalentes simples. Por exemplo, uma skill sincronizada nomeada `Commit` e uma skill local nomeada `commit` contam como o mesmo nome, então `/commit` continua executando sua skill local.249Quando compara nomes, Claude Code ignora maiúsculas, espaçamento e caracteres invisíveis, e trata formas de compatibilidade como letras de largura completa e variantes de travessão como seus equivalentes simples. Por exemplo, uma skill sincronizada nomeada `Commit` e uma skill local nomeada `commit` contam como o mesmo nome, então `/commit` continua executando sua skill local.

246 250

253Claude Code aplica duas regras ao frontmatter de uma skill sincronizada:257Claude Code aplica duas regras ao frontmatter de uma skill sincronizada:

254 258

255* Claude Code honra o frontmatter em todo tipo de sessão, então uma concessão `allowed-tools` passa pelo [fluxo de permissão](/docs/pt/permissions) normal.259* Claude Code honra o frontmatter em todo tipo de sessão, então uma concessão `allowed-tools` passa pelo [fluxo de permissão](/docs/pt/permissions) normal.

256* Claude Code sanitiza o texto de exibição que a skill fornece, como sua descrição. Remove caracteres de controle, e em texto que chega a Claude, como a descrição, também escapa colchetes angulares para que o texto não possa imitar a formatação interna do Claude Code. Essa sanitização requer Claude Code v2.1.228 ou posterior.260* Claude Code sanitiza o texto de exibição que a skill fornece, como sua descrição. Remove caracteres de controle, e em texto que alcança Claude, como a descrição, também escapa colchetes angulares para que o texto não possa imitar a formatação interna do Claude Code. Esta sanitização requer Claude Code v2.1.228 ou posterior.

257 261

258<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">262<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">

259 Como Claude Code lida com o corpo de uma skill sincronizada263 Como Claude Code lida com o corpo de uma skill sincronizada

262O que Claude Code faz com o corpo de uma skill sincronizada depende de onde a sessão executa:266O que Claude Code faz com o corpo de uma skill sincronizada depende de onde a sessão executa:

263 267

264* Em uma sessão cloud, o corpo mantém o comportamento que uma skill local tem, porque a sessão executa em um contêiner isolado.268* Em uma sessão cloud, o corpo mantém o comportamento que uma skill local tem, porque a sessão executa em um contêiner isolado.

265* Em uma sessão Cowork em seu desktop, o corpo mantém o comportamento que uma skill local tem, exceto que Claude Code substitui cada linha de comando `!` pelo [placeholder `disableSkillShellExecution`](#inject-dynamic-context), como faz para cada skill que você fornece lá.269* Em uma sessão Cowork em seu desktop, o corpo mantém o comportamento que uma skill local tem, exceto que Claude Code substitui cada linha de comando `!` pelo placeholder [`disableSkillShellExecution`](#inject-dynamic-context), como faz para toda skill que você fornece lá.

266* Em qualquer outra sessão em sua máquina, Claude Code não executa [comandos `!`](#inject-dynamic-context), não anexa os arquivos que referências `@` nomeiam da forma que faz para uma skill local, e não substitui os placeholders `${CLAUDE_PROJECT_DIR}` e `${CLAUDE_SESSION_ID}`, então as referências `@` e ambos os placeholders chegam a Claude como texto literal. Uma linha de comando `!` chega a Claude como texto literal também, ou como esse placeholder quando `disableSkillShellExecution` está ativado. Esse tratamento requer Claude Code v2.1.228 ou posterior.270* Em qualquer outra sessão em sua máquina, Claude Code não executa [comandos `!`](#inject-dynamic-context), não anexa os arquivos que referências `@` nomeiam da forma que faz para uma skill local, e não substitui os placeholders `${CLAUDE_PROJECT_DIR}` e `${CLAUDE_SESSION_ID}`, então as referências `@` e ambos os placeholders alcançam Claude como texto literal. Uma linha de comando `!` alcança Claude como texto literal também, ou como esse placeholder quando `disableSkillShellExecution` está ativado. Este tratamento requer Claude Code v2.1.228 ou posterior.

267 271

268<h3 id="live-change-detection">272<h3 id="live-change-detection">

269 Edite uma skill durante uma sessão273 Edite uma skill durante uma sessão

270</h3>274</h3>

271 275

272Claude Code observa diretórios de skill para mudanças de arquivo, exceto em [modo bare](/docs/pt/headless#start-faster-with-bare-mode). Quando você adiciona, edita ou remove uma skill em `~/.claude/skills/`, o `.claude/skills/` do projeto, ou um `.claude/skills/` dentro de um diretório `--add-dir`, Claude Code pega a mudança dentro da sessão atual, sem uma reinicialização. Se você criar um diretório de skills de nível superior que não existia quando a sessão começou, reinicie Claude Code para que ele possa observar o novo diretório.276Claude Code observa diretórios de skill para mudanças de arquivo, exceto em [modo bare](/docs/pt/headless#start-faster-with-bare-mode). Quando você adiciona, edita ou remove uma skill sob `~/.claude/skills/`, o `.claude/skills/` do projeto, ou um `.claude/skills/` dentro de um diretório `--add-dir`, Claude Code pega a mudança dentro da sessão atual, sem uma reinicialização. Se você criar um diretório de skills de nível superior que não existia quando a sessão iniciou, reinicie Claude Code para que possa observar o novo diretório.

273 277

274A detecção de mudança ao vivo cobre apenas 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 vigor.278A detecção de mudança ao vivo cobre apenas 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 vigor.

275 279

279 283

280Como você remove uma skill depende de onde ela veio:284Como você remove uma skill depende de onde ela veio:

281 285

282* **Skill pessoal ou de projeto**: delete o diretório da skill, `~/.claude/skills/<skill-name>/` ou `.claude/skills/<skill-name>/`. Claude Code [a remove de `/skills` na sessão atual](#live-change-detection); o conteúdo que Claude Code já carregou dela segue o [ciclo de vida do conteúdo da skill](#skill-content-lifecycle).286* **Skill pessoal ou de projeto**: delete o diretório da skill, `~/.claude/skills/<skill-name>/` ou `.claude/skills/<skill-name>/`. Claude Code a [remove de `/skills` na sessão atual](#live-change-detection); conteúdo que Claude Code já carregou dela segue o [ciclo de vida do conteúdo da skill](#skill-content-lifecycle).

283* **Skill enterprise**: um administrador deleta o diretório da skill de `.claude/skills/` dentro do [diretório de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms), por exemplo `/etc/claude-code/.claude/skills/<skill-name>/` no Linux.287* **Skill enterprise**: um administrador deleta o diretório da skill de `.claude/skills/` dentro do [diretório de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms), por exemplo `/etc/claude-code/.claude/skills/<skill-name>/` no Linux.

284* **Skill de plugin**: desabilite ou desinstale o plugin que a fornece, do menu `/plugin` ou com `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code descarrega as skills do plugin quando [a mudança se aplica](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) ou quando você reinicia.288* **Skill de plugin**: desabilite ou desinstale o plugin que a fornece, do menu `/plugin` ou com `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code descarrega as skills do plugin quando [a mudança se aplica](/docs/pt/discover-plugins#apply-plugin-changes-without-restarting) ou quando você reinicia.

285* **Skill sincronizada do claude.ai**: desative a skill para sua conta claude.ai, no mesmo lugar onde você a [habilitou](#skills-in-cowork-and-cloud-sessions). Claude Code a remove de `~/.claude/skills/synced/` na próxima vez que [sincroniza suas skills](#where-synced-skills-load). Se você deletar o diretório manualmente em vez disso, a próxima sincronização o baixa novamente enquanto a skill permanece habilitada em claude.ai.289* **Skill sincronizada do claude.ai**: desative a skill para sua conta claude.ai, no mesmo lugar onde você a [habilitou](#skills-in-cowork-and-cloud-sessions). Claude Code a remove de `~/.claude/skills/synced/` na próxima vez que [sincroniza suas skills](#where-synced-skills-load). Se você deletar o diretório manualmente, a próxima sincronização o baixa novamente enquanto a skill permanece habilitada no claude.ai.

286* **Skill agrupada**: defina [`disableBundledSkills`](#bundled-skills) como `true` para desativar skills agrupadas, ou defina uma skill como `"off"` em [`skillOverrides`](#override-skill-visibility-from-settings) para ocultá-la.290* **Skill agrupada**: defina [`disableBundledSkills`](#bundled-skills) como `true` para desativar skills agrupadas, ou defina uma skill como `"off"` em [`skillOverrides`](#override-skill-visibility-from-settings) para ocultá-la.

287 291

288Para manter uma skill pessoal ou de projeto mas impedir que Claude a invoque por conta própria, defina [`disable-model-invocation: true`](#control-who-invokes-a-skill) em seu frontmatter, ou `"user-invocable-only"` em [`skillOverrides`](#override-skill-visibility-from-settings) quando você não quiser editar o arquivo.292Para manter uma skill pessoal ou de projeto mas parar Claude de invocá-la por conta própria, defina [`disable-model-invocation: true`](#control-who-invokes-a-skill) em seu frontmatter, ou `"user-invocable-only"` em [`skillOverrides`](#override-skill-visibility-from-settings) quando você não quer editar o arquivo.

289 293

290<h2 id="configure-skills">294<h2 id="configure-skills">

291 Configurar skills295 Configurar skills

335 Referência de frontmatter339 Referência de frontmatter

336</h3>340</h3>

337 341

338Além do conteúdo markdown, você pode configurar o comportamento da skill usando campos de frontmatter YAML entre marcadores `---` no topo do seu arquivo `SKILL.md`:342Configure uma skill com YAML [frontmatter](/docs/pt/glossary#frontmatter) entre marcadores `---` no topo de `SKILL.md`, e escreva as instruções da skill como Markdown após o `---` de fechamento. Os nomes de campo usam palavras minúsculas separadas por hífens, exceto `when_to_use`. Um [arquivo de comando](#where-skills-live) em `.claude/commands/` aceita os mesmos campos exceto `name` e `paths`. Este exemplo define quatro campos:

339 343

340```yaml theme={null}344```yaml theme={null}

341---345---

348Your skill instructions here...352Your skill instructions here...

349```353```

350 354

351Todos os campos são opcionais. Apenas `description` é recomendado para que Claude saiba quando usar a skill.355Todos os campos são opcionais. Apenas `description` é recomendado para que Claude saiba quando usar a skill. Um nome de campo deve corresponder exatamente à tabela, hífens inclusos: Claude Code ignora um campo que não reconhece sem relatar um erro.

352 356

353Claude Code lê o frontmatter apenas quando a abertura `---` é a primeira linha do arquivo. Caso contrário, trata o arquivo inteiro, incluindo marcadores `---`, como conteúdo de skill.357Claude Code lê o frontmatter apenas quando a abertura `---` é a primeira linha do arquivo. Caso contrário, trata o arquivo inteiro, incluindo marcadores `---`, como conteúdo de skill. Se o YAML entre os marcadores não for analisado, a skill ainda carrega sem campos definidos; veja [Skill não disparando](#skill-not-triggering) para encontrar e corrigir o erro.

354 358

355Campos booleanos aceitam `yes`, `no`, `on`, `off`, `1` e `0` em qualquer caso de letra, além de `true` e `false`. Antes da v2.1.218, Claude Code reconhecia apenas `true` e `false`.359Campos booleanos aceitam `yes`, `no`, `on`, `off`, `1` e `0` em qualquer caso de letra, além de `true` e `false`. Antes da v2.1.218, Claude Code reconhecia apenas `true` e `false`.

356 360

790Quando esta skill é executada:794Quando esta skill é executada:

791 795

7921. Um novo contexto isolado é criado7961. Um novo contexto isolado é criado

7932. O subagente recebe o conteúdo da skill como seu prompt ("Research \$ARGUMENTS thoroughly...")7972. O subagente recebe o conteúdo da skill como seu prompt (as instruções "Research \$ARGUMENTS thoroughly")

7943. O campo `agent` determina o ambiente de execução (modelo, ferramentas e permissões)7983. O campo `agent` determina o ambiente de execução (modelo, ferramentas e permissões)

7954. O subagente resume seus resultados e os retorna para sua conversa principal quando termina7994. O subagente resume seus resultados e os retorna para sua conversa principal quando termina

796 800

statusline.md +2 −2

Details

192| `workspace.git_worktree` | Nome da git worktree quando o diretório atual está dentro de uma worktree vinculada criada com `git worktree add`. Ausente na worktree principal. Preenchido para qualquer git worktree, diferentemente de `worktree.*`, que está presente apenas enquanto a sessão está em uma [sessão de worktree](/docs/pt/worktrees) |192| `workspace.git_worktree` | Nome da git worktree quando o diretório atual está dentro de uma worktree vinculada criada com `git worktree add`. Ausente na worktree principal. Preenchido para qualquer git worktree, diferentemente de `worktree.*`, que está presente apenas enquanto a sessão está em uma [sessão de worktree](/docs/pt/worktrees) |

193| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Identidade do repositório analisada a partir do remote `origin`, por exemplo, `"github.com"`, `"anthropics"`, `"claude-code"`. Ausente fora de um repositório git ou quando nenhum remote `origin` está configurado. Para um projeto gitlab.com aninhado em subgrupos, `owner` é o caminho completo do namespace com barras, como `"group/subgroup"`. Antes da v2.1.260, `workspace.repo` estava ausente para esses projetos |193| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Identidade do repositório analisada a partir do remote `origin`, por exemplo, `"github.com"`, `"anthropics"`, `"claude-code"`. Ausente fora de um repositório git ou quando nenhum remote `origin` está configurado. Para um projeto gitlab.com aninhado em subgrupos, `owner` é o caminho completo do namespace com barras, como `"group/subgroup"`. Antes da v2.1.260, `workspace.repo` estava ausente para esses projetos |

194| `cost.total_cost_usd` | Custo total estimado da sessão em USD, calculado no lado do cliente ao preço de lista, a menos que uma tabela [`modelPricing`](/docs/pt/settings-reference#modelpricing) esteja em vigor. Pode diferir de sua fatura real. Redefine para \$0 quando `/clear` inicia uma nova sessão. Antes da v2.1.211, o total era mantido após `/clear` |194| `cost.total_cost_usd` | Custo total estimado da sessão em USD, calculado no lado do cliente ao preço de lista, a menos que uma tabela [`modelPricing`](/docs/pt/settings-reference#modelpricing) esteja em vigor. Pode diferir de sua fatura real. Redefine para \$0 quando `/clear` inicia uma nova sessão. Antes da v2.1.211, o total era mantido após `/clear` |

195| `cost.total_duration_ms` | Tempo total decorrido desde o início da sessão, em milissegundos |195| `cost.total_duration_ms` | Tempo total decorrido desde o início da sessão, em milissegundos. Acumula entre retomadas e não inclui tempo enquanto a sessão não está em execução |

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

236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",

237 "transcript_path": "/path/to/transcript.jsonl",237 "transcript_path": "/path/to/transcript.jsonl",

238 "model": {238 "model": {

239 "id": "claude-opus-5",239 "id": "claude-opus-5-5",

240 "display_name": "Opus"240 "display_name": "Opus"

241 },241 },

242 "workspace": {242 "workspace": {

sub-agents.md +28 −14

Details

32 32

33Claude Code inclui subagentes integrados que Claude usa automaticamente quando apropriado. Cada um herda as permissões da conversa pai; a maioria é executada com um conjunto de ferramentas restrito.33Claude Code inclui subagentes integrados que Claude usa automaticamente quando apropriado. Cada um herda as permissões da conversa pai; a maioria é executada com um conjunto de ferramentas restrito.

34 34

35Explore e Plan pulam seus arquivos CLAUDE.md e o status git da sessão pai para manter a pesquisa rápida e econômica. Todos os outros subagentes integrados e [subagentes personalizados](#configure-subagents) carregam ambos, a menos que sua definição defina o campo [`omitClaudeMd`](#supported-frontmatter-fields) para pular os arquivos CLAUDE.md do usuário, projeto e local. Para o detalhamento completo do que chega a um subagente, consulte [o que é carregado na inicialização](#what-loads-at-startup).35Explore e Plan pulam seus arquivos CLAUDE.md e o snapshot de status git para manter a pesquisa rápida e econômica. Todos os outros subagentes integrados e [subagentes personalizados](#configure-subagents) carregam ambos, a menos que sua definição defina o campo [`omitClaudeMd`](#supported-frontmatter-fields) para pular os arquivos CLAUDE.md do usuário, projeto e local. Para o detalhamento completo do que chega a um subagente, consulte [o que é carregado na inicialização](#what-loads-at-startup).

36 36

37<Tabs>37<Tabs>

38 <Tab title="Explore">38 <Tab title="Explore">

230 </Tab>230 </Tab>

231</Tabs>231</Tabs>

232 232

233O flag `--agents` aceita JSON com um campo `prompt` mais estes campos de [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` e `isolation`. Use `prompt` para o prompt de sistema, equivalente ao corpo markdown em subagentes baseados em arquivo.233O flag `--agents` aceita JSON com um campo `prompt` mais estes campos de [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` e `isolation`. Use `prompt` para o prompt de sistema, equivalente ao corpo markdown em subagentes baseados em arquivo. `color` e `experimental` não são aceitos aqui e são ignorados em vez de rejeitados.

234 234

235Cada chave de nível superior no JSON é o nome do agente. Não comece um nome com `-`.235Cada chave de nível superior no JSON é o nome do agente. Não comece um nome com `-`.

236 236

295 295

296Quando a conversa principal em si é executada isolada em um worktree, Claude Code aplica as mesmas verificações à sessão e a cada subagente que ela gera, incluindo subagentes sem `isolation: worktree`; veja [Como Claude Code impõe isolamento](/docs/pt/worktrees#how-claude-code-enforces-isolation).296Quando a conversa principal em si é executada isolada em um worktree, Claude Code aplica as mesmas verificações à sessão e a cada subagente que ela gera, incluindo subagentes sem `isolation: worktree`; veja [Como Claude Code impõe isolamento](/docs/pt/worktrees#how-claude-code-enforces-isolation).

297 297

298<h4 id="supported-frontmatter-fields">298<h3 id="supported-frontmatter-fields">

299 Campos de frontmatter suportados299 Referência de frontmatter

300</h4>300</h3>

301

302Configure um subagente com [frontmatter](/docs/pt/glossary#frontmatter) YAML entre marcadores `---` no topo de seu arquivo, e escreva seu prompt de sistema como Markdown após o `---` de fechamento. Apenas `name` e `description` são obrigatórios.

301 303

302Os seguintes campos podem ser usados no frontmatter YAML. Apenas `name` e `description` são obrigatórios.304Nomes de campo com múltiplas palavras usam camelCase, como `maxTurns` e `disallowedTools`, e devem corresponder à tabela exatamente: Claude Code ignora um campo que não reconhece sem relatar um erro. Para descobrir por que um arquivo de subagente não carregou, veja [Arquivos de subagente que Claude Code pula](#subagent-files-claude-code-skips).

303 305

305| :---------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |307| :---------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

306| `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. Nomes não podem conter `:`, que é reservado para [identificadores com escopo de plugin](/docs/pt/plugins) como `my-plugin:reviewer`. Claude Code não carrega um arquivo cujo nome contém um e registra um erro no log de debug. Antes da v2.1.218, tais nomes eram aceitos |308| `name` | Yes | Identificador único, como `code-reviewer` ou `reviewer-v2`. [Hooks](/docs/pt/hooks#subagentstart) recebem este valor como `agent_type`. O nome do arquivo não precisa corresponder. Nomes não podem conter `:`, que é reservado para [identificadores com escopo de plugin](/docs/pt/plugins) como `my-plugin:reviewer`. Claude Code não carrega um arquivo cujo nome contém um e registra um erro no log de debug. Antes da v2.1.218, tais nomes eram aceitos |

307| `description` | Yes | Quando Claude deve delegar para este subagente |309| `description` | Yes | Quando Claude deve delegar para este subagente |

308| `tools` | No | [Ferramentas](#available-tools) que o subagente pode usar. Herda todas as ferramentas disponíveis para subagentes se omitido. Se nenhuma entrada na lista se resolver para uma ferramenta, o subagente geralmente [falha ao iniciar](/docs/pt/errors#agent-would-be-spawned-with-zero-tools) com um erro nomeando as entradas. Para pré-carregar Skills no contexto, use o campo `skills` em vez de listar `Skill` aqui |310| `tools` | No | [Ferramentas](#available-tools) que o subagente pode usar, como uma string separada por vírgulas como `Read, Grep, Bash` ou uma lista YAML. Herda todas as ferramentas disponíveis para subagentes se omitido. Se nenhuma entrada na lista se resolver para uma ferramenta, o subagente geralmente [falha ao iniciar](/docs/pt/errors#agent-would-be-spawned-with-zero-tools) com um erro nomeando as entradas. Para pré-carregar Skills no contexto, use o campo `skills` em vez de listar `Skill` aqui |

309| `disallowedTools` | No | Ferramentas a negar, removidas da lista herdada ou especificada. Uma entrada com um especificador, como `Bash(git push *)`, ainda [remove a ferramenta inteira](#available-tools) |311| `disallowedTools` | No | Ferramentas a negar, removidas da lista herdada ou especificada. Mesmo formato que `tools`. Uma entrada com um especificador, como `Bash(git push *)`, ainda [remove a ferramenta inteira](#available-tools) |

310| `model` | No | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, um ID de modelo completo como `claude-opus-5`, ou `inherit`. Quando você omite, Claude Code escolhe o modelo na [ordem de modelo de subagente](#choose-a-model) |312| `model` | No | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, um ID de modelo completo como `claude-opus-5-5`, ou `inherit`. Quando você omite, Claude Code escolhe o modelo na [ordem de modelo de subagente](#choose-a-model) |

311| `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) |313| `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) |

312| `maxTurns` | No | Número máximo de turnos de agente antes do subagente parar. Quando o subagente atinge o limite, Claude Code retorna sua saída marcada como parcial, e Claude pode [retomá-lo](#resume-subagents) para continuar. A marcação parcial requer Claude Code v2.1.246 ou posterior |314| `maxTurns` | No | Número máximo de turnos de agente antes do subagente parar. Quando o subagente atinge o limite, Claude Code retorna sua saída marcada como parcial, e Claude pode [retomá-lo](#resume-subagents) para continuar. A marcação parcial requer Claude Code v2.1.246 ou posterior |

313| `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 |315| `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 |

319| `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 |321| `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 |

320| `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 |322| `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 |

321| `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` |323| `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` |

322| `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 |324| `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. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

323| `experimental` | No | Mapa de opções experimentais. Defina sua chave `cacheTtl` como `5m` ou `1h` para escolher o [tempo de vida do cache de prompt](/docs/pt/prompt-caching#choose-the-ttl-yourself) para as solicitações deste subagente, no lugar da [precedência de tempo de vida do cache](/docs/pt/prompt-caching#choose-the-ttl-yourself). Claude Code ignora qualquer outro valor, ignora `1h` enquanto sua assinatura Claude está usando créditos de uso, e lê o campo apenas de arquivos de subagente. Requer Claude Code v2.1.248 ou posterior |325| `experimental` | No | Mapa de opções experimentais. Defina sua chave `cacheTtl` como `5m` ou `1h` para escolher o [tempo de vida do cache de prompt](/docs/pt/prompt-caching#choose-the-ttl-yourself) para as solicitações deste subagente, no lugar da [precedência de tempo de vida do cache](/docs/pt/prompt-caching#choose-the-ttl-yourself). Claude Code ignora qualquer outro valor, ignora `1h` enquanto sua assinatura Claude está usando créditos de uso, e lê o campo apenas de arquivos de subagente. Requer Claude Code v2.1.248 ou posterior |

324 326

325Escreva `cacheTtl` dentro do mapa `experimental`, não no nível superior do frontmatter.327Escreva `cacheTtl` dentro do mapa `experimental`, não no nível superior do frontmatter.

362O campo `model` controla qual modelo o subagente usa:364O campo `model` controla qual modelo o subagente usa:

363 365

364* **Alias de modelo**: use um dos aliases disponíveis: `sonnet`, `opus`, `haiku`, ou `fable`366* **Alias de modelo**: use um dos aliases disponíveis: `sonnet`, `opus`, `haiku`, ou `fable`

365* **ID de modelo completo**: use um ID de modelo completo como `claude-opus-5` ou `claude-sonnet-5`. Aceita os mesmos valores que o flag `--model`367* **ID de modelo completo**: use um ID de modelo completo como `claude-opus-5-5` ou `claude-sonnet-5`. Aceita os mesmos valores que o flag `--model`

366* **inherit**: use o mesmo modelo que a conversa principal368* **inherit**: use o mesmo modelo que a conversa principal

367 369

368Quando 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:370Quando 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:

3723. A variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/pt/model-config#environment-variables), quando você a define para um alias de modelo ou ID de modelo3743. A variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/pt/model-config#environment-variables), quando você a define para um alias de modelo ou ID de modelo

3734. O modelo da conversa principal3754. O modelo da conversa principal

374 376

377Em dois casos, um alias de família como `opus` no parâmetro por invocação ou no frontmatter se resolve para o modelo da conversa principal em vez da [versão para a qual o alias aponta](/docs/pt/model-config#model-aliases):

378

379* **O modelo da conversa principal pertence a essa família**: o subagente é executado no modelo exato da conversa principal, incluindo qualquer sufixo `[1m]`, portanto obtém a mesma janela de [contexto estendido](/docs/pt/model-config#extended-context) que a conversa principal.

380* **Claude Code não consegue dizer a família do modelo da conversa principal, em [um provedor diferente da API Anthropic](/docs/pt/third-party-integrations)**: isso pode acontecer com um [ARN de perfil de inferência de aplicação](/docs/pt/amazon-bedrock#iam-configuration) no Amazon Bedrock que Claude Code não resolveu para um modelo de suporte. Este caso cobre apenas o alias `opus`, e não se aplica quando você define [`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/pt/model-config#environment-variables), já que `opus` então se resolve para o modelo que você definiu.

381

382Um alias em `CLAUDE_CODE_SUBAGENT_MODEL` sempre se resolve para a versão para a qual o alias aponta, mesmo quando nomeia a família da conversa principal.

383

375Definir `CLAUDE_CODE_SUBAGENT_MODEL` por si só não muda o modelo em que os subagentes Explore e Plan integrados são executados. Para mudá-lo, veja [Executar cada subagente em um modelo](#run-every-subagent-on-one-model).384Definir `CLAUDE_CODE_SUBAGENT_MODEL` por si só não muda o modelo em que os subagentes Explore e Plan integrados são executados. Para mudá-lo, veja [Executar cada subagente em um modelo](#run-every-subagent-on-one-model).

376 385

377Antes da v2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` vinha primeiro nesta ordem e sobrescrevia tanto o parâmetro por invocação quanto o frontmatter, incluindo `model: inherit`.386Antes da v2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` vinha primeiro nesta ordem e sobrescrevia tanto o parâmetro por invocação quanto o frontmatter, incluindo `model: inherit`.

438* `EnterPlanMode`447* `EnterPlanMode`

439* `ExitPlanMode`, a menos que o [`permissionMode`](#permission-modes) do subagente seja `plan`448* `ExitPlanMode`, a menos que o [`permissionMode`](#permission-modes) do subagente seja `plan`

440* `ScheduleWakeup`449* `ScheduleWakeup`

441* `TaskOutput`

442* `WaitForMcpServers`450* `WaitForMcpServers`

443* `Workflow`451* `Workflow`

444 452

445O segundo filtro se aplica a subagentes em execução em background. Além de `Agent` e `ExitPlanMode`, que seguem as condições do primeiro filtro onde quer que o subagente seja executado, um subagente em background mantém cada ferramenta MCP mas apenas essas ferramentas integradas: `Read`, `Grep`, `Glob`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage` e `Artifact`, além de [`SubagentHandback`](/docs/pt/tools-reference) para um subagente que relata através dele. Claude Code remove todas as outras ferramentas integradas de um subagente em background, seja herdadas ou listadas no campo `tools`, portanto a mesma definição pode se resolver para ferramentas diferentes em foreground e background. A remoção não relata erro a menos que deixe a lista `tools` [se resolvendo para nada](/docs/pt/errors#agent-would-be-spawned-with-zero-tools).453O segundo filtro se aplica a subagentes em execução em background. Além de `Agent` e `ExitPlanMode`, que seguem as condições do primeiro filtro onde quer que o subagente seja executado, um subagente em background mantém cada ferramenta MCP mas apenas essas ferramentas integradas: `Read`, `Grep`, `Glob`, `LSP`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage` e `Artifact`, além de [`SubagentHandback`](/docs/pt/tools-reference) para um subagente que relata através dele. Claude Code remove todas as outras ferramentas integradas de um subagente em background, seja herdadas ou listadas no campo `tools`, portanto a mesma definição pode se resolver para ferramentas diferentes em foreground e background. A remoção não relata erro a menos que deixe a lista `tools` [se resolvendo para nada](/docs/pt/errors#agent-would-be-spawned-with-zero-tools).

454

455Antes da v2.1.280, subagentes em background não podiam usar `LSP`.

446 456

447[`ListAgents`](/docs/pt/cross-session-messaging) segue esses filtros como qualquer ferramenta integrada: um subagente em foreground a herda em sessões onde mensagens entre sessões estão habilitadas, e um subagente em background não a mantém.457[`ListAgents`](/docs/pt/cross-session-messaging) segue esses filtros como qualquer ferramenta integrada: um subagente em foreground a herda em sessões onde mensagens entre sessões estão habilitadas, e um subagente em background não a mantém.

448 458

989 999

990A verificação não julga se o conteúdo é malicioso, e não muda o que uma instrução em um relatório pode fazer: uma chamada de ferramenta que o relatório leva Claude a fazer ainda passa pelas [verificações de permissão](/docs/pt/permissions) e [sandboxing](/docs/pt/sandboxing) da sessão. Não é um substituto para [restringir o que um subagente pode alcançar](#control-subagent-capabilities).1000A verificação não julga se o conteúdo é malicioso, e não muda o que uma instrução em um relatório pode fazer: uma chamada de ferramenta que o relatório leva Claude a fazer ainda passa pelas [verificações de permissão](/docs/pt/permissions) e [sandboxing](/docs/pt/sandboxing) da sessão. Não é um substituto para [restringir o que um subagente pode alcançar](#control-subagent-capabilities).

991 1001

1002Um relatório que retorna a Claude como o resultado do subagente também chega sob um cabeçalho marcando-o como saída de subagente. O cabeçalho afirma que instruções ou reivindicações de aprovação dentro do relatório são as palavras do subagente e não carregam autoridade de você.

1003

1004Um [relatório de subagente em segundo plano](#run-subagents-in-foreground-or-background) chega dentro de uma notificação de conclusão, que é marcada como um evento automatizado em vez de uma mensagem de você.

1005

992<Note>1006<Note>

993 A verificação de saída de subagente requer Claude Code v2.1.210 ou posterior.1007 A verificação de saída de subagente requer Claude Code v2.1.210 ou posterior.

994</Note>1008</Note>

terminal-config.md +20 −6

Details

343 Colar conteúdo grande343 Colar conteúdo grande

344</h2>344</h2>

345 345

346Quando você cola mais de 800 caracteres ou mais de três linhas no prompt, Claude Code recolhe a entrada para um espaço reservado como `[Pasted text #1 +120 lines]` para que a caixa de entrada permaneça utilizável. Em uma janela de terminal com menos de 12 linhas, o limite de linhas diminui, então Claude Code recolhe uma colagem de três linhas em 11 linhas e qualquer colagem de múltiplas linhas em 10 linhas ou menos. Claude Code ainda envia o conteúdo completo quando você submete.346Quando você cola mais de 800 caracteres ou mais de três linhas no prompt, Claude Code recolhe a entrada para um espaço reservado como `[Pasted text #1 +120 lines]` para que a caixa de entrada permaneça utilizável, e ainda envia o conteúdo completo quando você submete. Para entradas muito grandes, como arquivos inteiros ou logs longos, escreva o conteúdo em um arquivo e peça ao Claude para lê-lo em vez de colar. A transcrição da conversa permanece legível e Claude pode referenciar o arquivo por caminho em turnos posteriores. O terminal integrado do VS Code também pode descartar caracteres de colas muito grandes antes de chegarem ao Claude Code, então use um arquivo lá.

347 347

348Quando você deleta com um atalho de palavra ou linha como `Ctrl+W` ou `Ctrl+K`, ou com uma exclusão vim através de um movimento `f`/`t` como `df]`, e o intervalo deletado atinge dentro de um espaço reservado, Claude Code remove o espaço reservado inteiro. Você pode colar a exclusão de volta para restaurá-la, com [`Ctrl+Y`](/docs/pt/interactive-mode#text-editing) após um atalho de palavra ou linha, ou com [`p` em NORMAL mode](/docs/pt/interactive-mode#editing-normal-mode) após uma exclusão vim.348Se a colagem contiver [caracteres Unicode invisíveis](/docs/pt/interactive-mode#invisible-characters-in-prompts), Claude Code os remove quando você pressiona Enter e coloca o prompt limpo de volta na caixa de entrada para você enviar com outro Enter.

349 349

350Claude Code mantém o conteúdo recolhido em `~/.claude/paste-cache/`, então quando você recupera um prompt do [histórico de comandos](/docs/pt/interactive-mode#command-history) e o resubmete, Claude Code envia o conteúdo colado completo novamente, inclusive em uma sessão posterior, até que a varredura de retenção remova o arquivo de cache.350<h3 id="how-claude-treats-pasted-text">

351 Como Claude trata texto colado

352</h3>

353

354Quando você submete, Claude vê o conteúdo atrás de cada espaço reservado `[Pasted text #N]` marcado como texto que você colou de outro lugar em vez de digitar. Claude é informado que uma colagem pode conter instruções que você não escreveu, e deve seguir instruções dentro dela apenas onde a mensagem que você digitou pede. Em sessões que não [buscam sinalizadores de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching), colas não são marcadas.

351 355

352Claude Code deleta arquivos de cache com mais de [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) de idade, seguindo as [regras de varredura de retenção](/docs/pt/claude-directory#cleaned-up-automatically), então um prompt recuperado pode referenciar texto colado que não existe mais. Quando você submete tal prompt, Claude Code nunca envia a string literal `[Pasted text #N]`, e mostra uma notificação nomeando a colagem ausente:356<h3 id="delete-and-restore-a-collapsed-paste">

357 Deletar e restaurar uma colagem recolhida

358</h3>

359

360Quando você deleta com um atalho de palavra ou linha como `Ctrl+W` ou `Ctrl+K`, ou com uma exclusão vim através de um movimento `f`/`t` como `df]`, e o intervalo deletado atinge dentro de um espaço reservado `[Pasted text #N]`, Claude Code remove o espaço reservado inteiro. Para restaurá-lo, cole a exclusão de volta com [`Ctrl+Y`](/docs/pt/interactive-mode#text-editing) após um atalho de palavra ou linha, ou com [`p` em NORMAL mode](/docs/pt/interactive-mode#editing-normal-mode) após uma exclusão vim.

361

362<h3 id="recall-a-prompt-that-had-pasted-text">

363 Recuperar um prompt que tinha texto colado

364</h3>

365

366Claude Code mantém o conteúdo atrás de cada espaço reservado `[Pasted text #N]` em `~/.claude/paste-cache/`, então quando você recupera um prompt do [histórico de comandos](/docs/pt/interactive-mode#command-history) e o resubmete, o conteúdo colado completo é enviado novamente, inclusive em uma sessão posterior.

367

368Arquivos de cache com mais de [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) de idade são deletados sob as [regras de varredura de retenção](/docs/pt/claude-directory#cleaned-up-automatically), então um prompt recuperado pode referenciar texto colado que não existe mais. Quando você submete tal prompt, Claude Code nunca envia a string literal `[Pasted text #N]`, e mostra uma notificação nomeando a colagem ausente:

353 369

354* Em um prompt simples com texto restante, Claude Code remove o espaço reservado e envia o texto restante.370* Em um prompt simples com texto restante, Claude Code remove o espaço reservado e envia o texto restante.

355* Em um comando [shell mode](/docs/pt/interactive-mode#shell-mode-with-prefix) ou um comando `/`, onde a remoção alteraria o que é executado, e em qualquer prompt cuja remoção deixa vazio, Claude Code cancela a submissão e mantém o texto original na entrada, com o espaço reservado ainda nele. Delete o espaço reservado ou edite o comando, depois resubmeta.371* Em um comando [shell mode](/docs/pt/interactive-mode#shell-mode-with-prefix) ou um comando `/`, onde a remoção alteraria o que é executado, e em qualquer prompt cuja remoção deixa vazio, Claude Code cancela a submissão e mantém o texto original na entrada, com o espaço reservado ainda nele. Delete o espaço reservado ou edite o comando, depois resubmeta.

356 372

357O terminal integrado do VS Code pode descartar caracteres de colas muito grandes antes de chegarem ao Claude Code, então prefira fluxos de trabalho baseados em arquivo lá. Para entradas muito grandes, como arquivos inteiros ou logs longos, escreva o conteúdo em um arquivo e peça ao Claude para lê-lo em vez de colar. Isso mantém a transcrição da conversa legível e permite que Claude referencie o arquivo por caminho em turnos posteriores.

~~358~~

359<h2 id="edit-prompts-with-vim-keybindings">373<h2 id="edit-prompts-with-vim-keybindings">

360 Editar prompts com atalhos de teclado Vim374 Editar prompts com atalhos de teclado Vim

361</h2>375</h2>

third-party-integrations.md +4 −4

Details

86 86

87Para a maioria das organizações, Claude for Teams ou Claude for Enterprise oferece a melhor experiência. Os membros da equipe obtêm acesso tanto a Claude Code quanto a Claude na web com uma única assinatura, faturamento centralizado e nenhuma configuração de infraestrutura necessária.87Para a maioria das organizações, Claude for Teams ou Claude for Enterprise oferece a melhor experiência. Os membros da equipe obtêm acesso tanto a Claude Code quanto a Claude na web com uma única assinatura, faturamento centralizado e nenhuma configuração de infraestrutura necessária.

88 88

89**Claude for Teams** é de autoatendimento e inclui recursos de colaboração, ferramentas de administração e gerenciamento de faturamento. Melhor para equipes menores que precisam começar rapidamente.89**Claude for Teams** é de autoatendimento e inclui recursos de colaboração, ferramentas de administração, SSO, gerenciamento de faturamento e [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) para configuração de Claude Code em toda a organização. Melhor para equipes menores que precisam começar rapidamente.

90 90

91**Claude for Enterprise** adiciona SSO e captura de domínio, permissões baseadas em funções, acesso à API de conformidade e configurações de política gerenciada para implantar configurações de Claude Code em toda a organização. Melhor para organizações maiores com requisitos de segurança e conformidade.91**Claude for Enterprise** adiciona captura de domínio, permissões baseadas em funções e acesso à API de conformidade. Melhor para organizações maiores com requisitos de segurança e conformidade.

92 92

93Saiba mais sobre [planos de equipe](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) e [planos empresariais](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).93Saiba mais sobre [planos de equipe](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) e [planos empresariais](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).

94 94

95As opções de implantação comparadas abaixo cobrem onde a inferência do modelo é executada. Para executar sessões de [Claude Code na web](/docs/pt/claude-code-on-the-web) em computação que sua organização opera, consulte [ambientes auto-hospedados](/docs/pt/self-hosted-environments).95As opções de implantação comparadas abaixo cobrem onde a inferência do modelo é executada. Para executar [sessões na nuvem](/docs/pt/claude-code-on-the-web) de Claude Code em computação que sua organização opera, consulte [ambientes auto-hospedados](/docs/pt/self-hosted-environments).

96 96

97Se sua organização tem requisitos de infraestrutura específicos, compare as opções abaixo:97Se sua organização tem requisitos de infraestrutura específicos, compare as opções abaixo:

98 98

152 152

153 <tr>153 <tr>

154 <td>Autenticação</td>154 <td>Autenticação</td>

155 <td>Claude.ai SSO ou email</td>155 <td>claude.ai SSO ou email</td>

156 <td>Chave de API ou [entrada no Console sem uma](/docs/pt/authentication#sign-in-without-an-api-key)</td>156 <td>Chave de API ou [entrada no Console sem uma](/docs/pt/authentication#sign-in-without-an-api-key)</td>

157 <td>Chave de API ou credenciais da AWS</td>157 <td>Chave de API ou credenciais da AWS</td>

158 <td>Chave de API ou credenciais da AWS</td>158 <td>Chave de API ou credenciais da AWS</td>

troubleshoot-install.md +1 −1

Details

24| `Raw mode is not supported` durante a instalação | [Execute novamente o instalador](#raw-mode-is-not-supported-during-install) |24| `Raw mode is not supported` durante a instalação | [Execute novamente o instalador](#raw-mode-is-not-supported-during-install) |

26| `Failed to fetch version` ou não consegue alcançar o servidor de download | [Verifique as configurações de rede e proxy](#check-network-connectivity) |26| `Failed to fetch version` ou não consegue alcançar o servidor de download | [Verifique as configurações de rede e proxy](#check-network-connectivity) |

27| `irm is not recognized` ou `&& is not valid` | [Use o comando correto para seu shell](#wrong-install-command-on-windows) |27| `irm is not recognized` ou `The token '&&' is not a valid statement separator` | [Use o comando correto para seu shell](#wrong-install-command-on-windows) |

28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Atualize o Homebrew](#homebrew-cask-unavailable-or-outdated) |28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Atualize o Homebrew](#homebrew-cask-unavailable-or-outdated) |

29| `'bash' is not recognized as the name of a cmdlet` | [Use o comando do instalador do Windows](#wrong-install-command-on-windows) |29| `'bash' is not recognized as the name of a cmdlet` | [Use o comando do instalador do Windows](#wrong-install-command-on-windows) |

30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Use o comando do instalador do Windows](#wrong-install-command-on-windows) |30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Use o comando do instalador do Windows](#wrong-install-command-on-windows) |

ultrareview.md +10 −3

Details

50 50

51A branch base não precisa existir em seu clone local; Claude Code a busca de `origin`. Se o nome tiver um erro de digitação, Claude Code sugere o nome de branch mais próximo no erro.51A branch base não precisa existir em seu clone local; Claude Code a busca de `origin`. Se o nome tiver um erro de digitação, Claude Code sugere o nome de branch mais próximo no erro.

52 52

53Um ID de commit ou tag também funciona como a base, e a revisão então cobre as mudanças em sua branch desde esse commit.

53<h3 id="review-a-pull-request">55<h3 id="review-a-pull-request">

54 Revisar uma pull request56 Revisar uma pull request

55</h3>57</h3>

114Ultrareview verifica o diff antes de qualquer trabalho de revisão ser executado e informa quando não consegue revisá-lo como está:116Ultrareview verifica o diff antes de qualquer trabalho de revisão ser executado e informa quando não consegue revisá-lo como está:

115 117

116* **Diff muito grande**: uma revisão de branch pode incluir até 500 arquivos alterados e 8.000 linhas alteradas por padrão. Os valores exatos podem mudar, e a [recusa](/docs/pt/errors#diff-is-too-large-for-ultrareview) nomeia os em vigor, o tamanho do seu diff e os arquivos com mais linhas alteradas. Claude Code recusa uma pull request muito grande da mesma forma, nomeando suas contagens de arquivo e linha, mas não o detalhamento por arquivo118* **Diff muito grande**: uma revisão de branch pode incluir até 500 arquivos alterados e 8.000 linhas alteradas por padrão. Os valores exatos podem mudar, e a [recusa](/docs/pt/errors#diff-is-too-large-for-ultrareview) nomeia os em vigor, o tamanho do seu diff e os arquivos com mais linhas alteradas. Claude Code recusa uma pull request muito grande da mesma forma, nomeando suas contagens de arquivo e linha, mas não o detalhamento por arquivo

117* **Nada para revisar**: quando o diff contra a base está vazio, Claude Code diz isso e sugere preparar ou confirmar edições locais, ou passar uma base diferente119* **Nada para revisar**: quando o diff contra a base está vazio, ultrareview recusa e nomeia a branch ou commit com o qual comparou e o caso em que você está, como estar na própria branch base sem nada não confirmado, ou uma branch cujos commits já fazem parte da base. Também sugere a maneira de sair para esse caso, como mudar para a branch com seu trabalho, preparar ou confirmar edições locais, ou passar uma base diferente

118* **Sem base de mesclagem**: quando sua branch não compartilha histórico com a branch base, Claude Code volta a revisar cada arquivo rastreado no repositório; o fallback requer um clone completo e aplica os mesmos limites de tamanho. Em um checkout sem branches ou outras refs, como um HEAD desanexado criado ao fazer checkout de `FETCH_HEAD` após buscar uma URL, Claude Code [recusa a revisão](/docs/pt/errors#your-checkout-has-no-branches) e sugere criar uma branch primeiro120* **Primeiro commit**: o primeiro commit de um repositório não tem nada anterior para comparar, portanto ultrareview revisa cada arquivo nele depois que você confirma no diálogo de lançamento. Se você tiver arquivos não rastreados, ele recusa em vez disso e informa para `git add` os que você deseja revisados. Os mesmos limites de tamanho se aplicam.

121

122 Um primeiro commit é revisado integralmente apenas após essa confirmação, portanto o subcomando `claude ultrareview` e `claude -p` o recusam e o apontam para uma sessão interativa em vez disso. Requer Claude Code v2.1.277 ou posterior

123* **Sem base de mesclagem**: quando sua branch não compartilha histórico com a branch base, ou o repositório não tem branch base para comparar, ultrareview revisa cada arquivo rastreado no repositório em vez disso. O fallback requer um clone completo e aplica os mesmos limites de tamanho. Ele é lançado apenas quando você confirma no diálogo de lançamento ou executa o subcomando `claude ultrareview` você mesmo. Em `claude -p` e em qualquer outro lugar onde nenhum desses acontece, ultrareview recusa, diz que a revisão cobriria cada arquivo, e o aponta para uma sessão interativa.

124

125 Em um checkout sem branches ou outras refs, como um HEAD desanexado criado ao fazer checkout de `FETCH_HEAD` após buscar uma URL, Claude Code [recusa a revisão](/docs/pt/errors#your-checkout-has-no-branches) e sugere criar uma branch primeiro

119 126

120<h2 id="pricing-and-free-runs">127<h2 id="pricing-and-free-runs">

121 Preços e execuções gratuitas128 Preços e execuções gratuitas

166 173

167Sem argumentos, o subcomando revisa o diff entre sua branch atual e a branch padrão, com o mesmo [fallback de repositório inteiro](#diff-limits-and-fallbacks) que `/code-review ultra` quando não existe base de mesclagem. Passe um número de PR para revisar uma pull request, ou uma branch base para revisar em relação a ela; o [tratamento de branch base](#review-against-a-different-base) corresponde ao comando interativo.174Sem argumentos, o subcomando revisa o diff entre sua branch atual e a branch padrão, com o mesmo [fallback de repositório inteiro](#diff-limits-and-fallbacks) que `/code-review ultra` quando não existe base de mesclagem. Passe um número de PR para revisar uma pull request, ou uma branch base para revisar em relação a ela; o [tratamento de branch base](#review-against-a-different-base) corresponde ao comando interativo.

168 175

169Você consente com o fallback de repositório inteiro e com o aviso de faturamento e termos quando executa o subcomando, portanto a execução começa sem aguardar entrada.176Você consente com o fallback de repositório inteiro e com o aviso de faturamento e termos quando executa o subcomando, portanto a execução começa sem aguardar entrada. Executar você mesmo é o que conta como consentimento. Quando Claude executa o subcomando para você, por exemplo através da ferramenta Bash, Claude Code recusa a revisão de repositório inteiro.

170 177

171No Claude Code v2.1.218 ou posterior, você também pode iniciar a revisão na nuvem executando `/code-review ultra` em uma sessão não interativa, por exemplo `claude -p '/code-review ultra'`. Claude Code inicia a revisão e imprime um link de rastreamento sem aguardar as descobertas, diferentemente de `claude ultrareview`, que bloqueia até que elas cheguem. Quando a revisão faturaria créditos de uso, Claude Code para antes de iniciar e aponta você para `claude ultrareview`, porque a confirmação de faturamento precisa de uma sessão interativa. Antes da v2.1.218, `/code-review ultra` em uma sessão não interativa executava uma revisão local.178No Claude Code v2.1.218 ou posterior, você também pode iniciar a revisão na nuvem executando `/code-review ultra` em uma sessão não interativa, por exemplo `claude -p '/code-review ultra'`. Claude Code inicia a revisão e imprime um link de rastreamento sem aguardar as descobertas, diferentemente de `claude ultrareview`, que bloqueia até que elas cheguem. Quando a revisão faturaria créditos de uso, Claude Code para antes de iniciar e aponta você para `claude ultrareview`, porque a confirmação de faturamento precisa de uma sessão interativa. Antes da v2.1.218, `/code-review ultra` em uma sessão não interativa executava uma revisão local.

172 179

vs-code.md +79 −14

Details

90 * No modo Manual, quando Claude quer editar um arquivo, ele mostra uma comparação lado a lado do original e das alterações propostas, depois pede permissão. Você pode aceitar, rejeitar ou dizer a Claude o que fazer em vez disso. Se você editar o conteúdo proposto diretamente na visualização de diff antes de aceitar, Claude é informado de que você o modificou para que não assuma que o arquivo corresponde à sua proposta original.90 * No modo Manual, quando Claude quer editar um arquivo, ele mostra uma comparação lado a lado do original e das alterações propostas, depois pede permissão. Você pode aceitar, rejeitar ou dizer a Claude o que fazer em vez disso. Se você editar o conteúdo proposto diretamente na visualização de diff antes de aceitar, Claude é informado de que você o modificou para que não assuma que o arquivo corresponde à sua proposta original.

91 91

92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code mostrando um diff das alterações propostas por Claude com um prompt de permissão perguntando se deve fazer a edição" width="3292" height="1876" data-path="images/vs-code-edits.png" />92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code mostrando um diff das alterações propostas por Claude com um prompt de permissão perguntando se deve fazer a edição" width="3292" height="1876" data-path="images/vs-code-edits.png" />

94 Para revisar uma edição proposta uma alteração por vez, use os botões **Accept this change** e **Reject this change** sob cada alteração no diff. Rejeitar uma alteração a reverte no conteúdo proposto; aceitar a marca como revisada. Aceitar ou rejeitar o arquivo inteiro ainda finaliza a revisão. Um diff com mais de 100 alterações abre sem os botões por alteração, então revise-o como um arquivo inteiro. A revisão por alteração requer Claude Code v2.1.275 ou posterior.

96 As mesmas ações estão disponíveis no cursor a partir do menu de contexto do editor e da Command Palette como **Claude Code: Accept Change at Cursor** e **Claude Code: Reject Change at Cursor**.

93 </Step>97 </Step>

94</Steps>98</Steps>

95 99

110 * **Manual**: Claude asks permission before file edits and most shell commands.114 * **Manual**: Claude asks permission before file edits and most shell commands.

111 * **Plan**: Claude describes what it will do and waits for approval before making changes. VS Code automatically opens the plan as a full Markdown document where you can add inline comments to give feedback before Claude begins.115 * **Plan**: Claude describes what it will do and waits for approval before making changes. VS Code automatically opens the plan as a full Markdown document where you can add inline comments to give feedback before Claude begins.

112 * **Edit automatically**: Claude makes edits without asking.116 * **Edit automatically**: Claude makes edits without asking.

113* **Model**: select **Switch model…** from the command menu to change the model mid-session. You can also click the model name at the bottom of the prompt box to open the same picker. When the current model supports [effort levels](/docs/pt/model-config#adjust-effort-level), the picker also shows an **Effort** row and the model name button shows the selected level. The model name button and the **Effort** row require Claude Code v2.1.257 or later.117* **Model**: select **Switch model…** from the command menu to change the model mid-session. You can also click the model name at the bottom of the prompt box to open the same picker.

114* **Command menu**: click `/` or type `/` to open the command menu. Options include attaching files, switching models, and toggling extended thinking. The Customize section provides access to MCP servers, slash commands, output styles, hooks, memory, permissions, and plugins. Items with a terminal icon open in the integrated terminal.118

119 When the current model supports [effort levels](/docs/pt/model-config#adjust-effort-level), the picker also shows an **Effort** row and the model name button shows the selected level. When you pick a level other than `max`, Claude Code saves it for the current model as your default, under [`modelSettings`](/docs/pt/settings-reference#modelsettings) in your user settings; `max` applies to the current session only. The model name button and the **Effort** row require Claude Code v2.1.257 or later.

120* **Command menu**: click `/` or type `/` to open the command menu. Options include attaching files, switching models, and toggling extended thinking.

121

122 The Customize section provides access to MCP servers, commands, output styles, hooks, memory, instructions, permissions, and plugins. Items with a terminal icon open in the integrated terminal.

123

115 * To browse commands such as `/usage` or [`/remote-control`](/docs/pt/remote-control), select **Slash commands** in the Customize section. A dialog lists them with a filter box. Pick one to run it. Typing `/` in the prompt box still suggests commands inline. Requires Claude Code v2.1.257 or later.124 * To browse commands such as `/usage` or [`/remote-control`](/docs/pt/remote-control), select **Slash commands** in the Customize section. A dialog lists them with a filter box. Pick one to run it. Typing `/` in the prompt box still suggests commands inline. Requires Claude Code v2.1.257 or later.

116 * Select **Output styles** in the Customize section to pick an [output style](/docs/pt/output-styles), including your custom styles. Requires Claude Code v2.1.257 or later.125 * Select **Output styles** in the Customize section to pick an [output style](/docs/pt/output-styles), including your custom styles. Requires Claude Code v2.1.257 or later.

117 126

118 To create a custom style instead, select **Build a custom style** from the **Output styles** menu. Claude Code writes the [style file](/docs/pt/output-styles#create-a-custom-output-style) for you at the project or user level. Requires Claude Code v2.1.261 or later.127 To create a custom style instead, select **Build a custom style** from the **Output styles** menu. Claude Code writes the [style file](/docs/pt/output-styles#create-a-custom-output-style) for you at the project or user level. Requires Claude Code v2.1.261 or later.

119 * Select **Hooks** in the Customize section to view the [hooks](/docs/pt/hooks) loaded in the session, grouped by event. You can add, edit, or remove hooks saved in your user, project, and local settings files. Hooks from other sources, such as managed settings or plugins, are read-only. Requires Claude Code v2.1.269 or later.128 * Select **Hooks** in the Customize section to view the [hooks](/docs/pt/hooks) loaded in the session, grouped by event. You can add, edit, or remove hooks saved in your user, project, and local settings files. Hooks from other sources, such as managed settings or plugins, are read-only. Requires Claude Code v2.1.269 or later.

120 * Select **Permissions** in the Customize section to view the session's [permission rules](/docs/pt/permissions), grouped into Allow, Ask, and Deny. You can add rules to your user, project, or local settings and remove rules saved there. Rules from other sources, such as managed settings or approvals made for this session only, are read-only. Requires Claude Code v2.1.269 or later.129 * Select **Permissions** in the Customize section to view the session's [permission rules](/docs/pt/permissions), grouped into Allow, Ask, and Deny. You can add rules to your user, project, or local settings and remove rules saved there. Rules from other sources, such as managed settings or approvals made for this session only, are read-only. Requires Claude Code v2.1.269 or later.

130 * Select **Memory** in the Customize section to turn [auto memory](/docs/pt/memory#auto-memory) on or off. While it's on, you can also browse the memories Claude has saved and reveal the folders that store them in your file manager. Requires Claude Code v2.1.274 or later.

131

132 Click a saved memory to read it in the dialog, where you can edit the text, delete the memory, or open its file in the editor. Viewing, editing, and deleting a memory in the dialog require Claude Code v2.1.275 or later.

133 * Select **Instructions** in the Customize section to edit the [CLAUDE.md files](/docs/pt/memory#claude-md-files) Claude reads. Pick a file to open it in the editor. If the file doesn't exist yet, Claude Code creates it first. Requires Claude Code v2.1.274 or later.

121 * The Settings section includes **Enable Remote Control for all sessions**, which sets [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) to control whether [new interactive sessions connect to Remote Control automatically](/docs/pt/remote-control#enable-remote-control-for-all-sessions). Requires Claude Code v2.1.203 or later.134 * The Settings section includes **Enable Remote Control for all sessions**, which sets [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) to control whether [new interactive sessions connect to Remote Control automatically](/docs/pt/remote-control#enable-remote-control-for-all-sessions). Requires Claude Code v2.1.203 or later.

122 135

123 When you turn the toggle on or off in a VS Code window, the change applies to the sessions already open in that VS Code window, not only to sessions you start afterwards. If you turn it off, the open sessions disconnect. With Claude Code v2.1.261 or later, the change also reaches sessions open in your other VS Code windows.136 When you turn the toggle on or off in a VS Code window, the change applies to the sessions already open in that VS Code window, not only to sessions you start afterwards. If you turn it off, the open sessions disconnect. With Claude Code v2.1.261 or later, the change also reaches sessions open in your other VS Code windows.

124 * The Settings section also includes **Focus view**, which hides tool calls, tool results, and thinking behind expandable rows, leaving your prompts and Claude's responses. Toggle it there, with `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), or from the Command Palette with **Claude Code: Toggle Focus view**. The change applies to every open session and persists across sessions. Requires Claude Code v2.1.221 or later.137 * The Settings section also includes **Focus view**, which hides tool calls, tool results, and thinking behind expandable rows, leaving your prompts and Claude's responses. Toggle it there, with `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), or from the Command Palette with **Claude Code: Toggle Focus view**. The change applies to every open session and persists across sessions. Requires Claude Code v2.1.221 or later.

125 138

126 Claude's latest to-do list stays visible, and so does the text a pending question from Claude is asking about; this requires Claude Code v2.1.225 or later. While Claude runs [subagents](/docs/pt/sub-agents), live progress rows with their latest activity appear under the tool-call group that started them. This requires Claude Code v2.1.269 or later.139 Claude's latest to-do list stays visible, and so does the text a pending question from Claude is asking about; this requires Claude Code v2.1.225 or later. While Claude runs [subagents](/docs/pt/sub-agents), live progress rows with their latest activity appear under the tool-call group that started them. This requires Claude Code v2.1.269 or later.

140 * To sign out of your Anthropic account, select **Sign out** in the Settings section, or type `/logout`. On a [third-party provider](#use-third-party-providers), the menu doesn't offer either. Requires Claude Code v2.1.277 or later.

127 * To report a bug, click **Report a problem** at the bottom of the menu, or type `/bug` or `/feedback` with an optional description that prefills the report. When you submit the report and you're signed in to Anthropic on a first-party connection, Claude Code sends it to Anthropic. On a third-party provider, or without Anthropic credentials, the dialog still opens, but submitting shows an error and sends nothing: unlike the CLI's `/bug`, the extension doesn't write a local archive. Requires Claude Code v2.1.229 or later.141 * To report a bug, click **Report a problem** at the bottom of the menu, or type `/bug` or `/feedback` with an optional description that prefills the report. When you submit the report and you're signed in to Anthropic on a first-party connection, Claude Code sends it to Anthropic. On a third-party provider, or without Anthropic credentials, the dialog still opens, but submitting shows an error and sends nothing: unlike the CLI's `/bug`, the extension doesn't write a local archive. Requires Claude Code v2.1.229 or later.

128 142

129 If your organization's policy turns product feedback off, **Report a problem** doesn't appear in the menu, and `/bug` and `/feedback` show a `Feedback is turned off by your organization's policy or this environment's settings.` notice instead of opening the report.143 If your organization's policy turns product feedback off, **Report a problem** doesn't appear in the menu, and `/bug` and `/feedback` show a `Feedback is turned off by your organization's policy or this environment's settings.` notice instead of opening the report.

130* **Side questions**: type `/btw` followed by a question to ask about your session [without adding to the conversation](/docs/pt/interactive-mode#side-questions-with-%2Fbtw). The answer opens in a panel beside the chat, where you can ask follow-up questions. The thread survives window reloads. Claude Code keeps the newest 20 exchanges and expires stored threads on the [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) schedule, as long as Claude Code can [safely determine the retention period](/docs/pt/claude-directory#cleaned-up-automatically). To clear a thread, click the trash icon in the panel. Requires Claude Code v2.1.227 or later.144* **Side questions**: type `/btw` followed by a question to ask about your session [without adding to the conversation](/docs/pt/interactive-mode#side-questions-with-%2Fbtw). The answer opens in a panel beside the chat, where you can ask follow-up questions. The thread survives window reloads. Claude Code keeps the newest 20 exchanges and expires stored threads on the [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) schedule, as long as Claude Code can [safely determine the retention period](/docs/pt/claude-directory#cleaned-up-automatically). To clear a thread, click the trash icon in the panel. Requires Claude Code v2.1.227 or later.

145* **Copy a response**: hover over a response and click **Copy response** to copy it to your clipboard, or type `/copy` to copy the latest response. `/copy 2` copies the second-to-last. Requires Claude Code v2.1.277 or later.

131* **Context indicator**: the prompt box shows how much of Claude's context window you're using. Claude automatically compacts when needed, or you can run `/compact` manually.146* **Context indicator**: the prompt box shows how much of Claude's context window you're using. Claude automatically compacts when needed, or you can run `/compact` manually.

132* **Prompt cache clock**: a clock icon next to the context indicator estimates how much time the conversation's [prompt cache](/docs/pt/prompt-caching) has left before it expires. It counts down from the cache's five-minute or one-hour [lifetime](/docs/pt/prompt-caching#cache-lifetime), and each response that uses the cache restarts the countdown. Apart from compaction, the [actions that invalidate the cache](/docs/pt/prompt-caching#actions-that-invalidate-the-cache) don't reset the clock, so it can still show minutes left after you switch models.147* **Prompt cache clock**: a clock icon next to the context indicator estimates how much time the conversation's [prompt cache](/docs/pt/prompt-caching) has left before it expires. It counts down from the cache's five-minute or one-hour [lifetime](/docs/pt/prompt-caching#cache-lifetime), and each response that uses the cache restarts the countdown. Apart from compaction, the [actions that invalidate the cache](/docs/pt/prompt-caching#actions-that-invalidate-the-cache) don't reset the clock, so it can still show minutes left after you switch models.

133 * Until the countdown runs out, the icon shows the minutes left, such as **12m**.148 * Until the countdown runs out, the icon shows the minutes left, such as **12m**.

136* **Agent map**: when the conversation includes [subagents](/docs/pt/sub-agents), an agent count such as **2 agents** appears at the bottom of the prompt box. Its dot shows whether any subagent is working or waiting for your permission.151* **Agent map**: when the conversation includes [subagents](/docs/pt/sub-agents), an agent count such as **2 agents** appears at the bottom of the prompt box. Its dot shows whether any subagent is working or waiting for your permission.

137 152

138 Click the agent count to open the agent map, which draws the conversation's subagents as a tree under the main agent, each with its status, elapsed time, and token count. Click a subagent to see its prompt and tool calls, open its read-only transcript, or stop it while it runs. Requires Claude Code v2.1.269 or later.153 Click the agent count to open the agent map, which draws the conversation's subagents as a tree under the main agent, each with its status, elapsed time, and token count. Click a subagent to see its prompt and tool calls, open its read-only transcript, or stop it while it runs. Requires Claude Code v2.1.269 or later.

154

155 The map also lists the session's other [background tasks](/docs/pt/tools-reference#background-commands), such as background shell commands and [monitors](/docs/pt/tools-reference#monitor-tool), below the agents. Click a row to open the task's card and stop it there.

156

157 To open the map when no agent count is showing, such as when Claude has started a background shell but no subagents, type `/tasks` in the prompt box. Background tasks in the map and the typed `/tasks` require Claude Code v2.1.277 or later.

139* **Extended thinking**: lets Claude spend more time reasoning through complex problems. Toggle it on via the command menu (`/`). Claude's reasoning appears in the conversation as collapsed blocks: click a block to read it, or press `Ctrl+O` to expand or collapse every thinking block in the session. See [Extended thinking](/docs/pt/model-config#extended-thinking) for details.158* **Extended thinking**: lets Claude spend more time reasoning through complex problems. Toggle it on via the command menu (`/`). Claude's reasoning appears in the conversation as collapsed blocks: click a block to read it, or press `Ctrl+O` to expand or collapse every thinking block in the session. See [Extended thinking](/docs/pt/model-config#extended-thinking) for details.

140* **Multi-line input**: press `Shift+Enter` to add a new line without sending. This also works in the "Other" free-text input of question dialogs.159* **Multi-line input**: press `Shift+Enter` to add a new line without sending. This also works in the "Other" free-text input of question dialogs.

141 160

154 173

155When you select text in the editor, Claude can see your highlighted code automatically. The prompt box footer shows how many lines are selected. Press `Option+K` (Mac) / `Alt+K` (Windows/Linux) to insert an @-mention with the file path and line numbers (e.g., `@app.ts#5-10`). Click the **X** on the selection indicator to remove it so Claude doesn't receive the selection. The indicator comes back when you select other text.174When you select text in the editor, Claude can see your highlighted code automatically. The prompt box footer shows how many lines are selected. Press `Option+K` (Mac) / `Alt+K` (Windows/Linux) to insert an @-mention with the file path and line numbers (e.g., `@app.ts#5-10`). Click the **X** on the selection indicator to remove it so Claude doesn't receive the selection. The indicator comes back when you select other text.

156 175

176The extension withholds selected text from some files. When the file is inside your workspace and matches your `files.exclude` or `search.exclude` settings, Claude receives at most the file's path and not the text you selected. The same applies to a file git ignores, as long as VS Code's `search.useIgnoreFiles` setting and the extension's [`respectGitIgnore` setting](#extension-settings) are both on, which is the default. This filter covers the chat panel only: when Claude Code runs in the integrated terminal, the CLI sends your selected text whatever the file, so add a [`Read` deny rule](#the-built-in-ide-mcp-server) to keep a file's contents from Claude there.

177

157Claude also sees which file you have open in the editor, even when nothing is selected, and the prompt box shows its name. To add only your selected text, turn off the [Attach Open File setting](vscode://settings/claudeCode.attachOpenFile). The setting requires Claude Code v2.1.271 or later.178Claude also sees which file you have open in the editor, even when nothing is selected, and the prompt box shows its name. To add only your selected text, turn off the [Attach Open File setting](vscode://settings/claudeCode.attachOpenFile). The setting requires Claude Code v2.1.271 or later.

158 179

159To attach an image, paste it from your clipboard into the prompt box. You can also hold `Shift` while dragging files into the prompt box to add them as attachments. Click the X on any attachment to remove it from context.180You can also attach images and files to your message:

181

182* To attach an image, paste it from your clipboard into the prompt box.

183* To attach files, hold `Shift` while dragging them into the prompt box.

184* To remove an attachment from context, click the X on it.

160 185

161<h3 id="resume-past-conversations">186<h3 id="resume-past-conversations">

162 Resume past conversations187 Resume past conversations

171 196

172By default, a session with no activity for 14 days moves to **Archived sessions** automatically, unless it is open, unread, or in a [group](#organize-sessions-into-groups). Automatic archiving requires Claude Code v2.1.265 or later. To change the period or turn it off, open the [Archive Inactive Sessions setting](vscode://settings/claudeCode.archiveInactiveSessions) and select a number of days or **Never**.197By default, a session with no activity for 14 days moves to **Archived sessions** automatically, unless it is open, unread, or in a [group](#organize-sessions-into-groups). Automatic archiving requires Claude Code v2.1.265 or later. To change the period or turn it off, open the [Archive Inactive Sessions setting](vscode://settings/claudeCode.archiveInactiveSessions) and select a number of days or **Never**.

173 198

174To restore an archived session, expand **Archived sessions** and click **Unarchive session**. Before v2.1.257, the action was **Delete session**, which hid a session with no way to restore it. Sessions you deleted then appear under **Archived sessions** after you upgrade.199To restore an archived session, expand **Archived sessions** and click **Unarchive session**. To restore every archived session at once, hover over the **Archived sessions** header in the sessions list in the Activity Bar and click its unarchive icon, which requires Claude Code v2.1.277 or later. Before v2.1.257, the action was **Delete session**, which hid a session with no way to restore it. Sessions you deleted then appear under **Archived sessions** after you upgrade.

175 200

176When the conversation you resume ended in plan mode, Claude Code restores plan mode. Requires Claude Code v2.1.246 or later. Claude Code doesn't restore it in two cases:201When the conversation you resume ended in plan mode, Claude Code restores plan mode. Requires Claude Code v2.1.246 or later. Claude Code doesn't restore it in two cases:

177 202

206 Check account and usage231 Check account and usage

207</h3>232</h3>

208 233

209Run `/usage` to open the Account & usage dialog. The dialog requires a claude.ai sign-in, so it isn't offered on a [third-party provider](#use-third-party-providers). It shows your signed-in account, your plan, and usage bars for your plan's limits, such as the current session and the week. Each bar shows how long until its limit resets.234Run `/usage` to open the Account & usage dialog. It shows your signed-in account, and the usage it reports differs by sign-in:

210 235

211The dialog also breaks down what is contributing to your plan limits. It flags behaviors that account for 10% or more of recent usage, such as cache misses, long context, and subagent-heavy or highly parallel sessions, each with a tip to reduce it. Attribution tables show how much usage came from each skill, subagent, plugin, and MCP server.236* **claude.ai plan**: usage bars for your plan's limits, such as the current session and the week. Each bar shows how long until its limit resets.

212 237

213Use the Day and Week toggle to switch between the last 24 hours and the last 7 days. The figures are approximate and computed from local sessions on this machine, so usage from other devices or claude.ai is not included. For more on tracking and reducing usage, see [Track your costs](/docs/pt/costs#track-your-costs).238 The dialog also breaks down what is contributing to your plan limits. It flags behaviors that account for 10% or more of recent usage, such as cache misses, long context, and subagent-heavy or highly parallel sessions, each with a tip to reduce it. Attribution tables show how much usage came from each skill, subagent, plugin, and MCP server.

239

240 Use the Day and Week toggle to switch between the last 24 hours and the last 7 days. The figures are approximate and computed from local sessions on this machine, so usage from other devices or claude.ai is not included.

241* **Other sign-ins**: when plan limits don't apply to your sign-in, such as on a [third-party provider](#use-third-party-providers) or with an API key, the Usage section shows the session's own cost and token usage instead. The CLI's `/usage` shows the same totals in its [Session block](/docs/pt/costs#track-your-costs). The sessions list in the Activity Bar also shows the active session's totals under its **Account & usage** header. Requires Claude Code v2.1.277 or later.

242

243For more on tracking and reducing usage, see [Track your costs](/docs/pt/costs#track-your-costs).

214 244

215<h2 id="customize-your-workflow">245<h2 id="customize-your-workflow">

216 Personalize seu fluxo de trabalho246 Personalize seu fluxo de trabalho

228* **Barra lateral primária**: a barra lateral esquerda com ícones para Explorer, Search, etc.258* **Barra lateral primária**: a barra lateral esquerda com ícones para Explorer, Search, etc.

229* **Área do editor**: abre Claude como uma aba ao lado de seus arquivos. Útil para tarefas secundárias.259* **Área do editor**: abre Claude como uma aba ao lado de seus arquivos. Útil para tarefas secundárias.

230 260

261Quando Claude abre uma aba em um novo grupo de editor, a extensão bloqueia esse grupo, então os arquivos que você abre enquanto a aba Claude está em foco vão para outro grupo em vez de ficar ao lado dela.

262

263Para impedir que a extensão bloqueie grupos, desative a [configuração Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Os grupos que já estão bloqueados permanecem bloqueados até que você os desbloqueie. A configuração requer Claude Code v2.1.274 ou posterior.

264

231<Tip>265<Tip>

232 Use a barra lateral para sua sessão principal do Claude e abra abas adicionais para tarefas secundárias. Claude lembra sua localização preferida. O ícone da lista de sessões da Activity Bar é separado do painel Claude: a lista de sessões está sempre visível na Activity Bar, enquanto o ícone do painel Claude só aparece lá quando o painel está encaixado na barra lateral esquerda.266 Use a barra lateral para sua sessão principal do Claude e abra abas adicionais para tarefas secundárias. Claude lembra sua localização preferida. O ícone da lista de sessões da Activity Bar é separado do painel Claude: a lista de sessões está sempre visível na Activity Bar, enquanto o ícone do painel Claude só aparece lá quando o painel está encaixado na barra lateral esquerda.

233</Tip>267</Tip>

237* **Aba do editor**: a conversa volta com sua aba.271* **Aba do editor**: a conversa volta com sua aba.

238* **Barra lateral**: a conversa volta se você enviou uma mensagem ou Claude respondeu nela nos últimos 10 minutos. Se ela não voltar, retome a conversa do [Histórico de sessões](#resume-past-conversations).272* **Barra lateral**: a conversa volta se você enviou uma mensagem ou Claude respondeu nela nos últimos 10 minutos. Se ela não voltar, retome a conversa do [Histórico de sessões](#resume-past-conversations).

239 273

274Se o recarregamento interrompeu Claude no meio de uma etapa, Claude continua essa etapa quando a conversa volta, e um aviso no chat marca a continuação. Requer Claude Code v2.1.274 ou posterior. Se a etapa foi interrompida há mais de uma hora ou a sessão está aberta em outro lugar, a conversa volta inativa em vez disso.

275

276Para desativar a continuação, abra a [configuração Continue After Reload](vscode://settings/claudeCode.continueAfterReload) e desmarque-a.

277

240<h3 id="run-multiple-conversations">278<h3 id="run-multiple-conversations">

241 Execute múltiplas conversas279 Execute múltiplas conversas

242</h3>280</h3>

304A URL aceita dois parâmetros de consulta:342A URL aceita dois parâmetros de consulta:

305 343

306| Parâmetro | Descrição |344| Parâmetro | Descrição |

307| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |345| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

309| `marketplace` | De onde o plugin vem, em qualquer forma que a [aba Marketplaces](#manage-marketplaces) aceita, como um `owner/repo` do GitHub ou uma URL git. Codifique-o em URL se contiver caracteres como `&`. Padrão para `anthropics/claude-plugins-official` quando omitido. |347| `marketplace` | De onde o plugin vem: um `owner/repo` do GitHub, uma URL `https://`, ou uma URL git SSH como `git@github.com:owner/repo.git`. Padrão para `anthropics/claude-plugins-official` quando omitido. |

348

349Alguns valores que a [aba Marketplaces](#manage-marketplaces) aceita não funcionam em um link, como um caminho local ou um endereço `http://`. Para esses, VS Code mostra uma mensagem de erro e o diálogo não abre.

310 350

311Dois casos terminam em uma mensagem no diálogo em vez da escolha de escopo:351Dois casos terminam em uma mensagem no diálogo em vez da escolha de escopo:

312 352

364</Note>404</Note>

365 405

367| -------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |407| -------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

409| Focus last message | - | Mova o foco do teclado para a mensagem mais recente na conversa, ou para um prompt de permissão pendente, para que você possa ler a partir daí com o teclado ou um leitor de tela. Não disponível em [modo terminal](#switch-to-terminal-mode). Requer Claude Code v2.1.268 ou posterior |

369| Open in Side Bar | - | Abrir Claude na barra lateral |410| Open in Side Bar | - | Abrir Claude na barra lateral |

370| Open in Terminal | - | Abrir Claude no modo terminal |411| Open in Terminal | - | Abrir Claude no modo terminal |

373| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Iniciar uma nova conversa. Requer que o Claude esteja focado e `enableNewConversationShortcut` definido como `true` |414| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Iniciar uma nova conversa. Requer que o Claude esteja focado e `enableNewConversationShortcut` definido como `true` |

374| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Reabrir a aba de sessão do Claude fechada mais recentemente. Volta para a reabertura normal de editor fechado do VS Code quando a última aba fechada não era uma sessão do Claude. Desabilitar com `enableReopenClosedSessionShortcut` |415| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Reabrir a aba de sessão do Claude fechada mais recentemente. Volta para a reabertura normal de editor fechado do VS Code quando a última aba fechada não era uma sessão do Claude. Desabilitar com `enableReopenClosedSessionShortcut` |

417| Accept Change at Cursor | - | Aceitar a alteração no cursor enquanto [revisa uma edição proposta](#get-started) uma alteração por vez. Requer Claude Code v2.1.275 ou posterior |

418| Reject Change at Cursor | - | Reverter a alteração no cursor enquanto revisa uma edição proposta uma alteração por vez. Requer Claude Code v2.1.275 ou posterior |

376| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Ocultar ou mostrar atividade de ferramenta na conversa. Funciona enquanto um painel ou barra lateral do Claude está visível. Requer Claude Code v2.1.221 ou posterior |419| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Ocultar ou mostrar atividade de ferramenta na conversa. Funciona enquanto um painel ou barra lateral do Claude está visível. Requer Claude Code v2.1.221 ou posterior |

377| Rename Session Tab | - | Renomear a sessão na aba ativa do Claude. Requer Claude Code v2.1.257 ou posterior |420| Rename Session Tab | - | Renomear a sessão na aba ativa do Claude. Requer Claude Code v2.1.257 ou posterior |

378| Add Session Tab to Group | - | Adicionar a sessão na aba ativa do Claude a um [grupo de sessão](#organize-sessions-into-groups) que você escolher ou criar. Requer Claude Code v2.1.257 ou posterior |421| Add Session Tab to Group | - | Adicionar a sessão na aba ativa do Claude a um [grupo de sessão](#organize-sessions-into-groups) que você escolher ou criar. Requer Claude Code v2.1.257 ou posterior |

458| `initialPermissionMode` | - | 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. Quando você deixa sem definir, a extensão escolhe o modo de permissão inicial conforme descrito em [Switch permission modes](/docs/pt/permission-modes#switch-permission-modes). |501| `initialPermissionMode` | - | 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. Quando você deixa sem definir, a extensão escolhe o modo de permissão inicial conforme descrito em [Switch permission modes](/docs/pt/permission-modes#switch-permission-modes). |

503| `lockEditorGroups` | `true` | [Bloquear os grupos de editor que Claude inicia para suas abas](#choose-where-claude-lives), para que os arquivos que você abre enquanto uma aba Claude está em foco vão para outro grupo. Quando desativado, a extensão nunca bloqueia um grupo de editor. Requer Claude Code v2.1.274 ou posterior |

461| `attachOpenFile` | `true` | Adicione o arquivo que está aberto no editor às suas mensagens e mostre-o na caixa de prompt. Quando desativado, apenas o texto selecionado é adicionado. Requer Claude Code v2.1.271 ou posterior |505| `attachOpenFile` | `true` | Adicione o arquivo que está aberto no editor às suas mensagens e mostre-o na caixa de prompt. Quando desativado, apenas o texto selecionado é adicionado. Requer Claude Code v2.1.271 ou posterior |

507| `scrollToBottomOnSend` | `true` | Rolar a conversa para o final quando você enviar uma mensagem. Quando desativado, a conversa permanece onde você a deixou. Requer Claude Code v2.1.275 ou posterior |

464| `enableReopenClosedSessionShortcut` | `true` | Use Cmd/Ctrl+Shift+T para reabrir a aba de sessão Claude fechada mais recentemente. Quando a última aba fechada não era uma sessão Claude, o atalho executa o comando normal de reabrir editor fechado do VS Code. |509| `enableReopenClosedSessionShortcut` | `true` | Use Cmd/Ctrl+Shift+T para reabrir a aba de sessão Claude fechada mais recentemente. Quando a última aba fechada não era uma sessão Claude, o atalho executa o comando normal de reabrir editor fechado do VS Code. |

465| `archiveInactiveSessions` | `14` | [Arquivar uma sessão automaticamente](#resume-past-conversations) após este número de dias sem atividade: `1`, `2`, `7` ou `14`. Defina `0` para desativar. Requer Claude Code v2.1.265 ou posterior |510| `archiveInactiveSessions` | `14` | [Arquivar uma sessão automaticamente](#resume-past-conversations) após este número de dias sem atividade: `1`, `2`, `7` ou `14`. Defina `0` para desativar. Requer Claude Code v2.1.265 ou posterior |

511| `continueAfterReload` | `true` | Após um recarregamento de janela, Claude [continua a etapa que foi interrompida](#choose-where-claude-lives) na sessão restaurada. Requer Claude Code v2.1.274 ou posterior |

467| `focusView` | `false` | Ocultar chamadas de ferramenta, resultados de ferramenta e pensamento atrás de linhas expansíveis, deixando seus prompts e respostas do Claude. A lista de tarefas mais recente do Claude permanece visível; isso requer Claude Code v2.1.225 ou posterior. Você também pode alternar a visualização de foco no menu de comandos. Requer Claude Code v2.1.221 ou posterior |513| `focusView` | `false` | Ocultar chamadas de ferramenta, resultados de ferramenta e pensamento atrás de linhas expansíveis, deixando seus prompts e respostas do Claude. A lista de tarefas mais recente do Claude permanece visível; isso requer Claude Code v2.1.225 ou posterior. Você também pode alternar a visualização de foco no menu de comandos. Requer Claude Code v2.1.221 ou posterior |

470| `environmentVariables` | `[]` | Definir variáveis de ambiente para o processo Claude. Use as configurações do Claude Code em vez disso para configuração compartilhada. |516| `environmentVariables` | `[]` | Definir variáveis de ambiente para o processo Claude. Use as configurações do Claude Code em vez disso para configuração compartilhada. |

487* **Status changes**: the extension announces when Claude starts working, when Claude is ready for your input, and when Claude Code starts compacting the conversation.533* **Status changes**: the extension announces when Claude starts working, when Claude is ready for your input, and when Claude Code starts compacting the conversation.

488* **Errors and model prompts**: the extension announces errors in the conversation, and announces when the [usage-credits consent prompt](/docs/pt/model-config#fable-and-usage-credits) or the [flagged-request prompt](/docs/pt/model-config#ask-before-switching) appears.534* **Errors and model prompts**: the extension announces errors in the conversation, and announces when the [usage-credits consent prompt](/docs/pt/model-config#fable-and-usage-credits) or the [flagged-request prompt](/docs/pt/model-config#ask-before-switching) appears.

489 535

490Each turn in the transcript starts with a visually hidden heading labeled with the prompt that started the turn, so you can jump between turns with your screen reader's heading navigation. You can also move focus to the transcript itself with `Tab`, since the extension exposes it as a labeled region, and read it at your own pace. While Claude works, your screen reader reads a text label in place of the progress spinner's animation.536While Claude works, your screen reader reads a text label in place of the progress spinner's animation.

491 537

492When you reopen a session or switch to another one, the extension announces nothing: restored history, pending permission prompts, and in-progress status stay silent until something new happens.538When you reopen a session or switch to another one, the extension announces nothing: restored history, pending permission prompts, and in-progress status stay silent until something new happens.

493 539

540<h3 id="use-the-chat-panel-from-the-keyboard">

541 Use the chat panel from the keyboard

542</h3>

543

544Each turn in the transcript starts with a visually hidden heading labeled with the prompt that started the turn, so you can jump between turns with your screen reader's heading navigation.

545

546Within a turn, your screen reader announces whose message you're on as you move through it:

547

548* **Your messages**: "You"

549* **Claude's messages**: "Claude"

550* **Tool steps**: "Claude" plus the tool name, such as "Claude, Bash"

551* **Thinking blocks**: "Claude, thinking"

552

553Because the extension exposes the transcript as a labeled region, you can also move focus to the transcript itself with `Tab` and read it at your own pace. To move focus to the newest message or a waiting permission prompt instead, run **Claude Code: Focus last message** from the [Command Palette](#vs-code-commands-and-shortcuts).

554

555When an option on a permission prompt saves a permission rule or directory access, its label ends by naming where the approval is saved, such as "all projects" or "this session". With that option focused, press the `Left` or `Right` arrow key to change the destination, and the extension announces each destination as you move to it. You can also click the destination in the label. The arrow keys require Claude Code v2.1.268 or later.

556

494<h2 id="vs-code-extension-vs-claude-code-cli">557<h2 id="vs-code-extension-vs-claude-code-cli">

495 Extensão VS Code vs. Claude Code CLI558 Extensão VS Code vs. Claude Code CLI

496</h2>559</h2>

543 Monitorar processos em segundo plano606 Monitorar processos em segundo plano

544</h3>607</h3>

545 608

546A visibilidade de tarefas em segundo plano na extensão é limitada em comparação com o CLI. Para melhor visibilidade, peça ao Claude para exibir o comando para que você possa executá-lo no terminal integrado do VS Code.609Digite `/tasks` na caixa de prompt para abrir o [mapa de agente](#use-the-prompt-box), que lista as tarefas em segundo plano da sessão, como um servidor de desenvolvimento que Claude deixou em execução como um comando de shell em segundo plano. Clique em uma tarefa para abrir seu cartão e interrompê-la lá. Requer Claude Code v2.1.277 ou posterior.

547 610

548<h3 id="connect-to-external-tools-with-mcp">611<h3 id="connect-to-external-tools-with-mcp">

549 Conectar a ferramentas externas com MCP612 Conectar a ferramentas externas com MCP

610 </Step>673 </Step>

611</Steps>674</Steps>

612 675

613Em um provedor de terceiros, a extensão não oferece recursos que exigem uma conta claude.ai, como rastreamento de uso, [ditado por voz](/docs/pt/voice-dictation) e a aba Web para [sessões na nuvem](#resume-cloud-sessions-from-claude-ai). Um login claude.ai deixado de um `/login` anterior permanece não utilizado: a extensão não o envia com nenhuma solicitação.676Em um provedor de terceiros, a extensão não oferece recursos que exigem uma conta claude.ai, como barras de uso do plano, [ditado por voz](/docs/pt/voice-dictation) e a aba Web para [sessões na nuvem](#resume-cloud-sessions-from-claude-ai). Para o que a caixa de diálogo Conta e uso mostra nestes logins, consulte [Verificar conta e uso](#check-account-and-usage).

677

678Um login claude.ai deixado de um `/login` anterior permanece não utilizado: a extensão não o envia com nenhuma solicitação.

614 679

615<h2 id="security-and-privacy">680<h2 id="security-and-privacy">

616 Segurança e privacidade681 Segurança e privacidade

workflows.md +21 −19

Details

231 231

232Antes da v2.1.216, Claude Code seguia o link, o que poderia colocar o arquivo fora do local que você escolheu.232Antes da v2.1.216, Claude Code seguia o link, o que poderia colocar o arquivo fora do local que você escolheu.

233 233

234Em 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.234Em um monorepo com vários diretórios `.claude/`, você pode manter fluxos de trabalho ao lado do pacote ao qual se aplicam. 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.

235 235

236Se um fluxo de trabalho de projeto e um fluxo de trabalho pessoal compartilham um nome, o do projeto é executado.236Se um fluxo de trabalho de projeto e um fluxo de trabalho pessoal compartilham um nome, o do projeto é executado.

237 237

261 Exemplos de prompts de fluxo de trabalho261 Exemplos de prompts de fluxo de trabalho

262</h2>262</h2>

263 263

264Um fluxo de trabalho se encaixa melhor quando a tarefa é maior do que um agente pode manter em contexto, ou quando o mesmo passo precisa ser executado em muitos itens. Os prompts abaixo mostram formas comuns. Cada um pede a Claude para escrever e executar um fluxo de trabalho para essa tarefa; você não escreve o script você mesmo.264Um fluxo de trabalho se encaixa melhor quando a tarefa é maior do que um agente pode manter em contexto, ou quando a mesma etapa precisa ser executada em muitos itens. Os prompts abaixo mostram formas comuns. Cada um pede ao Claude para escrever e executar um fluxo de trabalho para essa tarefa; você não escreve o script você mesmo.

265 265

266<h3 id="audit-many-files-for-the-same-issue">266<h3 id="audit-many-files-for-the-same-issue">

267 Auditar muitos arquivos para o mesmo problema267 Auditar muitos arquivos para o mesmo problema

268</h3>268</h3>

269 269

270Distribua um agente por arquivo, depois colete e verifique as descobertas.270Distribua um agente por arquivo e depois colete e verifique os achados.

271 271

272```text wrap theme={null}272```text wrap theme={null}

273use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it273use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

274```274```

275 275

276<h3 id="keep-fixing-until-a-check-passes">276<h3 id="keep-fixing-until-a-check-passes">

277 Continuar corrigindo até uma verificação passar277 Continue corrigindo até que uma verificação seja aprovada

278</h3>278</h3>

279 279

280Execute um verificador, corrija o que falhou e repita até passar ou parar de fazer progresso.280Execute um verificador, corrija o que falhou e repita até que seja aprovado ou pare de fazer progresso.

281 281

282```text wrap theme={null}282```text wrap theme={null}

283use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress283use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

287 Migrar muitos arquivos em paralelo287 Migrar muitos arquivos em paralelo

288</h3>288</h3>

289 289

290Descubra os arquivos a migrar, transforme cada um em uma cópia isolada para que as edições não entrem em conflito, e verifique cada resultado.290Descubra os arquivos a migrar, transforme cada um em uma cópia isolada para que as edições não entrem em conflito e verifique cada resultado.

291 291

292```text wrap theme={null}292```text wrap theme={null}

293use a workflow to migrate every component under src/components/ from JavaScript to TypeScript, working on each file in its own isolated copy293use a workflow to migrate every component under src/components/ from JavaScript to TypeScript, working on each file in its own isolated copy

297 Revisar cada arquivo alterado e escrever um resumo297 Revisar cada arquivo alterado e escrever um resumo

298</h3>298</h3>

299 299

300Execute um revisor por arquivo, depois entregue todas as descobertas a um agente que as classifica e deduplicar.300Execute um revisor por arquivo e depois passe todos os achados para um agente que os classifica e deduplica.

301 301

302```text wrap theme={null}302```text wrap theme={null}

303use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary303use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

307 Pesquisar um tópico em muitas fontes307 Pesquisar um tópico em muitas fontes

308</h3>308</h3>

309 309

310Distribua leitores em changelogs, problemas e documentos, depois sintetize. O fluxo de trabalho `/deep-research` agrupado faz isso; você também pode descrever uma versão mais estreita.310Distribua leitores entre changelogs, problemas e documentação e depois sintetize. O fluxo de trabalho `/deep-research` incluído faz isso; você também pode descrever uma versão mais restrita.

311 311

312```text wrap theme={null}312```text wrap theme={null}

313use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches313use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

314```314```

315 315

316<h3 id="find-issues-until-the-list-stops-growing">316<h3 id="find-issues-until-the-list-stops-growing">

317 Encontrar problemas até a lista parar de crescer317 Encontrar problemas até que a lista pare de crescer

318</h3>318</h3>

319 319

320Continue pesquisando em rodadas e pare quando novas rodadas não encontrarem nada novo.320Continue pesquisando em rodadas e pare quando novas rodadas não encontrarem nada novo.

327 Como o script salvo se parece327 Como o script salvo se parece

328</h3>328</h3>

329 329

330Quando você [salva um fluxo de trabalho](#save-the-workflow-for-reuse), o arquivo em `.claude/workflows/` contém um bloco `meta` seguido por um corpo de script que orquestra subagentos. Você geralmente não precisa editá-lo, mas aqui está a forma de um pequeno para que você possa reconhecer o que Claude gerou:330Quando você [salva um fluxo de trabalho](#save-the-workflow-for-reuse), o arquivo em `.claude/workflows/` contém um bloco `meta` seguido por um corpo de script que orquestra subagentes. Você geralmente não precisa editá-lo, mas aqui está a forma de um pequeno para que você possa reconhecer o que Claude gerou:

331 331

332```javascript theme={null}332```javascript theme={null}

333export const meta = {333export const meta = {

346return audits.filter(Boolean)346return audits.filter(Boolean)

347```347```

348 348

349O corpo é JavaScript simples com `await` de nível superior. `agent()` spawna um subagentos, `pipeline()` executa um por item em uma lista, e `parallel()` executa um conjunto de tarefas de agente ao mesmo tempo e aguarda todas elas.349O corpo é JavaScript simples com `await` no nível superior. `agent()` gera um subagente, `pipeline()` executa um por item em uma lista, e `parallel()` executa um conjunto de tarefas de agente ao mesmo tempo e aguarda todas elas.

350 350

351Uma chamada `agent()` é resolvida para `null` se você a interromper no meio da execução ou se ela atingir um erro de API irrecuperável. Em [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), o classificador pode bloquear uma chamada `agent()` antes do subagentos iniciar. Uma chamada bloqueada é resolvida para `null` e aparece na visualização de progresso da execução com o motivo. `pipeline()` mantém cada `null` na matriz de resultados, e é por isso que o exemplo termina com `.filter(Boolean)` para descartar essas entradas.351Uma chamada `agent()` é resolvida para `null` se você a interromper no meio da execução ou se ela atingir um erro de API irrecuperável. `pipeline()` mantém cada `null` na matriz de resultados, e é por isso que o exemplo termina com `.filter(Boolean)` para descartar essas entradas.

352 352

353Se você passar um `schema` em uma chamada `agent()`, esse subagentos retorna JSON correspondendo à forma em vez de prosa. Claude Code verifica o schema antes de iniciar o subagentos: quando pode provar que o schema contradiz a si mesmo, a chamada falha com um erro nomeando a contradição, e o subagentos nunca inicia. Uma contradição que pode provar é uma chave `required` que `additionalProperties: false` descarta.353No [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), o prompt que seu script passa para `agent()` não conta como uma solicitação sua quando o classificador revisa as ações desse subagente, porque Claude Code o marca como texto que o script calculou.

354 354

355Se a saída do subagentos ainda falhar na validação após cinco tentativas, a chamada falha com um erro que inclui a última falha de validação. Para alterar a contagem de tentativas, defina [`MAX_STRUCTURED_OUTPUT_RETRIES`](/docs/pt/env-vars).355Se você passar um `schema` em uma chamada `agent()`, esse subagente retorna JSON correspondente à forma em vez de prosa. Claude Code verifica o schema antes de iniciar o subagente: quando pode provar que o schema se contradiz, a chamada falha com um erro nomeando a contradição, e o subagente nunca é iniciado. Uma contradição que pode provar é uma chave `required` que `additionalProperties: false` exclui.

356

357Se a saída do subagente ainda falhar na validação após cinco tentativas, a chamada falha com um erro que inclui a última falha de validação. Para alterar a contagem de tentativas, defina [`MAX_STRUCTURED_OUTPUT_RETRIES`](/docs/pt/env-vars).

356 358

357<h3 id="edit-a-saved-script">359<h3 id="edit-a-saved-script">

358 Editar um script salvo360 Editar um script salvo

359</h3>361</h3>

360 362

361Para alterar um [fluxo de trabalho que você salvou](#save-the-workflow-for-reuse), edite seu arquivo `.js` ou peça a Claude para fazer a alteração. Antes de editar ou pedir, execute a [skill agrupada](/docs/pt/skills#bundled-skills) `/workflow-authoring` para carregar a referência de escrita de script com a qual Claude trabalha. A skill requer Claude Code v2.1.248 ou posterior.363Para alterar um [fluxo de trabalho que você salvou](#save-the-workflow-for-reuse), edite seu arquivo `.js` ou peça ao Claude para fazer a alteração. Antes de editar ou pedir, execute a [skill incluída](/docs/pt/skills#bundled-skills) `/workflow-authoring` para carregar a referência de escrita de script com a qual Claude trabalha. A skill requer Claude Code v2.1.248 ou posterior.

362 364

363Para executar a versão editada na sessão atual, execute [`/reload-skills`](/docs/pt/commands#all-commands) para reler os diretórios de fluxo de trabalho, depois execute `/<name>` novamente.365Para executar a versão editada na sessão atual, execute [`/reload-skills`](/docs/pt/commands#all-commands) para reler os diretórios de fluxo de trabalho e depois execute `/<name>` novamente.

364 366

365Claude Code aplica essas regras a cada parte do arquivo quando carrega e executa o script:367Claude Code aplica essas regras a cada parte do arquivo quando carrega e executa o script:

366 368

367* **Bloco `meta`**: mantenha `export const meta` como a primeira instrução, e mantenha-o um objeto literal simples com um `name` e uma `description`. Se contiver qualquer coisa além de valores literais, como uma variável, uma chamada de função ou um spread, Claude Code descarta `/<name>` do autocomplete `/`.369* **Bloco `meta`**: mantenha `export const meta` como a primeira instrução e mantenha-o um objeto literal simples com um `name` e uma `description`. Se contiver algo diferente de valores literais, como uma variável, uma chamada de função ou um spread, Claude Code remove `/<name>` do autocomplete `/`.

368* **Corpo**: além de `agent()`, `pipeline()` e `parallel()`, você pode chamar `phase()` para agrupar os agentes que seguem sob um título na visualização de progresso, chamar `log()` para mostrar uma mensagem acima das fases, e ler o global [`args`](#pass-input-to-a-saved-workflow). Se o corpo tiver um erro de sintaxe, Claude Code o reporta quando você executa o fluxo de trabalho.370* **Corpo**: além de `agent()`, `pipeline()` e `parallel()`, você pode chamar `phase()` para agrupar os agentes que seguem sob um título na visualização de progresso, chamar `log()` para mostrar uma mensagem acima das fases e ler o global [`args`](#pass-input-to-a-saved-workflow). Se o corpo tiver um erro de sintaxe, Claude Code o reportará quando você executar o fluxo de trabalho.

369* **`phases`**: se você listá-las em `meta`, dê a cada entrada exatamente o título que você passa para `phase()`. Um título `phase()` sem entrada obtém seu próprio grupo de progresso.371* **`phases`**: se você listá-las em `meta`, dê a cada entrada exatamente o título que você passa para `phase()`. Um título `phase()` sem entrada obtém seu próprio grupo de progresso.

370* **Timestamps e aleatoriedade**: Claude Code faz `Date.now()`, `Math.random()` e um `new Date()` sem argumentos lançarem dentro do script, para que uma [execução relançada](#resume-after-a-pause) repita as mesmas chamadas `agent()`. Passe um timestamp através de `args` em vez disso.372* **Timestamps e aleatoriedade**: Claude Code faz `Date.now()`, `Math.random()` e um `new Date()` sem argumentos lançarem dentro do script, para que uma [execução relançada](#resume-after-a-pause) repita as mesmas chamadas `agent()`. Passe um timestamp através de `args` em vez disso.

371 373

372Você também pode editar [o script de uma única execução](#how-a-workflow-runs) em vez da cópia salva. [Retomar após uma pausa](#resume-after-a-pause) cobre quais agentes executam novamente quando você relança um script editado. Para as entradas da ferramenta Workflow, consulte sua entrada na [referência do Agent SDK](/docs/pt/agent-sdk/typescript#workflow).374Você também pode editar [o script de uma única execução](#how-a-workflow-runs) em vez da cópia salva. [Retomar após uma pausa](#resume-after-a-pause) cobre quais agentes são executados novamente quando você relança um script editado. Para as entradas da ferramenta Workflow, consulte sua entrada na [referência do Agent SDK](/docs/pt/agent-sdk/typescript#workflow).

373 375

374<h2 id="how-a-workflow-runs">376<h2 id="how-a-workflow-runs">

375 Como um fluxo de trabalho é executado377 Como um fluxo de trabalho é executado

worktrees.md +10 −5

Details

59 Limpe worktrees59 Limpe worktrees

60</h2>60</h2>

61 61

~~62Quando você sai de uma sessão de worktree interativa, Claude verifica a worktree para trabalho que a remoção deletaria: arquivos alterados ou não rastreados, e novos commits.~~62Quando você sai de uma sessão de worktree interativa, Claude verifica a worktree para trabalho que a remoção deletaria: arquivos alterados ou não rastreados, trabalho não confirmado dentro de submódulos verificados e novos commits.

63 63

64* **A worktree está limpa**: para uma sessão sem nome, Claude remove a worktree e seu branch automaticamente. Uma sessão [nomeada](/docs/pt/sessions#name-your-sessions) solicita primeiro para que você possa manter a worktree para depois64* **A worktree está limpa**: para uma sessão sem nome, Claude remove a worktree e seu branch automaticamente. Uma sessão [nomeada](/docs/pt/sessions#name-your-sessions) solicita primeiro para que você possa manter a worktree para depois

65* **A worktree tem trabalho nela**: Claude solicita que você mantenha ou remova a worktree. Manter preserva o diretório e branch para que você possa retornar depois. Remover deleta o diretório da worktree e seu branch, junto com todo o trabalho neles65* **A worktree tem trabalho nela**: Claude solicita que você mantenha ou remova a worktree. Manter preserva o diretório e branch para que você possa retornar depois. Remover deleta o diretório da worktree e seu branch, junto com todo o trabalho neles

66* **O estado da worktree não pode ser verificado**: quando Claude Code não consegue contar as alterações da worktree ou não consegue inspecionar seus checkouts de submódulo, ele solicita em vez de remover a worktree automaticamente. O prompt nomeia o que não conseguiu verificar

66 67

67Execuções não interativas com `-p` não têm prompt de saída, então Claude não limpa suas worktrees, e Claude Code deixa o bloqueio que tomou em cada uma na criação em vigor até que uma [varredura de bloqueio obsoleto](#clean-up-subagent-and-background-session-worktrees) posterior o libere. Para remover uma, execute `git worktree remove`; se git recusar porque a worktree está bloqueada, execute `git worktree unlock` nela primeiro.68Execuções não interativas com `-p` não têm prompt de saída, então Claude não limpa suas worktrees, e Claude Code deixa o bloqueio que tomou em cada uma na criação em vigor até que uma [varredura de bloqueio obsoleto](#clean-up-subagent-and-background-session-worktrees) posterior o libere. Para remover uma, execute `git worktree remove`; se git recusar porque a worktree está bloqueada, execute `git worktree unlock` nela primeiro.

68 69

101* **Edições de arquivo**: Claude Code bloqueia um `Edit`, `Write`, ou `NotebookEdit` que visa um caminho no checkout principal.102* **Edições de arquivo**: Claude Code bloqueia um `Edit`, `Write`, ou `NotebookEdit` que visa um caminho no checkout principal.

102* **Diretório de trabalho do comando**: Claude Code bloqueia um comando Bash, PowerShell, ou Monitor cujo diretório de trabalho resolve para o checkout principal, ou cujo diretório de trabalho não pode verificar que fica fora dele.103* **Diretório de trabalho do comando**: Claude Code bloqueia um comando Bash, PowerShell, ou Monitor cujo diretório de trabalho resolve para o checkout principal, ou cujo diretório de trabalho não pode verificar que fica fora dele.

103* **Redirecionamentos git**: Claude Code bloqueia um comando Bash ou Monitor que redireciona git para o checkout principal. O redirecionamento pode vir através de `git -C`, `--git-dir`, uma variável `GIT_DIR` ou `GIT_WORK_TREE`, ou um `cd` para o checkout principal antes de executar git.104* **Redirecionamentos git**: Claude Code bloqueia um comando Bash ou Monitor que redireciona git para o checkout principal. O redirecionamento pode vir através de `git -C`, `--git-dir`, uma variável `GIT_DIR` ou `GIT_WORK_TREE`, ou um `cd` para o checkout principal antes de executar git.

104* **Forma do comando**: Claude Code bloqueia um comando Bash ou Monitor quando não pode verificar do texto do comando que qualquer git que o comando executa fica dentro da worktree, por exemplo quando o nome do comando é computado em tempo de execução ou a sintaxe não pode ser analisada. Claude Code diz a Claude como reescrever o comando recusado, como dividi-lo em comandos simples e separados. Você não pode desativar essa verificação.105* **Forma do comando**: Claude Code bloqueia um comando Bash ou Monitor quando não pode verificar do texto do comando que qualquer git que o comando executa fica dentro da worktree. Isso acontece, por exemplo, quando o nome do comando é computado em tempo de execução, quando a sintaxe não pode ser analisada, ou quando uma expansão como `${!name}` ou `${ command; }` poderia executar um comando que o texto não especifica. Claude Code diz a Claude como reescrever o comando recusado, como dividi-lo em comandos simples e separados. Você não pode desativar essa verificação.

105 106

106As verificações se aplicam ao repositório de onde você iniciou Claude Code. Elas também cobrem o checkout principal que uma worktree vinculada está vinculada de. Para comandos PowerShell, Claude Code aplica apenas a verificação de diretório de trabalho.107As verificações se aplicam ao repositório de onde você iniciou Claude Code. Elas também cobrem o checkout principal que uma worktree vinculada está vinculada de. Para comandos PowerShell, Claude Code aplica apenas a verificação de diretório de trabalho.

107 108

108Claude vê cada recusa como um erro de ferramenta que nomeia a worktree e diz como proceder.109Claude vê cada recusa como um erro de ferramenta que nomeia a worktree e diz como proceder. Para um comando recusado, veja [o que a mensagem de recusa significa e como limpá-la](/docs/pt/errors#command-blocked-by-the-worktree-isolation-checks).

109 110

110<h2 id="isolate-subagents-with-worktrees">111<h2 id="isolate-subagents-with-worktrees">

111 Isole subagentes com worktrees112 Isole subagentes com worktrees

139Quando você [coloca em segundo plano](/docs/pt/agent-view#send-the-session-to-the-background) uma sessão `--worktree`, sua worktree se torna uma worktree de sessão em segundo plano que a varredura pode remover. A varredura deixa uma worktree no lugar nestes casos:140Quando você [coloca em segundo plano](/docs/pt/agent-view#send-the-session-to-the-background) uma sessão `--worktree`, sua worktree se torna uma worktree de sessão em segundo plano que a varredura pode remover. A varredura deixa uma worktree no lugar nestes casos:

140 141

141* A worktree ainda contém trabalho: arquivos alterados ou não rastreados, ou commits não enviados.142* A worktree ainda contém trabalho: arquivos alterados ou não rastreados, ou commits não enviados.

143* Um submódulo verificado na worktree contém arquivos alterados ou não rastreados, ou Claude Code não consegue inspecionar os submódulos da worktree. Esta verificação requer Claude Code v2.1.274 ou posterior.

142* Um dos [quatro casos que também bloqueiam a criação de worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) se aplica: Claude Code não pode determinar quais drivers de filtro a configuração do repositório define, ou encontra uma configuração lá que não pode desativar.144* Um dos [quatro casos que também bloqueiam a criação de worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) se aplica: Claude Code não pode determinar quais drivers de filtro a configuração do repositório define, ou encontra uma configuração lá que não pode desativar.

143* A worktree pertence a uma sessão `--worktree` que você não colocou em segundo plano, qualquer que seja sua idade.145* A worktree pertence a uma sessão `--worktree` que você não colocou em segundo plano, qualquer que seja sua idade.

144* Você criou a worktree você mesmo com `git worktree add`, mesmo que depois tenha executado uma sessão `--worktree <name>` nela e colocado essa sessão em segundo plano.146* Você criou a worktree você mesmo com `git worktree add`, mesmo que depois tenha executado uma sessão `--worktree <name>` nela e colocado essa sessão em segundo plano.

251 O que worktrees compartilham com o checkout principal253 O que worktrees compartilham com o checkout principal

252</h2>254</h2>

253 255

254Uma worktree obtém seus próprios arquivos e branch, mas compartilha o diretório `.git` do repositório, plugins de escopo de projeto, e aprovações de permissão salvas com o checkout principal:256Uma worktree obtém seus próprios arquivos e branch, mas compartilha o seguinte com o checkout principal:

255 257

256* **O diretório `.git` do repositório**: comandos git em uma worktree escrevem no diretório `.git` compartilhado do repositório principal, e [sandboxing](/docs/pt/sandboxing#filesystem-isolation) permite essas escritas, então comandos como `git commit` funcionam de dentro de uma worktree com a sandbox ativada.258* **O diretório `.git` do repositório**: comandos git em uma worktree escrevem no diretório `.git` compartilhado do repositório principal, e [sandboxing](/docs/pt/sandboxing#filesystem-isolation) permite essas escritas, então comandos como `git commit` funcionam de dentro de uma worktree com a sandbox ativada.

257* **Plugins**: plugins instalados em [escopo de 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. Requer Claude Code v2.1.200 ou posterior.259* **Plugins**: plugins instalados em [escopo de 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. Requer Claude Code v2.1.200 ou posterior.

258* **Aprovações de permissão**: escolher "Sim, e não pergunte novamente" para um comando Bash em uma sessão de worktree salva a regra no `.claude/settings.local.json` do checkout principal, para que se aplique no checkout principal e em cada outra worktree do repositório, e sobreviva à remoção da worktree. No Windows e nos outros casos onde Claude Code [não usa a raiz do repositório](/docs/pt/settings#where-claude-code-looks-for-each-file), a regra fica com essa worktree. Antes da v2.1.211, uma aprovação concedida em uma worktree era salva dentro dessa worktree, não se aplicava em outro lugar, e era perdida quando a worktree era removida. Consulte [onde as aprovações são salvas](/docs/pt/permissions#permission-system).260* **Aprovações de permissão**: escolher "Sim, e não pergunte novamente" para um comando Bash em uma sessão de worktree salva a regra no `.claude/settings.local.json` do checkout principal, para que se aplique no checkout principal e em cada outra worktree do repositório, e sobreviva à remoção da worktree. No Windows e nos outros casos onde Claude Code [não usa a raiz do repositório](/docs/pt/settings#where-claude-code-looks-for-each-file), a regra fica com essa worktree. Antes da v2.1.211, uma aprovação concedida em uma worktree era salva dentro dessa worktree, não se aplicava em outro lugar, e era perdida quando a worktree era removida. Consulte [onde as aprovações são salvas](/docs/pt/permissions#permission-system).

261* **Skills, agentes e comandos não rastreados**: quando o checkout da worktree não tem um diretório `.claude/skills` em sua raiz, por exemplo porque seu `.claude/skills` é gitignored, Claude Code carrega as [skills de projeto](/docs/pt/skills#where-skills-live) do checkout principal na sessão da worktree. Em uma worktree com seu próprio diretório `.claude/skills`, apenas essa cópia carrega.

259 262

260Todos os três se aplicam se você criar a worktree com `--worktree`, com `git worktree add`, ou através do [aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions).263 A mesma leitura abrange `.claude/agents` e `.claude/commands`. Para skills, a leitura requer Claude Code v2.1.277 ou posterior.

264

265Todos esses se aplicam se você criar a worktree com `--worktree`, com `git worktree add`, ou através do [aplicativo desktop](/docs/pt/desktop#work-in-parallel-with-sessions).

261 266

262<h2 id="manage-worktrees-manually">267<h2 id="manage-worktrees-manually">

263 Gerencie worktrees manualmente268 Gerencie worktrees manualmente

Documentation 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC