---
id: "terminal-quando-nao-abre"
titulo: "Cuando la terminal no abre"
resumo: "Qué hacer cuando el panel muestra un error, cuando la sesión no sube y cuando un workspace remoto pierde la conexión."
idioma: "es"
tipo: "solucao-de-problemas"
categoria: "telas"
aplicavelDesde: "0.0.16"
capabilities: ["terminal.runtime.recover"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/ferramentas/terminal/quando-nao-abre/"
fonte: "pt-br/ferramentas/terminal/quando-nao-abre.md"
caminhoPublico: "docs/publica/es/ferramentas/terminal/quando-nao-abre.md"
hashFonte: "sha256:6bfbfa7a0cd12b2eabab903e36d58f3884f67e27fa8a0e9fbee5a0ee1c46d17d"
hashDestaPagina: "sha256:eea8c4d1b5b56f23cd64cd8317bc3b09ec710921fcc9ede190a1cdd0773b4be2"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/terminal/quando-nao-abre.md fonteHash=sha256:6bfbfa7a0cd12b2eabab903e36d58f3884f67e27fa8a0e9fbee5a0ee1c46d17d estado=atual -->

Un error en el panel no es todo lo mismo. El aviso que aparece en el panel trae acciones diferentes según la causa, y elegir la acción equivocada puede reiniciar más de lo necesario.

## Síntoma → qué hacer

| Síntoma | Acción ofrecida | Qué hace |
|---|---|---|
| **La sesión no abre y el panel muestra un rechazo de apertura** | **Intentar de nuevo** | Rehace la apertura de la terminal, sin tocar lo que ya está ejecutándose en los otros paneles |
| **El panel señala un fallo del servicio de terminales (directorio de trabajo perdido)** | **Reiniciar el servicio** | Reinicia el servicio que hospeda las terminales |
| **La conexión de un workspace remoto se cayó** | **Reconectar** | Reabre la conexión del host; la recuperación pasa por el aviso de reconexión, no por el reinicio local |
| **El panel de un agente pide reinicio por cambio de cuenta** | **Reiniciar el panel** | Recrea el panel con la sesión del agente; la disposición de divisiones de ese panel se conserva |
| **Quieres reportar el problema** | **Reportar** | Abre el camino de reporte desde el propio aviso |

## Reiniciar el servicio de terminales

Esta acción **no se ofrece para cualquier error**. Aparece cuando el fallo tiene la marca de servicio obsoleto — el caso en que el directorio de trabajo se perdió — y **no aparece** en conexiones remotas ni cuando la creación de procesos está bloqueada. En esos casos, insistir en el reinicio local no resolvería nada.

**Qué alcanza:** reiniciar el servicio afecta a **todas** las terminales que hospeda, no solo al panel con error. Si tienes trabajo en curso en otros paneles, trata el reinicio como una acción de impacto amplio.

## Reiniciar el panel de un agente

Reiniciar el panel de un agente **sustituye el proceso**: lo que no se guardó en la sesión anterior se pierde. Lo que se conserva es la disposición — la posición y las divisiones de ese panel siguen donde estaban.

## Reconexión de workspace remoto

En un workspace remoto, la recuperación es otra: el panel muestra el aviso de reconexión, y el camino es reabrir la conexión con el host. **Reiniciar el servicio local no es la respuesta a una caída de conexión remota** — y, mientras la conexión no vuelva, el panel remoto no responde.

Si el host está indisponible, ninguna acción en el panel lo resuelve: verifica el acceso al host antes de reintentar.

## Qué hacer después de recuperar

1. Confirma que la sesión volvió a responder.
2. **Relee el historial** — después de una recuperación, el contenido puede haberse restaurado o reiniciado; no supongas que la salida anterior está toda ahí.
3. Si el problema se repite en el mismo panel, repórtalo por el propio aviso, con lo que estabas haciendo cuando falló.

## Relacionados

- [Retomar después de reiniciar](/docs/es/ferramentas/terminal/retomar-sessoes/)
- [Trabajar con un agente en la Terminal](/docs/es/ferramentas/terminal/sessoes-de-agente/)