---
id: "sistema.ssh-projeto-remoto"
titulo: "Abrir un proyecto en otra máquina"
resumo: "Cree un proyecto o un workspace apuntando a una carpeta que existe en un host SSH."
idioma: "es"
tipo: "tutorial"
categoria: "ambientes"
aplicavelDesde: "0.0.16"
capabilities: ["environment.ssh.project"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/sistema/ssh-projeto-remoto/"
fonte: "pt-br/sistema/ssh-projeto-remoto.md"
caminhoPublico: "docs/publica/es/sistema/ssh-projeto-remoto.md"
hashFonte: "sha256:73d2931401e3ee5c8a88ea3142d614506668338edafa474a1d10cb8f6e99f32e"
hashDestaPagina: "sha256:8313541b5db35f9c079aeb213c226b21200856669e75bb5da06fdc5cb191653d"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/sistema/ssh-projeto-remoto.md fonteHash=sha256:73d2931401e3ee5c8a88ea3142d614506668338edafa474a1d10cb8f6e99f32e estado=atual -->

Este tutorial lo lleva desde el host registrado hasta un workspace ejecutándose en un host SSH. El
proyecto **no se copia**: la app registra una ruta que existe en la máquina remota, y el trabajo pasa a
ocurrir allí.

## Requisitos previos

- Un host SSH ya registrado y conectado. Si aún no lo tiene, empiece por [Hosts SSH](/docs/es/sistema/ssh-hosts/).
- La ruta de la carpeta del proyecto **en el host**. La elegirá con el explorador de carpetas remoto.
- Git instalado en el host, si el proyecto es un repositorio.

## Paso 1 — Añadir el proyecto

1. Abra el flujo de **Añadir proyecto**.
2. Elija **Otra máquina (SSH)**.
3. Seleccione el **host** en la lista.
4. Elija la **ruta** de la carpeta del proyecto.

Si el host está desconectado, la pantalla muestra **Connect**. Conecte antes de elegir la ruta — el
explorador de carpetas necesita la conexión para listar lo que existe del otro lado.

**El explorador de carpetas es el del host, no el de su computadora.** Lista directorios que existen en la
máquina remota. Si espera ver su carpeta personal, está en la pantalla equivocada.

## Paso 2 — Confirmar la creación

Al confirmar, la app registra el proyecto apuntando a la carpeta remota. Nada se descarga a su computadora
y ningún archivo se sube al host.

## Paso 3 — Crear un workspace

1. Abra **Nuevo workspace**.
2. Elija el host SSH como destino.
3. Si el host no está conectado, use **Connect**.
4. Indique la ruta del workspace y confirme.

El workspace pasa a existir dentro del proyecto, con los archivos resueltos en la carpeta del host.

## Resultado

- El proyecto aparece en la lista, marcado como remoto.
- La terminal del workspace se ejecuta en el host.
- Las operaciones de Git resuelven el repositorio que está en el host.
- Ningún archivo del proyecto se copió a su máquina.

## Límites

- **La conexión debe estar activa antes de prometer la creación.** Si la conexión falla, el error debe
  aparecer — un proyecto apuntando a una ruta inalcanzable no es útil y no debe parecer creado.
- **No elija una ruta local para un host remoto.** El explorador de carpetas remoto existe precisamente
  para evitar ese error.
- **La ruta remota debe existir en el host.** La app apunta a una carpeta; no crea el repositorio por
  usted.
- **Git en el host depende del host.** Versión, configuración y credenciales son de la máquina remota.

## Si algo no funciona

1. **Host desconectado.** Use **Connect** en la propia pantalla e intente de nuevo.
2. **La carpeta no aparece en el explorador.** Confirme que la ruta existe en el host y que su cuenta
   tiene permiso de lectura allí.
3. **Error de conexión al crear.** Resuelva primero la conexión — vea la sección de diagnóstico en
   [Hosts SSH](/docs/es/sistema/ssh-hosts/).
4. **Proyecto creado apuntando al lugar equivocado.** Corríjalo en el registro del proyecto; nada se
   copió, así que no hay archivos que limpiar.

## Limpieza segura

Quitar el proyecto o el workspace de la app **no borra la carpeta en el host**. Nada en esta página
autoriza a borrar archivos en la máquina remota.

## Próximos pasos

- [Hosts SSH](/docs/es/sistema/ssh-hosts/)