# GitHub Desktop을 사용하여 첫 번째 리포지토리 만들기

명령줄을 사용하지 않고 Git 리포지토리를 만들고 관리하는 데 사용할 GitHub Desktop 수 있습니다.

## 소개

GitHub Desktop는 GitHub 또는 기타 Git 호스팅 서비스에 호스팅된 코드로 작업할 수 있도록 도와주는 무료 오픈 소스 애플리케이션입니다.
GitHub Desktop를 사용하면 명령줄을 사용하는 대신 그래픽 사용자 인터페이스에서 변경 내용을 커밋하고 푸시하는 것과 같은 Git 명령을 수행할 수 있습니다. 자세한 내용은 [GitHub Desktop에 대한 정보](/ko/desktop/overview/about-github-desktop)을(를) 참조하세요.

이 가이드를 마치면 GitHub Desktop를 사용하여 리포지토리를 만들고, 리포지토리에 변경 사항을 적용하고, 그 변경 사항을 GitHub에 게시하게 됩니다.

GitHub Desktop를 설치하고 GitHub 또는 GitHub Enterprise에 로그인한 후 튜토리얼 리포지토리를 만들고 클론할 수 있습니다. 이 자습서에서는 Git 작업 및 GitHub텍스트 편집기 설치, 분기 만들기, 커밋 만들기, 푸시 GitHub, 끌어오기 요청 열기 등의 기본 사항을 소개합니다. 아직 GitHub Desktop에 리포지토리가 없는 경우 이 자습서를 사용할 수 있습니다.

자습서를 완료하는 것을 권장하지만, 새 리포지토리를 만들어 GitHub Desktop를 탐색하려는 경우 이 가이드에서는 Git 리포지토리에서 작업할 때 GitHub Desktop를 사용하는 방법을 안내합니다.

## 1부: 계정 설치 GitHub Desktop 및 인증

지원되는 모든 운영 체제에 GitHub Desktop를 설치할 수 있습니다. 앱을 설치한 후에는 자습서 리포지토리를 만들고 복제하기 전에 로그인하고 계정을 GitHubGitHub Enterprise 인증해야 합니다.

설치 및 인증에 대한 자세한 내용은 [GitHub Desktop 설정](/ko/desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop)을(를) 참조하세요.

## 2부: 새 리포지토리 만들기

연결된 GitHub Desktop리포지토리가 없는 경우 "시작해 보겠습니다!"가 표시됩니다. 자습서 리포지토리를 만들고 복제하거나, 인터넷에서 기존 리포지토리를 복제하거나, 새 리포지토리를 만들거나, 하드 드라이브에서 기존 리포지토리를 추가하도록 선택할 수 있습니다.

!["이제 시작하겠습니다!" 스크린샷 GitHub Desktop에서 보기.](/assets/images/help/desktop/lets-get-started.png)

### 자습서 리포지토리 만들기 및 복제

GitHub Desktop 사용을 연습하기 위한 첫 번째 프로젝트로 튜토리얼 리포지토리를 만들고 복제하는 것을 권장합니다.

1. **자습서 리포지토리 만들기**를 클릭합니다.
2. 자습서의 안내에 따라 텍스트 편집기를 설치하고, 브랜치를 만들고, 파일을 편집하고, 커밋하고, GitHub에 게시한 다음 풀 리퀘스트를 여세요.

### 새 리포지토리 만들기

자습서 리포지토리를 만들고 복제하는 것을 원하지 않는 경우 새 리포지토리를 만들 수 있습니다.

1. **하드 드라이브에서 새 리포지토리 만들기**를 클릭합니다.
2. "새 리포지토리 만들기" 창에서 필드를 입력하고 원하는 옵션을 선택합니다.
   * "이름"은 로컬과 GitHub 모두에서 리포지토리 이름을 정의합니다.
   * “설명”은 리포지토리의 용도에 대한 자세한 정보를 제공하는 데 사용할 수 있는 선택적 필드입니다.
   * “로컬 경로”는 컴퓨터에서 리포지토리의 위치를 설정합니다. 기본적으로 GitHub Desktop 문서 폴더 내에 *GitHub* 폴더를 만들어 리포지토리 \_\_ 를 저장하지만 컴퓨터의 모든 위치를 선택할 수 있습니다. 새 리포지토리는 선택한 위치 내의 폴더가 됩니다. 예를 들어 리포지토리의 이름을 `Tutorial`로 지정하면 로컬 경로에 선택한 폴더 내에 \_Tutorial\_이라는 폴더가 생성됩니다.
     GitHub Desktop 는 다음에 새 리포지토리를 만들거나 복제할 때 선택한 위치를 기억합니다.
   * **README를 사용하여 이 리포지토리를 초기화**하면 *README.md* 파일을 사용하여 초기 커밋이 생성됩니다. README는 사람들이 프로젝트의 목적을 이해하는 데 도움이 되므로 README를 선택하고 유용한 정보를 입력하는 것이 좋습니다. 누군가가 GitHub에서 리포지토리를 방문하면, README는 그들이 프로젝트에 대해 알아볼 때 가장 먼저 보게 되는 항목입니다. 자세한 내용은 [리포지토리 README 파일에 관하여](/ko/enterprise-server@3.22/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)을(를) 참조하세요.
   * **Git 무시** 드롭다운 메뉴를 사용하면 버전 제어에 저장하지 않으려는 로컬 리포지토리의 특정 파일을 무시하는 사용자 지정 파일을 추가할 수 있습니다. 사용할 특정 언어 또는 프레임워크가 있는 경우 사용 가능한 목록에서 옵션을 선택할 수 있습니다. 이제 막 시작하는 경우 이 선택을 건너뛸 수 있습니다. 자세한 내용은 [Ignoring files(파일 무시)](/ko/enterprise-server@3.22/get-started/git-basics/ignoring-files)을(를) 참조하세요.
   * **라이선스** 드롭다운 메뉴를 사용하면 리포지토리의 LICENSE 파일에 오픈 소스 라이선스를 추가할 수 있습니다. 라이선스를 바로 추가하는 것에 대해 걱정할 필요가 없습니다. 사용 가능한 오픈 소스 라이선스 및 리포지토리에 라이선스를 추가하는 방법에 대한 자세한 내용은 [리포지토리 라이선싱](/ko/enterprise-server@3.22/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository)을(를) 참조하세요.
3. **Create repository**(리포지토리 만들기)를 클릭합니다.

## 3부: 탐색 GitHub Desktop

화면 상단의 파일 메뉴에서 GitHub Desktop에서 수행할 수 있는 설정과 작업에 액세스할 수 있습니다. 대부분의 작업에는 보다 효율적으로 작업하는 데 도움이 되는 바로 가기 키가 있습니다. 바로 가기 키의 전체 목록은 [GitHub Desktop 바로 가기 키](/ko/desktop/overview/github-desktop-keyboard-shortcuts)을(를) 참조하세요.

### GitHub Desktop 리포지토리 막대

앱 맨 위에 GitHub Desktop 리포지토리의 현재 상태를 보여 주는 막대가 표시됩니다.

![GitHub Desktop 앱의 스크린샷입니다. "hello-world" 리포지토리에 대한 세부 정보를 표시하는 모음이 창의 위쪽에 걸쳐 있으며 주황색 윤곽선으로 표시됩니다.](/assets/images/help/desktop/explore-github-desktop.png)

* **현재 리포지토리** 에는 작업 중인 리포지토리의 이름이 표시됩니다.
  **현재 리포지토리**를 클릭하여 .에서 다른 리포지토리로 전환할 수 있습니다GitHub Desktop.
* **현재 분기**는 작업 중인 분기의 이름을 표시합니다.
  **현재 분기**를 클릭하여 리포지토리의 모든 분기를 보거나, 다른 분기로 전환하거나, 새 분기를 만들 수 있습니다. 리포지토리에서 끌어오기 요청을 만든 후에는 **현재 분기**를 클릭하여 요청을 볼 수도 있습니다.
* **리포지토리 게시**가 표시되는 이유는 아직 리포지토리를 GitHub에 게시하지 않았기 때문이며, 이는 다음 단계에서 나중에 수행하게 됩니다. 표시줄의 이 섹션은 현재 분기 및 리포지토리의 상태에 따라 변경됩니다. 로컬 리포지토리와 원격 리포지토리 간에 데이터를 교환할 수 있는 다양한 컨텍스트 종속 작업을 사용할 수 있습니다.

### 변경 내용 및 기록

왼쪽 사이드바에서 **변경 내용** 및 **기록** 보기를 찾을 수 있습니다.

![GitHub Desktop 앱의 스크린샷입니다. 왼쪽의 사이드바에는 "Changes" 및 "History"라는 레이블이 지정된 탭이 주황색 윤곽선으로 표시됩니다.](/assets/images/help/desktop/changes-and-history.png)

* **변경 내용** 보기에는 현재 분기의 파일에 적용되었지만 로컬 리포지토리에 커밋되지 않은 변경 내용이 표시됩니다. 하단에는 "요약" 및 "설명" 텍스트 상자가 있는 상자와 **Commit to BRANCH** 버튼이 있습니다. 여기서 새 변경 내용을 커밋합니다.
  **BRANCH에 커밋** 버튼은 동적이며, 변경 사항을 커밋할 브랜치를 표시합니다.
* **기록** 보기에는 리포지토리의 현재 분기에 대한 이전 커밋이 표시됩니다. 리포지토리를 만들 때 만든 GitHub Desktop "초기 커밋"이 표시됩니다. 커밋 오른쪽에 리포지토리를 만들 때 선택한 옵션에 따라 *.gitattributes*, *.gitignore*, LICENSE 또는 README 파일이 표시됩니다. 각 파일을 클릭하여 해당 커밋의 파일에 대한 변경 내용인 해당 파일에 대한 diff를 볼 수 있습니다. diff는 파일의 전체 내용이 아니라 파일의 변경된 부분만 표시합니다.

## 4부: 내 리포지토리 게시하기 GitHub

새 리포지토리를 만들면 해당 리포지토리는 사용자의 컴퓨터에만 존재하며 해당 사용자만이 이 리포지토리에 액세스할 수 있습니다. 리포지토리를 게시하여 GitHub 여러 컴퓨터에서 동기화된 상태로 유지하고 다른 사용자가 액세스할 수 있도록 할 수 있습니다. 리포지토리를 게시하려면 로컬 변경 내용을 .에 푸시합니다 GitHub.

1. 리포지토리 막대에서 **리포지토리 게시**를 클릭합니다.

![리포지토리 표시줄의 스크린샷입니다. "리포지토리 게시"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/publish-repository.png)

1. "리포지토리 게시" 창에서 새 리포지토리에 대한 세부 정보를 입력합니다.
   * GitHub Desktop 는 리포지토리를 만들 때 입력한 정보로 "이름" 및 "설명" 필드를 자동으로 채웁니다.
   * **이 코드를 비공개로 유지**하면 프로젝트를 볼 수 있는 사용자를 제어할 수 있습니다. 이 옵션을 선택하지 않은 상태로 두면 다른 사용자가 GitHub 코드를 볼 수 있습니다. 이 옵션을 선택하면 코드가 공개되지 않습니다.
   * **조직** 드롭다운 메뉴가 있는 경우 리포지토리를 사용자가 속한 특정 조직에 게시할 GitHub수 있습니다.
   1. **리포지토리 게시**를 클릭합니다.
   2. GitHub 내에서 GitHub Desktop의 리포지토리에 접근할 수 있습니다. 파일 메뉴에서 **리포지토리**를 클릭한 다음 **GitHub에서 보기**를 클릭합니다. 이렇게 하면 기본 브라우저의 리포지토리로 바로 이동합니다.

## 5부: 변경 사항 생성, 커밋하기, 푸시하기

이제 리포지토리를 만들고 게시했으므로 이번에는 프로젝트를 변경하고 리포지토리에 대한 첫 번째 커밋 만들기를 시작해 보겠습니다.

1. 내부에서 GitHub Desktop외부 편집기를 시작하려면 "GitHub Desktop" 메뉴 모음에서 **리포지토리**를 선택한 다음 **편집기에서 열기**를 클릭합니다. 자세한 내용은 [GitHub Desktop에서 기본 편집기 구성하기](/ko/desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop)을(를) 참조하세요.

![Mac의 메뉴 모음 스크린샷입니다. 열려 있는 "리포지토리" 드롭다운 메뉴에서 커서가 파란색으로 강조 표시된 "Visual Studio Code에서 열기" 위로 이동합니다. ](/assets/images/help/desktop/open-in-editor.png)

1. 이전에 만든 *README.md* 파일을 약간 변경합니다. 프로젝트를 설명하는 정보(예: 역할 및 기능)를 추가할 수 있습니다. 변경 내용에 만족하면 텍스트 편집기에서 저장합니다.
2. 에서 GitHub Desktop**변경 내용** 보기로 이동합니다. 파일 목록에 \_README.md\_가 표시됩니다.
   *README.md* 파일 왼쪽에 있는 확인란은 파일에 대한 변경 내용이 커밋의 일부임을 나타냅니다. 나중에 여러 파일을 변경할 수 있지만 일부 파일에 대해 변경한 내용만 커밋하려고 합니다. 파일 옆에 있는 확인란에 표시를 클릭하면 해당 파일이 커밋에 포함되지 않습니다.

![사이드바의 "변경 내용" 탭 스크린샷입니다. "README.md" 파일의 왼쪽에는 선택한 확인란이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/viewing-changes.png)

1. **변경 내용** 목록 하단에 커밋 메시지를 입력합니다. 프로필 사진 오른쪽에 커밋에 대한 간단한 설명을 입력합니다.
   *README.md* 파일을 변경하기 때문에 “프로젝트의 목적에 대한 정보 추가”는 좋은 커밋 요약이 될 것입니다. 요약에는 커밋의 변경 내용에 대한 더 긴 설명을 입력할 수 있는 “설명” 텍스트 필드가 표시됩니다. 이를 통해 프로젝트 기록을 되돌아보고 변경된 이유를 이해할 수 있습니다.
   *README.md* 파일의 기본적인 업데이트를 하고 있으므로 설명을 건너뛸 수 있습니다.

![사이드바의 "변경 내용" 탭 스크린샷입니다. 프로필 사진 오른쪽에는 커밋 메시지가 포함된 텍스트 필드가 주황색으로 표시됩니다.](/assets/images/help/desktop/commit-message.png)

1. 커밋 메시지 아래에서 **분기 이름에 커밋**을 클릭합니다. 커밋 단추에는 현재 분기가 표시되므로 원하는 분기에 커밋해야 합니다.
2. GitHub의 원격 저장소에 변경 사항을 푸시하려면 **Push origin**을 클릭하세요.

![‘리포포지토리’ 메뉴 모음의 스크린샷. "원본 푸시"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/push-to-origin.png)

* **원본 푸시** 버튼은 리포지토리를 GitHub에 게시하기 위해 클릭한 것과 동일합니다. 이 단추는 Git 워크플로에서의 위치에 따라 상황별로 변경됩니다. 이제 `Push origin`라고 표시되고 그 옆에 `1`가 함께 표시되어, GitHub에 아직 푸시되지 않은 커밋이 1개 있음을 나타내야 합니다.
* **Push origin**에서 "origin"은 변경 사항을 `origin`라는 원격 저장소로 푸시한다는 뜻이며, 이 경우 그 원격 저장소는 GitHub에 있는 프로젝트의 저장소입니다. 새 커밋을 GitHub에 푸시하기 전까지는 컴퓨터에 있는 프로젝트 리포지토리와 GitHub에 있는 프로젝트 리포지토리 사이에 차이가 있습니다. 이렇게 하면 로컬에서 작업하고 준비가 되었을 때만 변경 사항을 GitHub에 푸시할 수 있습니다.

1. **변경 내용** 보기 오른쪽 창에 다음에 수행할 수 있는 작업에 대한 제안이 표시됩니다. 브라우저에서 GitHub의 리포지토리를 열려면 **GitHub에서 보기**를 클릭합니다.

!["로컬 변경 내용 없음" 화면의 스크린샷입니다. 제안 목록에서 "GitHub에서 보기"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/available-actions.png)

1. 브라우저에서 **2개의 커밋**을 클릭합니다. 이 리포지토리에 커밋 목록이 표시됩니다 GitHub. 첫 번째 커밋은 방금 만든 GitHub Desktop커밋이어야 합니다.

![GitHub의 리포지터리 페이지 스크린샷. 파일 목록 위와 시계 아이콘 옆에는 "커밋 2개"라는 레이블이 지정된 링크가 주황색으로 표시됩니다.](/assets/images/help/desktop/click-two-commits.png)

## 결론

이제 리포지토리를 만들고, 리포지토리를 게시하고 GitHub, 커밋하고, 변경 내용을 GitHub푸시했습니다. 만들거나 협업하는 다른 프로젝트에 참여할 때 이 워크플로를 따를 수 있습니다.

## 추가 참고 자료

* [Git 기본 사항](/ko/enterprise-server@3.22/get-started/git-basics)
* [GitHub 대해 알아보기](/ko/enterprise-server@3.22/get-started/learning-about-github)
* [GitHub 설명서 시작하기](/ko/enterprise-server@3.22/get-started)