Configuración de los agentes

1. Abre facade.json#

1. Abre el menú … del panel de Facade y elige Open Settings. También está disponible en la Paleta de comandos.
2. En Facade: Home, elige Edit in facade.json. Si la ventana remota abre la configuración como JSON, el comando abre facade.json directamente.
3. Edita el archivo y guárdalo. Facade acepta comentarios JSON y comas finales.

La ubicación predeterminada es ~/.facade/facade.json. Si el archivo no existe, Facade lo crea con comentarios, entradas de CLI integradas y ejemplos que puedes adaptar. Facade no reescribe un archivo que ya existe.

2. Cambia un valor predeterminado#

Por ejemplo, esto establece el esfuerzo predeterminado de Codex en high y quita Pi de New Agent. Añade estos campos a tu archivo actual y conserva las demás entradas que uses:

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

Guarda el archivo e inicia un agente nuevo. Los agentes en ejecución conservan su configuración de inicio; los agentes reanudados y anclados usan el archivo actual la próxima vez que se inicien.

3. Añade otra configuración#

Usa un ID integrado como codex para cambiar los valores predeterminados de esa CLI, o un nombre nuevo para añadir una configuración distinta:

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

Sustituye YOUR_MODEL_ID por un modelo compatible con tu configuración de Codex. Guarda el archivo y elige Codex · review en New Agent para usarla. El campo type mantiene la integración de Codex con Facade, mientras que el nombre identifica esta configuración.

La entrada nueva no hereda ajustes de codex. Añade sus propios argumentos, variables de entorno o ruta de ejecutable según necesites. Para conectar otra API, sigue la guía de Claude Code o de Codex. Consulta Nombres e iconos para cambiar su apariencia.

Usa la configuración de la máquina correcta#

Los proyectos locales que usan el mismo directorio base de Facade comparten su configuración. Los proyectos SSH, WSL y de contenedor leen el archivo de su propio entorno de ejecución. Abre Open Settings desde el proyecto que quieras configurar.

El ajuste Facade: Home de la configuración de VS Code determina la carpeta que contiene facade.json. Un valor explícito tiene prioridad sobre FACADE_HOME, que a su vez tiene prioridad sobre ~/.facade. Después de cambiar el directorio base, acepta la petición de Facade para recargar la ventana.

Usa Edit in facade.json para llegar al archivo activo. Para ver la definición de los campos y los valores predeterminados, consulta la referencia de configuración.