---
title: "VS Code Remote SSH: edite e rode código direto na sua VPS"
description: "Use a extensão Remote SSH do VS Code para editar código dentro da VPS, abrir terminal remoto, encaminhar portas e resolver o servidor travado ou sem memória."
url: "https://streethosting.com.br/guias/vps/vscode-remote-ssh-vps"
category: "vps"
slug: "vscode-remote-ssh-vps"
datePublished: "2026-11-13"
dateModified: "2026-11-13"
author: "Equipe StreetHosting"
difficulty: "iniciante"
language: "pt-BR"
keywords:
  - "vscode remote ssh"
  - "vs code remote ssh vps"
  - "editar codigo na vps"
  - "vscode server"
  - "encaminhar porta vscode"
  - "remote ssh travado"
---

# Como editar e rodar código direto na VPS com o VS Code Remote SSH

Com a extensão Remote SSH, o VS Code abre a pasta que está na VPS como se fosse local, com terminal, extensões e depurador rodando lá. Veja a configuração, o uso de memória e o que fazer quando trava.

> **Resposta rápida**
>
> Instale no VS Code a extensão **Remote - SSH**, da Microsoft, aperte `F1`, escolha `Remote-SSH: Connect to Host` e informe o apelido do seu `~/.ssh/config` ou `usuario@ip`. O VS Code instala um servidor pequeno na VPS e passa a abrir pastas, terminal e extensões direto nela. O servidor costuma ocupar algumas centenas de MB de RAM, e as portas do app são encaminhadas para o seu `localhost`.

## Como o Remote SSH funciona

O jeito comum de trabalhar com uma VPS é editar o código no computador, mandar para o servidor e testar lá. A cada ajuste pequeno você repete o ciclo. O Remote SSH muda isso: o VS Code do seu computador abre uma conexão SSH, instala na VPS um componente chamado **VS Code Server** e passa a conversar com ele.

O resultado é que a pasta aberta na janela está na VPS. O terminal integrado roda comandos na VPS. As extensões de linguagem, como o autocompletar de Python ou de TypeScript, rodam na VPS e enxergam o mesmo ambiente em que o código vai executar, com as mesmas versões de Node, Python e bibliotecas. O seu computador só desenha a interface.

Isso é útil quando o projeto depende de algo que só existe no servidor, como um banco de dados local, ou quando seu computador é fraco e a VPS compila mais rápido. Também evita o problema clássico de funcionar na sua máquina e falhar no servidor por diferença de versão.

## Conectar pela primeira vez

Antes de começar, o SSH precisa funcionar no seu terminal: se `ssh usuario@ip` não entra, o VS Code também não vai entrar. No Windows, o cliente OpenSSH já vem com o sistema, e o guia de [chave SSH no Windows](https://streethosting.com.br/guias/vps/configurar-chave-ssh-windows) mostra como deixar o login por chave pronto.

1. No VS Code, abra a aba de extensões, procure por **Remote - SSH** e instale a da Microsoft.
2. Aperte `F1` e rode `Remote-SSH: Connect to Host`.
3. A lista mostra todos os apelidos do seu arquivo ssh config. Escolha um, ou digite `usuario@ip` na hora.
4. Uma nova janela do VS Code abre. Se aparecer a pergunta sobre o tipo de sistema do servidor, escolha **Linux** e confirme a impressão digital (fingerprint) na primeira conexão.
5. Espere a instalação do servidor remoto. O canto inferior esquerdo passa a mostrar o nome do host, indicando que você está conectado.
6. Aperte F1, rode `File: Open Folder` e escolha uma pasta da VPS, como `/home/deploy/meuapp`.

> **Dica**
>
> Use o apelido do arquivo de configuração em vez de digitar usuário e IP toda vez. O guia de [ssh config para vários servidores](https://streethosting.com.br/guias/vps/ssh-config-varios-servidores) explica o formato. O Remote SSH lê esse mesmo arquivo, então chave, porta e usuário já vêm prontos.

## Trabalhar dentro da VPS

Depois de conectado, o VS Code se comporta como no seu computador, com algumas diferenças que vale conhecer:

- **Terminal integrado:** aperte F1 e rode `View: Toggle Terminal`. O atalho de teclado aparece ao lado do comando e muda conforme o layout do seu teclado. O terminal já é um shell da VPS, na pasta do projeto. É aqui que você roda `npm install`, `git pull` ou reinicia um serviço.
- **Extensões separadas:** as extensões de interface, como temas, ficam no seu computador. As de linguagem e de ferramentas precisam ser instaladas na VPS. No painel de extensões, as que estão só no seu computador ganham um botão para instalar no host SSH conectado.
- **Depurador e testes:** rodam na VPS, com o mesmo ambiente da aplicação em produção.
- **Arrastar arquivos:** arrastar um arquivo do seu computador para o explorador do VS Code envia o arquivo para a VPS.

> **Atenção**
>
> Editar na VPS significa que o arquivo salvo ali já está valendo. Se o app roda de uma pasta com recarga automática, cada Ctrl+S pode reiniciar a aplicação que atende usuários. Mantenha um ambiente de teste separado e use Git para o que vai para produção.

Um cuidado com processos de longa duração. O que você roda no terminal integrado pertence à sessão do VS Code: quando a janela fecha ou a conexão some por muito tempo, o processo vai junto. É o mesmo problema de [manter um processo rodando depois de fechar o SSH](https://streethosting.com.br/guias/vps/tmux-manter-processo-rodando-ssh). Para o que precisa ficar no ar, crie um [serviço systemd](https://streethosting.com.br/guias/vps/criar-servico-systemd-linux) e use o VS Code só para editar e reiniciar.

## Encaminhar portas

Você está desenvolvendo um site ou uma API que escuta na porta 3000 da VPS. Para abrir no navegador, não precisa liberar a porta no firewall nem expor o app para a internet: o VS Code cria um túnel pela conexão SSH que já existe.

1. Inicie o app no terminal integrado. Na maioria dos casos o VS Code detecta a porta aberta e avisa que a encaminhou.
2. Se não avisar, aperte F1, rode `Forward a Port` e digite 3000. As portas encaminhadas aparecem no painel de portas, ao lado do terminal.
3. Abra `http://localhost:3000` no navegador do seu computador. A requisição vai pelo túnel até a VPS.

Funciona para qualquer protocolo em TCP, não só HTTP: dá para encaminhar a porta de um banco de dados e usar um cliente gráfico no seu computador, mantendo o banco escutando só em `127.0.0.1` na VPS. Essa é a forma mais segura de acessar painéis e bancos durante o desenvolvimento. Fora do VS Code, o mesmo recurso existe no SSH com `ssh -L 3000:localhost:3000 apelido`.

## Quanta RAM ele usa

O VS Code Server não é um programa leve e pequeno como o SSH puro. Ele roda processos de Node para atender o editor, e as extensões de linguagem rodam em um processo próprio. Como ordem de grandeza, conte com algumas centenas de MB de RAM em um projeto pequeno, e mais que isso quando há muitas extensões ou um projeto com milhares de arquivos, porque o servidor indexa e observa as mudanças em todos eles. Não existe um número fixo: depende das extensões instaladas, da linguagem e do tamanho do projeto.

Para medir no seu caso, conecte, abra o projeto e rode no terminal integrado `free -h` e `ps aux --sort=-%mem | head`. Os processos do servidor aparecem com `.vscode-server` no caminho. O guia de [como verificar CPU, RAM e disco no Linux](https://streethosting.com.br/guias/vps/verificar-cpu-ram-disco-rede-linux) ajuda a ler essa saída.

- **Reduza as extensões na VPS:** instale lá só o que você usa de verdade para aquela linguagem.
- **Exclua pastas pesadas da observação:** em configurações, procure por `files.watcherExclude` e inclua pastas como node_modules e dist.
- **Considere uma VPS com mais folga:** se o app, o banco e o editor dividem 1 ou 2 GB, a conta aperta.

## Problemas comuns

- **A conexão cai ou o servidor é encerrado sozinho:** normalmente é falta de memória. O sistema mata o processo que mais consome, e o VS Code mostra que perdeu a conexão. Veja se o kernel registrou isso com `sudo dmesg | grep -i "killed process"`. A saída é criar memória virtual, como no guia de [swap no Ubuntu](https://streethosting.com.br/guias/vps/configurar-swap-ubuntu-vps), ou migrar para uma VPS com mais RAM.
- **Pede senha o tempo todo ou recusa a chave:** o Remote SSH abre várias conexões e cada uma pode pedir a senha da chave. Use um agente de chaves e `IdentitiesOnly yes` no bloco do host, como no guia de ssh config, e confira que `ssh apelido` entra no terminal comum.
- **Fica parado em "Setting up SSH Host" ou "Installing VS Code Server":** a instalação pode ter ficado corrompida, ou a VPS não conseguiu baixar o servidor. Teste `curl -I https://update.code.visualstudio.com` na VPS para ver se há saída para a internet, e depois limpe a instalação, como mostrado abaixo.
- **Disco cheio:** a pasta `~/.vscode-server` guarda versões antigas do servidor e as extensões. Se o disco acabar, a instalação nova falha.
- **Versão antiga do sistema:** versões recentes do VS Code Server exigem um Linux relativamente novo. No Ubuntu 22.04 e no 24.04 não há problema, mas distribuições muito antigas podem recusar a conexão com uma mensagem sobre a biblioteca do sistema.

Para limpar uma instalação travada, primeiro tente pelo próprio VS Code: aperte F1 e rode `Remote-SSH: Kill VS Code Server on Host`. Se nem isso funcionar, conecte por um terminal SSH comum e apague a pasta:

```
# encerra processos do servidor que ficaram presos
pkill -f vscode-server

# apaga a instalação; o VS Code baixa tudo de novo na próxima conexão
rm -rf ~/.vscode-server
```

Na conexão seguinte o VS Code reinstala o servidor do zero. Você perde as extensões remotas, que precisam ser instaladas de novo, e as configurações salvas só para aquela máquina. Seus arquivos e as configurações de projeto não ficam nessa pasta.

## Onde rodar

O Remote SSH precisa de um servidor Linux com SSH liberado, acesso à internet de saída para baixar o servidor e RAM suficiente para o editor e o app juntos. Nas [VPS da StreetHosting](https://streethosting.com.br/vps) você tem acesso root em KVM, IPv4 dedicado e liberdade para instalar o que o projeto pedir.

- **Projetos pequenos e testes:** a VPS Xeon, a partir de R$ 26,00 por mês, tem 2 vCPU, 2 GB de RAM e 20 GB NVMe.
- **Desenvolver com folga:** a [VPS Ryzen 9 9950X](https://streethosting.com.br/vps/ryzen) começa em R$ 43,00 por mês, com 1 vCPU e 2 GB DDR5, e vai até 64 GB de RAM para projetos maiores.

Todas ficam em São Paulo, com AntiDDoS incluso, até 5 TB de tráfego por mês e ativação em cerca de 60 segundos depois do Pix ou do cartão aprovado.

## Perguntas frequentes

### O Remote SSH é gratuito?

A extensão Remote - SSH é gratuita e vem da própria Microsoft, assim como o VS Code. Você só paga pela VPS. O servidor que o VS Code instala na VPS também não tem custo.

### Preciso instalar o VS Code na VPS?

Não. Você instala o VS Code no seu computador. Na primeira conexão, ele baixa e instala sozinho um pequeno servidor na VPS, o VS Code Server, dentro da pasta ~/.vscode-server do usuário que conectou.

### Meu código fica na VPS ou no meu computador?

Fica na VPS. O VS Code do seu computador funciona como tela e teclado: os arquivos, o terminal, as extensões de linguagem e a execução ficam todos no servidor. Por isso vale manter backup e usar Git.

### Como abro o site que está rodando na VPS no meu navegador?

Pelo encaminhamento de portas. Se o app escuta na porta 3000 da VPS, o VS Code a encaminha para a porta 3000 do seu computador, e você abre http://localhost:3000 no navegador local, sem liberar nada no firewall do servidor.

### O VS Code Remote SSH funciona em uma VPS com 1 GB de RAM?

Funciona para projetos pequenos, mas fica no limite, principalmente com várias extensões. Se o servidor travar ou a conexão cair, a causa costuma ser falta de memória. Ative swap ou use uma VPS com mais RAM.

## Guias relacionados

- [Arquivo ssh config: acesse vários servidores com um nome curto](https://streethosting.com.br/guias/vps/ssh-config-varios-servidores.md)
- [Configurar chave SSH no Windows para acessar a VPS](https://streethosting.com.br/guias/vps/configurar-chave-ssh-windows.md)
- [Como configurar memória swap no Ubuntu da VPS](https://streethosting.com.br/guias/vps/configurar-swap-ubuntu-vps.md)
- [tmux na VPS: como manter um processo rodando depois de fechar o SSH](https://streethosting.com.br/guias/vps/tmux-manter-processo-rodando-ssh.md)
- [Como criar um serviço systemd no Linux para rodar qualquer app](https://streethosting.com.br/guias/vps/criar-servico-systemd-linux.md)

## Produtos citados

- https://streethosting.com.br/vps
- https://streethosting.com.br/vps/ryzen

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "@type": [
      "Article",
      "TechArticle"
    ],
    "headline": "Como editar e rodar código direto na VPS com o VS Code Remote SSH",
    "name": "VS Code Remote SSH: edite e rode código direto na sua VPS",
    "abstract": "Com a extensão Remote SSH, o VS Code abre a pasta que está na VPS como se fosse local, com terminal, extensões e depurador rodando lá. Veja a configuração, o uso de memória e o que fazer quando trava.",
    "description": "Use a extensão Remote SSH do VS Code para editar código dentro da VPS, abrir terminal remoto, encaminhar portas e resolver o servidor travado ou sem memória.",
    "datePublished": "2026-11-13",
    "dateModified": "2026-11-13",
    "author": {
      "@type": "Organization",
      "name": "Equipe StreetHosting"
    },
    "publisher": {
      "@type": "Organization",
      "name": "StreetHosting",
      "url": "https://streethosting.com.br"
    },
    "inLanguage": "pt-BR",
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://streethosting.com.br/guias/vps/vscode-remote-ssh-vps"
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "O Remote SSH é gratuito?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "A extensão Remote - SSH é gratuita e vem da própria Microsoft, assim como o VS Code. Você só paga pela VPS. O servidor que o VS Code instala na VPS também não tem custo."
        }
      },
      {
        "@type": "Question",
        "name": "Preciso instalar o VS Code na VPS?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Não. Você instala o VS Code no seu computador. Na primeira conexão, ele baixa e instala sozinho um pequeno servidor na VPS, o VS Code Server, dentro da pasta ~/.vscode-server do usuário que conectou."
        }
      },
      {
        "@type": "Question",
        "name": "Meu código fica na VPS ou no meu computador?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Fica na VPS. O VS Code do seu computador funciona como tela e teclado: os arquivos, o terminal, as extensões de linguagem e a execução ficam todos no servidor. Por isso vale manter backup e usar Git."
        }
      },
      {
        "@type": "Question",
        "name": "Como abro o site que está rodando na VPS no meu navegador?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Pelo encaminhamento de portas. Se o app escuta na porta 3000 da VPS, o VS Code a encaminha para a porta 3000 do seu computador, e você abre http://localhost:3000 no navegador local, sem liberar nada no firewall do servidor."
        }
      },
      {
        "@type": "Question",
        "name": "O VS Code Remote SSH funciona em uma VPS com 1 GB de RAM?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Funciona para projetos pequenos, mas fica no limite, principalmente com várias extensões. Se o servidor travar ou a conexão cair, a causa costuma ser falta de memória. Ative swap ou use uma VPS com mais RAM."
        }
      }
    ]
  }
]
```