4장. 클릭 한 번으로 저장소 만들기 — GitHub Desktop 설치와 첫 저장소

2026년 3월 15일 일요일 저녁, 김진관 선생님은 교원 연수를 다녀온 뒤 집 책상 앞에 앉았습니다. 연수에서 만든 GitHub 계정을 실제로 써보려고 유튜브를 켰습니다. 검색창에 "Git 사용법"을 치자 영상 섬네일이 줄줄이 떴습니다. 재생 버튼을 누를 때마다 화면에는 까만 터미널 창이 떠 있었고, 강사들은 알 수 없는 영어 명령어를 빠르게 두드렸습니다. git add .과 git commit -m "..."이 지나갈 때 김진관 선생님의 손이 멈췄습니다. "이걸 전부 외워야 한다고?" 포기할 뻔한 순간, 영상 댓글 하나가 눈에 들어왔습니다. "GitHub Desktop 쓰세요. 버튼만 누르면 됩니다." 검색창에 다시 GitHub Desktop을 쳤습니다.

GitHub Desktop은 Git의 모든 명령어를 버튼으로 바꿔줍니다.

이 챕터를 마치면 다음 네 가지를 할 수 있습니다.

GitHub Desktop을 내 컴퓨터에 설치하고 3장에서 만든 GitHub 계정으로 로그인할 수 있습니다
GitHub Desktop 화면의 세 영역(저장소 선택, Changes·History 탭, Commit 입력창)을 구분할 수 있습니다
내 컴퓨터의 평범한 폴더를 Git 저장소로 바꿀 수 있습니다
class-2b 프로젝트 폴더를 GitHub Desktop에 등록하고 "Let's get started" 환영 화면을 직접 확인할 수 있습니다

(1) GitHub Desktop 설치 — 앱스토어에서 카카오톡 까는 것과 같은 방식

스마트폰에서 카카오톡을 깔 때 우리는 문법이나 명령어를 배우지 않습니다. 앱스토어에서 설치 버튼을 누르고 로그인하면 그만입니다. GitHub Desktop 설치는 완전히 같은 흐름입니다. 김진관 선생님은 웹사이트에 접속해 설치 파일을 받고, 실행하고, GitHub 계정으로 로그인만 하면 끝입니다. 외울 명령어는 하나도 없습니다.

단계별로 따라갑니다. (1) 크롬 또는 엣지 브라우저를 열고 주소창에 desktop.github.com을 입력합니다. (2) 화면 가운데 보라색 Download for Windows 버튼(Mac 사용자는 Download for macOS 버튼)을 클릭합니다. (3) 다운로드 폴더에 생긴 GitHubDesktopSetup-x64.exe 파일을 더블클릭합니다. Mac 사용자는 .zip 파일의 압축을 풀고 안에 들어 있는 GitHub Desktop.app을 응용 프로그램 폴더로 끌어다 놓습니다. (4) 설치는 1~2분 안에 자동으로 끝나고 앱이 혼자 켜집니다. (5) 앱 중앙의 Sign in to GitHub.com 버튼을 누르면 브라우저가 열리고 GitHub 로그인 페이지로 이동합니다. (6) 3장에서 만든 아이디와 비밀번호를 입력한 뒤 초록색 Authorize desktop 버튼을 누릅니다.

로그인이 끝나면 "Let's get started with GitHub Desktop"이라는 환영 화면이 뜹니다. 이 화면이 뜨면 선생님도 설치가 완료된 것입니다. 이게 전부입니다. 이 화면이 김진관 선생님의 첫 번째 Quick Win입니다. 설치가 끝났다는 공식 신호이자, 이 책 전체에서 계속 보게 될 홈 화면입니다.

잘 안 되면?

로그인 후 Authorization failed 메시지가 뜨는 경우: 2단계 인증(2FA)이 걸려 있을 확률이 높습니다. 브라우저에서 github.com에 먼저 로그인한 상태를 만든 뒤 다시 Sign in to GitHub.com을 누릅니다.

설치 파일이 다운로드되지 않는 경우: 학교 네트워크의 보안 정책이 원인입니다. 개인 와이파이나 핸드폰 핫스팟에서 다시 받습니다.

Mac에서 "확인되지 않은 개발자" 경고가 뜨는 경우: 시스템 설정 > 개인 정보 보호 및 보안 > 하단 확인 없이 열기 버튼을 클릭합니다.

(2) 화면 구성 3영역 — 운전석 계기판처럼 한눈에 보기

이 절에서 GitHub Desktop 화면을 구성하는 세 영역의 이름과 위치를 확인할 수 있습니다.

자동차 운전석 계기판은 속도·연료·방향을 한눈에 보여주는 세 영역으로 구성됩니다. GitHub Desktop 화면도 똑같이 세 영역입니다. 김진관 선생님이 이 세 곳만 구분하면 앞으로 나오는 모든 기능을 바로 찾을 수 있습니다.

(1) 왼쪽 상단은 저장소 선택 영역입니다. "Current Repository"라는 라벨 아래 현재 열려 있는 프로젝트 이름이 표시됩니다. 여러 프로젝트를 오갈 때 이 라벨을 클릭해 목록에서 고릅니다. 옆에는 "Current Branch" 라벨이 있는데, 이 자리가 브랜치 전환 지점입니다(6장에서 다룹니다). (2) 중간 영역에는 Changes 탭과 History 탭이 있습니다. Changes 탭은 지금 수정한 파일 목록을 보여줍니다. 어떤 파일이든 한 글자라도 고치면 즉시 빨간색·초록색 줄과 함께 파일명이 이곳에 뜹니다. History 탭은 과거에 찍어둔 커밋 기록을 시간순으로 보여줍니다. (3) 왼쪽 하단은 Commit 입력창입니다. "Summary (required)"와 "Description"이라는 두 개의 빈 칸과 파란색 Commit to main 버튼이 있습니다. 이 버튼이 1장에서 배운 "사진 찍기"의 실제 손잡이입니다. Summary가 비어 있으면 버튼은 회색이고, 요약을 한 글자라도 적으면 파란색으로 살아납니다.

이 세 영역의 이름과 위치만 외워두면 이후 챕터의 모든 실습이 이 그림 안에서 벌어집니다. 이게 전부입니다.

잘 안 되면?

Changes 탭에 아무 파일도 뜨지 않는 경우: 아직 저장소에 어떤 변경도 없기 때문입니다. 저장소 폴더에 아무 텍스트 파일이나 하나 넣고 저장하면 즉시 나타납니다.

"Current Repository" 라벨이 회색으로 비어 있는 경우: 아직 등록된 저장소가 없는 상태입니다. 아래 (3)번 실습으로 첫 저장소를 만들면 채워집니다.

(3) 첫 저장소 만들기 — 빈 공책에 "2B반 수업 기록" 표지 붙이기

이 절에서 내 컴퓨터의 평범한 폴더를 Git 저장소로 등록하는 과정을 직접 확인할 수 있습니다.

책상 위 빈 공책은 그 자체로는 아무것도 아닙니다. 표지에 "2B반 수업 기록"이라고 적는 순간 하나의 "책"이 됩니다. Git 저장소도 마찬가지입니다. 내 컴퓨터의 평범한 폴더 하나를 골라서 "이제부터 여기는 Git 저장소다"라고 알려주면, 그 폴더는 변경 기록을 추적하는 저장소로 변신합니다. GitHub Desktop에서는 이 변신이 버튼 두 번 클릭입니다.

실습 순서는 다음과 같습니다. (1) 바탕화면에 class-2b라는 새 폴더를 만듭니다. 이 폴더가 앞으로 2학년 B반 학급 웹사이트 프로젝트의 집이 됩니다. 폴더 안에 메모장을 열어 안녕하세요 2학년 B반입니다 한 줄을 적고 index.html로 저장합니다. (2) GitHub Desktop 상단 메뉴에서 File > Add Local Repository를 클릭합니다. (3) 열린 창의 Choose 버튼을 눌러 방금 만든 class-2b 폴더를 선택하고 Add Repository를 누릅니다. (4) "This directory does not appear to be a Git repository"라는 안내 문구가 빨간 글씨로 나타납니다. 놀라지 않으셔도 됩니다. 이 문구 안의 파란 create a repository 링크를 클릭합니다. (5) "Create a New Repository" 창이 뜹니다. Name은 class-2b로 자동 입력되어 있고, 그 아래 Initialize this repository with a README에 체크합니다. (6) 하단의 파란색 Create Repository 버튼을 누릅니다.

왼쪽 상단 "Current Repository" 라벨에 class-2b가 나타나고, 폴더 안에는 눈에 보이지 않는 .git이라는 관리 폴더가 자동으로 생성됩니다. 김진관 선생님의 컴퓨터에 첫 번째 Git 저장소가 태어났습니다. 이게 전부입니다.

잘 안 되면?

Add Local Repository 후 "This directory does not appear..." 문구가 나타나지 않는 경우: 선택한 폴더가 이미 Git 저장소이거나 상위 폴더가 저장소일 가능성이 높습니다. 바탕화면에 완전히 새 폴더를 만들어 다시 시도합니다.

Create Repository 버튼이 회색으로 눌리지 않는 경우: Name 칸이 비어 있거나 공백·특수문자가 섞여 있습니다. 영문 소문자와 하이픈만 사용합니다. class-2b는 통과됩니다.

저장소를 만들었는데 왼쪽 상단에 이름이 보이지 않는 경우: 상단 Current Repository 라벨을 클릭하면 목록이 펼쳐집니다. 목록에서 class-2b를 고르면 됩니다.

핵심 3줄 요약

GitHub Desktop은 터미널 명령어를 버튼으로 바꿔주는 공식 앱이므로 외울 문법이 없습니다.
화면은 저장소 선택(왼쪽 상단), Changes·History 탭(중간), Commit 입력창(왼쪽 하단) 세 영역으로 나뉩니다.
평범한 폴더를 저장소로 만들려면 File > Add Local Repository > create a repository 링크 클릭 한 번이면 끝납니다.

완료 체크리스트

desktop.github.com에서 설치 파일을 받아 GitHub Desktop을 설치할 수 있다
3장에서 만든 GitHub 계정으로 로그인해 "Let's get started" 환영 화면을 띄울 수 있다
화면의 세 영역(저장소 선택, Changes·History, Commit 입력창)을 손가락으로 짚으며 이름을 말할 수 있다
바탕화면에 class-2b 폴더를 만들고 GitHub Desktop에 Git 저장소로 등록할 수 있다

다음 챕터 예고

다음 5장에서 이 class-2b 저장소에 첫 번째 커밋을 찍고 GitHub에 푸시해 세상 어디서든 열리는 주소를 손에 넣습니다.