# Configurações dos agentes

Escolha quais CLIs aparecem em New Agent, altere os padrões delas e adicione suas próprias configurações de inicialização.

## 1. Abra o facade.json

- Abra o menu **…** do painel Facade e escolha **Open Settings**. Você também pode encontrá-lo na Paleta de Comandos.
- 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.
- 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:

```json
{
  "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:

```json
{
  "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](https://facadecode.com/pt-br/docs/providers/claude-code/) ou do [Codex](https://facadecode.com/pt-br/docs/providers/codex/). Veja [Nomes e ícones](https://facadecode.com/pt-br/docs/appearance/) 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](https://facadecode.com/pt-br/docs/reference/).