Configurações
Configuração do harness do Claude Code em settings.json, cobrindo permissões de ferramentas, cabeamento de hooks, variáveis de ambiente e modelos de linha de status.
O settings.json carrega a configuração do harness do Claude Code: cabeamento de
hooks, permissões de ferramentas, variáveis de ambiente e ajustes da linha de
status.
A referência canônica completa vive em settings-reference.md. Esta página resume o contrato e aponta para a referência mais aprofundada.
Seções
| Seção | Propósito |
|---|---|
permissions | Listas brancas e negras de ferramentas por matcher |
hooks | Tabela de comandos de hook indexada por evento (o cabeamento canônico) |
env | Variáveis de ambiente por sessão |
statusLine | Modelo de linha de status que o host renderiza |
Invariante de modelo único
O adaptador do Claude Code envia um único modelo settings.json. Os comandos de
hook usam a forma exec (command mais args) em vez de strings de comando
específicas do shell, de modo que o comportamento entre sistemas operacionais é
revisado dentro de um único arquivo. Novas entradas de permissões e eventos de
hook aterrissam nesse arquivo de forma atômica.
Servidores MCP
Configuração de servidores Model Context Protocol — de propriedade do operador e registrados através do mecanismo MCP nativo de cada ferramenta; o Apothem sincroniza o inventário a partir do perfil compartilhado, mas não cria entradas de servidor.
Documentação do settings.json
Configure a execução de hooks do Claude Code, permissões, eventos, tempos limite, runtime Python, validação e precedência de configurações em camadas para o ecossistema Apothem.