Instalación de la CLI de GitHub Copilot

Obtén información sobre cómo instalar CLI de Copilot para que puedas usar Copilot directamente desde la línea de comandos.

¿Quién puede utilizar esta característica?

CLI de GitHub Copilot está disponible con todos los planes Copilot. Si recibes Copilot de una organización, la directiva de CLI de Copilot debe estar habilitada en la configuración de la organización.

En este artículo

Para obtener información sobre CLI de Copilot antes de instalarlo, consulta Acerca de la CLI de GitHub Copilot.

Prerrequisitos

  •         **Una suscripción activa GitHub Copilot**. Consulte [planes de Copilot](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=text).
  • (En Windows) PowerShell v6 o posterior

Si tiene acceso a GitHub Copilot a través de su organización o empresa, no puede usar CLI de Copilot si el propietario de la organización o el administrador de la empresa lo ha deshabilitado en la configuración de la organización o de la empresa. Consulta Administración de directivas y características para GitHub Copilot en tu organización.

Instalación o actualización de la CLI de Copilot

Puede instalar CLI de Copilot mediante WinGet (Windows), Homebrew (macOS y Linux), npm (todas las plataformas) o un script de instalación (macOS y Linux).

Instalación con npm (todas las plataformas)

Requisito previo: Node.js 22 o posterior.

Shell
npm install -g @github/copilot

Nota:

Si tiene ignore-scripts=true en el ~/.npmrc archivo, debe usar el comando :

Shell
npm_config_ignore_scripts=false npm install -g @github/copilot

Para instalar la versión preliminar:

Shell
npm install -g @github/copilot@prerelease

Instalación con WinGet (Windows)

PowerShell
winget install GitHub.Copilot

Para instalar la versión preliminar:

PowerShell
winget install GitHub.Copilot.Prerelease

Instalación con Homebrew (macOS y Linux)

Shell
brew install copilot-cli

Para instalar la versión preliminar:

Shell
brew install copilot-cli@prerelease

Instalación con el script de instalación (macOS y Linux)

Shell
curl -fsSL https://gh.io/copilot-install | bash

O:

Shell
wget -qO- https://gh.io/copilot-install | bash

Para instalar en /usr/local/bin y ejecutar como superusuario, use | sudo bash.

Para instalar en un directorio personalizado, establezca la variable de entorno PREFIX. El valor predeterminado es /usr/local cuando se ejecuta como raíz o $HOME/.local cuando se ejecuta como usuario no raíz.

Para instalar una versión específica, establezca la variable del entorno VERSION. El valor predeterminado es la versión más reciente.

Por ejemplo, para instalar la versión v0.0.369 en un directorio personalizado:

Shell
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash

Descargar de GitHub.com

Puede descargar los archivos ejecutables directamente desde el copilot-cli repositorio.

Descargue el archivo ejecutable de la plataforma, desempaquelo y ejecútelo.

Autenticación con CLI de Copilot

La primera vez que se ejecuta, si no ha iniciado sesión en ese momento en GitHub, se le pedirá que use el comando de barra diagonal /login. Escribe este comando y sigue las instrucciones en pantalla para autenticarte. Para obtener más información sobre el proceso de autenticación, consulte Autenticación de la CLI de GitHub Copilot.

Autenticación con un personal access token

También puede autenticarse mediante un fine-grained personal access token con el permiso "Solicitudes de Copilot" habilitado.

  1. Visite Fine-grained personal access tokens.
  2. En "Permisos", haga clic en Agregar permisos y seleccione Copilot Solicitudes.
  3. Haga clic en Generar token.
  4. Exporte el token en la configuración del terminal o del entorno. Use la COPILOT_GITHUB_TOKENvariable de entorno , GH_TOKENo GITHUB_TOKEN (en orden de prioridad).

Pasos siguientes

Ahora puedes usar Copilot desde la línea de comandos. Consulta Uso de la CLI de GitHub Copilot.