# GitHub Desktop에서 워크트리 관리

작업 트리를 사용하면 동일한 리포지토리의 여러 분기에서 동시에 작업할 수 있으므로 작업을 숨기지 않고 컨텍스트를 전환하거나 변경 내용을 검토하거나 핫픽스를 만들 수 있습니다.

## 워크트리 정보

Git 워크트리를 사용하면 컴퓨터의 자체 디렉터리에 있는 동일한 리포지토리의 여러 분기를 동시에 체크 아웃할 수 있습니다. 즉, 기능 분기에서 작업하거나, 다른 분기에서 끌어오기 요청을 신속하게 검토하거나, 현재 분기에서 불완전한 작업을 숨기거나 커밋하지 않고 핫픽스를 만들 수 있습니다.

GitHub Desktop 에서는 워크트리를 만들고, 전환하고, 이름을 바꾸고, 삭제할 수 있는 기본 제공 지원을 제공합니다. 리포지토리에 워크트리가 있으면 **리포지토리**와 **분기** 드롭다운 사이의 도구 모음에 **Worktree** 드롭다운이 나타납니다.

> \[!NOTE]
> **Worktree** 드롭다운은 하나 이상의 연결된 워크트리가 있는 경우에만 표시됩니다. 첫 번째 워크트리를 만들려면 **리포지토리** 메뉴를 사용하거나 도구 모음에서 **리포지토리** 드롭다운을 마우스 오른쪽 단추로 클릭합니다.

각 워크트리는 분기(또는 분리된 HEAD 커밋)와 연결됩니다. 기본 워크트리는 원래 리포지토리 복제본이며 연결된 워크트리는 사용자가 만드는 추가 체크 아웃입니다.

## 워크트리 만들기

**리포지토리** 메뉴에서 도구 모음의 **리포지토리** 드롭다운을 마우스 오른쪽 단추로 클릭하거나 **Worktree** 드롭다운에서 (이미 워크트리가 있으면) 새 워크트리를 만들 수 있습니다.

### 첫 번째 워크트리 만들기

리포지토리에 연결된 워크트리가 아직 없으면 도구 모음에 **Worktree** 드롭다운이 표시되지 않습니다. 첫 번째 워크트리를 만들려면 다음을 수행합니다.

1. 메뉴 모음에서 **리포지토리**를 클릭한 다음 **새 워크트리...** 를 클릭합니다.

   또는 도구 모음에서 **리포지토리** 드롭다운을 마우스 오른쪽 단추로 클릭하고 **새 워크트리를 클릭합니다.**

   <div class="ghd-tool mac">

   ![Mac의 "리포지토리" 드롭다운 메뉴 스크린샷 "새 Worktree" 옵션이 파란색으로 강조 표시되어 있습니다.](/assets/images/help/desktop/mac-repository-new-worktree-menu.png)

   </div>

   <div class="ghd-tool windows">

   ![Windows "리포지토리" 드롭다운 메뉴의 스크린샷. "새 워크트리" 옵션이 파란색으로 강조 표시됩니다.](/assets/images/help/desktop/windows-repository-new-worktree-menu.png)

   </div>

2. "worktree 추가" 대화 상자의 **Worktree** 이름 필드에 작업 트리의 이름을 입력합니다.

GitHub Desktop 에서는 입력한 이름에 따라 작업 트리를 만들 경로를 자동으로 결정합니다. 전체 경로는 대화 상자의 아래쪽에 표시됩니다.

1. 필요에 따라 **분기 이름 필드에 분기** 이름을 입력하거나 선택합니다.

   * 이 필드를 비워 두면 작업 트리와 이름이 같은 새 분기가 만들어집니다.
   * 기존 로컬 분기의 이름을 입력하면 해당 분기가 새 워크트리에서 체크 아웃됩니다.
   * 원격 분기의 이름을 입력하면 원격 참조에서 새 로컬 분기가 만들어집니다.

   <div class="ghd-tool mac">

   ![이름, 경로 및 분기 필드를 보여 주는 Mac의 "worktree 추가" 대화 상자 스크린샷](/assets/images/help/desktop/mac-add-worktree-dialog.png)

   </div>

   <div class="ghd-tool windows">

   ![이름, 경로 및 분기 필드를 보여 주는 Windows "worktree 추가" 대화 상자의 스크린샷.](/assets/images/help/desktop/windows-add-worktree-dialog.png)

   </div>

2. **Worktree 만들기**를 클릭합니다.

첫 번째 연결된 워크트리를 만든 후 도구 모음에 **Worktree** 드롭다운이 나타납니다.

### 추가 작업 트리 만들기

**Worktree** 드롭다운이 표시되면 여기에서 워크트리를 만들 수도 있습니다.

1. 리포지토리 표시줄에서 **Worktree** 드롭다운을 클릭합니다.

   <div class="ghd-tool mac">

   ![Mac의 워크트리 드롭다운 스크린샷 확장된 "Worktree" 드롭다운에서 새 워크트리 단추가 파란색으로 강조 표시됩니다.](/assets/images/help/desktop/mac-worktree-dropdown-new-worktree.png)

   </div>

   <div class="ghd-tool windows">

   ![Windows 워크트리 드롭다운의 스크린샷 확장된 "Worktree" 드롭다운에서 새 워크트리 단추가 파란색으로 강조 표시됩니다.](/assets/images/help/desktop/windows-worktree-dropdown-new-worktree.png)

   </div>

2. **새 워크트리**를 클릭합니다.

3. [첫 번째](#creating-your-first-worktree) 작업 트리 만들기에 설명된 대로 "worktree 추가" 대화 상자에서 필드를 완료한 다음 **Worktree 만들기**를 클릭합니다.

GitHub Desktop는 워크트리를 만들고 해당 워크트리로 자동 전환합니다.

## 작업 트리 간 전환

언제든지 작업 트리 간에 전환할 수 있습니다. 작업 트리를 GitHub Desktop 전환하면 작업 디렉터리를 선택한 작업 트리의 경로로 업데이트합니다.

1. 리포지토리 표시줄에서 **Worktree** 드롭다운을 클릭합니다.
2. 작업 트리 목록에서 전환할 작업 트리를 클릭합니다.

   ![활성 워크트리에 확인 표시가 있는 "기본 워크트리" 및 "연결된 작업 트리" 그룹을 보여 주는 워크트리 드롭다운의 스크린샷.](/assets/images/help/desktop/worktree-dropdown.png)

   작업 트리 목록은 "기본 작업 트리" 및 "연결된 작업 트리"로 그룹화됩니다. 각 항목에는 worktree 디렉터리 이름과 연결된 분기 이름이 표시됩니다. 목록 맨 위에 있는 필터 필드를 사용하여 이름으로 작업 트리를 검색할 수 있습니다.

## 작업 트리 이름 바꾸기

연결된 워크트리의 이름을 바꿀 수 있습니다. 기본 워크트리의 이름을 바꿀 수 없습니다.

1. 리포지토리 표시줄에서 **Worktree** 드롭다운을 클릭합니다.

2. 이름을 바꿀 작업 트리를 마우스 오른쪽 단추로 클릭한 다음 **이름 바꾸기...** 를 클릭합니다.

   <div class="ghd-tool mac">

   ![이름 바꾸기, 이름 복사, 경로 복사 및 삭제 옵션이 있는 Mac의 작업 트리 항목에 있는 상황에 맞는 메뉴의 스크린샷.](/assets/images/help/desktop/mac-worktree-context-menu.png)

   </div>

   <div class="ghd-tool windows">

   ![이름 바꾸기, 이름 복사, 경로 복사 및 삭제 옵션이 있는 Windows 작업 트리 항목의 상황에 맞는 메뉴 스크린샷](/assets/images/help/desktop/windows-worktree-context-menu.png)

   </div>

3. "워크트리 이름 바꾸기" 대화 상자에서 작업 트리의 새 이름을 입력합니다.

4. **이름 바꾸기**를 클릭합니다.

## 작업 트리 삭제

더 이상 필요하지 않은 연결된 워크트리를 삭제할 수 있습니다. 삭제를 방지하기 위해 Git에서 잠근 기본 작업 트리 또는 작업 트리는 삭제할 수 없습니다.

1. 리포지토리 표시줄에서 **Worktree** 드롭다운을 클릭합니다.
2. 삭제할 작업 트리를 마우스 오른쪽 단추로 클릭한 다음 **삭제...** 를 클릭합니다.
3. 확인 대화 상자에서 **삭제**를 클릭합니다.

   필요에 따라 **이 메시지를 다시 표시하지 않음** 을 선택하여 나중에 이 확인을 건너뜁니다. 기본 설정에서 확인을 다시 사용하도록 설정할 수 있습니다.
   [워크트리 삭제에 대한 프롬프트 구성을 참조하세요](#configuring-a-prompt-for-deleting-worktrees).

   <div class="ghd-tool mac">

   !["이 메시지를 다시 표시 안 함" 확인란이 있는 Mac의 "Worktree 삭제" 확인 대화 상자 스크린샷](/assets/images/help/desktop/mac-delete-worktree.png)

   </div>

   <div class="ghd-tool windows">

   !["이 메시지를 다시 표시 안 함" 확인란이 있는 Windows "Worktree 삭제" 확인 대화 상자의 스크린샷](/assets/images/help/desktop/windows-delete-worktree.png)

   </div>

   예를 들어 워크트리에 커밋되지 않은 변경 내용 GitHub Desktop 이 포함되어 있으므로 삭제에 실패하면 워크트리를 강제로 삭제하는 오류 대화 상자가 표시됩니다. 취소 GitHub Desktop 하면 원래 작업하던 작업 트리로 다시 전환합니다.

## 워크트리 삭제 프롬프트 구성

작업 트리를 삭제하기 전에 확인을 요청할지 여부를 GitHub Desktop 선택할 수 있습니다.

<div class="ghd-tool mac">

1. 메뉴 바에서 **GitHub Desktop** 을 선택하고 **Settings**을 클릭합니다.

   ![Mac의 메뉴 모음에서 스크린샷. 열려 있는 "GitHub Desktop" 드롭다운 메뉴에서 커서가 파란색으로 강조 표시된 "Settings"에 있습니다.](/assets/images/help/desktop/mac-choose-settings.png)

2. 설정 창에서 **프롬프트를** 클릭합니다.

3. **작업 트리 제거** 확인란을 선택하거나 선택 취소하여 확인 프롬프트를 사용하거나 사용하지 않도록 설정합니다.

</div>

<div class="ghd-tool windows">

1. **파일** 메뉴에서 **옵션**을 클릭합니다.

   ![Windows의 "GitHub Desktop" 메뉴 모음 스크린샷. 확장된 "File" 드롭다운 메뉴에서 "Options" 항목이 주황색 윤곽선으로 표시됩니다.](/assets/images/help/desktop/windows-choose-options.png)

2. 옵션 창에서 **프롬프트를** 클릭합니다.

3. **작업 트리 제거** 확인란을 선택하거나 선택 취소하여 확인 프롬프트를 사용하거나 사용하지 않도록 설정합니다.

</div>

## 추가 읽기

* [GitHub Desktop에서 분기 관리하기](/ko/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)
* Git 설명서의 [git-worktree](https://git-scm.com/docs/git-worktree)