---
id: "terminal-quando-nao-abre"
titulo: "Quando o terminal não abre"
resumo: "O que fazer quando o painel mostra erro, quando a sessão não sobe e quando um workspace remoto perde a conexão."
idioma: "pt-br"
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/pt-br/ferramentas/terminal/quando-nao-abre/"
fonte: "pt-br/ferramentas/terminal/quando-nao-abre.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/terminal/quando-nao-abre.md"
hashFonte: "sha256:6bfbfa7a0cd12b2eabab903e36d58f3884f67e27fa8a0e9fbee5a0ee1c46d17d"
hashDestaPagina: "sha256:6bfbfa7a0cd12b2eabab903e36d58f3884f67e27fa8a0e9fbee5a0ee1c46d17d"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Erro no painel não é tudo a mesma coisa. O aviso que aparece no painel traz ações diferentes conforme a causa, e escolher a ação errada pode reiniciar mais do que o necessário.

## Sintoma → o que fazer

| Sintoma | Ação oferecida | O que ela faz |
|---|---|---|
| **A sessão não abre e o painel mostra uma recusa de abertura** | **Tentar de novo** | Refaz a abertura do terminal, sem mexer no que já está rodando nos outros painéis |
| **O painel aponta falha do serviço de terminais (diretório de trabalho perdido)** | **Reiniciar o serviço** | Reinicia o serviço que hospeda os terminais |
| **A conexão de um workspace remoto caiu** | **Reconectar** | Reabre a conexão do host; a recuperação passa pelo aviso de reconexão, não pelo reinício local |
| **O painel de um agente pede reinício por troca de conta** | **Reiniciar o painel** | Recria o painel com a sessão do agente; o arranjo de divisões do painel é preservado |
| **Você quer relatar o problema** | **Relatar** | Abre o caminho de relato a partir do próprio aviso |

## Reiniciar o serviço de terminais

Essa ação **não é oferecida para qualquer erro**. Ela aparece quando a falha tem a marca de serviço obsoleto — o caso em que o diretório de trabalho se perdeu — e **não aparece** em conexões remotas nem quando a criação de processo está bloqueada. Nesses casos, insistir no reinício local não resolveria.

**O que ela alcança:** reiniciar o serviço afeta **todos** os terminais que ele hospeda, não só o painel com erro. Se você tem trabalho em andamento em outros painéis, trate o reinício como uma ação de impacto amplo.

## Reiniciar o painel de um agente

Reiniciar o painel de um agente **troca o processo**: o que não foi salvo na sessão anterior se perde. O que se preserva é o arranjo — a posição e as divisões daquele painel continuam onde estavam.

## Reconexão de workspace remoto

Em um workspace remoto, a recuperação é outra: o painel mostra o aviso de reconexão, e o caminho é reabrir a conexão com o host. **Reiniciar o serviço local não é a resposta para uma queda de conexão remota** — e, enquanto a conexão não volta, o painel remoto não responde.

Se o host está indisponível, nenhuma ação no painel resolve: verifique o acesso ao host antes de repetir.

## O que fazer depois de recuperar

1. Confirme que a sessão voltou a responder.
2. **Releia o histórico** — depois de uma recuperação, o conteúdo pode ter sido restaurado ou reiniciado; não presuma que a saída anterior está toda lá.
3. Se o problema se repetir no mesmo painel, relate pelo próprio aviso, com o que você estava fazendo quando falhou.

## Relacionados

- [Retomar depois de reiniciar](/docs/pt-br/ferramentas/terminal/retomar-sessoes/)
- [Trabalhar com um agente no Terminal](/docs/pt-br/ferramentas/terminal/sessoes-de-agente/)