Configurações dos agentes

1. Abra o facade.json#

1. Abra o menu … do painel Facade e escolha Open Settings. Você também pode encontrá-lo na Paleta de Comandos.
2. Em Facade: Home, escolha Edit in facade.json. Se a janela remota abrir as configurações como JSON, o comando abre o facade.json diretamente.
3. Edite o arquivo e salve. O Facade aceita comentários JSON e vírgulas finais.

O local padrão é ~/.facade/facade.json. Se o arquivo não existir, o Facade o cria com comentários, entradas de CLIs nativas e exemplos para adaptar. O Facade não reescreve um arquivo existente.

2. Altere um padrão#

Por exemplo, isto define o esforço padrão do Codex como high e remove o Pi do New Agent. Adicione estes campos ao seu arquivo, mantendo as outras entradas que você usa:

{
  "clis": {
    "codex": {
      "effort": "high"
    },
    "pi": {
      "enabled": false
    }
  }
}

Salve e inicie um agente novo. Agentes em execução mantêm as configurações de inicialização; agentes retomados e fixados usam o arquivo atual na próxima vez que iniciarem.

3. Adicione outra configuração#

Use um ID nativo como codex para mudar os padrões dessa CLI, ou um nome novo para adicionar uma configuração separada:

{
  "clis": {
    "Codex · review": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "effort": "high"
    }
  }
}

Substitua YOUR_MODEL_ID por um modelo compatível com sua configuração do Codex. Salve e escolha Codex · review em New Agent para usá-la. O type mantém a integração do Codex com o Facade, enquanto o nome identifica esta configuração.

A nova entrada não herda configurações de codex. Adicione os próprios argumentos, variáveis de ambiente ou caminho do executável conforme necessário. Para conectar outra API, siga o guia do Claude Code ou do Codex. Veja Nomes e ícones para mudar como ela aparece.

Use as configurações da máquina certa#

Projetos locais que usam a mesma home do Facade compartilham as configurações dela. Projetos em SSH, WSL e contêineres leem o arquivo em seus próprios ambientes de execução. Abra as configurações a partir do projeto que você quer configurar.

A configuração Facade: Home no VS Code escolhe a pasta que contém o facade.json. Um valor explícito tem precedência sobre FACADE_HOME, que por sua vez tem precedência sobre ~/.facade. Depois de mudar a home, aceite o prompt do Facade para recarregar a janela.

Use Edit in facade.json para chegar ao arquivo ativo. Para definições de campos e padrões, veja a referência de configuração.