sitdraw

如何安裝並使用 GitHub CLI（gh）：登入、複製倉庫與從終端機開 PR

依官方步驟安裝 GitHub CLI，完成 gh auth login，並從終端機複製倉庫或建立 Pull Request。

要在終端機用 GitHub CLI（指令 gh）複製倉庫或開 Pull Request，先完成三件事：依官方方式安裝，跑 gh auth login，再執行 gh repo clone 或 gh pr create。

依官方安裝頁與手冊走，不要猜套件名。核心檢索詞是 如何安裝 GitHub CLI、gh auth login，以及 用 gh 開 PR。文件在 cli.github.com 與 cli.github.com/manual/。

gh官方指令名
auth先登入再調 API
PR終端機裡建立請求

先依系統裝官方二進位

macOS 與 Windows

macOS：brew install gh。Windows：winget install --id GitHub.cli，也可用 Scoop 或 Chocolatey。裝完跑 gh --version。

Linux

Debian / Ubuntu / Fedora 等請跟 cli.github.com 上的發行版套件庫，不要隨便拷貝第三方 deb。企業機若禁 Homebrew，用官方發布頁的套件。

步驟指令要注意
登入gh auth login選 github.com 或 Enterprise；HTTPS 或 SSH；瀏覽器或 token
檢查gh auth status確認帳號、協定、token 是否仍有效
複製gh repo clone owner/repo私有庫需要對應權限；SSO 組織要額外授權
開 PRgh pr create分支須已推遠端；可用 --fill 或手寫標題正文

安裝、登入、複製或開 PR

  1. 01
    安裝並確認版本

    依官方頁選套件管理員。裝完 gh --version 應印出版本號。若指令找不到，檢查 PATH，不要和舊的第三方 gh 指令碼混用。

  2. 02
    跑 gh auth login

    選 GitHub.com（或管理員給的 Enterprise 主機）。協定：日常 HTTPS 即可；已用 SSH 金鑰就選 SSH。有瀏覽器選 Login with a web browser，記下一次性碼，到 github.com/login/device 貼上。無圖形介面貼上 PAT。

  3. 03
    複製一個倉庫

    在目標目錄執行 gh repo clone owner/repo。成功後目錄裡應有 .git。唯讀失敗時看 gh auth status 與組織 SSO。

  4. 04
    從目前分支建立 PR

    改完程式、提交並推送後，在倉庫根目錄跑 gh pr create。依提示填 title/body，或 gh pr create --fill。在瀏覽器打開回傳的 URL 核對 diff。

gh --version
gh auth login
gh auth status
gh repo clone owner/repo
cd repo
# 提交並推送目前分支後：
gh pr create --title "Fix login timeout" --body "Repro and fix."
必須用瀏覽器登入嗎？
不必。官方導覽支援貼上 personal access token。CI 或無頭機器用 token 或 GH_TOKEN 環境變數，不要寫進倉庫。
HTTPS 和 SSH 怎麼選？
已有 GitHub SSH 金鑰並加到帳號，選 SSH，後續 git 操作走同一把金鑰。否則選 HTTPS，gh 會幫你設定憑證協助程式。
pr create 說找不到倉庫或拒絕？
確認目前目錄是 git 倉庫、遠端指向 GitHub、分支已 push，且帳號對該 repo 有寫入權限。SSO 組織要在授權頁啟用該 org。
裝完就能當白板用嗎？
不能。這是 GitHub 的終端用戶端。要對著同一張圖說話時，再開 sitdraw。

先登入，再動倉庫

沒跑通 gh auth status 之前，不要把失敗的 clone 當成網路問題。多半是帳號、SSO 或協定沒配對。

開始畫