Instalación de la CLI de GitHub Copilot

Obtenga información sobre cómo instalar CLI de Copilot para que pueda 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 Copilot planes. Si una organización le envía Copilot, la política 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, consulte Acerca de GitHub Copilot CLI.

Prerrequisitos

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

Si tiene acceso a a GitHub Copilot 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. Consulte Administración de directivas y características para GitHub Copilot en su organización.

Instalación o actualización 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 desde GitHub.com

Puede descargar los archivos ejecutables directamente desde the copilot-cli repository.

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

Autenticación con CLI de Copilot

En el primer inicio, si no ha iniciado sesión actualmente en GitHub, se le pedirá que use el /login comando de barra diagonal. 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 personal access token

También puede autenticarse mediante un fine-grained personal access token con el permiso "Copilot Solicitudes" 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 puede usar Copilot desde la línea de comandos. Consulte Uso de la CLI de GitHub Copilot.