> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallelane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 클론

> 원격 저장소 복제

원격 저장소를 복제해 ParalleLane에 자동으로 등록하고 엽니다.
URL을 직접 입력하거나, 계정에 접근 권한이 있는 저장소 목록에서 골라 클론할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/remote-clone-dialog.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=da1dd34c9aa774cf055009186c7783a5" alt="저장소 URL, 계정, 접근 가능한 저장소와 위치를 선택하는 원격 저장소 클론 다이얼로그" width="886" height="832" data-path="images/remote-clone-dialog.png" />
</Frame>

## 저장소 클론하기

<Steps>
  <Step title="클론 모달 열기">
    사이드바의 **저장소 추가 → 원격 프로젝트 열기** 를 선택합니다.
    모달이 열리면 접근 가능한 저장소 목록을 불러옵니다.
  </Step>

  <Step title="계정 선택">
    **계정** 드롭다운에서 클론에 사용할 계정을 고릅니다.
    기본값은 전역 기본 계정이며, 바꾸면 저장소 목록이 다시 로드됩니다.

    <Note>
      비공개 저장소는 선택한 계정의 자격증명으로 클론됩니다.
      클론에 사용한 계정은 그 저장소의 계정으로 자동 연결되어 이후 푸시·풀·커밋에도 쓰입니다.
    </Note>
  </Step>

  <Step title="클론할 저장소 지정">
    * **목록에서 선택** — **접근 가능한 저장소(Accessible repositories)** 드롭다운에서 고르면 클론 URL이 자동으로 채워집니다.
      이미 등록된 저장소는 **추가됨(Added)** 배지가 붙고 비활성 상태입니다.
    * **URL 직접 입력** — **저장소 URL** 칸에 주소를 붙여 넣습니다.

    <Note>
      URL이 항상 기준입니다.
      목록에서 고른 뒤 URL을 손으로 고치면 목록 선택이 해제되고 입력한 URL로 클론됩니다.
    </Note>
  </Step>

  <Step title="대상 폴더 확인">
    **위치** 에서 부모 폴더를 확인하거나 **찾아보기** 로 변경합니다.
    실제 클론 경로는 `<위치>/<저장소 이름>` 입니다.
  </Step>

  <Step title="클론 실행">
    **저장소 클론(Clone repo)** 을 누릅니다.
    완료되면 새 저장소가 등록되고 자동으로 열립니다.
  </Step>
</Steps>

<Tip>
  [설정 → ParalleLane → 일반](/ko/settings/preferences)의 **기본 클론 위치** 를 지정하면 모달이 열릴 때 자동으로 채워집니다.
  **찾아보기** 로 고른 폴더는 다음 클론의 기본값으로 기억됩니다.
</Tip>

## 클론 진행률

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/remote-clone-progress.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=de0ae9d86a7bd2a74ce215ae737e8768" alt="URL을 입력하고 클론을 실행해 단계별 진행률 바와 퍼센트가 표시된 클론 다이얼로그" width="886" height="944" data-path="images/remote-clone-progress.png" />
</Frame>

원격에서 진행 정보가 오기 전까지는 **연결 중…** 과 함께 진행률을 알 수 없는 바가 움직입니다.
보고가 시작되면 단계 이름과 진행률이 표시되며, 다음 순서로 지나갑니다.

**객체 세는 중 → 객체 압축 중 → 객체 받는 중 → 델타 해석 중 → 파일 갱신 중 → 콘텐츠 필터링 중**

단계 이름 옆에 `(처리한 개수/전체 개수)` 가, **객체 받는 중** 에는 전송 속도가 붙습니다.

<Note>
  진행률 바는 클론 전체가 아니라 **각 단계의 진행률** 입니다.
  단계가 바뀌면 0%에서 다시 시작하며, 저장소에 따라 지나가지 않는 단계도 있습니다.
</Note>

실패하면 진행 영역만 사라지고 입력값은 그대로 보존되므로 곧바로 다시 시도할 수 있습니다.

<Warning>
  클론이 진행되는 동안에는 모든 입력과 **취소** 버튼이 비활성화되고 모달을 닫을 수 없습니다.
  진행 중인 클론을 중간에 취소하는 기능은 없습니다.
</Warning>

<Note>
  클론에는 다른 원격 작업과 다른 타임아웃이 적용됩니다.
  진행 출력이 들어오는 동안에는 최대 24시간까지 계속되고, **300초 동안 아무 진행도 보고되지 않을 때만** 중단됩니다.
</Note>

## 자주 발생하는 상황

<AccordionGroup>
  <Accordion title="저장소 목록이 비어 있습니다" icon="user-x">
    계정이 없거나 토큰이 만료되면 목록을 채우지 못합니다.
    [설정 → ParalleLane → 계정](/ko/settings/accounts)에서 계정을 추가하거나 다시 인증하세요.
    이 경우에도 URL을 직접 입력해 클론할 수 있습니다.

    목록 조회가 실패하면 드롭다운 아래에 원격이 돌려준 오류가 그대로 표시됩니다(예: `HTTP 401 Unauthorized`). 계정은 연결됐지만 접근 가능한 저장소가 없으면 오류가 아니라 안내 문구만 표시됩니다.
  </Accordion>

  <Accordion title="대상 폴더가 이미 존재합니다" icon="folder">
    `<위치>/<저장소 이름>` 폴더가 이미 있으면 클론이 시작되기 전에 중단됩니다.
    위치를 바꾸거나 기존 폴더를 정리하세요.
  </Accordion>

  <Accordion title="이미 등록된 저장소입니다" icon="copy">
    판정 기준은 URL 문자열이 아니라 호스트·소유자·저장소 이름이므로, 같은 저장소의 SSH·HTTPS 주소도 동일하게 인식됩니다.

    <Note>
      URL 직접 입력에는 이 검사가 적용되지 않습니다.
      같은 저장소를 다른 위치에 클론하면 별개의 로컬 사본으로 하나 더 등록됩니다.
    </Note>
  </Accordion>

  <Accordion title="클론이 인증 오류로 실패합니다" icon="lock">
    선택한 계정에 접근 권한이 있는지 확인하고, [설정 → ParalleLane → 계정](/ko/settings/accounts)에서 자격증명을 재확인하세요.
  </Accordion>
</AccordionGroup>