Remote-SSH no VS Code: Como Programar Direto em um Servidor Remoto

Olá devs! 💜

Na semana passada, vimos o que é SSH e como gerar suas chaves para acessar servidores remotos com segurança.

Hoje vamos usar isso na prática para programar direto em um servidor remoto, sem sair do VS Code.

🥰 Siga nossa página no Linkedin e no Instagram e ajude a divulgar nosso conteúdo. Por mais mulheres em tech!

Se você trabalha com servidores, VPS, Raspberry Pi ou qualquer máquina remota, provavelmente já passou pelo processo chato de editar arquivos via terminal com vim ou nano, depois fazer upload por scp, testar, repetir.

A extensão Remote - SSH do VS Code elimina esse ciclo: você abre o VS Code localmente, mas todo o código, terminal e execução acontecem no servidor remoto, como se ele estivesse na sua máquina.

• Como criar sua própria Skill no Claude (exemplo real)

• Atalhos do VS Code que toda dev precisa saber

• O que eu faria se estivesse começando HOJE na programação (em 2026)

• Uma página para acelerar sua jornada em tecnologia

Em vez de copiar arquivos entre seu computador e o servidor, o VS Code se conecta via SSH e roda um pequeno servidor (o “VS Code Server”) na máquina remota. Você trabalha com:

• Editor completo, com IntelliSense e extensões

• Terminal integrado já dentro do servidor

• Debugger funcionando remotamente

• Explorador de arquivos da máquina remota

Tudo isso sem precisar instalar o VS Code no servidor manualmente; ele faz isso por você na primeira conexão.

1. Abra o VS Code

2. Vá em Extensions (Ctrl+Shift+X)

3. Busque por Remote - SSH (publicada pela Microsoft)

4. Clique em instalar

Isso também instala o pacote Remote Development, que inclui suporte a containers e WSL (vale a pena ter tudo junto).

Antes de tudo, você precisa conseguir acessar o servidor via SSH normalmente pelo terminal:

ssh usuario@ip-do-servidor

Se isso funciona, a extensão também vai funcionar. Se não, configure suas chaves SSH primeiro (veja o post anterior sobre SSH).

1. Pressione Ctrl+Shift+P para abrir a paleta de comandos

2. Digite Remote-SSH: Connect to Host

3. Escolha Add New SSH Host

4. Digite o comando de conexão:

ssh usuario@ip-do-servidor

5. Selecione onde salvar a configuração (geralmente ~/.ssh/config)

Uma nova janela do VS Code abre, conectando ao servidor. Na primeira vez, ele baixa e instala o VS Code Server remotamente (pode levar alguns minutos dependendo da conexão).

Para conexões frequentes, vale configurar o arquivo ~/.ssh/config manualmente:

Host meu-servidor
    HostName 192.168.1.100
    User ubuntu
    Port 22

Depois disso, ao conectar pela extensão, “meu-servidor” aparece como opção direta na lista de hosts — sem precisar digitar IP e usuário toda vez.

Depois de conectado:

1. Ctrl+Shift+P → File: Open Folder

2. Navegue até o diretório do projeto no servidor

3. Confirme

A partir daqui, o explorador de arquivos, o terminal e qualquer comando rodam diretamente no servidor.

Um detalhe importante: extensões precisam ser instaladas na sessão remota separadamente.

Extensões de UI (temas, ícones) ficam locais, mas linters, formatadores e ferramentas de linguagem precisam estar instalados no lado remoto; o VS Code geralmente sugere isso automaticamente quando detecta a necessidade.

• Desenvolvimento em VPS — código roda direto no servidor de produção (ou staging), sem sincronizar arquivos manualmente.

• Raspberry Pi e IoT — edite e debugue código que interage com hardware sem precisar de monitor conectado ao dispositivo.

• Máquinas com mais poder de processamento — edite localmente a interface, mas rode builds, testes ou treinamento de modelos numa máquina remota mais robusta.

• Ambientes padronizados de equipe — todo o time se conecta ao mesmo servidor de desenvolvimento, eliminando o clássico “funciona na minha máquina”.

Combine o Remote-SSH com o ~/.ssh/config e suas chaves já configuradas, e a transição entre “minha máquina” e “servidor” vira só uma troca de aba.

Sem fricção, sem upload manual, sem perder o ambiente que você já conhece no VS Code.

Até a próxima! 🚀