GitHub 완전 초보 가이드
GitHub가 뭔지 몰라도 괜찮습니다. 이 글만 따라하면 10분 안에 준비 완료.
Ad Space — github-top
01GitHub가 뭔가요?
한 줄 요약
GitHub = 코드 전용 Google Drive
Google Drive에 문서를 저장하듯, GitHub에 코드를 저장합니다. 차이점이 있다면:
백업
컴퓨터가 고장나도 코드가 안전합니다
되돌리기
실수로 코드를 망쳐도 이전 버전으로 되돌릴 수 있습니다. 게임의 세이브 포인트처럼.
배포 연결
GitHub에 코드를 올리면 Vercel이 자동으로 웹사이트를 업데이트합니다
공유
다른 사람에게 코드를 보여주거나 함께 작업할 수 있습니다
📦 알아두면 좋은 용어
Repository (레포지토리) — 프로젝트 하나를 담는 폴더. 줄여서 "레포"라고 부릅니다.
Commit (커밋) — 변경사항을 저장하는 것. 게임에서 세이브하는 것과 같습니다.
Push (푸시) — 내 컴퓨터의 코드를 GitHub에 올리는 것. Google Drive에 파일 업로드하는 것과 같습니다.
Pull (풀) — GitHub에 있는 코드를 내 컴퓨터로 내려받는 것.
비개발자분들이 가장 혼란스러워하는 게 "Git"과 "GitHub"의 차이예요. Git은 코드 변경을 추적하는 도구(소프트웨어)이고, GitHub는 그 기록을 온라인에 저장하는 서비스(웹사이트)입니다. 비유하자면 Git = 카메라, GitHub = 구글 포토. 사진 찍는 도구와 저장하는 곳이 다른 것처럼요.
02GitHub 계정 만들기
무료입니다. 3분이면 끝납니다.
GitHub 가입 페이지로 바로 이동합니다
파란색 배경에 'Welcome to GitHub'가 보입니다. 이메일 입력란이 화면 중앙에 있습니다. 자주 쓰는 이메일을 입력하고 초록색 'Continue' 버튼을 누르세요.
비밀번호 입력
비밀번호를 만듭니다.
15자 이상이거나, 8자 + 숫자 조합이어야 합니다. 입력하면 초록색 체크 표시가 나타납니다. 'Continue' 버튼을 누르세요.
사용자 이름(Username) 입력
영문으로 닉네임을 만듭니다. 이 이름이 나중에 github.com/이름이 됩니다.
이미 사용 중인 이름이면 빨간색 X가 나타납니다. 다른 이름을 시도하세요. 초록색 체크가 뜨면 'Continue'를 누르세요.
이메일 수신 설정
GitHub 소식을 이메일로 받을지 선택합니다.
'Would you like to receive product updates?' — 'n'을 입력하고 'Continue'를 누르세요. 나중에 바꿀 수 있습니다.
보안 확인 (퍼즐)
로봇이 아닌지 확인하는 퍼즐이 나옵니다.
'Verify your account' 아래에 이미지 퍼즐이 나타납니다. 지시대로 이미지를 선택하세요 (보통 "나선 은하를 선택하세요" 같은 문제). 완료하면 'Create account' 버튼을 누르세요.
이메일 인증
입력한 이메일로 인증 코드가 옵니다.
이메일 앱(Gmail 등)을 열어 GitHub에서 온 메일을 찾으세요. 8자리 숫자 코드가 있습니다. 그 숫자를 GitHub 화면에 입력하세요. 스팸함도 확인하세요.
설문 건너뛰기
취향 설문이 나옵니다. 안 해도 됩니다.
'How many team members?' 같은 질문이 나옵니다. 화면 하단의 'Skip personalization'을 누르세요. 작은 글씨로 되어 있으니 잘 찾아보세요.
완료!
대시보드 화면이 보이면 GitHub 계정이 만들어진 것입니다. 🎉
'Start a new repository' 또는 'Learn Git and GitHub' 같은 카드가 보이는 화면이 나타납니다. 여기서 더 할 건 없습니다. 이 화면은 닫아도 됩니다.
💡 Username 고르는 팁
✅ 짧고 기억하기 쉬운 것: hyunseo-kim
✅ 본명이나 닉네임: designerkim
❌ 특수문자 많은 것: x_X_kim_2024_X_x
이 이름이 나중에 코드 주소가 됩니다: github.com/hyunseo-kim/my-project
03GitHub CLI 설치하기
🤔 이건 왜 필요한가요?
GitHub 웹사이트에 매번 들어가지 않고, 터미널에서 바로 코드를 올릴 수 있게 해주는 도구입니다. Claude Code가 자동으로 코드를 올리려면 이게 있어야 합니다.
🍎 Mac 사용자
Homebrew 확인
터미널을 열고 (🔍 → "터미널") 아래를 입력:
$ brew --version
숫자(예: Homebrew 4.x.x)가 나오면 → Step 2로. 'command not found'가 나오면 → Homebrew 먼저 설치 ↓
Homebrew 설치 (brew가 없는 경우만)
Homebrew 공식 사이트로 이동
검은 배경에 큰 맥주잔 아이콘이 보입니다. 화면 중간에 '/bin/bash -c ...'로 시작하는 긴 명령어가 있습니다. 오른쪽의 복사 아이콘(📋)을 클릭하세요.
터미널에 붙여넣기
복사한 명령어를 터미널에 붙여넣고 엔터.
Mac 비밀번호를 물어봅니다. 입력할 때 화면에 아무것도 안 보이는 게 정상입니다. 그냥 비밀번호 치고 엔터 누르세요. 설치에 2-5분 걸립니다.
GitHub CLI 설치
$ brew install gh
설치가 진행되면서 텍스트가 쏟아집니다. 1-2분 기다리면 됩니다. 마지막에 아무 에러 없이 끝나면 성공.
🪟 Windows 사용자
PowerShell 열기
시작 메뉴 → "PowerShell" 검색 → 클릭
파란 배경의 창이 열립니다. 커서가 깜빡이면 준비 완료.
설치 명령어 입력
$ winget install GitHub.cli
'winget'이 안 되면 → cli.github.com 접속 → 'Download for Windows' 버튼 클릭 → 설치 파일 실행 → Next만 누르기
✅ 설치 확인
$ gh --version
gh version 2.x.x 같은 숫자가 나오면 성공! 'command not found'가 나오면 터미널을 완전히 끄고 다시 열어보세요.
Homebrew, winget, CLI... 설치할 게 많다고 느껴질 수 있지만 이건 딱 한 번만 하는 거예요. 마치 새 폰 샀을 때 앱 설치하는 것처럼, 처음만 번거롭고 그 다음부턴 그냥 쓰면 됩니다.
Ad Space — github-mid
04터미널에서 GitHub 로그인
GitHub CLI를 설치했으니, 내 GitHub 계정으로 로그인합니다. 한 번만 하면 됩니다.
로그인 시작
$ gh auth login
물음표(?)와 함께 선택지가 나타납니다. 키보드 화살표(↑↓)로 이동하고 엔터로 선택합니다.
첫 번째 질문
"What account do you want to log into?"
두 개 선택지가 보입니다: GitHub.com / GitHub Enterprise Server. GitHub.com이 이미 선택되어 있으면 그냥 엔터. 아니면 화살표로 이동 후 엔터.
두 번째 질문
"What is your preferred protocol for Git operations?"
HTTPS / SSH 두 개가 보입니다. HTTPS를 선택하세요 (보통 이미 선택되어 있음). 엔터.
세 번째 질문
"Authenticate Git with your GitHub credentials?"
Yes / No가 보입니다. Yes를 선택하세요. 엔터.
네 번째 질문
"How would you like to authenticate GitHub CLI?"
Login with a web browser / Paste an authentication token이 보입니다. Login with a web browser를 선택하세요. 엔터.
코드 확인 & 브라우저 승인
화면에 코드가 나타나고 엔터를 누르라고 합니다.
터미널에 'First, copy your one-time code: AB12-3456' 같은 8자리 코드가 표시됩니다. 이 코드를 기억하세요 (또는 이미 복사됨). 엔터를 누르면 브라우저가 자동으로 열립니다.
브라우저가 자동으로 열립니다 (안 열리면 이 링크 클릭)
'Enter the code displayed on your device'라는 화면이 보입니다. 터미널에 있던 8자리 코드를 입력하세요. 그 다음 화면에서 초록색 'Authorize GitHub CLI' 버튼을 누르세요.
완료!
터미널로 돌아가면 로그인 성공 메시지가 보입니다.
'✓ Logged in as [내 이름]'이 나타납니다. 이제 터미널에서 GitHub을 사용할 수 있습니다!
✅ 언제든 확인하는 방법
$ gh auth status
✅ Logged in to github.com as 이름 → 정상
❌ 에러 → gh auth login을 다시 실행하세요
개발자들 사이에서 GitHub 인증은 SSH 키, Personal Access Token, GitHub CLI 등 여러 방법이 있어서 항상 논쟁거리예요. 여기서 소개한 "gh auth login"은 가장 최신이고 가장 쉬운 방법입니다. 다른 방법은 몰라도 됩니다.
05코드를 GitHub에 올리기
로그인이 끝났으니, 실제로 코드를 올려봅시다.
🏆 추천: Claude Code에게 시키기
가장 쉬운 방법입니다. 아래 한 마디면 됩니다.
Claude Code에게 말하기
> 이 프로젝트를 GitHub에 올려줘. 레포 이름은 my-links로 해줘.
Claude Code가 자동으로 git init → commit → 레포 생성 → push까지 전부 실행합니다. 중간에 'y' 허용을 몇 번 눌러야 할 수 있습니다.
올라간 코드를 확인합니다
github.com에 로그인하면 왼쪽에 방금 만든 레포(my-links)가 보입니다. 클릭하면 코드 파일 목록이 보입니다. 이게 보이면 성공!
🔧 직접 하고 싶다면 (참고용)
Claude Code 없이 터미널 명령어로 직접 올리는 방법:
# 1. 프로젝트 폴더에서 Git 시작
$ git init
# 2. 모든 파일을 저장 대상에 추가
$ git add .
# 3. 첫 번째 세이브 (커밋)
$ git commit -m "첫 번째 버전"
# 4. GitHub에 레포 만들고 올리기
$ gh repo create my-links --public --push --source .
"Claude Code에게 시키기"를 강력 추천합니다. Git 명령어는 개발자들도 자주 헷갈려서 매번 검색하거든요. AI한테 시키는 게 실수도 적고 빠릅니다.
06GitHub에 올린 코드 확인하기
코드를 올렸다면 확인해봅시다.
- 1
터미널에서 바로 열기
$ gh repo view --web
브라우저에서 내 레포가 열립니다
- 2
또는 직접 접속
github.com/내닉네임/my-links에 접속하면 코드가 보입니다
📁 보이는 것들
파일 목록 — 프로젝트의 모든 파일이 보입니다
README — 프로젝트 설명 (없어도 괜찮아요)
Commits — 저장(커밋) 기록. 언제 뭘 바꿨는지
초록 Code 버튼 — 다른 사람이 내 코드를 다운로드할 수 있는 버튼
07자주 하는 질문
GitHub에 올린 코드를 다른 사람이 볼 수 있나요?
Public(공개) 레포는 누구나 볼 수 있습니다. 비밀번호나 API 키 같은 민감한 정보는 절대 올리면 안 됩니다. Claude Code는 이런 파일(.env.local)을 자동으로 제외합니다.
Private(비공개) 레포를 만들 수 있나요?
네! 무료 계정도 비공개 레포를 만들 수 있습니다. Claude Code에게 "GitHub에 올려줘, private으로"라고 하면 됩니다. 다만 Vercel 무료 플랜에서는 public 레포가 필요할 수 있습니다.
코드를 잘못 올렸어요. 삭제할 수 있나요?
네. GitHub 웹사이트에서: 레포 페이지 → Settings (맨 아래) → "Delete this repository". 또는 터미널에서: gh repo delete 레포이름 --yes
gh 명령어가 안 돼요
GitHub CLI가 설치되지 않았거나 터미널을 재시작해야 합니다. 터미널을 완전히 끄고 다시 열어보세요. 그래도 안 되면 위의 설치 단계를 다시 진행하세요.
git과 gh의 차이가 뭔가요?
git은 코드 변경을 추적하는 기본 도구, gh는 GitHub 서비스를 터미널에서 사용하는 도구입니다. git은 Node.js 설치할 때 같이 설치되고, gh는 별도로 설치해야 합니다.
매번 명령어를 외워야 하나요?
아니요! Claude Code에게 "GitHub에 올려줘", "변경사항 저장해줘"라고 말하면 알아서 git/gh 명령어를 실행합니다. 명령어를 외울 필요 없어요.
Git은 개발자들 사이에서도 "가장 어려운 도구" 취급을 받아요. 20년 경력 개발자도 가끔 Git 때문에 코드를 날립니다. 그래서 요즘은 AI한테 시키는 게 최선입니다. "GitHub에 올려줘" 한 마디가 명령어 10줄보다 안전해요.
다음 단계
Ad Space — github-bottom