GitHub Copilot CLI en Windows: instalación, PATH, PowerShell e inicio de sesión

Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026

GitHub Copilot CLI funciona de forma nativa en Windows, tanto en x64 como en ARM64. Esta guía explica las cuatro formas de instalarlo, los problemas de PATH que hacen que PowerShell no reconozca copilot, la versión de PowerShell que espera Copilot, el inicio de sesión y las actualizaciones. Comprobamos los comandos con la documentación oficial el 8 de octubre de 2026.

La versión corta: WinGet

GitHub Copilot CLI

Abre PowerShell y ejecuta estas dos líneas. WinGet elige por ti la compilación x64 o ARM64. Cierra la terminal y abre otra antes de lanzar copilot --version, para que vea el PATH actualizado.

powershell
winget install GitHub.Copilot
copilot --version

GitHub pide dos cosas en Windows: una suscripción activa a Copilot y PowerShell 6 o posterior (documentación de instalación de GitHub, revisada el 8 de octubre de 2026). El recorrido general para todas las plataformas está en cómo instalar y usar GitHub Copilot CLI.

Cuatro formas de instalarlo en Windows

MétodoQué ejecutas o descargas
WinGetwinget install GitHub.Copilot
Instalador MSIcopilot-x64.msi o copilot-arm64.msi
Zipcopilot-win32-x64.zip o copilot-win32-arm64.zip, cada uno con un único copilot.exe
npm (Node.js 22 o posterior)npm install -g @github/copilot
Nombres de archivo de la versión v1.0.93 publicada en GitHub.

Los archivos MSI y zip están en la página de versiones de copilot-cli, junto a SHA256SUMS.txt. Elige el que corresponda a tu procesador: lo ves en Configuración > Sistema > Información, en Tipo de sistema. Para las versiones preliminares, usa winget install GitHub.Copilot.Prerelease o npm install -g @github/copilot@prerelease.

Solo el paquete de npm necesita Node.js. WinGet, el MSI y el zip instalan el binario independiente.

Instalación manual desde el zip

powershell
$dir = "$env:LOCALAPPDATA\copilot-cli"
$base = "https://github.com/github/copilot-cli/releases/latest/download"
Invoke-WebRequest "$base/copilot-win32-x64.zip" -OutFile copilot.zip
Invoke-WebRequest "$base/SHA256SUMS.txt" -OutFile SHA256SUMS.txt
(Get-FileHash copilot.zip -Algorithm SHA256).Hash
Select-String -Path SHA256SUMS.txt -Pattern "copilot-win32-x64.zip"
Expand-Archive copilot.zip -DestinationPath $dir
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$dir", "User")

En un equipo ARM64, cambia x64 por arm64 en los dos nombres de archivo. Los dos hashes tienen que coincidir; PowerShell muestra el suyo en mayúsculas y el archivo lo trae en minúsculas, y eso no importa. Las dos últimas líneas añaden la carpeta al PATH de tu usuario, así que abre una terminal nueva al terminar.

La carpeta %LOCALAPPDATA%\copilot-cli es solo una sugerencia. Es la misma que usa el instalador de CodeAgentSwarm, así lo tienes todo en un sitio si cambias más adelante.

Cuando PowerShell no reconoce copilot

powershell
Get-Command copilot -All
where.exe copilot
npm prefix -g
  • La terminal estaba abierta durante la instalación. Cada ventana conserva el PATH con el que arrancó. Abre otra y reinicia cualquier app que lance Copilot por ti.
  • Instalaste con npm. En Windows, npm deja los comandos globales directamente en la carpeta que muestra npm prefix -g, por defecto %AppData%\npm (documentación de carpetas de npm, revisada el 8 de octubre de 2026). Esa carpeta tiene que estar en el PATH.
  • Descomprimiste el zip. Nadie añade la carpeta al PATH por ti. Usa las dos últimas líneas del ejemplo del zip.
  • Aparecen varias copias. Ejecuta copilot --version desde cada ruta que muestre Get-Command y quédate con la que quieras. Dos instalaciones que se actualizan con herramientas distintas acaban con versiones diferentes.

PowerShell es la shell que usa Copilot

En Windows, Copilot ejecuta sus comandos con PowerShell. Prefiere PowerShell 7 o posterior (pwsh) y, si no lo encuentra, usa Windows PowerShell (powershell.exe) (referencia de configuración de GitHub, revisada el 8 de octubre de 2026). Windows PowerShell 5.1 es la versión que viene con Windows, y es anterior a PowerShell 6, el mínimo que pide GitHub. Comprueba cuál tienes e instala PowerShell 7 si hace falta:

powershell
$PSVersionTable.PSVersion
winget install --id Microsoft.PowerShell --source winget

El comando de instalación sale de la guía de instalación de PowerShell de Microsoft, revisada el 8 de octubre de 2026. PowerShell 7 convive con Windows PowerShell 5.1; no lo sustituye. El ajuste powershellFlags de settings.json, dentro de la carpeta .copilot de tu perfil de usuario, decide cómo arranca Copilot PowerShell. El valor por defecto es:

json
{
  "powershellFlags": ["-NoProfile", "-NoLogo"]
}

Con -NoProfile no se carga tu perfil de PowerShell, así que Copilot no ve los alias ni las funciones que tengas definidos ahí. Deja el valor por defecto salvo que un comando dependa de verdad de tu perfil. El archivo admite comentarios, y COPILOT_HOME cambia de sitio la carpeta entera.

Inicia sesión con un código de dispositivo

powershell
copilot login --device-code

En un escritorio de Windows normal, copilot login abre el navegador. Con --device-code muestra https://github.com/login/device y un código de un solo uso, que también sirve por SSH o en una sesión remota. Copilot guarda el token en el llavero del sistema. Tienes los detalles en la documentación de autenticación de GitHub.

  • No admite los tokens personales clásicos que empiezan por ghp_. Usa un token detallado (fine-grained) con el permiso Copilot Requests y pásalo con copilot login --with-token.
  • Si existe COPILOT_GITHUB_TOKEN, GH_TOKEN o GITHUB_TOKEN, Copilot lo usa antes que el llavero, en ese orden. Si no hay ninguno, recurre a GitHub CLI si tiene una sesión iniciada.
  • /logout borra el token local, pero no lo revoca.

¿Has iniciado sesión con una cuenta y Copilot usa otra? Busca un GH_TOKEN o GITHUB_TOKEN guardado en las variables de usuario de Windows. Tiene prioridad sobre la cuenta con la que acabas de entrar.

Mantenlo actualizado

Instalado conCómo se actualiza
WinGetwinget upgrade GitHub.Copilot
Zipcopilot update, o deja que la actualización automática se aplique en el siguiente arranque
npmnpm install -g @github/copilot (Copilot solo avisa de que hay una versión nueva)
Instalador de CodeAgentSwarmLa app actualiza su propia copia, y las instalaciones de WinGet o npm con esas herramientas

Las instalaciones independientes descargan las actualizaciones solas y las aplican la próxima vez que arranca Copilot. Para desactivarlo, arranca Copilot con --no-auto-update o define COPILOT_AUTO_UPDATE=false. copilot update prerelease cambia a las versiones preliminares. GitHub no explica cómo se actualiza la instalación MSI, así que comprueba copilot --version después.

copilot no es gh copilot

Si ya usabas GitHub CLI, puede que aún tengas la antigua extensión gh copilot. Solo sugería y explicaba comandos de shell. GitHub Copilot CLI es otro programa: el comando es copilot, y lee tu proyecto, edita archivos y ejecuta comandos cuando los apruebas.

Así que si gh copilot suggest funciona pero PowerShell no reconoce copilot, tienes la extensión antigua y no el agente. Instala Copilot CLI con cualquiera de los métodos anteriores. Lo único que comparten: una sesión iniciada en GitHub CLI puede dar a Copilot CLI la cuenta que usa.

GitHub Copilot CLI en CodeAgentSwarm para Windows

El soporte de Copilot llega en CodeAgentSwarm 2.5.0, en beta. Estos pasos se comprobaron durante el desarrollo de la 2.5.0, y el instalador también se probó en Windows ARM64.

Diálogo de instalación de GitHub Copilot CLI en CodeAgentSwarm
Captura real de CodeAgentSwarm, tomada durante el desarrollo de la 2.5.0. Al pulsar Install, la app descarga el archivo oficial y comprueba su SHA-256 antes de extraerlo.
  • Instalación: elige GitHub Copilot CLI en el selector de agentes o pulsa Install en Settings > Providers. En Windows, la app descarga el zip x64 o ARM64, lo verifica con SHA256SUMS y deja copilot.exe en %LOCALAPPDATA%\copilot-cli. Si ya lo instalaste con WinGet o npm, la app detecta esa copia y la actualiza con la misma herramienta.
  • Inicio de sesión: pulsa Sign in en Chat. Usa el código de dispositivo, así que solo abres la página de GitHub y escribes el código.
  • Chat o terminal: Chat muestra los modelos que ofrece tu cuenta, los modos Agent, Plan y Autopilot y las solicitudes de permiso. La vista de terminal ejecuta la interfaz normal de copilot, y una sesión de Chat sigue ahí con --resume.
  • Historial y uso: Conversation History lista tus sesiones de Copilot por proyecto, y el panel Usage muestra tu cupo mensual y la fecha de renovación junto a tus otros agentes.
Una conversación de Chat reanudada en la terminal de GitHub Copilot CLI con la pregunta de confianza en la carpeta
Captura real de CodeAgentSwarm, tomada durante el desarrollo de la 2.5.0: una sesión iniciada en Chat sigue en la terminal, y Copilot pregunta la primera vez si confías en la carpeta.

Cada sesión puede vivir en su propio proyecto o worktree de git, junto a Claude Code, Codex y el resto de agentes. Lee cómo montar un enjambre de agentes con GitHub Copilot CLI para organizarlo, el modo YOLO de GitHub Copilot CLI antes de aprobarlo todo y GitHub Copilot CLI en Linux si también trabajas en WSL o en un servidor.

Preguntas frecuentes

¿Necesito WSL para usar GitHub Copilot CLI en Windows?

No. GitHub publica compilaciones nativas de Windows para x64 y ARM64, además de un paquete de WinGet y un MSI. Dentro de WSL usarías la compilación de Linux, que es una instalación aparte.

¿GitHub Copilot CLI funciona en Windows ARM?

Sí. Hay un zip y un MSI nativos para ARM64. WinGet y el instalador de CodeAgentSwarm eligen la compilación que corresponde al equipo.

¿Qué shell usa Copilot para los comandos en Windows?

PowerShell. Prefiere PowerShell 7 o posterior (pwsh) y, si no está instalado, usa Windows PowerShell. GitHub pide PowerShell 6 o posterior, así que instala PowerShell 7 si solo tienes la 5.1 que trae Windows.

¿Por qué PowerShell no reconoce copilot justo después de instalarlo?

Casi siempre es porque la terminal se abrió antes de la instalación y conserva el PATH anterior. Abre una nueva. Si instalaste con npm, la carpeta que muestra npm prefix -g tiene que estar en el PATH; con el zip, la añades tú.

¿gh copilot es lo mismo que GitHub Copilot CLI?

No. gh copilot es una antigua extensión de GitHub CLI que sugería y explicaba comandos de shell. GitHub Copilot CLI es el comando copilot, un agente que edita archivos y ejecuta comandos cuando los apruebas.