GitHub CLI (gh) 설치 및 로그인 절차

 

GitHub CLI (gh) 설치 및 로그인 절차

GitHub CLI는 터미널 창을 벗어나지 않고도 GitHub의 핵심 기능들을 자유자재로 다룰 수 있게 해주는 강력한 공식 도구입니다. 저장소 관리는 물론 이슈나 풀 리퀘스트(PR) 처리, 심지어 GitHub Actions 워크플로우 제어까지 명령줄에서 바로 해결할 수 있죠. 이 도구를 제대로 활용하기 위한 첫 단추는 바로 설치와 로그인 과정인데, 일단 한 번 세팅해 두면 매번 웹 브라우저를 띄우는 번거로움 없이 개발 흐름을 쭉 이어갈 수 있어 생산성이 크게 향상됩니다. 윈도우(Windows), 맥(macOS), 리눅스(Linux) 등 대부분의 운영체제를 지원하니 본인 환경에 맞춰 설치하면 됩니다. 윈도우 사용자라면 `winget`이나 `Chocolatey` 같은 패키지 매니저로 간편하게 설치할 수 있고, 원한다면 MSI 파일을 직접 받아도 됩니다. 설치가 끝났다면 터미널에서 `gh --version`을 입력해 버전 정보가 잘 뜨는지 확인해 보세요. 그 다음엔 `gh auth login` 명령어로 계정을 연결해야 하는데, 이 과정에서 HTTPS와 SSH 중 선호하는 방식을 고를 수 있고, 브라우저 인증이나 토큰 인증 중 편한 방법을 선택하면 됩니다. 브라우저 인증을 쓰면 자동으로 뜨는 창에 코드만 입력하면 되니 아주 간편하죠. 로그인이 잘 됐는지는 `gh auth status`로 확인할 수 있습니다. 이제 터미널이 곧 GitHub 대시보드가 되는 경험을 시작해 보세요.

GitHub CLI (gh) 설치 방법과 다운로드 절차

윈도우 환경에서 GitHub CLI를 설치하는 방법은 다양하지만, 개인적으로 가장 추천하는 건 윈도우 패키지 매니저인 `winget`을 사용하는 겁니다. 윈도우 10(1809 버전 이상)이나 11을 쓰고 있다면 이미 내장되어 있어 별도 설치도 필요 없죠. 관리자 권한으로 터미널을 열고 `winget install --id GitHub.cli` 한 줄만 입력하면 최신 버전을 알아서 내려받고 설치까지 깔끔하게 끝냅니다. 만약 `Chocolatey`를 애용하신다면 `choco install gh`를, `Scoop`을 쓰신다면 버킷 추가 후 `scoop install gh`를 입력하면 됩니다. 패키지 매니저가 익숙지 않다면 GitHub CLI 공식 릴리스 페이지에서 MSI 인스톨러를 직접 다운로드해 설치 마법사를 따라가도 무방합니다. 설치 후에는 환경 변수(PATH) 반영을 위해 터미널을 껐다 다시 켜는 걸 잊지 마세요. 이제 `gh --version`을 쳤을 때 "gh version X.X.X"처럼 버전이 뜬다면 성공입니다. 혹시 명령어가 안 먹힌다면 설치 경로 문제일 수 있으니 다시 확인이 필요합니다. 참고로 CLI 도구는 업데이트가 잦은 편이니 가끔 `winget upgrade --id GitHub.cli` 등으로 최신 상태를 유지해 주는 게 좋습니다. 사용 가능한 명령어 목록이 궁금하다면 `gh --help`를 눌러보세요.

GitHub CLI 설치 후 로그인 절차와 인증 설정

설치를 마쳤다면 이제 내 GitHub 계정과 연결할 차례입니다. `gh auth login` 명령어를 실행하면 대화형 설정이 시작되는데, 질문에 하나씩 답하면 돼서 생각보다 간단합니다. 먼저 일반 사용자라면 "GitHub.com"을, 사내 구축형을 쓴다면 "Enterprise Server"를 선택하세요. 그 다음 Git 프로토콜을 묻는데, 평소 SSH 키를 관리한다면 SSH를, 그렇지 않다면 HTTPS를 추천합니다. HTTPS를 고르면 CLI가 복잡한 자격 증명 관리를 대신해주니 훨씬 편하거든요. "Git 자격 증명 헬퍼로 사용하겠느냐"는 질문에는 "Yes"를 눌러주세요. 그래야 `git push` 할 때마다 아이디/비번을 치는 귀찮음에서 해방됩니다. 인증 방식은 "Login with a web browser"가 가장 직관적입니다. 엔터를 누르면 브라우저가 열리고 일회용 코드가 뜨는데, 이걸 입력하고 승인만 해주면 끝입니다. 만약 원격 서버나 자동화 환경이라 브라우저를 못 쓴다면 "Paste an authentication token"을 선택해 미리 발급받은 액세스 토큰(Personal Access Token)을 붙여넣으세요. 이때 토큰 권한은 최소한 'repo', 'read:org', 'gist' 정도는 있어야 원활하게 작동합니다. 로그인이 성공하면 토큰은 안전하게 저장되며, 다중 계정이 필요할 땐 `gh auth login`을 다시 실행해 계정을 추가하고 `gh auth switch`로 오가며 쓸 수 있습니다.

GitHub CLI 로그인 완료 후 사용 준비와 확인 방법

로그인까지 마쳤다면 `gh auth status` 명령어로 상태를 점검해 봅시다. "Logged in to github.com as 사용자명"이라는 메시지와 함께 체크 표시가 뜬다면 완벽하게 연결된 겁니다. 이제 제대로 작동하는지 테스트해 볼까요? `gh repo list`를 입력했을 때 내 저장소 목록이 주루룩 뜬다면 준비 완료입니다. 만약 앞선 단계에서 Git 자격 증명 설정을 놓쳤다면 `gh auth setup-git` 명령어를 한 번 실행해 주세요. 이걸 해두면 `git` 명령어와 `gh`의 인증 정보가 연동되어 작업이 훨씬 매끄러워집니다. CLI 설정은 주로 `~/.config/gh/config.yml` 파일에 저장되는데, `gh config set editor "code --wait"`처럼 기본 에디터를 VS Code로 지정해 두면 PR 본문을 작성할 때 편합니다. 사용하다가 막히면 언제든 `gh 명령어 --help`로 사용법을 찾아볼 수 있고, 기능이 부족하다 싶으면 `gh extension install`로 유저들이 만든 확장 기능을 추가할 수도 있습니다. 혹시라도 인증 오류가 생기면 `gh auth refresh`로 토큰을 갱신하면 되고, 로그아웃은 `gh auth logout`으로 간단히 처리할 수 있습니다. 이제 터미널에서 저장소 생성부터 배포 관리까지, GitHub의 모든 기능을 효율적으로 즐겨보세요.