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
Configurações compartilhadas de uma equipe
As configurações compartilhadas de uma equipe, confirmadas no repositório para que todos que o clonem obtenham as mesmas permissões, hooks, telemetria e marketplace de plugins. Salve um arquivo como este em.claude/settings.json no topo do repositório. Três coisas a saber antes de confirmar um:
- Sessões em nuvem também o leem. Uma sessão em nuvem no Claude Code na web começa a partir de um clone do repositório, então o arquivo confirmado se aplica lá também.
- Regras de permissão aguardam confiança. Regras de permissão e entradas
extraKnownMarketplacesentram em vigor depois que cada pessoa confia nesta pasta em si, não apenas em uma pasta pai; regras de negação e pergunta se aplicam em cada sessão, confiável ou não. - O hook é um script no repositório. O hook deste arquivo executa
.claude/hooks/block-rm.sh; How a hook resolves percorre como escrevê-lo.
- Copyable settings file
- What each key does
Salve isto como
.claude/settings.json no topo do repositório e confirme. É JSON válido sem comentários, então você pode colar como está e deletar as chaves que não deseja..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 ecurl, 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 lista de permissão de rede fixa e sem retry não sandboxedrequiredMinimumVersiondefine 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.
- Copyable settings file
- What each key does
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