Facade CodeSolució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. Para errores de conexión con el móvil, consulta Continúa desde el móvil.
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.