Skip to main content

이 버전의 GitHub Enterprise는 다음 날짜에 중단되었습니다. 2024-09-25. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 더 뛰어난 성능, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise Server로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

GitHub 플랫폼에서 GitHub CLI 사용

다양한 GitHub 플랫폼의 계정에 인증될 때 명령을 실행하는 방법을 알아보세요.

GitHub.com의 개인 계정, GHE.com의 관리형 사용자 계정 등의 여러 GitHub 플랫폼에 계정이 있는 경우 각 계정에 대해 gh auth login으로 인증할 수 있습니다.

지정된 환경에서 어떤 명령이든 실행하기 위해서는 인증이 필요합니다. 예를 들어 GitHub.com의 퍼블릭 리포지토리에 대한 읽기 권한만 필요한 명령을 실행하는 경우에도 GHE.com의 계정에만 인증된 경우에는 이 명령을 사용할 수 없습니다. 따라서 GitHub CLI에 사용하려는 모든 계정을 인증해야 합니다.

각 계정에 대한 명령은 어떻게 실행하나요?

여러 계정으로 인증을 완료한 후, 명령을 실행하면 GitHub CLI에서 액세스하려는 플랫폼을 자동으로 감지할 수 있습니다. 다른 경우에는 명령에 추가 정보를 제공해야 합니다.

특정 리포지토리의 컨텍스트에 있을 때 GitHub CLI는 사용자가 의도한 계정을 자동으로 감지합니다. 예를 들어 my-repo 디렉터리로 cd하고 gh repo view를 실행하면 명령은 해당 리포지토리의 올바른 플랫폼을 대상으로 합니다.

이 컨텍스트가 없는 경우 GitHub CLI는 사용자가 의도한 계정을 자동으로 감지할 수 없습니다. 예를 들어 계정의 리포지토리를 나열하기 위해 gh repo list를 실행하는 경우 GitHub CLI는 액세스하려는 계정을 알 수 없습니다. 다음과 같은 경우:

  • GitHub CLI는 기본적으로 GitHub.com으로 설정됩니다.
  • GH_HOST 환경 변수를 설정하여 이러한 종류의 요청에 대한 기본 대상을 변경할 수 있습니다. GitHub CLI 매뉴얼에서 gh 환경을 참조하세요.
  • 일부 명령을 사용하면 gh api와 같은 --hostname 옵션을 사용하여 대상 환경을 지정하거나 gh pr view와 같은 리포지토리의 전체 URL을 전달할 수 있습니다.

동일한 플랫폼에서 여러 계정을 사용할 수 있나요?

동일한 플랫폼에서 여러 계정으로 인증할 수도 있습니다. 이러한 계정 간에 전환하려면 gh auth switch 명령을 사용하면 됩니다. GitHub CLI 매뉴얼에서 gh auth switch를 참조하세요.