개발/Git

[Git] GitHub(원격 저장소) 연결하기

firsthg 2026. 8. 19. 11:58

Step 1. GitHub CLI 설치하고 인증하기

터미널에 brew 명령어를 입력하여

brew install gh

GitHub CLI를 설치한다.

 

그리고 다음 명령어를 입력하여 깃헙 인증을 시도하고

gh auth login

 

다음과 같은 대화형 질문에 대하여 답을 한다.

 

Enter를 입력하여 브라우저 창이 뜨면 터미널창에 출력된 8 자리 인증키를 입력하여 인증을 완료한다.

 

한 번 해두면 macOS 키체인에 저장돼서 이후로는 인증을 다시 묻지 않는다.

 

Step 2. 원격 저장소 만들고 깃 프로젝트 폴더와 연결하기

gh repo create git-practice --private --source=. --remote=origin
  • --private : 비공개 저장소 (실습이므로)
  • --source=. : 현재 폴더를 대상으로
  • --remote=origin : 원격 저장소의 별칭을 origin으로 등록 (origin은 그냥 관례적인 별칭)

 

웹에서 직접 저장소를 만든 경우에는 다음과 같이 명령어를 입력하여 연결한다.

git remote add origin https://github.com/<사용자명>/git-practice.git

 

이제 다음 명령어를 입력하여 현재 폴더와 연결된 GitHub 원격 저장소를 확인해 볼 수 있다.

git remote -v

 

Step 3. 로컬 저장소의 브랜치와 원격 저장소의 브랜치를 1:1로 매핑하기

다음 명령어를 입력하여 

git push -u origin main

-u (upstream) 옵션을 통해 앞으로 로컬 저장소의 main 브랜치는 origin 원격 저장소와 짝이라고 등록한다.

 

연결이 완료된 이후에는 원격 저장소 이름과 브랜치 이름을 매번 명시할 필요 없이 git push 및 git pull만 입력해도 정상 동작한다.

 

다음 명령어를 입력하면 웹 브라우저에서 저장소를 열 수 있다.

gh repo view --web

 

브라우저를 확인해보면

지금까지의 커밋 기록이 전부 올라와 있는 것을 확인할 수 있다.