Cómo instalar GitHub Copilot CLI en Linux (e iniciar sesión por SSH)
Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026
copilot. En esta guía vemos los tres métodos de instalación, el caso de Alpine (musl) que el script no resuelve, cómo iniciar sesión en un servidor sin navegador, los tokens para máquinas sin pantalla, los modelos locales, las actualizaciones y los errores que más te vas a encontrar. Comprobamos los comandos con el script de instalación de la 1.0.93 y la documentación de GitHub el 8 de octubre de 2026.Respuesta rápida: instala GitHub Copilot CLI en Linux
Respuesta rápida: ejecuta el script oficial, sin sudo. Instala ~/.local/bin/copilot y comprueba la descarga con las sumas de verificación que publica GitHub. Después entra en un proyecto, escribe copilot e inicia sesión.
# Script oficial para Linux y macOS (también vale wget -qO-)
curl -fsSL https://gh.io/copilot-install | bash
# Comprueba la instalación
copilot --version
# Arráncalo dentro de un proyecto
cd ~/mi-proyecto
copilotFuentes: documentación de instalación de GitHub y documentación de autenticación de GitHub, revisadas el 8 de octubre de 2026. Si buscas una visión general del agente, lee cómo instalar y usar GitHub Copilot CLI.
Script, Homebrew o npm
| Método | Comando | Qué conviene saber |
|---|---|---|
| Script oficial | curl -fsSL https://gh.io/copilot-install | bash | Binario independiente. ~/.local/bin como usuario normal, /usr/local/bin como root. |
| Homebrew | brew install --cask copilot-cli | Versión preliminar: copilot-cli@prerelease. |
| npm | npm install -g @github/copilot | Necesita Node.js 22 o posterior. Versión preliminar: @github/copilot@prerelease. |
# Instala en la carpeta que elijas y fija una versión
curl -fsSL https://gh.io/copilot-install | VERSION="v1.0.93" PREFIX="$HOME/tools" bash
# El binario queda en $HOME/tools/bin/copilotEl script lee dos variables. PREFIX elige la carpeta base y el binario va a $PREFIX/bin. VERSION elige una versión publicada (por defecto, la última; prerelease también funciona si tienes git). Si encuentra sha256sum o shasum, el script verifica el archivo con SHA256SUMS.txt antes de extraerlo y se detiene si la suma no coincide.
Alpine y otras distribuciones con musl
GitHub publica dos compilaciones de Linux para cada arquitectura: copilot-linux-x64 y copilot-linux-arm64 para distribuciones con glibc (Ubuntu, Debian, Fedora y casi todas las demás), y copilot-linuxmusl-x64 y copilot-linuxmusl-arm64 para distribuciones con musl como Alpine. Cuando leímos el script de instalación el 8 de octubre de 2026, siempre descargaba la compilación de glibc. En Alpine, descarga tú mismo el archivo musl desde la página de versiones:
# Alpine en x64 (en ARM64 usa copilot-linuxmusl-arm64)
BASE=https://github.com/github/copilot-cli/releases/latest/download
curl -fsSLO $BASE/copilot-linuxmusl-x64.tar.gz
curl -fsSLO $BASE/SHA256SUMS.txt
grep copilot-linuxmusl-x64.tar.gz SHA256SUMS.txt | sha256sum -c -
mkdir -p ~/.local/bin
tar -xz -C ~/.local/bin -f copilot-linuxmusl-x64.tar.gz
copilot --version¿No sabes cuál tienes? Ejecuta ldd --version. Si la salida menciona musl, o existe /etc/alpine-release, usa la compilación musl. En Alpine también puedes usar el paquete de npm si ya tienes Node.js 22 o posterior.
Inicia sesión por SSH con un código de dispositivo
En un escritorio, copilot login abre el navegador. Por SSH, en contenedores de desarrollo, en CI y en un Linux sin entorno gráfico usa por defecto el flujo de código de dispositivo, así que puedes iniciar sesión desde cualquier otro aparato.
copilot login # código de dispositivo por defecto en SSH
copilot login --device-code # fuerza el código de dispositivo
copilot login --web-flow # fuerza el navegador- El comando muestra
https://github.com/login/devicey un código de un solo uso. Abre esa página en el portátil o el móvil, escribe el código y aprueba el acceso. - Dentro de la interfaz interactiva,
/loginhace lo mismo./user listy/user switchgestionan varias cuentas. - Con GitHub Enterprise Cloud y residencia de datos, añade
--host https://example.ghe.com(con tu dominio) o defineCOPILOT_GH_HOST. - La primera vez que abres Copilot en una carpeta, te pide confirmar que confías en ella. Responde una vez o pide que recuerde la carpeta.
Copilot guarda el token en el llavero del sistema. Un servidor sin entorno gráfico muchas veces no tiene llavero (por ejemplo, le falta libsecret). En ese caso Copilot pregunta si quieres guardar el token en texto plano en ~/.copilot/config.json. Acepta solo en una máquina que controles y deja ese archivo fuera de las copias que compartas. /logout borra el token local, pero no lo revoca en GitHub.
Máquinas sin pantalla y CI: COPILOT_GITHUB_TOKEN
Cuando nadie puede escribir un código de dispositivo, dale a Copilot un token. Tiene que ser un token de acceso personal de grano fino (fine-grained) con el permiso Copilot Requests:
- Abre la página de tokens fine-grained en GitHub.
- En Resource owner, elige tu cuenta personal.
- En Account permissions, añade Copilot Requests y genera el token.
# Opción 1: variable de entorno, no se guarda nada en disco
export COPILOT_GITHUB_TOKEN="github_pat_..."
copilot
# Opción 2: guárdalo una vez (se lee por la entrada estándar)
copilot login --with-token < ~/copilot-token.txtLos tokens clásicos que empiezan por ghp_ no funcionan. Copilot mira COPILOT_GITHUB_TOKEN, después GH_TOKEN, después GITHUB_TOKEN, luego el llavero y por último una sesión de GitHub CLI. Si el servidor ya exporta un GITHUB_TOKEN para otra cosa, Copilot puede usarlo; define COPILOT_GITHUB_TOKEN para dejar clara la elección.
Tu propio modelo, o sin conexión
Copilot CLI puede hablar con tu propio proveedor (BYOK) en lugar de con los modelos de GitHub, y entonces no necesita iniciar sesión en GitHub. COPILOT_PROVIDER_TYPE acepta openai (el valor por defecto, para cualquier endpoint compatible con la API Chat Completions de OpenAI), azure o anthropic. Un proveedor remoto también pide COPILOT_PROVIDER_API_KEY.
# Ejemplo de la documentación de GitHub: un servidor Ollama local
export COPILOT_PROVIDER_BASE_URL=http://localhost:11434
export COPILOT_MODEL=YOUR-MODEL-NAME
# Opcional: no contactar nunca con los servidores de GitHub
export COPILOT_OFFLINE=true
copilot- El modelo tiene que admitir llamadas a herramientas y streaming. GitHub recomienda una ventana de contexto de al menos 128k tokens.
COPILOT_OFFLINE=trueexige un proveedor local. GitHub avisa de que el modo sin conexión solo te aísla del todo si el proveedor también corre en local o dentro de la misma red aislada.--modelen la línea de comandos hace lo mismo queCOPILOT_MODEL.
Fuente: documentación de GitHub sobre modelos BYOK, revisada el 8 de octubre de 2026.
Actualizaciones, y cómo apagarlas en CI
| Instalado con | Cómo se actualiza |
|---|---|
| Script o archivo de la versión | Descarga las actualizaciones solo y las aplica en el siguiente arranque. copilot update lo hace al momento. |
| npm | Solo avisa de que hay una versión nueva. Actualiza con npm install -g @github/copilot. |
| Homebrew | Actualiza con brew upgrade --cask copilot-cli. |
copilot update # última versión estable
copilot update prerelease # última versión preliminar
# Mantén una versión fija en un servidor compartido o una imagen de build
copilot --no-auto-update
export COPILOT_AUTO_UPDATE=falseEn una imagen de build, fija la versión con VERSION al instalar y deja la actualización automática apagada, así todos los trabajos usan el mismo binario.
Errores habituales en Linux y cómo arreglarlos
- "copilot: command not found" después de instalar:
~/.local/binno está en tu PATH. El script se ofrece a añadirlo a~/.profile,~/.bash_profileo~/.zprofile. Si no, añade túexport PATH="$HOME/.local/bin:$PATH"y abre una shell nueva. - "Error: Unsupported architecture": el script solo admite x86_64 y aarch64. Compruébalo con
uname -m. - El binario está, pero no arranca en Alpine: tienes la compilación de glibc en un sistema con musl. Instala el archivo
linuxmuslcomo se explica arriba. - "Could not create directory ... You may not have write permissions": pon en
PREFIXuna carpeta tuya, o ejecuta el script como root para instalar en/usr/local/bin. - "No sha256sum or shasum found, skipping checksum validation": instala coreutils con tu gestor de paquetes y vuelve a ejecutar el script.
- El login no termina nunca por SSH: fuerza
copilot login --device-code. - Rechaza el token: seguramente es un token clásico
ghp_, o uno fine-grained sin el permiso Copilot Requests. - El paquete de npm no se instala o no arranca: revisa
node --version. El paquete necesita Node.js 22 o posterior.
Los registros están en ~/.copilot/logs/. Sube el nivel de detalle con --log-level o guárdalos en otra carpeta con --log-dir.
En un servidor remoto y en CodeAgentSwarm
En un servidor remoto, arranca Copilot dentro de tmux o screen para que un corte de SSH no termine la sesión. Si aun así se corta, copilot --continue reabre la última sesión y copilot --resume <id> reabre una concreta. Las sesiones se guardan en ~/.copilot/session-state/ de ese servidor.

En un escritorio Linux, CodeAgentSwarm añade GitHub Copilot CLI en la 2.5.0, en beta. Elige GitHub Copilot CLI en el selector de agentes o instálalo desde Settings > Providers: la app descarga el archivo oficial para tu equipo, glibc o musl, verifica SHA256SUMS e instala ~/.local/bin/copilot. Si ya instalaste Copilot con npm o Homebrew, la app lo detecta y lo actualiza con esa misma herramienta. Inicias sesión desde Chat con un código de dispositivo, y una sesión empezada en Chat continúa en la vista de terminal.

El panel de uso muestra tu asignación mensual de Copilot y la fecha de renovación junto a tus otros agentes. La lee con un token del entorno o con una sesión de GitHub CLI, nunca del llavero. Puedes tener varias sesiones de Copilot en paralelo, cada una en su proyecto o en su git worktree, junto a Claude Code, Codex y los demás agentes compatibles. Siguiente paso: MCP e historial en Copilot CLI y modelos y créditos de IA.
Conclusión
En casi cualquier Linux, una línea de curl instala GitHub Copilot CLI en tu carpeta personal. Alpine necesita el archivo musl a mano. Por SSH el código de dispositivo es el flujo por defecto, las máquinas sin pantalla usan un token fine-grained en COPILOT_GITHUB_TOKEN, y COPILOT_OFFLINE=true con un modelo local deja todo dentro de tu red. Apaga la actualización automática donde necesites una versión fija.
Preguntas frecuentes
¿Cómo instalo GitHub Copilot CLI en Linux?
Ejecuta "curl -fsSL https://gh.io/copilot-install | bash". Instala el binario en ~/.local/bin como usuario normal, o en /usr/local/bin como root. También funcionan Homebrew ("brew install --cask copilot-cli") y npm ("npm install -g @github/copilot", con Node.js 22 o posterior).
¿GitHub Copilot CLI funciona en Alpine Linux?
Sí. GitHub publica compilaciones musl para x64 y ARM64 (copilot-linuxmusl-x64 y copilot-linuxmusl-arm64). El script de instalación que revisamos el 8 de octubre de 2026 siempre bajaba la de glibc, así que descarga el archivo musl desde la página de versiones o usa npm.
¿Cómo inicio sesión en Copilot CLI en un servidor sin navegador?
Ejecuta "copilot login". Por SSH usa por defecto el código de dispositivo: muestra github.com/login/device y un código que escribes en cualquier otro aparato. En máquinas donde nadie puede escribir, exporta COPILOT_GITHUB_TOKEN con un token fine-grained que tenga el permiso Copilot Requests.
¿Puedo usar GitHub Copilot CLI sin conexión?
Sí, con tu propio modelo local. Define COPILOT_PROVIDER_BASE_URL y COPILOT_MODEL para el proveedor local y después COPILOT_OFFLINE=true. El modelo debe admitir llamadas a herramientas y streaming. Con esa configuración no hace falta iniciar sesión en GitHub.
¿Cómo evito que GitHub Copilot CLI se actualice solo?
Arráncalo con --no-auto-update o define COPILOT_AUTO_UPDATE=false. En CI la actualización automática ya viene apagada por defecto. Las instalaciones de npm nunca se actualizan solas; solo avisan de que hay una versión nueva.