Skip to main content

GitHub CLI 빠른 시작

GitHub CLI 사용을 시작하여 명령줄에서 GitHub 작업을 합니다.

GitHub CLI 정보

GitHub CLI는 컴퓨터의 명령줄에서 GitHub를 사용하기 위한 오픈 소스 도구입니다. 명령줄에서 작업하는 경우 GitHub CLI을(를) 사용하여 시간을 절약하고 컨텍스트 전환을 방지할 수 있습니다.

필수 조건

  1. macOS, Windows 또는 Linux에 GitHub CLI를 설치합니다. 자세한 내용은 GitHub CLI 리포지토리의 설치를 참조하세요.

  2. 터미널에서 이 명령을 실행하여 GitHub(으)로 인증합니다.

    gh auth login
    
  3. 화면에 표시되는 메시지를 따릅니다.

    GitHub CLI은(는) Git 작업의 기본 프로토콜로 HTTPS가 선택된 경우 자동으로 Git 자격 증명을 저장하고 GitHub 자격 증명으로 Git에 인증할지 묻는 프롬프트에 “예”라고 대답합니다. 이는 별도의 자격 증명 관리자를 설정하거나 SSH를 사용하지 않고도 git push, git pull 등의 Git 명령을 사용할 수 있으므로 유용할 수 있습니다.

몇 가지 유용한 명령

참고: 일부 명령을 처음 사용하는 경우(예 gh codespace SUBCOMMAND) 인증 토큰에 추가 범위를 추가하라는 메시지가 표시됩니다. 화면에 나타나는 지시에 따릅니다.

상태 보기

구독하는 모든 리포지토리에서 GitHub에 대한 현재 작업의 세부 정보를 보려면 gh status를 입력합니다.

리포지토리 보기

리포지토리 설명 및 리포지토리의 README.md를 보려면 gh repo view OWNER/REPO를 입력합니다. 기본 브라우저에서 리포지토리를 보려면 gh repo view OWNER/REPO --web을 입력합니다.

GitHub에 원격이 있는 로컬 Git 리포지토리의 디렉터리 내에서 repo 하위 명령을 실행하는 경우 OWNER/REPO를 생략할 수 있습니다.

리포지토리 복제

gh repo clone OWNER/REPO를 입력합니다. 예를 들어 gh repo clone octo-org/octo-repo는 로컬 컴퓨터에서 이 명령을 실행한 디렉터리에 octo-org/octo-repo 리포지토리를 복제합니다.

리포지토리 만들기

gh repo create를 입력하고 화면에 나타나는 지시에 따릅니다. GitHub에 빈 새 리포지토리를 만든 다음 필요에 따라 로컬로 복제할 수 있습니다. 또는 기존 로컬 리포지토리를 GitHub에 푸시하고 필요에 따라 로컬 리포지토리의 원격으로 설정할 수 있습니다. 로컬 디렉터리를 Git 리포지토리로 설정하는 방법에 대한 자세한 내용은 "GitHub에 로컬로 호스트된 코드 추가"을 참조하세요.

이슈 작업

지정된 리포지토리에 대해 현재 열려 있는 가장 최근에 만든 문제를 나열하려면 gh issue list --repo OWNER/REPO를 입력합니다. GitHub에 원격이 있는 로컬 Git 리포지토리의 디렉터리 내에서 issue 하위 명령을 실행하는 경우 --repo OWNER/REPO를 생략할 수 있습니다. 예를 들어 gh issue list --assignee "@me"를 입력하여 이 리포지토리에 할당된 이슈를 나열하거나 gh issue list --author monalisa를 입력하여 사용자 "monalisa"가 만든 이슈를 나열합니다.

새 이슈를 만들거나 "문제 만들기"을 참조하거나 이슈를 검색할 수도 있습니다("AUTOTITLE" 참조).

끌어오기 요청 작업

지정된 리포지토리에 대해 현재 열려 있는 가장 최근에 만든 끌어오기 요청을 나열하려면 gh pr list --repo OWNER/REPO를 입력합니다. GitHub에 원격이 있는 로컬 Git 리포지토리의 디렉터리 내에서 pr 하위 명령을 실행하는 경우 --repo OWNER/REPO를 생략할 수 있습니다. 예를 들어 이 리포지토리에서 만든 열린 끌어오기 요청을 나열하려면 gh pr list --author "@me"를 입력합니다.

특정 레이블이 있는 열린 끌어오기 요청을 나열하려면 gh pr list --label LABEL-NAME을 입력합니다. 검토하라는 요청을 받은 끌어오기 요청을 나열하려면 gh search prs --review-requested=@me --state=open을 입력합니다.

끌어오기 요청을 만들려면 gh pr create를 입력하고 화면의 지시에 따릅니다. 자세한 내용은 "끌어오기 요청 만들기"을(를) 참조하세요.

Codespaces 작업

새 codespace을 만들려면 gh codespace create를 입력하고 화면의 지시에 따릅니다.

기존 codespace를 표시하려면 gh codespace list를 입력합니다. 웹 버전의 VS Code에서 codespace를 열려면 gh codespace code -w를 입력하고 codespace를 선택합니다.

이러한 모든 명령에서 codespacecs를 대신할 수 있습니다.

도움말 가져오기

사용할 수 있는 최상위 GitHub CLI 명령의 미리 알림으로 gh를 입력합니다. 예를 들어, issue, pr, repo 등입니다.

각 명령 및 각 자회사 하위 명령에 대해 --help 플래그를 추가하여 사용 방법을 확인할 수 있습니다. 예를 들어 gh issue --help 또는 gh issue create --help입니다.

GitHub CLI 사용자 지정

구성 설정을 변경하고 별칭 또는 확장을 추가하여 GitHub CLI이(가) 가장 적합한 방식으로 작동하도록 할 수 있습니다.

  • gh config set SUBCOMMANDS를 입력하여 GitHub CLI의 설정을 구성하고 SUBCOMMANDS를 조정하려는 설정으로 바꿉니다.

    예를 들어 GitHub CLI 명령을 사용하여 만드는 새 이슈에 대한 본문 텍스트를 추가할 때와 같이 텍스트를 편집해야 할 때 사용되는 텍스트 편집기를 지정할 수 있습니다. 예를 들어 기본 설정 텍스트 편집기를 Visual Studio Code(으)로 설정하려면 gh config set editor "code -w"를 입력합니다. 이 예제의 -w(또는--wait) 플래그를 사용하면 명령이 Visual Studio Code에서 파일을 닫을 때까지 기다린 후 터미널에서 다음 단계를 진행합니다.

    자세한 내용은 gh config set를 참조하세요.

  • 일반적으로 실행하는 명령에 대한 별칭을 정의합니다. 예를 들어 gh alias set prd "pr create --draft"를 실행할 경우, 초안 끌어오기 요청을 빠르게 열려면 gh prd를 실행할 수 있습니다. 자세한 내용은 gh alias를 참조하세요.

  • GitHub CLI 확장을 사용하여 사용자 지정 명령을 만들거나 추가합니다. 자세한 내용은 "GitHub CLI 확장 사용" 및 "GitHub CLI 확장 만들기"을 참조하세요.

추가 참고 자료