이번 장에서 준비할 것
GitHub를 배우기 전에 먼저 작업 환경을 완성해야 합니다. 환경 설정이 되어 있지 않으면 저장소를 만들고, 파일을 수정하고, 커밋하고, GitHub에 올리는 과정에서 계속 막힙니다.
이번 장의 목표는 단순합니다.
GitHub 계정을 만든다.
이메일 노출을 줄인다.
내 컴퓨터에 Git을 설치한다.
커밋 작성자 정보를 설정한다.
앞으로 사용할 작업 도구를 고른다.
여기까지 끝내면 다음 장에서 바로 첫 번째 저장소를 만들 수 있습니다.
GitHub 계정 만들기
GitHub를 사용하려면 개인 계정이 필요합니다. 처음에는 무료 개인 계정이면 충분합니다. GitHub 공식 사이트에 접속한 뒤 Sign up을 눌러 가입을 진행합니다.
가입할 때 필요한 것은 보통 세 가지입니다.
이메일 주소
사용자명
비밀번호
가입 후에는 이메일 인증을 완료해야 합니다. GitHub는 이메일 인증이 되지 않은 계정에서는 저장소 생성 같은 기본 작업이 제한될 수 있다고 안내합니다.1 인증 메일이 보이지 않으면 스팸함을 확인하고, 그래도 없다면 인증 메일을 다시 보내면 됩니다.
사용자명은 신중하게 정하세요. 사용자명은 단순한 로그인 이름이 아니라 내 GitHub 공개 주소가 됩니다.
https://github.com/사용자명예를 들어 사용자명이 minji-dev라면 내 프로필 주소는 다음과 같습니다.
https://github.com/minji-dev초보자에게 추천하는 사용자명은 기억하기 쉽고, 너무 장난스럽지 않은 이름입니다.
좋은 예시는 다음과 같습니다.
minji-dev
junho-kim
sora-code피하는 것이 좋은 예시는 다음과 같습니다.
test123456
hello-github-test
xXsuperHackerXxGitHub는 나중에 포트폴리오처럼 보일 수 있습니다. 지금 당장 개발자가 아니어도, 다른 사람이 봤을 때 알아보기 쉬운 이름을 고르는 편이 좋습니다.
기본 프로필 설정하기
계정을 만들었다면 오른쪽 위 프로필 사진을 눌러 Your profile로 이동합니다. 처음에는 비어 있어도 괜찮습니다. 다만 최소한 아래 항목은 간단히 채워두는 것을 추천합니다.
프로필 사진
한 줄 소개
블로그나 개인 사이트 링크
관심 분야
예를 들어 초보자라면 이렇게 적어도 충분합니다.
프론트엔드 개발을 배우고 있습니다.
GitHub로 프로젝트 기록을 남기는 중입니다.프로필은 멋지게 꾸미는 곳이라기보다, "이 사람이 어떤 공부와 작업을 하고 있는지" 보여주는 공간입니다. 처음부터 완벽하게 만들 필요는 없습니다. 앞으로 저장소가 쌓이면 자연스럽게 채워집니다.
이메일 비공개 설정하기
Git 커밋에는 작성자 이름과 이메일이 기록됩니다. 이 설정을 아무 생각 없이 두면 개인 이메일이 공개 저장소의 커밋 기록에 남을 수 있습니다.
따라서 GitHub를 처음 만들었다면 이메일 비공개 설정을 먼저 해두는 것이 좋습니다.
GitHub에서 다음 순서로 이동합니다.
오른쪽 위 프로필 사진 → Settings → Emails그다음 아래 항목을 켭니다.
Keep my email addresses private이 설정을 켜면 GitHub 웹에서 만드는 커밋에 실제 이메일 대신 GitHub가 제공하는 noreply 이메일을 사용할 수 있습니다.2
GitHub의 noreply 이메일은 보통 다음과 비슷한 형식입니다.3
[email protected]가능하다면 같은 화면에서 아래 설정도 함께 켜세요.
Block command line pushes that expose my email이 옵션은 명령어로 푸시할 때 개인 이메일이 노출될 가능성을 줄여줍니다. 다만 이 설정을 켠 뒤에는 로컬 Git의 user.email도 GitHub의 noreply 이메일로 맞춰야 합니다. 실제 개인 이메일로 커밋한 뒤 push하면 GitHub가 이메일 보호를 위해 push를 거절할 수 있습니다. 이 경우 아래에서 설정하는 git config --global user.email 값을 다시 확인하면 됩니다.
Git 설치하기
GitHub는 웹사이트이고, Git은 내 컴퓨터에서 변경 이력을 기록하는 프로그램입니다. 즉 GitHub를 제대로 사용하려면 내 컴퓨터에 Git이 설치되어 있어야 합니다. GitHub 공식 문서도 로컬 컴퓨터에서 GitHub 관련 작업을 하려면 Git을 설치하고 설정해야 한다고 안내합니다.4
먼저 터미널을 열고 Git이 이미 설치되어 있는지 확인합니다.
git --version아래처럼 버전이 나오면 설치되어 있는 것입니다.
git version 2.x.x버전 숫자는 사람마다 다를 수 있습니다. 숫자가 다르다고 걱정하지 않아도 됩니다.
Windows
Windows에서는 Git 공식 사이트에서 설치 파일을 내려받아 설치합니다.5
설치 중 여러 옵션이 나오는데, 처음에는 대부분 기본값으로 진행해도 괜찮습니다. 설치가 끝나면 Git Bash라는 프로그램이 함께 설치됩니다.
앞으로 Windows 사용자는 명령어 실습을 할 때 Git Bash를 사용하는 것을 추천합니다.
설치 확인:
git --version만약 git 명령어를 찾을 수 없다는 메시지가 나오면 Git이 제대로 설치되지 않았거나 PATH 연결이 안 된 것입니다. 이때는 Git을 다시 설치하거나, 설치 후 새 Git Bash 창을 열어 다시 확인하세요.
macOS
macOS에서는 터미널을 열고 먼저 확인합니다.
git --versionGit이 없다면 Xcode Command Line Tools 설치 안내가 뜰 수 있습니다. 안내에 따라 설치하면 됩니다.
Homebrew를 사용한다면 다음 명령어로 설치할 수도 있습니다.
brew install git설치 후 다시 확인합니다.
git --versionLinux
Ubuntu 계열 Linux라면 다음 명령어를 사용합니다.
sudo apt update
sudo apt install git설치 후 확인합니다.
git --versionLinux 배포판에 따라 설치 명령어는 다를 수 있습니다. 하지만 핵심은 같습니다. 설치 후 git --version이 정상 출력되면 준비가 된 것입니다.
커밋 작성자 정보 설정하기
Git은 커밋을 만들 때 "누가 이 변경을 했는지" 기록합니다. 그래서 첫 커밋 전에 이름과 이메일을 설정해야 합니다.
터미널 또는 Git Bash에서 아래 명령어를 입력합니다.
git config --global user.name "이름"
git config --global user.email "이메일"여기서 user.name은 GitHub 사용자명과 꼭 같을 필요는 없습니다. 보통은 본명, 닉네임, 영문 이름 중 하나를 씁니다.
이메일에는 앞에서 확인한 GitHub noreply 이메일을 넣는 것을 추천합니다.
예시는 다음과 같습니다.
git config --global user.name "Minji Kim"
git config --global user.email "[email protected]"설정이 잘 되었는지 확인합니다.
git config --global --list아래와 비슷하게 나오면 정상입니다.
user.name=Minji Kim
[email protected]--global은 "이 컴퓨터 전체에서 기본값으로 사용하겠다"는 뜻입니다. 초보자는 전역 설정으로 시작하면 됩니다. 나중에 회사 프로젝트와 개인 프로젝트의 이메일을 다르게 써야 할 때는 저장소별 설정을 따로 배우면 됩니다.
어떤 도구로 시작할까
GitHub를 사용하는 방법은 하나가 아닙니다. 초보자는 목적에 따라 도구를 고르면 됩니다.
터미널 또는 Git Bash
Git 명령어 흐름을 제대로 익히고 싶다면 터미널이 가장 좋습니다.
앞으로 자주 쓰게 될 명령어는 다음과 같습니다.
git status
git add README.md
git commit -m "메시지"
git push처음에는 낯설지만, Git의 원리를 이해하는 데 가장 도움이 됩니다. 특히 초보 단계에서는 git add .로 모든 파일을 한꺼번에 올리기보다, git status로 확인한 뒤 필요한 파일명을 직접 지정하는 습관이 안전합니다.
VS Code
코드 편집과 Git 조작을 함께 하고 싶다면 VS Code가 좋습니다. 파일을 수정하고, 같은 화면에서 터미널을 열어 Git 명령어를 입력할 수 있습니다.
초보자에게 가장 균형 잡힌 선택입니다.
추천 흐름은 다음과 같습니다.
VS Code에서 파일 수정 → 터미널에서 git status 확인 → add → commit → pushGitHub Desktop
명령어가 너무 부담스럽다면 GitHub Desktop으로 시작할 수 있습니다. 버튼을 눌러 변경 사항을 커밋하고 GitHub에 올릴 수 있습니다.
다만 이 책에서는 Git의 기본 흐름을 이해하기 위해 명령어도 함께 다룹니다. GitHub Desktop을 쓰더라도 commit, push, pull 같은 용어는 꼭 익혀야 합니다.
GitHub 웹 UI
간단한 README 수정이나 작은 문서 수정은 GitHub 웹사이트에서도 가능합니다. 브라우저에서 파일을 열고 바로 수정한 뒤 커밋할 수 있습니다.
하지만 실제 개발에서는 내 컴퓨터에서 수정하고 Git으로 올리는 일이 많습니다. 웹 UI는 가벼운 수정용으로 생각하면 됩니다.
실전 예시: 내 환경 점검하기
이제 실제로 준비가 끝났는지 확인해 봅시다. 아래 순서대로 체크하세요.
1단계: GitHub 로그인 확인
브라우저에서 GitHub에 접속합니다.
https://github.com오른쪽 위에 내 프로필 사진이나 아이콘이 보이면 로그인된 상태입니다.
2단계: 이메일 인증 확인
Settings → Emails등록한 이메일 옆에 인증 완료 상태가 표시되는지 확인합니다.
3단계: 이메일 비공개 확인
아래 설정이 켜져 있는지 확인합니다.
Keep my email addresses private가능하면 아래 설정도 켜둡니다.
Block command line pushes that expose my email이 설정을 켰다면 로컬 Git 이메일도 noreply 이메일인지 함께 확인합니다.
git config --global user.email4단계: Git 설치 확인
터미널 또는 Git Bash에서 실행합니다.
git --version버전이 나오면 통과입니다.
5단계: Git 전역 설정 확인
git config --global --list아래 두 줄이 있는지 확인합니다.
user.name=내 이름
user.email=내 이메일6단계: 사용할 도구 실행 확인
본인이 선택한 도구를 열어봅니다.
Windows: Git Bash
macOS/Linux: 터미널
코드 편집: VS Code
클릭 중심 작업: GitHub Desktop
여기까지 문제없이 끝났다면 다음 장으로 넘어갈 준비가 된 것입니다.
자주 생기는 문제
git 명령어를 찾을 수 없다고 나오는 경우
Git이 설치되지 않았거나, 설치 후 터미널을 새로 열지 않은 경우가 많습니다. Git을 설치한 뒤 터미널 또는 Git Bash를 완전히 닫고 다시 열어보세요.
커밋할 때 "Please tell me who you are"가 나오는 경우
Git 사용자 정보가 설정되지 않았다는 뜻입니다. 아래 명령어를 다시 입력하세요.
git config --global user.name "이름"
git config --global user.email "이메일"이메일을 잘못 입력한 경우
다시 설정하면 됩니다.
git config --global user.email "올바른 이메일"그다음 확인합니다.
git config --global user.email만약 이메일 비공개와 command line push 차단을 켜두었다면, GitHub의 noreply 이메일을 사용하는지 확인하세요.
마무리
이번 장에서는 GitHub 계정과 로컬 Git 환경을 준비했습니다. 초보자가 GitHub에서 가장 많이 막히는 지점은 저장소를 만들기 전이 아니라, 의외로 계정 인증과 Git 설정입니다.
이제 준비된 것은 네 가지입니다.
GitHub 계정
이메일 비공개 설정
Git 설치
커밋 작성자 정보 설정
다음 장에서는 이 환경을 바탕으로 첫 번째 저장소를 만들고, GitHub에 프로젝트 공간을 직접 생성해 보겠습니다.
참고
1Creating an account on GitHub
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.