settings.json de exemplo, um para cada lugar onde você salva uma configuração:
- Um
~/.claude/settings.jsonde desenvolvedor - Um
.claude/settings.jsonde equipe, confirmado no repositório - Um
managed-settings.jsonde organização
Suas próprias configurações
As configurações pessoais de um desenvolvedor. Ele escolhe um modelo e esforço, ajusta o terminal e pré-aprova um comando somente leitura e uma leitura de arquivo. Tudo não listado mantém seu padrão. Um arquivo como este vai em~/.claude/settings.json, onde se aplica a cada projeto que você abre.
- Copyable settings file
- What each key does
Salve isto como
~/.claude/settings.json. É JSON válido sem comentários, então você pode colar como está e deletar as chaves que não deseja.~/.claude/settings.json
As configurações compartilhadas de uma equipe
As configurações compartilhadas de uma equipe, com commit no repositório para que todos que o clonarem recebam as mesmas permissões, hooks e marketplace de plugins. Salve um arquivo como este em.claude/settings.json na raiz do repositório. O que saber antes de fazer commit de um:
- Sessões na nuvem fora das threads de um projeto também o leem. Uma sessão na nuvem com um repositório começa dentro do clone, então o arquivo com commit também se aplica lá.
- A telemetria vai nas configurações gerenciadas ou pessoais. O Claude Code ignora as variáveis do exportador OpenTelemetry nos arquivos de configurações de um repositório, exceto alguns valores que desativam a telemetria. Defina-as nas configurações gerenciadas da sua organização ou no
~/.claude/settings.jsonde cada pessoa. - As regras de allow aguardam a confiança. As regras de allow (permitir) e as entradas de
extraKnownMarketplacesentram em vigor depois que cada pessoa confia nesta própria pasta, e não apenas em uma pasta pai; as regras de deny e ask se aplicam em todas as sessões, confiáveis ou não. - O hook é um script no repositório. O hook deste arquivo executa
.claude/hooks/block-rm.sh; Como um hook é resolvido explica como escrevê-lo. - As regras correspondem ao comando e ao caminho conforme escritos.
Bash(git push *)não corresponde agit -C . push.Read(./.env)sozinho bloqueia as ferramentas de arquivo e os comandos que nomeiam o arquivo, comocat .env, mas nãogrep -rexecutado sobre o diretório; o blocosandboxneste arquivo fecha essa lacuna, porque o sandbox adiciona seus caminhos de deny deReadao que nenhum comando em sandbox pode ler.
- Arquivo de configurações para copiar
- O que cada chave faz
Salve isto como
.claude/settings.json na raiz do repositório e faça o commit. É um JSON válido sem comentários, então você pode colá-lo como está e excluir as chaves que não quiser..claude/settings.json
Configurações gerenciadas de uma organização
Um arquivomanaged-settings.json que mostra a forma das chaves gerenciadas, com um valor plausível para cada uma. Não é uma política recomendada: escolha as chaves que correspondem aos seus próprios requisitos e defina seus próprios valores. O exemplo define estas chaves:
forceLoginMethodeforceLoginOrgUUIDfixam o método de login e a organizaçãoavailableModelseenforceAvailableModelsrestringem quais modelos as sessões podem usarpermissions.denybloqueia duas leituras de arquivo e comandoscurlconforme Claude os escreve, edisableBypassPermissionsModeremove o modo de permissão de bypassallowManagedPermissionRulesOnlyeallowManagedMcpServersOnlyfazem as listas de permissão gerenciadas e MCP as únicas que se aplicamallowedMcpServersfixa o servidor MCP pela URLstrictKnownMarketplacespermite um marketplace de pluginssandboxcoloca comandos em sandbox com uma allowlist de rede fixa e sem nova tentativa fora do sandbox. Sua chavefailIfUnavailableimpede que Claude Code seja iniciado onde o sandbox não pode ser executado, exceto em um ambiente hospedado pela AnthropicrequiredMinimumVersiondefine uma versão mínima de Claude CodecleanupPeriodDaysencurta a retenção de transcrições de sessão e outros dados locais para sete diascompanyAnnouncementsmostra uma mensagem na inicialização
managed-settings.json, ou o mesmo JSON através de MDM ou configurações gerenciadas pelo servidor. Um arquivo implantado se aplica a cada máquina ou conta que alcança. Para dar a um grupo valores diferentes, implante um arquivo ou perfil diferente para esse grupo. Em um plano Enterprise, você pode, em vez disso, dar ao grupo sua própria configuração nas configurações gerenciadas pelo servidor.
- Arquivo de configurações copiável
- O que cada chave faz
Implante isto como
managed-settings.json, ou o mesmo JSON através de MDM ou do console claude.ai. É JSON válido sem comentários; substitua o UUID da organização de exemplo, URL do servidor e marketplace pelos seus próprios e delete as chaves que não deseja.managed-settings.json