Cómo instalar GitHub Copilot CLI en Linux (e iniciar sesión por SSH)

Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026

GitHub Copilot CLI funciona en Linux como un único binario llamado 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

GitHub Copilot CLI

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.

bash
# 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
copilot

Fuentes: 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étodoComandoQué conviene saber
Script oficialcurl -fsSL https://gh.io/copilot-install | bashBinario independiente. ~/.local/bin como usuario normal, /usr/local/bin como root.
Homebrewbrew install --cask copilot-cliVersión preliminar: copilot-cli@prerelease.
npmnpm install -g @github/copilotNecesita Node.js 22 o posterior. Versión preliminar: @github/copilot@prerelease.
Métodos de instalación que recoge la documentación de GitHub, revisada el 8 de octubre de 2026.
bash
# 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/copilot

El 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:

bash
# 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.

bash
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/device y 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, /login hace lo mismo. /user list y /user switch gestionan varias cuentas.
  • Con GitHub Enterprise Cloud y residencia de datos, añade --host https://example.ghe.com (con tu dominio) o define COPILOT_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:

bash
# 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.txt

Los 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.

bash
# 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=true exige 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.
  • --model en la línea de comandos hace lo mismo que COPILOT_MODEL.

Fuente: documentación de GitHub sobre modelos BYOK, revisada el 8 de octubre de 2026.

Actualizaciones, y cómo apagarlas en CI

Instalado conCómo se actualiza
Script o archivo de la versiónDescarga las actualizaciones solo y las aplica en el siguiente arranque. copilot update lo hace al momento.
npmSolo avisa de que hay una versión nueva. Actualiza con npm install -g @github/copilot.
HomebrewActualiza con brew upgrade --cask copilot-cli.
En CI la actualización automática ya viene apagada por defecto.
bash
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=false

En 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/bin no está en tu PATH. El script se ofrece a añadirlo a ~/.profile, ~/.bash_profile o ~/.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 linuxmusl como se explica arriba.
  • "Could not create directory ... You may not have write permissions": pon en PREFIX una 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.

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.

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.

Asignación mensual de GitHub Copilot CLI en el panel de uso de CodeAgentSwarm
Interfaz real de CodeAgentSwarm, capturada durante el desarrollo de la 2.5.0. El 7 % restante que se ve sale de datos de prueba, no de una cuenta real.

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.