Documentation 2026-11-11 22:59 UTC to 2026-11-12 23:02 UTC

245 245 

246## A janela de contexto246## A janela de contexto

247 247 

248A janela de contexto é a quantidade total de informações disponíveis para Claude durante uma sessão. Ela não é redefinida entre voltas dentro de uma sessão. Tudo se acumula: o prompt do sistema, definições de ferramentas, histórico de conversa, entradas de ferramentas e saídas de ferramentas. Conteúdo que permanece igual entre voltas (prompt do sistema, definições de ferramentas, CLAUDE.md) é automaticamente [prompt cached](https://platform.claude.com/docs/pt/build-with-claude/prompt-caching), o que reduz custo e latência para prefixos repetidos. Para saber como um prompt do sistema personalizado ou texto `append` afeta a reutilização de cache entre sessões, veja [Modificando prompts do sistema](https://code.claude.com/docs/pt/agent-sdk/modifying-system-prompts.md#improve-prompt-caching-across-users-and-machines).248A janela de contexto é a quantidade total de informações disponíveis para o Claude durante uma sessão. Ela não é redefinida entre turnos dentro de uma sessão. Tudo se acumula: o system prompt, as definições de ferramentas, o histórico da conversa, as entradas de ferramentas e as saídas de ferramentas. O conteúdo que permanece o mesmo entre turnos (system prompt, definições de ferramentas, CLAUDE.md) é automaticamente [armazenado no cache de prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), o que reduz o custo e a latência para prefixos repetidos. Para saber como um system prompt personalizado ou um texto `append` afeta a reutilização do cache entre sessões, consulte [Modificar system prompts](https://code.claude.com/docs/pt/agent-sdk/modifying-system-prompts.md#improve-prompt-caching-across-users-and-machines).

249 249 

250### O que consome contexto250### O que consome contexto

251 251 

252Aqui está como cada componente afeta o contexto no SDK:252Veja como cada componente afeta o contexto no SDK:

253 253 

254| Fonte | Quando carrega | Impacto |254| Origem | Quando é carregado | Impacto |

255| :- | :- | :- |255| :- | :- | :- |

256| **Prompt do sistema** | Cada requisição | Custo fixo pequeno, sempre presente |256| **System prompt** | Toda requisição | Pequeno custo fixo, sempre presente |

257| **Arquivos CLAUDE.md** | Início da sessão, via [`settingSources`](https://code.claude.com/docs/pt/agent-sdk/claude-code-features) | Conteúdo completo em cada requisição (mas prompt-cached, então apenas a primeira requisição paga o custo completo) |257| **Arquivos CLAUDE.md** | Início da sessão, via [`settingSources`](https://code.claude.com/docs/pt/agent-sdk/claude-code-features) | Conteúdo completo em toda requisição (mas armazenado no cache de prompt) |

258| **Definições de ferramentas** | Cada requisição para ferramentas integradas principais, como Bash, Read e Edit; sob demanda para ferramentas MCP e outras ferramentas integradas, que a [busca de ferramentas](https://code.claude.com/docs/pt/agent-sdk/mcp.md#mcp-tool-search) adia por padrão | Todos os esquemas carregam antecipadamente nos casos descritos em [Configurar busca de ferramentas](https://code.claude.com/docs/pt/agent-sdk/tool-search.md#configure-tool-search) |258| **Definições de ferramentas** | Toda requisição para ferramentas integradas principais, como Bash, Read e Edit; sob demanda para ferramentas MCP e outras ferramentas integradas, que a [busca de ferramentas](https://code.claude.com/docs/pt/agent-sdk/mcp.md#mcp-tool-search) adia por padrão | Todos os esquemas são carregados antecipadamente nos casos descritos em [Configurar a busca de ferramentas](https://code.claude.com/docs/pt/agent-sdk/tool-search.md#configure-tool-search) |

259| **Histórico de conversa** | Acumula entre voltas | Cresce a cada volta: prompts, respostas, entradas de ferramentas, saídas de ferramentas |259| **Histórico da conversa** | Acumula-se ao longo dos turnos | Cresce a cada turno: prompts, respostas, entradas de ferramentas, saídas de ferramentas |

260| **Descrições de skills** | Início da sessão, via fontes de configuração | Resumos curtos; conteúdo completo carrega apenas quando invocado |260| **Descrições de skills** | Início da sessão, via fontes de configuração | Resumos curtos; o conteúdo completo é carregado apenas quando invocado |

261 261 

262Grandes saídas de ferramentas consomem contexto significativo. Ler um arquivo grande ou executar um comando com saída detalhada pode usar milhares de tokens em uma única volta. O contexto se acumula entre voltas, então sessões mais longas com muitas chamadas de ferramentas acumulam significativamente mais contexto do que as curtas.262Saídas grandes de ferramentas consomem uma quantidade significativa de contexto. Ler um arquivo grande ou executar um comando com saída detalhada pode usar milhares de tokens em um único turno. O contexto se acumula ao longo dos turnos, então sessões mais longas com muitas chamadas de ferramenta acumulam significativamente mais contexto do que as curtas.

263 263 

264### Compactação automática264### Compactação automática

265 265 

266Quando a janela de contexto se aproxima de seu limite, o SDK compacta automaticamente a conversa: resume o histórico mais antigo para liberar espaço, mantendo suas trocas mais recentes e decisões-chave intactas. O SDK emite uma mensagem com `type: "system"` e `subtype: "compact_boundary"` no fluxo quando isso acontece (em Python isso é uma `SystemMessage`; em TypeScript é um tipo separado `SDKCompactBoundaryMessage`).266Quando a janela de contexto se aproxima do seu limite, o SDK compacta automaticamente a conversa: ele resume o histórico mais antigo para liberar espaço, mantendo intactas suas trocas mais recentes e as decisões principais. O SDK emite uma mensagem com `type: "system"` e `subtype: "compact_boundary"` no stream quando isso acontece (em Python, é uma `SystemMessage`; em TypeScript, é um tipo separado `SDKCompactBoundaryMessage`).

267 267 

268A compactação substitui mensagens mais antigas por um resumo, então instruções específicas do início da conversa podem não ser preservadas. Regras persistentes pertencem a CLAUDE.md (carregado via [`settingSources`](https://code.claude.com/docs/pt/agent-sdk/claude-code-features)) em vez do prompt inicial, porque o conteúdo CLAUDE.md é reinjetado em cada requisição.268A compactação substitui as mensagens mais antigas por um resumo, então instruções específicas do início da conversa podem não ser preservadas. Regras persistentes devem ficar no CLAUDE.md (carregado via [`settingSources`](https://code.claude.com/docs/pt/agent-sdk/claude-code-features)) em vez de no prompt inicial, porque o conteúdo do CLAUDE.md é reinjetado em toda requisição.

269 269 

270Você pode personalizar o comportamento de compactação de várias maneiras:270Você pode personalizar o comportamento da compactação de várias maneiras:

271 271 

272* **Instruções de sumarização em CLAUDE.md:** O compactador lê seu CLAUDE.md como qualquer outro contexto, então você pode incluir uma seção dizendo a ele o que preservar ao resumir. O compactador corresponde à intenção, então o cabeçalho da seção é livre.272* **Instruções de resumo no CLAUDE.md:** O compactador lê seu CLAUDE.md como qualquer outro contexto, então você pode incluir uma seção dizendo a ele o que preservar ao resumir. O compactador identifica a intenção, então o cabeçalho da seção é de formato livre.

273* **Hook `PreCompact`:** Execute lógica personalizada antes da compactação ocorrer, por exemplo para arquivar a transcrição completa. O hook recebe um campo `trigger` (`manual` ou `auto`). Veja [hooks](https://code.claude.com/docs/pt/agent-sdk/hooks.md).273* **Hook `PreCompact`:** Execute lógica personalizada antes que a compactação ocorra, por exemplo, para arquivar a transcrição completa. O hook recebe um campo `trigger` (`manual` ou `auto`). Consulte [hooks](https://code.claude.com/docs/pt/agent-sdk/hooks.md).

274* **Compactação manual:** Envie `/compact` como uma string de prompt para acionar compactação sob demanda. Comandos enviados desta forma são entradas SDK ordinárias. Veja [dispatch commands by name](https://code.claude.com/docs/pt/agent-sdk/skills.md#dispatch-commands-by-name).274* **Compactação manual:** Envie `/compact` como uma string de prompt para acionar a compactação sob demanda. Os comandos enviados dessa forma são entradas comuns do SDK. Consulte [despachar comandos por nome](https://code.claude.com/docs/pt/agent-sdk/skills.md#dispatch-commands-by-name).

275 275 

276> [accordion] Exemplo: Instruções de sumarização em CLAUDE.md276> [accordion] Exemplo: Instruções de resumo no CLAUDE.md

277>277>

278> Adicione uma seção ao CLAUDE.md do seu projeto dizendo ao compactador o que preservar. O nome do cabeçalho não é especial; use qualquer rótulo claro.278> Adicione uma seção ao CLAUDE.md do seu projeto dizendo ao compactador o que preservar. O nome do cabeçalho não é especial; use qualquer rótulo claro.

279>279>

287> - Decisions made and the reasoning behind them287> - Decisions made and the reasoning behind them

288> ```288> ```

289 289 

290### Manter contexto eficiente290### Mantenha o contexto eficiente

291 291 

292Algumas estratégias para agentes de longa duração:292Algumas estratégias para agentes de longa duração:

293 293 

294* **Use subagentes para subtarefas.** Um subagente retorna apenas sua resposta final, então o contexto do seu agente principal cresce com um resumo, não com a transcrição da subtarefa.294* **Use subagentes para subtarefas.** Um subagente retorna apenas sua resposta final, então o contexto do seu agente principal cresce com um resumo, não com a transcrição da subtarefa.

295* **Seja seletivo com ferramentas.** Cada definição de ferramenta ocupa espaço de contexto. Use o campo `tools` em [`AgentDefinition`](https://code.claude.com/docs/pt/agent-sdk/subagents#agentdefinition-configuration) para escopo subagentes ao conjunto mínimo que precisam.295* **Seja seletivo com as ferramentas.** Cada definição de ferramenta ocupa espaço de contexto. Use o campo `tools` em [`AgentDefinition`](https://code.claude.com/docs/pt/agent-sdk/subagents#agentdefinition-configuration) para restringir os subagentes ao conjunto mínimo de que precisam.

296* **Observe custos de servidor MCP.** [MCP tool search](https://code.claude.com/docs/pt/agent-sdk/mcp.md#mcp-tool-search) adia esquemas de ferramentas MCP por padrão e carrega-os sob demanda. Quando a busca de ferramentas está desativada ou voltou ao carregamento antecipado em modelos não suportados e certas plataformas, cada servidor MCP adiciona todos os seus esquemas de ferramentas a cada requisição, então alguns servidores com muitas ferramentas podem consumir contexto significativo antes do agente fazer qualquer trabalho. Veja [Configurar busca de ferramentas](https://code.claude.com/docs/pt/agent-sdk/tool-search.md#configure-tool-search) para as configurações onde o fallback se aplica.296* **Observe os custos de servidores MCP.** A [busca de ferramentas MCP](https://code.claude.com/docs/pt/agent-sdk/mcp.md#mcp-tool-search) adia os esquemas de ferramentas MCP por padrão e os carrega sob demanda. Quando a busca de ferramentas está desativada ou recorreu ao carregamento antecipado, cada servidor MCP adiciona todos os seus esquemas de ferramentas a toda requisição, então alguns servidores com muitas ferramentas podem consumir uma quantidade significativa de contexto antes que o agente faça qualquer trabalho. Consulte [Configurar a busca de ferramentas](https://code.claude.com/docs/pt/agent-sdk/tool-search.md#configure-tool-search) para ver as configurações em que o fallback se aplica.

297* **Use esforço mais baixo para tarefas rotineiras.** Defina [esforço](#effort-level) para `"low"` para agentes que apenas precisam ler arquivos ou listar diretórios. Isso reduz uso de tokens e custo.297* **Use um esforço menor para tarefas rotineiras.** Defina o [esforço](#effort-level) como `"low"` para agentes que só precisam ler arquivos ou listar diretórios. Isso reduz o uso de tokens e o custo.

298 298 

299Para um detalhamento detalhado dos custos de contexto por recurso, veja [Entender custos de contexto](https://code.claude.com/docs/pt/features-overview.md#understand-context-costs).299Para uma análise detalhada dos custos de contexto por recurso, consulte [Entender os custos de contexto](https://code.claude.com/docs/pt/features-overview.md#understand-context-costs).

300 300 

301## Sessões e continuidade301## Sessões e continuidade

302 302 

298 298 

299### Escritas de espelho são best-effort299### Escritas de espelho são best-effort

300 300 

301Se `append()` rejeita, o SDK tenta novamente o lote até mais duas vezes com um backoff curto, para no máximo três tentativas no total. Uma chamada que expira não é retentada, já que a chamada original ainda pode chegar. Se o lote ainda falhar, o SDK registra o erro, emite uma mensagem `{ type: "system", subtype: "mirror_error" }` para o iterador, descarta o lote, e continua a consulta. Como um lote retentado pode reentrega entradas que já chegaram, deduplicar por `entry.uuid` em sua implementação de `append()`.301Se `append()` rejeita, o SDK tenta novamente o lote até mais duas vezes com um backoff curto, para no máximo três tentativas no total. Uma chamada que expira não é retentada, já que a chamada original ainda pode chegar. Como um lote retentado pode reentregar entradas que já chegaram, deduplique por `entry.uuid` em sua implementação de `append()` e mantenha todas as entradas que não têm `uuid`.

302 302 

303Uma interrupção de store não interrompe o agente, já que o subprocess escreve localmente primeiro. Monitore `mirror_error` se você precisar detectar perda de dados de store. Em uma execução [retomada do store](#resume-from-the-store), um lote descartado não tem cópia sobrevivente uma vez que a execução termina.303Se o lote ainda falhar, o SDK registra o erro, emite uma mensagem `{ type: "system", subtype: "mirror_error" }` para o iterador, descarta o lote, e continua a consulta. Uma interrupção de store não interrompe o agente, já que o subprocess escreve localmente primeiro. Monitore `mirror_error` para detectar perda de dados de store. Em uma execução [retomada do store](#resume-from-the-store), um lote descartado não tem cópia sobrevivente uma vez que a execução termina.

304 304 

305### `getSessionMessages` retorna a cadeia pós-compactação305### `getSessionMessages` retorna a cadeia pós-compactação

306 306 

512 512 

513### Executar Mantle junto com a API Invoke513### Executar Mantle junto com a API Invoke

514 514 

515Os modelos disponíveis para você no Mantle podem não incluir todos os modelos que você usa hoje. Definir tanto `CLAUDE_CODE_USE_BEDROCK` quanto `CLAUDE_CODE_USE_MANTLE` permite que Claude Code chame ambos os endpoints da mesma sessão. IDs de modelo que correspondem ao formato Mantle são roteados para Mantle, e todos os outros IDs de modelo vão para a API Invoke do Amazon Bedrock.515Os modelos disponíveis para você no Mantle podem não incluir todos os modelos que você usa hoje. Se você se conectar sem um gateway, defina tanto `CLAUDE_CODE_USE_BEDROCK` quanto `CLAUDE_CODE_USE_MANTLE` para chamar o Mantle e a API Invoke da mesma sessão. IDs de modelo que correspondem ao formato Mantle são roteados para Mantle, e todos os outros IDs de modelo vão para a API Invoke do Amazon Bedrock.

516 516 

517```bash theme={null}517```bash theme={null}

518export CLAUDE_CODE_USE_BEDROCK=1518export CLAUDE_CODE_USE_BEDROCK=1

618* Se o erro nomeia uma ação `bedrock-mantle:`, conceda à sua identidade IAM essa ação.618* Se o erro nomeia uma ação `bedrock-mantle:`, conceda à sua identidade IAM essa ação.

619* Se o erro não nomeia nenhuma ação e suas credenciais são válidas, sua conta AWS não foi concedida acesso ao modelo que você solicitou. Entre em contato com sua equipe de conta AWS para solicitar acesso.619* Se o erro não nomeia nenhuma ação e suas credenciais são válidas, sua conta AWS não foi concedida acesso ao modelo que você solicitou. Entre em contato com sua equipe de conta AWS para solicitar acesso.

620 620 

621Um `400` que nomeia o ID do modelo significa que esse modelo não é servido no Mantle. Mantle tem seu próprio lineup de modelo separado do catálogo Amazon Bedrock padrão, então IDs de perfil de inferência como `us.anthropic.claude-sonnet-4-6` não funcionam. Use um ID de formato Mantle, ou habilite [ambos os endpoints](#run-mantle-alongside-the-invoke-api) para que Claude Code envie IDs de perfil de inferência para a API Invoke.621Um `400` que nomeia o ID do modelo significa que esse modelo não é servido no Mantle. Mantle tem seu próprio lineup de modelos separado do catálogo Amazon Bedrock padrão, então IDs de perfil de inferência como `us.anthropic.claude-sonnet-4-6` não funcionam.

622 

623Para resolver o erro:

624 

625* **Sem um gateway**: use um [ID de formato Mantle](#select-a-mantle-model) que o Mantle serve, ou [execute o Mantle junto com a API Invoke](#run-mantle-alongside-the-invoke-api) para enviar IDs em outros formatos para essa API.

626* **Por meio de um gateway**: pergunte ao operador dele quais IDs de modelo usar.

622 627 

623## Recursos adicionais628## Recursos adicionais

624 629 

148 148 

149#### Desativar scripts nas visualizações SSH e WSL para sua organização149#### Desativar scripts nas visualizações SSH e WSL para sua organização

150 150 

151Para impedir que as [visualizações HTML em sessões SSH e WSL](#preview-html-files-in-ssh-and-wsl-sessions) executem scripts, defina a [configuração gerenciada `disableBrowserExternalNavigation`](#managed-settings) como `true`. Com essa configuração, os usuários também não podem [navegar em sites externos](#restrict-external-browsing-for-your-organization) no painel de navegador.151Para impedir que as [visualizações HTML em sessões SSH e WSL](#preview-html-files-in-ssh-and-wsl-sessions) executem scripts, defina a [configuração gerenciada `disableRemotePreviewScripts`](#managed-settings) como `true`. Os usuários ainda podem navegar em sites externos. Requer Claude Desktop v5.1231.0 ou posterior.

152 152 

153Defina-a nas suas [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md), ou em uma [política MDM do Claude Code ou arquivo de configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md#where-each-mechanism-stores-the-policy) no computador que executa o Desktop. O Desktop não a lê da máquina remota nem da distribuição WSL. Com um [provedor terceirizado](https://code.claude.com/docs/pt/third-party-integrations.md), use a política MDM ou o arquivo.153> [!NOTE]

154>

155> Versões anteriores ignoram `disableRemotePreviewScripts`. Para interromper os scripts nelas, atualize o Desktop ou defina também `disableBrowserExternalNavigation` como `true`. Nesse caso, os usuários [não podem navegar em sites externos](#restrict-external-browsing-for-your-organization) em nenhum computador que receba `disableBrowserExternalNavigation`.

156 

157Defina cada chave nas suas [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md), ou em uma [política MDM do Claude Code ou arquivo de configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md#where-each-mechanism-stores-the-policy) no computador que executa o Desktop. O Desktop não lê essas chaves da máquina remota, da distribuição WSL, de um [`policyHelper`](https://code.claude.com/docs/pt/settings-reference#policyhelper) nem das [políticas do próprio Desktop](#device-management-policies). Com um [provedor terceirizado](https://code.claude.com/docs/pt/third-party-integrations.md), use a política MDM ou o arquivo.

154 158 

155> [!WARNING]159> [!WARNING]

156>160>

160 164 

161Em seguida, peça aos usuários que reiniciem o Desktop para garantir que a configuração seja aplicada e informe-os sobre o que esperar:165Em seguida, peça aos usuários que reiniciem o Desktop para garantir que a configuração seja aplicada e informe-os sobre o que esperar:

162 166 

163* **Arquivos que eles abrem**: a visualização não executa scripts, então gráficos e tabelas desenhados por scripts permanecem vazios167* **Arquivos que eles abrem**: a visualização não executa scripts, então gráficos e tabelas desenhados por scripts permanecem vazios. O aviso dela começa com `This preview doesn't run scripts`.

164* **Visualizações que estão executando scripts**: se o Desktop aplicar a configuração antes da reinicialização, elas são fechadas. Os usuários veem `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`168* **Visualizações que estão executando scripts**: se o Desktop aplicar a configuração antes da reinicialização, elas são fechadas. Os usuários veem `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`

165* **Arquivos que eles exportam**: se um usuário [exportar um arquivo](#preview-html-files-in-ssh-and-wsl-sessions) e abri-lo em um navegador, os scripts dele são executados lá, com ou sem essa configuração169* **Arquivos que eles exportam**: se um usuário [exportar um arquivo](#preview-html-files-in-ssh-and-wsl-sessions) e abri-lo em um navegador, os scripts dele são executados lá, com ou sem essa configuração

166 170 

171##### Verificar se um computador ainda executa scripts

172 

173Após a reinicialização, abra um arquivo HTML de uma sessão SSH ou WSL nesse computador. Se o aviso acima da visualização começar com `This preview doesn't load anything from the web`, os scripts ainda são executados lá. Verifique a [versão do Desktop](#check-your-version), onde você colocou a chave e se o valor dela é o booleano JSON `true`.

174 

167### Navegar em sites externos175### Navegar em sites externos

168 176 

169O painel de navegador é um navegador com abas, então você pode abrir documentação, rastreadores de problemas ou qualquer outro site ao lado do seu aplicativo em execução. Para abrir o navegador, pressione **Cmd+Shift+B** no macOS ou **Ctrl+Shift+B** no Windows, ou clique em **Browser** na barra de título da sessão. Você pode fazer login em sites no painel, incluindo fluxos de login em popup como Google OAuth.177O painel de navegador é um navegador com abas, então você pode abrir documentação, rastreadores de problemas ou qualquer outro site ao lado do seu aplicativo em execução. Para abrir o navegador, pressione **Cmd+Shift+B** no macOS ou **Ctrl+Shift+B** no Windows, ou clique em **Browser** na barra de título da sessão. Você pode fazer login em sites no painel, incluindo fluxos de login em popup como Google OAuth.

2037| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |2045| `browserExternalPageTools` | defina como `"disabled"` para impedir Claude de usar ferramentas para ler ou agir em páginas externas no [painel Browser](#browse-external-sites). Os usuários ainda podem navegar para sites externos por conta própria, e as visualizações do servidor de desenvolvimento local não são afetadas. |

2038| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](https://code.claude.com/docs/pt/desktop-ios-simulator.md#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |2046| `disableMobileSimulatorTools` | defina como `true` para bloquear as ferramentas de Claude para controlar e capturar dispositivos no [painel iOS Simulator](https://code.claude.com/docs/pt/desktop-ios-simulator.md#turn-off-simulator-access). O painel permanece utilizável para os toques do próprio usuário; apenas o acesso de Claude é removido. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |

2039| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. As visualizações HTML em sessões SSH e WSL [não executam scripts](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |2047| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. As visualizações HTML em sessões SSH e WSL [não executam scripts](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |

2048| `disableRemotePreviewScripts` | defina como `true` para [desativar apenas os scripts nas visualizações HTML](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) em sessões SSH e WSL. O Desktop não a lê da máquina remota nem da distribuição WSL. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. Requer Claude Desktop v5.1231.0 ou posterior. |

2040| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no seletor de ambiente. Usuários não podem excluir conexões gerenciadas nem editar nada além de sua própria **Worktree folder**. |2049| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no seletor de ambiente. Usuários não podem excluir conexões gerenciadas nem editar nada além de sua própria **Worktree folder**. |

2041| `sshHostCommands` | ofereça aos usuários [conexões SSH cujo host vem de um comando](#distribute-commands-to-your-team), junto com as suas próprias. O Desktop a lê do arquivo de configurações gerenciadas ou da política MDM no computador, e a ignora em [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Requer Claude Desktop v3.6556.0 ou posterior no macOS ou Linux, ou v4.16336.0 ou posterior no Windows, conectado com uma conta Claude. No Windows, o Desktop também precisa [conectar-se através do cliente OpenSSH](#use-your-ssh-configuration). |2050| `sshHostCommands` | ofereça aos usuários [conexões SSH cujo host vem de um comando](#distribute-commands-to-your-team), junto com as suas próprias. O Desktop a lê do arquivo de configurações gerenciadas ou da política MDM no computador, e a ignora em [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Requer Claude Desktop v3.6556.0 ou posterior no macOS ou Linux, ou v4.16336.0 ou posterior no Windows, conectado com uma conta Claude. No Windows, o Desktop também precisa [conectar-se através do cliente OpenSSH](#use-your-ssh-configuration). |

2042| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Lido apenas de configurações gerenciadas. |2051| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Lido apenas de configurações gerenciadas. |

2044| `disableSshSavedPasswords` | defina como `true` para impedir que o Desktop ofereça lembrar senhas SSH e que use ou mostre as que salvou anteriormente. Ativá-la não as exclui. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.49585.0 ou posterior. |2053| `disableSshSavedPasswords` | defina como `true` para impedir que o Desktop ofereça lembrar senhas SSH e que use ou mostre as que salvou anteriormente. Ativá-la não as exclui. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.49585.0 ou posterior. |

2045| `managedMcpServers` | envie configurações de servidor MCP para todos os usuários. Disponível apenas em implantações Desktop de terceiros (3P). Em cada entrada, defina um transporte de `"http"`, `"sse"` ou `"stdio"`, detalhes de conexão e opcionalmente um mapa `toolPolicy` para restringir quais ferramentas desse servidor os usuários podem invocar. Entregue através do arquivo de configurações gerenciadas, MDM ou do [bloco `desktop`](https://code.claude.com/docs/pt/claude-apps-gateway-config#claude-desktop-overlay) da política de um gateway de aplicativos Claude, já que implantações de terceiros não recebem configurações do console de administração. Para entregá-lo através do gateway, você precisa de Claude Code v2.1.232 ou posterior no servidor do gateway. Esta é a chave do próprio aplicativo desktop; Claude Code lê uma [configuração gerenciada de mesmo nome](https://code.claude.com/docs/pt/managed-mcp.md#provide-servers-through-managed-settings) própria, com uma forma de entrada diferente. |2054| `managedMcpServers` | envie configurações de servidor MCP para todos os usuários. Disponível apenas em implantações Desktop de terceiros (3P). Em cada entrada, defina um transporte de `"http"`, `"sse"` ou `"stdio"`, detalhes de conexão e opcionalmente um mapa `toolPolicy` para restringir quais ferramentas desse servidor os usuários podem invocar. Entregue através do arquivo de configurações gerenciadas, MDM ou do [bloco `desktop`](https://code.claude.com/docs/pt/claude-apps-gateway-config#claude-desktop-overlay) da política de um gateway de aplicativos Claude, já que implantações de terceiros não recebem configurações do console de administração. Para entregá-lo através do gateway, você precisa de Claude Code v2.1.232 ou posterior no servidor do gateway. Esta é a chave do próprio aplicativo desktop; Claude Code lê uma [configuração gerenciada de mesmo nome](https://code.claude.com/docs/pt/managed-mcp.md#provide-servers-through-managed-settings) própria, com uma forma de entrada diferente. |

2046 2055 

2047Se você desativar um recurso com `browserExternalPageTools`, `disableMobileSimulatorTools` ou `disableBrowserExternalNavigation` na [política MDM ou arquivo de configurações gerenciadas de maior prioridade](https://code.claude.com/docs/pt/managed-settings.md#how-claude-code-combines-managed-sources) de um computador, o recurso permanece desativado nesse computador. Ele permanece desativado mesmo quando suas [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md) deixam essa chave sem definição ou permitem o recurso. Não use um valor de registro `HKCU` no nível do usuário para isso. Para reativar o recurso, remova o valor onde quer que você o tenha definido. Requer Claude Desktop v4.4212.0 ou posterior.2056Se você desativar um recurso com uma destas quatro chaves na [política MDM ou arquivo de configurações gerenciadas de maior prioridade](https://code.claude.com/docs/pt/managed-settings.md#how-claude-code-combines-managed-sources) de um computador, o recurso permanece desativado nesse computador:

2057 

2058* **`browserExternalPageTools`, `disableMobileSimulatorTools`, `disableBrowserExternalNavigation`**: requer Claude Desktop v4.4212.0 ou posterior

2059* **`disableRemotePreviewScripts`**: requer Claude Desktop v5.1231.0 ou posterior

2060 

2061Ele permanece desativado mesmo quando suas [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md) deixam essa chave sem definição ou permitem o recurso. Não use um valor de registro `HKCU` no nível do usuário para isso. Para reativar o recurso, remova o valor onde quer que você o tenha definido.

2048 2062 

2049Quais configurações gerenciadas alcançam uma sessão Desktop depende de onde essa sessão é executada. Restrições de modelo como [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) são aplicadas em sessões Claude Code do Desktop da mesma forma que na CLI do terminal; veja [cobertura de superfície](https://code.claude.com/docs/pt/model-config.md#surface-coverage).2063Quais configurações gerenciadas alcançam uma sessão Desktop depende de onde essa sessão é executada. Restrições de modelo como [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) são aplicadas em sessões Claude Code do Desktop da mesma forma que na CLI do terminal; veja [cobertura de superfície](https://code.claude.com/docs/pt/model-config.md#surface-coverage).

2050 2064 

2109>2123>

2110> Verifique o valor de `forceLoginOrgUUID` antes de implantá-lo. Se o ID não for o da sua organização, as pessoas da sua organização não poderão usar o Claude Desktop, a menos que também pertençam a uma organização com esse ID. Para recuperar o acesso, implante o ID correto e peça que reiniciem o Claude Desktop.2124> Verifique o valor de `forceLoginOrgUUID` antes de implantá-lo. Se o ID não for o da sua organização, as pessoas da sua organização não poderão usar o Claude Desktop, a menos que também pertençam a uma organização com esse ID. Para recuperar o acesso, implante o ID correto e peça que reiniciem o Claude Desktop.

2111 2125 

2112Se você definir `forceLoginMethod` e `forceLoginOrgUUID` nas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) de Claude Code, a tela de login do Claude Desktop não muda.2126Se você definir `forceLoginMethod` e `forceLoginOrgUUID` nas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) de Claude Code, a tela de login do Claude Desktop não muda. Uma pessoa ainda pode usar o Claude Desktop com sua própria chave de API do Claude ou [conta do Claude Console](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in), e executar sessões da aba Code dessa forma.

2127 

2128Para impedir isso, implante também `forceLoginOrgUUID` na política do Claude Desktop (em `HKLM` no Windows), com o ID da sua organização claude.ai. A menos que a própria política [selecione a Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach), o Claude Desktop deixa de usar a chave de API ou a conta do Console da própria pessoa na próxima inicialização do aplicativo.

2129 

2130Verifique dois casos antes de implantá-la:

2131 

2132* **Organizações do Claude Console**: não implante `forceLoginOrgUUID` sozinho com o ID de uma organização do Claude Console, ou você bloqueará o acesso das pessoas da sua organização ao Claude Desktop. Em vez disso, veja [Which devices offer the Claude API account sign-in](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in).

2133* **Enterprise Admin Console**: se ele entrega a configuração do Claude Desktop dos seus computadores, atualize-os primeiro para o Claude Desktop v2.37337.0 ou posterior, porque versões anteriores o ignoram depois que essa chave é definida. Veja [Keep a device on its managed profile](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile).

2113 2134 

2114### Requisitos de acesso à rede2135### Requisitos de acesso à rede

2115 2136 

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`**: um terminal mantém a conversa, por exemplo um onde você a retomou com `claude --resume` ou `/resume`. A linha também mostra `Open in a terminal`.5469* **`running in another terminal`**: um processo que não é uma sessão em background mantém a conversa, por exemplo uma execução de `claude -p`, ou um terminal onde você a retomou com `claude --resume` ou `/resume`. A linha também mostra `Open in a terminal`.

5470* **`already open in another running Claude session`**: outro processo Claude Code não interativo a mantém, por exemplo um processo de [sessão em background](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) para a mesma conversa que ainda não saiu.5470* **`already open in another running Claude session`**: outra [sessão em background](https://code.claude.com/docs/pt/agent-view.md#the-supervisor-process) a mantém.

5471 5471 

5472**O que fazer:**5472**O que fazer:**

5473 5473 

5474* Continue a conversa no processo que a tem aberta, ou saia desse processo e abra a linha novamente5474* Para `running in another terminal`: continue nesse terminal, ou saia desse processo ou deixe-o terminar, e depois tente novamente

5475* Para `already open in another running Claude session`: use essa sessão, ou pare-a e depois tente novamente

5475 5476 

5476Antes da v2.1.248, apenas a recusa `already open in another running Claude session` existia: uma conversa retomada em um terminal não contava como aberta, e abrir a linha iniciava um segundo processo Claude Code escrevendo na mesma conversa.5477Antes da v2.1.248, apenas a recusa `already open in another running Claude session` existia: uma conversa retomada em um terminal não contava como aberta, e abrir a linha iniciava um segundo processo Claude Code escrevendo na mesma conversa.

5477 5478 

98 98 

99* **Pro, Max e Ultra**: você paga pelo modo rápido com seus créditos de uso. Vá para [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, onde a seção **Usage credits** mostra quanto você gastou em créditos de uso este mês. Essa figura inclui o modo rápido, mas não o separa individualmente.99* **Pro, Max e Ultra**: você paga pelo modo rápido com seus créditos de uso. Vá para [**Settings > Usage**](https://claude.ai/settings/usage) em claude.ai, onde a seção **Usage credits** mostra quanto você gastou em créditos de uso este mês. Essa figura inclui o modo rápido, mas não o separa individualmente.

100* **Team e Enterprise**: sua organização paga pelo seu uso do modo rápido com seus créditos de uso. Para ver seu próprio gasto de créditos de uso, execute [`/usage`](https://code.claude.com/docs/pt/costs#check-your-usage-credits-spend). Para ver onde sua organização vê esse gasto, consulte [Claude for Teams and Enterprise](https://code.claude.com/docs/pt/costs.md#claude-for-teams-and-enterprise).100* **Team e Enterprise**: sua organização paga pelo seu uso do modo rápido com seus créditos de uso. Para ver seu próprio gasto de créditos de uso, execute [`/usage`](https://code.claude.com/docs/pt/costs#check-your-usage-credits-spend). Para ver onde sua organização vê esse gasto, consulte [Claude for Teams and Enterprise](https://code.claude.com/docs/pt/costs.md#claude-for-teams-and-enterprise).

101* **Claude Console**: sua organização paga pelo modo rápido junto com o resto de seu uso de API. Nas páginas [Usage](https://platform.claude.com/usage) e [Cost](https://platform.claude.com/cost) do Console, selecione **Speed (research preview)** no menu **Group by** para separar o modo rápido do uso em velocidade padrão. Você vê essa opção apenas quando o intervalo de datas selecionado inclui uso do modo rápido.101* **Claude Console**: sua organização paga pelo modo rápido junto com o resto de seu uso de API. Nas páginas [Usage](https://platform.claude.com/usage) e [Cost](https://platform.claude.com/cost) do Console, selecione **Speed** no menu **Group by** para separar o modo rápido do uso em velocidade padrão. Você vê essa opção apenas quando o intervalo de datas selecionado inclui uso do modo rápido.

102 102 

103## Decidir quando usar o modo rápido103## Decidir quando usar o modo rápido

104 104 

218 218 

219## Mods integrados ao Claude Code219## Mods integrados ao Claude Code

220 220 

221Alguns dos próprios recursos do Claude Code são mods. Para ver os que sua sessão tem, execute `/plugin` no prompt do Claude Code e vá para a aba **Installed**, que os lista em **Built-in**. Você não pode atualizar ou desinstalar um mod integrado, e a última coluna da tabela diz como desativar cada um. A linha [`mods active`](#see-which-mods-a-session-loaded) deixa mods integrados de fora.221Alguns dos próprios recursos do Claude Code são mods. Para ver os que sua sessão tem, execute `/plugin` no prompt do Claude Code e vá para a aba **Installed**, que os lista em **Built-in**. Você não pode atualizar ou desinstalar um mod integrado. A [linha `mods active`](#see-which-mods-a-session-loaded) deixa mods integrados de fora.

222 222 

223Esta tabela lista cada entrada pelo nome que `/plugin` mostra:223Esta tabela lista algumas das entradas **Built-in** pelo nome que `/plugin` mostra:

224 224 

225| Nome em `/plugin` | O que faz | Onde está ativado | Como desativar |225| Nome em `/plugin` | O que faz | Onde está ativado | Como desativar |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |

231| `cc-plugin-telemetry` | Envia os registros de análise que o Claude Code e seus mods integrados registram | Onde a análise própria do Claude Code está ativada | Desabilite em `/plugin` ou desative a análise, por exemplo com [`DISABLE_TELEMETRY`](https://code.claude.com/docs/pt/env-vars) |231| `cc-plugin-telemetry` | Envia os registros de análise que o Claude Code e seus mods integrados registram | Onde a análise própria do Claude Code está ativada | Desabilite em `/plugin` ou desative a análise, por exemplo com [`DISABLE_TELEMETRY`](https://code.claude.com/docs/pt/env-vars) |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions): um agente lateral mostra uma nota acima do prompt quando encontra algo que você pode ter deixado passar | Desativado até que você [o ative](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions) | Desabilite em `/plugin` |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions): um agente lateral mostra uma nota acima do prompt quando encontra algo que você pode ter deixado passar | Desativado até que você [o ative](https://code.claude.com/docs/pt/interactive-mode.md#you-should-know-suggestions) | Desabilite em `/plugin` |

233 233 

234Para um plugin **Built-in** que não está na tabela, [abra seus detalhes em `/plugin`](https://code.claude.com/docs/pt/plugins/install#manage-installed-plugins) para ler o que ele faz ou para desabilitá-lo.

235 

234As configurações e flags que param mods instalados, como `disableAllHooks`, `--bare` e `--safe-mode`, não param mods integrados.236As configurações e flags que param mods instalados, como `disableAllHooks`, `--bare` e `--safe-mode`, não param mods integrados.

235 237 

236### Ler a fonte de mods integrados238### Ler a fonte de mods integrados

194| `session.receive` | `($, e) => ({ text: e.text })`. Dispare-o com `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |194| `session.receive` | `($, e) => ({ text: e.text })`. Dispare-o com `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect` tem as asserções `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined`, e `toThrow`, e `.not` antes de qualquer uma delas.197### Verificar um resultado com `expect`

198 

199O kit tem estas asserções, e a que você escolher vem depois do valor que está verificando, como em `expect(answer.text).toBe('ok')`:

200 

201* **Igualdade**: `toBe` para o mesmo valor ou objeto, `toEqual` para estrutura, `toStrictEqual` para estrutura mais campos `undefined` e o protótipo, e `toMatchObject` para os campos que você nomear

202* **Texto**: `toMatch`, que aceita uma expressão regular ou uma substring, `toStartWith` e `toEndWith`

203* **Números**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Conteúdo**: `toContain` para uma substring ou um membro, `toContainEqual` para um membro comparado por estrutura, `toHaveLength` e `toHaveProperty`

205* **Presença e tipo**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Lançamento**: `toThrow`, para uma função que `expect` chama, ou para uma promise que você verifica com `.rejects`

207 

208Coloque `.not` antes de uma asserção para verificar o oposto, e `.resolves` ou `.rejects` para verificar com o que uma promise é concluída.

198 209 

199Quando um `expect` falha dentro de um stub ou hook que você passou para `on` como uma função simples em vez de um gerador assíncrono, o teste falha. O mecanismo pula esse hook, e a saída da falha o nomeia, como `in the test's store.set hook`.210Quando um `expect` falha dentro de um stub ou hook que você passou para `on` como uma função simples em vez de um gerador assíncrono, o teste falha. O mecanismo pula esse hook, e a saída da falha o nomeia, como `in the test's store.set hook`.

200 211 

26| Contexto do projeto | CLAUDE.md, memória automática, regras sem escopo | A sessão começa, ou após `/clear` ou `/compact` |26| Contexto do projeto | CLAUDE.md, memória automática, regras sem escopo | A sessão começa, ou após `/clear` ou `/compact` |

27| Conversa | Suas mensagens, respostas do Claude, resultados de ferramentas | A cada turno |27| Conversa | Suas mensagens, respostas do Claude, resultados de ferramentas | A cada turno |

28 28 

29Uma mudança na camada de conversa deixa o system prompt e o contexto do projeto em cache. Uma mudança no system prompt invalida tudo, porque todo o conteúdo posterior agora fica atrás de um prefixo diferente. A terceira coluna fornece gatilhos comuns em vez de uma lista exaustiva, e as seções abaixo cobrem o conjunto completo.29Uma adição à camada de conversa deixa o system prompt e o contexto do projeto em cache. Uma mudança no system prompt invalida tudo, porque todo o conteúdo posterior agora fica atrás de um prefixo diferente. A terceira coluna fornece gatilhos comuns em vez de uma lista exaustiva, e as seções abaixo cobrem o conjunto completo.

30 30 

31A regra de correspondência de prefixo explica a maioria dos comportamentos nesta página. O [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) e o [carregamento de skills](https://code.claude.com/docs/pt/skills.md), por exemplo, anexam suas instruções como mensagens de conversa, então o prefixo em cache permanece intacto.31A regra de correspondência de prefixo explica a maioria dos comportamentos nesta página. O [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) e o [carregamento de skills](https://code.claude.com/docs/pt/skills.md), por exemplo, anexam suas instruções como mensagens de conversa, então o prefixo em cache permanece intacto.

32 32 

174 174 

175### Compacting the conversation175### Compacting the conversation

176 176 

177A [compactação](https://code.claude.com/docs/pt/context-window.md#what-survives-compaction) substitui seu histórico de mensagens por um resumo. Por design, isso invalida a camada de conversa: a próxima solicitação tem um histórico novo e mais curto que não compartilha um prefixo com o antigo. As camadas de system prompt e de contexto do projeto podem permanecer em cache:177A [compactação](https://code.claude.com/docs/pt/context-window.md#what-survives-compaction) substitui seu histórico de mensagens por um resumo. Por design, isso invalida a camada de conversa: a próxima solicitação tem um histórico novo e mais curto que não compartilha um prefixo com o antigo.

178 178 

179* **System prompt**: a próxima solicitação lê essa camada do cache, a menos que uma [conversa retomada](#resuming-a-session) tenha mantido um system prompt que agora está desatualizado. Na primeira vez que essa conversa é compactada, Claude Code a muda para o prompt atual, e a próxima solicitação reconstrói o cache dessa camada uma vez.179* **System prompt**: a próxima solicitação lê essa camada do cache, a menos que uma [conversa retomada](#resuming-a-session) tenha mantido um system prompt que agora está desatualizado. Na primeira vez que essa conversa é compactada, Claude Code a muda para o prompt atual, e a próxima solicitação reconstrói o cache dessa camada uma vez.

180* **Contexto do projeto**: Claude Code recarrega essa camada do disco. A próxima solicitação a lê do cache apenas se o CLAUDE.md e a memória não tiverem mudado desde o início da sessão.180* **Contexto do projeto**: Claude Code recarrega essa camada do disco. Ela é armazenada em cache junto com a conversa, então após `/compact` ou a compactação automática seu cache é reconstruído mesmo que seus arquivos não tenham mudado.

181 181 

182Para produzir o resumo, Claude Code envia uma solicitação separada. A solicitação repete o system prompt, as ferramentas e o histórico sendo resumido da sua conversa. Ela termina com uma instrução de sumarização. Enquanto o cache está quente, essa solicitação lê seu prefixo do cache. Um `/compact` no meio da sessão então custa uma fração do que o tamanho do contexto sugere e gasta a maior parte do tempo gerando o resumo.182Para produzir o resumo, Claude Code envia uma solicitação separada. A solicitação repete o system prompt, as ferramentas e o histórico sendo resumido da sua conversa. Ela termina com uma instrução de sumarização. Enquanto o cache está quente, essa solicitação lê seu prefixo do cache. Um `/compact` no meio da sessão então custa uma fração do que o tamanho do contexto sugere e gasta a maior parte do tempo gerando o resumo.

183 183 

184Após uma pausa mais longa que o [cache lifetime](#cache-lifetime), não há cache deixado para ler, então a solicitação de sumarização reprocessa esse histórico como entrada não armazenada em cache. É por isso que `/compact` custa mais quando você [retoma uma sessão antiga](https://code.claude.com/docs/pt/sessions.md#resume-a-session). Em ambos os casos quente e frio, o turno após compactação reconstrói o cache de conversa apenas para o resumo muito mais curto, então esse turno não é a parte lenta.184Após uma pausa mais longa que o [cache lifetime](#cache-lifetime), não há cache deixado para ler, então a solicitação de sumarização reprocessa esse histórico como entrada não armazenada em cache. É por isso que `/compact` custa mais quando você [retoma uma sessão antiga](https://code.claude.com/docs/pt/sessions.md#resume-a-session). Em ambos os casos quente e frio, o turno após a compactação reconstrói o cache de conversa apenas para o histórico muito mais curto, então esse turno não é a parte lenta.

185 185 

186> [!TIP]186> [!TIP]

187>187>

31>31>

32> **macOS, Linux, WSL:**32> **macOS, Linux, WSL:**

33>33>

34> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}34> ```bash theme={null}

35> curl -fsSL https://claude.ai/install.sh | bash35> curl -fsSL https://claude.ai/install.sh | bash

36> ```36> ```

37>37>

39>39>

40> **Windows PowerShell:**40> **Windows PowerShell:**

41>41>

42> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}42> ```powershell theme={null}

43> irm https://claude.ai/install.ps1 | iex43> irm https://claude.ai/install.ps1 | iex

44> ```44> ```

45>45>

46> **Windows CMD:**46> **Windows CMD:**

47>47>

48> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}48> ```batch theme={null}

49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50> ```50> ```

51>51>

63 63 

64> [tab] Homebrew64> [tab] Homebrew

65>65>

66> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}66> ```bash theme={null}

67> brew install --cask claude-code67> brew install --cask claude-code

68> ```68> ```

69>69>

75 75 

76> [tab] WinGet76> [tab] WinGet

77>77>

78> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}78> ```powershell theme={null}

79> winget install Anthropic.ClaudeCode79> winget install Anthropic.ClaudeCode

80> ```80> ```

81>81>

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rejeite servidores específicos do [`.mcp.json`](https://code.claude.com/docs/pt/mcp#project-scope) de um projeto | MCP | Any file |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rejeite servidores específicos do [`.mcp.json`](https://code.claude.com/docs/pt/mcp#project-scope) de um projeto | MCP | Any file |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Bloqueie as ferramentas de Claude no painel [desktop](https://code.claude.com/docs/pt/desktop.md) iOS Simulator | Ferramentas | Managed |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Bloqueie as ferramentas de Claude no painel [desktop](https://code.claude.com/docs/pt/desktop.md) iOS Simulator | Ferramentas | Managed |

88| [`disableRemoteControl`](#disableremotecontrol) | Desative o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) em todos os lugares onde pode começar | Remoto, desktop e notificações | Any file |88| [`disableRemoteControl`](#disableremotecontrol) | Desative o [Remote Control](https://code.claude.com/docs/pt/remote-control.md) em todos os lugares onde pode começar | Remoto, desktop e notificações | Any file |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | Desative scripts nas pré-visualizações HTML do aplicativo [desktop](https://code.claude.com/docs/pt/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) em sessões SSH e WSL | Remoto, desktop e notificações | Managed |

89| [`disableSideloadFlags`](#disablesideloadflags) | Rejeite as flags CLI que carregam [plugins](https://code.claude.com/docs/pt/plugins/overview.md), [subagentes](https://code.claude.com/docs/pt/sub-agents.md) e [servidores MCP](https://code.claude.com/docs/pt/mcp.md) | Configurações empresariais e gerenciadas | Managed |90| [`disableSideloadFlags`](#disablesideloadflags) | Rejeite as flags CLI que carregam [plugins](https://code.claude.com/docs/pt/plugins/overview.md), [subagentes](https://code.claude.com/docs/pt/sub-agents.md) e [servidores MCP](https://code.claude.com/docs/pt/mcp.md) | Configurações empresariais e gerenciadas | Managed |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | Impeça [skills](https://code.claude.com/docs/pt/skills.md) e comandos personalizados de executar shell inline | Plugins e skills | Any file |91| [`disableSkillShellExecution`](#disableskillshellexecution) | Impeça [skills](https://code.claude.com/docs/pt/skills.md) e comandos personalizados de executar shell inline | Plugins e skills | Any file |

91| [`disableWorkflows`](#disableworkflows) | Desative [workflows dinâmicos](https://code.claude.com/docs/pt/workflows.md) para todos; use `enableWorkflows` para você mesmo | Hooks e automação | Any file |92| [`disableWorkflows`](#disableworkflows) | Desative [workflows dinâmicos](https://code.claude.com/docs/pt/workflows.md) para todos; use `enableWorkflows` para você mesmo | Hooks e automação | Any file |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Faça as ferramentas `Write`, `Edit` e `NotebookEdit` recusarem caminhos fora dos [diretórios de trabalho](https://code.claude.com/docs/pt/permissions.md#working-directories) em cada modo de permissão, exceto [alguns dos próprios arquivos de Claude Code](#what-the-write-block-refuses-and-what-stays-writable) | Configurações de permissão | Any file |148| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Faça as ferramentas `Write`, `Edit` e `NotebookEdit` recusarem caminhos fora dos [diretórios de trabalho](https://code.claude.com/docs/pt/permissions.md#working-directories) em cada modo de permissão, exceto [alguns dos próprios arquivos de Claude Code](#what-the-write-block-refuses-and-what-stays-writable) | Configurações de permissão | Any file |

148| [`permissions.defaultMode`](#permissions-defaultmode) | Defina o [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md#which-mode-a-session-starts-in) padrão para novas sessões | Configurações de permissão | Any file |149| [`permissions.defaultMode`](#permissions-defaultmode) | Defina o [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md#which-mode-a-session-starts-in) padrão para novas sessões | Configurações de permissão | Any file |

149| [`permissions.deny`](#permissions-deny) | Bloqueie [usos de ferramentas](https://code.claude.com/docs/pt/permissions.md#permission-rule-syntax) listados, incluindo leituras de arquivos que contêm segredos | Configurações de permissão | Any file |150| [`permissions.deny`](#permissions-deny) | Bloqueie [usos de ferramentas](https://code.claude.com/docs/pt/permissions.md#permission-rule-syntax) listados, incluindo leituras de arquivos que contêm segredos | Configurações de permissão | Any file |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | Negue chamadas de ferramenta que aguardariam um [prompt de permissão](https://code.claude.com/docs/pt/permissions.md#permission-system), para que uma sessão que ninguém está acompanhando continue funcionando | Configurações de permissão | User or managed |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Impeça qualquer pessoa de entrar no [modo bypassPermissions](https://code.claude.com/docs/pt/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Configurações de permissão | Any file |152| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Impeça qualquer pessoa de entrar no [modo bypassPermissions](https://code.claude.com/docs/pt/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Configurações de permissão | Any file |

151| [`plansDirectory`](#plansdirectory) | Escolha onde o [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) escreve arquivos de plano | Memória e contexto | Any file |153| [`plansDirectory`](#plansdirectory) | Escolha onde o [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) escreve arquivos de plano | Memória e contexto | Any file |

152| [`pluginConfigs`](#pluginconfigs) | Armazene as respostas que você deu ao diálogo de configuração de um [plugin](https://code.claude.com/docs/pt/plugins/overview.md) | Plugins e skills | User or managed |154| [`pluginConfigs`](#pluginconfigs) | Armazene as respostas que você deu ao diálogo de configuração de um [plugin](https://code.claude.com/docs/pt/plugins/overview.md) | Plugins e skills | User or managed |

228| [`statusLine`](#statusline) | Execute seu próprio comando para renderizar uma [linha de status](https://code.claude.com/docs/pt/statusline.md) abaixo do prompt | Interface e terminal | Any file |230| [`statusLine`](#statusline) | Execute seu próprio comando para renderizar uma [linha de status](https://code.claude.com/docs/pt/statusline.md) abaixo do prompt | Interface e terminal | Any file |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Defina a allowlist das fontes de [marketplace](https://code.claude.com/docs/pt/plugins/overview.md) que os usuários podem adicionar e a partir das quais podem instalar | Plugins e skills | Managed |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Defina a allowlist das fontes de [marketplace](https://code.claude.com/docs/pt/plugins/overview.md) que os usuários podem adicionar e a partir das quais podem instalar | Plugins e skills | Managed |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Bloqueie [skills](https://code.claude.com/docs/pt/skills.md), [agentes](https://code.claude.com/docs/pt/sub-agents.md), [hooks](https://code.claude.com/docs/pt/hooks.md) e [servidores MCP](https://code.claude.com/docs/pt/mcp.md) de fontes de usuário e projeto | Plugins e skills | Managed |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Bloqueie [skills](https://code.claude.com/docs/pt/skills.md), [agentes](https://code.claude.com/docs/pt/sub-agents.md), [hooks](https://code.claude.com/docs/pt/hooks.md) e [servidores MCP](https://code.claude.com/docs/pt/mcp.md) de fontes de usuário e projeto | Plugins e skills | Managed |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Restrinja [agentes](https://code.claude.com/docs/pt/sub-agents.md) a fontes de plugin e gerenciadas | Plugins e skills | Managed |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Bloqueie [agentes](https://code.claude.com/docs/pt/sub-agents.md) de fontes de usuário e projeto | Plugins e skills | Managed |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Restrinja [hooks](https://code.claude.com/docs/pt/hooks.md) a fontes de plugin e gerenciadas | Plugins e skills | Managed |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Bloqueie [hooks](https://code.claude.com/docs/pt/hooks.md) de fontes de usuário e projeto | Plugins e skills | Managed |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Restrinja [servidores MCP](https://code.claude.com/docs/pt/mcp.md) a fontes de plugin e gerenciadas | Plugins e skills | Managed |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Bloqueie [servidores MCP](https://code.claude.com/docs/pt/mcp.md) de fontes de usuário e projeto | Plugins e skills | Managed |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Restrinja [skills](https://code.claude.com/docs/pt/skills.md) a fontes de plugin e gerenciadas | Plugins e skills | Managed |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Bloqueie [skills](https://code.claude.com/docs/pt/skills.md) de fontes de usuário e projeto | Plugins e skills | Managed |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Escolha o [tempo de vida do cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para subagentes e outras requisições fora da conversa principal | Modelo e respostas | Any file |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Escolha o [tempo de vida do cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para subagentes e outras requisições fora da conversa principal | Modelo e respostas | Any file |

236| [`subagentStatusLine`](#subagentstatusline) | Reescreva linhas na [exibição de tarefa do subagente](https://code.claude.com/docs/pt/sub-agents.md) com seu próprio comando | Interface e terminal | Any file |238| [`subagentStatusLine`](#subagentstatusline) | Reescreva linhas na [exibição de tarefa do subagente](https://code.claude.com/docs/pt/sub-agents.md) com seu próprio comando | Interface e terminal | Any file |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | Alterne modelos automaticamente ou pause quando um [classificador de segurança](https://code.claude.com/docs/pt/model-config.md#ask-before-switching) sinalizar uma requisição | Modelo e respostas | Any file |239| [`switchModelsOnFlag`](#switchmodelsonflag) | Alterne modelos automaticamente ou pause quando um [classificador de segurança](https://code.claude.com/docs/pt/model-config.md#ask-before-switching) sinalizar uma requisição | Modelo e respostas | Any file |

288}290}

289```291```

290 292 

291A chave não tem efeito em provedores onde o advisor [não está disponível](https://code.claude.com/docs/pt/advisor.md#requirements), como Amazon Bedrock e Claude Platform on AWS. `"fable"` requer [acesso ao Fable](https://code.claude.com/docs/pt/advisor.md#choose-an-advisor-model).293A chave não tem efeito em provedores onde o advisor [não está disponível](https://code.claude.com/docs/pt/advisor.md#requirements), como o Amazon Bedrock. No Claude Platform on AWS, a chave requer Claude Code v2.1.300 ou posterior. `"fable"` requer [acesso ao Fable](https://code.claude.com/docs/pt/advisor.md#choose-an-advisor-model).

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 

448 450 

449Ative o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) em sessões onde ele está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo, em que você quer velocidade a um custo maior por token. Normalmente, você não edita esta chave manualmente. Executar `/fast` grava `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave.451Ative o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) em sessões onde ele está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo, em que você quer velocidade a um custo maior por token. Normalmente, você não edita esta chave manualmente. Executar `/fast` grava `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave.

450 452 

451Apenas o Fable 5.2, o Opus 5.5, o Opus 5 e o Opus 4.8 suportam o modo rápido. Executar `/fast` a partir de outro modelo muda você para o Opus, e mudar para um modelo não suportado desativa o modo rápido. Consulte [Trocar de modelo com o modo rápido ativado](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on).453Na API da Anthropic, apenas o Fable 5.2, o Opus 5.5, o Opus 5 e o Opus 4.8 suportam o modo rápido. Executar `/fast` a partir de outro modelo muda você para o Opus, e mudar para um modelo não suportado desativa o modo rápido. Consulte [Trocar de modelo com o modo rápido ativado](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on). No Agent Platform do Google Cloud, [`/fast` muda você para o Fable 5.2](https://code.claude.com/docs/pt/fast-mode#use-fast-mode-on-agent-platform) em vez disso e não grava esta chave, e o Claude Code ignora um `true` salvo.

452 454 

453* **Escopo**: [`Any file`](#scopes)455* **Escopo**: [`Any file`](#scopes)

454* **Tipo**: Boolean456* **Tipo**: Boolean

904Controle quais ferramentas Claude pode usar sem perguntar, quais solicitam confirmação e quais são bloqueadas. Também defina o [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md) padrão para novas sessões. Cada chave `permissions.*` abaixo se aninha sob este objeto.906Controle quais ferramentas Claude pode usar sem perguntar, quais solicitam confirmação e quais são bloqueadas. Também defina o [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md) padrão para novas sessões. Cada chave `permissions.*` abaixo se aninha sob este objeto.

905 907 

906* **Escopo**: [`Any file`](#scopes)908* **Escopo**: [`Any file`](#scopes)

907* **Tipo**: objeto com `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` e `disableAutoMode`909* **Tipo**: objeto com `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `denyInsteadOfPrompting`, `disableBypassPermissionsMode` e `disableAutoMode`

908* **Padrão**: não definido910* **Padrão**: não definido

909 911 

910Este exemplo aprova comandos `npm run` sem perguntar, solicita antes de `git push`, bloqueia leituras de `.env` e inicia sessões em `acceptEdits`:912Este exemplo aprova comandos `npm run` sem perguntar, solicita antes de `git push`, bloqueia leituras de `.env` e inicia sessões em `acceptEdits`:

1163 1165 

1164As regras de permissão se sobrepõem a cada modo: as regras `deny` bloqueiam em cada modo, incluindo `bypassPermissions`. Consulte [Modos de permissão](https://code.claude.com/docs/pt/permission-modes.md). Em sessões na nuvem, Claude Code honra apenas `acceptEdits`, `plan`, `default` e `auto` desta chave. Para conversas que a extensão VS Code inicia, consulte [qual configuração a extensão lê para o modo de permissão inicial](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes).1166As regras de permissão se sobrepõem a cada modo: as regras `deny` bloqueiam em cada modo, incluindo `bypassPermissions`. Consulte [Modos de permissão](https://code.claude.com/docs/pt/permission-modes.md). Em sessões na nuvem, Claude Code honra apenas `acceptEdits`, `plan`, `default` e `auto` desta chave. Para conversas que a extensão VS Code inicia, consulte [qual configuração a extensão lê para o modo de permissão inicial](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes).

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170Defina isto como `true` para manter uma sessão em execução quando não houver ninguém para responder a um prompt de permissão. Claude Code nega uma chamada de ferramenta que, de outra forma, aguardaria um prompt, e o turno continua. Requer Claude Code v2.1.319 ou posterior.

1171 

1172Uma chamada prossegue se uma regra de permissão, seu [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md) ou o classificador do modo auto a aprovar. Para permitir a maioria das chamadas que de outra forma solicitariam confirmação, responda a partir de um [hook `PermissionRequest`](https://code.claude.com/docs/pt/hooks#permissionrequest).

1173 

1174* **Escopo**: [`User or managed`](#scopes), e `--settings`. Um repositório não pode defini-lo para você.

1175* **Tipo**: Booleano

1176 * `true`: Claude Code nega chamadas que de outra forma solicitariam confirmação

1177 * `false`: o mesmo que não definido; as chamadas ainda são negadas se outra dessas fontes definir `true`

1178* **Padrão**: não definido, portanto uma chamada que precisa de aprovação solicita sua confirmação

1179 

1180Em `~/.claude/settings.json`, este exemplo inicia sessões no modo auto e nega o que ainda recairia em um prompt:

1181 

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

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191A chave se aplica em execuções `-p`, sessões interativas de terminal, na [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md), em sessões locais no [aplicativo Desktop](https://code.claude.com/docs/pt/desktop.md), em [subagentes](https://code.claude.com/docs/pt/sub-agents.md) e em [equipes de agentes](https://code.claude.com/docs/pt/agent-teams.md). Para negar o que solicitaria confirmação em uma única execução [não interativa](https://code.claude.com/docs/pt/headless.md), passe [`--permission-prompts none`](https://code.claude.com/docs/pt/headless#turn-off-permission-prompts-in-unattended-runs) com `-p`.

1192 

1193#### O que mais `denyInsteadOfPrompting` interrompe

1194 

1195Com a configuração ativada, Claude Code também interrompe estas solicitações de resposta:

1196 

1197* **Ferramentas de pergunta e de plano**: Claude Code deixa de fora [`AskUserQuestion`](https://code.claude.com/docs/pt/tools-reference#askuserquestion-tool-behavior), `EnterPlanMode` e `ExitPlanMode`, portanto uma sessão no modo de planejamento não pode sair dele por conta própria. Um colega de equipe em uma equipe de agentes mantém `EnterPlanMode` e `ExitPlanMode`

1198* **Elicitação MCP**: Claude Code cancela uma [requisição de elicitação](https://code.claude.com/docs/pt/mcp.md#respond-to-mcp-elicitation-requests) a menos que um [hook `Elicitation`](https://code.claude.com/docs/pt/hooks#elicitation) a responda

1199* **Hosts de permissão**: Claude Code não consulta seu [callback `canUseTool`](https://code.claude.com/docs/pt/agent-sdk/user-input) nem [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags). Para aprovar chamadas a partir de código, responda a partir de um hook `PermissionRequest`. Algumas chamadas são negadas antes que qualquer hook seja consultado, como uma [remoção de caminho crítico](https://code.claude.com/docs/pt/permission-modes.md#critical-path-removals-in-each-permission-mode) no modo `auto` que nenhuma regra ask cobre.

1200* **Aviso de cobrança do classificador**: onde o [aviso sobre requisições cobradas do classificador](https://code.claude.com/docs/pt/auto-mode-classifier-billing.md) abriria um diálogo, Claude Code não o mostra e nega as ações que precisam dessas requisições

1201 

1202Uma sessão ainda pode aguardar o [diálogo de confiança do workspace](https://code.claude.com/docs/pt/permissions.md#project-allow-rules-and-workspace-trust) e a [aprovação de servidores MCP do projeto](https://code.claude.com/docs/pt/mcp.md#project-server-approvals-and-workspace-trust). Responda a ambos antes de deixar a sessão em execução.

1203 

1204#### Mensagens de `denyInsteadOfPrompting`

1205 

1206Estas mensagens relatam chamadas recusadas. Elas não são prompts, portanto nada aguarda sua resposta.

1207 

1208A negação que Claude lê pode começar com este texto:

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214Na saída `stream-json`, [as execuções que emitem uma mensagem `permission_denied`](https://code.claude.com/docs/pt/agent-sdk/typescript#sdkpermissiondeniedmessage) relatam este `decision_reason`:

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220No modo auto com a configuração ativada, o turno termina após 20 chamadas seguidas que o classificador bloqueou ou que uma [verificação de segurança recusou](https://code.claude.com/docs/pt/errors.md#auto-mode-cannot-determine-the-safety-of-an-action), e você vê esta mensagem:

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226Uma execução `-p` relata esse turno como `error_during_execution`.

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168Impeça que qualquer pessoa entre no modo `bypassPermissions`. Claude Code então rejeita a flag `--dangerously-skip-permissions` e ignora uma [definição de agente](https://code.claude.com/docs/pt/sub-agents.md#permission-modes) `permissionMode: bypassPermissions`, portanto o subagente é executado com o modo de permissão da sessão pai.1230Impeça que qualquer pessoa entre no modo `bypassPermissions`. Claude Code então rejeita a flag `--dangerously-skip-permissions` e ignora uma [definição de agente](https://code.claude.com/docs/pt/sub-agents.md#permission-modes) `permissionMode: bypassPermissions`, portanto o subagente é executado com o modo de permissão da sessão pai.

1202 1264 

1203Pule o diálogo de confirmação que Claude Code mostra antes de uma sessão entrar no modo `bypassPermissions`, seja de `--dangerously-skip-permissions` ou de `defaultMode: "bypassPermissions"`. Claude Code escreve `true` aqui em suas configurações de usuário quando você aceita esse diálogo uma vez.1265Pule o diálogo de confirmação que Claude Code mostra antes de uma sessão entrar no modo `bypassPermissions`, seja de `--dangerously-skip-permissions` ou de `defaultMode: "bypassPermissions"`. Claude Code escreve `true` aqui em suas configurações de usuário quando você aceita esse diálogo uma vez.

1204 1266 

1205* **Escopo**: [`User, local, or managed`](#scopes). Um repositório não confiável não pode pular o diálogo para você.1267* **Escopo**: [`User, local, or managed`](#scopes), e arquivos passados com `--settings`. [Sessões em segundo plano](https://code.claude.com/docs/pt/permission-modes.md#bypass-permissions-ignored-in-a-background-session) consideram apenas configurações de usuário e gerenciadas. Um repositório não confiável não pode pular o diálogo para você.

1206* **Tipo**: Booleano1268* **Tipo**: Booleano

1207 * `true`: Claude Code pula o diálogo de confirmação antes de uma sessão entrar no modo `bypassPermissions`1269 * `true`: Claude Code pula o diálogo de confirmação antes de uma sessão entrar no modo `bypassPermissions`

1208 * `false`: o mesmo que não definido; o diálogo aparece a menos que outro desses arquivos defina `true`1270 * `false`: o mesmo que não definido; o diálogo aparece a menos que outro desses arquivos defina `true`

3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code colore código por linguagem nos diffs, blocos de código e visualizações de arquivo que mostra no terminal, com seu highlighter integrado; nenhum plugin ou servidor de linguagem está envolvido. Defina esta chave como `true` para mostrá-los como texto simples em vez disso, por exemplo se as cores entrarem em conflito com seu tema de terminal ou desacelerem um leitor de tela.3197Claude Code colore código por linguagem nos diffs, blocos de código e visualizações de arquivo que mostra no terminal, com seu highlighter integrado. Defina esta chave como `true` para mostrá-los como texto simples em vez disso, por exemplo se as cores entrarem em conflito com seu tema de terminal ou desacelerem um leitor de tela.

3136 3198 

3137* **Scope**: [`Any file`](#scopes)3199* **Scope**: [`Any file`](#scopes)

3138* **Type**: Boolean3200* **Type**: Boolean

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113Bloqueie skills, agents, hooks e servidores MCP de fontes de usuário e projeto, portanto podem vir apenas de plugins ou configurações gerenciadas. Combine com [`strictKnownMarketplaces`](#strictknownmarketplaces) para controlar a cadeia de suprimento de customização completa: a lista de permissões de marketplace controla quais plugins usuários podem instalar.4175Bloqueie skills, agentes, hooks e servidores MCP de fontes de usuário e projeto. Combine com [`strictKnownMarketplaces`](#strictknownmarketplaces) para escolher de quais marketplaces os usuários podem instalar plugins. Adicione [`disableSideloadFlags`](#disablesideloadflags) para rejeitar as flags da CLI que carregam lateralmente plugins, agentes e servidores MCP para uma única execução.

4114 4176 

4115* **Scope**: [`Managed`](#scopes)4177* **Scope**: [`Managed`](#scopes)

4116* **Type**: `true` para bloquear todos os quatro tipos de customização, ou um array nomeando os tipos a bloquear, de `"skills"`, `"agents"`, `"hooks"` e `"mcp"`4178* **Type**: `true` para bloquear todos eles, ou um array nomeando os que devem ser bloqueados, dentre `"skills"`, `"agents"`, `"hooks"` e `"mcp"`

4117* **Default**: não definido, portanto nada é bloqueado4179* **Default**: não definido, portanto nada é bloqueado

4118 4180 

4119Este exemplo bloqueia skills e hooks e deixa agents e servidores MCP desbloqueados:4181Este exemplo bloqueia skills e hooks e deixa agents e servidores MCP desbloqueados:

4216Cada escopo serve um propósito diferente:4278Cada escopo serve um propósito diferente:

4217 4279 

4218* **User settings**: suas preferências pessoais de plugin4280* **User settings**: suas preferências pessoais de plugin

4219* **Project settings**: plugins compartilhados com todos no repositório4281* **Project settings**: plugins ativados para todos no repositório. Isso não os instala, portanto cada usuário [os instala](https://code.claude.com/docs/pt/plugins/org.md#require-plugins-per-repository).

4220* **Local settings**: overrides por máquina, gitignored quando Claude Code salva uma configuração lá4282* **Local settings**: overrides por máquina, gitignored quando Claude Code salva uma configuração lá

4221* **Managed settings**: política em toda a organização. Um plugin definido como `false` aqui é bloqueado da instalação em cada escopo e ocultado do marketplace4283* **Managed settings**: política em toda a organização. Um plugin definido como `false` aqui é bloqueado da instalação em cada escopo e ocultado do marketplace

4222 4284 

4223As configurações de projeto têm precedência sobre as configurações de usuário, portanto definir um plugin como `false` em `~/.claude/settings.json` não desativa um plugin que o `.claude/settings.json` do projeto ativa. Para optar por não participar de um plugin habilitado pelo projeto em sua máquina, defina como `false` em `.claude/settings.local.json`. Plugins forçadamente habilitados por configurações gerenciadas não podem ser desativados dessa forma, já que configurações gerenciadas substituem configurações locais.4285As configurações de projeto têm precedência sobre as configurações de usuário, portanto definir um plugin como `false` em `~/.claude/settings.json` não desativa um plugin que o `.claude/settings.json` do projeto ativa. Para optar por não participar de um plugin habilitado pelo projeto em sua máquina, defina como `false` em `.claude/settings.local.json`. Plugins forçadamente habilitados por configurações gerenciadas não podem ser desativados dessa forma, já que configurações gerenciadas substituem configurações locais.

4224 4286 

4225Ativar um plugin de uma fonte externa como um repositório GitHub ou pacote npm no `.claude/settings.json` de um projeto não o instala para outras pessoas. Em cada caminho que carrega plugins, Claude Code relata o plugin como não instalado até que cada usuário [o instale](https://code.claude.com/docs/pt/plugins/org.md#require-plugins-per-repository).

4226 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229Registre marketplaces de plugin adicionais por nome, para que pessoas que abram o repositório, ou todos que suas configurações gerenciadas alcançam, obtenham o marketplace sem adicioná-lo eles mesmos. Claude Code registra cada marketplace que ainda não conhece. Se um plugin que [`enabledPlugins`](#enabledplugins) nomeia dele instala depende da fonte do plugin e qual arquivo o ativa; essa entrada tem as regras.4289Registre marketplaces de plugin adicionais por nome, para que as pessoas que abrem o repositório, ou todos que suas configurações gerenciadas alcançam, obtenham o marketplace sem adicioná-lo elas mesmas. Claude Code registra cada marketplace que ainda não conhece. Se um plugin desse marketplace nomeado em [`enabledPlugins`](#enabledplugins) é instalado depende da fonte do plugin e de qual arquivo o ativa; [Habilitado nas configurações de projeto, mas não instalado](https://code.claude.com/docs/pt/plugins/loading.md#enabled-in-project-settings-but-not-installed) traz as regras.

4230 4290 

4231* **Scope**: [`Any file`](#scopes). Claude Code honra entradas no `.claude/settings.json` ou `.claude/settings.local.json` de um repositório apenas após você aceitar o diálogo de confiança de workspace para essa pasta; em uma pasta que você não confiou, incluindo uma execução `-p` lá, ignora sem mensagem.4291* **Scope**: [`Any file`](#scopes). Claude Code honra entradas no `.claude/settings.json` ou `.claude/settings.local.json` de um repositório apenas após você aceitar o diálogo de confiança de workspace para essa pasta; em uma pasta que você não confiou, incluindo uma execução `-p` lá, ignora sem mensagem.

4232* **Type**: objeto mapeando um nome de marketplace para um objeto com um objeto `source` e um Boolean `autoUpdate` opcional4292* **Type**: objeto mapeando um nome de marketplace para um objeto com um objeto `source` e um Boolean `autoUpdate` opcional

4354 4414 

4355Liste os plugins gerenciados cujos [mods](https://code.claude.com/docs/pt/plugins/mods/overview.md) são executados antes de cada mod que um usuário instala, na ordem listada. Quando você define esta chave em configurações gerenciadas, nomeie `sec-default@builtin` na lista para manter a guarda integrada. Em configurações gerenciadas, Claude Code pula um id cujo plugin não conta como de sua organização. Consulte [Instale os mods de sua organização e defina a ordem](https://code.claude.com/docs/pt/plugins/mods/admin.md#install-your-organizations-mods) para essas condições e para como as duas chaves de ordenação funcionam juntas.4415Liste os plugins gerenciados cujos [mods](https://code.claude.com/docs/pt/plugins/mods/overview.md) são executados antes de cada mod que um usuário instala, na ordem listada. Quando você define esta chave em configurações gerenciadas, nomeie `sec-default@builtin` na lista para manter a guarda integrada. Em configurações gerenciadas, Claude Code pula um id cujo plugin não conta como de sua organização. Consulte [Instale os mods de sua organização e defina a ordem](https://code.claude.com/docs/pt/plugins/mods/admin.md#install-your-organizations-mods) para essas condições e para como as duas chaves de ordenação funcionam juntas.

4356 4416 

4357* **Scope**: [`User or managed`](#scopes). Claude Code lê a chave de configurações gerenciadas. Lê a chave de configurações de usuário apenas em uma máquina sem configurações gerenciadas, em uma sessão cuja credencial não é um `/login` Team ou Enterprise. Ignora a chave em configurações de projeto e local e em um arquivo `--settings`.4417* **Scope**: [`User or managed`](#scopes). Claude Code lê a chave de configurações gerenciadas. Lê a chave de configurações de usuário apenas em uma máquina sem configurações gerenciadas nem arquivo `managed-mcp.json`, em uma sessão cuja credencial não é um `/login` Team ou Enterprise. Ignora a chave em configurações de projeto e locais e em um arquivo `--settings`.

4358* **Type**: array de strings `plugin-name@marketplace-name`4418* **Type**: array de strings `plugin-name@marketplace-name`

4359* **Default**: não definido4419* **Default**: não definido

4360 4420 

4374 4434 

4375Liste os plugins gerenciados cujos [mods](https://code.claude.com/docs/pt/plugins/mods/overview.md) são executados após cada mod que um usuário instala, na ordem listada. Um id listado em ambos `prependPlugins` e `appendPlugins` é antecedido. Em configurações gerenciadas, Claude Code pula um id cujo plugin não [conta como de sua organização](https://code.claude.com/docs/pt/plugins/mods/admin.md#install-your-organizations-mods).4435Liste os plugins gerenciados cujos [mods](https://code.claude.com/docs/pt/plugins/mods/overview.md) são executados após cada mod que um usuário instala, na ordem listada. Um id listado em ambos `prependPlugins` e `appendPlugins` é antecedido. Em configurações gerenciadas, Claude Code pula um id cujo plugin não [conta como de sua organização](https://code.claude.com/docs/pt/plugins/mods/admin.md#install-your-organizations-mods).

4376 4436 

4377* **Scope**: [`User or managed`](#scopes). Claude Code lê a chave de configurações gerenciadas. Lê a chave de configurações de usuário apenas em uma máquina sem configurações gerenciadas, em uma sessão cuja credencial não é um `/login` Team ou Enterprise. Ignora a chave em configurações de projeto e local e em um arquivo `--settings`.4437* **Scope**: [`User or managed`](#scopes). Claude Code lê a chave de configurações gerenciadas. Lê a chave de configurações de usuário apenas em uma máquina sem configurações gerenciadas nem arquivo `managed-mcp.json`, em uma sessão cuja credencial não é um `/login` Team ou Enterprise. Ignora a chave em configurações de projeto e locais e em um arquivo `--settings`.

4378* **Type**: array de strings `plugin-name@marketplace-name`4438* **Type**: array de strings `plugin-name@marketplace-name`

4379* **Default**: não definido4439* **Default**: não definido

4380 4440 

4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615Escolha o que esta sessão faz com [mensagens chegando de suas outras sessões do Claude Code](https://code.claude.com/docs/pt/cross-session-messaging.md#control-inbound-messages). Quando nenhum valor se aplica, Claude Code decide por mensagem das classes de modo de permissão das duas sessões. Requer Claude Code v2.1.224 ou posterior.4675Escolha o que esta sessão faz com [mensagens chegando de suas outras sessões do Claude Code](https://code.claude.com/docs/pt/cross-session-messaging.md#control-inbound-messages). Quando nenhum valor se aplica, Claude Code decide por mensagem das classes de modo de permissão das duas sessões.

4616 4676 

4617* **Escopo**: [`Qualquer arquivo`](#scopes). Um valor de projeto ou local se aplica apenas quando é mais restritivo do que o valor de configurações gerenciadas, a flag `--settings` ou configurações de usuário fornecem.4677* **Escopo**: [`Qualquer arquivo`](#scopes). Um valor de projeto ou local se aplica apenas quando é mais restritivo do que o valor de configurações gerenciadas, a flag `--settings` ou configurações de usuário fornecem.

4618* **Tipo**: string, um de:4678* **Tipo**: string, um de:

4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011Impeça que scripts sejam executados quando as pessoas [visualizam um arquivo HTML](https://code.claude.com/docs/pt/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) a partir de uma sessão SSH ou WSL no aplicativo desktop. A navegação externa no painel Browser não é afetada.

5012 

5013O aplicativo desktop lê essa chave; o CLI do terminal a ignora. Requer Claude Desktop v5.1231.0 ou posterior. Versões anteriores ignoram a chave: para impedir os scripts nelas, defina também [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation), que desativa também a navegação externa.

5014 

5015* **Escopo**: [`Gerenciado`](#scopes). O aplicativo desktop não lê a chave da máquina remota nem da distribuição WSL.

5016* **Tipo**: Boolean; apenas o Boolean JSON `true` tem efeito

5017 * `true`: visualizações de HTML em sessões SSH e WSL não executam scripts

5018 * `false`: a chave não desativa scripts

5019* **Padrão**: não definido, então a chave não tem efeito

5020 

5021Se o computador que executa o aplicativo desktop não recebe nenhuma outra configuração gerenciada do Claude Code, defina também [`parentSettingsBehavior`](#parentsettingsbehavior) como `"merge"` nas configurações gerenciadas que você criar. No Windows, se você criar um arquivo de configurações gerenciadas, os usuários também perdem as sessões WSL até que você [as permita](https://code.claude.com/docs/pt/admin-setup.md#wsl-sessions-in-claude-code-desktop). [Desativar scripts em visualizações SSH e WSL para sua organização](https://code.claude.com/docs/pt/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) explica ambos e diz onde definir a chave.

5022 

5023Este exemplo mostra a chave sozinha, como você a adicionaria a configurações gerenciadas que um computador já recebe:

5024 

5025```json managed-settings.json theme={null}

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031O aplicativo desktop ignora qualquer outro valor, e um valor que não seja um Boolean, como a string `"true"` ou `1`, também registra um aviso.

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951Desative a ferramenta [Artifact](https://code.claude.com/docs/pt/artifacts.md), que publica a saída da sessão como uma página da web privada em claude.ai. Quando você desativa a linha **Artifacts** em `/config`, o Claude Code escreve essa chave em suas configurações de usuário, então você geralmente não a edita manualmente.5035Desative a ferramenta [Artifact](https://code.claude.com/docs/pt/artifacts.md), que publica a saída da sessão como uma página da web privada em claude.ai. Quando você desativa a linha **Artifacts** em `/config`, o Claude Code escreve essa chave em suas configurações de usuário, então você geralmente não a edita manualmente.

5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222Restrinja qual tipo de conta as pessoas podem usar para fazer login. Defina `"claudeai"` para permitir apenas contas claude.ai, `"console"` para permitir apenas contas Claude Console, ou `"gateway"` para enviar as pessoas para um [gateway na nuvem](https://code.claude.com/docs/pt/claude-apps-gateway) em vez de um login de primeira parte. Os administradores o definem em configurações gerenciadas e o emparelham com [`forceLoginOrgUUID`](#forceloginorguuid) para manter os logins claude.ai dos desenvolvedores dentro de uma organização.5306Restrinja qual tipo de conta as pessoas podem usar para fazer login: `"claudeai"` para login claude.ai ou `"console"` para login Claude Console. Defina `"gateway"` para enviar as pessoas para um [gateway na nuvem](https://code.claude.com/docs/pt/claude-apps-gateway) em vez de um login de primeira parte. Os administradores o definem em configurações gerenciadas e o emparelham com [`forceLoginOrgUUID`](#forceloginorguuid) para manter os logins claude.ai dos desenvolvedores dentro de uma organização.

5223 5307 

5224Se você o definir como `"claudeai"` em qualquer arquivo de configurações, Claude Code também para de oferecer o [login Console sem chave](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key) nas sessões às quais esse arquivo se aplica. Apenas com `"console"`, as pessoas ainda podem chegar ao login sem chave após uma falha de login. Para que Claude Code pare de oferecê-lo, veja [Parar de oferecer o login sem chave em máquinas gerenciadas](https://code.claude.com/docs/pt/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), que também lista o que mais `forceLoginOrgUUID` altera.5308Se você o definir como `"claudeai"` em qualquer arquivo de configurações, Claude Code também para de oferecer o [login Console sem chave](https://code.claude.com/docs/pt/authentication.md#sign-in-without-an-api-key) nas sessões às quais esse arquivo se aplica. Apenas com `"console"`, as pessoas ainda podem chegar ao login sem chave após uma falha de login. Para que Claude Code pare de oferecê-lo, veja [Parar de oferecer o login sem chave em máquinas gerenciadas](https://code.claude.com/docs/pt/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), que também lista o que mais `forceLoginOrgUUID` altera.

5225 5309 

5226* **Escopo**: [`Qualquer arquivo`](#scopes). Claude Code honra `"gateway"` das mesmas fontes que [`forceLoginGatewayUrl`](#forcelogingatewayurl) e o trata como não definido em todos os outros lugares.5310* **Escopo**: [`Qualquer arquivo`](#scopes). Claude Code honra `"gateway"` das mesmas fontes que [`forceLoginGatewayUrl`](#forcelogingatewayurl) e o trata como não definido em todos os outros lugares.

5227* **Tipo**: string, um de:5311* **Tipo**: string, um de:

5228 * `"claudeai"`: apenas contas claude.ai podem fazer login5312 * `"claudeai"`: login claude.ai

5229 * `"console"`: apenas contas Claude Console podem fazer login5313 * `"console"`: login Claude Console

5230 * `"gateway"`: Claude Code envia as pessoas para um gateway na nuvem em vez de um login de primeira parte5314 * `"gateway"`: Claude Code envia as pessoas para um gateway na nuvem em vez de um login de primeira parte

5231* **Padrão**: não definido, portanto as pessoas escolhem um método de login5315* **Padrão**: não definido, portanto as pessoas escolhem um método de login

5232 5316 

5471 5555 

5472Defina quantos dias o Claude Code mantém [transcrições de sessão e outros dados de aplicação](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically) antes de deletá-los. O Claude Code executa a exclusão como uma varredura em segundo plano após uma sessão iniciar, desde que possa determinar com segurança o período de retenção. A varredura deleta transcrições sem mostrar uma mensagem, então uma sessão que você não usou por mais tempo do que o período de retenção não aparece mais no seletor [`/resume`](https://code.claude.com/docs/pt/sessions#resume-a-session).5556Defina quantos dias o Claude Code mantém [transcrições de sessão e outros dados de aplicação](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically) antes de deletá-los. O Claude Code executa a exclusão como uma varredura em segundo plano após uma sessão iniciar, desde que possa determinar com segurança o período de retenção. A varredura deleta transcrições sem mostrar uma mensagem, então uma sessão que você não usou por mais tempo do que o período de retenção não aparece mais no seletor [`/resume`](https://code.claude.com/docs/pt/sessions#resume-a-session).

5473 5557 

5558Por padrão, o Claude Code mantém as transcrições de sessões que você iniciou ou continuou mais recentemente no Claude Desktop ou Cowork além desse período, mesmo que você mesmo defina essa chave. Esse período [ainda se aplica a elas em alguns casos](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically), como na configuração HIPAA. Antes da v2.1.248, o Claude Code as deletava após esse período.

5559 

5474* **Escopo**: [`Any file`](#scopes)5560* **Escopo**: [`Any file`](#scopes)

5475* **Tipo**: número de dias, um número inteiro, mínimo `1`5561* **Tipo**: número de dias, um número inteiro, mínimo `1`

5476* **Padrão**: `30`5562* **Padrão**: `30`

5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488Defina um limite de idade em dias para as transcrições de sessões que você iniciou ou continuou mais recentemente no Claude Desktop ou Cowork. Sem essa chave, o Claude Code [mantém essas transcrições em qualquer idade](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically). O Claude Code deleta cada uma assim que fica mais antiga que tanto esse limite quanto [`cleanupPeriodDays`](#cleanupperioddays), então com `cleanupPeriodDays` em seu padrão de 30, um valor de `7` ainda as mantém por 30 dias. [Limpos automaticamente](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically) lista os casos em que `cleanupPeriodDays` se aplica em vez disso e o Claude Code ignora essa chave. Requer Claude Code v2.1.248 ou posterior.5574Defina um limite de idade em dias para as transcrições de sessões que você iniciou ou continuou mais recentemente no Claude Desktop ou Cowork. Sem essa chave, o Claude Code [mantém essas transcrições em qualquer idade](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically), exceto em casos como o de uma sessão que você deletou no Claude Desktop. Requer Claude Code v2.1.248 ou posterior.

5575 

5576O Claude Code deleta cada transcrição assim que ela fica mais antiga que tanto esse limite quanto [`cleanupPeriodDays`](#cleanupperioddays), então com `cleanupPeriodDays` em seu padrão de 30, um valor de `7` ainda as mantém por 30 dias. [Limpos automaticamente](https://code.claude.com/docs/pt/claude-directory.md#cleaned-up-automatically) lista os casos em que `cleanupPeriodDays` se aplica em vez disso e o Claude Code ignora essa chave.

5489 5577 

5490* **Escopo**: [`User or managed`](#scopes). O Claude Code também lê a chave de um arquivo que você passa com `--settings` e a ignora em configurações de projeto e locais.5578* **Escopo**: [`User or managed`](#scopes). O Claude Code também lê a chave de um arquivo que você passa com `--settings` e a ignora em configurações de projeto e locais.

5491* **Tipo**: número de dias, um número inteiro, mínimo `0`5579* **Tipo**: número de dias, um número inteiro, mínimo `0`