> ## 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.

# 빠른 시작

> 온보딩부터 첫 커밋까지 가장 짧은 경로

처음 켜서 계정을 만들고, 저장소를 불러오고, 첫 커밋을 남기기까지의 흐름입니다.

## 첫 실행: 온보딩

최초 실행 시 계정 하나를 만드는 온보딩 마법사가 나타납니다.
**환영 → 요금제 → 프로바이더 → 자격증명 및 신원 → 클론 위치 → 완료** 순서로 진행되며, 프로바이더 연결(또는 SSH 키 선택)은 필수입니다.

<Steps>
  <Step title="계정 만들기를 시작합니다">
    **시작하기(Get started)** 를 누릅니다.
    좌측 레일에 진행 단계가 표시되고, 끝낸 단계는 다시 눌러 수정할 수 있습니다.

    <Frame>
      <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/start-onboarding-welcome.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=e4fceab39fae26dfde50783c2bb5c8b0" alt="환영 문구와 시작하기 버튼이 있는 온보딩 첫 화면, 좌측에 진행 단계가 나열된 레일" width="2906" height="1784" data-path="images/start-onboarding-welcome.png" />
    </Frame>
  </Step>

  <Step title="요금제를 확인합니다">
    Basic과 Pro를 비교하는 화면이 나타나고, 라이선스 키가 있다면 여기서 바로 활성화할 수 있습니다.
    선택은 필수가 아니어서 **다음(Next)** 을 눌러 넘기면 무료인 Basic으로 시작합니다.
    두 요금제의 차이는 아래 [요금제](#요금제)에서 정리합니다.
  </Step>

  <Step title="프로바이더를 선택합니다">
    GitHub, GitLab, Bitbucket과 각 서버(Enterprise/Server) 변형, 그리고 SSH 중에서 고릅니다.
    선택에 따라 다음 단계의 입력 형태가 정해집니다.

    <Info>
      **PRO 전용** — GitHub Enterprise, GitLab Server, Bitbucket Server 같은 셀프호스트 항목은 Basic에서 비활성 상태로 표시되고 **PRO** 배지가 붙습니다.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/start-onboarding-account.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=544a8369b4ac365cf3fd17ec308f7dbc" alt="GitHub, GitHub Enterprise, GitLab, GitLab Server, Bitbucket, Bitbucket Server, SSH가 세로로 나열된 프로바이더 선택 화면" width="2906" height="1784" data-path="images/start-onboarding-account.png" />
    </Frame>
  </Step>

  <Step title="자격 증명과 신원을 입력합니다">
    맨 위의 **라벨(Label, 선택)** 은 계정을 구분하는 이름으로, 비워 두면 git 이름이 표시됩니다.

    * **GitHub 로그인** — **GitHub으로 로그인(Sign in with GitHub)** 을 누르면 인증 코드가 표시됩니다.
      **GitHub에서 인증하기(Authorize on GitHub)** 로 브라우저를 열어 코드를 입력하고 승인하면, 앱이 로그인 결과를 받아 이름·이메일을 채웁니다.
    * **토큰** — 인증 유형을 **Personal Access Token**(Bitbucket은 **App Password**)으로 바꿔 토큰을 붙여넣고 **검증(Validate)** 을 누릅니다.
      오른쪽에 **필요 권한 (최소)** 목록과 발급 페이지 링크가 함께 표시됩니다.
    * **SSH** — 기존 SSH 키를 고르고 이름·이메일을 입력합니다.

    <Note>
      내려받은 빌드가 GitHub 로그인을 지원하지 않으면 인증 유형이 토큰 입력으로 돌아갑니다.
      이때는 개인 액세스 토큰으로 진행하세요.
    </Note>
  </Step>

  <Step title="클론 위치를 정합니다">
    원격 저장소를 복제할 **기본 클론 폴더(Default clone folder)** 를 지정합니다.
    **설정 → ParalleLane → 일반(General)** 에서 언제든 바꿀 수 있으니 비워 두어도 됩니다.
  </Step>

  <Step title="설정을 마칩니다">
    완료 화면에서 계정 정보를 확인하고 **ParalleLane 시작하기(Start ParalleLane)** 를 누르면 본화면으로 들어갑니다.
    이 계정이 기본 계정이 됩니다.
  </Step>
</Steps>

## 요금제

무료인 **Basic** 과 일회성 구매인 **Pro** 두 가지입니다.
온보딩에서 고르지 않으면 Basic으로 시작하며, 이후 **설정 → ParalleLane → 요금제(Plan)** 에서 현재 요금제를 확인하고 라이선스를 활성화할 수 있습니다.

|           | Basic   | Pro                                                                   |
| --------- | ------- | --------------------------------------------------------------------- |
| 요금        | 무료      | 영구 라이선스(일회성 구매, 기기 3대)                                                |
| 계정        | 2개      | 무제한                                                                   |
| 리모트       | 저장소당 1개 | 무제한                                                                   |
| Pro 전용 기능 | —       | 커밋 서명, 셀프호스트 계정(Enterprise/Server), 저장소별 브랜치·태그 그룹, 프로젝트별 Open In 재정의 |

Pro 전용 기능은 앱 안에서 **PRO** 배지로 표시되고 Basic에서는 비활성 상태로 보입니다.
라이선스 키가 있으면 요금제 화면의 **라이선스 키** 입력란에 넣고 **활성화** 를 누르세요.

## 저장소 불러오기

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/start-repo-scan.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=d5d5fedc5177c0189ad767701a5d103c" alt="좌측 사이드바의 프로젝트(Projects) 탭에 저장소 세 개가 각자의 워크트리까지 펼쳐져 나열돼 있고, PROJECTS 헤더의 저장소 추가(Add repository) 버튼에서 열린 드롭다운이 프로젝트 열기(Open Project)·원격 프로젝트 열기(Open Remote Project) 두 항목을 사이드바 위에 겹쳐 보여 준다. 오른쪽에는 선택된 워크트리의 History 탭에 브랜치 칩과 작성자가 붙은 여러 갈래 커밋 그래프가 그려져 있다" width="2266" height="1784" data-path="images/start-repo-scan.png" />
</Frame>

세 가지 방법이 있습니다.

<Steps>
  <Step title="소스 폴더 스캔으로 자동 발견하기">
    **설정 → ParalleLane → 일반(General)** 의 **소스 코드 폴더(Source code folders)** 에 저장소를 모아 둔 폴더를 등록하면, 바로 아래 한 단계의 Git 저장소가 자동으로 등록됩니다.
    앱을 켤 때마다 다시 스캔하며 **재스캔(Rescan)** 으로 즉시 훑을 수도 있습니다.
    빼고 싶은 폴더는 같은 화면의 **제외 폴더(Excluded folders)** 에 추가하세요.
  </Step>

  <Step title="폴더를 직접 열기">
    좌측 **프로젝트(Projects)** 탭 헤더의 **저장소 추가(Add repository) → 프로젝트 열기(Open Project)** 로 로컬 저장소 폴더를 엽니다.
  </Step>

  <Step title="원격 저장소 복제하기">
    같은 메뉴의 **원격 프로젝트 열기(Open Remote Project)** 로 계정에서 접근 가능한 저장소를 고르거나 URL을 붙여넣어 클론합니다.
    클론 위치는 기본 클론 폴더입니다.
  </Step>
</Steps>

## 그래프 보기와 첫 커밋

<Steps>
  <Step title="저장소와 워크트리를 선택합니다">
    좌측 **프로젝트(Projects)** 탭에서 저장소를 펼쳐 워크트리를 선택하면 가운데에 커밋 그래프가 그려집니다.
    각 영역의 역할은 [화면 둘러보기](/ko/interface-overview)에서 다룹니다.
  </Step>

  <Step title="변경 사항을 확인합니다">
    우측 사이드바 맨 위 **워킹 카피(Working copy)** 카드에 **N개 변경 / N개 충돌 / 변경 없음** 이 표시됩니다.
    카드를 누르면 파일 목록과 diff가 열립니다.
  </Step>

  <Step title="스테이징하고 커밋합니다">
    파일을 **스테이지(Stage)** 로 올리고 **요약(Summary)** 을 적은 뒤 **커밋(Commit)** 을 누르면 그래프 맨 위에 새 커밋이 나타납니다.
  </Step>
</Steps>

<Tip>
  한 저장소의 여러 브랜치를 폴더별로 동시에 열어 두고 오갈 수 있습니다.
  [워크트리 이해하기](/ko/worktrees/concept)를 확인하세요.
</Tip>