Ir al contenido
Copilot Workshops

Ejercicio 1 - Instalar GitHub Copilot CLI

GitHub Copilot CLI es un potente asistente de programación con agentes que se ejecuta en tu terminal y te permite explorar bases de código, generar código, ejecutar comandos e interactuar con herramientas externas, todo desde la línea de comandos. Te permite delegar tareas, solicitar cambios y mantener la concentración. Como imaginarás, el primer paso es instalar la herramienta. Por suerte, puedes hacerlo con herramientas que ya conoces.

En este ejercicio aprenderás a:

  • instalar GitHub Copilot CLI con npm.
  • autenticarte con tu cuenta de GitHub.
  • verificar la instalación.

Escenario

Tu equipo está empezando a usar agentes de IA para gestionar un backlog cada vez mayor. Copilot CLI lleva esa capacidad a la terminal, donde muchos desarrolladores ya trabajan habitualmente. Este ejercicio te ayudará a instalarlo, autenticarte y dejarlo listo para usarlo durante el resto del taller.

Abrir un terminal en tu codespace

Antes de instalar Copilot CLI, tienes que abrir una ventana de terminal en tu codespace.

  1. Vuelve a tu codespace si todavía no estás allí.
  2. Abre una ventana de terminal pulsando Ctrl+`.
  3. Deberías ver un panel de terminal en la parte inferior de la ventana de VS Code.

Instalar Copilot CLI

Puedes instalar Copilot CLI mediante npm, WinGet y Homebrew. Como GitHub Codespaces incluye Node.js preinstalado, usarás npm para instalar Copilot CLI.

  1. En el terminal, comprueba que Node.js está instalado y que cumple el requisito de versión:

    Terminal window
    node --version

    Deberías ver la versión 22 o posterior (por ejemplo, v22.x.x).

  2. Instala Copilot CLI globalmente en el codespace con npm:

    Terminal window
    npm install -g @github/copilot

  3. Verifica la instalación consultando la versión:

    Terminal window
    copilot --version

    Deberías ver el número de versión mostrado (por ejemplo, v1.0.XX).

Si encuentras errores de permisos, puede que necesites usar sudo npm install -g @github/copilot en algunos sistemas. Sin embargo, en GitHub Codespaces no debería ser necesario.

Autenticarse con GitHub

La primera vez que lo inicies, Copilot CLI te pedirá que te autentiques con tu cuenta de GitHub.

  1. Inicia Copilot CLI:

    Terminal window
    copilot

  2. Si no has iniciado sesión todavía, verás un mensaje para autenticarte. Copilot CLI mostrará un código de dispositivo y te pedirá que visites una URL.

  3. Sigue las instrucciones en pantalla:

    • Abre en el navegador la URL proporcionada
    • Introduce el código de dispositivo cuando se te solicite
    • Autoriza a Copilot CLI para acceder a tu cuenta de GitHub

  4. Una vez autenticado, verás el prompt de Copilot CLI listo para aceptar tus preguntas y comandos.

En un codespace, es posible que ya estés autenticado a través de tu sesión de GitHub. Si Copilot CLI se inicia sin pedir autenticación, ya está todo listo.

Confiar en el directorio y verificar que todo funciona

Ahora que estás en el prompt de Copilot CLI por primera vez, vamos a marcar como fiable este repositorio del taller y a comprobar que Copilot CLI está correctamente instalado y conectado.

  1. Cuando Copilot CLI te pida que confirmes que confías en los archivos de esta carpeta, verás tres opciones:

    • Yes, proceed: confiar solo durante esta sesión
    • Yes, and remember this folder for future sessions: confiar de forma permanente
    • No, exit (Esc): no permitir el acceso a los archivos

  2. Para este taller, selecciona Yes, and remember this folder for future sessions, ya que trabajarás en este repositorio durante toda la sesión.

  3. Haz a Copilot una pregunta sencilla para verificar que funciona:

    What files are in this project?

  4. Copilot debería explorar el repositorio y ofrecer un resumen de la estructura del proyecto.

  5. Prueba el comando /help para ver los comandos de barra disponibles:

    /help

  6. Sal de Copilot CLI introduciendo el siguiente comando en el terminal. Volveremos a Copilot CLI en un ejercicio posterior.

    exit

Resumen y siguientes pasos

¡Enhorabuena! Has instalado y autenticado GitHub Copilot CLI correctamente. Has aprendido a:

  • instalar Copilot CLI con npm.
  • autenticarte con tu cuenta de GitHub.
  • confiar en un directorio para que Copilot CLI pueda trabajar con él.
  • verificar que la instalación funciona correctamente.

Ahora que Copilot CLI está instalado, vamos a darle a Copilot algo de contexto del proyecto. Continúa con el Ejercicio 2 - Instrucciones personalizadas con CLI.

Recursos