Muitos desenvolvedores usam IDEs JetBrains como IntelliJ IDEA, PyCharm e WebStorm para programar. O GitHub Copilot oferece sugestões de código com IA diretamente no editor. Mas você precisa configurar o plugin e autenticar sua conta do GitHub antes de funcionar. Este artigo explica os passos exatos para instalar, autenticar e ajustar o GitHub Copilot em qualquer IDE JetBrains.
A configuração exige uma conta do GitHub com uma assinatura ativa do Copilot. O plugin é gratuito para instalar, mas o serviço requer um plano mensal ou anual. Abordamos tanto a configuração inicial quanto as opções que controlam o comportamento do Copilot.
Após seguir este guia, você poderá ativar ou desativar sugestões, ajustar atalhos de teclado e excluir determinados arquivos da análise do Copilot. O processo é idêntico em todos os produtos JetBrains.
Principais Pontos: Configuração do GitHub Copilot em IDEs JetBrains
- JetBrains Marketplace > Plugins > GitHub Copilot: Instale o plugin pelo marketplace oficial dentro da sua IDE.
- Tools > GitHub Copilot > Login to GitHub: Abre uma janela do navegador para autenticar sua conta do GitHub.
- File > Settings > Tools > GitHub Copilot: Ajuste o atraso das sugestões, ative sugestões para código público e gerencie exclusões de arquivos.
O que o GitHub Copilot Faz em IDEs JetBrains e o que Você Precisa
O GitHub Copilot é um programador parceiro de IA que sugere linhas de código e funções inteiras enquanto você digita. Em IDEs JetBrains, ele aparece como um plugin que se comunica com os servidores do GitHub. O plugin envia o contexto do código para gerar sugestões, portanto, uma conexão ativa com a internet é necessária.
Antes de configurar o Copilot, verifique estes pré-requisitos:
- Uma conta do GitHub com uma assinatura ativa do Copilot. Você pode usar o Copilot Individual, Copilot Business ou Copilot Enterprise.
- Uma IDE JetBrains versão 2021.2 ou posterior. Versões mais antigas não suportam o plugin.
- Uma conexão com a internet que possa acessar api.github.com e copilot-proxy.githubusercontent.com.
O plugin funciona com todos os principais produtos JetBrains. As etapas abaixo usam o IntelliJ IDEA como exemplo, mas os caminhos de menu são idênticos no PyCharm, WebStorm, GoLand, Rider e outros.
Passos para Instalar e Configurar o GitHub Copilot em IDEs JetBrains
Método 1: Instalar o Plugin do Marketplace
- Abra a janela de Plugins
Vá em File > Settings no Windows ou IntelliJ IDEA > Settings no macOS. Em seguida, selecione Plugins no painel esquerdo. - Pesquise por GitHub Copilot
Na aba Marketplace, digite GitHub Copilot na barra de pesquisa. O plugin oficial é publicado pelo GitHub. - Instale o plugin
Clique no botão Install ao lado do plugin. Aguarde o download terminar. Após a instalação, clique em Restart IDE quando solicitado.
Método 2: Autenticar Sua Conta do GitHub
- Abra o menu do Copilot
Após reiniciar, vá em Tools > GitHub Copilot > Login to GitHub. Uma janela aparecerá com um código de dispositivo. - Complete o login no navegador
Clique em Copy and Open Browser. A IDE copia o código e abre seu navegador padrão. Se o navegador não abrir, acesse manualmente https://github.com/login/device e cole o código. - Autorize o plugin do Copilot
No navegador, faça login na sua conta do GitHub. Clique em Authorize GitHub Copilot Plugin. Volte para a IDE. A janela confirma o login bem-sucedido.
Método 3: Ajustar as Configurações do Copilot
- Abra as configurações do Copilot
Vá em File > Settings > Tools > GitHub Copilot. No macOS, use IntelliJ IDEA > Settings > Tools > GitHub Copilot. - Defina o atraso das sugestões
No campo Completion Delay, insira um valor em milissegundos. O padrão é 1000 ms. Aumente para 2000 ms se as sugestões aparecerem muito rápido. Diminua para 500 ms para respostas mais rápidas. - Ative ou desative sugestões de código público
Marque ou desmarque Enable completions matching public code. Quando ativado, o Copilot pode sugerir código que corresponde a código público no GitHub. Desative se seu projeto exigir código original estrito. - Exclua arquivos específicos
Clique no link Manage Excluded Files. Adicione padrões de arquivo como min.js ou vendor/ para impedir que o Copilot sugira código nesses arquivos. Use o botão + para adicionar padrões e o botão – para removê-los.
Se o Copilot Não Funcionar Após a Configuração
Ícone do Copilot Está Cinza ou Ausente
Um ícone do Copilot cinza na barra de status significa que o plugin não está autenticado ou a IDE não consegue alcançar os servidores do GitHub. Reautentique indo em Tools > GitHub Copilot > Login to GitHub. Se o problema persistir, verifique as configurações de firewall ou proxy. A IDE deve conseguir se conectar a api.github.com e copilot-proxy.githubusercontent.com.
Copilot Não Mostra Sugestões em Certos Tipos de Arquivo
O Copilot funciona com a maioria dos tipos de arquivo, mas pode não ativar para linguagens que não reconhece. Certifique-se de que a extensão do arquivo está associada a uma linguagem suportada na sua IDE. Por exemplo, .js para JavaScript, .py para Python e .java para Java. Se o tipo de arquivo for personalizado, adicione-o nas configurações de tipo de arquivo da IDE em File > Settings > Editor > File Types.
Sugestões Estão Muito Lentas ou Muito Rápidas
A configuração de atraso das sugestões controla quanto tempo o Copilot espera antes de mostrar sugestões. Abra Settings > Tools > GitHub Copilot e ajuste o valor de Completion Delay. Um valor menor mostra sugestões mais rápido, mas pode distrair. Um valor maior dá tempo para digitar antes que as sugestões apareçam.
GitHub Copilot Free vs GitHub Copilot Pro: Principais Diferenças
| Item | GitHub Copilot Free | GitHub Copilot Pro |
|---|---|---|
| Preço mensal | $0 | $10 por mês |
| Sugestões de código | Até 2000 conclusões por mês | Conclusões ilimitadas |
| Acesso ao chat | Limitado a 50 mensagens de chat por mês | Mensagens de chat ilimitadas |
| Copilot na IDE | Suportado em IDEs JetBrains | Suportado em IDEs JetBrains |
| Correspondência de código público | Ativado por padrão, pode ser desativado | Ativado por padrão, pode ser desativado |
O GitHub Copilot Free é ideal para uso ocasional ou aprendizado. O Copilot Pro é adequado para desenvolvimento profissional diário, onde sugestões e chat ilimitados são necessários. Ambas as versões usam o mesmo plugin e as mesmas etapas de configuração nas IDEs JetBrains.
Agora você pode instalar, autenticar e ajustar o GitHub Copilot em qualquer IDE JetBrains. Comece instalando o plugin do marketplace, depois faça login com sua conta do GitHub. Para uma experiência mais suave, ajuste o atraso das sugestões e as exclusões de arquivos em Settings > Tools > GitHub Copilot. Para desativar o Copilot temporariamente, use o ícone na barra de status e selecione Disable Completions.