📦 GitHub이란 무엇인가

GitHub은 코드를 저장하고 관리하는 온라인 서비스입니다. 쉽게 말하면 "코드 전용 구글 드라이브"라고 생각하면 됩니다. 내 컴퓨터에만 있던 프로젝트를 인터넷에 안전하게 보관하고, 변경 이력을 추적하고, 다른 사람과 공유할 수 있습니다.

GitHub은 Git이라는 버전 관리 도구를 기반으로 동작합니다. Git이 내 컴퓨터에서 코드 변경 이력을 기록하는 도구라면, GitHub은 그 기록을 인터넷에 올려서 어디서든 접근할 수 있게 만드는 서비스입니다. 전 세계 개발자의 90% 이상이 사용하고 있으며, 무료 계정으로 대부분의 기능을 이용할 수 있습니다.

🎯 바이브코딩에서 GitHub이 필요한 이유

바이브코딩을 하다 보면 코드가 점점 쌓입니다. 어제 잘 동작하던 코드가 오늘 AI에게 수정을 요청한 뒤 망가지는 경우도 있습니다. GitHub이 없으면 이전 상태로 돌아갈 방법이 없습니다.

코드 백업: 컴퓨터가 고장나거나 파일을 실수로 삭제해도 GitHub에 올려둔 코드는 안전합니다.
변경 이력 추적: 어떤 파일을 언제 왜 바꿨는지 기록이 남습니다. 문제가 생기면 이전 버전으로 돌아갈 수 있습니다.
배포 연동: Vercel, Netlify 같은 호스팅 서비스는 GitHub 저장소와 연결해서 자동으로 배포합니다.
포트폴리오: GitHub 프로필이 개발자의 명함 역할을 합니다.
AI 도구 연동: Cursor, Claude Code 같은 AI 코딩 도구는 Git/GitHub과 연동되어 코드 관리를 도와줍니다.

📝 GitHub 가입 단계별 가이드

GitHub 가입은 5분이면 끝납니다. 아래 단계를 그대로 따라하세요.

1. 가입 페이지 접속

웹 브라우저에서 github.com에 접속합니다. 화면 중앙 또는 우측 상단에 "Sign up" 버튼이 있습니다.

2. 이메일 입력

실제 사용하는 이메일 주소를 입력합니다. 이 이메일로 인증 코드가 발송되고, 비밀번호 찾기, 알림 수신 등에 사용됩니다.

3. 비밀번호 설정

최소 15자 이상, 또는 숫자와 소문자를 포함해 8자 이상이어야 합니다. GitHub에 코드를 올리면 자동 배포가 되는 구조가 많기 때문에, 강력한 비밀번호를 사용하는 것이 중요합니다.

4. 사용자 이름(Username) 설정

GitHub URL에 사용되는 고유한 이름입니다. github.com/사용자이름 형태로 프로필 URL이 됩니다. 나중에 변경할 수 있지만, 변경하면 기존 URL이 깨지므로 처음부터 신중하게 정하세요.

사용자 이름 추천 패턴: brandon-kim, minjae-dev 같이 본명 영문 또는 본명+직무 형태가 좋습니다. 숫자 나열(user12345)이나 너무 긴 이름은 피하세요.

5. 이메일 인증

입력한 이메일로 인증 코드가 발송됩니다. 이메일을 확인해서 코드를 입력하면 가입이 완료됩니다. 스팸 폴더도 확인해보세요.

6. 요금제 선택

Free(무료)와 Pro(유료) 중에서 선택합니다. 바이브코딩을 시작하는 단계에서는 Free로 충분합니다. 무료 계정으로도 무제한 저장소, 무제한 협업자, GitHub Actions 2,000분/월을 사용할 수 있습니다.

🗂️ 첫 번째 저장소 만들기

저장소(Repository)는 하나의 프로젝트를 담는 폴더입니다. 바이브코딩으로 만든 프로젝트마다 저장소 하나를 만듭니다.

웹에서 저장소 만들기

GitHub에 로그인한 상태에서 우측 상단의 + 버튼 → "New repository"를 클릭합니다.
Repository name: 프로젝트 이름을 영문 소문자와 하이픈으로 입력합니다. 예: my-portfolio, todo-app
Description: 프로젝트 설명을 한 줄로 적습니다.
Public / Private: 포트폴리오라면 Public, 개인적인 프로젝트라면 Private을 선택합니다.
Add a README file: 체크합니다. README는 프로젝트의 "첫 페이지"입니다.
Add .gitignore: "Node"를 선택합니다.
"Create repository" 버튼을 클릭합니다.

터미널에서 저장소 만들기

이미 바이브코딩으로 프로젝트를 만들어서 내 컴퓨터에 파일이 있다면, 터미널에서 직접 저장소를 만들고 연결할 수 있습니다.

# 1. 프로젝트 폴더로 이동
cd my-portfolio

# 2. Git 초기화 (이미 git init이 되어 있다면 건너뛰기)
git init

# 3. 모든 파일을 스테이징
git add .

# 4. 첫 번째 커밋
git commit -m "첫 번째 커밋"

# 5. GitHub에서 빈 저장소 만든 뒤 연결
git remote add origin https://github.com/사용자이름/my-portfolio.git

# 6. 코드 올리기
git push -u origin main

🚀 코드를 저장소에 올리기

저장소를 만들었으면 코드를 올려야 합니다. 이 과정을 "push"라고 합니다.

기본 push 순서

# 1. 변경된 파일 확인
git status

# 2. 변경된 파일을 스테이징 (올릴 준비)
git add .

# 3. 변경 내용 설명과 함께 커밋
git commit -m "로그인 페이지 추가"

# 4. GitHub에 올리기
git push

git status를 먼저 실행해서 어떤 파일이 변경됐는지 확인하는 습관을 들이세요. 의도하지 않은 파일(.env 같은 비밀 정보 파일)이 포함되어 있지 않은지 확인할 수 있습니다.

인증 방법

처음 git push를 실행하면 GitHub 인증을 요청합니다. 2021년부터 비밀번호 인증은 지원하지 않으며, 아래 두 가지 방법 중 하나를 사용해야 합니다.

방법	난이도	설명
HTTPS + Personal Access Token	쉬움	Settings → Developer settings → Personal access tokens에서 토큰 발급 후 비밀번호 대신 입력
SSH Key	보통	공개키/비밀키 쌍 생성 후 공개키를 GitHub에 등록. 한 번 설정하면 매번 토큰 입력 불필요

비전공자에게는 HTTPS + Personal Access Token 방식을 추천합니다. 토큰을 발급받을 때 repo 권한만 체크하면 충분합니다.

⚠️ Personal Access Token은 비밀번호와 같습니다. 토큰이 노출되면 누군가 내 저장소에 코드를 올리거나 삭제할 수 있습니다. 절대로 코드에 직접 적거나 메신저로 공유하지 마세요.

📖 꼭 알아야 할 GitHub 용어 정리

용어	비유	설명
Repository (저장소)	프로젝트 폴더	하나의 프로젝트를 담는 공간
Commit (커밋)	저장 포인트	변경 사항을 기록하는 단위. 게임의 세이브 포인트와 비슷
Push (푸시)	업로드	내 컴퓨터의 커밋을 GitHub에 올리기
Pull (풀)	다운로드	GitHub의 최신 코드를 내 컴퓨터로 가져오기
Clone (클론)	복사	GitHub 저장소를 내 컴퓨터에 통째로 복사
Branch (브랜치)	평행 세계	원본을 건드리지 않고 새 기능을 따로 개발하는 공간
Fork (포크)	복제	다른 사람의 저장소를 내 계정으로 복제
README	프로젝트 소개서	저장소에 방문한 사람이 처음 보는 문서
.gitignore	무시 목록	Git에 올리지 않을 파일 목록 (예: .env, node_modules)

⚙️ 가입 후 바로 해야 할 설정

프로필 설정

Settings → Profile에서 이름, 자기소개, 프로필 사진을 설정합니다. GitHub 프로필은 개발자의 명함이니, 간단하게라도 채워두면 좋습니다.

2단계 인증(2FA) 활성화

Settings → Password and authentication에서 2FA를 활성화합니다. 인증 앱(Google Authenticator, Microsoft Authenticator 등)을 사용하는 것이 가장 안전합니다.

이메일 비공개 설정

Settings → Emails에서 "Keep my email addresses private"를 체크합니다. 이 설정을 하지 않으면 커밋 기록에 실제 이메일이 노출됩니다.

# 터미널에서 Git 이메일을 noreply로 변경
git config --global user.email "사용자이름@users.noreply.github.com"
git config --global user.name "사용자이름"

🚨 실수 패턴과 예방법

.env 파일을 GitHub에 올리기

가장 흔하고 가장 위험한 실수입니다. .env 파일에는 API 키, 데이터베이스 비밀번호 같은 민감한 정보가 들어 있습니다. 저장소를 만들 때 .gitignore에 .env가 포함되어 있는지 반드시 확인하세요.

node_modules 폴더를 올리기

node_modules 폴더는 수만 개의 파일이 들어 있어 용량이 수백 MB에 달할 수 있습니다. .gitignore에 node_modules/가 포함되어 있는지 확인하세요.

커밋 메시지를 "수정", "변경"으로만 적기

나중에 어떤 변경이었는지 알 수 없게 됩니다. "로그인 페이지 레이아웃 수정", "회원가입 폼 검증 추가"처럼 구체적으로 적는 습관을 들이세요.

🔓 Public vs Private 저장소 비교

항목	Public	Private
접근 범위	누구나 볼 수 있음	초대받은 사람만
적합한 용도	포트폴리오, 오픈소스	개인 프로젝트, 회사 코드
무료 플랜	무제한	무제한
Vercel 연동	무료 가능	무료 가능

바이브코딩 포트폴리오 프로젝트는 Public으로, API 키가 포함될 수 있는 백엔드 프로젝트는 Private으로 시작하는 것을 권장합니다.

💡 운영 팁

하루에 한 번은 push하기: 컴퓨터에만 있는 코드는 백업이 없는 것과 같습니다.
README를 작성하기: AI에게 "이 프로젝트의 README를 만들어줘"라고 요청하면 깔끔한 README를 생성해줍니다.
GitHub 잔디 채우기: 매일 조금씩 코드를 올리면 꾸준한 개발 활동을 보여줄 수 있습니다.

GitHub 가입부터 저장소 만들기까지 — 바이브코딩 필수 가이드 (2026)