Windows 安裝說明 (基礎版)

安裝 GitHub Copilot CLI 所需的工具與環境

如果你是 Windows 用戶，建議手動安裝以下軟體：

1. 安裝 PowerShell v7.5 版本

   因為 Windows 內建的 PowerShell 是 v5.1 版，這個版本問題很多，會導致 AI Coding 工具生成的指令碼無法執行，但是用 v7.5 以上版本就會順利很多！

2. 到 Microsoft Store 加裝 Windows Terminal 工具

   這個是一個終端機介面，可以讓你更好的執行上述的 AI Coding Agent 工具。

3. 第一次安裝與使用 PowerShell 的人，請在啟動 PowerShell 的時候，務必一定要先執行以下命令

   開啟 Windows Terminal 終端機視窗，或者按下 Win+R 開啟「執行」視窗，輸入 wt 就可以開啟視窗，然後依序複製貼上以下指令：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
   

   執行下去可以讓你這輩子多活個幾分鐘，可以在日後少很多問題。

4. 安裝一些必備工具

   在 Windows 至少還需要安裝 git、uv、Node.js 工具。

   請繼續在 Windows Terminal 終端機視窗，依序複製貼上以下指令：

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

   請關閉目前的 Windows Terminal 終端機視窗。

5. 安裝 Copilot CLI 工具

   開啟 Windows Terminal 終端機視窗，或者按下 Win+R 開啟「執行」視窗，輸入 wt 就可以開啟視窗，然後依序複製貼上以下指令：

   npm install -g @github/copilot
   

   檢查 Copilot CLI 的版本

   copilot -v