Você precisa de sugestões de código e assistência por chat ao editar arquivos em um servidor remoto através do VS Code Remote SSH. O GitHub Copilot pode fornecer esses recursos, mas apenas se a extensão estiver instalada e autenticada corretamente nas máquinas local e remota. Este artigo explica como configurar o GitHub Copilot com Remote SSH, quais são os pré-requisitos e como verificar se a extensão está ativa no host remoto.
Principais Conclusões: Configurando o GitHub Copilot no Remote SSH
- Extensão VS Code Remote SSH: Deve estar instalada localmente para conectar ao host remoto.
- Extensão GitHub Copilot versão 1.10+: Suporta desenvolvimento remoto; instale-a nas máquinas local e remota.
- Ícone da barra de status do GitHub Copilot: Mostra uma marca de verificação quando a extensão está ativa no host remoto.
Como o GitHub Copilot Funciona com Remote SSH
O GitHub Copilot é uma ferramenta de conclusão de código baseada em nuvem. Quando você usa o VS Code Remote SSH, sua instância local do VS Code se conecta a um servidor remoto. A extensão do Copilot é executada no host remoto. Ela envia o contexto do código do workspace remoto para os servidores do GitHub e recebe sugestões. A extensão deve ser instalada na máquina remota através do sistema de instalação remota de extensões do VS Code. Não é necessária instalação manual no servidor. A máquina local precisa apenas da extensão Remote SSH e da extensão Copilot instaladas localmente para acionar a instalação remota.
Pré-requisitos
Antes de começar, confirme estes itens:
- VS Code versão 1.80 ou posterior instalado na máquina local.
- Extensão Remote SSH instalada localmente.
- Uma assinatura ativa do GitHub Copilot (Copilot Individual, Business ou Enterprise).
- Acesso SSH ao servidor remoto com credenciais válidas.
- O servidor remoto deve ter acesso à internet para alcançar a API do GitHub.
Passos para Ativar o GitHub Copilot em uma Sessão Remote SSH
Siga estes passos para instalar e ativar o GitHub Copilot em um host remoto.
- Instale a extensão Remote SSH localmente
Abra o VS Code na máquina local. Vá para a visualização de Extensões pressionando Ctrl+Shift+X. Pesquise por “Remote SSH” e instale a extensão da Microsoft. - Instale o GitHub Copilot localmente
Na visualização de Extensões, pesquise por “GitHub Copilot” e instale a extensão. Faça login com sua conta do GitHub quando solicitado. Conclua o fluxo de autenticação no navegador. - Conecte-se ao host remoto
Pressione F1 para abrir a Paleta de Comandos. Digite “Remote-SSH: Connect to Host” e selecione. Insira a string de conexão SSH, por exemplo usuario@hostname. Escolha seu arquivo de configuração SSH, se necessário. O VS Code abre uma nova janela conectada ao host remoto. - Instale o GitHub Copilot no host remoto
Na janela remota, abra a visualização de Extensões. Você verá uma seção chamada “Local – Instalado” e “SSH: hostname – Instalado”. Encontre o GitHub Copilot em “Local – Instalado”. Clique no pequeno ícone de nuvem com uma seta ao lado do nome da extensão. Isso instala o Copilot no host remoto. Aguarde a instalação terminar. - Verifique se o Copilot está ativo no host remoto
Olhe para a barra de status no canto inferior direito. O ícone do Copilot deve mostrar uma marca de verificação. Se mostrar um círculo girando, aguarde alguns segundos. Abra um arquivo do workspace remoto e comece a digitar. Você deve ver sugestões de texto fantasma em cinza aparecerem.
Problemas Comuns e Limitações
Copilot Não Mostra Sugestões Após Instalação Remota
Se o texto fantasma não aparecer, a extensão pode não estar autenticada no host remoto. Abra a Paleta de Comandos com F1, digite “GitHub Copilot: Sign In” e selecione. Conclua o processo de login novamente. Isso reautentica a extensão no lado remoto.
Ícone do Copilot Mostra um Triângulo de Advertência
Um triângulo amarelo significa que a extensão está desabilitada no host remoto. Abra a visualização de Extensões, encontre o GitHub Copilot em “SSH: hostname – Instalado” e clique no botão Ativar. Se o botão não estiver visível, recarregue a janela remota usando o comando da Paleta de Comandos “Developer: Reload Window”.
Copilot Chat Não Disponível no Host Remoto
O GitHub Copilot Chat requer uma extensão separada. Instale o GitHub Copilot Chat localmente da mesma forma que instalou o Copilot. Em seguida, clique no ícone de nuvem para instalá-lo no host remoto. Após a instalação, abra a visualização de Chat pressionando Ctrl+Shift+I. O painel de chat deve aparecer na janela remota.
Sugestões Lentas na Conexão Remota
As sugestões podem atrasar se o servidor remoto tiver alta latência para os servidores do GitHub. Teste executando ping api.github.com no terminal remoto. Latência acima de 100 ms pode causar atrasos. Considere usar um servidor mais próximo dos data centers do GitHub ou verifique sua configuração de rede.
Comparação de Recursos: GitHub Copilot Local vs Remoto
| Item | VS Code Local | Remote SSH |
|---|---|---|
| Local da extensão | Executada na máquina local | Executada no host remoto após instalação na nuvem |
| Autenticação | Login único via navegador | Requer login separado no host remoto |
| Contexto de código enviado | Do workspace local | Do workspace remoto |
| Requisito de rede | Acesso à internet local | Host remoto deve ter acesso à internet |
| Copilot Chat | Disponível como extensão separada | Deve ser instalado separadamente no remoto |
O GitHub Copilot funciona em sessões Remote SSH assim que a extensão é instalada no host remoto através do recurso de instalação na nuvem do VS Code. Após concluir os passos acima, você pode usar conclusões inline e o Copilot Chat em qualquer arquivo armazenado no servidor remoto. Para equipes que usam o Copilot Business, verifique se o tráfego de saída do host remoto é permitido para api.github.com. Para melhorar ainda mais o desempenho, configure seu arquivo de configuração SSH com a opção “ServerAliveInterval 60” para manter a conexão estável durante longas sessões de codificação.