GitHub Copilot CLI en Windows: instalación, PATH, PowerShell e inicio de sesión
Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026
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
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.
winget install GitHub.Copilot
copilot --versionGitHub 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étodo | Qué ejecutas o descargas |
|---|---|
| WinGet | winget install GitHub.Copilot |
| Instalador MSI | copilot-x64.msi o copilot-arm64.msi |
| Zip | copilot-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 |
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
$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
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 --versiondesde cada ruta que muestreGet-Commandy 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:
$PSVersionTable.PSVersion
winget install --id Microsoft.PowerShell --source wingetEl 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:
{
"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
copilot login --device-codeEn 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 concopilot login --with-token. - Si existe
COPILOT_GITHUB_TOKEN,GH_TOKENoGITHUB_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. /logoutborra 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 con | Cómo se actualiza |
|---|---|
| WinGet | winget upgrade GitHub.Copilot |
| Zip | copilot update, o deja que la actualización automática se aplique en el siguiente arranque |
| npm | npm install -g @github/copilot (Copilot solo avisa de que hay una versión nueva) |
| Instalador de CodeAgentSwarm | La 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.

- 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
SHA256SUMSy dejacopilot.exeen%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.

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.