GitHub Copilot no VS Code no Linux: Problemas de Compatibilidade Conhecidos

O GitHub Copilot pode não ativar ou fornecer sugestões no Visual Studio Code em distribuições Linux como Ubuntu, Fedora ou Debian. Esse problema geralmente decorre de dependências de tempo de execução ausentes, configurações de proxy incorretas ou extensões do VS Code desatualizadas. Este artigo explica as causas raiz dessas falhas de compatibilidade e fornece correções passo a passo para cada cenário.

Por que o Copilot Falha no Linux

O GitHub Copilot funciona como um servidor de linguagem que se conecta à API do GitHub. No Linux, esse servidor requer uma versão moderna da glibc, especificamente libc6 2.28 ou posterior. Muitas distribuições Linux empresariais ou versões LTS antigas vêm com libc6 2.27 ou anterior. Quando o servidor de linguagem não consegue carregar, o VS Code não mostra erro, mas o Copilot nunca ativa.

Uma segunda causa comum é a restrição de rede. O Copilot precisa enviar contexto de código para api.github.com. Firewalls corporativos ou proxies que bloqueiam tráfego HTTPS de saída impedem a extensão de autenticar ou gerar sugestões. O VS Code pode exibir um ícone giratório na barra de status sem concluir a conexão.

Uma terceira causa é uma instalação corrompida ou incompleta do VS Code. Versões Flatpak ou Snap do VS Code às vezes não têm as permissões de sistema de arquivos necessárias para executar o binário do servidor de linguagem do Copilot. Pacotes nativos .deb ou .rpm evitam essa limitação.

Passos para Diagnosticar e Corrigir o Copilot no Linux

Verificar a Versão da glibc

1. Abra um terminal
   Execute o comando ldd --version. A primeira linha mostra a versão da glibc. Se for inferior a 2.28, o Copilot não pode iniciar.
2. Atualize a glibc se possível
   No Ubuntu, execute sudo apt update && sudo apt upgrade libc6. No Fedora, execute sudo dnf update glibc. Se a distribuição não fornecer uma glibc mais recente, considere atualizar o SO para uma versão mais nova, como Ubuntu 22.04 ou Fedora 38.
3. Verifique a atualização
   Execute ldd --version novamente. Confirme que a versão agora é 2.28 ou superior. Reinicie o VS Code após a atualização.

Configurar as Definições de Proxy

1. Abra as configurações do VS Code
   Pressione Ctrl+Virgula para abrir as Configurações. Pesquise por proxy.
2. Defina HTTP_PROXY e HTTPS_PROXY
   Insira a URL do proxy nos campos Http: Proxy e Https: Proxy. Por exemplo, http://proxy.empresa.com:8080. Não inclua credenciais de autenticação na URL.
3. Defina variáveis de ambiente no perfil do shell
   Adicione estas linhas ao ~/.bashrc ou ~/.zshrc:
   export HTTP_PROXY=http://proxy.empresa.com:8080
export HTTPS_PROXY=http://proxy.empresa.com:8080
   Execute source ~/.bashrc e reinicie o VS Code.
4. Teste a conectividade
   Em um terminal, execute curl -I https://api.github.com. Espere uma resposta 200 ou 301. Se obtiver timeout ou conexão recusada, o proxy ou firewall está bloqueando a requisição.

Reinstale o VS Code Usando Pacote Nativo

1. Remova a instalação existente do VS Code
   Se instalou via Flatpak, execute flatpak uninstall com.visualstudio.code. Para Snap, execute sudo snap remove code.
2. Baixe o pacote .deb ou .rpm
   Acesse code.visualstudio.com e baixe o pacote para sua distribuição. Para Ubuntu ou Debian, escolha o arquivo .deb.
3. Instale o pacote
   Execute sudo dpkg -i ~/Downloads/code_deb para sistemas baseados em Debian. Para Fedora, execute sudo rpm -i ~/Downloads/code-rpm.
4. Instale a extensão GitHub Copilot
   Abra o VS Code, vá para a visualização de Extensões, pesquise por GitHub Copilot e clique em Instalar. Faça login com sua conta do GitHub quando solicitado.

Se o Copilot Ainda Tiver Problemas Após a Correção Principal

Copilot Mostra “Não Conectado” Apesar do Login Bem-Sucedido

Isso ocorre quando o token de autenticação não é armazenado corretamente. Abra a paleta de comandos com Ctrl+Shift+P, digite GitHub Copilot: Sign Out e faça login novamente. Se o problema persistir, exclua o arquivo de token em cache: rm -rf ~/.config/Code/CachedData//github-copilot e reinicie o VS Code.

Copilot Apenas Sugere Completudes de Linha Única

Sugestões de várias linhas exigem que o servidor de linguagem do Copilot tenha memória suficiente. Em sistemas Linux com pouca memória, o servidor pode expirar. Aumente o limite de memória adicionando "github.copilot.advanced": { "memoryMB": 512 } ao arquivo settings.json do VS Code. Reinicie o VS Code após fazer a alteração.

Copilot Não Funciona com Remote SSH ou Containers

Ao usar a extensão Remote-SSH, o Copilot é executado na máquina remota. O host remoto também deve atender ao requisito de glibc e ter acesso HTTPS de saída. Instale a extensão Copilot no host remoto selecionando Extensões > Instalar Extensão na janela remota. Se o host remoto usar uma glibc antiga, atualize-o ou use uma imagem de contêiner baseada em Ubuntu 22.04 ou posterior.

GitHub Copilot no VS Code no Linux vs Windows: Principais Diferenças

Item	Linux	Windows
Dependência glibc	Requer libc6 2.28 ou mais recente	Nenhuma dependência equivalente; Windows 10 ou 11 funciona imediatamente
Configuração de proxy	Deve definir HTTP_PROXY e HTTPS_PROXY no shell ou nas configurações do VS Code	Usa as configurações de proxy do sistema automaticamente
Instalação do pacote	Pacote nativo .deb ou .rpm recomendado; Flatpak e Snap podem falhar	Instalador .exe funciona universalmente
Suporte a Remote SSH	O host remoto deve atender aos mesmos requisitos de glibc e rede	Host remoto no Windows ou Linux funciona sem configuração extra

Para resumir, o GitHub Copilot no Linux falha principalmente devido a uma biblioteca glibc desatualizada, configuração de proxy ausente ou um pacote não nativo do VS Code. Verifique sua versão da glibc com ldd --version e atualize para 2.28 ou superior. Defina as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY se você usar um proxy corporativo. Reinstale o VS Code usando o pacote oficial .deb ou .rpm para evitar problemas de permissão. Após aplicar essas correções, o Copilot deve gerar sugestões de forma confiável em seu ambiente Linux.