O GitHub Copilot é uma ferramenta de conclusão de código com IA que sugere linhas ou blocos inteiros de código enquanto você digita. No IntelliJ IDEA, o plugin se integra diretamente ao editor, oferecendo sugestões com base no contexto do seu projeto. Este artigo explica como instalar, configurar e solucionar problemas do plugin GitHub Copilot no IntelliJ IDEA. Ele cobre pré-requisitos, configuração passo a passo, erros comuns de configuração e uma comparação dos planos do Copilot.
Principais pontos: Configuração do GitHub Copilot no IntelliJ IDEA
- IntelliJ IDEA Marketplace > Plugins > GitHub Copilot: Instale o plugin oficial do JetBrains Marketplace.
- File > Settings > Tools > GitHub Copilot: Configure o comportamento das sugestões, atalhos de teclado e autenticação.
- Ctrl+Shift+Enter ou Alt+Insert: Aceite ou navegue pelas sugestões do Copilot durante a edição de código.
Plugin GitHub Copilot para IntelliJ IDEA: O que ele faz
O GitHub Copilot atua como um programador parceiro de IA. Ele analisa o código que você escreve, incluindo comentários e assinaturas de funções, e gera trechos de código relevantes. O plugin funciona com todas as principais linguagens suportadas pelo IntelliJ IDEA, incluindo Java, Python, JavaScript, TypeScript, C++ e Go.
Antes de começar, você precisa de uma conta GitHub com uma assinatura ativa do Copilot. O Copilot está disponível em dois planos: Copilot Individual por 10 USD por mês e Copilot Business por 19 USD por usuário por mês. O plano Business inclui gerenciamento de organização e controles de política. Você também precisa do IntelliJ IDEA versão 2021.2 ou posterior. O plugin é compatível com as edições Community, Ultimate e todas as outras.
Como o Copilot sugere código
O Copilot usa o OpenAI Codex, um modelo derivado do GPT-3 treinado em repositórios públicos do GitHub. Quando você digita código, o plugin envia o contexto atual do arquivo para os servidores do GitHub. O modelo gera uma ou mais conclusões. O IntelliJ IDEA exibe essas sugestões como texto fantasma inline. Você aceita uma sugestão com Tab ou Ctrl+Shift+Enter. Você pode navegar pelas alternativas com Alt+Insert ou Ctrl+Shift+Enter, dependendo do seu mapa de teclas.
Lista de verificação de pré-requisitos
- Conta GitHub ativa com assinatura paga do Copilot
- IntelliJ IDEA 2021.2 ou mais recente
- Conexão com a internet para autenticação e geração de sugestões
- Opcional: Acesso de administrador da organização para configuração de políticas do Copilot Business
Instalar e autenticar o GitHub Copilot no IntelliJ IDEA
- Abra o IntelliJ IDEA e vá para Settings
Clique em File no menu superior e selecione Settings. No macOS, use IntelliJ IDEA na barra de menus e escolha Preferences. - Navegue até Plugins
Na janela Settings, clique em Plugins no painel esquerdo. Certifique-se de que a aba Marketplace está selecionada. - Pesquise por GitHub Copilot
Digite GitHub Copilot na barra de pesquisa. O plugin oficial aparece como GitHub Copilot by GitHub. Clique em Install. - Reinicie o IntelliJ IDEA
Após a instalação, clique em Restart IDE para ativar o plugin. - Abra a janela de ferramentas do Copilot
Após reiniciar, clique no ícone do Copilot na barra de ferramentas direita. O ícone parece uma pequena cabeça de robô. Alternativamente, use View > Tool Windows > GitHub Copilot. - Autentique-se com o GitHub
Na janela de ferramentas do Copilot, clique em Sign In. Uma janela do navegador abre pedindo para autorizar o plugin. Faça login no GitHub e aprove a solicitação. O plugin exibe uma mensagem de sucesso. - Verifique a conexão
Abra um arquivo de código. Comece a digitar uma função ou um comentário. Sugestões de texto fantasma devem aparecer. Pressione Tab para aceitar.
Configurar as configurações do Copilot no IntelliJ IDEA
Após a instalação, você pode ajustar como o Copilot se comporta. Abra File > Settings > Tools > GitHub Copilot. As seguintes opções estão disponíveis:
- Enable Copilot: Ative ou desative o plugin globalmente.
- Suggestion delay: Defina um atraso em milissegundos antes que as sugestões apareçam. O padrão é 0 milissegundos.
- Show suggestions as ghost text: Desative para mostrar sugestões apenas quando você pressionar uma tecla.
- Enable for all languages: Desmarque linguagens específicas para desativar o Copilot para elas.
- Keybindings: Altere a tecla de aceitar sugestão de Tab para qualquer outra tecla.
Atalhos de teclado personalizados para o Copilot
O IntelliJ IDEA permite reatribuir todas as ações do Copilot. Vá para File > Settings > Keymap. Pesquise por Copilot. Você pode alterar as seguintes ações:
- Accept Suggestion: O padrão é Tab.
- Next Suggestion: O padrão é Alt+Insert ou Ctrl+Shift+Enter.
- Previous Suggestion: O padrão é Alt+Insert ou Ctrl+Shift+Enter com modificador.
- Toggle Copilot Enablement: O padrão é sem atalho. Atribua um como Ctrl+Shift+.
Erros comuns de configuração e como corrigi-los
Sugestões do Copilot não aparecem
Se o texto fantasma estiver ausente, primeiro confirme se o plugin está ativado. Verifique File > Settings > Tools > GitHub Copilot e certifique-se de que Enable Copilot está marcado. Verifique também sua conexão com a internet. O Copilot envia código para os servidores do GitHub e requer uma conexão ativa. Se você estiver atrás de um proxy corporativo, configure as configurações de proxy no IntelliJ IDEA em File > Settings > Appearance & Behavior > System Settings > HTTP Proxy.
A autenticação falha repetidamente
A autenticação usa OAuth através do seu navegador padrão. Se o navegador não abrir, vá manualmente para File > Settings > Tools > GitHub Copilot e clique em Reset Authentication. Em seguida, clique em Sign In novamente. Se você usa autenticação de dois fatores, certifique-se de aprovar a solicitação no seu aplicativo autenticador. Para o Copilot Business, o proprietário da sua organização GitHub deve conceder acesso ao plugin Copilot.
O Copilot deixa o IntelliJ IDEA lento
O plugin em si usa recursos locais mínimos. No entanto, a latência de rede pode causar atrasos. Aumente o atraso da sugestão em Settings > Tools > GitHub Copilot para 200 milissegundos. Isso impede que o Copilot envie solicitações a cada tecla pressionada. Alternativamente, desative o Copilot para linguagens que você raramente usa.
Sugestões imprecisas ou irrelevantes
O Copilot baseia as sugestões no contexto atual do arquivo. Se o seu projeto tiver pouco código existente, as sugestões podem ser genéricas. Escreva comentários descritivos e nomes de funções para melhorar o contexto. Por exemplo, em vez de // calcular, escreva // calcular o preço total com imposto. O Copilot também aprende com seu estilo de codificação ao longo do tempo. Ele não armazena seu código permanentemente, mas usa o contexto da sessão.
| Item | Copilot Individual | Copilot Business |
|---|---|---|
| Descrição | Assistente de IA pessoal para desenvolvedores individuais | Assistente de IA em equipe com gerenciamento de organização |
| Preço | 10 USD por mês | 19 USD por usuário por mês |
| Controles de administrador | Nenhum | Filtragem de sugestões baseada em políticas e logs de auditoria |
| Exclusão de código | Exclusão manual de arquivos via .gitignore | Políticas de exclusão em toda a organização |
| IDEs suportadas | IntelliJ IDEA, VS Code, Neovim, suíte JetBrains | Mesmo que Individual |
Após concluir a configuração, você pode começar a usar o Copilot no seu fluxo de trabalho diário de codificação. O plugin se integra às ferramentas de refatoração, depurador e executor de testes do IntelliJ IDEA. Para uso avançado, experimente o Copilot Chat, um plugin separado que adiciona um painel de chat para fazer perguntas sobre código. O plugin de chat é gratuito para todos os assinantes do Copilot.