跳轉到主要內容
在 Windows 上使用 WinGet、在 Linux 或 macOS 上使用安裝指令碼,或在任何平台上從版本封存安裝 XBOX CLI。若要改為從原始碼建置,請參閱從原始碼建置。

Windows:使用 WinGet 安裝

在 Windows 上,使用 Windows 套件管理員 WinGet 安裝 CLI:
WinGet 會將 xbox 新增至您的 PATH,且不需要系統管理員權限。如果安裝後終端機找不到 xbox,請開啟新的終端機;如果您使用 IDE 的整合式終端機,請重新啟動 IDE。 若要更新 CLI:
若要將其移除:
解除安裝會將您已儲存的設定和登入資料保留在 %LOCALAPPDATA%\XboxDevCLI 中。請只使用 WinGet 更新 WinGet 安裝,而不要使用此頁面上的 ZIP 步驟。請繼續進行後續步驟。

Linux 和 macOS:使用指令碼安裝

在 Linux x64 或 macOS 上,安裝指令碼會將最新版本下載到 ~/.local/opt/xboxdevcli,並在殼層的啟動檔案中將該目錄新增至您的 PATH。它需要 curl 和 unzip:
指令碼會列印它所變更的啟動檔案。開啟新的終端機,並使用 xbox --version 檢查版本。若要更新 CLI,請再次執行指令碼。若要將其移除,請刪除 ~/.local/opt/xboxdevcli,以及指令碼新增至該啟動檔案的那一行。

下載版本

當 WinGet 和安裝指令碼都不適用時 (例如在沒有 WinGet 的 Windows PC 上),請從版本封存安裝。 從 GitHub Releases 頁面下載適用於您作業系統和 CPU 的封存: Linux x64 二進位檔需要 glibc 2.27 或更新版本。macOS 二進位檔由 Microsoft 簽署並經過 Apple 公證。您不需要安裝 .NET。 將整個封存解壓縮到自己專用的新目錄中,並依照您平台的步驟將該目錄新增至您的 PATH。如果該目錄已包含安裝,請改為依照更新 ZIP 安裝進行操作。

Windows (PowerShell)

  1. 解壓縮封存,並檢查解壓縮後的可執行檔:
  2. 將目錄新增至您的 PATH。從 Windows 搜尋開啟 Edit environment variables for your account。在 User variables 下,編輯 Path、選取 New,然後輸入目錄,例如 C:\Users\<you>\AppData\Local\Programs\XboxDevCLI。
  3. 開啟新的終端機,並檢查版本:

Linux 和 macOS (Bash 或 Zsh)

  1. 解壓縮封存,並檢查解壓縮後的可執行檔。此範例使用 Linux x64;在 macOS 上,Apple 晶片請使用 xbox-osx-arm64.zip,Intel 則使用 xbox-osx-x64.zip:
  2. 將目錄新增至您的 PATH。若為 Zsh (macOS 上的預設殼層),請將此行新增至 ~/.zshrc;若為 Bash,則新增至 ~/.bashrc:
  3. 開啟新的終端機,並檢查版本:

驗證安裝

xbox --version 會顯示您所下載版本的版本號碼,不含標籤開頭的 v。如果它顯示較舊的版本,表示您的 PATH 中有另一份 xbox 排在前面。在 PowerShell 中使用 Get-Command xbox -All,或在 Bash 或 Zsh 中使用 type -a xbox 找到它,並將其從您的 PATH 中移除。

檢查更新

xbox upgrade 會告訴您是否有較新的版本,以及如何安裝它。請參閱升級。
若要更新 WinGet 安裝,請執行 winget upgrade Microsoft.Gaming.XBOXDeveloperCLI。若要更新指令碼安裝,請再次執行安裝指令碼。若要更新 ZIP 安裝,請依照下一節進行操作。

更新 ZIP 安裝

您已儲存的設定和登入資料會與安裝分開存放,因此會保留下來。請參閱值的儲存位置。
  1. 從 xbox upgrade 顯示的版本頁面,或從 GitHub Releases 頁面下載新版本的封存,並將其解壓縮到新的目錄中。
  2. 關閉所有執行中的 xbox 處理序。
  3. 以新的安裝目錄取代舊的安裝目錄 (位於相同路徑),或依照 Windows (PowerShell) 或 Linux 和 macOS (Bash 或 Zsh) 中的說明,將您的 PATH 項目變更為新目錄。
  4. 開啟新的終端機,並檢查 xbox --version 是否顯示新版本。
在新版本可以正常運作之前,請保留舊目錄,但將其從您的 PATH 中移除。如果您的登入已到期,請再次執行 xbox auth login。

後續步驟

  • 開始使用:登入、選擇您的 Partner Center 賣方,並列出其遊戲。
  • 命令:完整的命令參考。
  • 遙測:CLI 收集的內容,以及如何將其關閉。
最後修改於 2026年11月19日