Saltar al contenido principal
Instala la XBOX CLI con WinGet en Windows, con el script de instalación en Linux o macOS, o desde un archivo de versión en cualquier plataforma. Para compilarla desde el código fuente, consulta Building from source.

Windows: instalar con WinGet

En Windows, instala la CLI con WinGet, el Administrador de paquetes de Windows:
WinGet agrega xbox a tu PATH y no necesita derechos de administrador. Si el terminal no encuentra xbox después de la instalación, abre un terminal nuevo o reinicia tu IDE si usas su terminal integrado. Para actualizar la CLI:
Para quitarla:
Al desinstalarla, la configuración guardada y los datos de inicio de sesión se conservan en %LOCALAPPDATA%\XboxDevCLI. Actualiza una instalación de WinGet solo con WinGet, no con los pasos de ZIP de esta página. Continúa con Pasos siguientes.

Linux y macOS: instalar con un script

En Linux x64 o macOS, el script de instalación descarga la versión más reciente en ~/.local/opt/xboxdevcli y agrega ese directorio a tu PATH en el archivo de inicio de tu shell. Necesita curl y unzip:
El script muestra el archivo de inicio que modificó. Abre un terminal nuevo y comprueba la versión con xbox --version. Para actualizar la CLI, vuelve a ejecutar el script. Para quitarla, elimina ~/.local/opt/xboxdevcli y la línea que el script agregó a ese archivo de inicio.

Descargar una versión

Instala desde un archivo de versión cuando WinGet y el script de instalación no sean adecuados, por ejemplo, en un PC con Windows sin WinGet. Descarga el archivo para tu sistema operativo y tu CPU desde la página de versiones de GitHub: El binario de Linux x64 requiere glibc 2.27 o posterior. Los binarios de macOS están firmados por Microsoft y certificados por Apple. No necesitas instalar .NET. Extrae el archivo completo en un directorio nuevo propio y agrega ese directorio a tu PATH, como muestran los pasos de tu plataforma. Si el directorio ya contiene una instalación, sigue Actualizar una instalación desde ZIP en su lugar.

Windows (PowerShell)

  1. Extrae el archivo y comprueba el ejecutable extraído:
  2. Agrega el directorio a tu PATH. Desde Windows Search, abre Editar las variables de entorno de esta cuenta. En Variables de usuario, edita Path, selecciona Nuevo y escribe el directorio, como C:\Users\<you>\AppData\Local\Programs\XboxDevCLI.
  3. Abre un terminal nuevo y comprueba la versión:

Linux y macOS (Bash o Zsh)

  1. Extrae el archivo y comprueba el ejecutable extraído. Este ejemplo usa Linux x64; en macOS, usa xbox-osx-arm64.zip en Apple Silicon o xbox-osx-x64.zip en Intel:
  2. Agrega el directorio a tu PATH. Agrega esta línea a ~/.zshrc para Zsh, el shell predeterminado en macOS, o a ~/.bashrc para Bash:
  3. Abre un terminal nuevo y comprueba la versión:

Comprobar la instalación

xbox --version muestra la versión que descargaste, sin la v inicial de la etiqueta. Si muestra una versión anterior, hay otra copia de xbox antes en tu PATH. Búscala con Get-Command xbox -All en PowerShell o type -a xbox en Bash o Zsh, y quítala de tu PATH.

Buscar actualizaciones

xbox upgrade te indica si hay una versión más reciente y cómo instalarla. Consulta Upgrade.
Para actualizar una instalación de WinGet, ejecuta winget upgrade Microsoft.Gaming.XBOXDeveloperCLI. Para actualizar una instalación con script, vuelve a ejecutar el script de instalación. Para actualizar una instalación desde ZIP, sigue la sección siguiente.

Actualizar una instalación desde ZIP

La configuración guardada y los datos de inicio de sesión se almacenan aparte de la instalación, por lo que se conservan. Consulta Dónde se guardan los valores.
  1. Descarga el archivo de la nueva versión desde la página de la versión que muestra xbox upgrade, o desde la página de versiones de GitHub, y extráelo en un directorio nuevo.
  2. Cierra los procesos de xbox que estén en ejecución.
  3. Reemplaza el directorio de instalación anterior por el nuevo, en la misma ruta, o cambia la entrada de tu PATH al nuevo directorio como en Windows (PowerShell) o Linux y macOS (Bash o Zsh).
  4. Abre un terminal nuevo y comprueba que xbox --version muestra la nueva versión.
Conserva el directorio anterior, fuera de tu PATH, hasta que la nueva versión funcione. Si tu inicio de sesión ha expirado, vuelve a ejecutar xbox auth login.

Pasos siguientes

  • Introducción: inicia sesión, elige tu vendedor de Partner Center y enumera sus juegos.
  • Comandos: la referencia completa de comandos.
  • Telemetría: qué recopila la CLI y cómo desactivarla.
Última modificación el 19 de noviembre de 2026