第 2 章
安裝 GitHub Copilot CLI
把這位「住在終端機裡、會自己動手改檔案跑指令」的 AI 工程師，正式請進你的電腦——這一章只做一件事：讓終端機聽得懂 copilot 這個指令。
想像你要請一位很厲害的助手來家裡幫忙：第 0 章我們認識了這位助手是誰、跟舊版 gh copilot 有什麼不同；第 1 章學會了打開「跟電腦對話的視窗」（終端機）。這一章，我們把這位助手正式接進來。
別緊張，安裝本身很簡單，麻煩的地方只有一個：GitHub 官方給了不只一種安裝路徑，你要先知道自己該走哪一條。這一章你會學到：
- 動手裝之前，先花 10 秒確認系統夠不夠格；
- 四種官方安裝法（npm、WinGet、Homebrew、官方安裝腳本）分別適合誰，逐字指令照打；
- 裝完怎麼驗證真的裝好了；
- 解除安裝要注意什麼（老實說，這塊官方文件沒寫，我們會講清楚哪些是推論）；
- 為什麼這個工具改版速度快到你不該把任何版本號背下來。
別裝錯棚：這裡教的不是 gh copilot
如果你在網路上看到教學要你打 gh copilot suggest 或 gh copilot explain，那是舊版的 gh CLI 擴充功能，只能建議或解釋單行指令，已經在 2025-10-25 停止運作。這一章要裝的是獨立套件 @github/copilot，安裝完之後的指令是單獨的 copilot（前面沒有 gh），才是會自己讀檔、改檔、跑指令的完整版本。第 0 章有更完整的辨認方法，這裡先提醒一次，免得你複製到過時的安裝指令。
2.1 安裝前先 checklist：系統夠不夠格
正式動手前，先對一下官方寫明的門檻。這些不是嚇唬人的數字，只是讓你萬一卡住時，能快速排除「根本是版本太舊」這個可能性 官方：
| 項目 | 官方門檻 | 備註 |
|---|---|---|
| GitHub Copilot 訂閱 | 需要一份有效的訂閱 | Free／Pro／Pro+／Business／Enterprise 都算數，訂閱方案細節留到第 3 章講；若由組織提供，還要確認管理員已啟用 Copilot CLI policy |
| Node.js（僅走 npm 安裝時需要） | 22 或更新版本 | 只在 npm 這一條路需要；走 WinGet／Homebrew／官方腳本都不需要，也不必為 Copilot 特地安裝 Node |
| PowerShell（僅 Windows 走原生安裝時） | 官方最低 v6；本書新手路線固定用 Windows Terminal 的 PowerShell 7 | 不要在系統內建的 Windows PowerShell 5 或 CMD／WSL 裡混貼安裝指令 |
第一次從零開始時，先確認你的 GitHub 帳號確實有可用的 Copilot 方案、Windows 是否已有 PowerShell 7，以及 Git 與練習資料夾；不確定 Node.js 要不要裝，先看從零開始的共同清單。Node.js 22+ 只屬於 npm 安裝法，不是 Windows／Mac／Linux 的共同前置條件。
補充資訊：官方沒寫的部分，老實告訴你
查證這一節時發現，官方安裝頁沒有列出明確的作業系統版本清單（例如 macOS 要幾版以上、Ubuntu 要幾版以上）、也沒有列出 CPU 架構支援表（x64／arm64），更沒有要求 WSL。這不是我們漏看，是官方頁面本身就沒寫這麼細。本書的保守主線是 Windows Terminal → PowerShell 7 → WinGet：裝不動時保留錯誤訊息，先確認版本與公司政策，不要轉去 CMD、npm 或 WSL 混著試。
2.2 從零開始：每個人只選一條安裝路線
這四種方式最後裝到的都是同一個 copilot，但新手不要把它們當成四條備援路線輪流試。先依下表選唯一一條，安裝失敗就檢查那一條的前置條件或公司政策，不要混用不同工具留下的設定。
先用一張表幫你選 官方（四種方式與各自需求皆出自官方安裝頁逐字內容）：
| 安裝方式 | 適合誰 | 需要先裝 Node.js？ | 平台 |
|---|---|---|---|
| npm | 本來就在用 Node.js 開發的人 | 要（22+） | 全平台 |
| WinGet | Windows 新手唯一主線：Windows Terminal 的 PowerShell 7 | 不用 | 僅 Windows |
| Homebrew | 已經在用 Homebrew 的 Mac／Linux 使用者 | 不用 | macOS／Linux |
| 官方安裝腳本 | 想要一行指令解決、不在乎背後裝在哪 | 不用 | macOS／Linux |
從零開始的唯一選路
- Windows：開 Windows Terminal，選 PowerShell 7 分頁，先跑
winget --version；有版本號才走 WinGet。沒有或公司禁止時，更新官方 App Installer 或問 IT，不要改去 npm、CMD 或 WSL。 - macOS／Linux：不知道 Homebrew 或 npm 是什麼，就直接走本節後面的官方安裝腳本。只從 GitHub 官方安裝頁複製其當下顯示的官方網址。
- 已熟悉 npm 或 Homebrew：才可選對應方式；不確定自己是否熟悉，就不要選它。Node.js 22+ 只在 npm 路線才需要。
進階招式一：npm（全平台；僅此路徑需要 Node.js 22+）
只有你本來就在寫 JS、知道 npm 是什麼，並且確認 Node.js 是 22 或更新版本時才選這招 官方。不知道 npm／Node.js，請不要為了 Copilot 去猜著安裝；回上面的唯一選路即可。
node --version
npm --version第一行必須顯示 v22 或更高版本，才繼續：
npm install -g @github/copilot如果你的 ~/.npmrc 裡設定了 ignore-scripts=true（有些人為了安全會這樣設），上面這行可能裝不完整，改用這行讓安裝腳本正常跑完 官方：
npm_config_ignore_scripts=false npm install -g @github/copilot想搶先用預發行版（不建議日常使用，功能可能不穩定）官方：
npm install -g @github/copilot@prereleaseWindows 主線：WinGet（Windows Terminal → PowerShell 7，不需要 Node）
這是 Windows 從零開始唯一要走的官方原生安裝管道 官方。先開 Windows Terminal，選 PowerShell 7 分頁；若游標不是 PS 開頭，先切對分頁。不要在 Windows PowerShell 5、CMD 或 WSL 裡執行。
第一步先確認 WinGet 存在：
winget --version看到版本號才繼續；若顯示找不到指令，請從 Microsoft Store／公司軟體中心更新官方 App Installer，或詢問 IT。不要因此改走 npm、Homebrew、CMD 或 WSL。
winget install GitHub.Copilot預發行版 官方：
winget install GitHub.Copilot.PrereleaseWindows 不需要 WSL
本書把 WinGet 設為 Windows 唯一路線，避免 PowerShell／CMD／WSL 之間的路徑、Node 與設定互相干擾。公司既有 WSL 專案則應完全依公司文件操作，不應與這裡的 PowerShell 安裝共用。
進階招式三：Homebrew（macOS 與 Linux，不需要 Node）
只有你本來就在用 Homebrew、知道它管理哪些套件時才選這招 官方。不知道 brew 是什麼，就不要選它；macOS／Linux 請改走下一節的官方安裝腳本。
brew install --cask copilot-cli務必加 --cask
正確是 brew install --cask copilot-cli，如果漏了 --cask 會找不到套件或裝到錯的東西。這是官方文件寫明的正確語法，照抄就好。
預發行版 官方：
brew install --cask copilot-cli@prereleasemacOS／Linux 主線：官方安裝腳本
不知道 npm 或 Homebrew 的 macOS／Linux 使用者，從零開始就走這條。GitHub 官方安裝頁目前列出的指令是：
curl -fsSL https://gh.io/copilot-install | bash只在你從GitHub 官方安裝頁確認這個精確網址後才執行；不要把部落格、聊天或搜尋結果給的下載網址代入。指令完成後立刻驗證：
copilot --version看得到版本號才算完成；看不到時保留錯誤訊息，回官方安裝頁或詢問公司 IT，不要改用另一套安裝方式混著重裝。
需要自訂安裝位置或版本？那是進階情境
官方腳本支援 PREFIX（自訂安裝路徑）與 VERSION（指定版本），但從零開始不要先改它們。先使用上面的官方預設指令並完成 copilot --version 驗證；只有公司文件明確要求時才依官方頁面處理自訂值。
補充：直接下載執行檔
如果上面四招都不適用（例如離線環境、公司鎖死套件安裝權限），官方也提供另一條路：直接到github/copilot-cli 的 Releases 頁面下載對應平台的執行檔 官方。
2.3 驗證安裝：真的裝好了嗎？
裝完之後，在終端機打這一行，看它有沒有吐出版本號：
copilot --version看到一串版本號（例如 1.0.71 之類的數字），代表安裝成功、終端機認得 copilot 了。
小技巧
--version 是命令列工具的業界通用慣例，幾乎每個 CLI 都吃這個旗標。不過保險起見，真的有疑問時，直接跑 copilot --help 看看目前這一版實際支援哪些旗標最準——這工具改版很快，靠自己實機確認永遠比背書上的文字可靠。
裝完後第一次啟動要做的事（登入、信任目錄確認）留到下一章細講；這一章你只需要確認 copilot --version 有反應就算完工。
2.4 解除安裝：把它請出去
不想用了，移除方式看你當初怎麼裝的：
| 你當初用的安裝法 | 移除指令 |
|---|---|
| npm | npm uninstall -g @github/copilot |
| Homebrew | brew uninstall --cask copilot-cli |
| WinGet | winget uninstall GitHub.Copilot |
這一段官方沒有寫，是我們的推論
查證時發現，官方安裝頁完全沒有「Uninstalling（解除安裝）」這個段落。上面這張表是各套件管理工具的標準反向指令（裝的時候用 install，理所當然對應 uninstall），是合理推論，不是官方逐字寫明的步驟 社群。如果照著做卻遇到殘留檔案或行為跟預期不同，別懷疑自己操作錯，那本來就是官方沒明講的灰色地帶，以你實機的套件管理工具輸出為準。
2.5 這工具改版真的很快，別把版本號背下來
寫這一章的查證過程中，我們看到 GitHub 官方儲存庫 github/copilot-cli 的 Releases 頁面在短短兩天內（2026-07-16 至 2026-07-17）連續發了四個版號：1.0.70 → 1.0.71 → 1.0.72-0 → 1.0.72-1 官方。
版本時效提醒
這代表本章任何提到的版本號、指令細節，都只是「查證當下」的快照，過幾天很可能就變了。真的要以哪個為準，記住兩條：裝完馬上跑 copilot --version 看自己實際裝到哪一版；指令旗標有疑問，跑 copilot --help 或翻官方文件，不要死記本書任何具體版本號。本章對照的查證日期為 2026-07-18。
小結
走到這裡，你已經把 GitHub Copilot CLI 請進電腦了：知道四種安裝法各自適合誰、能在自己的系統上把它裝起來、也學會了怎麼驗證裝沒裝成功，以及解除安裝時哪些是官方講的、哪些是我們的推論。下一章，我們要真正第一次啟動它、完成登入，讓這位 AI 工程師正式上工。
動手試試
- 照 2.2 節挑一招，把 GitHub Copilot CLI 裝到你的電腦上（不用四招都做，挑最順手的那一招就好）。
- 跑
copilot --version，確認看得到版本號。 - 跑一次
copilot --help，看看你這一版實際支援哪些旗標，跟本章寫的是否一致。 - （🪟 Windows）在 Windows Terminal 的 PowerShell 7 分頁跑
winget --version，再執行 WinGet 安裝；不要改用 CMD 或 WSL。