266 266
267## Modelo e respostas267## Modelo e respostas
268 268
269Escolha quais modelos o Claude Code usa e como ele responde. Para saber como essas configurações interagem com o comando `/model` e variáveis de ambiente, consulte [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md).269Escolha quais modelos o Claude Code usa e como ele responde. Para saber como essas configurações interagem com o comando `/model` e com variáveis de ambiente, consulte [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md).
270 270
271### `advisorModel`271### `advisorModel`
272 272
273Escolha qual modelo responde quando Claude chama a [ferramenta advisor](https://code.claude.com/docs/pt/advisor.md) do lado do servidor. Deixe-a sem definir para desativar o advisor. O advisor deve ser pelo menos tão capaz quanto seu modelo principal. Consulte [Escolha um modelo advisor](https://code.claude.com/docs/pt/advisor.md#choose-an-advisor-model) para os emparelhamentos aceitos e o que acontece quando você escolhe um que não é aceito.273Escolha qual modelo responde quando o Claude chama a [ferramenta advisor](https://code.claude.com/docs/pt/advisor.md) do lado do servidor. Remova a configuração para desativar o advisor. O advisor deve ser pelo menos tão capaz quanto o seu modelo principal. Consulte [Escolher um modelo advisor](https://code.claude.com/docs/pt/advisor.md#choose-an-advisor-model) para ver as combinações aceitas e o que acontece quando você escolhe uma que não é aceita.
274 274
275Você normalmente não edita essa chave manualmente. Execute `/advisor` para abrir um seletor que mostra a escolha atual, os modelos que podem aconselhar e **Sem advisor**. Claude Code salva sua escolha nessa chave em `~/.claude/settings.json`. Se você escolher em um cliente [Remote Control](https://code.claude.com/docs/pt/remote-control.md) ou em uma sessão anexada a um worker remoto, a escolha se aplica apenas a essa sessão e não altera essa chave.275Normalmente, você não edita esta chave manualmente. Execute `/advisor` para abrir um seletor que mostra a escolha atual, os modelos que podem atuar como advisor e **No advisor**. O Claude Code salva sua escolha nesta chave em `~/.claude/settings.json`. Se você fizer a escolha a partir de um cliente [Remote Control](https://code.claude.com/docs/pt/remote-control.md) ou em uma sessão conectada a um worker remoto, a escolha se aplica apenas àquela sessão e não altera esta chave.
276 276
277Se sua conta exigir o [consentimento de créditos de uso](https://code.claude.com/docs/pt/advisor.md#fable-advisor-and-usage-credits), aceite-o primeiro executando `/model fable`. Até fazer isso, escolher Fable em `/advisor` não salva nada e Claude Code diz para executar `/model fable` primeiro.277Se a sua conta exigir o [consentimento de créditos de uso](https://code.claude.com/docs/pt/advisor.md#fable-advisor-and-usage-credits), aceite-o primeiro executando `/model fable`. Até que você faça isso, escolher Fable em `/advisor` não salva nada e o Claude Code informa que você deve executar `/model fable` primeiro.
278 278
279* **Escopo**: [`Qualquer arquivo`](#scopes)279* **Escopo**: [`Any file`](#scopes)
280* **Tipo**: string, um dos aliases `"fable"`, `"opus"` ou `"sonnet"`, que resolvem para a versão padrão atual do Claude Code dessa família de modelos, ou um ID de modelo completo como `"claude-opus-5-5"`280* **Tipo**: string, um dos aliases `"fable"`, `"opus"` ou `"sonnet"`, que correspondem à versão padrão atual do Claude Code daquela família de modelos, ou um ID de modelo completo, como `"claude-opus-5-5"`
281* **Padrão**: sem definir, então o advisor está desativado281* **Padrão**: não definido, então o advisor fica desativado
282* **Substituições por sessão**: `--advisor` tem precedência sobre essa chave para uma sessão. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](https://code.claude.com/docs/pt/env-vars) desativa o advisor, e essa chave não pode ativá-lo novamente282* **Substituições por sessão**: `--advisor` tem precedência sobre esta chave para uma sessão. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](https://code.claude.com/docs/pt/env-vars) desativa o advisor, e esta chave não pode reativá-lo
283 283
284```json settings.json theme={null}284```json settings.json theme={null}
285{285{
287}287}
288```288```
289 289
290A 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 na AWS. `"fable"` requer [acesso a Fable](https://code.claude.com/docs/pt/advisor.md#choose-an-advisor-model).290A 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).
291 291
292### `alwaysThinkingEnabled`292### `alwaysThinkingEnabled`
293 293
294Desative o [pensamento estendido](https://code.claude.com/docs/pt/model-config.md#extended-thinking) para cada sessão definindo isso como `false`. O pensamento está ativado por padrão, então `true` não muda nada. A maioria das pessoas define isso através de `/config` em vez de editar o arquivo.294Desative o [pensamento estendido](https://code.claude.com/docs/pt/model-config.md#extended-thinking) em todas as sessões definindo esta chave como `false`. O pensamento fica ativado por padrão, então `true` não altera nada. A maioria das pessoas define isso por meio de `/config` em vez de editar o arquivo.
295 295
296Em modelos que sempre pensam, como Opus 5.5, Sonnet 5.5, Haiku 5.5 e os modelos Fable, `false` não tem efeito. Em [provedores de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), Claude Code omite o parâmetro `thinking` em vez de desativar o pensamento, então modelos de raciocínio adaptativo podem ainda pensar. Com o pensamento desativado na API Anthropic, Claude Code envia esforço `high` em vez de um nível superior para modelos que sabe [não aceitam essa combinação](https://code.claude.com/docs/pt/errors.md#effort-isnt-available-with-thinking-turned-off), como Opus 5.296Em modelos que sempre pensam, como Opus 5.5, Sonnet 5.5, Haiku 5.5 e os modelos Fable, `false` não tem efeito. Em [provedores de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md), o Claude Code omite o parâmetro `thinking` em vez de desativar o pensamento, então modelos com raciocínio adaptativo ainda podem pensar. Com o pensamento desativado na API da Anthropic, o Claude Code envia o esforço `high` em vez de um nível mais alto para modelos que ele sabe que [não aceitam essa combinação](https://code.claude.com/docs/pt/errors.md#effort-isnt-available-with-thinking-turned-off), como o Opus 5.
297 297
298* **Escopo**: [`Qualquer arquivo`](#scopes)298* **Escopo**: [`Any file`](#scopes)
299* **Tipo**: Boolean299* **Tipo**: Boolean
300 * `true`: sem efeito; o pensamento já está ativado300 * `true`: sem efeito; o pensamento já está ativado
301 * `false`: Claude Code desativa o pensamento estendido para cada sessão301 * `false`: o Claude Code desativa o pensamento estendido em todas as sessões
302* **Padrão**: sem definir, então o pensamento está ativado para modelos que o suportam302* **Padrão**: não definido, então o pensamento fica ativado para modelos que o suportam
303* **Substituições por sessão**: [`MAX_THINKING_TOKENS`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre essa chave para uma sessão: `0` desativa o pensamento, sob os mesmos limites de modelo e provedor que `false`, e um valor positivo ativa o pensamento mesmo quando essa chave é `false`. Em modelos de raciocínio adaptativo, o número em si é ignorado303* **Substituições por sessão**: [`MAX_THINKING_TOKENS`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre esta chave para uma sessão: `0` desativa o pensamento, sob os mesmos limites de modelo e provedor que `false`, e um valor positivo ativa o pensamento mesmo quando esta chave é `false`. Em modelos com raciocínio adaptativo, o número em si é ignorado
304 304
305```json settings.json theme={null}305```json settings.json theme={null}
306{306{
310 310
311### `availableModels`311### `availableModels`
312 312
313Restrinja quais modelos as pessoas podem selecionar para a sessão principal, [subagentes](https://code.claude.com/docs/pt/sub-agents.md), [skills](https://code.claude.com/docs/pt/skills.md) e o [advisor](https://code.claude.com/docs/pt/advisor.md). Uma lista gerenciada restringe `/model`, `--model` e a chave `model` nos próprios arquivos de um desenvolvedor; um modelo fora dela não pode ser selecionado. Com a correspondência de prefixo padrão, isso não afeta a opção Padrão por si só; combine-o com [`enforceAvailableModels`](#enforceavailablemodels) para isso.313Restrinja quais modelos as pessoas podem selecionar para a sessão principal, [subagentes](https://code.claude.com/docs/pt/sub-agents.md), [skills](https://code.claude.com/docs/pt/skills.md) e o [advisor](https://code.claude.com/docs/pt/advisor.md). Uma lista gerenciada restringe `/model`, `--model` e a chave `model` nos arquivos do próprio desenvolvedor; um modelo fora dela não pode ser selecionado. Com a correspondência por prefixo padrão, isso por si só não afeta a opção Default; combine com [`enforceAvailableModels`](#enforceavailablemodels) para isso.
314 314
315* **Escopo**: [`Qualquer arquivo`](#scopes). Implante-o em configurações gerenciadas para aplicá-lo a uma organização.315* **Escopo**: [`Any file`](#scopes). Implante-a em configurações gerenciadas para aplicá-la a uma organização.
316* **Tipo**: array de aliases de modelo ou IDs316* **Tipo**: array de aliases ou IDs de modelo
317* **Padrão**: sem definir, então cada modelo está disponível317* **Padrão**: não definido, então todos os modelos estão disponíveis
318 318
319Este exemplo permite que as pessoas selecionem apenas modelos Sonnet e Haiku:319Este exemplo permite que as pessoas selecionem apenas modelos Sonnet e Haiku:
320 320
324}324}
325```325```
326 326
327Uma entrada de ID de modelo como `"claude-opus-5"` também permite versões posteriores que a estendem, como Opus 5.5. Para bloquear uma dessas versões, use [`deniedModels`](#deniedmodels). Para fazer cada entrada de ID de modelo permitir apenas a versão que ela nomeia, use [`availableModelsMatch`](#availablemodelsmatch). Consulte [Restrinja a seleção de modelo](https://code.claude.com/docs/pt/model-config.md#restrict-model-selection). Para IDs de provedores de terceiros, consulte [Fixe modelos para implantações de terceiros](https://code.claude.com/docs/pt/model-config.md#pin-models-for-third-party-deployments).327Uma entrada de ID de modelo como `"claude-opus-5"` também permite versões posteriores que a estendem, como o Opus 5.5. Para bloquear uma dessas versões, use [`deniedModels`](#deniedmodels). Para fazer com que cada entrada de ID de modelo permita apenas a versão que ela nomeia, use [`availableModelsMatch`](#availablemodelsmatch). Consulte [Restringir a seleção de modelos](https://code.claude.com/docs/pt/model-config.md#restrict-model-selection). Para IDs de provedores de terceiros, consulte [Fixar modelos para implantações de terceiros](https://code.claude.com/docs/pt/model-config.md#pin-models-for-third-party-deployments).
328 328
329### `availableModelsMatch`329### `availableModelsMatch`
330 330
331Escolha como as entradas [`availableModels`](#availablemodels) correspondem aos IDs de modelo. Por padrão, uma entrada de ID de modelo também permite versões posteriores que a estendem, então `"claude-opus-5"` permite Opus 5.5. Com `"exact"`, cada entrada de ID de modelo permite apenas a versão que ela nomeia, então uma versão mais nova desse modelo permanece bloqueada até você listá-la. Requer Claude Code v2.1.283 ou posterior.331Escolha como as entradas de [`availableModels`](#availablemodels) correspondem a IDs de modelo. Por padrão, uma entrada de ID de modelo também permite versões posteriores que a estendem, então `"claude-opus-5"` permite o Opus 5.5. Com `"exact"`, cada entrada de ID de modelo permite apenas a versão que ela nomeia, então uma versão mais nova desse modelo permanece bloqueada até que você a liste. Requer Claude Code v2.1.283 ou posterior.
332 332
333* **Escopo**: [`Gerenciado`](#scopes). Claude Code ignora a chave em configurações de usuário, projeto e local e em `--settings`, com um aviso333* **Escopo**: [`Managed`](#scopes). O Claude Code ignora a chave nas configurações de usuário, de projeto e locais e em `--settings`, com um aviso
334* **Tipo**: string, um de:334* **Tipo**: string, um de:
335 * `"prefix"`: uma entrada de ID de modelo permite sua versão e qualquer ID de modelo que a estenda com outro segmento335 * `"prefix"`: uma entrada de ID de modelo permite sua versão e qualquer ID de modelo que a estenda com outro segmento
336 * `"exact"`: uma entrada de ID de modelo permite apenas a versão que ela nomeia, então `"claude-opus-5"` permite Opus 5 mas não `claude-opus-5-5`. Uma entrada como `"claude-opus-4-5"` também permite seu ID de modelo Anthropic datado `claude-opus-4-5-20251101`. Um alias de família como `"opus"` ainda permite toda a família, e entradas `best`, `opusplan` e `default` são ignoradas336 * `"exact"`: uma entrada de ID de modelo permite apenas a versão que ela nomeia, então `"claude-opus-5"` permite o Opus 5, mas não `claude-opus-5-5`. Uma entrada como `"claude-opus-4-5"` também permite seu ID de modelo datado da Anthropic `claude-opus-4-5-20251101`. Um alias de família como `"opus"` ainda permite a família inteira, e as entradas `best`, `opusplan` e `default` são ignoradas
337* **Padrão**: `"prefix"`337* **Padrão**: `"prefix"`
338 338
339Este exemplo permite Opus 5 e Sonnet 5 e nenhuma versão posterior de nenhum deles:339Este exemplo permite o Opus 5 e o Sonnet 5 e nenhuma versão posterior de nenhum deles:
340 340
341```json managed-settings.json theme={null}341```json managed-settings.json theme={null}
342{342{
345}345}
346```346```
347 347
348Com `"exact"`, a opção Padrão também é limitada aos modelos listados sempre que a lista nomeia pelo menos um modelo ou família. Consulte [Bloqueie modelos ou versões específicas](https://code.claude.com/docs/pt/model-config.md#block-specific-models-or-versions).348Com `"exact"`, a opção Default também fica limitada aos modelos listados sempre que a lista nomeia pelo menos um modelo ou família. Consulte [Bloquear modelos ou versões específicos](https://code.claude.com/docs/pt/model-config.md#block-specific-models-or-versions).
349 349
350### `deniedModels`350### `deniedModels`
351 351
352Bloqueie modelos específicos, com ou sem uma lista de permissões [`availableModels`](#availablemodels) e mesmo quando essa lista os permite. Claude Code oculta um modelo bloqueado do seletor `/model`, e o modelo não pode ser selecionado em nenhum lugar onde `availableModels` é aplicado. Uma sessão na opção Padrão também não executa um modelo bloqueado, como [Bloqueie modelos ou versões específicas](https://code.claude.com/docs/pt/model-config.md#block-specific-models-or-versions) descreve. Requer Claude Code v2.1.283 ou posterior.352Bloqueie modelos específicos, com ou sem uma allowlist de [`availableModels`](#availablemodels) e mesmo quando essa lista os permite. O Claude Code oculta um modelo bloqueado do seletor `/model`, e o modelo não pode ser selecionado em nenhum lugar onde `availableModels` é aplicado. Uma sessão na opção Default também não executa um modelo bloqueado, conforme descrito em [Bloquear modelos ou versões específicos](https://code.claude.com/docs/pt/model-config.md#block-specific-models-or-versions). Requer Claude Code v2.1.283 ou posterior.
353 353
354* **Escopo**: [`Gerenciado`](#scopes). Claude Code ignora a chave em configurações de usuário, projeto e local e em `--settings`, com um aviso354* **Escopo**: [`Managed`](#scopes). O Claude Code ignora a chave nas configurações de usuário, de projeto e locais e em `--settings`, com um aviso
355* **Tipo**: array de aliases de modelo ou IDs355* **Tipo**: array de aliases ou IDs de modelo
356 * Um alias de família como `"opus"` bloqueia cada modelo nessa família356 * Um alias de família como `"opus"` bloqueia todos os modelos daquela família
357 * Um ID de modelo como `"claude-opus-5-5"` bloqueia essa versão em cada grafia, incluindo IDs datados e específicos do provedor357 * Um ID de modelo como `"claude-opus-5-5"` bloqueia essa versão em todas as grafias, incluindo IDs datados e específicos de provedores
358 * Um ID de modelo sem versão menor, como `"claude-opus-5"`, também bloqueia versões menores posteriores como Opus 5.5. Escreva `"claude-opus-5-0"` para bloquear apenas Opus 5358 * Um ID de modelo sem versão secundária, como `"claude-opus-5"`, também bloqueia versões secundárias posteriores, como o Opus 5.5. Escreva `"claude-opus-5-0"` para bloquear apenas o Opus 5
359 * Entradas `best`, `opusplan` e `default` são ignoradas359 * As entradas `best`, `opusplan` e `default` são ignoradas
360* **Padrão**: sem definir, então nenhum modelo é bloqueado360* **Padrão**: não definido, então nenhum modelo é bloqueado
361 361
362Este exemplo permite modelos Opus e Sonnet e bloqueia Opus 5.5:362Este exemplo permite modelos Opus e Sonnet e bloqueia o Opus 5.5:
363 363
364```json managed-settings.json theme={null}364```json managed-settings.json theme={null}
365{365{
368}368}
369```369```
370 370
371Consulte [Bloqueie modelos ou versões específicas](https://code.claude.com/docs/pt/model-config.md#block-specific-models-or-versions).371Consulte [Bloquear modelos ou versões específicos](https://code.claude.com/docs/pt/model-config.md#block-specific-models-or-versions).
372 372
373### `effortLevel`373### `effortLevel`
374 374
375Defina um [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) padrão para modelos para os quais você não salvou um nível. Níveis mais baixos são mais rápidos e mais baratos em tarefas diretas, e níveis mais altos raciocinam mais profundamente em problemas complexos.375Defina um [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) padrão para modelos para os quais você não salvou um nível. Níveis mais baixos são mais rápidos e mais baratos em tarefas simples, e níveis mais altos raciocinam com mais profundidade em problemas complexos.
376 376
377Quando você executa `/effort low`, `medium`, `high` ou `xhigh` em uma sessão interativa em sua máquina, Claude Code salva o nível para o modelo ativo em [`modelSettings`](#modelsettings) em vez de escrever essa chave. Antes da v2.1.251, `/effort` escrevia essa chave.377Quando você executa `/effort low`, `medium`, `high` ou `xhigh` em uma sessão interativa na sua máquina, o Claude Code salva o nível para o modelo ativo em [`modelSettings`](#modelsettings) em vez de gravar esta chave. Antes da v2.1.251, `/effort` gravava esta chave.
378 378
379Dentro do mesmo arquivo de configurações, Claude Code usa o nível salvo de um modelo em vez dessa chave. [`modelSettings`](#modelsettings) indica a precedência entre arquivos.379Dentro do mesmo arquivo de configurações, o Claude Code usa o nível salvo de um modelo em vez desta chave. [`modelSettings`](#modelsettings) descreve a precedência entre arquivos.
380 380
381Em uma sessão anexada a um worker remoto, em uma execução `-p` e no Agent SDK, `/effort` se aplica apenas a essa sessão. [Ajuste o nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) lista as escolhas interativas que também se aplicam apenas a essa sessão. A mensagem que `/effort` imprime diz qual aconteceu.381Em uma sessão conectada a um worker remoto, em uma execução `-p` e no Agent SDK, `/effort` se aplica apenas àquela sessão. [Ajustar o nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) lista as escolhas interativas que também se aplicam apenas àquela sessão. A mensagem que `/effort` exibe informa o que aconteceu.
382 382
383* **Escopo**: [`Qualquer arquivo`](#scopes)383* **Escopo**: [`Any file`](#scopes)
384* **Tipo**: string, um de:384* **Tipo**: string, um de:
385 * `"low"`: o mínimo de raciocínio, para tarefas curtas, delimitadas, sensíveis à latência que não são sensíveis à inteligência385 * `"low"`: o mínimo de raciocínio, para tarefas curtas, delimitadas e sensíveis à latência que não dependem de inteligência
386 * `"medium"`: reduz o uso de tokens para trabalho sensível a custos que pode fazer trade-off de alguma inteligência386 * `"medium"`: reduz o uso de tokens para trabalhos sensíveis a custo que podem abrir mão de alguma inteligência
387 * `"high"`: equilibra o uso de tokens e inteligência387 * `"high"`: equilibra uso de tokens e inteligência
388 * `"xhigh"`: raciocínio mais profundo com maior gasto de tokens388 * `"xhigh"`: raciocínio mais profundo com maior gasto de tokens
389* **Padrão**: sem definir389* **Padrão**: não definido
390* **Substituições por sessão**: `--effort` tem precedência sobre essa chave para uma sessão, e [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre ambas390* **Substituições por sessão**: `--effort` tem precedência sobre esta chave para uma sessão, e [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre ambos
391 391
392```json settings.json theme={null}392```json settings.json theme={null}
393{393{
395}395}
396```396```
397 397
398Em suas configurações de usuário, `~/.claude/settings.json`, essa chave é a forma mais antiga que `/effort` escrevia antes de salvar níveis por modelo, e continua se aplicando onde se aplicava antes, em Opus 5, Fable 5.1 e modelos anteriores. Opus 5.5 e modelos lançados após ele a ignoram e começam em seu próprio padrão até você salvar um nível para eles, que `/effort` escreve em [`modelSettings`](#modelsettings). Em configurações de projeto, local e gerenciada, e com `--settings`, essa chave se aplica a cada modelo.398No seu arquivo de configurações de usuário, `~/.claude/settings.json`, esta chave é a forma antiga que `/effort` gravava antes de salvar níveis por modelo, e ela continua se aplicando onde se aplicava antes: no Opus 5, no Fable 5.1 e em modelos anteriores. O Opus 5.5 e os modelos lançados depois dele a ignoram e começam no próprio padrão até que você salve um nível para eles, que `/effort` grava em [`modelSettings`](#modelsettings). Nas configurações de projeto, locais e gerenciadas, e com `--settings`, esta chave se aplica a todos os modelos.
399 399
400### `enforceAvailableModels`400### `enforceAvailableModels`
401 401
402O seletor `/model` tem uma opção **Padrão**, e [`default` model setting](https://code.claude.com/docs/pt/model-config#default-model-setting) descreve o modelo ao qual ela resolve. Uma lista de permissões [`availableModels`](#availablemodels) limita os modelos que você pode nomear, mas com a [correspondência de prefixo](#availablemodelsmatch) padrão ela não remapeia o padrão do seu tipo de conta, então **Padrão** ainda pode resolver para um modelo fora da lista. Esta chave fecha essa lacuna. Requer Claude Code v2.1.175 ou posterior.402O seletor `/model` tem uma opção **Default**, e [configuração de modelo `default`](https://code.claude.com/docs/pt/model-config#default-model-setting) descreve o modelo para o qual ela é resolvida. Uma allowlist de [`availableModels`](#availablemodels) limita os modelos que você pode nomear, mas com a [correspondência por prefixo](#availablemodelsmatch) padrão ela não remapeia o padrão do seu tipo de conta, então **Default** ainda pode ser resolvida para um modelo fora da lista. Esta chave fecha essa lacuna. Requer Claude Code v2.1.175 ou posterior.
403 403
404Quando sua organização implanta qualquer configuração gerenciada, Claude Code lê essa chave apenas da fonte gerenciada e a ignora em seus outros arquivos.404Quando sua organização implanta quaisquer configurações gerenciadas, o Claude Code lê esta chave apenas da fonte gerenciada e a ignora nos seus outros arquivos.
405 405
406Para saber como essa chave se aplica às verificações de modelo na inicialização, consulte [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#when-your-organization-enforces-a-model-allowlist) e [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md#when-your-organization-enforces-a-model-allowlist).406Para saber como esta chave se aplica às verificações de modelo na inicialização, consulte [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md#when-your-organization-enforces-a-model-allowlist) e [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md#when-your-organization-enforces-a-model-allowlist).
407 407
408* **Escopo**: [`Qualquer arquivo`](#scopes)408* **Escopo**: [`Any file`](#scopes)
409* **Tipo**: Boolean409* **Tipo**: Boolean
410 * `true`: quando **Padrão** resolveria para um modelo fora de `availableModels`, Claude Code o resolve para o primeiro modelo disponível na lista410 * `true`: quando **Default** seria resolvida para um modelo fora de `availableModels`, o Claude Code a resolve para o primeiro modelo disponível na lista
411 * `false`: esta chave não muda como **Padrão** resolve411 * `false`: esta chave não altera como **Default** é resolvida
412* **Padrão**: `false`412* **Padrão**: `false`
413 413
414Este exemplo restringe seleções nomeadas a modelos Sonnet e Haiku e faz **Padrão** resolver para o primeiro deles que está disponível:414Este exemplo restringe as seleções nomeadas a modelos Sonnet e Haiku e faz **Default** ser resolvida para o primeiro deles que estiver disponível:
415 415
416```json settings.json theme={null}416```json settings.json theme={null}
417{417{
420}420}
421```421```
422 422
423Esta chave não tem efeito quando `availableModels` está sem definir ou vazio. Consulte [Aplique a lista de permissões ao modelo Padrão](https://code.claude.com/docs/pt/model-config.md#enforce-the-allowlist-for-the-default-model). Requer Claude Code v2.1.175 ou posterior.423Esta chave não tem efeito quando `availableModels` não está definida ou está vazia. Consulte [Aplicar a allowlist ao modelo Default](https://code.claude.com/docs/pt/model-config.md#enforce-the-allowlist-for-the-default-model). Requer Claude Code v2.1.175 ou posterior.
424 424
425### `fallbackModel`425### `fallbackModel`
426 426
427Nomeie modelos de backup para Claude Code tentar, em ordem, quando seu modelo principal está sobrecarregado ou indisponível. Claude Code muda para o próximo modelo disponível na cadeia para o resto da volta e mostra um aviso. Sem uma cadeia, Claude Code tenta novamente o mesmo modelo e depois exibe o erro do servidor, e você tenta novamente ou muda de modelos você mesmo.427Nomeie modelos reserva para o Claude Code tentar, em ordem, quando seu modelo principal estiver sobrecarregado ou indisponível. O Claude Code muda para o próximo modelo disponível na cadeia pelo restante do turno e exibe um aviso. Sem uma cadeia, o Claude Code tenta novamente o mesmo modelo e depois exibe o erro do servidor, e você mesmo tenta novamente ou troca de modelo.
428 428
429Uma mudança significa uma volta com um [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#switching-models) frio no modelo de fallback; sua próxima mensagem tenta o modelo principal primeiro novamente.429Uma troca significa um turno com o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#switching-models) frio no modelo de fallback; sua próxima mensagem tenta primeiro o modelo principal novamente.
430 430
431* **Escopo**: [`Qualquer arquivo`](#scopes)431* **Escopo**: [`Any file`](#scopes)
432* **Tipo**: array de aliases de modelo ou IDs; `"default"` expande para o modelo padrão432* **Tipo**: array de aliases ou IDs de modelo; `"default"` se expande para o modelo padrão
433* **Padrão**: sem definir, então uma solicitação falhada não é tentada novamente em outro modelo433* **Padrão**: não definido, então uma requisição com falha não é tentada novamente em outro modelo
434* **Substituições por sessão**: `--fallback-model` tem precedência sobre essa chave para uma sessão434* **Substituições por sessão**: `--fallback-model` tem precedência sobre esta chave para uma sessão
435 435
436Este exemplo tenta Sonnet 5 primeiro, depois Haiku 4.5, quando seu modelo principal falha:436Este exemplo tenta primeiro o Sonnet 5 e depois o Haiku 4.5 quando seu modelo principal falha:
437 437
438```json settings.json theme={null}438```json settings.json theme={null}
439{439{
441}441}
442```442```
443 443
444Diferentemente da maioria das configurações de array, essa chave não mescla entre arquivos de configurações: o arquivo de maior precedência que a define fornece toda a cadeia. Se seu arquivo de projeto define `["claude-sonnet-5"]` e seu arquivo de usuário define `["claude-haiku-4-5"]`, a cadeia é apenas `["claude-sonnet-5"]`. Claude Code mantém no máximo três modelos distintos permitidos da lista e ignora o resto. Consulte [Cadeias de modelo de fallback](https://code.claude.com/docs/pt/model-config.md#fallback-model-chains).444Ao contrário da maioria das configurações de array, esta chave não é mesclada entre arquivos de configurações: o arquivo de maior precedência que a define fornece a cadeia inteira. Se o seu arquivo de projeto define `["claude-sonnet-5"]` e o seu arquivo de usuário define `["claude-haiku-4-5"]`, a cadeia é apenas `["claude-sonnet-5"]`. O Claude Code mantém no máximo três modelos permitidos distintos da lista e ignora o restante. Consulte [Cadeias de modelos de fallback](https://code.claude.com/docs/pt/model-config.md#fallback-model-chains).
445 445
446### `fastMode`446### `fastMode`
447 447
448Ative o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) para sessões onde está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo onde você quer velocidade a um custo mais alto por token. Você normalmente não edita essa chave manualmente: executar `/fast` escreve `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave. O modo rápido funciona apenas em Opus 5.5, Opus 5 e Opus 4.8: ativá-lo de outro modelo o muda para Opus, e mudar para um modelo não suportado o desativa. Consulte [Mude de modelos enquanto o modo rápido está ativado](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on).448Ative 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. O modo rápido funciona apenas no Opus 5.5, Opus 5 e Opus 4.8: ativá-lo a partir de outro modelo muda você para o Opus, e mudar para um modelo não suportado o desativa. 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).
449 449
450* **Escopo**: [`Qualquer arquivo`](#scopes)450* **Escopo**: [`Any file`](#scopes)
451* **Tipo**: Boolean451* **Tipo**: Boolean
452 * `true`: Claude Code ativa o modo rápido para sessões onde está disponível452 * `true`: o Claude Code ativa o modo rápido em sessões onde ele está disponível
453 * `false`: o modo rápido permanece desativado453 * `false`: o modo rápido permanece desativado
454* **Padrão**: sem definir, então o modo rápido está desativado454* **Padrão**: não definido, então o modo rápido fica desativado
455* **Substituições por sessão**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/pt/env-vars) desativa o modo rápido para uma sessão, e essa chave não pode ativá-lo novamente455* **Substituições por sessão**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/pt/env-vars) desativa o modo rápido para uma sessão, e esta chave não pode reativá-lo
456 456
457```json settings.json theme={null}457```json settings.json theme={null}
458{458{
462 462
463### `fastModePerSessionOptIn`463### `fastModePerSessionOptIn`
464 464
465Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário de uma pessoa, então o modo rápido está ativado no início de cada sessão posterior. Defina essa chave como `true` para parar isso: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, e cada pessoa tem que executar `/fast` em cada sessão que o quer. Claude Code deixa a chave `fastMode` em seu arquivo, então desativar essa chave restaura o comportamento antigo.465Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário da pessoa, então o modo rápido fica ativado no início de todas as sessões seguintes. Defina esta chave como `true` para impedir isso: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, e cada pessoa precisa executar `/fast` em cada sessão em que quiser usá-lo. O Claude Code mantém a chave `fastMode` no arquivo, então desativar esta chave restaura o comportamento anterior.
466 466
467Proprietários em planos Team ou Enterprise podem implantá-lo em toda a organização através de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Quando as configurações gerenciadas definem a chave, `/fast on` é recusado fora de sessões de terminal interativas e relata que sua organização desativou o modo rápido. Isso cobre [modo não interativo](https://code.claude.com/docs/pt/headless.md), a [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) e [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md).467Owners em planos Team ou Enterprise podem implantá-la em toda a organização por meio de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Quando as configurações gerenciadas definem a chave, `/fast on` é recusado fora de sessões interativas no terminal e informa que sua organização desativou o modo rápido. Isso abrange o [modo não interativo](https://code.claude.com/docs/pt/headless.md), a [extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md) e as [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md).
468 468
469* **Escopo**: [`Qualquer arquivo`](#scopes)469* **Escopo**: [`Any file`](#scopes)
470* **Tipo**: Boolean470* **Tipo**: Boolean
471 * `true`: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, então cada pessoa executa `/fast` em cada sessão que o quer; um `fastMode: true` passado com `--settings` ainda conta para essa sessão a menos que as configurações gerenciadas definam essa chave471 * `true`: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, então cada pessoa executa `/fast` em cada sessão em que quiser usá-lo; um `fastMode: true` passado com `--settings` ainda vale para aquela sessão, a menos que as configurações gerenciadas definam esta chave
472 * `false`: um `fastMode: true` salvo ativa o modo rápido no início de cada sessão posterior472 * `false`: um `fastMode: true` salvo ativa o modo rápido no início de todas as sessões seguintes
473* **Padrão**: `false`473* **Padrão**: `false`
474 474
475```json settings.json theme={null}475```json settings.json theme={null}
478}478}
479```479```
480 480
481Consulte [Exija opt-in por sessão](https://code.claude.com/docs/pt/fast-mode.md#require-per-session-opt-in).481Consulte [Exigir ativação por sessão](https://code.claude.com/docs/pt/fast-mode.md#require-per-session-opt-in).
482 482
483### `language`483### `language`
484 484
485Faça Claude responder em um idioma diferente do inglês por padrão. Não há lista fixa para respostas: Claude Code passa o valor verbatim para Claude como uma instrução para sempre responder nesse idioma, então qualquer nome de idioma que Claude possa ler funciona. Claude Code não verifica o valor, então um nome digitado incorretamente chega a Claude como escrito em vez de produzir um erro. O mesmo valor define o idioma para [ditado de voz](https://code.claude.com/docs/pt/voice-dictation.md#change-the-dictation-language), que tem uma lista fixa de [idiomas de ditado suportados](https://code.claude.com/docs/pt/voice-dictation.md#change-the-dictation-language), e para títulos de sessão gerados automaticamente.485Faça o Claude responder por padrão em um idioma diferente do inglês. Não há uma lista fixa para respostas: o Claude Code passa o valor literalmente ao Claude como uma instrução para sempre responder naquele idioma, então qualquer nome de idioma que o Claude consiga ler funciona. O Claude Code não verifica o valor, então um nome com erro de digitação chega ao Claude como foi escrito em vez de gerar um erro. O mesmo valor define o idioma do [ditado por voz](https://code.claude.com/docs/pt/voice-dictation.md#change-the-dictation-language), que tem uma lista fixa de [idiomas de ditado suportados](https://code.claude.com/docs/pt/voice-dictation.md#change-the-dictation-language), e dos títulos de sessão gerados automaticamente.
486 486
487* **Escopo**: [`Qualquer arquivo`](#scopes)487* **Escopo**: [`Any file`](#scopes)
488* **Tipo**: string, qualquer nome de idioma, como `"japanese"`, `"spanish"` ou `"french"`; Claude Code não o valida488* **Tipo**: string, qualquer nome de idioma, como `"japanese"`, `"spanish"` ou `"french"`; o Claude Code não o valida
489* **Padrão**: sem definir; os títulos de sessão então correspondem ao idioma de sua conversa489* **Padrão**: não definido; os títulos de sessão então seguem o idioma da sua conversa
490 490
491```json settings.json theme={null}491```json settings.json theme={null}
492{492{
496 496
497### `maxEffortLevel`497### `maxEffortLevel`
498 498
499Limite o [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) que uma sessão pode usar, deixando níveis mais baixos disponíveis. Qualquer nível mais alto funciona no limite em vez disso, incluindo um de `/effort`, o seletor `/model`, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/pt/env-vars), a frontmatter `effort` de uma skill ou subagente, ou o padrão do próprio modelo. Claude Code aplica o limite em si antes de cada solicitação, então ele se mantém em cada provedor, incluindo Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry. Requer Claude Code v2.1.267 ou posterior.499Limite o [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) que uma sessão pode usar, mantendo os níveis mais baixos disponíveis. Qualquer nível mais alto é executado no limite, incluindo um vindo de `/effort`, do seletor `/model`, de `--effort`, de [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/pt/env-vars), do `effort` no frontmatter de uma skill ou de um subagente, ou do próprio padrão do modelo. O próprio Claude Code aplica o limite antes de cada requisição, então ele vale em todos os provedores, incluindo Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry. Requer Claude Code v2.1.267 ou posterior.
500 500
501* **Escopo**: [`Qualquer arquivo`](#scopes). Implante-o em configurações gerenciadas para aplicá-lo a uma organização. Quando vários escopos definem um limite, o mais baixo se aplica, então um limite definido em um escopo não pode ser aumentado de outro501* **Escopo**: [`Any file`](#scopes). Implante-a em configurações gerenciadas para aplicá-la a uma organização. Quando vários escopos definem um limite, o mais baixo se aplica, então um limite definido em um escopo não pode ser aumentado a partir de outro
502* **Tipo**: string, um de `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Um valor `"max"` não define limite502* **Tipo**: string, um de `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"`. Um valor `"max"` não define limite
503* **Padrão**: sem definir, então nenhum limite se aplica503* **Padrão**: não definido, então nenhum limite se aplica
504* **Limites por modelo**: adicione `maxEffortLevel` à entrada [`modelSettings`](#modelsettings) de um modelo. Essa entrada substitui essa chave apenas para o modelo dentro da fonte de configurações que define ambas, como suas configurações de usuário ou uma [fonte gerenciada](https://code.claude.com/docs/pt/managed-settings.md#how-claude-code-combines-managed-sources). Defina `"max"` lá para isentar o modelo do limite dessa fonte; Claude Code ainda aplica limites de outras fontes504* **Limites por modelo**: adicione `maxEffortLevel` à entrada de um modelo em [`modelSettings`](#modelsettings). Essa entrada substitui esta chave para o modelo apenas dentro da fonte de configurações que define ambas, como suas configurações de usuário ou uma [fonte gerenciada](https://code.claude.com/docs/pt/managed-settings.md#how-claude-code-combines-managed-sources). Defina `"max"` ali para isentar o modelo do limite daquela fonte; o Claude Code ainda aplica limites de outras fontes
505 505
506Este exemplo limita cada modelo a `medium` e isenta Sonnet 4.6:506Este exemplo limita todos os modelos a `medium` e isenta o Sonnet 4.6:
507 507
508```json settings.json theme={null}508```json settings.json theme={null}
509{509{
520 520
521### `model`521### `model`
522 522
523Defina o modelo que cada nova sessão usa, então você não tem que escolher um com `/model` cada vez. Defini-lo aqui não o impede de mudar no meio da sessão. Se seu admin definiu um [modelo padrão da organização](https://code.claude.com/docs/pt/model-config.md#organization-default-model) para substituir a seleção do usuário, você obtém esse modelo mesmo quando define essa chave em configurações de usuário, projeto ou local.523Defina o modelo que toda nova sessão usa, para que você não precise escolher um com `/model` a cada vez. Defini-lo aqui não impede que você troque no meio da sessão. Se o seu administrador definiu um [modelo padrão da organização](https://code.claude.com/docs/pt/model-config.md#organization-default-model) para sobrescrever a seleção do usuário, você recebe esse modelo mesmo quando define esta chave nas configurações de usuário, de projeto ou locais.
524 524
525* **Escopo**: [`Qualquer arquivo`](#scopes)525* **Escopo**: [`Any file`](#scopes)
526* **Tipo**: string, um alias de modelo ou ID de modelo completo526* **Tipo**: string, um alias de modelo ou ID de modelo completo
527* **Padrão**: sem definir, então Claude Code usa o modelo padrão de sua conta527* **Padrão**: não definido, então o Claude Code usa o modelo padrão da sua conta
528* **Substituições por sessão**: `--model` tem precedência sobre [`ANTHROPIC_MODEL`](https://code.claude.com/docs/pt/env-vars), e ambos têm precedência sobre essa chave para uma sessão, incluindo sobre um `model` gerenciado; uma lista [`availableModels`](#availablemodels) ainda se aplica à escolha528* **Substituições por sessão**: `--model` tem precedência sobre [`ANTHROPIC_MODEL`](https://code.claude.com/docs/pt/env-vars), e ambos têm precedência sobre esta chave para uma sessão, inclusive sobre um `model` gerenciado; uma lista [`availableModels`](#availablemodels) ainda se aplica à escolha
529 529
530```json settings.json theme={null}530```json settings.json theme={null}
531{531{
533}533}
534```534```
535 535
536Um valor aqui supera [`ANTHROPIC_DEFAULT_MODEL`](https://code.claude.com/docs/pt/model-config#set-a-default-model-for-new-sessions), que Claude Code usa apenas quando nada mais seleciona um modelo.536Um valor aqui tem precedência sobre [`ANTHROPIC_DEFAULT_MODEL`](https://code.claude.com/docs/pt/model-config#set-a-default-model-for-new-sessions), que o Claude Code usa apenas quando nada mais seleciona um modelo.
537 537
538### `modelOverrides`538### `modelOverrides`
539 539
540Mapeie IDs de modelo Anthropic para IDs de modelo específicos do provedor, como ARNs de perfil de inferência do Amazon Bedrock. Cada entrada do seletor de modelo então usa seu valor mapeado ao chamar a API do provedor. Administradores usam isso em [Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry](https://code.claude.com/docs/pt/model-config.md#override-model-ids-per-version) para rotear cada versão de modelo para um perfil de inferência específico, nome de versão ou implantação para governança, alocação de custos ou roteamento regional.540Mapeie IDs de modelo da Anthropic para IDs de modelo específicos do provedor, como ARNs de perfis de inferência do Amazon Bedrock. Cada entrada do seletor de modelos então usa seu valor mapeado ao chamar a API do provedor. Administradores usam isso no [Amazon Bedrock, no Agent Platform do Google Cloud e no Microsoft Foundry](https://code.claude.com/docs/pt/model-config.md#override-model-ids-per-version) para rotear cada versão de modelo para um perfil de inferência, nome de versão ou implantação específicos, para governança, alocação de custos ou roteamento regional.
541 541
542* **Escopo**: [`Qualquer arquivo`](#scopes)542* **Escopo**: [`Any file`](#scopes)
543* **Tipo**: objeto mapeando ID de modelo para ID de modelo do provedor543* **Tipo**: objeto que mapeia ID de modelo para ID de modelo do provedor
544* **Padrão**: sem definir544* **Padrão**: não definido
545 545
546Este exemplo roteia cada chamada para Opus 4.6 para o perfil de inferência Bedrock nomeado:546Este exemplo roteia todas as chamadas do Opus 4.6 para o perfil de inferência do Bedrock indicado:
547 547
548```json settings.json theme={null}548```json settings.json theme={null}
549{549{
553}553}
554```554```
555 555
556Consulte [Substitua IDs de modelo por versão](https://code.claude.com/docs/pt/model-config.md#override-model-ids-per-version).556Consulte [Sobrescrever IDs de modelo por versão](https://code.claude.com/docs/pt/model-config.md#override-model-ids-per-version).
557 557
558### `modelPicker`558### `modelPicker`
559 559
560Liste os modelos que o seletor `/model` oferece, na ordem que você os escreve e sob rótulos que você escolhe, então o seletor lista os modelos que sua organização executa, após o lineup integrado ou em vez dele. O `model` de cada linha é tomado verbatim, então aceita qualquer coisa que `--model` aceita: um alias como `opus`, um ID de modelo Anthropic ou um ID de formato de provedor para Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry ou um gateway LLM. Requer Claude Code v2.1.242 ou posterior.560Liste os modelos que o seletor `/model` oferece, na ordem em que você os escreve e com os rótulos que você escolher, para que o seletor liste os modelos que sua organização executa, depois da lista integrada ou no lugar dela. O `model` de cada linha é usado literalmente, então aceita qualquer coisa que `--model` aceita: um alias como `opus`, um ID de modelo da Anthropic ou um ID no formato do provedor para Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry ou um gateway de LLM. Requer Claude Code v2.1.242 ou posterior.
561 561
562* **Escopo**: [`Usuário ou gerenciado`](#scopes). Claude Code lê a chave de configurações gerenciadas, `--settings` e configurações de usuário, e a ignora em configurações de projeto e local para que um repositório que você clone não possa rotular novamente o seletor. O maior dos três que define a chave fornece todo o lineup, e Claude Code nunca combina lineups de duas fontes.562* **Escopo**: [`User or managed`](#scopes). O Claude Code lê a chave das configurações gerenciadas, de `--settings` e das configurações de usuário, e a ignora nas configurações de projeto e locais para que um repositório que você clona não possa renomear o seletor. A fonte de maior precedência dentre essas três que define a chave fornece a lista inteira, e o Claude Code nunca combina listas de duas fontes.
563* **Tipo**: objeto com um array `options` de linhas e um Boolean `replaceBuiltInOptions` opcional563* **Tipo**: objeto com um array `options` de linhas e um Boolean opcional `replaceBuiltInOptions`
564* **Padrão**: sem definir, então o seletor mostra o lineup integrado564* **Padrão**: não definido, então o seletor mostra a lista integrada
565 565
566Este exemplo adiciona duas implantações Bedrock após o lineup integrado, sob nomes que sua equipe reconhece:566Este exemplo adiciona duas implantações do Bedrock depois da lista integrada, com nomes que sua equipe reconhece:
567 567
568```json managed-settings.json theme={null}568```json managed-settings.json theme={null}
569{569{
580}580}
581```581```
582 582
583#### Campos para `modelPicker`583#### Campos de `modelPicker`
584 584
585A chave leva dois campos, um para as linhas em si e outro para se elas substituem o lineup integrado ou o adicionam.585A chave aceita dois campos, um para as próprias linhas e outro para indicar se elas substituem a lista integrada ou são adicionadas a ela.
586 586
587| Campo | Tipo | O que faz |587| Campo | Tipo | O que faz |
588| :- | :- | :- |588| :- | :- | :- |
589| `options` | array de linhas, cada uma com um `model` obrigatório e um `label`, `description` e `behavesAs` opcionais | As linhas que o seletor mostra, nesta ordem, exceto que uma linha acinzentada se move para o final. Sem um `label`, Claude Code intitula a linha com o nome integrado para um modelo que conhece, ou o ID do modelo caso contrário, e sem uma `description` escreve uma segunda linha genérica |589| `options` | array de linhas, cada uma com um `model` obrigatório e `label`, `description` e `behavesAs` opcionais | As linhas que o seletor mostra, nesta ordem, exceto que uma linha desabilitada vai para o final. Sem um `label`, o Claude Code dá à linha o nome integrado para um modelo que ele conhece, ou o ID do modelo caso contrário, e sem uma `description` ele escreve uma segunda linha genérica |
590| `replaceBuiltInOptions` | Boolean, padrão `false` | Defina como `true` para mostrar apenas essas linhas, **Padrão** e uma linha para o modelo que a sessão já está usando. Deixe sem definir para adicionar essas linhas após o lineup integrado |590| `replaceBuiltInOptions` | Boolean, padrão `false` | Defina como `true` para mostrar apenas estas linhas, **Default** e uma linha para o modelo que a sessão já está usando. Deixe não definido para adicionar estas linhas depois da lista integrada |
591 591
592Uma entrada em `options` também pode levar um `behavesAs` string opcional ao lado de seu `model`, que requer v2.1.257 ou posterior. Defina-o para o ID de um modelo que sua versão do Claude Code já conhece, como `claude-opus-4-8`, em uma entrada cujo `model` é mais novo que sua versão. Claude Code então aplica as capacidades e padrões de esforço desse modelo conhecido à entrada em vez de tratar seu modelo como desconhecido. O rótulo da entrada e o ID do modelo que Claude Code envia em solicitações não mudam.592Uma entrada em `options` também pode ter uma string opcional `behavesAs` ao lado do seu `model`, o que requer v2.1.257 ou posterior. Defina-a como o ID de um modelo que sua versão do Claude Code já conhece, como `claude-opus-4-8`, em uma entrada cujo `model` seja mais novo que sua versão. O Claude Code então aplica as capacidades e os padrões de esforço desse modelo conhecido à entrada, em vez de tratar seu modelo como desconhecido. O rótulo da entrada e o ID de modelo que o Claude Code envia nas requisições não mudam.
593 593
594Com `replaceBuiltInOptions` ativado, Claude Code oculta todas as outras linhas: o lineup integrado, as linhas que adiciona para entradas [`availableModels`](#availablemodels), os modelos que [descoberta de gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#model-discovery) encontrou e [`ANTHROPIC_CUSTOM_MODEL_OPTION`](https://code.claude.com/docs/pt/model-config#add-a-custom-model-option). Com ele desativado, Claude Code pula um modelo listado que o lineup integrado já cobre. Um rótulo muda o que o seletor mostra, não qual modelo Claude Code executa.594Com `replaceBuiltInOptions` ativado, o Claude Code oculta todas as outras linhas: a lista integrada, as linhas que ele adiciona para entradas de [`availableModels`](#availablemodels), os modelos que a [descoberta do gateway](https://code.claude.com/docs/pt/llm-gateway-protocol.md#model-discovery) encontrou e [`ANTHROPIC_CUSTOM_MODEL_OPTION`](https://code.claude.com/docs/pt/model-config#add-a-custom-model-option). Com ele desativado, o Claude Code pula um modelo listado que a lista integrada já abrange. Um rótulo altera o que o seletor mostra, não qual modelo o Claude Code executa.
595 595
596Uma lista de permissões [`availableModels`](#availablemodels) ainda se aplica a essas linhas. Antes de adicionar um modelo listado à lista de permissões, leia [Comportamento de mesclagem](https://code.claude.com/docs/pt/model-config.md#merge-behavior): um ID de modelo específico estreita a entrada curinga de sua família. Claude Code também verifica cada linha contra a sessão antes de mostrar o seletor:596Uma allowlist de [`availableModels`](#availablemodels) ainda se aplica a estas linhas. Antes de adicionar um modelo listado à allowlist, leia [Comportamento de mesclagem](https://code.claude.com/docs/pt/model-config.md#merge-behavior): um ID de modelo específico restringe a entrada curinga da sua família. O Claude Code também verifica cada linha em relação à sessão antes de mostrar o seletor:
597 597
598* **Descartada**: uma linha que Claude Code não pode servir, como um modelo aposentado ou um modelo ao qual sua organização não tem acesso598* **Removida**: uma linha que o Claude Code não consegue atender, como um modelo descontinuado ou um modelo ao qual sua organização não tem acesso
599* **Acinzentada**: uma linha que você não pode selecionar ainda, mostrada com o motivo599* **Desabilitada**: uma linha que você ainda não pode selecionar, mostrada com o motivo
600* **Nenhuma linha sobrevive**: Claude Code mantém o lineup integrado, filtrado pela lista de permissões como usual600* **Nenhuma linha restante**: o Claude Code mantém a lista integrada, filtrada pela allowlist como de costume
601 601
602Claude Code descarta uma linha que não pode analisar e mantém o resto. Consulte [Corrija um arquivo de configurações quebrado](https://code.claude.com/docs/pt/settings.md#fix-a-broken-settings-file).602O Claude Code descarta uma linha que não consegue interpretar e mantém o restante. Consulte [Corrigir um arquivo de configurações com problemas](https://code.claude.com/docs/pt/settings.md#fix-a-broken-settings-file).
603 603
604### `modelPricing`604### `modelPricing`
605 605
606Relate gastos nas taxas que sua organização paga em vez de preço de lista. Defina-o quando sua organização tem taxas contratadas, então os valores em dólares que os desenvolvedores veem correspondem à sua fatura. Claude Code aplica as taxas em `/usage`, a [linha de status](https://code.claude.com/docs/pt/statusline.md), o `total_cost_usd` do Agent SDK, o limite [`--max-budget-usd`](https://code.claude.com/docs/pt/cli-reference) e a métrica de custo [OpenTelemetry](https://code.claude.com/docs/pt/monitoring-usage.md) e eventos. Você fornece as taxas: Claude Code não as lê de seu contrato ou do Claude Console. Requer Claude Code v2.1.242 ou posterior.606Informe os gastos com as tarifas que sua organização paga em vez do preço de tabela. Defina esta chave quando sua organização tiver tarifas contratadas, para que os valores em dólar que os desenvolvedores veem correspondam à sua fatura. O Claude Code aplica as tarifas em `/usage`, na [linha de status](https://code.claude.com/docs/pt/statusline.md), no `total_cost_usd` do Agent SDK, no limite [`--max-budget-usd`](https://code.claude.com/docs/pt/cli-reference) e na métrica e nos eventos de custo do [OpenTelemetry](https://code.claude.com/docs/pt/monitoring-usage.md). Você fornece as tarifas: o Claude Code não as lê do seu contrato nem do Claude Console. Requer Claude Code v2.1.242 ou posterior.
607 607
608* **Escopo**: [`Gerenciado`](#scopes). Implante a chave através de configurações gerenciadas pelo servidor, uma política MDM, um arquivo `managed-settings.json` ou um [auxiliar de política](https://code.claude.com/docs/pt/managed-settings.md#compute-the-policy-with-a-helper-program). Claude Code a ignora em configurações de usuário, projeto e local, em `--settings` e no Windows no [registro HKCU](https://code.claude.com/docs/pt/managed-settings.md#where-each-mechanism-stores-the-policy) gravável pelo usuário. Com configurações gerenciadas pelo servidor, cada sessão relata custos ao preço de lista até que a [busca de configurações](https://code.claude.com/docs/pt/server-managed-settings.md#fetch-and-caching-behavior) dessa sessão tenha confirmado a configuração. Um aplicativo host que incorpora Claude Code e define [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/pt/env-vars) pode fornecer uma tabela própria através da opção SDK [`managedSettings`](https://code.claude.com/docs/pt/agent-sdk/typescript#options), que Claude Code usa apenas quando nenhuma fonte gerenciada define a chave e apenas em Claude Code v2.1.246 ou posterior.608* **Escopo**: [`Managed`](#scopes). Implante a chave por meio de configurações gerenciadas pelo servidor, uma política de MDM, um arquivo `managed-settings.json` ou um [auxiliar de política](https://code.claude.com/docs/pt/managed-settings.md#compute-the-policy-with-a-helper-program). O Claude Code a ignora nas configurações de usuário, de projeto e locais, em `--settings` e, no Windows, no [registro HKCU](https://code.claude.com/docs/pt/managed-settings.md#where-each-mechanism-stores-the-policy) gravável pelo usuário. Com configurações gerenciadas pelo servidor, cada sessão informa custos pelo preço de tabela até que a [busca de configurações](https://code.claude.com/docs/pt/server-managed-settings.md#fetch-and-caching-behavior) daquela sessão tenha confirmado a configuração. Um aplicativo host que incorpora o Claude Code e define [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/pt/env-vars) pode fornecer sua própria tabela por meio da opção [`managedSettings`](https://code.claude.com/docs/pt/agent-sdk/typescript#options) do SDK, que o Claude Code usa apenas quando nenhuma fonte gerenciada define a chave e apenas no Claude Code v2.1.246 ou posterior.
609* **Tipo**: objeto com um `multiplier` opcional e um mapa `overrides` opcional609* **Tipo**: objeto com um `multiplier` opcional e um mapa `overrides` opcional
610* **Padrão**: sem definir, então Claude Code relata preço de lista a menos que um aplicativo host forneça uma tabela610* **Padrão**: não definido, então o Claude Code informa o preço de tabela, a menos que um aplicativo host forneça uma tabela
611 611
612Defina `multiplier` sozinho para um desconto fixo, `overrides` sozinho para taxas por modelo ou ambos.612Defina apenas `multiplier` para um desconto ou acréscimo fixo, apenas `overrides` para tarifas por modelo, ou ambos.
613 613
614Este exemplo define taxas contratadas para Sonnet 4.6 e depois reduz cada figura, a linha Sonnet incluída, em 15%:614Este exemplo define tarifas contratadas para o Sonnet 4.6 e depois reduz todos os valores, incluindo a linha do Sonnet, em 15%:
615 615
616```json managed-settings.json theme={null}616```json managed-settings.json theme={null}
617{617{
629}629}
630```630```
631 631
632Defina `multiplier` acima de 1, até 10, para marcar cada figura para cima. Uma marcação requer Claude Code v2.1.271 ou posterior. Versões anteriores ignoram um `multiplier` acima de 1 com um aviso e mantêm o resto da configuração.632Defina `multiplier` acima de 1, até 10, para aplicar um acréscimo a todos os valores. Um acréscimo requer Claude Code v2.1.271 ou posterior. Versões anteriores ignoram um `multiplier` acima de 1 com um aviso e mantêm o restante da configuração.
633 633
634Para as etapas, incluindo como confirmar que as taxas estão em vigor, consulte [Relate gastos em suas taxas contratadas](https://code.claude.com/docs/pt/costs.md#report-spend-at-your-contracted-rates).634Para os passos, incluindo como confirmar que as tarifas estão em vigor, consulte [Informar gastos com suas tarifas contratadas](https://code.claude.com/docs/pt/costs.md#report-spend-at-your-contracted-rates).
635 635
636#### Campos para `modelPricing`636#### Campos de `modelPricing`
637 637
638| Campo | Tipo | O que faz |638| Campo | Tipo | O que faz |
639| :- | :- | :- |639| :- | :- | :- |
640| `multiplier` | número maior que 0 e no máximo 10 | Dimensiona cada custo que Claude Code calcula, independentemente de uma linha `overrides` cobri-lo. Abaixo de 1 é um desconto, acima de 1 uma marcação |640| `multiplier` | número maior que 0 e no máximo 10 | Ajusta a escala de todo custo que o Claude Code calcula, esteja ou não coberto por uma linha de `overrides`. Abaixo de 1 é um desconto, acima de 1 um acréscimo |
641| `overrides` | mapa de ID de modelo para um objeto de taxa com `input`, `output`, `cacheRead` e `cacheWrite`, cada um de 0 a 10000 | As taxas USD-por-milhão-de-tokens para esse modelo, todos os quatro obrigatórios. `cacheWrite` cobre tanto gravações de cache de cinco minutos quanto de uma hora. Consulte [Quais modelos uma linha `modelPricing` se aplica a](#which-models-a-modelpricing-row-applies-to) |641| `overrides` | mapa de ID de modelo para um objeto de tarifas com `input`, `output`, `cacheRead` e `cacheWrite`, cada um de 0 a 10000 | As tarifas em USD por milhão de tokens para aquele modelo, todas as quatro obrigatórias. `cacheWrite` abrange gravações de cache de cinco minutos e de uma hora. Consulte [A quais modelos uma linha se aplica](#which-models-a-modelpricing-row-applies-to) |
642 642
643Claude Code usa as taxas de uma linha exatamente como você as escreveu, sem adicionar a sobretaxa do modo rápido ou a [taxa de inferência apenas para EUA](https://platform.claude.com/docs/en/about-claude/pricing). Se você também definir `multiplier`, Claude Code a aplica no topo das taxas da linha. Claude Code descarta uma linha com uma taxa que não pode analisar ou um `multiplier` que não pode analisar e mantém o resto; consulte [Corrija um arquivo de configurações quebrado](https://code.claude.com/docs/pt/settings.md#fix-a-broken-settings-file).643O Claude Code usa as tarifas de uma linha exatamente como você as escreveu, sem adicionar a sobretaxa do modo rápido nem a [tarifa de inferência apenas nos EUA](https://platform.claude.com/docs/en/about-claude/pricing). Se você também definir `multiplier`, o Claude Code o aplica sobre as tarifas da linha. O Claude Code descarta uma linha com uma tarifa que não consegue interpretar, ou um `multiplier` que não consegue interpretar, e mantém o restante; consulte [Corrigir um arquivo de configurações com problemas](https://code.claude.com/docs/pt/settings.md#fix-a-broken-settings-file).
644 644
645#### Quais modelos uma linha `modelPricing` se aplica a645#### A quais modelos uma linha de `modelPricing` se aplica
646 646
647Claude Code decide quais modelos uma linha se aplica a partir da chave da linha:647O Claude Code decide a quais modelos uma linha se aplica com base na chave da linha:
648 648
649* **ID de um modelo integrado**: uma chave que Claude Code usa para um modelo integrado, independentemente de essa chave ser o próprio ID do modelo, como `claude-sonnet-4-6`, ou seu ID Bedrock, Agent Platform ou Foundry. Claude Code aplica a linha a cada ID de snapshot datado e ID específico do provedor desse modelo.649* **O ID de um modelo integrado**: uma chave que o próprio Claude Code usa para um modelo integrado, seja o próprio ID do modelo, como `claude-sonnet-4-6`, ou seu ID no Bedrock, no Agent Platform ou no Foundry. O Claude Code aplica a linha a todos os IDs de snapshot datados e IDs específicos de provedores daquele modelo.
650* **Qualquer outra chave**: uma chave que não é o ID de um modelo integrado, como um alias de modelo de gateway. Claude Code aplica a linha apenas a esse ID. Quando um ID de modelo corresponde exatamente a uma de suas chaves e também se enquadra em uma linha com chave de ID de modelo integrado, Claude Code usa a correspondência exata.650* **Qualquer outra chave**: uma chave que não é o ID de um modelo integrado, como um alias de modelo de gateway. O Claude Code aplica a linha apenas àquele ID. Quando um ID de modelo corresponde exatamente a uma das suas chaves e também se enquadra em uma linha cuja chave é o ID de um modelo integrado, o Claude Code usa a correspondência exata.
651* **Um perfil de inferência de aplicação Bedrock**: uma vez que Claude Code resolveu o perfil para o modelo ao qual roteia, através de seu mapa [`modelOverrides`](#modeloverrides) ou da busca [`bedrock:GetInferenceProfile`](https://code.claude.com/docs/pt/amazon-bedrock#iam-configuration), Claude Code aplica a linha desse modelo ao perfil.651* **Um perfil de inferência de aplicativo do Bedrock**: depois que o Claude Code resolve o perfil para o modelo para o qual ele roteia, por meio do seu mapa [`modelOverrides`](#modeloverrides) ou da [consulta `bedrock:GetInferenceProfile`](https://code.claude.com/docs/pt/amazon-bedrock#iam-configuration), o Claude Code aplica a linha daquele modelo ao perfil.
652 652
653### `modelSettings`653### `modelSettings`
654 654
655Salve um [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) para cada modelo que você usa. Requer Claude Code v2.1.251 ou posterior.655Salve um [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) para cada modelo que você usa. Requer Claude Code v2.1.251 ou posterior.
656 656
657Em uma sessão interativa em sua máquina, quando você salva `low`, `medium`, `high` ou `xhigh` como seu padrão com `/effort` ou o controle deslizante de esforço do seletor `/model`, Claude Code escreve esse nível aqui sob o modelo que você está usando, então você raramente edita essa chave você mesmo. Quando você escolhe um desses níveis no [seletor de modelo da extensão VS Code](https://code.claude.com/docs/pt/vs-code.md#use-the-prompt-box), Claude Code salva-o aqui da mesma forma. A entrada [`effortLevel`](#effortlevel) lista as sessões onde `/effort` se aplica apenas a essa sessão.657Em uma sessão interativa na sua máquina, quando você salva `low`, `medium`, `high` ou `xhigh` como padrão com `/effort` ou com o controle deslizante de esforço do seletor `/model`, o Claude Code grava esse nível aqui sob o modelo que você está usando, então raramente você mesmo edita esta chave. Quando você escolhe um desses níveis no [seletor de modelos da extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md#use-the-prompt-box), o Claude Code o salva aqui da mesma forma. A entrada [`effortLevel`](#effortlevel) lista as sessões em que `/effort` se aplica apenas àquela sessão.
658 658
659Edite a chave manualmente para alterar ou remover um nível que você salvou.659Edite a chave manualmente para alterar ou remover um nível que você salvou.
660 660
661Um `effortLevel` de um modelo aqui tem precedência sobre o [`effortLevel`](#effortlevel) de nível superior no mesmo arquivo de configurações. Entre arquivos, Claude Code resolve cada modelo separadamente: o arquivo de configurações de maior precedência [settings file](https://code.claude.com/docs/pt/settings.md#settings-precedence) que define um `effortLevel` para esse modelo ou o `effortLevel` de nível superior que [se aplica a esse modelo](#effortlevel) decide, então um `effortLevel` em configurações gerenciadas supera um nível que você salvou em configurações de usuário. [Ajuste o nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) lista o que mais pode substituir um nível salvo, como `--effort` no lançamento.661O `effortLevel` de um modelo aqui tem precedência sobre o [`effortLevel`](#effortlevel) de nível superior no mesmo arquivo de configurações. Entre arquivos, o Claude Code resolve cada modelo separadamente: decide o [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#settings-precedence) de maior precedência que define um `effortLevel` para aquele modelo ou um `effortLevel` de nível superior que [se aplica àquele modelo](#effortlevel), então um `effortLevel` em configurações gerenciadas tem precedência sobre um nível que você salvou nas configurações de usuário. [Ajustar o nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) lista o que mais pode sobrescrever um nível salvo, como `--effort` na inicialização.
662 662
663Para limitar o esforço de um modelo em vez de definir seu nível, adicione um campo [`maxEffortLevel`](#maxeffortlevel) à entrada desse modelo. O campo requer Claude Code v2.1.267 ou posterior.663Para limitar o esforço de um modelo em vez de definir seu nível, adicione um campo [`maxEffortLevel`](#maxeffortlevel) à entrada daquele modelo. O campo requer Claude Code v2.1.267 ou posterior.
664 664
665* **Escopo**: [`Qualquer arquivo`](#scopes)665* **Escopo**: [`Any file`](#scopes)
666* **Tipo**: objeto mapeando um nome de modelo para um objeto com qualquer um destes campos:666* **Tipo**: objeto que mapeia um nome de modelo para um objeto com qualquer um destes campos:
667 * `effortLevel`: um de `"low"`, `"medium"`, `"high"` ou `"xhigh"`667 * `effortLevel`: um de `"low"`, `"medium"`, `"high"` ou `"xhigh"`
668 * [`maxEffortLevel`](#maxeffortlevel): o nível de esforço mais alto em que o modelo pode ser executado668 * [`maxEffortLevel`](#maxeffortlevel): o nível de esforço mais alto com que o modelo pode ser executado
669 * `autoCompactWindow`: um número de tokens de `100000` a `1000000`, ou `"auto"` para a janela ajustada para o modelo. [`/autocompact`](https://code.claude.com/docs/pt/model-config#set-the-auto-compact-window) salva aqui. Para esse modelo, o valor tem precedência sobre um [`autoCompactWindow`](#autocompactwindow) de nível superior no mesmo arquivo de configurações. Requer Claude Code v2.1.288 ou posterior669 * `autoCompactWindow`: um número de tokens de `100000` a `1000000`, ou `"auto"` para a janela ajustada para o modelo. [`/autocompact`](https://code.claude.com/docs/pt/model-config#set-the-auto-compact-window) salva aqui. Para aquele modelo, o valor tem precedência sobre um [`autoCompactWindow`](#autocompactwindow) de nível superior no mesmo arquivo de configurações. Requer Claude Code v2.1.288 ou posterior
670* **Padrão**: sem definir670* **Padrão**: não definido
671 671
672Claude Code escreve cada entrada sob o nome canônico do modelo, como `claude-opus-5-5`, e corresponde ao alias desse modelo, com sufixo de data, `[1m]` e IDs específicos do provedor reconhecidos à mesma entrada.672O Claude Code grava cada entrada sob o nome canônico do modelo, como `claude-opus-5-5`, e associa à mesma entrada o alias desse modelo, os IDs com sufixo de data, `[1m]` e os IDs específicos de provedores reconhecidos.
673 673
674Este exemplo mantém Opus 5.5 em `high` enquanto outros modelos usam seus próprios níveis salvos ou padrão:674Este exemplo mantém o Opus 5.5 em `high` enquanto os outros modelos usam seus próprios níveis salvos ou padrão:
675 675
676```json settings.json theme={null}676```json settings.json theme={null}
677{677{
683}683}
684```684```
685 685
686Execute `/effort auto` para limpar seu nível salvo para o modelo que você está usando. Claude Code deixa as outras entradas e qualquer `effortLevel` de nível superior em vigor.686Execute `/effort auto` para limpar o nível salvo para o modelo que você está usando. O Claude Code mantém as outras entradas e qualquer `effortLevel` de nível superior.
687 687
688### `outputStyle`688### `outputStyle`
689 689
690Selecione um [estilo de saída](https://code.claude.com/docs/pt/output-styles.md) por nome. Um estilo de saída é um conjunto salvo de instruções que muda o papel, tom e formato de saída de Claude, como os estilos Explanatory e Learning integrados ou um que você escreveu você mesmo.690Selecione um [estilo de saída](https://code.claude.com/docs/pt/output-styles.md) pelo nome. Um estilo de saída é um conjunto salvo de instruções que altera o papel, o tom e o formato de saída do Claude, como os estilos integrados Explanatory e Learning ou um que você mesmo escreveu.
691 691
692Se você alterar essa chave durante uma sessão, Claude usa o novo estilo começando com sua próxima mensagem. Para o que essa mensagem custa em cache de prompt, consulte [Alterando estilo de saída](https://code.claude.com/docs/pt/prompt-caching.md#changing-output-style). Antes da v2.1.251, a edição se aplicava apenas depois que você executava `/clear` ou iniciava uma nova sessão.692Se você alterar esta chave durante uma sessão, o Claude usa o novo estilo a partir da sua próxima mensagem. Para saber quanto essa mensagem custa em cache de prompt, consulte [Alterar o estilo de saída](https://code.claude.com/docs/pt/prompt-caching.md#changing-output-style). Antes da v2.1.251, a alteração só se aplicava depois que você executava `/clear` ou iniciava uma nova sessão.
693 693
694* **Escopo**: [`Qualquer arquivo`](#scopes)694* **Escopo**: [`Any file`](#scopes)
695* **Tipo**: string, o nome de um estilo de saída [integrado](https://code.claude.com/docs/pt/output-styles.md#built-in-output-styles) ou [personalizado](https://code.claude.com/docs/pt/output-styles.md#create-a-custom-output-style)695* **Tipo**: string, o nome de um estilo de saída [integrado](https://code.claude.com/docs/pt/output-styles.md#built-in-output-styles) ou [personalizado](https://code.claude.com/docs/pt/output-styles.md#create-a-custom-output-style)
696* **Padrão**: sem definir, então Claude Code usa o estilo padrão696* **Padrão**: não definido, então o Claude Code usa o estilo padrão
697 697
698Este exemplo seleciona o estilo Explanatory integrado, que adiciona insights educacionais entre tarefas:698Este exemplo seleciona o estilo integrado Explanatory, que adiciona insights educacionais entre as tarefas:
699 699
700```json settings.json theme={null}700```json settings.json theme={null}
701{701{
705 705
706### `promptCacheTtl`706### `promptCacheTtl`
707 707
708Escolha quanto tempo o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md) mantém a conversa principal. Esta chave se aplica a suas voltas interativas, `-p` e Agent SDK, juntamente com os auxiliares que Claude Code executa inline com elas. A vida útil de uma hora mantém o cache aquecido entre pausas mais longas, e a API [cobra cada gravação de cache a uma taxa mais alta](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) do que na vida útil de cinco minutos. Requer Claude Code v2.1.242 ou posterior.708Escolha por quanto tempo o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md) mantém a conversa principal. Esta chave se aplica aos seus turnos interativos, `-p` e do Agent SDK, junto com os auxiliares que o Claude Code executa em linha com eles. A duração de uma hora mantém o cache aquecido durante pausas mais longas, e a API [cobra cada gravação de cache a uma tarifa mais alta](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) do que na duração de cinco minutos. Requer Claude Code v2.1.242 ou posterior.
709 709
710* **Escopo**: [`Qualquer arquivo`](#scopes)710* **Escopo**: [`Any file`](#scopes)
711* **Tipo**: string, um de:711* **Tipo**: string, um de:
712 * `"5m"`: o cache se mantém por cinco minutos712 * `"5m"`: o cache dura cinco minutos
713 * `"1h"`: o cache se mantém por uma hora713 * `"1h"`: o cache dura uma hora
714* **Padrão**: sem definir, então cada solicitação de conversa principal obtém [sua vida útil padrão](https://code.claude.com/docs/pt/prompt-caching.md#which-ttl-each-request-gets)714* **Padrão**: não definido, então cada requisição da conversa principal recebe [sua duração padrão](https://code.claude.com/docs/pt/prompt-caching.md#which-ttl-each-request-gets)
715* **Substituições por sessão**: [`FORCE_PROMPT_CACHING_5M`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre tudo mais, depois [`CLAUDE_CODE_PROMPT_CACHE_TTL`](https://code.claude.com/docs/pt/env-vars), depois essa chave e por último [`ENABLE_PROMPT_CACHING_1H`](https://code.claude.com/docs/pt/env-vars)715* **Substituições por sessão**: [`FORCE_PROMPT_CACHING_5M`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre todo o resto, depois [`CLAUDE_CODE_PROMPT_CACHE_TTL`](https://code.claude.com/docs/pt/env-vars), depois esta chave e, por último, [`ENABLE_PROMPT_CACHING_1H`](https://code.claude.com/docs/pt/env-vars)
716 716
717Este exemplo mantém a conversa principal na vida útil de uma hora e deixa subagentes em cinco minutos:717Este exemplo mantém a conversa principal na duração de uma hora e deixa os subagentes em cinco minutos:
718 718
719```json settings.json theme={null}719```json settings.json theme={null}
720{720{
723}723}
724```724```
725 725
726Para o que cada vida útil custa, consulte [Vida útil do cache](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime).726Para saber quanto custa cada duração, consulte [Duração do cache](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime).
727 727
728### `showThinkingSummaries`728### `showThinkingSummaries`
729 729
730Veja resumos do [pensamento estendido](https://code.claude.com/docs/pt/model-config.md#extended-thinking) de Claude em sessões interativas. Defina-o se você quer os resumos completos quando expande o pensamento com `Ctrl+O`. Quando sem definir ou `false`, a API Anthropic redige blocos de pensamento e Claude Code mostra um stub recolhido.730Veja resumos do [pensamento estendido](https://code.claude.com/docs/pt/model-config.md#extended-thinking) do Claude em sessões interativas. Defina esta chave se quiser os resumos completos ao expandir o pensamento com `Ctrl+O`. Quando não definida ou `false`, a API da Anthropic oculta os blocos de pensamento e o Claude Code mostra um resumo recolhido.
731 731
732* **Escopo**: [`Qualquer arquivo`](#scopes)732* **Escopo**: [`Any file`](#scopes)
733* **Tipo**: Boolean733* **Tipo**: Boolean
734 * `true`: você vê resumos completos de pensamento quando expande o pensamento com `Ctrl+O`734 * `true`: você vê os resumos completos de pensamento ao expandir o pensamento com `Ctrl+O`
735 * `false`: a API Anthropic redige blocos de pensamento e Claude Code mostra um stub recolhido735 * `false`: a API da Anthropic oculta os blocos de pensamento e o Claude Code mostra um resumo recolhido
736* **Padrão**: `false`736* **Padrão**: `false`
737 737
738```json settings.json theme={null}738```json settings.json theme={null}
741}741}
742```742```
743 743
744A redação muda apenas o que você vê, não o que o modelo gera. Para reduzir o gasto de pensamento, [reduza o orçamento ou desative o pensamento](https://code.claude.com/docs/pt/model-config.md#extended-thinking) em vez disso.744A ocultação altera apenas o que você vê, não o que o modelo gera. Para reduzir o gasto com pensamento, [reduza o orçamento ou desative o pensamento](https://code.claude.com/docs/pt/model-config.md#extended-thinking).
745 745
746### `subagentPromptCacheTtl`746### `subagentPromptCacheTtl`
747 747
748Escolha quanto tempo o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md) mantém as solicitações que Claude Code faz fora da conversa principal. Esta chave se aplica a [subagentes](https://code.claude.com/docs/pt/sub-agents.md), [workflows](https://code.claude.com/docs/pt/workflows.md) e as próprias solicitações de background e auxiliar de Claude Code, como compactação e títulos de sessão. A vida útil de uma hora mantém o cache aquecido entre pausas mais longas, e a API [cobra cada gravação de cache a uma taxa mais alta](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) do que na vida útil de cinco minutos. Requer Claude Code v2.1.242 ou posterior.748Escolha por quanto tempo o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md) mantém as requisições que o Claude Code faz fora da conversa principal. Esta chave se aplica a [subagentes](https://code.claude.com/docs/pt/sub-agents.md), [fluxos de trabalho](https://code.claude.com/docs/pt/workflows.md) e às próprias requisições em segundo plano e auxiliares do Claude Code, como compactação e títulos de sessão. A duração de uma hora mantém o cache aquecido durante pausas mais longas, e a API [cobra cada gravação de cache a uma tarifa mais alta](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) do que na duração de cinco minutos. Requer Claude Code v2.1.242 ou posterior.
749 749
750* **Escopo**: [`Qualquer arquivo`](#scopes)750* **Escopo**: [`Any file`](#scopes)
751* **Tipo**: string, um de:751* **Tipo**: string, um de:
752 * `"5m"`: o cache se mantém por cinco minutos752 * `"5m"`: o cache dura cinco minutos
753 * `"1h"`: o cache se mantém por uma hora753 * `"1h"`: o cache dura uma hora
754* **Padrão**: sem definir, então cada uma dessas solicitações obtém [sua vida útil padrão](https://code.claude.com/docs/pt/prompt-caching.md#which-ttl-each-request-gets)754* **Padrão**: não definido, então cada uma dessas requisições recebe [sua duração padrão](https://code.claude.com/docs/pt/prompt-caching.md#which-ttl-each-request-gets)
755* **Substituições por sessão**: [`FORCE_PROMPT_CACHING_5M`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre tudo mais, depois [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](https://code.claude.com/docs/pt/env-vars), depois essa chave, depois [`ENABLE_PROMPT_CACHING_1H`](https://code.claude.com/docs/pt/env-vars), que pede a vida útil de uma hora em cada solicitação. Para onde o valor de frontmatter próprio de um subagente se classifica, consulte [Escolha o TTL você mesmo](https://code.claude.com/docs/pt/prompt-caching.md#choose-the-ttl-yourself)755* **Substituições por sessão**: [`FORCE_PROMPT_CACHING_5M`](https://code.claude.com/docs/pt/env-vars) tem precedência sobre todo o resto, depois [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](https://code.claude.com/docs/pt/env-vars), depois esta chave, depois [`ENABLE_PROMPT_CACHING_1H`](https://code.claude.com/docs/pt/env-vars), que solicita a duração de uma hora em todas as requisições. Para saber onde se posiciona o valor no frontmatter do próprio subagente, consulte [Escolher o TTL você mesmo](https://code.claude.com/docs/pt/prompt-caching.md#choose-the-ttl-yourself)
756 756
757Este exemplo dá aos subagentes e às outras solicitações fora da conversa principal a vida útil de uma hora:757Este exemplo dá aos subagentes e às outras requisições fora da conversa principal a duração de uma hora:
758 758
759```json settings.json theme={null}759```json settings.json theme={null}
760{760{
762}762}
763```763```
764 764
765Esta chave cobre as solicitações que [`promptCacheTtl`](#promptcachettl) não cobre, então defina ambas para escolher uma vida útil para cada solicitação que Claude Code faz. Para como o cache de um subagente difere do cache da conversa principal, consulte [Subagentes e o cache](https://code.claude.com/docs/pt/prompt-caching.md#subagents-and-the-cache).765Esta chave abrange as requisições que [`promptCacheTtl`](#promptcachettl) não abrange, então defina ambas para escolher uma duração para todas as requisições que o Claude Code faz. Para saber como o cache de um subagente difere do da conversa principal, consulte [Subagentes e o cache](https://code.claude.com/docs/pt/prompt-caching.md#subagents-and-the-cache).
766 766
767### `switchModelsOnFlag`767### `switchModelsOnFlag`
768 768
769Escolha o que acontece quando um [classificador de segurança sinaliza uma solicitação](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback): mude para o modelo de fallback e continue, ou pause para que você possa escolher entre mudar e editar o prompt.769Escolha o que acontece quando um [classificador de segurança sinaliza uma requisição](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback): mudar para o modelo de fallback e continuar, ou pausar para que você possa escolher entre mudar e editar o prompt.
770 770
771* **Escopo**: [`Qualquer arquivo`](#scopes). Aparece em `/config` como **Switch models when a message is flagged**, com as opções **Switch automatically** e **Ask each time**.771* **Escopo**: [`Any file`](#scopes). Aparece em `/config` como **Switch models when a message is flagged**, com as opções **Switch automatically** e **Ask each time**.
772* **Tipo**: Boolean772* **Tipo**: Boolean
773 * `true`: Claude Code muda para o modelo de fallback e continua773 * `true`: o Claude Code muda para o modelo de fallback e continua
774 * `false`: em uma sessão interativa Claude Code pausa para que você possa escolher entre mudar e editar o prompt; onde nenhum diálogo pode mostrar, como uma execução `-p`, a solicitação sinalizada termina como um erro774 * `false`: em uma sessão interativa, o Claude Code pausa para que você possa escolher entre mudar e editar o prompt; onde nenhuma caixa de diálogo pode ser exibida, como em uma execução `-p`, a requisição sinalizada termina com um erro
775* **Padrão**: sem definir. Claude Code muda automaticamente, embora possa [perguntar primeiro](https://code.claude.com/docs/pt/model-config.md#ask-before-switching) em uma sessão interativa775* **Padrão**: não definido. O Claude Code muda automaticamente, embora possa [perguntar primeiro](https://code.claude.com/docs/pt/model-config.md#ask-before-switching) em uma sessão interativa
776 776
777```json settings.json theme={null}777```json settings.json theme={null}
778{778{
780}780}
781```781```
782 782
783Consulte [Pergunte antes de mudar](https://code.claude.com/docs/pt/model-config.md#ask-before-switching).783Consulte [Perguntar antes de mudar](https://code.claude.com/docs/pt/model-config.md#ask-before-switching).
784 784
785### `ultracode`785### `ultracode`
786 786
787Inicie sessões com [ultracode](https://code.claude.com/docs/pt/workflows.md#let-claude-decide-with-ultracode) ativado. Com ele ativado, Claude planeja um workflow para cada tarefa substancial em vez de esperar você pedir. Claude planeja workflows apenas quando [workflows dinâmicos](https://code.claude.com/docs/pt/workflows.md) estão habilitados para você e seu modelo suporta esforço `xhigh`. A chave não muda o nível de esforço da sessão: ultracode funciona em qualquer nível que a sessão usa. Claude Code lê essa chave mas nunca a escreve: `/effort ultracode` ativa ultracode apenas para a sessão atual.787Inicie sessões com o [ultracode](https://code.claude.com/docs/pt/workflows.md#let-claude-decide-with-ultracode) ativado. Com ele ativado, o Claude planeja um fluxo de trabalho para cada tarefa substancial em vez de esperar que você peça. O Claude planeja fluxos de trabalho apenas quando os [fluxos de trabalho dinâmicos](https://code.claude.com/docs/pt/workflows.md) estão habilitados para você e seu modelo suporta o esforço `xhigh`. A chave não altera o nível de esforço da sessão: o ultracode é executado no nível que a sessão usa. O Claude Code lê esta chave, mas nunca a grava: `/effort ultracode` ativa o ultracode apenas para a sessão atual.
788 788
789* **Escopo**: [`Qualquer arquivo`](#scopes)789* **Escopo**: [`Any file`](#scopes)
790* **Tipo**: Boolean790* **Tipo**: Boolean
791 * `true`: sessões começam com ultracode ativado quando workflows dinâmicos estão habilitados para você e seu modelo suporta `xhigh`791 * `true`: as sessões começam com o ultracode ativado quando os fluxos de trabalho dinâmicos estão habilitados para você e seu modelo suporta `xhigh`
792 * `false`: sessões começam com ultracode desativado792 * `false`: as sessões começam com o ultracode desativado
793* **Padrão**: sem definir, então ultracode está desativado793* **Padrão**: não definido, então o ultracode fica desativado
794* **Substituições por sessão**: `/effort ultracode` ativa ultracode para uma sessão sem essa chave, e `/effort ultracode off` o desativa para uma sessão quando essa chave é `true`. A flag `--effort ultracode` também o ativa para uma sessão, em esforço `xhigh`794* **Substituições por sessão**: `/effort ultracode` ativa o ultracode para uma sessão sem esta chave, e `/effort ultracode off` o desativa para uma sessão quando esta chave é `true`. A flag `--effort ultracode` também o ativa para uma sessão, com esforço `xhigh`
795 795
796```json settings.json theme={null}796```json settings.json theme={null}
797{797{
799}799}
800```800```
801 801
802O nível de esforço da sessão vem de [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings) e as outras [fontes de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level), e um [limite de esforço](https://code.claude.com/docs/pt/model-config.md#organization-effort-limits) como [`maxEffortLevel`](#maxeffortlevel) reduz esse nível sem desativar ultracode. Isso e a forma `/effort ultracode off` requerem Claude Code v2.1.284 ou posterior. Antes da v2.1.284, `ultracode: true` executava a sessão em esforço `xhigh`, e um limite de esforço abaixo de `xhigh` mantinha ultracode desativado. Uma solicitação de controle `apply_flag_settings` do Agent SDK também aceita a chave.802O nível de esforço da sessão vem de [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings) e das outras [fontes de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level), e um [limite de esforço](https://code.claude.com/docs/pt/model-config.md#organization-effort-limits) como [`maxEffortLevel`](#maxeffortlevel) reduz esse nível sem desativar o ultracode. Isso e a forma `/effort ultracode off` requerem Claude Code v2.1.284 ou posterior. Antes da v2.1.284, `ultracode: true` executava a sessão com esforço `xhigh`, e um limite de esforço abaixo de `xhigh` mantinha o ultracode desativado. Uma requisição de controle `apply_flag_settings` do Agent SDK também aceita a chave.
803 803
804## Configurações de permissão804## Configurações de permissão
805 805
2424 2424
2425A compactação em ociosidade fica ativada por padrão para conversas que atendem a todas estas condições:2425A compactação em ociosidade fica ativada por padrão para conversas que atendem a todas estas condições:
2426 2426
2427* **Sessão**: você está em uma sessão interativa no terminal, ou no painel de chat da extensão do VS Code ou na aba Code do aplicativo desktop em uma [conta selecionada pela Anthropic](#idle-compaction-in-vs-code-and-the-desktop-app)2427* **Sessão**: você está em uma sessão interativa no terminal, no painel de chat da extensão do VS Code ou na aba Code do aplicativo desktop quando a sessão é executada na sua máquina ou via SSH
2428* **Compactação automática**: [`autoCompactEnabled`](#autocompactenabled) está ativada2428* **Compactação automática**: [`autoCompactEnabled`](#autocompactenabled) está ativada
2429* **Cache de prompt**: a conversa está no [TTL de cache de prompt de uma hora](https://code.claude.com/docs/pt/prompt-caching.md#which-ttl-each-request-gets)2429* **Cache de prompt**: a conversa está no [TTL de cache de prompt de uma hora](https://code.claude.com/docs/pt/prompt-caching.md#which-ttl-each-request-gets)
2430* **Feature flags**: o Claude Code consegue [buscar feature flags da Anthropic](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching)2430* **Feature flags**: o Claude Code consegue [buscar feature flags da Anthropic](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching)
2431* **Tamanho**: o contexto da conversa atingiu o limite de tokens, que você pode [alterar](#change-the-idle-compaction-threshold) a partir do padrão de 200.0002431* **Tamanho**: o contexto da conversa atingiu o limite de tokens, que você pode [alterar](#change-the-idle-compaction-threshold) a partir do padrão de 200.000
2432* **Tempo ocioso**: passaram-se cerca de 54 minutos desde a última requisição, e seu computador está ativo nesse momento2432* **Tempo ocioso**: passou-se cerca de uma hora desde a última requisição, e seu computador permanece ativo até lá
2433 2433
2434Para desativar a compactação em ociosidade, defina esta chave como `false`.2434Para desativar a compactação em ociosidade, defina esta chave como `false`.
2435 2435
2475Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json2475Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json
2476```2476```
2477 2477
2478Você não precisa fazer nada. Para desativar a compactação em ociosidade, defina `idleCompaction` como `false` em `~/.claude/settings.json` ou em outro [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#settings-files-and-who-they-affect).2478Você não precisa fazer nada. Para desativar a compactação em ociosidade, defina `idleCompaction` como `false` em `~/.claude/settings.json` na máquina ou na distribuição WSL onde a sessão é executada, ou em outro [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#settings-files-and-who-they-affect).
2479
2480No painel de chat da extensão do VS Code e na aba Code do aplicativo desktop, a compactação em ociosidade é executada para contas selecionadas pela Anthropic. O Claude Code escreve o resumo enquanto você está ausente e só compacta com ele se sua próxima mensagem chegar uma hora ou mais depois da última requisição.
2481 2479
2482### `plansDirectory`2480### `plansDirectory`
2483 2481
5173 5171
5174### `forceLoginMethod`5172### `forceLoginMethod`
5175 5173
5176Restrinja 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. Se você o definir como `"claudeai"` ou `"console"` 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.5174Restrinja 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.
5175
5176Se 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.
5177 5177
5178* **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.5178* **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.
5179* **Tipo**: string, um de:5179* **Tipo**: string, um de:
5585| Listas de restrição | Pega a lista inteira da fonte mais alta que a define, sem adicionar entradas de fontes inferiores. Quando a fonte mais alta não define uma, pega inteira da próxima fonte abaixo | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) e a cadeia [`fallbackModel`](#fallbackmodel) |5585| Listas de restrição | Pega a lista inteira da fonte mais alta que a define, sem adicionar entradas de fontes inferiores. Quando a fonte mais alta não define uma, pega inteira da próxima fonte abaixo | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) e a cadeia [`fallbackModel`](#fallbackmodel) |
5586| Valores tomados inteiros | Pega o valor inteiro da fonte mais alta que o define, sem combinar entradas ou campos de fontes inferiores. Quando a fonte mais alta não o define, pega inteiro da próxima fonte abaixo | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |5586| Valores tomados inteiros | Pega o valor inteiro da fonte mais alta que o define, sem combinar entradas ou campos de fontes inferiores. Quando a fonte mais alta não o define, pega inteiro da próxima fonte abaixo | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |
5587| Servidores MCP fornecidos | Combina os nomes de servidor de todas as fontes. Quando duas fontes definem o mesmo nome, aplica a entrada inteira da fonte mais alta | [`managedMcpServers`](#managedmcpservers) |5587| Servidores MCP fornecidos | Combina os nomes de servidor de todas as fontes. Quando duas fontes definem o mesmo nome, aplica a entrada inteira da fonte mais alta | [`managedMcpServers`](#managedmcpservers) |
5588| Lê apenas da fonte de prioridade mais alta | Lê a chave apenas da fonte de prioridade mais alta que carrega uma chave de política, então o valor de uma fonte inferior é ignorado mesmo quando a fonte mais alta não define nenhum | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), os valores `"claudeai"` e `"console"` de [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |5588| Lê apenas da fonte de prioridade mais alta | Lê a chave apenas da fonte de prioridade mais alta que carrega uma chave de política, então o valor de uma fonte inferior é ignorado mesmo quando a fonte mais alta não define nenhum | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |
5589| `env` | [Mescla por variável em fontes de administrador](https://code.claude.com/docs/pt/managed-settings.md#keys-read-from-every-admin-source), sob ambos `"first-wins"` e `"merge"` | [`env`](#env) |5589| `env` | [Mescla por variável em fontes de administrador](https://code.claude.com/docs/pt/managed-settings.md#keys-read-from-every-admin-source), sob ambos `"first-wins"` e `"merge"` | [`env`](#env) |
5590| Todas as outras chaves | Pega o valor da fonte mais alta que o define | [`cleanupPeriodDays`](#cleanupperioddays), [`model`](#model) |5590| Todas as outras chaves | Pega o valor da fonte mais alta que o define | [`cleanupPeriodDays`](#cleanupperioddays), [`model`](#model) |
5591 5591
5596* **[`policyHelper`](#policyhelper)**: Claude Code a honra apenas quando a fonte mais alta que carrega uma chave de política é uma política MDM ou um arquivo de configurações gerenciadas, então sob configurações gerenciadas pelo servidor ela não se aplica.5596* **[`policyHelper`](#policyhelper)**: Claude Code a honra apenas quando a fonte mais alta que carrega uma chave de política é uma política MDM ou um arquivo de configurações gerenciadas, então sob configurações gerenciadas pelo servidor ela não se aplica.
5597* **[`modelOverrides`](#modeloverrides)**: emparelha com `availableModels`. Claude Code pega `modelOverrides` da fonte mais alta que a define, a menos que uma fonte mais alta defina `availableModels` sem `modelOverrides`. Nesse caso, ele ignora `modelOverrides` de todas as fontes.5597* **[`modelOverrides`](#modeloverrides)**: emparelha com `availableModels`. Claude Code pega `modelOverrides` da fonte mais alta que a define, a menos que uma fonte mais alta defina `availableModels` sem `modelOverrides`. Nesse caso, ele ignora `modelOverrides` de todas as fontes.
5598* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) e o valor `"gateway"` de [`forceLoginMethod`](#forceloginmethod)**: Claude Code nunca lê nenhum deles de configurações gerenciadas pelo servidor, então um valor lá não se aplica nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. Entre as fontes de administrador na máquina, apenas a fonte classificada mais alta que carrega uma chave de política as fornece, independentemente de configurações gerenciadas pelo servidor também estarem presentes.5598* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) e o valor `"gateway"` de [`forceLoginMethod`](#forceloginmethod)**: Claude Code nunca lê nenhum deles de configurações gerenciadas pelo servidor, então um valor lá não se aplica nem oculta um definido em uma política MDM ou arquivo de configurações gerenciadas. Entre as fontes de administrador na máquina, apenas a fonte classificada mais alta que carrega uma chave de política as fornece, independentemente de configurações gerenciadas pelo servidor também estarem presentes.
5599* **[`forceLoginOrgUUID`](#forceloginorguuid) e os valores `"claudeai"` e `"console"` de [`forceLoginMethod`](#forceloginmethod)**: consulte qual valor se aplica em [Qual fonte gerenciada fornece as chaves de login](https://code.claude.com/docs/pt/managed-settings.md#which-managed-source-supplies-login-keys) em vez de na tabela.
5599* **[`allowedProviders`](#allowedproviders)**: após a regra da tabela, a lista da própria máquina ainda limita o resultado, conforme a nota de Escopo da entrada afirma.5600* **[`allowedProviders`](#allowedproviders)**: após a regra da tabela, a lista da própria máquina ainda limita o resultado, conforme a nota de Escopo da entrada afirma.
5600 5601
5601Para confirmar quais fontes se combinaram em uma máquina, execute `/status` e [leia a linha `Setting sources`](https://code.claude.com/docs/pt/managed-settings#read-the-source-in-/status).5602Para confirmar quais fontes se combinaram em uma máquina, execute `/status` e [leia a linha `Setting sources`](https://code.claude.com/docs/pt/managed-settings#read-the-source-in-/status).
