Documentation 2026-11-11 22:59 UTC to 2026-11-12 22:01 UTC

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 

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 

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 

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`