Pular para o conteúdo principal
Instale a XBOX CLI com o WinGet no Windows, com o script de instalação no Linux ou no macOS, ou a partir de um arquivo de versão em qualquer plataforma. Para compilá-la a partir do código-fonte, consulte Building from source.

Windows: instalar com o WinGet

No Windows, instale a CLI com o WinGet, o Gerenciador de Pacotes do Windows:
O WinGet adiciona xbox ao seu PATH e não precisa de direitos de administrador. Se o terminal não encontrar xbox após a instalação, abra um novo terminal ou reinicie o IDE, se você usar o terminal integrado dele. Para atualizar a CLI:
Para removê-la:
A desinstalação mantém suas configurações salvas e seus dados de login em %LOCALAPPDATA%\XboxDevCLI. Atualize uma instalação do WinGet somente com o WinGet, não com as etapas de ZIP desta página. Continue com Próximas etapas.

Linux e macOS: instalar com um script

No Linux x64 ou no macOS, o script de instalação baixa a versão mais recente em ~/.local/opt/xboxdevcli e adiciona esse diretório ao seu PATH no arquivo de inicialização do shell. Ele precisa de curl e unzip:
O script imprime o arquivo de inicialização que ele alterou. Abra um novo terminal e verifique a versão com xbox --version. Para atualizar a CLI, execute o script novamente. Para removê-la, exclua ~/.local/opt/xboxdevcli e a linha que o script adicionou a esse arquivo de inicialização.

Baixar uma versão

Instale a partir de um arquivo de versão quando o WinGet e o script de instalação não forem adequados, como em um PC com Windows sem o WinGet. Baixe o arquivo para o seu sistema operacional e a sua CPU na página GitHub Releases: O binário do Linux x64 requer a glibc 2.27 ou posterior. Os binários do macOS são assinados pela Microsoft e autenticados pela Apple. Você não precisa instalar o .NET. Extraia o arquivo inteiro em um novo diretório próprio e adicione esse diretório ao seu PATH, conforme mostram as etapas da sua plataforma. Se o diretório já contiver uma instalação, siga Atualizar uma instalação via ZIP.

Windows (PowerShell)

  1. Extraia o arquivo e verifique o executável extraído:
  2. Adicione o diretório ao seu PATH. Na Pesquisa do Windows, abra Edit environment variables for your account. Em User variables, edite Path, selecione New e insira o diretório, como C:\Users\<you>\AppData\Local\Programs\XboxDevCLI.
  3. Abra um novo terminal e verifique a versão:

Linux e macOS (Bash ou Zsh)

  1. Extraia o arquivo e verifique o executável extraído. Este exemplo usa o Linux x64; no macOS, use xbox-osx-arm64.zip no Apple silicon ou xbox-osx-x64.zip no Intel:
  2. Adicione o diretório ao seu PATH. Adicione esta linha a ~/.zshrc para o Zsh, o shell padrão no macOS, ou a ~/.bashrc para o Bash:
  3. Abra um novo terminal e verifique a versão:

Verificar a instalação

xbox --version mostra a versão que você baixou, sem o v inicial da tag. Se ele mostrar uma versão mais antiga, outra cópia de xbox vem primeiro no seu PATH. Encontre-a com Get-Command xbox -All no PowerShell ou type -a xbox no Bash ou no Zsh e remova-a do seu PATH.

Verificar se há atualizações

xbox upgrade informa se há uma versão mais recente e como instalá-la. Consulte Upgrade.
Para atualizar uma instalação do WinGet, execute winget upgrade Microsoft.Gaming.XBOXDeveloperCLI. Para atualizar uma instalação via script, execute o script de instalação novamente. Para atualizar uma instalação via ZIP, siga a próxima seção.

Atualizar uma instalação via ZIP

Suas configurações salvas e seus dados de login são armazenados separadamente da instalação; portanto, eles são mantidos. Consulte Onde os valores são salvos.
  1. Baixe o arquivo da nova versão na página da versão que xbox upgrade mostra ou na página GitHub Releases e extraia-o em um novo diretório.
  2. Feche todos os processos xbox em execução.
  3. Substitua o diretório da instalação antiga pelo novo, no mesmo caminho, ou altere a entrada do seu PATH para o novo diretório, como em Windows (PowerShell) ou Linux e macOS (Bash ou Zsh).
  4. Abra um novo terminal e verifique se xbox --version mostra a nova versão.
Mantenha o diretório antigo, fora do seu PATH, até que a nova versão funcione. Se o seu login tiver expirado, execute xbox auth login novamente.

Próximas etapas

  • Introdução: entre, escolha seu vendedor do Partner Center e liste os jogos dele.
  • Comandos: a referência completa de comandos.
  • Telemetria: o que a CLI coleta e como desativar.
Última modificação em 19 de novembro de 2026