> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalación

> Descarga e instala la CLI para Windows, Linux o macOS.

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](https://github.com/xbox/cli/blob/v0.4.2/docs/contributing/building-from-source.md).

## Windows: instalar con WinGet

En Windows, instala la CLI con [WinGet](https://learn.microsoft.com/windows/package-manager/winget/),
el Administrador de paquetes de Windows:

```powershell theme={null}
winget install xbox
xbox --version
```

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:

```powershell theme={null}
winget upgrade Microsoft.Gaming.XBOXDeveloperCLI
```

Para quitarla:

```powershell theme={null}
winget uninstall Microsoft.Gaming.XBOXDeveloperCLI
```

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](#next-steps).

## 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`:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/xbox/cli/main/install.sh | sh
```

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](https://github.com/xbox/cli/releases/latest):

| Plataforma | Recurso | Binario |
| - | - | - |
| Windows x64 | `xbox-win-x64.zip` | `xbox.exe` |
| Linux x64 | `xbox-linux-x64.zip` | `xbox` |
| macOS en Apple Silicon | `xbox-osx-arm64.zip` | `xbox` |
| macOS en Intel | `xbox-osx-x64.zip` | `xbox` |

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](#update-a-zip-installation) en su lugar.

## Windows (PowerShell)

1. Extrae el archivo y comprueba el ejecutable extraído:

   ```powershell theme={null}
   $cliDir = Join-Path $env:LOCALAPPDATA 'Programs\XboxDevCLI'
   Expand-Archive -LiteralPath "$HOME\Downloads\xbox-win-x64.zip" -DestinationPath $cliDir
   & "$cliDir\xbox.exe" --version
   ```

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:

   ```powershell theme={null}
   xbox --version
   ```

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

   ```bash theme={null}
   cli_dir="$HOME/.local/opt/xboxdevcli"
   mkdir -p "$cli_dir"
   unzip "$HOME/Downloads/xbox-linux-x64.zip" -d "$cli_dir"
   chmod u+x "$cli_dir/xbox"
   "$cli_dir/xbox" --version
   ```

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:

   ```bash theme={null}
   export PATH="$HOME/.local/opt/xboxdevcli:$PATH"
   ```

3. Abre un terminal nuevo y comprueba la versión:

   ```bash theme={null}
   xbox --version
   ```

## 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](https://docs.xbox.com/es/tools/xbox-cli/commands/upgrade.md).

```bash theme={null}
xbox 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](#linux-and-macos-install-with-a-script).
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](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md#where-values-are-saved).

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](https://github.com/xbox/cli/releases/latest), 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)](#windows-powershell) o
   [Linux y macOS (Bash o Zsh)](#linux-and-macos-bash-or-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](https://docs.xbox.com/es/tools/xbox-cli/getting-started.md): inicia sesión, elige tu vendedor de Partner Center y enumera sus
  juegos.
* [Comandos](https://docs.xbox.com/es/tools/xbox-cli/commands.md): la referencia completa de comandos.
* [Telemetría](https://docs.xbox.com/es/tools/xbox-cli/telemetry.md): qué recopila la CLI y cómo desactivarla.


## Related topics

- [Atribuir instalación](https://docs.xbox.com/es/services/playfab/api-references/rest/client/advertising/attribute-install.md)
- [Instalación por streaming: depuración](https://docs.xbox.com/es/build/core-features/common/packaging/packaging-debugging.md)
- [Instalación por streaming: estado](https://docs.xbox.com/es/build/core-features/common/packaging/packaging-installstatus.md)
- [Herramientas para la instalación mediante streaming](https://docs.xbox.com/es/build/core-features/common/packaging/deployment/atoc-deployment-tools.md)
- [Instalación por streaming e Intelligent Delivery: información general](https://docs.xbox.com/es/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery.md)
