Passer au contenu principal
Installez la XBOX CLI avec WinGet sous Windows, avec le script d’installation sous Linux ou macOS, ou à partir d’une archive de version sur n’importe quelle plateforme. Pour la générer plutôt à partir du code source, consultez Building from source.

Windows : installer avec WinGet

Sous Windows, installez la CLI avec WinGet, le Gestionnaire de package Windows :
WinGet ajoute xbox à votre PATH et ne nécessite aucun droit d’administrateur. Si le terminal ne trouve pas xbox après l’installation, ouvrez un nouveau terminal, ou redémarrez votre IDE si vous utilisez son terminal intégré. Pour mettre à jour la CLI :
Pour la supprimer :
La désinstallation conserve vos paramètres enregistrés et vos données de connexion dans %LOCALAPPDATA%\XboxDevCLI. Mettez à jour une installation WinGet uniquement avec WinGet, et non avec les étapes ZIP de cette page. Poursuivez avec Étapes suivantes.

Linux et macOS : installer avec un script

Sous Linux x64 ou macOS, le script d’installation télécharge la dernière version dans ~/.local/opt/xboxdevcli et ajoute ce répertoire à votre PATH dans le fichier de démarrage de votre shell. Il nécessite curl et unzip :
Le script affiche le fichier de démarrage qu’il a modifié. Ouvrez un nouveau terminal et vérifiez la version avec xbox --version. Pour mettre à jour la CLI, exécutez de nouveau le script. Pour la supprimer, supprimez ~/.local/opt/xboxdevcli et la ligne que le script a ajoutée à ce fichier de démarrage.

Télécharger une version

Installez la CLI à partir d’une archive de version lorsque WinGet et le script d’installation ne conviennent pas, par exemple sur un PC Windows sans WinGet. Téléchargez l’archive correspondant à votre système d’exploitation et à votre processeur depuis la page GitHub Releases : Le binaire Linux x64 nécessite glibc 2.27 ou version ultérieure. Les binaires macOS sont signés par Microsoft et notariés par Apple. Vous n’avez pas besoin d’installer .NET. Extrayez l’intégralité de l’archive dans un nouveau répertoire dédié, puis ajoutez ce répertoire à votre PATH, comme l’indiquent les étapes pour votre plateforme. Si le répertoire contient déjà une installation, suivez plutôt Mettre à jour une installation ZIP.

Windows (PowerShell)

  1. Extrayez l’archive et vérifiez l’exécutable extrait :
  2. Ajoutez le répertoire à votre PATH. Dans la recherche Windows, ouvrez Modifier les variables d’environnement pour votre compte. Sous Variables utilisateur, modifiez Path, sélectionnez Nouveau, puis saisissez le répertoire, par exemple C:\Users\<you>\AppData\Local\Programs\XboxDevCLI.
  3. Ouvrez un nouveau terminal et vérifiez la version :

Linux et macOS (Bash ou Zsh)

  1. Extrayez l’archive et vérifiez l’exécutable extrait. Cet exemple utilise Linux x64 ; sous macOS, utilisez xbox-osx-arm64.zip sur Apple silicon ou xbox-osx-x64.zip sur Intel :
  2. Ajoutez le répertoire à votre PATH. Ajoutez cette ligne à ~/.zshrc pour Zsh, le shell par défaut sous macOS, ou à ~/.bashrc pour Bash :
  3. Ouvrez un nouveau terminal et vérifiez la version :

Vérifier l’installation

xbox --version affiche la version que vous avez téléchargée, sans le v initial de l’étiquette. Si une version plus ancienne s’affiche, une autre copie de xbox apparaît en premier dans votre PATH. Trouvez-la avec Get-Command xbox -All dans PowerShell ou type -a xbox dans Bash ou Zsh, puis supprimez-la de votre PATH.

Rechercher des mises à jour

xbox upgrade vous indique s’il existe une version plus récente et comment l’installer. Consultez Upgrade.
Pour mettre à jour une installation WinGet, exécutez winget upgrade Microsoft.Gaming.XBOXDeveloperCLI. Pour mettre à jour une installation par script, exécutez de nouveau le script d’installation. Pour mettre à jour une installation ZIP, suivez la section suivante.

Mettre à jour une installation ZIP

Vos paramètres enregistrés et vos données de connexion sont stockés séparément de l’installation : ils sont donc conservés. Consultez Emplacement d’enregistrement des valeurs.
  1. Téléchargez l’archive de la nouvelle version depuis la page de version qu’affiche xbox upgrade, ou depuis la page GitHub Releases, puis extrayez-la dans un nouveau répertoire.
  2. Fermez tous les processus xbox en cours d’exécution.
  3. Remplacez votre ancien répertoire d’installation par le nouveau, au même chemin, ou modifiez l’entrée de votre PATH pour qu’elle pointe vers le nouveau répertoire, comme dans Windows (PowerShell) ou Linux et macOS (Bash ou Zsh).
  4. Ouvrez un nouveau terminal et vérifiez que xbox --version affiche la nouvelle version.
Conservez l’ancien répertoire, hors de votre PATH, jusqu’à ce que la nouvelle version fonctionne. Si votre connexion a expiré, exécutez de nouveau xbox auth login.

Étapes suivantes

  • Prise en main : connectez-vous, choisissez votre vendeur Partner Center et répertoriez ses jeux.
  • Commandes : la référence complète des commandes.
  • Télémétrie : ce que la CLI collecte et comment le désactiver.
Dernière modification le 19 novembre 2026