先搞懂 GitHub Copilot CLI 是什麼

別緊張，這一章完全不用你動手打指令。我們先花幾分鐘把「GitHub Copilot CLI 到底是什麼」弄清楚——尤其是一個很容易踩到的認錯陷阱——後面安裝、登入、真正動手時才不會走錯棚。

0.1 一句話 + 一個比喻

先給你最濃縮的一句話：

GitHub Copilot CLI 是 GitHub 官方推出、住在你終端機裡、會自己讀檔、改檔、跑指令的 AI 工程師。

它是 GitHub 在 2025 年 9 月才推出的獨立新產品，跟你可能聽過的「Copilot」不完全是同一回事（這件事很重要，我們馬上在 0.2 節拆給你看）。

官方在公開預覽公告裡是這樣描述它的定位（GitHub Blog changelog，2025-09-25，官方原文）：

"Terminal-native development: Work with Copilot coding agent directly in your command line — no context switching required."
（終端機原生的開發體驗：直接在你的命令列裡跟 Copilot 編碼代理工作，不需要切換視窗。）

"Full control: Preview every action before execution — nothing happens without your explicit approval."
（完全掌控：每個動作執行前都能先預覽，沒有你明確核可就不會發生任何事。）

比喻：想像你請了一位隨傳隨到、不會累的工程師助手，而且這位助手剛好是 GitHub 自家人——他不只會幫你讀檔、改檔、跑測試，還天生就懂怎麼開 PR（Pull Request，合併程式碼的申請）、看 issue（問題回報）、幫你的程式碼做 code review（審查），因為他跟 GitHub.com 是同一家公司出品，帳號也直接沿用你原本的 GitHub 帳號。

0.2 名字用過兩次：先分清楚「這個 Copilot CLI」是誰

在往下看之前，有一個「認錯對象」的陷阱一定要先提醒你：GitHub 把「在終端機用 Copilot」這件事，前後推出過兩個完全不同的東西，而且兩個都可以被稱作某種形式的「Copilot CLI」。等一下你自己上網查資料、或問長輩朋友「怎麼用」時，很可能會撈到舊的那一個，裝完發現功能少得可憐，其實不是你裝錯，是你查到舊貨了。

舊的：gh copilot（gh CLI 的擴充功能）

這是掛在 GitHub 官方 CLI 工具（gh 指令）底下的一個小擴充套件，功能非常有限：只能「建議一條 shell 指令該怎麼下」（gh copilot suggest）或「解釋一條指令在幹嘛」（gh copilot explain）。它不會自己讀檔、改檔、跑指令，也不記得你們之前聊過什麼——比較像一本「指令小抄查詢機」，不是會動手做事的代理人（agent）。

2025 年 9 月 25 日，GitHub 官方 Blog 發了一則棄用公告，原文明講（Upcoming deprecation of gh-copilot CLI extension，官方原文）：

"...deprecated and stop functioning on October 25, 2025."
（……已棄用，並將於 2025 年 10 月 25 日起停止運作。）

也就是說，如果你手邊還留著「先裝 gh CLI，再裝 gh copilot 擴充」這種教學，它現在已經打不開了。舊版的官方文件頁面目前仍掛在網路上（標題是「Using the GitHub CLI Copilot extension」），Google 搜尋還是找得到，但那是歷史文件，不是本教學要教的東西。

新的：獨立套件 @github/copilot（本教學的主角）

跟舊版同一天（2025-09-25），GitHub 宣布了一個全新的獨立產品：npm 套件 @github/copilot，指令是單獨的 copilot（前面沒有 gh），也不需要先裝 gh CLI。這才是把「Copilot coding agent」的完整能力搬進終端機的那個新東西——會自己讀寫檔案、跑指令、規劃並執行多步驟任務。

2025-09-25 公開預覽（Public Preview），2026-02-25 正式 GA（General Availability，全面開放使用），面向所有 Copilot 訂閱戶。官方 GA 公告原文（GitHub Copilot CLI is now generally available，官方原文）：

"GitHub Copilot CLI ... is now generally available for all Copilot subscribers. Since launching in public preview in September 2025, hundreds of improvements ... grew from a terminal assistant into a full agentic development environment—one that plans, builds, reviews, and remembers across sessions."
（GitHub Copilot CLI……現已對所有 Copilot 訂閱戶正式開放。自 2025 年 9 月公開預覽以來，經過數百項改進……從一個終端機小幫手，成長為一套完整的代理式開發環境——能規劃、建構、審查，並跨 session 記住脈絡。）

給你的判斷法（跟 codex 單元教的認錯陷阱同一招）：

# 看到指令長這樣 → 舊貨，2025-10-25 後已經打不開了
gh copilot suggest "列出目前資料夾內的檔案"
gh copilot explain "docker ps -a"

# 看到指令長這樣（單獨的 copilot，前面沒有 gh）→ 新版，本教學教的就是這個
copilot

料源：官方 changelog 逐字確認（見上方引用），指令語法整理自 Upcoming deprecation of gh-copilot CLI extension。

除了看指令開頭是不是 gh，還有兩個輔助判斷法：

• 看文章/影片發布時間：2025 年 9 月 25 日之前提到「Copilot CLI」的內容，十之八九在講舊版擴充功能。
• 看有沒有提到「trust this folder（信任這個資料夾）」「agentic（代理式）」「MCP」這幾個詞：舊版完全沒有這些概念，出現這幾個詞就是在講新版。

0.3 新版能幹嘛：把 Copilot coding agent 完整搬進終端機

搞清楚「這是新版」之後，來看看它實際上能幫你做什麼。官方總覽頁把它定位為（About GitHub Copilot CLI，官方頁面內容轉述，非逐字引用）：讓你直接在終端機裡用 Copilot 回答問題、寫程式、除錯，並且跟 GitHub.com 互動。它有兩種運作方式：一種是像聊天一樣一來一往的互動模式，一種是用 -p / -s 這類旗標、不用你在旁邊盯著、直接印出結果的程式化模式（給腳本、自動化流程用）；面對比較複雜的任務，它還有一個「plan mode（規劃模式）」，會先幫你把任務拆解成計畫再動手。

它的核心能力大致分四塊（GitHub Copilot CLI 總覽，官方文件內容整理）：

• 讀寫程式碼、除錯：跟其他終端機 AI 代理一樣，能讀你的專案、改檔案、抓 bug。
• GitHub 原生整合：瀏覽 issue、PR（Pull Request）、gist，管理 PR、做 code review，全部用自然語言下指令，而且沿用你現有的 GitHub 帳號授權——不用另外裝 MCP 外掛就有這個能力，這是它跟其他三套終端機工具很不一樣的地方（詳細對照留給 0.6 節）。
• 自動化：用 /delegate 把任務委派給雲端背景執行、autopilot 模式讓它不用每步都等你點頭、還能排程 prompt 自動執行。
• 安全機制：可以設定哪些工具要問過你才能用（tool approval）、哪些資料夾算「信任目錄（trusted directories）」、限制能碰的路徑與網址，以及設定 AI 額度（AI credits）用量上限。

另外它也能跟 VS Code 整合、共享脈絡與信任設定，還能透過 GitHub.com 或 GitHub Mobile 遠端監控執行中的任務（/remote），也支援接進 GitHub Actions 工作流程。

0.4 跟 VS Code 裡的 Copilot 是什麼關係？

你可能本來就在用 VS Code 裡那個「Copilot」——編輯器右側聊天面板、打字時自動跳出的程式碼建議。這個 CLI 版，跟你熟悉的那個編輯器擴充功能是同一個東西嗎？

答案是：同一個 Copilot 品牌，但是兩個不同的產品形態。 官方沒有出一張正式的「VS Code Copilot vs CLI」對照表，但官方頁面明確講到兩者可以互相搭配：可以在 VS Code 內建終端機裡直接用 Copilot CLI，脈絡（context）與信任設定可以共用，你也可以在終端機規劃完任務後，回到 VS Code 的 Chat 面板繼續編輯。

以下這段定位描述是本教學依官方頁面內容做的合理歸納（非官方逐字對照，語氣保守）：VS Code Copilot 擴充功能主戰場在編輯器介面——自動完成、側欄聊天；Copilot CLI 是一個獨立的終端機程式，主戰場是純文字命令列，跟 Claude Code、Codex CLI、Gemini CLI 這些工具同一類。兩者可以搭配著用，但不是同一個東西、也不是誰取代誰的關係。

0.5 最大賣點：一支工具，能切換多家模型

如果只能記住 GitHub Copilot CLI 一個「結構性」的差異，記這個：它是本站四款終端機工具裡，唯一一個能自由切換多家 AI 供應商模型的。

官方 changelog 明講（Enhanced model selection changelog，2025-10-03，官方原文）：

"Copilot CLI supports models from multiple foundation model providers, such as Anthropic, Google, and OpenAI."
（Copilot CLI 支援來自多家基礎模型供應商的模型，例如 Anthropic、Google、OpenAI。）

"GitHub Copilot CLI defaults to Claude Sonnet 4.5, but you can actually switch to other models on the fly."
（GitHub Copilot CLI 預設使用 Claude Sonnet 4.5，但你可以隨時切換到其他模型。）

也就是說：它預設用的模型就是 Anthropic 的 Claude Sonnet 4.5，但你可以用互動指令 /model 或啟動旗標 --model=MODEL（也可以設定 COPILOT_MODEL 環境變數）切成別家模型，或者乾脆設成 auto 讓系統自動幫你選當下最合適的模型。進階玩家甚至能用 BYOK（bring your own key，自帶金鑰）接自己的 OpenAI 相容端點、Azure OpenAI 或 Anthropic 帳號（Using your own LLM models in GitHub Copilot CLI，官方文件）。

把這件事放進本站已經教過的三套工具裡對照，你會看出它多特別：

Claude Code、Codex CLI、Gemini CLI 都是「一個工具綁一家供應商」，你想換腦袋就得換整套工具。GitHub Copilot CLI 反過來——工具是同一個，換的是腦袋：今天用 Claude Sonnet 寫程式，明天想試試 GPT 系列的模型怎麼回答同一個問題，打一個 /model 指令切過去就好，不用重新學一套新工具。

0.6 四款終端機 agent，先看一張總覽地圖

讀到這裡，你可能已經在腦中把 GitHub Copilot CLI 跟本站其他三套工具做比較了。這裡先給一張總覽表，讓你有個大致的定位感——但要先老實說在前面：

四款工具的共同點：都是「住進終端機、能自己讀改檔案、跑指令」的 agentic CLI 工具，都用自然語言交辦任務。差異主要落在三個面向：綁定哪家模型（上表已經講清楚）、跟自家生態系整合的深淺（GitHub Copilot CLI 原生綁 GitHub issue/PR/code review 是它的主場優勢）、以及記憶檔與設定機制的細節（這部分留給後面「個人化設定」章節，屆時你會看到 GitHub Copilot CLI 甚至會直接讀取 CLAUDE.md、GEMINI.md 這些其他工具的守則檔，是個很有意思的細節）。

0.7 本篇範圍與「以實機為準」的時效鐵則

最後，把接下來幾章的地圖攤給你看：

一條貫穿全書的鐵則：逐字細節，以你實機為準。 GitHub Copilot CLI 改版速度非常快——查證這份教學的當下，GitHub 的原始碼庫在短短兩天內就連發了好幾個版號（1.0.70 → 1.0.71 → 1.0.72-0 → 1.0.72-1）。這代表指令、旗標、模型名稱、預設值都可能隨時調整。所以本書每次提到逐字的指令或版本細節時，都會請你以自己終端機跑出來的 copilot --help 結果、或官方文件頁面為準——不要把任何教學（包括本書）裡的逐字內容當成永遠不變的真理。

0.8 具體會省下什麼：同一個小改動，兩種做法並排看

前面幾節都在講「它是什麼」，這一節換個角度：不談規格名詞，直接看一個具體例子，感受一下「為什麼要為此改變工作習慣」。

假設你要幫一個網站做一個很小的改動——「聯絡我們」表單的送出按鈕，要一次做三件事：按鈕文字從「送出」改成「送出訊息」、按鈕顏色從舊的藍色換成新配色、送出後彈出的提示訊息裡也提到「送出」兩個字，要一起改才不會前後不一致。這三件事分別藏在三個不同的檔案裡：畫面上的按鈕標記（HTML）、顏色定義（CSS）、彈出訊息的文字（JS）——一個看起來很小的改動，其實牽涉三個檔案。

省下來的不是「打字的力氣」，是「記得要去哪幾個檔案」跟「來回切換、測試、發現漏改、再回頭補」這一整串動作——牽涉的檔案越多、專案越大，靠人腦一次記住所有關聯的成本就越高。這也是所有常駐終端機 agent 工具（不只 GitHub Copilot CLI）想解決的同一個問題：把「規劃＋記住所有關聯」這件事交給讀得完整個專案的工具，你只負責在關鍵步驟點頭或喊停。

本章小結

一句話收束：GitHub Copilot CLI 是 GitHub 官方在 2025 年 9 月推出的獨立終端機 AI 代理，跟舊版只能「建議一條指令」的 gh copilot 擴充功能（已於 2025-10-25 停止運作）完全是兩回事；新版能自己讀寫檔案、跑指令，原生整合 GitHub issue／PR／code review，而且是本站四款終端機工具裡唯一能自由切換多家模型供應商的一個（預設 Claude Sonnet 4.5）。 它跟 VS Code 裡的 Copilot 擴充功能可以搭配使用，但不是同一個產品。所有逐字細節，都以你實機跑出來的結果與官方文件為準。

動手試試（不用安裝，純認識）

1. 打開瀏覽器，找一篇提到「Copilot CLI」的網路文章或影片，練習用 0.2 節教的判斷法猜猜看：它講的是 gh copilot（舊）還是獨立的 copilot（新）？線索是指令開頭有沒有 gh、發布時間在不在 2025-09-25 之前。
2. 逛一下官方公開預覽公告 GitHub Copilot CLI is now in public preview，找找看 0.1 節引用的那兩句原文，感受一下官方怎麼描述「完全掌控」這件事。
3. 在 0.5 節的表格裡，用一句話跟自己複誦：GitHub Copilot CLI 跟其他三款工具最大的結構性差異是什麼？（提示：換的是腦袋，不是工具。）
4. 記住一個本書會反覆出現的口訣：「逐字細節，實機 copilot --help / /model 為準。」 下一章我們就要真的打開終端機了。