405| Escopo | Arquivo | Quem afeta | Use para |405| Escopo | Arquivo | Quem afeta | Use para |
406| :- | :- | :- | :- |406| :- | :- | :- | :- |
407| Usuário | `~/.claude/settings.json` | Você, em cada projeto nesta máquina | Preferências pessoais: tema, modo de editor, modelo padrão, suas próprias regras de permissão |407| Usuário | `~/.claude/settings.json` | Você, em cada projeto nesta máquina | Preferências pessoais: tema, modo de editor, modelo padrão, suas próprias regras de permissão |
408| Projeto compartilhado | `.claude/settings.json` | Todos trabalhando na pasta que o contém. Em um repositório git, confirme-o para que os colegas de equipe o obtenham | Permissões de equipe, hooks, plugins e as variáveis de ambiente que o projeto precisa |408| Projeto compartilhado | `.claude/settings.json` | Todos trabalhando na pasta que o contém. Em um repositório git, faça commit dele para que os colegas de equipe o obtenham | Permissões de equipe, hooks, plugins e as variáveis de ambiente que o projeto precisa |
409| Projeto local | `.claude/settings.local.json` | Você, apenas neste projeto. O Claude Code o mantém fora do git quando cria o arquivo; se você o criar manualmente, adicione-o ao `.gitignore` você mesmo | Substituições pessoais para um projeto e testes antes de compartilhar |409| Projeto local | `.claude/settings.local.json` | Você, apenas neste projeto. O Claude Code o mantém fora do git quando cria o arquivo; se você o criar manualmente, adicione-o ao `.gitignore` você mesmo | Substituições pessoais para um projeto e testes antes de compartilhar |
410| Gerenciado | `managed-settings.json` e outros [mecanismos de entrega](/docs/pt/managed-settings#delivery-mechanisms) | Todos em sua organização para os quais é implantado; nada que você defina o substitui, exceto algumas [exceções sensíveis à segurança](#exceptions-to-managed-settings-precedence) | Política de segurança e requisitos de conformidade |410| Gerenciado | `managed-settings.json` e outras [fontes gerenciadas](/docs/pt/managed-settings#delivery-mechanisms) | Todos para os quais sua organização o implanta; [Precedência de configurações](#settings-precedence) diz o que pode sobrescrevê-lo | Política de segurança e requisitos de conformidade |
411 411
412Na coluna Arquivo, `~/.claude` é a pasta `.claude` no seu diretório home, e um `.claude` simples é a pasta `.claude` dentro do seu projeto.412Na coluna Arquivo, `~/.claude` é a pasta `.claude` no seu diretório home, e um `.claude` simples é a pasta `.claude` dentro do seu projeto.
413 413
419 Compare o escopo de cada arquivo de configurações419 Compare o escopo de cada arquivo de configurações
420</h3>420</h3>
421 421
422Suponha que você tenha três projetos em sua máquina, `website/`, `api/` e `acme-app/`, um colega de equipe tenha seu próprio clone de `acme-app/` e você inicie uma [sessão em nuvem](#settings-in-cloud-sessions) em `acme-app/`.422Suponha que você tenha três projetos em sua máquina, `website/`, `api/` e `acme-app/`, um colega de equipe tenha seu próprio clone de `acme-app/` e você inicie uma [sessão na nuvem](#settings-in-cloud-sessions) em `acme-app/`.
423 423
424O gráfico abaixo mostra em quais dessas pastas uma configuração se aplica quando você inicia o Claude Code a partir delas. Clique em um arquivo de configurações para ver as pastas que ele alcança.424O gráfico abaixo mostra em quais dessas pastas uma configuração se aplica quando você inicia o Claude Code a partir delas. Clique em um arquivo de configurações para ver as pastas que ele alcança.
425 425
426<SettingsScope />426<SettingsScope />
427 427
428* **`~/.claude/settings.json`**: cada projeto em sua máquina, e nada no de seu colega de equipe ou na sessão em nuvem428* **`~/.claude/settings.json`**: cada projeto em sua máquina, e nada no de seu colega de equipe ou na sessão na nuvem
429* **`acme-app/.claude/settings.json`**: seu `acme-app/`. Alcança o clone do seu colega de equipe e a sessão em nuvem apenas se você confirmar o arquivo no controle de versão; até então, é um arquivo no seu disco como qualquer outro e ninguém mais o tem429* **`acme-app/.claude/settings.json`**: seu `acme-app/`. Alcança o clone do seu colega de equipe e a sessão na nuvem apenas se você fizer commit do arquivo no controle de versão; até então, é um arquivo no seu disco como qualquer outro e ninguém mais o tem
430* **`acme-app/.claude/settings.local.json`**: seu `acme-app/` apenas. O Claude Code o adiciona às suas exclusões git globais na primeira vez que escreve o arquivo, para que fique fora de seus commits; se você criar o arquivo manualmente, [adicione-o ao `.gitignore` você mesmo](#keep-personal-settings-out-of-a-repository)430* **`acme-app/.claude/settings.local.json`**: seu `acme-app/` apenas. O Claude Code o adiciona às suas exclusões git globais na primeira vez que escreve o arquivo, para que fique fora de seus commits; se você criar o arquivo manualmente, [adicione-o ao `.gitignore` você mesmo](#keep-personal-settings-out-of-a-repository)
431* **Configurações gerenciadas**, seja um arquivo `managed-settings.json`, uma política MDM ou [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) do console claude.ai: cada projeto em cada máquina para a qual sua organização as implanta, ou que você entra com sua conta organizacional. Apenas configurações gerenciadas pelo servidor alcançam a sessão em nuvem431* **Configurações gerenciadas**, seja um arquivo `managed-settings.json`, uma política MDM ou [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) do console claude.ai: cada projeto em cada máquina para a qual sua organização as implanta, ou que você entra com sua conta organizacional. Apenas configurações gerenciadas pelo servidor alcançam a sessão na nuvem
432 432
433<span id="which-files-you-have" />433<span id="which-files-you-have" />
434 434
439Instalar o Claude Code não cria nenhum arquivo de configurações. Se sua máquina ou projeto já tiver um, ele veio de uma dessas fontes:439Instalar o Claude Code não cria nenhum arquivo de configurações. Se sua máquina ou projeto já tiver um, ele veio de uma dessas fontes:
440 440
441* **Gerenciado**: sua organização o implanta. Você não o cria ou edita.441* **Gerenciado**: sua organização o implanta. Você não o cria ou edita.
442* **Projeto compartilhado**: um projeto que já usa Claude Code pode ter um confirmado. Se não, crie-o em `.claude/settings.json` na pasta do projeto.442* **Projeto compartilhado**: um projeto que já usa Claude Code pode ter um incluído em um commit. Se não, crie-o em `.claude/settings.json` na pasta do projeto.
443* **Usuário** e **Projeto local**: crie-os você mesmo, ou deixe o Claude Code criá-los. Ele escreve `~/.claude/settings.json` na primeira vez que você altera uma opção no menu `/config` que ele armazena em configurações de usuário, como o tema, e `.claude/settings.local.json` na primeira vez que você dá uma aprovação permanente em um prompt de permissão, como "Sim, e não pergunte novamente" para um comando Bash. Algumas opções `/config`, incluindo **Mostrar dicas**, são salvas em `.claude/settings.local.json` em vez do arquivo de usuário.443* **Usuário** e **Projeto local**: crie-os você mesmo, ou deixe o Claude Code criá-los. Ele escreve `~/.claude/settings.json` na primeira vez que você altera uma opção no menu `/config` que ele armazena em configurações de usuário, como o tema, e `.claude/settings.local.json` na primeira vez que você dá uma aprovação permanente em um prompt de permissão, como "Sim, e não pergunte novamente" para um comando Bash. Algumas opções `/config`, incluindo **Mostrar dicas**, são salvas em `.claude/settings.local.json` em vez do arquivo de usuário.
444 444
445<Info>445<Info>
452 Compartilhe configurações com sua equipe452 Compartilhe configurações com sua equipe
453</h3>453</h3>
454 454
455Confirme `.claude/settings.json` para que todos que clonem o repositório obtenham as mesmas permissões, hooks e plugins. Cada colega de equipe ainda pode substituí-lo para si mesmo em seu próprio `.claude/settings.local.json`, para que exceções pessoais não precisem de um commit. Para um arquivo de equipe completo, veja [configurações compartilhadas de uma equipe](/docs/pt/settings-example#a-teams-shared-settings).455Faça commit de `.claude/settings.json` para que todos que clonem o repositório obtenham as mesmas permissões, hooks e plugins. Cada colega de equipe ainda pode sobrescrevê-lo para si mesmo em seu próprio `.claude/settings.local.json`, para que exceções pessoais não precisem de um commit. Para um arquivo de equipe completo, veja [configurações compartilhadas de uma equipe](/docs/pt/settings-example#a-teams-shared-settings).
456 456
457Parte do que você confirma espera até que cada colega de equipe [confie na pasta](/docs/pt/permissions#project-allow-rules-and-workspace-trust), e algumas chaves nunca entram em vigor de um arquivo de repositório; [Solucione problemas de uma configuração que não se aplica](#common-cases) cobre ambos.457Parte do que você inclui no commit espera até que cada colega de equipe [confie na pasta](/docs/pt/permissions#project-allow-rules-and-workspace-trust), e algumas chaves nunca entram em vigor de um arquivo de repositório; [Solucione problemas de uma configuração que não se aplica](#common-cases) cobre ambos.
458 458
459<span id="local-settings-file" />459<span id="local-settings-file" />
460 460
468 Mantenha configurações pessoais fora de um repositório468 Mantenha configurações pessoais fora de um repositório
469</h3>469</h3>
470 470
471Para alterar uma configuração para você em um projeto sem alterá-la para seus colegas de equipe, salve-a em `.claude/settings.local.json` dentro do projeto. O Claude Code aplica esse arquivo sobre o `.claude/settings.json` confirmado, então se o arquivo da sua equipe define `"model": "claude-sonnet-5"` e você quer Opus, coloque `"model": "claude-opus-5-5"` no seu arquivo local e apenas suas sessões mudam.471Para alterar uma configuração para você em um projeto sem alterá-la para seus colegas de equipe, salve-a em `.claude/settings.local.json` dentro do projeto. O Claude Code aplica esse arquivo sobre o `.claude/settings.json` incluído no commit, então se o arquivo da sua equipe define `"model": "claude-sonnet-5"` e você quer Opus, coloque `"model": "claude-opus-5-5"` no seu arquivo local e apenas suas sessões mudam.
472 472
473O Claude Code também escreve neste arquivo, o mantém fora de seus commits e aplica suas regras de permissão sem a etapa de confiança:473O Claude Code também escreve neste arquivo, o mantém fora de seus commits e aplica suas regras allow sem a etapa de confiança:
474 474
475* **O Claude Code também o escreve.** Quando Claude pede permissão para executar um comando Bash e você escolhe "Sim, e não pergunte novamente", o Claude Code salva essa [aprovação de permissão](/docs/pt/permissions#permission-system) aqui como uma regra `allow`.475* **O Claude Code também o escreve.** Quando Claude pede permissão para executar um comando Bash e você escolhe "Sim, e não pergunte novamente", o Claude Code salva essa [aprovação de permissão](/docs/pt/permissions#permission-system) aqui como uma regra `allow`.
476* **Você não precisa gitignore você mesmo, a menos que o tenha criado manualmente.** Na primeira vez que o Claude Code escreve o arquivo em um repositório git que ainda não o ignora, ele adiciona `**/.claude/settings.local.json` ao seu arquivo de exclusões git globais, para que o arquivo fique fora de seus commits em cada repositório. Esse arquivo é `core.excludesFile` quando sua config git global o define para um caminho absoluto ou com prefixo `~`; caso contrário é `$XDG_CONFIG_HOME/git/ignore`, ou `~/.config/git/ignore` quando `XDG_CONFIG_HOME` não está definido. Se você criou o arquivo manualmente e o Claude Code ainda não escreveu nele, adicione-o ao `.gitignore` você mesmo.476* **Você não precisa adicioná-lo ao gitignore você mesmo, a menos que o tenha criado manualmente.** Na primeira vez que o Claude Code escreve o arquivo em um repositório git que ainda não o ignora, ele adiciona `**/.claude/settings.local.json` ao seu arquivo de exclusões git globais, para que o arquivo fique fora de seus commits em cada repositório. Esse arquivo é `core.excludesFile` quando sua config git global o define para um caminho absoluto ou com prefixo `~`; caso contrário é `$XDG_CONFIG_HOME/git/ignore`, ou `~/.config/git/ignore` quando `XDG_CONFIG_HOME` não está definido. Se você criou o arquivo manualmente e o Claude Code ainda não escreveu nele, adicione-o ao `.gitignore` você mesmo.
477* **Suas regras allow não esperam por confiança enquanto o arquivo permanece não rastreado.** Como o arquivo é seu e não do repositório, o Claude Code aplica suas regras `allow` sem a etapa de [confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) que exige para o arquivo confirmado. Se o arquivo for rastreado pelo git, a etapa de confiança também se aplica a ele; veja [Quando seu arquivo de configurações local precisa de confiança](/docs/pt/permissions#when-your-local-settings-file-needs-trust).477* **Suas regras allow não esperam por confiança enquanto o arquivo permanece não rastreado.** Como o arquivo é seu e não do repositório, o Claude Code aplica suas regras `allow` sem a etapa de [confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) que exige para o arquivo incluído no commit. Se o arquivo for rastreado pelo git, a etapa de confiança também se aplica a ele; veja [Quando seu arquivo de configurações local precisa de confiança](/docs/pt/permissions#when-your-local-settings-file-needs-trust).
478 478
479<span id="where-claude-code-looks-for-each-file" />479<span id="where-claude-code-looks-for-each-file" />
480 480
486 Onde o Claude Code mantém o arquivo local em um repositório git486 Onde o Claude Code mantém o arquivo local em um repositório git
487</h4>487</h4>
488 488
489Quando Claude pede permissão para executar um comando Bash e você escolhe "Sim, e não pergunte novamente", o Claude Code salva essa aprovação como uma regra `allow` em `.claude/settings.local.json`. Se você iniciar o Claude Code em um subdiretório de um repositório git, ele lê e escreve esse arquivo na raiz do repositório e aplica a aprovação em todo o repositório. Em uma [worktree](/docs/pt/worktrees), ele usa o arquivo na raiz do checkout principal.489Quando Claude pede permissão para executar um comando Bash e você escolhe "Sim, e não pergunte novamente", o Claude Code salva essa aprovação como uma regra `allow` em `.claude/settings.local.json`. Se você iniciar o Claude Code em um subdiretório de um repositório git, ele lê e escreve esse arquivo na raiz do repositório e aplica a aprovação em todo o repositório. Em um [worktree](/docs/pt/worktrees), ele usa o arquivo na raiz do checkout principal.
490 490
491Duas regras qualificam a localização da raiz:491Duas regras qualificam a localização da raiz:
492 492
495 495
496Antes da v2.1.211, o Claude Code mantinha o arquivo no diretório inicial. Ele ainda lê um arquivo que uma versão anterior deixou lá ao lado do arquivo raiz; onde ambos definem a mesma chave, o valor da raiz se aplica, e regras de permissão de ambos os arquivos se aplicam. O helper [`resolveSettings()`](/docs/pt/agent-sdk/typescript#resolvesettings) do Agent SDK sempre lê o arquivo do diretório inicial.496Antes da v2.1.211, o Claude Code mantinha o arquivo no diretório inicial. Ele ainda lê um arquivo que uma versão anterior deixou lá ao lado do arquivo raiz; onde ambos definem a mesma chave, o valor da raiz se aplica, e regras de permissão de ambos os arquivos se aplicam. O helper [`resolveSettings()`](/docs/pt/agent-sdk/typescript#resolvesettings) do Agent SDK sempre lê o arquivo do diretório inicial.
497 497
498O Claude Code lê o `.claude/settings.json` compartilhado do [diretório de trabalho primário](/docs/pt/permissions#working-directories) da sessão, então para usar um arquivo confirmado na raiz do repositório, inicie o Claude Code lá. Depois que você [mover a sessão com `/cd`](/docs/pt/permissions#move-the-session-to-another-directory), o Claude Code lê ambos os arquivos do projeto do novo diretório em vez disso, colocando o arquivo local pelas mesmas regras. Lê-los do diretório para o qual você se moveu requer Claude Code v2.1.246 ou posterior.498O Claude Code lê o `.claude/settings.json` compartilhado do [diretório de trabalho primário](/docs/pt/permissions#working-directories) da sessão, então para usar um arquivo incluído no commit na raiz do repositório, inicie o Claude Code lá. Depois que você [mover a sessão com `/cd`](/docs/pt/permissions#move-the-session-to-another-directory), o Claude Code lê ambos os arquivos do projeto do novo diretório em vez disso, colocando o arquivo local pelas mesmas regras. Lê-los do diretório para o qual você se moveu requer Claude Code v2.1.246 ou posterior.
499 499
500<span id="managed-settings-delivery" />500<span id="managed-settings-delivery" />
501 501
519* Políticas de nível MDM ou SO, e arquivos `managed-settings.json` em um diretório do sistema519* Políticas de nível MDM ou SO, e arquivos `managed-settings.json` em um diretório do sistema
520* Um host de incorporação como Claude Desktop, através da opção SDK `managedSettings`; veja [Controlar política de um host de incorporação](/docs/pt/managed-settings#parent-settings-from-embedding-hosts)520* Um host de incorporação como Claude Desktop, através da opção SDK `managedSettings`; veja [Controlar política de um host de incorporação](/docs/pt/managed-settings#parent-settings-from-embedding-hosts)
521 521
522Em uma sessão [Cowork](https://claude.com/docs/cowork/overview) que é executada em sua máquina no aplicativo Claude Desktop, o Claude Code não busca configurações gerenciadas pelo servidor do console de administração claude.ai, e lê a política implantada em seu dispositivo a menos que a configuração Claude Desktop da sua organização defina `requireCoworkFullVmSandbox`. [Onde e quando uma política se aplica](/docs/pt/managed-settings#where-and-when-a-policy-applies) cobre Cowork e sessões em nuvem.522Em uma sessão [Cowork](https://claude.com/docs/cowork/overview) que é executada em sua máquina no aplicativo Claude Desktop, o Claude Code não busca configurações gerenciadas pelo servidor do console de administração claude.ai, e lê a política implantada em seu dispositivo a menos que a configuração Claude Desktop da sua organização defina `requireCoworkFullVmSandbox`. [Onde e quando uma política se aplica](/docs/pt/managed-settings#where-and-when-a-policy-applies) cobre Cowork e sessões na nuvem.
523 523
524Se você é o administrador, [Configure o Claude Code para sua organização](/docs/pt/admin-setup) o guia através da escolha do que impor, e [Implante configurações gerenciadas](/docs/pt/managed-settings) cobre entrega e como confirmar que uma política está em vigor.524Se você é o administrador, [Configure o Claude Code para sua organização](/docs/pt/admin-setup) o guia através da escolha do que impor, e [Implante configurações gerenciadas](/docs/pt/managed-settings) cobre entrega e como confirmar que uma política está em vigor.
525 525
659 659
660Em ordem, precedência mais alta primeiro:660Em ordem, precedência mais alta primeiro:
661 661
6621. **Configurações gerenciadas**: configurações que sua organização implanta, por um arquivo `managed-settings.json`, uma política MDM ou [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) do console claude.ai. Nada que você defina as substitui: uma chave que você passa com `--settings` não substitui a mesma chave gerenciada, e uma flag como `--model` escolhe apenas entre os modelos que sua organização permite. Uma `model` gerenciada define o modelo com o qual cada sessão inicia, e você ainda pode mudar com `/model`; o bloqueio é [`availableModels`](/docs/pt/settings-reference#availablemodels), que restringe `/model`, `--model` e a chave `model` em seus próprios arquivos. Quando sua organização entrega mais de uma fonte gerenciada, as regras para [precedência dentro do nível gerenciado](/docs/pt/managed-settings#precedence-within-the-managed-tier) dizem o que o Claude Code lê de cada uma.6621. **Configurações gerenciadas**: configurações que sua organização implanta, por um arquivo `managed-settings.json`, uma política MDM ou [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) do console claude.ai. Nada em seus próprios arquivos de configurações ou em `--settings` sobrescreve uma chave gerenciada, e uma flag como `--model` escolhe apenas entre os modelos que sua organização permite. Um [`model`](/docs/pt/settings-reference#model) gerenciado é um padrão inicial, não um bloqueio; os bloqueios são [`availableModels`](/docs/pt/settings-reference#availablemodels) e [`deniedModels`](/docs/pt/settings-reference#deniedmodels). Quando sua organização entrega mais de uma fonte gerenciada, as regras para [precedência dentro do nível gerenciado](/docs/pt/managed-settings#precedence-within-the-managed-tier) dizem o que o Claude Code lê de cada uma.
6632. **Argumentos de linha de comando**: flags que você passa quando inicia `claude` de um terminal, para uma sessão; veja [Altere uma configuração para uma sessão](#change-a-setting-for-one-session). O Claude Code mescla JSON que você passa com `--settings <file-or-json>` com seus arquivos de configurações pelas mesmas regras que os outros níveis: ele toma uma chave que você define aqui sobre a mesma chave em configurações local, projeto ou usuário, e mantém o valor de nível inferior para uma chave que você omite.6632. **Linha de comando**: JSON que você passa com `--settings <file-or-json>` ao iniciar `claude`, apenas para essa sessão; veja [Altere uma configuração para uma sessão](#change-a-setting-for-one-session). Uma chave que você define ali sobrescreve a mesma chave em seus arquivos de configurações de projeto e de usuário, e uma chave que você omite mantém seu valor desses arquivos. Outras flags, como `--model`, definem uma coisa para a sessão e não fazem parte desta pilha; a entrada de uma chave na [referência de configurações](/docs/pt/settings-reference) diz quais flags a sobrescrevem.
6643. **Configurações locais de projeto** (`.claude/settings.local.json`): suas configurações pessoais para este projeto.6643. **Configurações locais de projeto** (`.claude/settings.local.json`): suas configurações pessoais para este projeto.
6654. **Configurações compartilhadas de projeto** (`.claude/settings.json`): configurações que sua equipe verifica no controle de origem.6654. **Configurações compartilhadas de projeto** (`.claude/settings.json`): configurações que sua equipe verifica no controle de origem.
6665. **Configurações de usuário** (`~/.claude/settings.json`): suas configurações pessoais para cada projeto.6665. **Configurações de usuário** (`~/.claude/settings.json`): suas configurações pessoais para cada projeto.
792| [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) | `true` de qualquer escopo | Honrado mesmo quando uma fonte gerenciada define `false` |792| [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) | `true` de qualquer escopo | Honrado mesmo quando uma fonte gerenciada define `false` |
793| [`enableArtifact`](/docs/pt/settings-reference#enableartifact) | `false` de qualquer escopo, e `disableArtifact: true` de qualquer escopo | Honrado mesmo quando uma fonte gerenciada define `true`; nada liga a [ferramenta Artifact](/docs/pt/artifacts#disable-artifacts) de volta. Requer Claude Code v2.1.242 ou posterior |793| [`enableArtifact`](/docs/pt/settings-reference#enableartifact) | `false` de qualquer escopo, e `disableArtifact: true` de qualquer escopo | Honrado mesmo quando uma fonte gerenciada define `true`; nada liga a [ferramenta Artifact](/docs/pt/artifacts#disable-artifacts) de volta. Requer Claude Code v2.1.242 ou posterior |
794| [`isolatePeerMachines`](/docs/pt/settings-reference#isolatepeermachines) | `true` de qualquer escopo | Honrado mesmo quando uma fonte gerenciada define `false` |794| [`isolatePeerMachines`](/docs/pt/settings-reference#isolatepeermachines) | `true` de qualquer escopo | Honrado mesmo quando uma fonte gerenciada define `false` |
795| [`permissions.blockReadsOutsideWorkingDirectories`](/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` de qualquer escopo | Honrado mesmo quando uma fonte gerenciada define `false`. Requer Claude Code v2.1.257 ou posterior |
796| [`autoMode.classifyAllShell`](/docs/pt/settings-reference#automode-classifyallshell) | `true` de `~/.claude/settings.json` ou `--settings` | Honrado mesmo quando uma fonte gerenciada define `false` |
795| [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) | `false` de `.claude/settings.json` ou `.claude/settings.local.json` | Honrado mesmo quando uma fonte gerenciada define `true`; um `true` de projeto ou local é ignorado |797| [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) | `false` de `.claude/settings.json` ou `.claude/settings.local.json` | Honrado mesmo quando uma fonte gerenciada define `true`; um `true` de projeto ou local é ignorado |
796| [`crossSessionInbound`](/docs/pt/settings-reference#crosssessioninbound) | Um valor mais rigoroso de `.claude/settings.json` ou `.claude/settings.local.json`, na escada `accept` \< `hold` \< `refuse` | Honrado sobre valores gerenciados, `--settings` e de usuário; um valor de projeto ou local que não é mais rigoroso é ignorado |798| [`crossSessionInbound`](/docs/pt/settings-reference#crosssessioninbound) | Um valor mais rigoroso de `.claude/settings.json` ou `.claude/settings.local.json`, na escada `accept` \< `hold` \< `refuse` | Honrado sobre valores gerenciados, `--settings` e de usuário; um valor de projeto ou local que não é mais rigoroso é ignorado |
797| [`useAutoModeDuringPlan`](/docs/pt/settings-reference#useautomodeduringplan) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Honrado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |799| [`useAutoModeDuringPlan`](/docs/pt/settings-reference#useautomodeduringplan) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Honrado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |
799| [`syncClaudeAiPlugins`](/docs/pt/settings-reference#syncclaudeaiplugins) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Honrado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |801| [`syncClaudeAiPlugins`](/docs/pt/settings-reference#syncclaudeaiplugins) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Honrado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |
800| [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) | Um limite inferior de qualquer escopo, incluindo `--settings` | Honrado mesmo quando as configurações gerenciadas que o Claude Code aplica definem um limite superior; o limite inferior se aplica. Requer Claude Code v2.1.267 ou posterior |802| [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) | Um limite inferior de qualquer escopo, incluindo `--settings` | Honrado mesmo quando as configurações gerenciadas que o Claude Code aplica definem um limite superior; o limite inferior se aplica. Requer Claude Code v2.1.267 ou posterior |
801 803
802Um aplicativo que executa o Claude Code dentro de si e define [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/pt/env-vars) também é uma exceção. O Claude Code toma a configuração de modelo daquele aplicativo sobre as chaves `model`, `fallbackModel`, `modelPicker` e `modelOverrides` de cada fonte gerenciada, e sobre as variáveis de seleção de modelo em um bloco `env` gerenciado, como `ANTHROPIC_MODEL` e a família `ANTHROPIC_DEFAULT_*_MODEL`. O Claude Code mantém uma [`availableModels`](/docs/pt/settings-reference#availablemodels) gerenciada em vigor a menos que o aplicativo forneça a sua própria.804Um aplicativo que executa o Claude Code dentro de si e define [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/pt/env-vars) também é uma exceção. O Claude Code toma a configuração de modelo daquele aplicativo sobre as chaves `model`, `fallbackModel`, `modelPicker` e `modelOverrides` de cada fonte gerenciada, e sobre as variáveis de seleção de modelo em um bloco `env` gerenciado, como `ANTHROPIC_MODEL` e a família `ANTHROPIC_DEFAULT_*_MODEL`. O Claude Code mantém uma allowlist [`availableModels`](/docs/pt/settings-reference#availablemodels) gerenciada em vigor a menos que o aplicativo forneça a sua própria.
803 805
804<h2 id="settings-in-cloud-sessions">806<h2 id="settings-in-cloud-sessions">
805 Configurações em sessões em nuvem807 Configurações em sessões em nuvem