Hub GitHub Copilot CLI 完整教學

第 1 篇 入門 · 第 1 章

踏出第一步：打開終端機

終端機是一個用「打字」跟電腦對話的小視窗，而 GitHub Copilot CLI 就住在這個視窗裡。

想像一下：平常你用滑鼠點來點去操作電腦，就像跟店員比手畫腳點餐。終端機則是另一個櫃台——你直接「打字」告訴電腦要做什麼，它照做。GitHub Copilot CLI 這位 AI 工程師，工作的地方就在這個打字櫃台。所以在正式認識它之前，我們得先學會怎麼打開這個視窗、怎麼在裡面走動。

別怕！這一章不寫任何程式，只是帶你熟悉「環境」。就像搬進新家前先認門牌、認房間。你會學到三件事：

  • 終端機是什麼，以及在你的電腦上怎麼打開它；
  • 三個最基本的走動指令（cd / ls / pwd），還有「工作目錄」這個關鍵概念；
  • 為什麼在叫 Copilot CLI 動手之前，最好先用 Git 存個檔。

這章的定位

GitHub Copilot CLI 怎麼安裝、怎麼登入，是下一章（第 2 章）和第 3 章的事。這一章只負責把「家門」打開，讓你之後跟得上。

1.1 終端機是什麼、三平台怎麼打開

終端機（Terminal）有很多別名：命令列（Command Line）、終端、console、shell 視窗……指的都是同一個東西：一個你打指令、電腦回你結果的純文字視窗。

它長得樸素，通常黑底白字，沒有按鈕、沒有圖示。第一次看到會有點陌生，但這正是 GitHub Copilot CLI 運作的舞台——它是一支「住在終端機裡」的獨立指令 copilot，不打開終端機，就見不到它。

為什麼工程師愛用終端機？

因為打字下指令比點滑鼠快、可以精準重複、還能寫成腳本自動化。你現在不用懂這些好處，先學會打開它就好。

每個作業系統打開終端機的方式不太一樣，下面分平台帶你做。

🍎 macOS：打開「終端機」App

Mac 內建一個叫「終端機」（Terminal）的程式，不用另外安裝。

  1. 按鍵盤的 Command + 空白鍵，打開 Spotlight 搜尋。
  2. 輸入「終端機」或「Terminal」。
  3. 按 Enter，終端機視窗就跳出來了。

你也可以從「應用程式 → 工具程式 → 終端機」找到它。

進階選擇 iTerm2

很多 Mac 開發者改用免費的 iTerm2 取代內建終端機，功能更多、更好用。新手用內建的「終端機」就完全夠了，等熟了再換不遲。

🐧 Linux：各家發行版略有不同

Linux 幾乎一定內建終端機，只是不同發行版（Ubuntu、Fedora、Debian……）入口名稱略有差異。最通用的兩招：

  • 快捷鍵：大多數桌面環境按 Ctrl + Alt + T 就能直接開啟終端機。
  • 從選單找：在應用程式選單搜尋「Terminal」「終端」或「Console」。

🪟 Windows：Windows Terminal → PowerShell 7

Windows 的情況稍微多一層，因為它有好幾種命令列環境。對 GitHub Copilot CLI 來說，最單純的路是這樣：

  1. 按開始鍵，輸入「Windows Terminal」（Windows 10/11 通常已經內建，或可從 Microsoft Store 免費安裝），點開啟。
  2. Windows Terminal 是一個「殼」。在分頁下拉選單選 PowerShell 7；這就是本書所有 Windows 指令唯一要用的地方。

PowerShell 其實有兩支，先分清楚

「PowerShell」這個名字背後藏著兩支不同的程式：電腦內建、比較舊的 Windows PowerShell 5.1（執行檔 powershell.exe），和另外獨立推出、可跨平台的 PowerShell 7（執行檔 pwsh.exe）。開始選單搜尋「PowerShell」，你可能會同時看到兩個很像的圖示，這是正常的。想確認自己打開的是哪一支，在視窗裡打一行：

$PSVersionTable.PSVersion

Major 那一欄顯示 7 就是新版；顯示 5 就是系統內建的舊版。這件事在這一章只是先認識，但到了下一章實際安裝 GitHub Copilot CLI，本書要求 PowerShell 7：GitHub 官方最低門檻是 PowerShell v6 以上，也就是要用 pwsh.exe 那一支，光有系統內建的舊版是不夠的。若目前沒有 7，先停在這裡，下一章處理，不要改去 CMD 或 WSL。

WSL 不需要，也不要混用

GitHub Copilot CLI 有 Windows 原生安裝路徑，本書的新手主線固定是 Windows Terminal → PowerShell 7 → WinGet，不需要安裝 WSL。只有公司或既有專案已明確要求 WSL 時，才完整使用那套 Linux 環境；不要把 WSL 的路徑、Node 安裝或設定檔，和這條 PowerShell 路線混在一起。細節第 2 章會把 Windows 唯一選路列清楚。

1.2 基本指令熱身（cd / ls / pwd）與「工作目錄」

終端機打開了，你會看到一個閃爍的游標，在等你打字。我們先學三個最基本、也最安全的指令來熱身——它們只是「看」和「走動」，不會改壞任何東西。

這三個指令在 🍎 macOS、🐧 Linux 上完全一樣；🪟 Windows Terminal 的 PowerShell 7 分頁也都認得（PowerShell 貼心地把這些常用名字都做了對應），所以你照著打就行。

pwd：我現在站在哪個資料夾？

pwd 是 print working directory 的縮寫，意思是「印出我目前所在的資料夾」。

pwd

✅ 預期會看到類似這樣的一行路徑（代表你目前站在哪）：

/Users/你的名字

「絕對路徑」與「相對路徑」

pwd 印出來這種從最頂層寫到底的完整路徑，叫絕對路徑——不管你現在人站在哪裡，這條路徑永遠指向同一個地方（🍎 macOS／🐧 Linux 一定以 / 開頭；🪟 Windows 則是磁碟機代號，例如 C:\Users\你的名字）。等一下你會看到 cd Desktop 這種只寫「相對於目前位置」的寫法，叫相對路徑——同一句 cd Desktop，站在不同資料夾打，會走進完全不同的地方。之後不管是跟 Copilot CLI 說話、還是在設定檔裡填路徑，分不清這兩者常常是踩雷的起點，現在有個印象就好。

ls：這個資料夾裡有什麼？

ls（list）會把目前資料夾裡的檔案和子資料夾列出來。

ls

✅ 預期會看到一排檔名和資料夾名，例如：

Desktop    Documents    Downloads    Pictures

PowerShell 小提醒

在 Windows Terminal 的 PowerShell 7 分頁裡，ls 和 pwd 都可以用（它幫你對應到內建指令）。

剛剛看到的都是「一般」檔案和資料夾。但還有一種以小數點 . 開頭的資料夾——最典型的例子，就是等一下 1.3 節會提到的 .git（藏著 Git 每一次「存檔」歷史的地方），將來裝好 GitHub Copilot CLI 後，你的電腦也會多出一個類似的隱藏資料夾 ~/.copilot/ 放設定資料——ls 預設不會顯示這些，目的是讓平常的清單不要太雜亂。想連這些隱藏項目也一起看到，多打兩個字母：

ls -la

-la 其實是兩個旗標疊在一起

-a（all）代表連隱藏項目都列出來；-l（long）代表用「長格式」顯示，每一項多印出權限、擁有者、大小、修改時間。兩個疊著寫成 -la 或 -al 效果一樣。之後安裝好 GitHub Copilot CLI，想確認 ~/.copilot/ 這個設定資料夾在不在，ls -la 就是你的第一個偵查動作。

cd：走進另一個資料夾

cd（change directory，切換目錄）讓你「走進」某個資料夾。例如走進桌面：

cd Desktop

打完後再 pwd 一次，就會看到你的位置變了。想回到家目錄（你的個人主資料夾），不管在哪，打：

cd ~

~（波浪號）是「我的家目錄」的簡寫。

超實用小技巧

不想手打一長串資料夾路徑？在終端機輸入 cd （記得後面留一個空格），然後把資料夾直接用滑鼠拖進終端機視窗，路徑就會自動補上，按 Enter 即可。迷路了就 cd ~ 回家，永遠不會卡死。

資料夾名稱不用整個打完，按 Tab 讓它幫你補

打 cd Doc 之後按一下鍵盤的 Tab 鍵，終端機會自動幫你補完成 cd Documents（符合的候選不只一個時，多按幾次 Tab 會依序列出或循環）。🍎 macOS、🐧 Linux、🪟 PowerShell 都吃這招，是最省時間的打字習慣之一，之後路徑越打越長，會越有感。

「工作目錄」：你帶 Copilot CLI 進的那個房間

把上面三個指令串起來，你會發現一件事：終端機永遠「站」在某一個資料夾裡，這個你當下所在的資料夾，就叫工作目錄（working directory，也叫當前目錄）。pwd 印的就是它，ls 列的就是它裡面的東西，cd 就是換到另一個工作目錄。

這個概念對 GitHub Copilot CLI 超級重要，因為：

關鍵心法

GitHub Copilot CLI 啟動後，就在你當下的「工作目錄」裡讀檔、改檔、執行程式。你可以把工作目錄想成「你帶這位 AI 工程師走進的那個房間」——它只會動這個房間裡的東西。所以開工前，先用 cd 走進你要它處理的專案資料夾，是基本動作。

實際操作起來，通常是這樣的順序（這裡先看流程，指令細節第 4 章會詳細教）：

cd ~/projects/我的網站     # 1. 先走進專案資料夾（這就是工作目錄）
copilot                    # 2. 在這裡啟動 GitHub Copilot CLI，它就在這個房間工作

先預告——Copilot CLI 第一次進某個資料夾，會先問你「信任嗎？」

因為 GitHub Copilot CLI 會在工作目錄裡讀檔、甚至改檔跑指令，第一次在一個新資料夾啟動時，官方介面會先跳出「信任這個資料夾嗎？」的確認畫面才讓它繼續動作。這其實就是「工作目錄」這個概念在保護你：Copilot CLI 只承諾動你當下站的這個房間，但進房間前，還是會先敲門問一聲。這個確認畫面長什麼樣、三個選項分別代表什麼，是第 3 章「第一次啟動與登入」的主題，這裡你只要知道：1.1～1.2 節學的「先想清楚自己站在哪個資料夾」，到了實際用 Copilot CLI 時會直接變成一個保護你的安全機制。

官方參考：About GitHub Copilot CLI、GitHub Copilot CLI 總覽、Getting started with GitHub Copilot CLI

1.3 為什麼開工前先 git commit 存檔

學會了走進房間，我們講最後一件、也是最重要的習慣：在叫 GitHub Copilot CLI 動手之前，先用 Git 存一個檔。

先講為什麼：Copilot CLI 會「直接改你的檔案」

這點一定要先記住：GitHub Copilot CLI 不是只給你建議，官方定位就是把「讀寫程式碼、除錯」的能力放進終端機，它會在你的工作目錄裡真的去新增、修改、執行程式碼。這正是它強大的地方——它是會自己動手的 AI 工程師，不是只會出一張嘴的顧問。

但「會自己動手」也代表：萬一它改錯了、或你不滿意它的改法，你需要一個「回到改動前」的後路。這個後路，就是 Git。

把 Git 想成電玩存檔

Git 是工程師用的「版本控制」工具，最白話的比喻就是電玩的存檔點。你存了檔，之後不管打怪打到多慘，都能讀檔回到存檔那一刻。git commit 就是「存檔」這個動作。

Copilot CLI 自己也有「反悔」指令，但那是另一層保險

之後你會發現，GitHub Copilot CLI 本身也內建 /undo 與 /rewind 這類回滾指令，可以撤銷它剛剛做的事（這是第 6 章的主題）。但那是它自己家的機制，跟你自己養成的 git commit 習慣是兩層不同的保險——工具內建的回滾綁在那次 session 裡，git 存檔則是你自己留在硬碟上、永遠拿得回來的底牌。兩者不衝突，一起用更保險。

怎麼做：開工前先存一個乾淨的檔

在你要交給 GitHub Copilot CLI 的專案資料夾裡（也就是你的工作目錄），動工前先跑這兩行——🍎 macOS、🐧 Linux、🪟 Windows 都一樣：

git add -A
git commit -m "checkpoint before copilot"
  • 第一行 git add -A：把目前所有的檔案變動「打包準備存檔」。
  • 第二行 git commit -m "..."：正式存檔，引號裡是你給這次存檔的備註（這裡寫「進 Copilot CLI 前的檢查點」）。

之後 Copilot CLI 不管怎麼改，你都能用 Git 比對它改了哪些地方，不滿意就還原回這個檢查點。

重要提醒

GitHub Copilot CLI 官方定位明確會直接改動你的程式碼，因此在啟動它之前先做一次 Git checkpoint / commit 是公認的安全作法。這不是可有可無的潔癖，是保護你心血的安全網。

想知道原理：真的要「還原」的時候，具體打哪些指令？

「用 Git 比對、還原」不是抽象的說法，實際上就是這幾個指令：

  • git status：看 Copilot CLI 動過哪些檔案（新增、修改、刪除，一眼列表）。
  • git diff：看每個被改的檔案裡，具體哪幾行變了、變成什麼樣子。
  • git restore .：把還沒 add 的改動全部丟掉，退回上一次存檔的樣子（比較溫和的還原，只清「尚未存檔」的部分）。
  • git reset --hard HEAD：更徹底的還原，連已經 add 過的改動一起丟掉，整個資料夾強制退回最近一次 commit。這個指令會真的丟掉東西、沒有回收桶，下手前務必先用 git status／git diff 確認自己真的不要那些改動。

新手現在不用背這些，先知道「這幾招存在、Git 真的能救你」就夠了。等哪天 Copilot CLI 真的改壞東西，回來翻這一段照著打即可。

還沒用 Git 怎麼辦？

如果你的專案還沒有 Git（跑 git add -A 時報錯說「not a git repository」），別擔心，那是因為這個資料夾還沒「開始版本控制」。你可以先在資料夾裡跑一次：

git init

這會幫這個資料夾建立 Git 版本控制，之後就能正常 git add / git commit 了。

沒裝 Git 的話

如果連 git 指令都找不到，代表你的電腦還沒裝 Git。Mac 通常內建；Windows 可到 Git for Windows 下載安裝；Linux 用各發行版的套件管理員安裝即可。Git 的完整用法不在本書範圍，但「開工前 commit 一下」這個習慣，會在後面的章節一再幫你救命。

裝好之後，養成先確認版本的習慣：

git --version

這裡老實留白

GitHub Copilot CLI 官方安裝文件目前沒有像某些同類工具一樣，明確寫出對 Git 版本的最低需求——本書研究階段沒查到這項數字，不替官方杜撰。你的電腦如果是近幾年安裝、有跟著系統更新過的 Git，通常不會有問題；真的是舊電腦、版本明顯偏舊，藉這個機會更新一下也好。

Git 的安全網不是萬能

Git 只能還原「被 Git 追蹤的檔案」。如果 Copilot CLI 改了 Git 範圍外的東西（例如系統設定、資料庫），Git 救不回來。所以越是放手讓 AI 動手，越要搭配後面章節會教的「核可與安全」觀念（第 6 章），雙重保險。

官方參考：About GitHub Copilot CLI、GitHub Copilot CLI 總覽、Git for Windows

本章小結

走到這裡，你已經把「家門」打開了：你會在自己的作業系統上打開終端機、會用 cd / ls / pwd 在資料夾間走動、懂了「工作目錄就是你帶 GitHub Copilot CLI 進的房間」，也養成了「開工前先 git commit 存檔」的安全習慣。這些都還沒碰到 Copilot CLI 本體，但每一項都是它跑起來的地基。終端機開好了，下一步就是把 GitHub Copilot CLI 真正裝進你的電腦——這是第 2 章的事。

動手試試

  1. 用你平台的方法打開終端機，依序打 pwd → ls → cd ~ → pwd，觀察位置怎麼變化。
  2. 練習「拖曳補路徑」：輸入 cd （留空格），把任一個資料夾拖進終端機視窗，按 Enter，再 pwd 確認你走進去了。
  3. 練習 Tab 補全：打 cd 加某個資料夾名稱的前兩三個字母，按 Tab 讓它幫你補完，感受一下跟手打完整名稱的差異。
  4. 在任一個資料夾打 ls -la，找找看有沒有 .git 這種以點開頭的隱藏資料夾。
  5. （🪟 Windows 使用者）打開 Windows Terminal，在 PowerShell 7 分頁裡跑一次 $PSVersionTable.PSVersion，確認 Major 是 7；若是 5，下一章先處理 PowerShell 7，不要改用 CMD 或 WSL。
  6. （有 Git 的話）挑一個練習用的資料夾，跑 git add -A 和 git commit -m "checkpoint before copilot"；接著隨便改一個檔案內容，再打 git status 和 git diff，看看 Git 怎麼「看見」你剛剛的改動——這就是之後檢查 Copilot CLI 改了什麼的方式。

本章官方文件參考