GitHub Desktop

어떤 사용자에게 맞는가

Git 명령어를 외우기보다 변경 파일과 이력을 눈으로 확인하려는 개발자, 문서 담당자, Git 입문자에게 적합하다. GitHub 외의 Git 호스팅 서비스에 있는 파일도 다룰 수 있지만, 계정 인증과 풀 리퀘스트 연동은 GitHub 중심이다.

코드 편집은 Visual Studio Code 같은 별도 편집기에서 하고, Desktop으로 돌아와 변경을 검토하고 기록하는 방식이 기본 작업 흐름이다. 편집기와 버전 관리 화면을 나누어 쓰고 싶은 사용자에게 선택 기준이 된다.

변경 검토와 이력 관리

Changes에서 추가·수정·삭제된 파일을 확인하고, Unified 또는 Split 비교 화면으로 이전 내용과 새 내용을 대조한다. 공백 변경을 숨기거나 주변 문맥을 펼쳐 실제 수정 의도를 검토할 수 있다.

한 파일에 여러 작업이 섞였을 때는 변경된 줄을 골라 부분 커밋을 만든다. 커밋 공동 작성자를 표시할 수도 있다. 브랜치를 바꾸기 전 미완성 작업은 stash로 보관하며, 이력 정리 기능으로 다른 브랜치의 커밋을 가져오거나 여러 커밋을 합칠 수 있다.

macOS 설치와 첫 작업 순서

공식 홈페이지에서 Mac에 맞는 다운로드 항목을 선택하고 ZIP 압축을 푼 뒤 앱을 실행한다. GitHub 저장소와 연결하려면 Settings의 Accounts에서 해당 계정으로 로그인하고, Git 작성자 정보와 기본 편집기를 확인한다.

File의 Clone Repository로 작업할 저장소와 로컬 경로를 선택한다. 기존 프로젝트는 Add Local Repository로 추가할 수 있다. Current Branch에서 작업 브랜치를 만든 뒤 편집기로 파일을 수정하고, Changes에서 포함할 파일·줄을 검토한다. 설명을 입력해 로컬 커밋을 만든 다음 원격 공유가 필요할 때 Push origin 또는 Publish branch를 사용한다. 로컬 커밋과 원격 전송은 별도 단계다.

실무 예시: 문서 수정과 코드 변경 분리

팀 프로젝트에서 README의 설치 안내를 고치면서 코드의 오류도 함께 수정했다고 가정하자. 문서 파일만 선택해 ‘설치 안내 보완’ 커밋을 만들고, 코드 변경은 별도 커밋으로 기록하면 검토자가 목적별로 확인하기 쉽다.

같은 파일에 두 수정이 섞였으면 줄 선택 기능으로 나눌 수 있다. 작업 브랜치를 원격에 공유하고 풀 리퀘스트로 검토를 요청하는 흐름으로 이어진다. 이는 공식 기능을 적용한 작업 예시이며 설치·사용 체험을 뜻하지 않는다.

무료 사용과 협업 제약

공식 문서는 Desktop 자체를 무료 오픈 소스 앱으로 소개한다. 일반 Git 작업을 위한 별도 Desktop 유료판 구매 조건은 확인되지 않았다. 다만 연결하는 호스팅 서비스나 추가 서비스의 요금까지 무료라는 뜻은 아니다.

저장소 읽기 권한으로 로컬 브랜치를 만들 수 있어도 원격 전송에는 쓰기 권한이 필요하다. 브랜치 보호와 ruleset은 브랜치 이름, 커밋 형식, 게시 작업 등을 제한할 수 있다. Copilot 커밋 메시지 생성은 Copilot 접근 권한이 있을 때 사용하는 선택 기능이다.

문제가 생겼을 때 확인 순서

작업이 막히면 먼저 오류 문구, 선택한 저장소와 브랜치, 로그인 계정을 확인한다. 커밋이나 전송이 제한되면 쓰기 권한과 저장소 규칙을 살핀다. 작성자가 잘못 표시되면 Git 설정의 이메일을 확인한다.

Mac에서 로그인 후 사용자명·암호 오류가 나오면 공식 문서는 Keychain 접근 문제를 확인하도록 안내한다. Keychain Access에서 login 키체인을 잠갔다가 해제하고 다시 인증하는 순서다. 업데이트 중 임시 디렉터리 권한 오류가 나오면 앱을 종료하고 ~/Library/Caches/com.github.GitHubClient.ShipIt 폴더의 사용자 권한이 Read & Write인지 확인한다.

지원 OS와 다른 도구 선택 기준

공식 지원 문서는 macOS 12 이상과 Windows 10 64비트 이상을 명시하며 Linux는 공식 지원하지 않는다. 다만 최근 공식 배포 이력에는 macOS 12 지원 제거가 기록되어 있어, 최신 빌드 설치 전 배포 조건을 다시 확인해야 한다. 제품 전체의 지원 종료는 확인되지 않았다.

화면으로 파일과 줄을 검토하는 일상 작업은 Desktop이 후보가 된다. 명령을 스크립트로 반복하거나 세밀한 Git 조작이 필요하면 명령줄 Git을 함께 사용하는 편이 적합하다. 편집 중 버전 관리까지 한 화면에서 처리하고 싶다면 편집기의 Git 통합 기능과 작업 동선을 비교해 선택한다.

공식 안내

• GitHub Desktop | Simple collaboration from your desktop · 확인 2026-10-09
• About GitHub Desktop · 확인 2026-10-09
• Supported operating systems for GitHub Desktop · 확인 2026-10-09
• Installing GitHub Desktop · 확인 2026-10-09
• Getting started with GitHub Desktop · 확인 2026-10-09
• Committing and reviewing changes to your project in GitHub Desktop · 확인 2026-10-09
• Managing branches in GitHub Desktop · 확인 2026-10-09
• Releases · desktop/desktop · 확인 2026-10-09