建立 2026-09-15 更新 2026-09-15

安裝與登入

先裝 gh，再登入一次。登入成功後，多數指令不必再管 token；Git 走 HTTPS 時，也可以請 gh 代管憑證，之後 git push 就不必反覆貼密碼。

安裝

各系統的官方套件名稱都是 GitHub CLI。任選一種即可。

macOS（Homebrew）：

brew install gh

Windows（WinGet）：

winget install --id GitHub.cli

Debian / Ubuntu：

依 cli/cli 安裝說明 加入官方 apt 來源後安裝 gh，不要用過舊的發行版套件。

裝完確認版本：

gh --version

看得到版本號就表示指令已在 PATH 裡。完整安裝選項見 cli/cli。

登入 GitHub

gh auth login

互動式問題依序是：

1. GitHub.com 還是 Enterprise？ 一般選 GitHub.com。
2. HTTPS 還是 SSH？ 剛開始選 HTTPS 最省事；已有 SSH 金鑰再選 SSH。
3. 要不要用 GitHub 憑證驗證 Git？ 選 Yes，之後 git push 可沿用這次登入。
4. 瀏覽器登入還是貼 token？ 選瀏覽器。終端機會給一組一次性代碼，瀏覽器開啟後貼上並授權 GitHub CLI。

檢查狀態：

gh auth status

應看到登入的帳號、協定，以及 token 具備的權限範圍（scopes）。若之後要操作 workflow 檔，有時需補 workflow 範圍：

gh auth refresh -s workflow

卡住時怎麼查

gh
gh pr --help
gh pr create --help

只打 gh 會列出頂層指令。每個子指令都有 --help，內容與線上手冊同步。

下一步：常用指令。