O GitHub Copilot é uma ferramenta de conclusão de código com IA que sugere linhas ou blocos de código enquanto você digita. Ao iniciar um novo projeto no Visual Studio, o Copilot não é ativado automaticamente. Você precisa instalar a extensão, fazer login com uma conta GitHub que tenha uma assinatura ativa do Copilot e verificar se a integração funciona no ambiente do seu projeto. Este artigo explica o processo completo de configuração do GitHub Copilot em um novo projeto do Visual Studio, abordando instalação, autenticação e configuração inicial.
Principais pontos: Configuração do GitHub Copilot no Visual Studio
- Extensões > Gerenciar Extensões > GitHub Copilot: Instale a extensão oficial do Copilot para Visual Studio 2022 ou posterior.
- Conta GitHub com assinatura do Copilot: Você precisa de um plano ativo do GitHub Copilot (individual, business ou enterprise) antes de fazer login.
- Ferramentas > Opções > GitHub > Copilot: Ajuste o comportamento das sugestões e ative ou desative as sugestões por projeto.
O que o GitHub Copilot faz no Visual Studio
O GitHub Copilot fornece sugestões de código geradas por IA diretamente no editor. Ele analisa o contexto do arquivo atual, incluindo comentários, nomes de funções e código ao redor, para propor conclusões. A ferramenta oferece suporte a C#, C++, JavaScript, Python, TypeScript e muitas outras linguagens comuns em projetos do Visual Studio.
Antes de usar o Copilot, você precisa do seguinte:
- Visual Studio 2022 versão 17.4 ou posterior instalado no Windows
- Uma conta GitHub com uma assinatura ativa do Copilot (Individual, Business ou Enterprise)
- Acesso à internet para autenticar e receber sugestões do serviço Copilot
O Copilot não requer SDKs adicionais ou modelos de projeto. Ele funciona com qualquer projeto .NET, C++ ou web. A extensão se comunica com o backend do GitHub Copilot via HTTPS e não armazena seu código nos servidores do GitHub.
Passos para instalar e ativar o GitHub Copilot em um novo projeto
Siga estes passos para configurar o Copilot em um novo projeto do Visual Studio. O processo cobre instalação, autenticação e verificação.
- Abra o Visual Studio e vá em Extensões
Inicie o Visual Studio 2022. No menu superior, clique em Extensões e depois selecione Gerenciar Extensões. Isso abre a janela do Gerenciador de Extensões, onde você pode navegar e instalar extensões. - Pesquise por GitHub Copilot
No Gerenciador de Extensões, clique na guia Online à esquerda. Digite GitHub Copilot na caixa de pesquisa. A extensão oficial publicada pelo GitHub aparece nos resultados. Verifique se o editor é GitHub Inc. e se o nome da extensão corresponde. - Instale a extensão
Clique no botão Download ao lado da extensão GitHub Copilot. O Visual Studio baixa o pacote e solicita que você feche o IDE para concluir a instalação. Clique em Fechar e aguarde o instalador VSIX ser executado. Siga as instruções do instalador e reinicie o Visual Studio quando solicitado. - Crie um novo projeto
Após reiniciar, clique em Criar um novo projeto na janela inicial. Escolha um modelo de projeto, como Aplicativo de Console, API Web ASP.NET Core ou Biblioteca de Classes. Defina o nome do projeto, local e nome da solução e clique em Criar. - Faça login no GitHub pelo ícone de status do Copilot
Observe a barra de status do Visual Studio na parte inferior da janela. Você verá um ícone do Copilot que parece uma pequena cabeça de robô. Clique no ícone. Uma caixa de diálogo solicita que você faça login no GitHub. Clique em Entrar. Seu navegador padrão abre uma página de autorização do GitHub. Insira suas credenciais do GitHub e autorize a extensão do Copilot. Se você tiver a autenticação de dois fatores ativada, conclua essa etapa também. - Verifique a ativação do Copilot
Volte ao Visual Studio. O ícone do Copilot na barra de status muda para uma cabeça de robô preenchida, indicando que o Copilot está ativo. Abra um arquivo de código, como Program.cs ou Startup.cs. Comece a digitar um nome de função comoprivate voidou um comentário como// calcular total. O Copilot exibe uma sugestão em cinza. Pressione Tab para aceitar a sugestão ou Esc para descartá-la. - Ajuste as configurações do Copilot se necessário
Vá em Ferramentas > Opções > GitHub > Copilot. Aqui você pode ativar ou desativar as seguintes opções:- Ativar GitHub Copilot – ativa ou desativa as sugestões globalmente
- Ativer conclusões – controla se as sugestões inline aparecem
- Ativar texto fantasma – mostra ou oculta o texto de pré-visualização no editor
As alterações entram em vigor imediatamente sem reiniciar o Visual Studio.
Problemas comuns de configuração e como resolvê-los
Ícone do Copilot mostra uma cabeça de robô riscada
Esse ícone significa que o Copilot está desativado ou não autenticado. Clique no ícone e selecione Ativar Copilot. Se a opção estiver esmaecida, faça logout e login novamente usando o botão Entrar no mesmo menu.
Nenhuma sugestão aparece após o login
Verifique sua conexão com a internet. O Copilot requer uma conexão ativa com a API do GitHub. Além disso, verifique se sua assinatura do GitHub Copilot está ativa visitando github.com/settings/copilot. Se a assinatura expirou, você precisa renová-la para que as sugestões funcionem.
Sugestões do Copilot estão lentas ou atrasadas
Isso pode acontecer se o arquivo do projeto for muito grande ou se a latência da rede for alta. Tente fechar arquivos e guias não utilizados. Você também pode reduzir a frequência das sugestões indo em Ferramentas > Opções > GitHub > Copilot e definindo Atraso de conclusão para um valor mais alto, como 1500 milissegundos.
O Copilot sugere código no idioma errado
O Copilot detecta a linguagem de programação com base na extensão do arquivo. Certifique-se de que seu arquivo tenha a extensão correta, como .cs para C#, .py para Python ou .js para JavaScript. Se você renomear um arquivo com uma extensão diferente, o Copilot pode interpretar mal o contexto.
GitHub Copilot Free vs GitHub Copilot Pro: Principais diferenças
| Item | GitHub Copilot Free | GitHub Copilot Pro |
|---|---|---|
| Preço mensal | Gratuito para estudantes, professores e mantenedores de código aberto verificados | US$ 10 por mês para usuários individuais |
| Sugestões de código | Até 2000 conclusões por mês | Conclusões ilimitadas |
| Suporte por chat | Não incluído | GitHub Copilot Chat no IDE |
| Acesso à organização | Não | Sim via Copilot Business ou Enterprise |
| IDEs compatíveis | Visual Studio Code, JetBrains, Neovim | Todos os IDEs compatíveis, incluindo Visual Studio |
O Copilot Free é limitado em conclusões mensais e não inclui o recurso de chat. Para desenvolvimento ativo no Visual Studio, a assinatura Pro é recomendada, pois remove o limite mensal e adiciona assistência por chat. Se você faz parte de uma equipe, verifique se sua organização fornece uma licença do Copilot Business.
Após concluir a configuração, você já pode usar o GitHub Copilot em seu novo projeto do Visual Studio. A extensão sugerirá código enquanto você digita, com base no contexto do projeto e nos seus padrões de codificação. Para aproveitar ao máximo o Copilot, escreva comentários claros e defina as assinaturas das funções antes do corpo. Isso ajuda a IA a gerar sugestões mais precisas. Como próximo passo, explore o painel Copilot Chat, disponível em Exibir > Outras Janelas > GitHub Copilot Chat, para fazer perguntas sobre seu código ou gerar código a partir de prompts em linguagem natural.