wbmeet

如何安裝並使用 GitHub Copilot CLI：安裝、登入與第一個倉庫任務

從官方安裝通道到 /login，再到倉庫裡第一個可審查的 diff。需要有效 Copilot 訂閱。

第一次用 GitHub Copilot CLI，卡住的通常不是提示詞，而是裝到哪個套件、怎麼登入，以及倉庫裡第一件能審查的事。依官方文件安裝 copilot，用 GitHub 帳號登入，再改一行你自己能回溯的程式。

檢索詞是 如何安裝並使用 GitHub Copilot CLI。下文依官方安裝頁與驗證頁：docs.github.com/en/copilot/how-tos/copilot-cli。這是獨立終端代理（指令是 copilot），不是已棄用的 gh copilot 擴充。要約短會對齊 diff，用 wbmeet 建房即可，步驟見 如何建立與加入房間。

安裝登入倉庫裡的第一件事

先核對能不能用

官方前提：有效的 GitHub Copilot 訂閱。Windows 需要 PowerShell v6 或更高。若 Copilot 來自組織或企業，管理員可在原則關閉 Copilot CLI。npm 安裝還需要 Node.js 22+。

22+
npm 路徑的 Node
PS 6
Windows 官方最低
1 次
/login 裝置碼

第一次：安裝、登入、改一行能審查的程式

  1. 1

    用官方通道安裝

    全平台 npm：npm install -g @github/copilot（需 Node 22+）。若 ~/.npmrc 寫了 ignore-scripts=true，改用 npm_config_ignore_scripts=false npm install -g @github/copilot。macOS/Linux 腳本：curl -fsSL https://gh.io/copilot-install | bash。Homebrew：brew install --cask copilot-cli。Windows WinGet：winget install GitHub.Copilot。

  2. 2

    核對指令再進倉庫

    新開終端，跑 copilot --version 或直接 copilot。command not found 時先查 PATH（腳本預設非 root 裝到 $HOME/.local/bin）。不要去跑舊的 gh copilot。

  3. 3

    用 /login 完成驗證

    cd 到你擁有的倉庫，執行 copilot。未登入時輸入 /login，走瀏覽器裝置碼。自動化可設細粒度 PAT（帳號權限的 Copilot Requests，資源擁有者必須是個人帳號），再匯出 COPILOT_GITHUB_TOKEN、GH_TOKEN 或 GITHUB_TOKEN。已登入的 gh 可作最低優先回退。/user 可核對帳號。

  4. 4

    做一個能審查的第一任務

    官方入門會建議 /init 產生面向本倉庫的說明。先問「這個專案做什麼、入口在哪」，再下一條：「給一個沒測試的輔助函式補單測，或給對外函式加輸入檢查。先出示 diff，等我同意再改。」不要把金鑰寫進提示。

# Official install · as of 2026-09
npm install -g @github/copilot
copilot --version
cd /path/to/your/project
copilot
# /login   then /init
# first task: add a unit test for one helper; show the diff first

安裝通道、驗證、常見坑

路徑官方怎麼寫第一次注意
npm @github/copilot全平台；Node 22+ignore-scripts 會擋安裝
install 腳本macOS/Linux新開終端再跑 copilot
Homebrew caskcopilot-cli不要裝成舊 gh 擴充
WinGetGitHub.CopilotPowerShell 6+
組織原則關閉 CLI管理員可停用先問管理員
01

裝完找不到 copilot

多半是 PATH。腳本非 root 預設 $HOME/.local/bin。新開終端。確認裝的是 @github/copilot。

02

登入循環或 403

先 /login。組織停用 CLI 時個人席位也過不去。PAT 必須掛在個人帳號並勾選 Copilot Requests。

03

第一任務停在閒聊

/init 只是熱身。要有一條可審查的改動並看 diff。

官方 Installing / Authenticating GitHub Copilot CLI：先裝獨立 CLI，再用 /login 或權杖。以 docs.github.com 為準。

獨立 CLI ≠ gh copilot 擴充
舊的 GitHub CLI 擴充已棄用。本頁只寫 copilot。
環境變數優先順序
COPILOT_GITHUB_TOKEN → GH_TOKEN → GITHUB_TOKEN → 鑰匙圈 OAuth → gh auth token。
教程頁不是會議說明書
只講 Copilot CLI 第一次。短會白板見 wbmeet 與 對照筆記。

還想核對的問題

沒有 Copilot 訂閱能用 CLI 嗎？

官方把有效 Copilot 訂閱列為前提。組織若關閉 Copilot CLI，即便個人有席位也不能用。

該用 npm、Homebrew 還是安裝腳本？

都能裝到同一條 copilot。已有 Node 22+ 用 npm。macOS/Linux 也可用安裝腳本或 Homebrew。Windows 用 WinGet，並確認 PowerShell 6+。

CI 裡怎麼登入？

不要走互動式 /login。用帶 Copilot Requests 的細粒度 PAT，匯出到 COPILOT_GITHUB_TOKEN。不要把權杖寫進倉庫。

第一個任務必須改正式環境程式嗎？

不必。先 /init 或問專案做什麼，再做一件可回溯的小事並先看 diff。

免費開始開會