Instalar o GitHub Copilot é um processo rápido em qualquer um dos ambientes suportados, mas cada IDE tem suas particularidades: extensões diferentes, formas de login e verificações finais distintas. Este guia cobre o passo a passo completo nas três plataformas mais usadas — VS Code, JetBrains e Neovim — do download ao primeiro teste.
Antes de começar, confira os requisitos de sistema: conexão estável com a internet, uma conta no GitHub com plano ativo (há opção gratuita) e uma versão recente da IDE. Com isso em dia, a instalação leva poucos minutos.
Instalação no Visual Studio Code
O VS Code é o caminho mais simples. Abra o editor, acesse a aba de extensões (Ctrl+Shift+X ou Cmd+Shift+X no Mac) e pesquise por «GitHub Copilot». Instale a extensão oficial publicada pelo GitHub — verifique o publicador para evitar cópias de terceiros.
Após a instalação, o editor pedirá login na sua conta do GitHub. Clique no aviso ou no ícone do Copilot na barra de status, autorize no navegador e pronto: o ícone na barra inferior indica que o assistente está ativo. Se o ícone mostrar um alerta, o problema quase sempre é autenticação ou plano.
Primeiro teste no VS Code
Crie um arquivo novo com extensão de uma linguagem popular, como teste.py. Digite um comentário descritivo — por exemplo, «função que valida um endereço de e-mail» — e aguarde um instante. A sugestão aparece em texto esmaecido; pressione Tab para aceitar ou Esc para ignorar.
Se nada aparecer, verifique três pontos: o ícone do Copilot na barra de status está ativo, o arquivo tem uma linguagem reconhecida (veja o seletor no canto inferior direito) e a sua conexão está funcionando. O Copilot não opera offline, como explicamos no nosso FAQ.
Instalação nas IDEs JetBrains
Nas IDEs da JetBrains — IntelliJ, PyCharm, WebStorm e demais — o Copilot chega como plugin. Vá em File > Settings > Plugins (ou Preferences no Mac), abra a aba Marketplace e pesquise «GitHub Copilot». Instale o plugin oficial e reinicie a IDE quando solicitado.
No primeiro uso, um aviso pedirá login no GitHub: clique em «Sign in to GitHub», copie o código exibido e confirme no navegador. Depois disso, o Copilot aparece na barra de ferramentas e nas configurações, onde você ajusta comportamento por linguagem e atalhos.
Instalação no Neovim
O Neovim exige um pré-requisito extra: o Node.js instalado, porque o plugin do Copilot roda sobre ele. Com o Node em dia, adicione o plugin oficial copilot.vim pelo seu gerenciador preferido — packer, lazy.nvim ou vim-plug.
Depois de instalar, execute :Copilot setup dentro do Neovim para autenticar: o comando mostra um código e abre a página de autorização do GitHub. Concluído o login, as sugestões aparecem inline conforme você digita, e :Copilot status confirma o funcionamento.
Comparativo dos três caminhos
| Etapa | VS Code | JetBrains | Neovim |
|---|---|---|---|
| Formato | Extensão do Marketplace | Plugin do repositório JetBrains | Plugin copilot.vim |
| Pré-requisito extra | Nenhum | Nenhum | Node.js instalado |
| Login | Fluxo no navegador | Código + navegador | :Copilot setup |
| Verificação | Ícone na barra de status | Ícone na barra de ferramentas | :Copilot status |
| Recursos | Completos (chat, agente) | Completos (chat, agente) | Foco em autocomplete |
Problemas comuns na instalação
A maioria dos contratempos se concentra em poucos pontos conhecidos. Conhecê-los economiza tempo de diagnóstico:
- Login não completa: verifique se o navegador padrão abriu a página do GitHub e se a conta tem plano ativo.
- Sugestões não aparecem: confira se a extensão está habilitada para a linguagem do arquivo aberto.
- Proxy corporativo: redes com proxy podem exigir configuração adicional nas opções da IDE.
- Conflito de extensões: outros plugins de autocomplete podem disputar o Tab; ajuste a ordem de prioridade.
- Versão antiga da IDE: atualize o editor antes de culpar o plugin.
Ativação, pausa e controle
Instalado não significa ligado para sempre. Você pode pausar as sugestões por arquivo, por linguagem ou por projeto — útil em repositórios sensíveis. O controle fino de ativação em cada ambiente está detalhado no guia de como ativar e desativar o Copilot.
Também vale configurar exclusões: arquivos de configuração, segredos e pastas específicas podem ficar fora do contexto enviado à IA. As opções de ajuste fino estão no artigo de personalização do Copilot.
Conclusão
A instalação do Copilot é simples nos três ambientes: extensão, login, teste. O VS Code oferece o caminho mais curto, as IDEs JetBrains mantêm o padrão do seu ecossistema, e o Neovim pede apenas o Node.js como preparo. Com tudo funcionando, o próximo passo é aprender a usar a ferramenta de forma eficaz no dia a dia.
