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

 

GitHub CLI는 명령줄에서 GitHub의 기능을 사용할 수 있게 해주는 공식 도구로, 터미널에서 직접 저장소를 관리하고, 이슈와 풀 리퀘스트를 처리하며, GitHub Actions를 제어할 수 있게 해줍니다. GitHub CLI를 설치하고 로그인하는 과정은 개발 워크플로우를 크게 개선할 수 있는 중요한 첫 단계이며, 웹 브라우저를 열지 않고도 GitHub의 대부분의 기능을 명령줄에서 수행할 수 있게 해줍니다. GitHub CLI는 Windows, macOS, Linux 등 주요 운영체제를 모두 지원하며, 각 운영체제에 맞는 다양한 설치 방법을 제공합니다. Windows 환경에서는 Windows Package Manager인 winget을 사용하거나, Chocolatey 같은 패키지 매니저를 통해 설치할 수 있으며, MSI 인스톨러를 직접 다운로드하여 설치하는 방법도 있습니다. GitHub CLI 설치가 완료되면 gh --version 명령어로 설치된 버전을 확인할 수 있으며, 정상적으로 설치되었다면 버전 번호가 표시됩니다. GitHub CLI를 사용하기 위해서는 설치 후 반드시 GitHub 계정으로 로그인해야 하며, 이는 gh auth login 명령어를 실행하여 진행할 수 있습니다. 로그인 과정에서는 GitHub.com 또는 GitHub Enterprise Server 중 하나를 선택하고, Git 작업에 사용할 프로토콜(HTTPS 또는 SSH)을 선택하며, 브라우저를 통한 인증 또는 Personal Access Token을 사용한 인증 중 하나를 선택하게 됩니다. 브라우저 인증을 선택하면 GitHub CLI가 일회용 인증 코드를 생성하고 브라우저를 자동으로 열어주며, 사용자는 해당 코드를 입력하여 인증을 완료합니다. Personal Access Token을 사용하는 경우에는 GitHub에서 생성한 토큰을 입력하면 되며, 이 방법은 자동화나 헤드리스 환경에서 유용합니다. 로그인이 완료되면 gh auth status 명령어로 인증 상태를 확인할 수 있으며, 정상적으로 로그인되었다면 사용자 이름과 인증된 호스트 정보가 표시됩니다. GitHub CLI를 설치하고 로그인하는 절차를 완료하면 저장소 생성, 이슈 관리, 풀 리퀘스트 처리 등 다양한 GitHub 작업을 명령줄에서 효율적으로 수행할 수 있게 됩니다.

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

GitHub CLI를 Windows 환경에 설치하는 방법은 여러 가지가 있으며, 가장 간단한 방법은 Windows Package Manager인 winget을 사용하는 것입니다. Windows 10 버전 1809 이상 또는 Windows 11에서는 winget이 기본적으로 포함되어 있어 별도의 설치 없이 바로 사용할 수 있습니다. winget을 사용하여 GitHub CLI를 설치하려면 Command Prompt나 PowerShell을 관리자 권한으로 실행한 후 winget install --id GitHub.cli 명령어를 입력하면 됩니다. 이 명령어는 GitHub CLI의 최신 버전을 자동으로 다운로드하고 설치하며, 설치 과정에서 사용자의 개입이 거의 필요 없이 완료됩니다. Chocolatey 패키지 매니저를 사용하는 경우에는 choco install gh 명령어를 실행하면 되며, Chocolatey가 설치되어 있지 않다면 먼저 Chocolatey를 설치해야 합니다. Scoop 패키지 매니저를 사용하는 경우에는 scoop install gh 명령어를 사용할 수 있으며, 먼저 scoop bucket add github-gh https://github.com/cli/scoop-gh.git 명령어로 GitHub CLI 버킷을 추가해야 합니다. 수동 설치 방법으로는 GitHub CLI 공식 릴리스 페이지에서 MSI 인스톨러를 다운로드하여 설치할 수 있으며, 이 방법은 패키지 매니저를 사용하지 않고 직접 설치 파일을 실행하는 전통적인 방식입니다. MSI 인스톨러를 다운로드하려면 GitHub CLI 공식 저장소의 릴리스 페이지에 접속하여 Windows용 MSI 파일을 찾아 다운로드하고, 다운로드한 파일을 실행하여 설치 마법사를 따라 진행하면 됩니다. 설치가 완료된 후에는 터미널을 다시 시작하거나 새 터미널 창을 열어야 PATH 환경 변수가 업데이트되어 gh 명령어를 사용할 수 있습니다. 설치가 제대로 되었는지 확인하려면 gh --version 명령어를 실행하여 버전 정보가 표시되는지 확인하면 되며, 정상적으로 설치되었다면 "gh version X.X.X" 형식의 버전 번호가 나타납니다. gh --help 명령어를 실행하면 사용 가능한 모든 명령어 목록이 표시되며, 이를 통해 GitHub CLI가 정상적으로 작동하는지 추가로 확인할 수 있습니다. GitHub CLI는 정기적으로 업데이트되며, winget upgrade --id GitHub.cli 또는 choco upgrade gh 명령어를 사용하여 최신 버전으로 업데이트할 수 있습니다. 설치 과정에서 문제가 발생하면 GitHub CLI 공식 문서를 참조하거나, GitHub CLI 저장소의 이슈 트래커에서 유사한 문제를 검색하여 해결 방법을 찾을 수 있습니다.

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

GitHub CLI 설치가 완료되면 GitHub 계정으로 로그인해야 하며, 이는 gh auth login 명령어를 실행하여 시작할 수 있습니다. gh auth login 명령어를 실행하면 대화형 설정 프로세스가 시작되며, 먼저 로그인할 계정을 선택하게 됩니다. GitHub.com을 사용하는 경우 "GitHub.com"을 선택하고, GitHub Enterprise Server를 사용하는 경우 "GitHub Enterprise Server"를 선택한 후 호스트 이름을 입력합니다. 다음 단계에서는 Git 작업에 사용할 프로토콜을 선택하게 되며, HTTPS와 SSH 중 하나를 선택할 수 있습니다. HTTPS를 선택하면 GitHub CLI가 Git 자격 증명을 자동으로 관리해주며, SSH를 선택하면 SSH 키를 생성하거나 기존 SSH 키를 업로드할 수 있습니다. 프로토콜 선택 후에는 Git 작업에 GitHub 자격 증명을 사용할지 묻는 프롬프트가 나타나며, "Yes"를 선택하면 GitHub CLI가 Git의 자격 증명 헬퍼로 설정되어 git push나 git pull 같은 Git 명령어를 실행할 때 자동으로 인증이 처리됩니다. 다음 단계에서는 인증 방법을 선택하게 되며, "Login with a web browser"와 "Paste an authentication token" 두 가지 옵션이 제공됩니다. 웹 브라우저를 통한 로그인을 선택하면 GitHub CLI가 일회용 인증 코드를 생성하고 브라우저를 자동으로 열어주며, 사용자는 브라우저에서 해당 코드를 입력하고 GitHub 계정으로 로그인한 후 권한을 승인하면 됩니다. 이 과정에서 2단계 인증이 활성화되어 있다면 추가 인증 단계를 거쳐야 하며, 권한 승인 후에는 자동으로 인증이 완료됩니다. Personal Access Token을 사용하는 경우에는 먼저 GitHub에서 Personal Access Token을 생성해야 하며, GitHub 설정 페이지의 Developer settings에서 Personal Access Tokens 섹션으로 이동하여 새 토큰을 생성합니다. 토큰 생성 시 최소한 'repo', 'read:org', 'gist' 스코프가 필요하며, 필요에 따라 추가 스코프를 선택할 수 있습니다. 토큰이 생성되면 복사하여 gh auth login 명령어 실행 시 "Paste an authentication token" 옵션을 선택한 후 붙여넣으면 됩니다. 로그인이 완료되면 GitHub CLI가 인증 토큰을 시스템의 자격 증명 저장소에 안전하게 저장하며, 자격 증명 저장소를 사용할 수 없는 경우에는 일반 텍스트 파일에 저장됩니다. 저장 위치는 gh auth status 명령어로 확인할 수 있으며, 이 명령어는 현재 로그인된 계정 정보와 인증 상태를 표시합니다. 여러 GitHub 계정을 사용하는 경우 gh auth login 명령어를 여러 번 실행하여 각 계정을 추가로 인증할 수 있으며, gh auth switch 명령어를 사용하여 계정 간 전환할 수 있습니다.

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

GitHub CLI 로그인이 완료되면 다양한 GitHub 작업을 명령줄에서 수행할 수 있으며, 먼저 gh auth status 명령어로 인증 상태를 확인하는 것이 좋습니다. gh auth status 명령어를 실행하면 현재 로그인된 GitHub 계정의 사용자 이름, 호스트 정보, 활성 계정 여부, Git 작업 프로토콜, 토큰 스코프 등의 정보가 표시됩니다. 인증이 정상적으로 완료되었다면 "Logged in to github.com as 사용자명"과 같은 메시지가 나타나며, Git 작업이 설정되었다는 확인 메시지도 함께 표시됩니다. GitHub CLI의 기본 기능을 테스트하기 위해 gh repo list 명령어를 실행하여 자신의 저장소 목록을 확인할 수 있으며, 이 명령어가 정상적으로 작동하면 GitHub CLI가 올바르게 설정되었다는 것을 의미합니다. gh repo view 명령어를 사용하면 특정 저장소의 정보를 확인할 수 있으며, gh repo create 명령어로 새 저장소를 생성할 수도 있습니다. GitHub CLI를 Git의 자격 증명 헬퍼로 설정하려면 gh auth setup-git 명령어를 실행하면 되며, 이 명령어는 Git 설정에 GitHub CLI를 자격 증명 헬퍼로 등록하여 Git 명령어 실행 시 자동으로 GitHub 인증을 처리하도록 합니다. gh auth setup-git 명령어를 실행하면 git config --global credential.helper '!gh auth git-credential' 설정이 자동으로 추가되며, 이후 git push나 git pull 같은 Git 명령어를 실행할 때 별도의 인증 입력 없이 GitHub CLI의 인증 정보가 사용됩니다. GitHub CLI의 설정 파일은 일반적으로 ~/.config/gh/config.yml 경로에 저장되며, 이 파일에는 사용자 설정, 별칭, 그리고 기타 구성 정보가 포함됩니다. 설정 파일을 직접 편집하거나 gh config set 명령어를 사용하여 설정을 변경할 수 있으며, 예를 들어 기본 에디터를 설정하려면 gh config set editor "code --wait" 명령어를 사용할 수 있습니다. GitHub CLI의 다양한 기능을 활용하기 위해 gh --help 명령어로 사용 가능한 모든 명령어를 확인하거나, 특정 명령어에 대한 도움말을 보려면 gh 명령어 --help 형식으로 실행할 수 있습니다. GitHub CLI는 확장 기능을 지원하며, gh extension install 명령어로 커뮤니티에서 제공하는 확장 기능을 설치할 수 있습니다. 로그인 상태를 지속적으로 확인하려면 주기적으로 gh auth status 명령어를 실행하거나, GitHub CLI 작업 중 인증 오류가 발생하면 gh auth refresh 명령어로 인증 토큰을 새로고침할 수 있습니다. 여러 계정을 사용하는 경우 gh auth switch 명령어로 계정을 전환할 수 있으며, 특정 계정에서 로그아웃하려면 gh auth logout 명령어를 사용할 수 있습니다. GitHub CLI 로그인 절차를 완료하고 기본 설정을 마치면 저장소 관리, 이슈 처리, 풀 리퀘스트 관리, GitHub Actions 제어 등 다양한 GitHub 작업을 명령줄에서 효율적으로 수행할 수 있게 됩니다.