Você quer instalar a extensão GitHub Copilot no Visual Studio Code para receber sugestões de código com IA enquanto digita. A extensão conecta seu editor VS Code ao GitHub Copilot, um serviço que usa modelos da OpenAI para sugerir linhas ou blocos de código inteiros. Este artigo explica os pré-requisitos, mostra o processo de instalação passo a passo e aborda problemas comuns que podem impedir o funcionamento correto da extensão.
Principais Pontos: Instalação do GitHub Copilot no VS Code
- Painel de Extensões do VS Code (Ctrl+Shift+X): Local principal para pesquisar e instalar a extensão GitHub Copilot.
- Conta GitHub com assinatura ativa do Copilot: Necessária antes que a extensão possa gerar sugestões; inscreva-se em github.com/features/copilot.
- Configurações da extensão > GitHub Copilot > Enable: Ative esta opção após a instalação para ativar as sugestões de IA.
O que a Extensão GitHub Copilot Faz e o que Você Precisa Antes de Instalar
GitHub Copilot é um programador parceiro de IA que sugere código enquanto você digita. Ele funciona dentro do editor VS Code analisando o contexto do arquivo atual e do projeto aberto. A extensão em si é gratuita para instalar, mas você precisa de uma assinatura ativa do GitHub Copilot para receber sugestões. As assinaturas estão disponíveis para indivíduos, estudantes e organizações através do GitHub. Você também precisa de uma conta GitHub e do VS Code versão 1.78 ou superior. A extensão é compatível com Windows 10, Windows 11, macOS e Linux.
Lista de Verificação de Pré-requisitos
Antes de começar, confirme se os itens a seguir estão em ordem:
- Visual Studio Code instalado (versão 1.78 ou superior). Você pode verificar em Ajuda > Sobre no VS Code.
- Uma conta GitHub. Se não tiver uma, crie em github.com/join.
- Uma assinatura ativa do GitHub Copilot. Planos individuais custam US$ 10 por mês ou US$ 100 por ano. Estudantes com e-mail .edu verificado podem obtê-la gratuitamente através do GitHub Student Developer Pack.
- Conexão de internet estável. O Copilot envia o contexto do código para os servidores do GitHub para processamento.
Passos para Instalar a Extensão GitHub Copilot no VS Code
Siga estes passos para instalar a extensão e ativá-la com sua conta GitHub.
- Abra o VS Code
Inicie o Visual Studio Code pelo menu Iniciar, dock ou atalho da área de trabalho. Certifique-se de estar usando uma versão compatível. Se vir uma notificação sobre uma versão mais recente, atualize o VS Code antes de prosseguir. - Abra o painel de Extensões
Pressione Ctrl+Shift+X no Windows ou Linux, ou Cmd+Shift+X no macOS. Alternativamente, clique no ícone de Extensões na Barra de Atividades à esquerda da janela. - Pesquise por GitHub Copilot
Na barra de pesquisa do painel de Extensões, digite GitHub Copilot. A extensão oficial é publicada pelo GitHub e tem um ícone azul com um rosto de robô branco. Verifique se o nome do publicador é GitHub e o nome da extensão é GitHub Copilot. - Instale a extensão
Clique no botão Instalar no cartão da extensão GitHub Copilot. O VS Code baixa e instala a extensão. Esse processo leva alguns segundos. Você pode ver uma mensagem de status no canto inferior direito confirmando a instalação. - Faça login no GitHub
Após a instalação, o VS Code solicita que você faça login no GitHub. Clique em Fazer login na notificação que aparece. Uma janela do navegador abre pedindo para autorizar o VS Code a acessar sua conta GitHub. Clique em Autorizar Visual Studio Code. Se você já estiver logado no GitHub no navegador, a autorização é concluída automaticamente. Caso contrário, faça login no GitHub primeiro e depois autorize. - Verifique se a extensão está ativa
Após a autorização, volte ao VS Code. Olhe na barra de status no canto inferior direito. Você deve ver o ícone do Copilot, que se parece com um pequeno rosto de robô. Passe o mouse sobre ele para ver a mensagem de status. Deve aparecer Copilot: Ativo ou Copilot: Pronto. Se aparecer Copilot: Desativado, clique no ícone e selecione Ativar. - Teste a extensão
Abra um novo arquivo no VS Code pressionando Ctrl+N. Defina o idioma como Python clicando no indicador de idioma na barra de status e selecionando Python. Digite um comentário como# função para calcular fatoriale pressione Enter. O Copilot deve sugerir um bloco de código em texto cinza. Pressione Tab para aceitar a sugestão.
Problemas Comuns Após Instalar o GitHub Copilot
Ícone do Copilot mostra Desativado ou Não Conectado
Se o ícone do Copilot na barra de status mostrar Desativado ou Não Conectado, a extensão está instalada mas não autenticada. Clique no ícone e selecione Fazer login. Se a janela do navegador não abrir, verifique se seu navegador padrão não está bloqueando pop-ups do VS Code. Você também pode fazer login manualmente abrindo a Paleta de Comandos com Ctrl+Shift+P, digitando GitHub Copilot: Fazer login e pressionando Enter.
Nenhuma sugestão aparece ao digitar
Se o Copilot estiver ativo mas nenhuma sugestão aparecer, verifique o seguinte: Primeiro, certifique-se de que seu arquivo tem um idioma suportado. O Copilot funciona com a maioria das linguagens populares, incluindo Python, JavaScript, TypeScript, Ruby, Go, C++ e Java. Segundo, verifique se o Copilot está ativado para esse idioma. Abra Arquivo > Preferências > Configurações, pesquise por GitHub Copilot: Ativar e confirme se o idioma que você está usando está listado. Terceiro, verifique o status da sua assinatura em github.com/settings/copilot. Se sua assinatura expirou ou o pagamento está pendente, o Copilot para de gerar sugestões.
A extensão não instala devido a restrições de rede
Redes corporativas ou VPNs às vezes bloqueiam o marketplace do VS Code. Se o botão Instalar não responder ou você vir um erro de rede, tente o seguinte: Baixe o arquivo VSIX da extensão diretamente do site Visual Studio Marketplace em marketplace.visualstudio.com. Pesquise por GitHub Copilot, clique no botão Baixar Extensão, depois no VS Code abra o painel de Extensões, clique no menu de três pontos, selecione Instalar do VSIX e escolha o arquivo baixado. Alternativamente, peça à sua equipe de TI para liberar marketplace.visualstudio.com e todos os subdomínios.
GitHub Copilot Free vs GitHub Copilot Pro: Principais Diferenças
| Item | GitHub Copilot Free | GitHub Copilot Pro |
|---|---|---|
| Preço mensal | Gratuito para estudantes e mantenedores de código aberto | US$ 10 por mês para indivíduos |
| Sugestões de código | Até 2000 conclusões por mês | Conclusões ilimitadas |
| Idiomas suportados | Todos os idiomas suportados pelo Copilot | Todos os idiomas suportados pelo Copilot |
| Acesso ao chat | Limitado ao Copilot Chat no VS Code | Copilot Chat completo com conversas sensíveis ao contexto |
| Suporte a IDEs | VS Code, JetBrains, Neovim | VS Code, JetBrains, Neovim, Visual Studio, Azure Data Studio |
Após instalar a extensão GitHub Copilot, você pode começar a usá-la imediatamente. Abra um projeto e comece a digitar para ver as sugestões. Personalize o comportamento abrindo a Paleta de Comandos com Ctrl+Shift+P e pesquisando por GitHub Copilot: Configurar. Você pode ajustar o atraso das sugestões, desativar sugestões para idiomas específicos ou ativar/desativar sugestões inline. Para a melhor experiência, mantenha tanto o VS Code quanto a extensão atualizados para as versões mais recentes.