> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos y configuración de la extensión para VS Code

> Todos los comandos de la extensión de Square Cloud para VS Code, su configuración y soluciones a problemas comunes.

## Comandos

Abre la paleta de comandos (`Ctrl+Shift+P` / `Cmd+Shift+P`) y escribe **Square Cloud**.

| Comando | Dónde más aparece |
| - | - |
| `Square Cloud: Conectar cuenta` | Vista de inicio de sesión, barra de estado sin cuenta conectada |
| `Square Cloud: Primeros pasos` | Vista de inicio de sesión, menú `...` de la barra lateral |
| `Square Cloud: Actualizar` | Barra de título de la barra lateral, barra de estado |
| `Square Cloud: Subir nueva aplicación` | Barra de título de la barra lateral, sección Aplicaciones vacía |
| `Square Cloud: Mostrar estado del servicio` | Pie de la barra lateral, con una cuenta conectada |
| `Square Cloud: Crear base de datos` | Menú `...` de la barra lateral, sección Bases de datos vacía |
| `Square Cloud: Crear espacio de trabajo` | Menú `...` de la barra lateral, sección Espacios de trabajo vacía |
| `Square Cloud: Copiar mi código de invitación` | Menú `...` de la barra lateral |
| `Square Cloud: Desconectar cuenta` | Menú `...` de la barra lateral |

Con una cuenta conectada, la paleta también ejecuta las acciones de aplicaciones y bases de datos. Cada una pregunta qué aplicación o base de datos usar y lista solo aquellas a las que se aplica: Iniciar ofrece las aplicaciones que no están en ejecución, Detener y Reiniciar las que no están detenidas, las herramientas del edge solo sitios web, y las métricas solo aplicaciones con 512 MB o más.

| Grupo | Comandos |
| - | - |
| Ciclo de vida | Iniciar aplicación..., Detener aplicación..., Reiniciar aplicación... |
| Logs y métricas | Mostrar logs de la aplicación..., Alternar transmisión en tiempo real de la aplicación..., Mostrar métricas de 24 h de la aplicación... |
| Deploy | Enviar archivos a la aplicación (commit)..., Descargar snapshot de la aplicación..., Restaurar snapshot de la aplicación... |
| Configuración | Editar variables de entorno de la aplicación..., Vincular aplicación a un repositorio de GitHub..., Desvincular aplicación del repositorio de GitHub... |
| Edge (sitios web) | Mostrar logs del edge..., Mostrar errores del edge..., Mostrar rendimiento del edge..., Purgar caché del edge... |
| Otros | Abrir aplicación en el panel web..., Copiar ID de la aplicación..., Eliminar aplicación... |
| Bases de datos | Iniciar base de datos..., Detener base de datos..., Descargar certificado TLS de la base de datos..., Eliminar base de datos... |

Las mismas acciones están en el menú de cada tarjeta de la barra lateral: haz clic derecho en una aplicación, base de datos o workspace, o usa su botón ⋯.

## Configuración

| Ajuste | Valor por defecto | Descripción |
| - | - | - |
| `squarecloud.favApps` | `[]` | IDs de tus aplicaciones favoritas, que se muestran al principio de la lista. La estrella de cada tarjeta lo gestiona, así que rara vez necesitas editarlo a mano. |

## Activación y actualización

La extensión se activa solo cuando hace falta: cuando el área de trabajo tiene un archivo `squarecloud.app` o `squarecloud.config`, o cuando abres la barra lateral de Square Cloud, ejecutas uno de sus comandos o abres un archivo de configuración. Hasta entonces, no tiene actividad en segundo plano.

Una vez activa, actualiza tu cuenta cada **60 segundos**. La actualización periódica se pausa mientras la ventana de VS Code no tiene el foco, y los datos se actualizan en cuanto vuelves, así que un editor inactivo no gasta tu cuota de la API. Cuando se alcanza un límite de tasa, la actualización en segundo plano se pausa durante unos minutos y la barra lateral mantiene lo que ya está en pantalla.

## Solución de problemas

<AccordionGroup>
  <Accordion title="No aparece nada en la barra lateral">
    Comprueba que haya una cuenta conectada: sin una, la barra lateral muestra la pantalla de inicio de sesión. Si no se puede contactar con Square Cloud, si está pausando solicitudes o si está en mantenimiento, la barra lateral indica cuál es el caso, con los botones **Intentar de nuevo** y **Estado del servicio**.
  </Accordion>

  <Accordion title="Tu autorización expiró o fue revocada">
    Las autorizaciones duran 90 días y no se pueden renovar de forma silenciosa. Ejecuta `Square Cloud: Conectar cuenta` de nuevo. Puedes revocar una autorización en cualquier momento en **Mi cuenta → Autenticación** del [panel](https://squarecloud.app/es/account/security).
  </Accordion>

  <Accordion title="Alguien te envió un código o un enlace para aprobar">
    No lo introduzcas. Aprobar el código de otra persona conecta su editor a tu cuenta. Si la página rechaza el código que pegaste, empieza de nuevo desde VS Code.
  </Accordion>

  <Accordion title="La subida falla con un error de configuración faltante">
    La carpeta elegida necesita un archivo `squarecloud.app` o `squarecloud.config` en su raíz. Consulta la [guía del archivo de configuración](/es/getting-started/config-file).
  </Accordion>

  <Accordion title="La subida falla porque el zip es demasiado grande">
    Los zips están limitados a 100 MB. Añade la salida de build, las cachés y las carpetas de dependencias a [`squarecloud.ignore`](/es/getting-started/squarecloud-ignore). `node_modules` y `.git` ya quedan fuera, y las dependencias se instalan en la plataforma a partir de tu manifiesto.
  </Accordion>

  <Accordion title="Un comando falló con un mensaje de límite de tasa">
    Espera antes de volver a intentarlo. La actualización en segundo plano ya reduce su ritmo por sí sola, y reintentar una y otra vez solo mantiene el límite activo.
  </Accordion>

  <Accordion title="Diagnosticar cualquier otro problema">
    Abre **Ver → Salida** y elige el canal **Square Cloud** para ver un registro de cada llamada a la API, e inclúyelo cuando informes de un error en [GitHub](https://github.com/squarecloudofc/vscode-extension).
  </Accordion>

  <Accordion title="Los datos parecen desactualizados">
    Haz clic en el elemento de la barra de estado o en el icono de actualizar en la barra de título de la barra lateral. Recuerda que la actualización periódica se pausa mientras la ventana no tiene el foco.
  </Accordion>
</AccordionGroup>
