Skip to main content

리포지토리 복제

GitHub에 리포지토리를 만들면 원격 리포지토리로 존재합니다. 리포지토리를 복제하여 컴퓨터에 로컬 복사본을 만들고 두 위치 간에 동기화할 수 있습니다.

Platform navigation

리포지토리 복제 정보

GitHub.com에서 로컬 컴퓨터 또는 codespace로 리포지토리를 복제하여 병합 충돌을 보다 쉽게 해결하고, 파일을 추가 또는 제거하고, 더 큰 커밋을 푸시할 수 있습니다. 리포지토리를 복제할 때 GitHub.com에서 로컬 컴퓨터로 리포지토리를 복사하거나 codespace를 만드는 경우 원격 가상 머신으로 복사합니다. codespace 복제에 대한 자세한 내용은 리포지토리에 대한 codespace 만들기을(를) 참조하세요.

GitHub.com에서 로컬 컴퓨터로 리포지토리를 복제하여 병합 충돌을 보다 쉽게 해결하고, 파일을 추가 또는 제거하고, 더 큰 커밋을 푸시할 수 있습니다. 리포지토리를 복제할 때 GitHub.com에서 로컬 컴퓨터로 리포지토리를 복사합니다.

GitHub.com에서 로컬 컴퓨터로 리포지토리를 복제하여 병합 충돌을 보다 쉽게 해결하고, 파일을 추가 또는 제거하고, 더 큰 커밋을 푸시할 수 있습니다. 리포지토리를 복제할 때 GitHub.com에서 로컬 컴퓨터로 리포지토리를 복사합니다.

리포지토리를 복제하면 프로젝트의 모든 파일 및 폴더 버전을 포함하여 GitHub.com이(가) 있는 모든 리포지토리 데이터의 전체 복사본이 제거됩니다. GitHub.com의 원격 리포지토리에 변경 내용을 푸시하거나 GitHub.com에서 다른 사용자의 변경 내용을 끌어올 수 있습니다. 자세한 내용은 Git 사용을(를) 참조하세요.

기존 리포지토리를 복제하거나 다른 사람의 기존 리포지토리를 복제하여 프로젝트에 기여할 수 있습니다.

리포지토리 복제

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 파일 목록 위에서 코드를 클릭합니다.

    리포지토리의 방문 페이지에 있는 파일 목록의 스크린샷. "코드" 단추는 진한 주황색 윤곽선으로 강조 표시됩니다.

  3. 리포지토리의 URL을 복사합니다.

    • HTTPS를 사용하여 리포지토리를 복제하려면 "HTTPS"에서 을 클릭합니다.

    • 조직의 SSH 인증 기관에서 발급한 인증서를 포함하여 SSH 키를 사용하여 리포지토리를 복제하려면 SSH를 클릭한 다음, 을 클릭합니다.

    • GitHub CLI를 사용하여 리포지토리를 복제하려면 GitHub CLI 를 클릭한 다음, 을 클릭합니다.

      "코드" 드롭다운 메뉴의 스크린샷. 리포지토리의 HTTPS URL 오른쪽에 복사 아이콘이 진한 주황색으로 표시됩니다.

  4. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  5. 현재 작업 디렉터리를 복제 대상 디렉터리의 위치로 변경합니다.

  6. git clone을 입력한 다음 이전에 복사한 URL을 붙여넣습니다.

    git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
    
  7. Enter 키를 눌러 로컬 복제본을 만듭니다.

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
    > Cloning into `Spoon-Knife`...
    > remote: Counting objects: 10, done.
    > remote: Compressing objects: 100% (8/8), done.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.
    

Note

GitHub CLI에 대한 자세한 내용은 "GitHub CLI 정보"을 참조하세요.

리포지토리를 로컬로 복제하려면 repo clone 하위 명령을 사용합니다. repository 매개 변수를 확장의 리포지토리로 바꿉니다. 예를 들어 octo-org/octo-repo, monalisa/octo-repo 또는 octo-repo입니다. OWNER/REPO 리포지토리 인수의 OWNER/ 부분을 생략하면 기본값은 인증 사용자의 이름으로 설정됩니다.

gh repo clone REPOSITORY

GitHub URL을 사용하여 리포지토리를 복제할 수도 있습니다.

gh repo clone https://github.com/PATH-TO/REPOSITORY
  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 파일 목록 위에서 코드를 클릭합니다.

    리포지토리의 방문 페이지에 있는 파일 목록의 스크린샷. "코드" 단추가 진한 주황색 윤곽선으로 강조 표시되어 있습니다.

  3. GitHub Desktop을(를) 사용하여 리포지토리를 복제하고 열려면 GitHub Desktop으로 열기를 클릭합니다.

    리포지토리의 “코드” 드롭다운 스크린샷 "GitHub Desktop으로 열기"라는 레이블이 있는 단추가 진한 주황색 윤곽선으로 표시되어 있습니다.

  4. GitHub Desktop의 프롬프트에 따라 복제를 완료합니다.

자세한 내용은 GitHub에서 GitHub Desktop으로 리포지토리 복제을(를) 참조하세요.

빈 리포지토리 복제

빈 리포지토리에는 파일이 없습니다. 리포지토리를 만들 때 추가 정보로 리포지토리를 초기화하지 않는 경우가 많습니다.

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. HTTPS를 사용하여 명령줄을 통해 리포지토리를 복제하려면 “빠른 설정”에서 를 클릭합니다. 조직의 SSH 인증 기관에서 발급한 인증서를 포함하여 SSH 키를 사용하여 리포지토리를 복제하려면 SSH를 클릭한 다음, 를 클릭합니다.

    빈 리포지토리에 대한 빠른 설정 지침의 스크린샷. 리포지토리의 HTTPS URL 오른쪽에 복사 아이콘이 진한 주황색 윤곽선으로 표시되어 있습니다.

    또는 데스크톱에서 리포지토리를 복제하려면 데스크톱에서 설정을 클릭하고 프롬프트에 따라 복제를 완료합니다.

    빈 리포지토리에 대한 빠른 설정 지침의 스크린샷. 다운로드 아이콘과 "데스크톱에서 설정"이라는 레이블이 있는 단추가 진한 주황색 윤곽선으로 표시되어 있습니다.

  3. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  4. 현재 작업 디렉터리를 복제 대상 디렉터리의 위치로 변경합니다.

  5. git clone을 입력한 다음 이전에 복사한 URL을 붙여넣습니다.

    git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
    
  6. Enter 키를 눌러 로컬 복제본을 만듭니다.

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
    > Cloning into `Spoon-Knife`...
    > remote: Counting objects: 10, done.
    > remote: Compressing objects: 100% (8/8), done.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.
    

복제 오류 문제 해결

리포지토리를 복제할 때 몇 가지 오류가 발생할 수 있습니다.

리포지토리를 복제할 수 없는 경우 다음을 확인합니다.

  • HTTP를 사용하여 연결할 수 있습니다. 자세한 내용은 복제 오류 문제 해결을(를) 참조하세요.
  • 복제하려는 리포지토리에 액세스할 수 있는 권한이 있습니다. 자세한 내용은 복제 오류 문제 해결을(를) 참조하세요.
  • 복제하려는 기본 분기가 여전히 존재합니다. 자세한 내용은 복제 오류 문제 해결을(를) 참조하세요.

추가 참고 자료