Configurações do Claude Code

O Claude Code oferece uma variedade de configurações para configurar seu comportamento para atender às suas necessidades. Você pode configurar o Claude Code executando o comando /config ao usar o REPL interativo.

​

Arquivos de configurações

O arquivo settings.json é nosso mecanismo oficial para configurar o Claude Code através de configurações hierárquicas:

• Configurações do usuário são definidas em ~/.claude/settings.json e se aplicam a todos os projetos.
• Configurações do projeto são salvas no diretório do seu projeto:
  • .claude/settings.json para configurações que são incluídas no controle de versão e compartilhadas com sua equipe
  • .claude/settings.local.json para configurações que não são incluídas, úteis para preferências pessoais e experimentação. O Claude Code configurará o git para ignorar .claude/settings.local.json quando for criado.
• Para implantações empresariais do Claude Code, também suportamos configurações de política gerenciada empresarial. Estas têm precedência sobre as configurações do usuário e do projeto. Os administradores do sistema podem implantar políticas em /Library/Application Support/ClaudeCode/managed-settings.json no macOS e /etc/claude-code/managed-settings.json no Linux e Windows via WSL.

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

Configurações disponíveis

settings.json suporta várias opções:

​

Configurações de permissão

​

Precedência de configurações

As configurações são aplicadas em ordem de precedência:

1. Políticas empresariais (veja documentação IAM)
2. Argumentos da linha de comando
3. Configurações locais do projeto
4. Configurações compartilhadas do projeto
5. Configurações do usuário

​

Variáveis de ambiente

O Claude Code suporta as seguintes variáveis de ambiente para controlar seu comportamento:

​

Opções de configuração

Estamos no processo de migrar a configuração global para settings.json.

claude config será descontinuado em favor de settings.json

Para gerenciar suas configurações, use os seguintes comandos:

• Listar configurações: claude config list
• Ver uma configuração: claude config get <key>
• Alterar uma configuração: claude config set <key> <value>
• Adicionar a uma configuração (para listas): claude config add <key> <value>
• Remover de uma configuração (para listas): claude config remove <key> <value>

Por padrão config altera sua configuração de projeto. Para gerenciar sua configuração global, use a flag --global (ou -g).

​

Configuração global

Para definir uma configuração global, use claude config set -g <key> <value>:

​

Ferramentas disponíveis para o Claude

O Claude Code tem acesso a um conjunto de ferramentas poderosas que o ajudam a entender e modificar sua base de código:

Regras de permissão podem ser configuradas usando /allowed-tools ou em configurações de permissão.

​

Estendendo ferramentas com hooks

Você pode executar comandos personalizados antes ou depois que qualquer ferramenta execute usando hooks do Claude Code.

Por exemplo, você poderia executar automaticamente um formatador Python depois que o Claude modifica arquivos Python, ou prevenir modificações em arquivos de configuração de produção bloqueando operações Write para certos caminhos.

​

Veja também

• Gerenciamento de Identidade e Acesso - Aprenda sobre o sistema de permissões do Claude Code
• IAM e controle de acesso - Gerenciamento de políticas empresariais
• Solução de problemas - Soluções para problemas comuns de configuração