---
id: "sistema.ssh-projeto-remoto"
titulo: "Abrir um projeto em outra máquina"
resumo: "Crie um projeto ou um workspace apontando para uma pasta que existe num host SSH."
idioma: "pt-br"
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/pt-br/sistema/ssh-projeto-remoto/"
fonte: "pt-br/sistema/ssh-projeto-remoto.md"
caminhoPublico: "docs/publica/pt-br/sistema/ssh-projeto-remoto.md"
hashFonte: "sha256:73d2931401e3ee5c8a88ea3142d614506668338edafa474a1d10cb8f6e99f32e"
hashDestaPagina: "sha256:73d2931401e3ee5c8a88ea3142d614506668338edafa474a1d10cb8f6e99f32e"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Este tutorial leva você do host cadastrado até um workspace rodando num host SSH. O projeto **não é
copiado**: o app registra um caminho que existe na máquina remota, e o trabalho passa a acontecer lá.

## Pré-requisitos

- Um host SSH já cadastrado e conectado. Se ainda não tem, comece em [Hosts SSH](/docs/pt-br/sistema/ssh-hosts/).
- O caminho da pasta do projeto **no host**. Você vai escolhê-lo pelo navegador de pastas remoto.
- Git instalado no host, se o projeto for um repositório.

## Passo 1 — Adicionar o projeto

1. Abra o fluxo de **Adicionar projeto**.
2. Escolha **Outra máquina (SSH)**.
3. Selecione o **host** na lista.
4. Escolha o **caminho** da pasta do projeto.

Se o host estiver desconectado, a tela mostra **Conectar**. Conecte antes de escolher o caminho — o
navegador de pastas precisa da conexão para listar o que existe do outro lado.

**O navegador de pastas é o do host, não o do seu computador.** Ele lista diretórios que existem na
máquina remota. Se você espera ver a sua pasta pessoal, está na tela errada.

## Passo 2 — Confirmar a criação

Ao confirmar, o app registra o projeto apontando para a pasta remota. Nada é baixado para o seu
computador, e nenhum arquivo é enviado para o host.

## Passo 3 — Criar um workspace

1. Abra **Novo workspace**.
2. Escolha o host SSH como destino.
3. Se o host não estiver conectado, use **Conectar**.
4. Informe o caminho do workspace e confirme.

O workspace passa a existir dentro do projeto, com os arquivos resolvidos na pasta do host.

## Resultado

- O projeto aparece na lista, marcado como remoto.
- O terminal do workspace roda no host.
- As operações de Git resolvem o repositório que está no host.
- Nenhum arquivo do projeto foi copiado para a sua máquina.

## Limites

- **A conexão precisa estar de pé antes de prometer a criação.** Se a conexão falhar, o erro precisa
  aparecer — um projeto apontando para um caminho inalcançável não é útil e não deve parecer criado.
- **Não escolha um caminho local para um host remoto.** O navegador de pastas remoto existe exatamente
  para evitar esse engano.
- **O caminho remoto precisa existir no host.** O app aponta para uma pasta; ele não cria o repositório
  por você.
- **Git no host depende do host.** Versão, configuração e credenciais são as da máquina remota.

## Se algo não funcionar

1. **Host desconectado.** Use **Conectar** na própria tela e tente de novo.
2. **Pasta não aparece no navegador.** Confirme que o caminho existe no host e que a sua conta tem
   permissão de leitura nele.
3. **Erro de conexão na hora de criar.** Resolva a conexão primeiro — veja a seção de diagnóstico em
   [Hosts SSH](/docs/pt-br/sistema/ssh-hosts/).
4. **Projeto criado apontando para o lugar errado.** Corrija pelo cadastro do projeto; nada foi copiado,
   então não há arquivos a limpar.

## Limpeza segura

Remover o projeto ou o workspace do app **não apaga a pasta no host**. Nada nesta página autoriza apagar
arquivos na máquina remota.

## Próximos passos

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