본문으로 건너뛰기

GitHub CLI(gh) 설치 및 기본 사용법

**GitHub CLI(gh)**는 터미널에서 GitHub의 거의 모든 기능(PR, Issue, Actions, Repo 등)을 조작할 수 있는 공식 명령줄 도구입니다.

설치​

Windows​

# winget (권장)
winget install --id GitHub.cli

# Chocolatey
choco install gh

# Scoop
scoop install gh

설치 후 터미널을 재시작합니다.

macOS​

brew install gh

Linux (Ubuntu/Debian)​

sudo apt update
sudo apt install gh

설치 확인​

gh --version
# gh version 2.x.x (20xx-xx-xx)

인증 (로그인)​

gh auth login

대화형 프롬프트가 나타납니다:

  1. GitHub.com 선택
  2. HTTPS 선택 (일반적인 경우)
  3. Login with a web browser 선택 → 브라우저에서 코드 입력 후 인증
# 인증 상태 확인
gh auth status

:::tip SSH 사용자 SSH를 선호하면 인증 시 SSH 프로토콜을 선택하세요. 기존 SSH 키를 자동으로 인식합니다. :::

자주 쓰는 명령어​

저장소​

# 레포 클론
gh repo clone owner/repo

# 현재 디렉토리에서 새 레포 생성
gh repo create my-project --private --source=.

# 레포를 브라우저에서 열기
gh browse

Pull Request​

# PR 목록 보기
gh pr list

# PR 생성 (현재 브랜치 → main)
gh pr create --title "기능 추가" --body "설명"

# PR 리뷰·머지
gh pr view 123
gh pr merge 123 --squash

Issue​

# 이슈 목록
gh issue list

# 이슈 생성
gh issue create --title "버그: 로그인 오류" --body "설명" --label bug

# 이슈 닫기
gh issue close 42

GitHub Actions​

# 워크플로 실행 상태
gh run list

# 특정 실행 로그 보기
gh run view 12345 --log

기타​

# GitHub API 직접 호출
gh api repos/owner/repo/issues

# 현재 인증된 사용자 정보
gh api user --jq '.login'

설정 팁​

# 기본 에디터 설정
gh config set editor "code --wait"

# 기본 브라우저에서 열기 대신 터미널 출력 선호
gh config set prompt disabled

# alias 등록 (자주 쓰는 명령)
gh alias set prc 'pr create --fill'
# 이후: gh prc 만으로 PR 생성

참고 자료​