Windows 安裝說明 (Unicode)

安裝 Spec Kit 所需的工具與環境

如果你是 Windows 用戶，而且你的使用者家目錄包含「中文」字元，安裝過程可能會出現錯誤，此時建議參考這份文件下去安裝。

1. 請先開啟 PowerShell 5 終端機視窗，或者按下 Win+R 開啟「執行」視窗，輸入 powershell 就可以開啟命令列視窗，然後依序複製貼上以下指令：

   # 安裝 Scoop 套件管理器
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
   Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
   
   # 安裝 git 與 uv 與 nvm
   scoop install pwsh git uv
   
   # 安裝搜尋文字檔案的利器 ripgrep
   scoop install ripgrep
   
   # 更新 uv 的路徑
   uv tool update-shell
   
   # 重新啟動檔案總管，讓環境變數生效
   Stop-Process -Name explorer -Force; Start-Process explorer
   

2. 安裝 NVM for Windows 工具

   這個工具可以將 nvm 安裝到「非家目錄」的資料夾中，可以避開「中文資料夾名稱」所造成的問題。

   請先到 https://github.com/coreybutler/nvm-windows/releases 下載最新版本的 nvm-setup.exe 安裝檔，並直接執行安裝精靈。

   安裝到 Select Destination Location 的時候，就可以自由選擇要安裝的目標路徑，你可以手動修改到 C:\nvm 或任意資料夾，但請記得整個路徑最好都不要出現中文或空白字元。

   

   其他步驟就直接按「下一步」走到底即可安裝成功！

3. 關閉 PowerShell 視窗，重新開啟 pwsh.exe 命令列視窗，或者按下 Win+R 開啟「執行」視窗，輸入 pwsh 就可以開啟命令列視窗，然後依序複製貼上以下指令：

   # 透過 nvm 安裝 Node.js LTS 版本
   nvm install lts
   nvm use lts
   
   # 安裝 Spec Kit 的 Specify CLI 命令列工具
   uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
   
   # 安裝 Copilot CLI (請自由選擇)
   npm install -g @github/copilot
   
   # 安裝 Claude Code (請自由選擇)
   npm install -g @anthropic-ai/claude-code
   
   # 檢查 Spec Kit 需要的工具支援
   specify check
   

   你至少需要看到 Git version control 是綠燈，還有 GitHub Copilot 或 Claude Code 或任何一套 AI Coding 工具是綠燈，環境就差不多設定完畢！

   

💡 關於 GitHub Copilot CLI 或 Claude Code 的使用，各位學員可能要自行學習了！