Configurar GitHub Copilot do Zero: Guia Prático para um Fluxo de Trabalho Produtivo

GitHub Copilot
1

Instalar o Copilot é fácil. Usá-lo bem é outra história. Neste guia vamos configurar o GitHub Copilot do zero e montar um fluxo de trabalho que realmente acelere sua produtividade — não apenas aceitar sugestões às cegas.

Pré-requisitos

  • Conta do GitHub com acesso ao Copilot (plano gratuito disponível para desenvolvedores individuais, estudantes e mantenedores open source)
  • VS Code atualizado (ou JetBrains se for sua preferência)
  • Um projeto real para trabalhar — o Copilot brilha com contexto

Passo 1: Instalação

  1. Abra o VS Code
  2. Vá para Extensions (Ctrl+Shift+X)
  3. Procure por “GitHub Copilot” e instale a extensão oficial
  4. Também instale “GitHub Copilot Chat” se não vier incluída
  5. O VS Code pedirá para você se autenticar com sua conta do GitHub — siga o fluxo de autorização

Verifique que funciona: abra qualquer arquivo de código e comece a escrever uma função. Você deveria ver sugestões em cinza aparecendo automaticamente. Pressione Tab para aceitar.

Passo 2: Configuração Básica

Abra Settings (Ctrl+,) e procure por “copilot”. As configurações principais:

Habilitar/desabilitar por linguagem:

"github.copilot.enable": {
  "*": true,
  "markdown": false,
  "plaintext": false
}

Isso mantém o Copilot ativo para código mas o desativa para arquivos de texto onde as sugestões costumam ser mais ruído que ajuda.

Atalhos de teclado essenciais:

  • Tab — aceitar sugestão completa
  • Ctrl+→ — aceitar palavra por palavra (muito útil para sugestões parcialmente corretas)
  • Alt+] / Alt+[ — navegar entre sugestões alternativas
  • Esc — rejeitar sugestão
  • Ctrl+Shift+I (ou Cmd+Shift+I no Mac) — abrir Copilot Chat

Passo 3: Instruções Personalizadas por Projeto

Aqui é onde a maioria dos desenvolvedores deixa valor na mesa. Crie um arquivo .github/copilot-instructions.md na raiz do seu projeto:

# Copilot Instructions

## Stack Técnico
- Frontend: React 18 com TypeScript
- Backend: Node.js com Express
- Banco de dados: PostgreSQL com Prisma ORM
- Testing: Vitest para unit tests, Playwright para E2E

## Convenções de Código
- Usar functional components com hooks, nunca class components
- Nomear arquivos em kebab-case
- Tipos TypeScript em arquivos separados (.types.ts)
- Funções async/await, evitar .then() chains
- Comentários em português para documentação interna

## Padrões Preferidos
- Repository pattern para acesso a dados
- Zod para validação de inputs
- Error handling centralizado com middleware customizado

Este arquivo dá ao Copilot contexto específico do seu projeto. A diferença na qualidade das sugestões é notável.

Passo 4: Fluxo de Trabalho com Copilot Chat

O Copilot Chat (Ctrl+Shift+I) é mais poderoso do que parece. Alguns fluxos práticos:

Explicar código desconhecido:
Selecione um bloco de código → abra Chat → escreva /explain. O Copilot desglossa o que o código faz, linha por linha. Perfeito quando você entra em um projeto novo ou revisa um PR.

Gerar testes:
Selecione uma função → /tests. O Copilot gera testes unitários baseados na assinatura e lógica da sua função. Nem sempre são perfeitos, mas te dão uma base sólida para iterar.

Refatorar:
Selecione código → descreva o que quer: “refatore isso para usar async/await em vez de callbacks” ou “extraia a lógica de validação para uma função separada”.

Debugging:
Cole um erro no chat → “por que estou recebendo este erro?” O Copilot analisa o erro no contexto do seu código e sugere soluções.

Documentar:
Selecione uma função → /doc. Gera JSDoc/docstring com descrição de parâmetros e return types.

Passo 5: Fluxo de Trabalho para Código Novo

O truque para tirar bom código do Copilot é dar a ele contexto antes de escrever:

// Função que calcula o preço final de um produto
// aplicando desconto por quantidade e o IVA conforme o país
// Países suportados: Chile (19%), Colômbia (19%), México (16%), Argentina (21%)
// Se a quantidade é maior que 10, aplica 5% de desconto
// Se é maior que 50, aplica 10% de desconto
function calcularPrecioFinal(

Com esses comentários detalhados, o Copilot gera uma implementação muito mais acertada do que se você simplesmente escrever o nome da função. O padrão é: comentário detalhado → assinatura da função → deixar que o Copilot complete.

Passo 6: Code Review com Copilot

No GitHub (web ou CLI), o Copilot pode revisar seus Pull Requests:

  1. Crie seu PR normalmente
  2. Na página do PR, clique no ícone do Copilot para solicitar uma revisão
  3. O Copilot analisa as mudanças e deixa comentários sobre possíveis bugs, melhorias de desempenho e problemas de segurança

Não substitui a revisão humana, mas pega coisas que às vezes nos passam despercebidas.

Erros Comuns a Evitar

Aceitar tudo sem ler. O Copilot é um junior muito produtivo — escreve rápido mas precisa de revisão. Leia cada sugestão antes de aceitá-la.

Não dar contexto. Se você escrever código sem comentários nem tipos, o Copilot adivinha. Quanto mais contexto você der (tipos, comentários, nomes descritivos), melhores são as sugestões.

Ignorar as alternativas. Se a primeira sugestão não é ideal, use Alt+] para ver outras opções. Às vezes a terceira ou quarta opção é a correta.

Não usar Chat. Muitos desenvolvedores só usam o autocomplete e nunca abrem o Copilot Chat. Você está deixando metade da ferramenta sem usar.

Resultado

Com essa configuração você tem:

  • Copilot entendendo as convenções do seu projeto
  • Um fluxo de trabalho que combina autocomplete inteligente com chat conversacional
  • Code review automatizado em seus PRs
  • Um processo para escrever código novo que maximiza a qualidade das sugestões

A chave não é que o Copilot escreva todo seu código — é que elimine o atrito das partes repetitivas para que você possa se focar na lógica de negócio e nas decisões de arquitetura.

Já usa o Copilot? Compartilhe sua configuração e seus truques nos comentários. :backhand_index_pointing_down: