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

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

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

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

정리하면 이렇습니다.

즉,

👉 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분이면 끝납니다.

게시물 GitHub 연결까지 완전 정복 (토큰 로그인 포함)이 하우인포-IT·테크에 처음 등장했습니다.

• Git = 내 PC에서 “코드 변경 이력”을 저장하는 도구
• GitHub/GitLab = 인터넷(원격) 에 저장해두는 “저장소 서비스”

즉,

• Git만 설치해도 내 컴퓨터에서 버전관리 가능
• GitHub까지 연결하면 백업/협업/다른 PC 동기화까지 가능

1) 다운로드는 “공식”에서만 (중요)

초보일수록 검색해서 아무 사이트에서 받다가 광고/번들 설치로 꼬이는 경우가 있어요.
아래 2곳이 대표적인 공식 루트입니다.

• Git 공식 설치 페이지(운영체제 선택): Git SCM Install
• Windows는 Git for Windows(공식 안내/다운로드 링크 제공): Git SCM Windows Install

추가로, Windows 요구사항(지원 OS)도 공식에 명시돼 있어요.

2) Windows 설치 (가장 많이 쓰는 케이스)

2-1) 다운로드

1. Git 공식 Windows 설치 페이지로 이동
2. “latest x64” 설치 파일을 다운로드 (대부분 PC는 x64)

참고: Git for Windows는 Windows 8.1 이상이 권장/지원 범위로 안내됩니다.

2-2) 설치하면서 뭐 선택해야 해요? (초보 추천 “안전 세팅”)

설치 옵션이 많아서 처음엔 무조건 헷갈립니다.
저는 처음에 아무거나 눌렀다가 줄바꿈 문제(CRLF/LF)로 고생했어요. 아래가 가장 무난했습니다.

설치 화면에서 핵심만 체크:

(1) PATH 옵션

• ✅ Git from the command line and also from 3rd-party software
  → CMD/PowerShell/VS Code에서 git 명령이 바로 먹게 됨

(2) Line endings(줄바꿈)

• ✅ Checkout Windows-style, commit Unix-style
  → 윈도우에서 줄바꿈 지뢰 줄이기

(3) 기본 터미널

• “Git Bash”는 기본 포함. 초보는 Git Bash로 시작하는 게 편합니다.

여기까지 하고 “Next → Install” 쭉 가면 됩니다.
(나머지는 기본값으로도 실무에 문제 거의 없었어요)

2-3) 설치 확인(이게 제일 중요)

설치 끝나면 Git Bash 열고 아래 입력:

git --version

git version 2.xx.x 이런 식으로 나오면 설치 성공입니다.
(안 나오면 PATH 옵션이 잘못된 경우가 많아요)

3) macOS 설치 (Homebrew가 제일 편함)

Git 공식 문서에서도 macOS에서 Homebrew 설치를 안내합니다.

3-1) Homebrew가 없다면

Homebrew 공식 설치 문서:

3-2) Git 설치

brew install git
git --version

경험팁: macOS 기본 Git이 “있긴 한데 오래된 버전”인 경우가 있어서, 저는 brew로 깔고 업데이트 관리하는 게 제일 편했습니다.

4) Ubuntu/Linux 설치 (apt로 간단)

Ubuntu 문서에서도 Git을 다루며, 필요하면 문서 패키지(git-doc)도 설치할 수 있다고 안내합니다.

sudo apt update
sudo apt install -y git
git --version

(문서까지 설치하고 싶으면)

sudo apt install -y git-doc

5) 설치 후 “딱 2분” 필수 설정 (안 하면 커밋에 이름이 이상하게 찍힘)

아래 2개는 무조건 해두세요.

git config --global user.name "name"
git config --global user.email "you@example.com"

설정 확인:

git config --global --list

경험상, 이거 안 해두면 나중에 커밋 작성자가 “PC 계정명”으로 찍히거나, 프로젝트마다 설정 꼬여서 다시 고치게 됩니다.

6) 이제 진짜 시작: “내 폴더를 Git으로 관리하기”

6-1) 새 폴더 만들고 Git 시작

mkdir my-project
cd my-project
git init

git init은 “이 폴더를 Git 저장소로 만들겠다”라는 뜻입니다.

6-2) 파일 하나 만들어보고 첫 커밋

예: README.md를 만든다고 치면

echo "# my-project" > README.md
git status

여기서 초보가 제일 헷갈리는 개념: “스테이징”

Git은 커밋 전에 무엇을 커밋할지 후보에 올리는 단계가 있어요.

1. 스테이징(커밋 후보로 올리기)

git add .

2. 커밋(스냅샷 저장)

git commit -m "chore: first commit"

3. 로그 확인

git log --oneline

7) 매일 쓰는 “초보 루틴 3종” (이 순서만 외우면 됨)

제가 정착한 순서가 이거였어요:

1. 지금 상태 보기

git status

2. 뭐가 바뀌었는지 보기

git diff

3. 올리고( add ) 저장( commit )

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

8) 실수했을 때 복구(초보 필수 3개)

실무/개인 모두 이 3개가 가장 많이 씁니다.

(1) 커밋 전 변경을 다 버리고 싶다 (되돌리기)

git restore .

(2) add를 잘못했다(스테이징 취소)

git restore --staged .

(3) 방금 커밋 메시지를 고치고 싶다

git commit --amend -m "fix: correct message"

9) 여기까지가 “Git만으로” 할 수 있는 것

• 내 PC에서 버전관리 ✅
• 변경이력/복구 ✅

다음 단계는 GitHub(원격 저장소) 연결인데,
초보는 여기서 로그인(토큰), push/pull, 브랜치가 같이 나오면서 갑자기 어려워집니다.

게시물 Git 완전 초보 가이드: 다운로드부터 “첫 커밋”까지 (실전 경험 버전)이 하우인포-IT·테크에 처음 등장했습니다.

이럴 때 도움을 주는 도구가 바로 Git입니다.
Git은 어렵게 말하면 버전 관리 시스템이지만,
쉽게 말하면 코드의 변경 기록을 차곡차곡 저장해 주는 도구라고 생각하면 됩니다.

Git을 쓰면 뭐가 좋아질까?

Git을 사용하면 이런 점들이 좋아집니다.

• 코드가 망가져도 이전 상태로 되돌릴 수 있고
• 어떤 파일을 언제 수정했는지 한눈에 볼 수 있고
• 혼자 작업해도, 여러 명이 함께 작업해도 관리가 쉬워집니다

처음에는 낯설 수 있지만,
기본 흐름만 익히면 생각보다 어렵지 않습니다.

Git을 사용하기 전, 딱 한 번만 하는 설정

Git을 처음 설치했다면
“이 작업을 누가 했는지”를 알 수 있도록 이름과 이메일을 설정합니다.

git config --global user.name "내 이름"
git config --global user.email "내이메일@example.com"

설정이 잘 되었는지는 아래 명령으로 확인할 수 있습니다.

git config --list

참고로 --global은
앞으로 만드는 모든 프로젝트에 공통으로 적용됩니다.

Git 저장소 만들기

새 프로젝트에서 시작하는 경우

git init

이 한 줄로
“이 폴더를 Git으로 관리하겠다”라고 선언하는 셈입니다.

이미 만들어진 프로젝트를 가져오는 경우

git clone 저장소주소

GitHub에 있는 프로젝트를 그대로 내려받을 때 사용하는 방법입니다.

Git의 기본 흐름 이해하기

Git은 항상 비슷한 순서로 움직입니다.

1. 파일을 수정하고
2. 변경된 파일을 모아두고
3. 하나의 기록으로 저장하고
4. 필요하면 원격 저장소로 올립니다

이 과정을 반복한다고 생각하면 됩니다.

지금 상태가 궁금할 때

git status

이 명령어 하나만 잘 써도
“뭐가 바뀌었는지”, “아직 저장 안 된 게 뭔지”를 바로 알 수 있습니다.

변경한 파일 저장하기

파일을 Git에 올릴 준비하기

git add 파일이름

모든 변경 사항을 한 번에 추가하고 싶다면

git add .

변경 내용을 하나의 기록으로 남기기

git commit -m "로그인 기능 추가"

이 메시지는
나중에 다시 봤을 때 무슨 작업을 했는지 바로 알 수 있게 적는 게 좋습니다.

GitHub 같은 원격 저장소에 올리기

git push origin main

이제 내 컴퓨터에만 있던 코드가
원격 저장소에도 안전하게 저장됩니다.

자주 쓰게 되는 명령어들

개인적으로 가장 많이 쓰는 것들만 정리해보면 이 정도입니다.

• git status : 지금 상태 확인
• git add : 변경 파일 모으기
• git commit : 기록 남기기
• git pull : 최신 코드 가져오기
• git push : 코드 올리기

처음에는 이 다섯 가지만 익혀도 충분합니다.

실수했을 때 대처 방법

방금 커밋한 걸 취소하고 싶을 때

git reset HEAD~1

파일은 그대로 두고
커밋만 취소할 수 있습니다.

원격 저장소 주소가 바뀐 경우

git remote set-url origin 새주소

마무리하며

Git은 처음 접하면 낯설고 어렵게 느껴지지만,
실제로는 코드를 안전하게 지키기 위한 도구에 가깝습니다.

처음부터 모든 기능을 알 필요는 없고,

• 상태 확인
• 저장
• 올리기

이 세 가지만 자연스럽게 익혀도
개발이 훨씬 편해집니다.

게시물 Git, 처음 써보는 사람을 위한 가장 쉬운 정리이 하우인포-IT·테크에 처음 등장했습니다.