Hub GitHub Copilot CLI 完整教學

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 suggestgh 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 的推薦主線是「先用 /planShift+Tab 切到規劃模式,確認方向後再放手讓它動手」。需要腳本化、CI 場景時,同一個 copilot 指令加上 -p-s 旗標就能跑完即退,不必另外記一個子指令。

情境 推薦指令 怎麼用
第一次登入/login走 OAuth device flow,瀏覽器貼一次性驗證碼登入 GitHub 帳號,是進場後第一件要做的事。
切換模型/model在 Claude、GPT、Gemini 等多家供應商模型之間切換,是 Copilot CLI 跟其他三套 CLI 最大的不同。
先規劃再動手/planShift+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+ 可以調整文字大小,調好之後翻到別章也會記得。