# Solución de problemas

Averigua si un problema proviene de la configuración de inicio, de la CLI o de su proveedor de modelos.

## Revisa el inicio solicitado

Ejecuta **Show Agent Launch** desde la Paleta de comandos y elige la ubicación de trabajo. El informe muestra cómo se iniciaría ahora cada CLI en ese lugar: ejecutable, directorio, argumentos y nombres de variables de entorno. Los valores privados se ocultan.

El informe describe el próximo inicio con tu configuración actual. No describe un agente que ya está en ejecución. Si una petición funciona, los registros de uso del proveedor pueden ayudar a confirmar qué cuenta la atendió.

## Encuentra el síntoma

| Problema | Qué comprobar |
| --- | --- |
| No encuentras el archivo de configuración | Elige Open Settings y luego Edit in facade.json en Facade: Home. Si la ventana remota abre la configuración como JSON, el comando abre facade.json directamente. |
| Falta una entrada en New Agent | Revisa el nombre y el `type` de la entrada y comprueba que no está desactivada con `enabled: false`. Las entradas no válidas aparecen en Unavailable con un motivo. |
| No se encuentra el ejecutable | Instala la CLI donde se ejecuta el proyecto o define su ruta completa en `command`. Para OpenCode, usa la versión 2 (`@opencode/cli`). |
| Falta una referencia de entorno | El host del editor debe tener esa variable antes de que se inicie el agente. Exportarla en una terminal ya abierta no actualiza el host. |
| Un argumento entra en conflicto con una opción que controla Facade | Quita la opción de `args`. Usa en su lugar el campo `model` o `effort` de la entrada, o el campo `yolo` de nivel superior. |
| Falla la autenticación o un modelo no está disponible | Revisa la clave, el endpoint, la región, el ID de modelo y el acceso de la cuenta del proveedor. |
| Un proveedor de Codex no responde | Comprueba que su endpoint admite la API Responses. |
| Un agente no encuentra a otro agente | Comprueba que sus proyectos están conectados a través del mismo directorio base de Facade y que su configuración de acceso permite la comunicación. |
| Un programa personalizado no recibe mensajes | Escribe en su terminal. Las entradas personalizadas no reciben la mensajería ni las herramientas de Facade. |
| La configuración guardada no ha cambiado un agente en ejecución | Inicia un agente nuevo. Para conservar la conversación, finaliza el agente y usa Resume Agent para reiniciarlo con la nueva configuración. |

Para la configuración de SSH, consulta [Ejecuta agentes en una máquina remota](https://facadecode.com/es/docs/remote-ssh/). Para errores de conexión con el móvil, consulta [Continúa desde el móvil](https://facadecode.com/es/docs/remote-control/).

## Informa de un problema

Incluye lo que intentaste, el error exacto, tu sistema operativo, las versiones del editor y de la extensión, la versión de la CLI y la entrada seleccionada. Si es posible, incluye la configuración relevante sin claves ni valores privados.

[Abre un issue en GitHub ↗](https://github.com/y5ez3g/facadecode/issues)