Configurar GitHub Copilot desde Cero: Guía Práctica para un Flujo de Trabajo Productivo

GitHub Copilot
1

Instalar Copilot es fácil. Usarlo bien es otra historia. En esta guía vamos a configurar GitHub Copilot desde cero y armar un flujo de trabajo que realmente acelere tu productividad — no solo aceptar sugerencias a ciegas.

Requisitos Previos

  • Cuenta de GitHub con acceso a Copilot (plan gratuito disponible para desarrolladores individuales, estudiantes y mantenedores open source)
  • VS Code actualizado (o JetBrains si es tu preferencia)
  • Un proyecto real para trabajar — Copilot brilla con contexto

Paso 1: Instalación

  1. Abre VS Code
  2. Ve a Extensions (Ctrl+Shift+X)
  3. Busca “GitHub Copilot” e instala la extensión oficial
  4. También instala “GitHub Copilot Chat” si no viene incluida
  5. VS Code te pedirá autenticarte con tu cuenta de GitHub — sigue el flujo de autorización

Verifica que funciona: abre cualquier archivo de código y empieza a escribir una función. Deberías ver sugerencias en gris apareciendo automáticamente. Presiona Tab para aceptar.

Paso 2: Configuración Básica

Abre Settings (Ctrl+,) y busca “copilot”. Las configuraciones clave:

Habilitar/deshabilitar por lenguaje:

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

Esto mantiene Copilot activo para código pero lo desactiva para archivos de texto donde las sugerencias suelen ser más ruido que ayuda.

Atajos de teclado esenciales:

  • Tab — aceptar sugerencia completa
  • Ctrl+→ — aceptar palabra por palabra (muy útil para sugerencias parcialmente correctas)
  • Alt+] / Alt+[ — navegar entre sugerencias alternativas
  • Esc — rechazar sugerencia
  • Ctrl+Shift+I (o Cmd+Shift+I en Mac) — abrir Copilot Chat

Paso 3: Instrucciones Personalizadas por Proyecto

Aquí es donde la mayoría de los desarrolladores dejan valor en la mesa. Crea un archivo .github/copilot-instructions.md en la raíz de tu proyecto:

# Copilot Instructions

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

## Convenciones de Código
- Usar functional components con hooks, nunca class components
- Nombrar archivos en kebab-case
- Tipos TypeScript en archivos separados (.types.ts)
- Funciones async/await, evitar .then() chains
- Comentarios en español para documentación interna

## Patrones Preferidos
- Repository pattern para acceso a datos
- Zod para validación de inputs
- Error handling centralizado con middleware custom

Este archivo le da a Copilot contexto específico de tu proyecto. La diferencia en la calidad de sugerencias es notable.

Paso 4: Flujo de Trabajo con Copilot Chat

Copilot Chat (Ctrl+Shift+I) es más poderoso de lo que parece. Algunos flujos prácticos:

Explicar código desconocido:
Selecciona un bloque de código → abre Chat → escribe /explain. Copilot desglosa qué hace el código, línea por línea. Perfecto cuando entras a un proyecto nuevo o revisas un PR.

Generar tests:
Selecciona una función → /tests. Copilot genera tests unitarios basados en la firma y lógica de tu función. No siempre son perfectos, pero te dan una base sólida para iterar.

Refactorizar:
Selecciona código → describe qué quieres: “refactoriza esto para usar async/await en vez de callbacks” o “extrae la lógica de validación a una función separada”.

Debugging:
Pega un error en el chat → “¿por qué estoy recibiendo este error?” Copilot analiza el error en el contexto de tu código y sugiere soluciones.

Documentar:
Selecciona una función → /doc. Genera JSDoc/docstring con descripción de parámetros y return types.

Paso 5: Flujo de Trabajo para Código Nuevo

El truco para sacar buen código de Copilot es darle contexto antes de escribir:

// Función que calcula el precio final de un producto
// aplicando descuento por cantidad y el IVA según el país
// Países soportados: Chile (19%), Colombia (19%), México (16%), Argentina (21%)
// Si la cantidad es mayor a 10, aplica 5% de descuento
// Si es mayor a 50, aplica 10% de descuento
function calcularPrecioFinal(

Con esos comentarios detallados, Copilot genera una implementación mucho más acertada que si simplemente escribes el nombre de la función. El patrón es: comentario detallado → firma de función → dejar que Copilot complete.

Paso 6: Code Review con Copilot

En GitHub (web o CLI), Copilot puede revisar tus Pull Requests:

  1. Crea tu PR normalmente
  2. En la página del PR, haz clic en el ícono de Copilot para solicitar una revisión
  3. Copilot analiza los cambios y deja comentarios sobre posibles bugs, mejoras de rendimiento, y problemas de seguridad

No reemplaza la revisión humana, pero atrapa cosas que a veces se nos pasan.

Errores Comunes a Evitar

Aceptar todo sin leer. Copilot es un junior muy productivo — escribe rápido pero necesita revisión. Lee cada sugerencia antes de aceptarla.

No dar contexto. Si escribes código sin comentarios ni tipos, Copilot adivina. Mientras más contexto le des (tipos, comentarios, nombres descriptivos), mejores son las sugerencias.

Ignorar las alternativas. Si la primera sugerencia no es ideal, usa Alt+] para ver otras opciones. A veces la tercera o cuarta opción es la correcta.

No usar Chat. Muchos desarrolladores solo usan el autocomplete y nunca abren Copilot Chat. Estás dejando la mitad de la herramienta sin usar.

Resultado

Con esta configuración tienes:

  • Copilot entendiendo las convenciones de tu proyecto
  • Un flujo de trabajo que combina autocomplete inteligente con chat conversacional
  • Code review automatizado en tus PRs
  • Un proceso para escribir código nuevo que maximiza la calidad de las sugerencias

La clave no es que Copilot escriba todo tu código — es que elimine la fricción de las partes repetitivas para que puedas enfocarte en la lógica de negocio y las decisiones de arquitectura.

¿Ya usas Copilot? Comparte tu configuración y tus trucos en los comentarios. :backhand_index_pointing_down: