Passer au contenu principal
Installez l’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 plutôt la générer à 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 laisse 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. Passez ensuite à É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

Effectuez l’installation à 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 à partir de la page GitHub Releases : Le fichier binaire Linux x64 nécessite glibc 2.27 ou une version ultérieure. Les fichiers binaires macOS sont signés par Microsoft et notariés par Apple. Vous n’avez pas besoin d’installer .NET. Extrayez l’archive complète dans un nouveau répertoire qui lui est propre, et 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. À partir de la recherche Windows, ouvrez Modifier les variables d’environnement pour votre compte. Sous Variables utilisateur, modifiez Path, sélectionnez Nouveau et entrez 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 elle affiche une version plus ancienne, une autre copie de xbox figure en premier dans votre PATH. Trouvez-la avec Get-Command xbox -All dans PowerShell ou type -a xbox dans Bash ou Zsh, et retirez-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 à part de l’installation; ils sont donc conservés. Consultez Emplacement des valeurs enregistrées.
  1. Téléchargez l’archive de la nouvelle version à partir de la page de version qu’affiche xbox upgrade, ou à partir de la page GitHub Releases, et 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 votre entrée 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 recueille, et comment la désactiver.
Dernière modification le 19 novembre 2026