Como usar o GitHub Copilot no VS Code para explicar e corrigir seu código

O GitHub Copilot no VS Code pode explicar trechos, sugerir código e propor correções sem que você precise sair do editor. O jeito mais seguro de começar é usá-lo como um colega que apresenta uma hipótese: você lê a mudança, executa os testes e só então decide se ela entra no projeto.

Este guia mostra o caminho para configurar o Copilot, conversar com os arquivos abertos, corrigir um erro simples e evitar os problemas mais comuns. A versão gratuita serve para experimentar, mas tem limites mensais e não transforma a ferramenta em uma fonte automática de código confiável.

O que é possível fazer com o GitHub Copilot no VS Code

O Copilot reúne experiências diferentes dentro do editor. As sugestões inline aparecem enquanto você digita; o chat responde a perguntas em linguagem natural; e o modo de agente pode analisar arquivos, planejar uma tarefa e propor alterações em mais de um ponto do projeto. O recurso disponível depende da sua conta, do plano e das configurações do VS Code.

Na prática, ele é mais útil em quatro situações:

• Entender código existente: peça uma explicação de uma função, classe ou erro de mensagem.
• Escrever um primeiro rascunho: descreva uma função pequena e informe a linguagem, entradas e saída esperada.
• Investigar falhas: envie a mensagem de erro, o trecho envolvido e o que você já tentou.
• Melhorar manutenção: solicite testes, validação de dados ou uma refatoração pequena, sempre revisando o diff.

Isso é diferente de pedir “faça meu sistema inteiro”. Quanto mais específico for o pedido, menor a chance de o modelo completar lacunas com uma solução que parece elegante, mas não combina com o projeto.

Como instalar e ativar o GitHub Copilot no VS Code

1. Instale ou atualize o Visual Studio Code no computador.
2. Abra o VS Code e clique no ícone do Copilot na barra de status.
3. Selecione Use AI Features e entre com sua conta do GitHub.
4. Se você ainda não tiver uma assinatura, o VS Code poderá oferecer o Copilot Free, com uma cota mensal de sugestões e créditos de IA.
5. Abra uma pasta de projeto e confirme que o arquivo está em uma linguagem reconhecida pelo editor.

O Copilot já aparece integrado às versões atuais do VS Code, mas o acesso continua ligado à conta do GitHub. Se o ícone não aparecer, atualize o editor, confira se você está conectado à conta correta e procure por “Copilot” na área de extensões.

Em um projeto novo, vale abrir o chat e digitar /init. Segundo a documentação do VS Code, esse comando analisa a base e cria instruções para ajudar a IA a seguir padrões do repositório. Não aceite o arquivo criado sem ler: ele pode registrar convenções erradas ou ignorar regras importantes do time.

Como pedir uma explicação sobre um trecho de código

Selecione a função ou classe, abra o chat pelo ícone no título do editor e escreva um pedido que delimite o contexto. No Windows e no Linux, o atalho do chat é Ctrl+Alt+I; para uma alteração rápida no próprio arquivo, use Ctrl+I.

Um prompt mais útil do que “explique isso” seria:

Explique esta função linha por linha. Informe quais entradas ela espera, o que retorna, quais exceções podem ocorrer e se há algum risco de segurança. Não altere o arquivo.

O detalhe “não altere o arquivo” é importante. Ele deixa claro que a tarefa é de leitura. Depois da resposta, confira se a explicação bate com o código e com as funções chamadas por ele. Uma descrição convincente não prova que o Copilot entendeu todas as regras do negócio.

Como usar o Copilot para corrigir um erro

Para corrigir um bug, não comece mandando a IA reescrever o arquivo inteiro. Use esta sequência:

1. Execute o programa ou o teste e copie a mensagem de erro completa.
2. Selecione o menor trecho que reproduz o problema.
3. Abra o chat ou o inline chat e informe o comportamento esperado.
4. Peça uma hipótese, a correção mínima e um teste que comprove o resultado.
5. Revise as alterações sugeridas e compare o diff antes de clicar para aceitar.
6. Rode novamente o teste e, se possível, os demais testes do projeto.

Experimente um pedido como este:

Este teste falha com a mensagem abaixo: [cole o erro]. O resultado esperado é [descreva o resultado]. Analise apenas os arquivos relacionados, proponha a menor correção possível e crie um teste para o caso que falhou. Explique por que a mudança resolve o problema.

O chat do VS Code pode responder com um resumo e alterações propostas. No modo de agente, ele também pode usar ferramentas do ambiente, dependendo das permissões. Por isso, leia quais arquivos serão modificados e não autorize comandos que você não entende, especialmente os que apagam arquivos, alteram banco de dados ou instalam dependências.

Como escrever prompts melhores para programação

Um bom pedido funciona como uma tarefa bem escrita para outra pessoa desenvolvedora. Inclua:

• Objetivo: o que deve mudar e o que precisa continuar igual.
• Contexto: linguagem, framework, versão relevante e arquivos envolvidos.
• Restrições: bibliotecas permitidas, padrão de nomes, compatibilidade e limite de desempenho.
• Critério de sucesso: teste, saída esperada ou comportamento observável.
• Formato da resposta: explicação, patch, lista de riscos ou código comentado.

Por exemplo, em vez de pedir “faça um login”, escreva: “Crie uma função em JavaScript que valide e-mail e senha, não armazene a senha em texto puro, retorne erros sem revelar qual campo falhou e inclua testes para entrada vazia”. Ainda será necessário revisar a implementação, mas o pedido reduz a margem para uma resposta genérica.

O que revisar antes de aceitar o código

O Copilot não executa a responsabilidade do programador. Antes de incorporar uma sugestão, confira:

• se o código compila e os testes passam;
• se a solução trata entradas vazias, limites e erros de rede;
• se não incluiu uma biblioteca desnecessária ou uma API desatualizada;
• se a mudança não expõe tokens, senhas, dados pessoais ou mensagens internas;
• se a licença e a origem do código são aceitáveis para o seu projeto;
• se o comportamento continua compatível com o que o usuário realmente precisa.

Um alerta especialmente importante: nunca cole chaves de API, conteúdo de arquivos .env, certificados ou dados reais de clientes no chat. Também confira as políticas do repositório e da empresa antes de habilitar recursos que enviem contexto para um serviço externo.

O Copilot Free é suficiente?

Para aprender e testar o fluxo, pode ser. A página de recursos do GitHub informa que o Copilot Free tem limite de 2.000 completions e 50 solicitações de chat por mês, incluindo edições pelo chat. Esses números podem mudar, então consulte a página oficial antes de tomar uma decisão de compra.

Quem programa todos os dias pode esbarrar na cota ou precisar de modelos e recursos adicionais dos planos pagos. A pergunta não é apenas “qual plano é mais barato”, mas quanto tempo a ferramenta realmente economiza depois de considerar revisão, testes e correção de respostas ruins. Para uma pessoa que ainda está aprendendo, o plano gratuito costuma ser um laboratório; para uma equipe, entram também privacidade, administração e política de uso.

Outro ponto que passa despercebido: a documentação do VS Code informa que a telemetria está habilitada por padrão na versão gratuita. É possível ajustar a coleta nas configurações do editor e nas opções do Copilot. Em computador compartilhado ou projeto sensível, faça essa revisão antes de trabalhar.

Erros comuns e como resolver

O Copilot não sugere nada

Verifique a conta conectada, a linguagem do arquivo, a conexão e se as sugestões inline foram desativadas. Também confira se uma política da organização bloqueou o recurso.

A resposta ignora arquivos importantes

Indique explicitamente os arquivos ou trechos relevantes e explique a relação entre eles. No chat, adicione contexto com os controles do próprio VS Code quando disponíveis, em vez de colar o projeto inteiro sem critério.

A correção compila, mas está errada

Isso normalmente significa que faltou contexto ou que o teste não cobriu o caso real. Descreva o resultado esperado, peça um teste de regressão e examine o diff linha por linha. Compilar é só o primeiro degrau.

Vale a pena usar o GitHub Copilot no VS Code?

Vale a pena para acelerar tarefas pequenas e reduzir o tempo gasto procurando exemplos, sobretudo quando você já sabe avaliar o resultado. Ele é menos indicado como “piloto automático” para sistemas inteiros, código de autenticação sem revisão ou decisões de arquitetura.

Se você trabalha com automação, o Copilot também pode ajudar a explicar scripts e gerar testes, mas não substitui a validação das permissões e dos efeitos colaterais. Para continuar explorando o ambiente de desenvolvimento do GitHub, veja também nosso guia sobre como usar o GitHub Codespaces para programar no navegador.

Fontes consultadas

• Microsoft: configuração do GitHub Copilot no VS Code.
• Microsoft: uso do chat no VS Code.
• Microsoft: GitHub Copilot no VS Code.
• GitHub: recursos e planos do Copilot.