copilot-cli-for-beginners

歡迎！在本章中，你將安裝 GitHub Copilot CLI（命令列介面），使用你的 GitHub 帳號登入，並驗證一切運作正常。這是一個快速設定章節。當你準備就緒後，真正的示範將在第 01 章開始！

🎯 學習目標

完成本章後，你將能夠：

• 安裝 GitHub Copilot CLI
• 使用你的 GitHub 帳號登入
• 透過簡單測試驗證其運作

⏱️ 預估時間：大約 10 分鐘（5 分鐘閱讀 + 5 分鐘實作）

---

✅ 先決條件

• 具有 Copilot 存取權的 GitHub 帳號。查看訂閱方案。學生／教師可透過 GitHub Education 免費取得 Copilot Pro。
• 終端機基礎操作：熟悉如 cd 和 ls 等指令

什麼是「Copilot 存取權」

GitHub Copilot CLI 需要有效的 Copilot 訂閱。你可以在 github.com/settings/copilot 檢查你的狀態。你應該會看到下列其中一項：

• Copilot Individual - 個人訂閱
• Copilot Business - 透過你的組織
• Copilot Enterprise - 透過你的企業
• GitHub Education - 經驗證的學生／教師免費

如果你看到「You don’t have access to GitHub Copilot」，你需要使用免費方案、訂閱付費方案，或加入有提供存取權的組織。

---

安裝

⏱️ 時間預估：安裝約需 2-5 分鐘。驗證身分再多 1-2 分鐘。

GitHub Codespaces（零設定）

如果你不想安裝任何先決條件，可以使用 GitHub Codespaces，它已經預先安裝好 GitHub Copilot CLI（你只需登入），並且預先安裝了 Python 和 pytest。

1. Fork 本儲存庫 到你的 GitHub 帳號
2. 選擇 Code > Codespaces > Create codespace on main
3. 等待幾分鐘讓容器建置完成
4. 一切就緒！終端機會自動在 Codespace 環境中開啟。

💡 在 Codespace 驗證：執行 cd samples/book-app-project && python book_app.py help 以確認 Python 與範例應用程式運作正常。

本機安裝

如果你想在本機執行 Copilot CLI 並搭配課程範例，請依照下列步驟操作。

1. 將課程範例儲存庫複製到你的電腦：

    git clone https://github.com/github/copilot-cli-for-beginners
    cd copilot-cli-for-beginners
   

2. 使用下列其中一種方式安裝 Copilot CLI。

   💡 不確定該選哪一種？ 如果你已安裝 Node.js，建議使用 npm。否則請選擇符合你系統的方式。

   ### 所有平台（npm）

    # 如果你已安裝 Node.js，這是快速取得 CLI 的方式
    npm install -g @github/copilot
   

   ### macOS/Linux（Homebrew）

    brew install copilot-cli
   

   ### Windows（WinGet）

    winget install GitHub.Copilot
   

   ### macOS/Linux（安裝腳本）

    curl -fsSL https://gh.io/copilot-install | bash
   

選用：啟用 shell 補全功能

Shell 補全功能讓你可以按下 **Tab** 鍵來自動補全 `copilot` 子指令、指令選項及部分選項值。這是選用功能，但當你熟悉 CLI 後會很方便。 Copilot CLI 目前支援 Bash、Zsh 與 Fish 的補全腳本： ```shell # Bash，僅限目前 session source <(copilot completion bash) # Bash，在 Linux 上持久啟用 copilot completion bash | sudo tee /etc/bash_completion.d/copilot # Zsh copilot completion zsh > "${fpath[1]}/_copilot" # Fish copilot completion fish > ~/.config/fish/completions/copilot.fish ``` 新增持久補全後請重新啟動你的 shell。PowerShell 支援在 Windows 上執行 Copilot CLI，但 `copilot completion` 目前僅支援 Bash、Zsh 與 Fish。

---

驗證身分

在 copilot-cli-for-beginners 儲存庫的根目錄開啟終端機，啟動 CLI 並允許存取該資料夾。

copilot

你會被要求信任包含此儲存庫的資料夾（如果尚未信任）。你可以選擇僅此次信任，或所有未來會話皆信任。

信任資料夾後，你可以使用 GitHub 帳號登入。

> /login

接下來會發生什麼：

1. Copilot CLI 會顯示一次性代碼（如 ABCD-1234）
2. 你的瀏覽器會開啟 GitHub 的裝置授權頁面。如果尚未登入 GitHub，請先登入。
3. 按指示輸入代碼
4. 選擇「Authorize」授權 GitHub Copilot CLI 存取權
5. 回到終端機——你已成功登入！

裝置授權流程：你的終端機產生代碼，你在瀏覽器驗證，Copilot CLI 完成驗證。

提示：登入狀態會在多個會話間保留。除非你的 token 過期或你主動登出，否則只需登入一次。

---

驗證運作正常

步驟 1：測試 Copilot CLI

現在你已登入，讓我們確認 Copilot CLI 能正常運作。在終端機啟動 CLI（如果尚未啟動）：

> Say hello and tell me what you can help with

收到回應後，你可以離開 CLI：

> /exit

---

🎬 觀看實際操作！

 *示範輸出內容會有所不同。你的模型、工具與回應可能與這裡顯示的不同。*

---

預期輸出：一個友善的回應，列出 Copilot CLI 的功能。

步驟 2：執行範例書籍應用程式

本課程提供一個範例應用程式，你將在課程中使用 CLI 探索並改進它（你可以在 /samples/book-app-project 看到程式碼）。在開始前，請確認 Python 書籍收藏終端機應用程式 能正常運作。根據你的系統執行 python 或 python3。

注意： 課程中的主要範例皆使用 Python（samples/book-app-project），因此如果你選擇本機安裝，請確保你的電腦已安裝 Python 3.10+。如果你偏好，也可選擇 JavaScript（samples/book-app-project-js）或 C#（samples/book-app-project-cs）版本。每個範例資料夾都有 README 說明如何執行該語言的應用程式。

cd samples/book-app-project
python book_app.py list

預期輸出：包含 “The Hobbit”、”1984” 和 “Dune” 在內的 5 本書清單。

步驟 3：搭配書籍應用程式試用 Copilot CLI

（如果你執行過步驟 2，請先回到儲存庫根目錄）

cd ../..   # 如有需要，回到儲存庫根目錄
copilot 
> What does @samples/book-app-project/book_app.py do?

預期輸出：書籍應用程式主要功能與指令的摘要。

如果你看到錯誤訊息，請參考下方的疑難排解區段。

完成後你可以離開 Copilot CLI：

> /exit

---

✅ 你已準備就緒！

安裝流程到此結束。真正的樂趣將在第 01 章展開，你將會：

• 觀看 AI 審查書籍應用程式並即時找出程式碼品質問題
• 學會三種不同方式使用 Copilot CLI
• 直接用英文產生可運作的程式碼

繼續閱讀第 01 章：第一步 →

---

疑難排解

“copilot: command not found”

CLI 尚未安裝。請嘗試其他安裝方式：

# 如果 brew 失敗，請嘗試 npm：
npm install -g @github/copilot

# 或使用安裝腳本：
curl -fsSL https://gh.io/copilot-install | bash

“You don’t have access to GitHub Copilot”

1. 請在 github.com/settings/copilot 確認你有 Copilot 訂閱
2. 如果使用工作帳號，請確認你的組織允許 CLI 存取

“Authentication failed”

請重新驗證身分：

copilot
> /login

瀏覽器未自動開啟

請手動前往 github.com/login/device 並輸入終端機顯示的代碼。

Token 過期

只需再次執行 /login：

copilot
> /login

仍然卡住？

• 請參考 GitHub Copilot CLI 官方文件
• 搜尋 GitHub Issues

---

🔑 重點整理

1. GitHub Codespace 是快速入門的好選擇－Python、pytest 與 GitHub Copilot CLI 都已預先安裝，讓你能立即開始示範
2. 多種安裝方式－可依你的系統選擇（Homebrew、WinGet、npm 或安裝腳本）
3. 一次性驗證身分－登入狀態會持續到 token 過期
4. 書籍應用程式可正常運作－你將在整個課程中使用 samples/book-app-project

📚 官方文件：安裝 Copilot CLI 以取得安裝選項與需求。

📋 快速參考：完整指令與快捷鍵請見 GitHub Copilot CLI 指令參考。

---

繼續閱讀第 01 章：第一步 →

This site is open source. Improve this page.