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 executadorequiredMinimumVersiondefine 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, já que as configurações gerenciadas pelo servidor não suportam política por grupo ainda.
- 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