GitHub Copilot CLI 完整教學
這是一份寫給新手的教學。GitHub Copilot CLI 是 GitHub 官方在 2025 年 9 月推出的獨立新產品——一個住在你終端機裡、會自己讀檔、改檔、跑指令的 AI 工程師。
先說清楚一件容易搞混的事:它跟舊版「gh copilot」指令建議工具是兩回事。舊版只能建議或解釋單行指令,2025-09-25 官方公告棄用,2025-10-25 已經停止運作;本教學教的是全新獨立套件 @github/copilot,指令是 copilot,2026-02-25 已正式 GA(正式版)。如果你在網路上看到教 gh copilot suggest/gh copilot explain 的文章,那多半是舊貨,先跳過。
就算你從沒打過一行程式,也能從確認 GitHub 帳號與可用方案、打開終端機、安裝與登入開始。
從第 0 章開始 →第一次來,只要先走第 0~3 章。
你會認識新版工具、打開終端機、完成安裝與登入。MCP、CI/CD、多代理與雲端委派都是後續選讀,不是起步門檻;今天可以先忽略。
還不確定為什麼要從聊天網頁換到 CLI?
先讀跨工具的〈為什麼要用 AI CLI?〉:用 10 分鐘看懂適用情境、第一次安全任務,以及長開發怎麼靠 Plan、Git、驗證與交棒接起來,再回來選工具。
本教學依撰稿當時(2026 年 7 月)的 GitHub Copilot CLI 版本與官方文件整理。這款工具從 2025-09-25 公開預覽到 2026-02-25 正式 GA,版本演進非常快——光是查證當下(2026-07-16~07-17)兩天內,GitHub 官方 repo 就連續發布了好幾個版號。指令旗標、設定欄位、登入流程都可能隨版本調整,遇到跟畫面不符的地方,請以附錄 C 官方文件與版本驗證連結地圖列出的官方來源,或直接跑 copilot --help 為準。
這份教學會帶你學什麼?
GitHub Copilot CLI 不只是回你文字,而是能真的讀你的檔案、改你的程式、在你的終端機跑指令。這份教學從零開始,先帶你完成登入與第一次安全練習;熟悉後再學指示檔案、Git、安全設定、外部工具、自動化與團隊協作。
下面是完整章節地圖,分成六篇循序漸進。第一次先照第 0~3 章走完;有實際專案後,再回來挑目前需要的章節。
補充資訊
GitHub Copilot CLI 最大的結構性賣點:一個工具、多家模型可切換。預設模型是 Claude Sonnet 4.5,你也可以隨時用 /model 切到 GPT 或 Gemini 家族模型——這跟只吃自家模型的 Claude Code(只認 Anthropic)、Codex CLI(只認 OpenAI)、Gemini CLI(只認 Google)是最明顯的差異。加上它是 GitHub 自家產品,操作 issue、PR、gist 這些 GitHub 原生功能也特別順手,內建 GitHub MCP 伺服器免設定即可用。
常用指令與情境推薦
Copilot CLI 的推薦主線是「先用 /plan 或 Shift+Tab 切到規劃模式,確認方向後再放手讓它動手」。需要腳本化、CI 場景時,同一個 copilot 指令加上 -p/-s 旗標就能跑完即退,不必另外記一個子指令。
| 情境 | 推薦指令 | 怎麼用 |
|---|---|---|
| 第一次登入 | /login | 走 OAuth device flow,瀏覽器貼一次性驗證碼登入 GitHub 帳號,是進場後第一件要做的事。 |
| 切換模型 | /model | 在 Claude、GPT、Gemini 等多家供應商模型之間切換,是 Copilot CLI 跟其他三套 CLI 最大的不同。 |
| 先規劃再動手 | /plan 或 Shift+Tab | 讓它先問澄清問題、產出結構化計畫,你核可後才真的動手改檔案;官方明講「有具體計畫可循的模型成功率更高」。 |
| 接外部工具 | /mcp | 管理 MCP 伺服器連線(新增/列出/停用),內建的 GitHub MCP 伺服器不用額外設定即可用。 |
| 丟給雲端跑 | /delegate | 把可以非同步處理的旁支任務(文件更新、次要修改)丟給雲端 Copilot coding agent,開分支、開 draft PR,本機專心處理核心工作。 |
| 平行拆工 | /fleet | 幕後協調者把大任務拆成多個子任務,同時派多個 subagent 平行跑;2026 年新功能,仍在快速迭代中。 |
| 腳本化執行 | copilot -p "..." -s | -p 帶提示詞非互動跑完即退,-s 靜默模式少印裝飾字樣,適合管線串接與 CI。 |
# 互動模式:先用 /plan 規劃,核可後再讓它動手
copilot
# 進入互動 session 後輸入:
# /login 先登入 GitHub 帳號
# /model 切換模型(例如切到 GPT 或 Gemini 家族)
# /plan 幫我讀懂這個專案的架構,並列出可能的技術債
# 非互動模式:腳本化、CI 場景,跑完即退
copilot -p "總結這個 commit 做了什麼改動" -s --model claude-haiku-4.5
# 平行拆工(實驗性功能,仍在快速迭代)
copilot
# /fleet 幫我把這個大重構任務拆成幾個獨立子任務,平行跑
官方 /login、/model、/plan(含 Shift+Tab 切換)、/mcp、/delegate、-p/--prompt、-s 均來自 GitHub Copilot CLI 官方文件與 changelog;實驗性 /fleet 官方明確標記為新功能、仍在快速迭代中,官方也誠實警告「本質循序的任務用 fleet 未必划算、拆太細反而更貴」,斟酌採用。
小提醒
不用急著一次讀完。建議照順序,邊讀邊在自己終端機上跟著做一次,學起來最快。右上角的 A−/A+ 可以調整文字大小,調好之後翻到別章也會記得。