Git 초보가 제일 막히는 구간을 하나씩 풀어봅니다

Git을 설치하고 로컬에서 git init까지는 했는데…

• ❓ GitHub는 왜 또 필요하지?
• ❓ 로그인은 어떻게 하지?
• ❓ 비밀번호가 안 되는데?
• ❓ 토큰은 뭐야?

👉 이 구간에서 70%가 멈춥니다.
👉 오늘 여기서 끝냅니다.

---

1️⃣ GitHub는 뭐고 왜 연결하나요?

정리하면 이렇습니다.

구분	역할
Git	내 PC에서 버전관리
GitHub	인터넷에 저장(백업 + 협업 + 다른 PC 동기화)

즉,

👉 Git만 쓰면 “내 컴퓨터 안에서만” 관리
👉 GitHub까지 연결하면 “클라우드 백업 + 협업 가능”

---

2️⃣ GitHub 가입 (처음이면)

1. https://github.com 접속
2. Sign up 클릭
3. 이메일 인증
4. 사용자명 생성

✔ 무료로 충분합니다.

---

3️⃣ GitHub에서 저장소(Repository) 만들기

로그인 후

1. 오른쪽 위 ➕ 버튼 클릭
2. New repository
3. Repository name: 예) my-project
4. Public / Private 선택
5. Create repository

⚠️ 여기서 README 생성 체크하지 마세요 (초보는 비워두는 게 안전)

---

4️⃣ 이제 로컬 Git과 연결합니다

이미 PC에서 이런 상태라고 가정합니다:

mkdir my-project
cd my-project
git init

GitHub에서 repo 생성 후 보이는 주소를 복사합니다.

예:

https://github.com/yourname/my-project.git

---

4-1) 원격 저장소 연결

git remote add origin https://github.com/yourname/my-project.git

확인:

git remote -v

---

5️⃣ 이제 push 해봅니다 (여기서 막힘 발생)

git branch -M main
git push -u origin main

👉 여기서 로그인 창이 뜨거나
👉 비밀번호를 요구합니다.

❗ 여기서 비밀번호 입력하면 실패합니다

GitHub는 더 이상 비밀번호 로그인 안 됩니다.
👉 Personal Access Token(토큰) 사용해야 합니다.

---

6️⃣ 토큰 생성 (초보용 단계별)

1. GitHub 오른쪽 위 프로필 클릭
2. Settings
3. 왼쪽 아래 → Developer settings
4. Personal access tokens
5. Tokens (classic) 클릭
6. Generate new token (classic)

설정 방법

• Note: git-login
• Expiration: 90 days (초보는 이렇게)
• Scopes:
  • ✅ repo (체크)

Generate token 클릭

⚠️ 생성되면 토큰 문자열이 보입니다.
👉 복사해서 안전한 곳에 저장
👉 다시는 안 보여줍니다

---

7️⃣ 토큰으로 로그인

다시 push 실행:

git push -u origin main

아이디 입력 → GitHub 아이디
비밀번호 입력 → 토큰 붙여넣기

👉 성공하면 업로드 완료 🎉

---

8️⃣ 이제부터는 이렇게 사용합니다

작업하고 커밋

git add .
git commit -m "feat: update feature"

GitHub에 업로드

git push

다른 PC에서 가져오기

git pull

---

9️⃣ 자주 발생하는 초보 오류 해결

❌ authentication failed

→ 토큰 잘못 입력
→ 토큰 만료
→ repo 권한 없음

---

❌ failed to push some refs

→ 먼저 pull 해야 하는 경우

git pull origin main --rebase
git push

---

🔟 브랜치까지 맛보기 (안전 작업)

기능 추가할 때는 이렇게:

git checkout -b feature/login

작업 후

git add .
git commit -m "feat: login"
git push -u origin feature/login

GitHub에서 PR 생성 → 병합

---

💡 제가 초보 때 깨달은 핵심

GitHub 연결은
👉 명령어보다 “토큰 이해”가 핵심

• Git = 로컬 기록
• GitHub = 원격 저장
• 토큰 = 로그인 비밀번호 대신

이 세 가지만 이해하면 더 이상 두렵지 않습니다.

---

📌 블로그용 정리 문장

Git 초보가 제일 막히는 구간은 “로그인”입니다.
비밀번호가 아니라 토큰으로 인증한다는 개념만 이해하면
GitHub 연결은 5분이면 끝납니다.