깃허브를 쓰고 싶은데 터미널에 git push 같은 명령어를 치는 게 부담스러운 분들 많습니다. 깃허브 데스크탑(GitHub Desktop)을 쓰면 마우스 클릭만으로 동일한 작업을 할 수 있어요.
설치부터 실제 커밋·푸시까지 한 번에 따라해보세요.
GitHub Desktop이 뭔가요?
GitHub에서 공식으로 만든 GUI(그래픽 인터페이스) 앱입니다. 터미널 대신 화면에서 버튼을 눌러 Git 작업을 합니다.
| 작업 | 터미널 방식 | Desktop 방식 |
|---|---|---|
| 변경 파일 확인 | git status |
Changes 탭에서 목록 확인 |
| 커밋 | git add . && git commit -m "메시지" |
메시지 입력 → “Commit” 버튼 |
| 푸시 | git push origin main |
“Push origin” 버튼 |
| 브랜치 생성 | git checkout -b 이름 |
Branch → New Branch |
| 저장소 복제 | git clone URL |
File → Clone Repository |
기능적으로 터미널과 동일합니다. 고급 기능(rebase, cherry-pick 등)만 약간 제한되지만, 일상적인 작업은 100% 가능해요.
설치하기 — Windows / Mac
Windows
- desktop.github.com 접속
- “Download for Windows” 클릭
- 다운로드된 설치 파일(.exe) 실행
- 설치 완료 후 자동 실행됨
Mac
- 같은 페이지에서 “Download for macOS” 클릭
- .dmg 파일 열기 → Applications 폴더로 드래그
- 실행 시 보안 경고 나오면 “열기” 허용
요구 사양: Windows 10 이상 / macOS 10.15 이상. 사양이 낮아도 가볍게 돌아갑니다.
초기 설정 — GitHub 계정 연결
- 앱 실행 후 “Sign in to GitHub.com” 클릭
- 브라우저가 열림 → GitHub 로그인 → “Authorize” 클릭
- 이름·이메일 확인 → “Finish” 클릭
이메일은 커밋 기록에 남는 정보입니다. 개인 이메일이 노출되기 싫으면 GitHub 설정에서 제공하는 “noreply” 주소를 사용할 수 있어요.
실전 사용 — 4가지 기본 작업
1. 기존 저장소 가져오기 (Clone)
- File → Clone Repository
- “GitHub.com” 탭에서 내 저장소 목록이 보임
- 원하는 저장소 선택 → Local Path(저장 위치) 지정 → Clone
이제 내 PC에 저장소 폴더가 생깁니다. 이 폴더 안에서 파일을 수정하면 Desktop 앱이 자동으로 변경 사항을 감지해요.
2. 파일 수정 후 커밋하기
- 저장소 폴더에서 파일을 편집/추가/삭제
- Desktop 앱으로 돌아오면 “Changes” 탭에 변경된 파일이 보임
- 좌측 하단에 커밋 메시지 입력 (예: “README에 프로젝트 설명 추가”)
- “Commit to main” 버튼 클릭
팁: 변경된 파일 중 일부만 커밋하고 싶으면 체크박스를 해제하면 됩니다. 선택한 파일만 커밋에 포함돼요.
3. GitHub에 올리기 (Push)
커밋은 내 PC에만 기록된 상태입니다. GitHub 서버에 올리려면:
- 상단 “Push origin” 버튼 클릭 (숫자가 표시됨 — 아직 안 올린 커밋 수)
- 완료 — GitHub 웹에서 반영된 걸 확인할 수 있음
4. 다른 사람 변경사항 가져오기 (Pull/Fetch)
팀 작업 중 다른 사람이 올린 변경사항을 내 PC에 반영하려면:
- 상단 “Fetch origin” 클릭 — 서버에 새 변경이 있는지 확인
- 새 변경이 있으면 “Pull origin” 버튼이 나타남 → 클릭
브랜치 사용하기 — 안전하게 수정
원본(main)을 직접 수정하면 실수했을 때 복구가 번거롭습니다. 브랜치를 만들면 별도 공간에서 작업하고, 확인 후에 원본에 합칠 수 있어요.
- 상단 “Current Branch” 클릭 → “New Branch”
- 브랜치 이름 입력 (예: feature/add-readme) → Create
- 이 브랜치에서 파일 수정 → 커밋 → 푸시
- 준비되면 “Create Pull Request” 버튼 → GitHub 웹에서 합치기(Merge)
자주 겪는 문제
| 문제 | 원인 | 해결 |
|---|---|---|
| “Push” 안 됨, 권한 오류 | 다른 사람의 저장소에 직접 push 시도 | Fork → 내 저장소에서 작업 → PR 보내기 |
| 충돌(Conflict) 발생 | 같은 파일을 동시에 수정 | Desktop에서 충돌 파일 열기 → 직접 수정 → 커밋 |
| Clone 시 “access denied” | Private 저장소 권한 없음 | 저장소 소유자에게 초대 요청 |
| 변경사항이 안 보임 | 저장소 폴더 밖에서 작업 | Clone한 정확한 폴더 안에서 편집했는지 확인 |
VS Code와 함께 쓰기
GitHub Desktop은 VS Code와 연동이 잘 됩니다.
- Desktop에서 저장소 우클릭 → “Open in Visual Studio Code”
- VS Code에서 파일 편집 → 저장
- Desktop으로 돌아오면 변경사항 자동 감지 → 커밋·푸시
VS Code 내장 Git 기능을 써도 되지만, 초보자는 Desktop의 시각적 인터페이스가 더 직관적입니다.
정리
- GitHub Desktop = 터미널 대신 클릭으로 Git 작업하는 공식 앱
- 설치: desktop.github.com에서 다운로드, GitHub 계정 연결
- 기본 흐름: Clone → 파일 수정 → Commit → Push
- 브랜치로 안전하게 작업 → PR로 합치기
- VS Code와 연동하면 편집+버전관리가 한 세트로
이 글은 2026년 7월 기준으로 작성되었습니다.
같은 주제 글 보기
- 깃허브 사용법, 코딩 모르는 사람도 이해하는 입문 설명
- 깃허브 코파일럿 사용법, AI가 코드 써주는 건 어디까지 되나
- 깃허브 학생 인증, 무료 Pro 받는 방법 단계별 정리
- AI 코딩 도구 비교, Cursor·Claude Code·Copilot·Windsurf·Cline