---
id: "terminal-criar-e-navegar-sessoes"
titulo: "Criar e navegar entre sessões"
resumo: "Como abrir um terminal ou um agente na tela Terminal, alternar entre as abas abertas e descobrir o que está rodando."
idioma: "pt-br"
tipo: "guia"
categoria: "telas"
aplicavelDesde: "0.0.16"
capabilities: ["terminal.sessions.create", "terminal.sessions.discover"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/terminal/criar-e-navegar-sessoes/"
fonte: "pt-br/ferramentas/terminal/criar-e-navegar-sessoes.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/terminal/criar-e-navegar-sessoes.md"
hashFonte: "sha256:f676a58fdb101ef044b808478ee26f96d70dccb5f6e51c651c9da58388ab59f1"
hashDestaPagina: "sha256:f676a58fdb101ef044b808478ee26f96d70dccb5f6e51c651c9da58388ab59f1"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## Abrir um shell

1. Abra a tela **Terminal** do projeto.
2. Na barra de abas, use o botão de nova aba.
3. No Windows, o mesmo menu oferece o shell: **PowerShell**, **CMD Prompt**, **Git Bash** ou **WSL**. Em macOS e Linux, a aba nova usa o shell padrão da máquina.

A sessão nasce no diretório de trabalho do projeto e passa a ser uma aba da tela Terminal.

## Abrir um agente

Uma CLI de agente é uma sessão como qualquer outra: ela roda no painel, com histórico, busca e restauração iguais às de um shell.

Se você já sabe qual agente quer, criar a sessão **já com o agente** é melhor do que abrir um shell e digitar o comando: a sessão nasce com o processo certo, sem uma janela em que um shell está no controle.

**O que esperar:** o agente ainda está subindo quando a criação termina. Escrever nele nesse instante chega embaralhado — o texto cai no shell antes de a interface do agente assumir. Espere o agente ficar ocioso antes de enviar a primeira mensagem; o passo a passo está em [Trabalhar com um agente no Terminal](/docs/pt-br/ferramentas/terminal/sessoes-de-agente/).

## Alternar entre abas

- Clique na aba para ativá-la.
- Quando há abas fora da área visível, a barra de abas rola: use as setas nas pontas para alcançá-las.
- Trocar de aba **não** interrompe o que está rodando nas outras.

## Descobrir o que está aberto

Além da própria barra de abas, existe a listagem de sessões, útil quando há muitas abas, quando você quer o identificador de uma sessão ou quando a sessão está em outro workspace.

O que a listagem devolve:

- uma entrada por sessão viva, com título, identificador e o workspace a que pertence;
- **`totalCount`** — quantas sessões existem de fato;
- **`truncated`** — se a lista que você recebeu está cortada, por paginação ou pelo teto interno do servidor.

> **Leia `truncated` antes de concluir que a lista está completa.** A listagem tem um teto interno de segurança; paginar só muda o que é exibido, não o teto.

Sessões criadas a partir de um cartão do Canvas podem demorar alguns segundos para aparecer na listagem.

## Detalhes e troca de foco

- **Detalhar uma sessão** devolve metadados e uma prévia do que está na tela, sem encerrar nem escrever nada no processo.
- **Trocar para uma sessão** muda a aba visível — o mesmo efeito de clicar na aba. Não muda o que está rodando.

## Por linha de comando

Para criar, listar, detalhar e trocar de aba sem sair do terminal, veja [Referência de comandos do Terminal](/docs/pt-br/ferramentas/terminal/referencia-cli/) — os comandos de criação, listagem, detalhe e troca, com as opções de seleção de workspace e paginação.

## Se algo não funcionar

- **A sessão não aparece na listagem:** confira o workspace da consulta e o campo `truncated`; sessões de cartão do Canvas demoram alguns segundos.
- **O agente recebeu texto embaralhado:** você escreveu antes de a interface dele assumir. Use [Ler, enviar e esperar](/docs/pt-br/ferramentas/terminal/ler-enviar-e-esperar/) para esperar a condição certa antes de escrever.
- **O painel não abre:** siga [Quando o terminal não abre](/docs/pt-br/ferramentas/terminal/quando-nao-abre/).