새로운 프로젝트를 시작할 때, 로컬 깃 저장소를 초기화하고
GitHub 원격 저장소를 생성한 뒤 첫 커밋을 푸시하는 과정을 단계별로 정리했습니다.
이 글을 따라 하시면 MacOS 터미널에서 단 몇 줄의 명령어로
깔끔하게 프로젝트를 세팅할 수 있습니다.

sequenceDiagram
    participant Dev as "개발자"
    participant Local as "로컬 디렉토리"
    participant GH as "GitHub 원격"

    Dev->>Local: git init
    Dev->>Local: git add .
    Dev->>Local: git commit -m "Initial commit"
    Dev->>GH: gh repo create USERNAME/REPO --public --source=. --remote=origin
    GH-->>Dev: "원격 URL 반환"
    Dev->>Local: git push -u origin main

📋 사전 준비

  1. Git 설치 확인

    git --version

    버전 정보가 출력되면 설치되어 있는 상태입니다.

  2. GitHub CLI 설치 (선택 사항)
    깃허브 저장소를 터미널에서 바로 생성하려면 GitHub CLI가 필요합니다.

    brew install gh
gh auth login

🔧 1. 로컬 저장소 초기화

프로젝트 루트 디렉토리로 이동한 뒤, 다음 명령어를 실행해 로컬 저장소를 초기화합니다.

cd /path/to/your/project
git init
  • git init
    해당 폴더에 .git/ 디렉토리를 생성하고, 이 폴더를 깃 저장소로 만듭니다.

📝 2. 첫 커밋 준비

  1. 변경된 파일 스테이징

    git add .

    현재 폴더의 모든 파일을 스테이징 영역에 올립니다.

  2. 커밋 생성

    git commit -m "Initial commit"

    첫 커밋을 기록합니다.

🚀 3. GitHub 원격 저장소 생성

방법 A: GitHub CLI 사용

gh repo create <USERNAME>/<REPO> \
  --public \
  --source=. \
  --remote=origin
  • --public 또는 --private 로 공개 여부 설정
  • --source=. 현재 폴더를 소스 디렉토리로 지정
  • --remote=origin 원격 이름을 origin 으로 지정

방법 B: GitHub 웹에서 생성

  1. GitHub에 로그인 후 새 저장소(New Repository) 생성

  2. 리포지토리 이름 입력 후 생성

  3. 화면에 표시된 리모트 URL 복사

    git remote add origin https://github.com/<USERNAME>/<REPO>.git

🌐 4. 원격에 푸시

# 기본 브랜치를 'main'으로 설정 (필요 시)
git branch -M main

# 원격에 첫 푸시
git push -u origin main
  • -u 옵션은 추적 설정(upstream)을 해 줍니다. 이후 git push만으로도 해당 브랜치에 푸시할 수 있습니다.

리포지토리 이름 변경


# 현재 디렉토리가 git과 연결된 GitHub 리포지토리라고 가정
gh repo rename <new-name> -y

🎉 완료!

이제 로컬에서 깃 관리를 시작하고, GitHub 원격 저장소까지 연결하여 첫 커밋을 푸시했습니다.
다음 단계로는 README 작성, .gitignore 설정, 협업 브랜치 전략 등을 추가로 설정해 보세요.