# Configuración de los agentes

Elige las CLI que aparecen en New Agent, cambia sus valores predeterminados y añade tus propias configuraciones de inicio.

## 1. Abre facade.json

- Abre el menú **…** del panel de Facade y elige **Open Settings**. También está disponible en la Paleta de comandos.
- En **Facade: Home**, elige **Edit in facade.json**. Si la ventana remota abre la configuración como JSON, el comando abre facade.json directamente.
- 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:

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

```json
{
  "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](https://facadecode.com/es/docs/providers/claude-code/) o de [Codex](https://facadecode.com/es/docs/providers/codex/). Consulta [Nombres e iconos](https://facadecode.com/es/docs/appearance/) 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](https://facadecode.com/es/docs/reference/).