#在 Windows 安裝 HolyCrab CLI

本頁說明手動安裝步驟。已通過一鍵安裝完成的使用者，可直接進入配置 API Key。本頁所有命令都在 Windows PowerShell 中執行。不需要安裝其他終端機工具，也不需要管理員權限。

#開始前的準備

• Windows 10 或 Windows 11，並且可以聯網。
• 可以為自己的 Windows 帳號安裝軟體。
• 配置 API Key前先關閉可能看到私密資訊的螢幕共享。

#安裝步驟

#1. 開啟 PowerShell

點選開始選單，輸入 PowerShell，開啟 Windows PowerShell。系統將顯示藍色或深色命令視窗。

在開始選單搜尋 PowerShell，然後開啟它。

#2. 檢查 Python

複製下面命令並按Enter。看到例如 Python 3.12.7 就可以繼續；低於 3.10 要先升級。

py -3 --version

#3. 缺少 Python 時進行安裝

如果提示找不到 py，請執行下面的命令。安裝完成後關閉並重新開啟 PowerShell，再次檢查版本。

winget install --id Python.Python.3.12 -e

#4. 安裝 HolyCrab

完整複製這一整行並按Enter。它會下載官方安裝器、把 holycrab 加入當前使用者 PATH，並連線這台電腦上已支援的 Agent。

irm https://holycrab.ai/cli/install.ps1 | iex

最後應顯示安裝完成，以及 HolyCrab 0.4.4 installed。

#5. 執行本機檢查

在同一個 PowerShell 視窗執行下面命令。找到 "ok": true 即可；此時提示還沒配置 API Key 是正常的。

holycrab doctor --json

#未成功時

• 如果 PowerShell 提示某個陌生的 Unix 命令不存在，說明覆制了 macOS/Linux 命令；請改用本頁的 PowerShell 命令。
• 安裝成功後仍提示找不到 holycrab，先關閉 PowerShell，開啟新視窗再檢查。
• 仍失敗時重新運行同一條安裝命令修復一次，再去常見問題頁。