GitHub CLI 빠른 시작

GitHub CLI 정보

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

필수 구성 요소

macOS, Windows 또는 Linux에 GitHub CLI를 설치합니다. 자세한 내용은 GitHub CLI 리포지토리의 설치를 참조하세요.
GitHub에 인증하려면 터미널에서 다음 명령을 실행합니다.
```
gh auth login
```
인증하려는 위치를 선택합니다.
- GitHub.com에서 GitHub에 액세스하는 경우 GitHub.com 을 선택합니다.
- 다른 도메인에서 GitHub에 액세스하는 경우 Other를 선택한 다음, 호스트 이름(예: octocorp.ghe.com)을 입력합니다.
화면에 표시되는 나머지 메시지를 따릅니다.

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

유용한 명령어 몇 가지

참고 항목

일부 명령을 처음 사용하는 예시: gh codespace SUBCOMMAND 인증 토큰에 추가 범위를 설정하라는 메시지가 표시됩니다. 화면에 표시되는 안내를 따르세요.

상태 보기

GitHub에서 구독 중인 모든 리포지토리를 대상으로 현재 작업에 대한 세부 정보를 확인하려면 gh status을 입력하세요.

리포지토리 보기

리포지토리 설명을 보려면 gh repo view OWNER/REPO을, 리포지토리를 보려면 README.md를 입력하세요. 기본 브라우저에서 리포지토리를 보려면 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”가 생성한 문제들을 볼 수 있습니다.

새로운 문제를 만들 수도 있고, 문제 만들기 또는 문제를 검색할 수도 있으며, 문제 및 끌어오기 요청 필터링 및 검색을 참고하세요.

끌어오기 요청 작업

지정한 저장소에서 현재 열려 있는 가장 최근에 생성된 변경 요청들을 나열하려면 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를 선택하세요.

이 모든 명령에서 codespace 대신 cs을 사용할 수 있습니다.

도움말 가져오기

사용할 수 있는 최상위 GitHub CLI 명령어 목록을 보려면 gh을 입력하세요. 예를 들어, issue, pr, repo 등이 있습니다.

각 명령과 하위 명령마다, 사용 방법을 확인하려면 --help 플래그를 추가하면 됩니다. 예를 들어 gh issue --help 또는 gh issue create --help입니다.

GitHub CLI 사용자 설정

구성 설정을 변경하거나 별칭과 확장을 추가하여, GitHub CLI를 가장 편한 방식으로 사용할 수 있습니다.

SUBCOMMANDS 자리에 조정할 설정 이름을 넣고 gh config set SUBCOMMANDS을 입력하면 GitHub CLI 설정을 변경할 수 있습니다.

예를 들어, 새 문제를 만들 때 본문을 입력하는 등 텍스트 편집이 필요한 경우, 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 확장 만들기을(를) 참조하세요.

여러 계정과 함께 GitHub CLI 사용하기

동일한 GitHub 플랫폼(예: GitHub.com)에 여러 계정을 가지고 있는 경우, 각각 인증하고 gh auth switch 명령어를 사용해 계정을 전환할 수 있습니다. 자세한 내용은 GitHub CLI 설명서의 gh auth switch를 참고하세요.

여러 GitHub 플랫폼에서 GitHub CLI를 사용해야 하는 경우(예: GitHub.com의 개인 계정과 GHE.com의 관리형 사용자 계정 등), GitHub 플랫폼에서 GitHub CLI 사용을 참고하세요.

추가 참고 자료

          [AUTOTITLE](/github-cli/github-cli/github-cli-reference)

          [GitHub CLI 온라인 매뉴얼](https://cli.github.com/manual/gh)