---
id: "terminal-criar-e-navegar-sessoes"
titulo: "Crear y navegar entre sesiones"
resumo: "Cómo abrir una terminal o un agente en la pantalla Terminal, alternar entre las pestañas abiertas y descubrir qué está ejecutándose."
idioma: "es"
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/es/ferramentas/terminal/criar-e-navegar-sessoes/"
fonte: "pt-br/ferramentas/terminal/criar-e-navegar-sessoes.md"
caminhoPublico: "docs/publica/es/ferramentas/terminal/criar-e-navegar-sessoes.md"
hashFonte: "sha256:f676a58fdb101ef044b808478ee26f96d70dccb5f6e51c651c9da58388ab59f1"
hashDestaPagina: "sha256:d5ea268043c98c3ac6f0e37bb6fb2a3705c954e801568d0666ce84ed6a282caf"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/terminal/criar-e-navegar-sessoes.md fonteHash=sha256:f676a58fdb101ef044b808478ee26f96d70dccb5f6e51c651c9da58388ab59f1 estado=atual -->

## Abrir un shell

1. Abre la pantalla **Terminal** del proyecto.
2. En la barra de pestañas, usa el botón de pestaña nueva.
3. En Windows, el mismo menú ofrece el shell: **PowerShell**, **CMD Prompt**, **Git Bash** o **WSL**. En macOS y Linux, la pestaña nueva usa el shell predeterminado de la máquina.

La sesión nace en el directorio de trabajo del proyecto y pasa a ser una pestaña de la pantalla Terminal.

## Abrir un agente

Una CLI de agente es una sesión como cualquier otra: se ejecuta en el panel, con historial, búsqueda y restauración idénticos a los de un shell.

Si ya sabes qué agente quieres, crear la sesión **ya con el agente** es mejor que abrir un shell y escribir el comando: la sesión nace con el proceso correcto, sin una ventana en la que un shell tiene el control.

**Qué esperar:** el agente todavía está subiendo cuando la creación termina. Escribirle en ese instante llega mezclado — el texto cae en el shell antes de que la interfaz del agente tome el control. Espera a que el agente quede ocioso antes de enviar el primer mensaje; el paso a paso está en [Trabajar con un agente en la Terminal](/docs/es/ferramentas/terminal/sessoes-de-agente/).

## Alternar entre pestañas

- Haz clic en la pestaña para activarla.
- Cuando hay pestañas fuera del área visible, la barra de pestañas se desplaza: usa las flechas de los extremos para alcanzarlas.
- Cambiar de pestaña **no** interrumpe lo que está ejecutándose en las demás.

## Descubrir qué está abierto

Además de la propia barra de pestañas, existe la lista de sesiones, útil cuando hay muchas pestañas, cuando quieres el identificador de una sesión o cuando la sesión está en otro workspace.

Lo que la lista devuelve:

- una entrada por sesión viva, con título, identificador y el workspace al que pertenece;
- **`totalCount`** — cuántas sesiones existen de hecho;
- **`truncated`** — si la lista que recibiste está cortada, por paginación o por el techo interno del servidor.

> **Lee `truncated` antes de concluir que la lista está completa.** La lista tiene un techo interno de seguridad; paginar solo cambia lo que se muestra, no el techo.

Las sesiones creadas a partir de una tarjeta del Canvas pueden tardar unos segundos en aparecer en la lista.

## Detalles y cambio de foco

- **Inspeccionar una sesión** devuelve metadatos y una vista previa de lo que está en pantalla, sin terminar ni escribir nada en el proceso.
- **Cambiar a una sesión** cambia la pestaña visible — el mismo efecto que hacer clic en la pestaña. No cambia lo que está ejecutándose.

## Por línea de comandos

Para crear, listar, inspeccionar y cambiar de pestaña sin salir de la terminal, consulta [Referencia de comandos de la Terminal](/docs/es/ferramentas/terminal/referencia-cli/) — los comandos de creación, listado, detalle y cambio, con las opciones de selección de workspace y paginación.

## Si algo no funciona

- **La sesión no aparece en la lista:** revisa el workspace de la consulta y el campo `truncated`; las sesiones de tarjeta del Canvas tardan unos segundos.
- **El agente recibió texto mezclado:** escribiste antes de que su interfaz tomara el control. Usa [Leer, enviar y esperar](/docs/es/ferramentas/terminal/ler-enviar-e-esperar/) para esperar la condición correcta antes de escribir.
- **El panel no abre:** sigue [Cuando la terminal no abre](/docs/es/ferramentas/terminal/quando-nao-abre/).