Git과 GitHub 사용법 총정리:
초보자를 위한 커밋과 푸시 따라 하기
바이브코딩으로 웹사이트나 프로그램을 만들다 보면 한 가지 걱정이 생깁니다. 열심히 만든 프로젝트가 컴퓨터 고장이나 실수로 사라지면 어떻게 해야 할까요?
Git과 GitHub 사용법을 알아두면 이런 걱정을 크게 줄일 수 있습니다. 작업한 내용을 단계별로 저장하고, 인터넷에 백업할 수 있기 때문입니다.
특히 안티그래비티(Antigravity)와 같은 AI 코딩 도구를 사용한다면 Git과 GitHub는 꼭 알아두면 좋은 기본 도구입니다.
이번 글에서는 개발 경험이 없는 초보자도 따라 할 수 있도록 Git 설치부터 GitHub 업로드까지 설명하겠습니다.
- Git과 GitHub의 차이
- Git 설치 및 초기 설정
- 프로젝트 폴더를 Git 저장소로 만들기
- 커밋으로 작업 기록 저장하기
- GitHub에 프로젝트 백업하기
- 자주 발생하는 오류 해결 방법
1. Git과 GitHub는 무엇일까?
Git과 GitHub는 이름이 비슷하지만 역할은 서로 다릅니다.
쉽게 이해하려면 컴퓨터 게임의 세이브 기능을 생각하면 됩니다.
Git은 게임의 세이브 포인트
게임을 하다가 중요한 지점에서 저장해 두면 나중에 문제가 생겨도 저장한 시점부터 다시 시작할 수 있습니다.
Git도 비슷합니다.
프로그램을 만들면서 중요한 변경 사항이 있을 때마다 기록을 남깁니다. 나중에 문제가 생기면 이전 작업 기록을 확인하거나 복구할 수 있습니다.
GitHub는 인터넷에 있는 보관 금고
Git으로 저장한 기록이 내 컴퓨터에만 있다면 컴퓨터가 고장 났을 때 문제가 생길 수 있습니다.
이때 GitHub를 사용합니다.
GitHub는 Git 저장소를 인터넷에 보관하고 관리할 수 있는 서비스입니다.
핵심 개념 정리
🔹 Git : 프로젝트 변경 기록을 관리하는 도구
🔹 Commit : 현재 작업 상태를 저장하는 것
🔹 Repository : 프로젝트 기록을 관리하는 저장소
🔹 GitHub : 인터넷에서 저장소를 보관하는 서비스
🔹 Push : 내 컴퓨터의 저장 기록을 GitHub로 올리는 것
2. Git 설치 여부 확인하기
먼저 내 컴퓨터에 Git이 설치되어 있는지 확인해야 합니다.
안티그래비티를 실행하고 작업할 프로젝트 폴더를 엽니다.
그다음 AI 채팅창에 다음 프롬프트를 입력합니다.
내 컴퓨터에 git이 설치되어 있는지 확인해줘. git --version 명령어를 실행하고 결과를 한국어로 설명해줘.
정상적으로 설치되어 있다면 다음과 비슷한 결과가 나옵니다.
git version 2.54.0.windows.1
버전 숫자가 표시되면 설치가 완료된 것입니다.
버전이 표시되지 않는다면 Git을 설치해야 합니다.
공식 홈페이지에 접속하여 Windows용 설치 파일을 다운로드합니다.
설치 과정에서는 특별한 설정이 필요하지 않다면 기본값을 유지하고 Next를 선택하면 됩니다.
설치가 끝나면 안티그래비티를 완전히 종료한 후 다시 실행합니다.
3. Git에 사용자 이름과 이메일 등록하기
Git은 누가 작업 내용을 저장했는지 기록합니다.
따라서 처음 사용할 때 이름과 이메일을 등록해야 합니다.
안티그래비티 채팅창에 다음과 같이 입력합니다.
내 컴퓨터에서 Git을 처음 사용하는 거야. 사용자 이름은 "myname", 이메일은 "가입한 이메일 주소"로 등록해줘. 설정이 정상적으로 완료되었는지도 확인해줘.
여기서 myname은 본인이 원하는 영문 이름이나 닉네임으로 변경하면 됩니다.
이메일은 GitHub 계정에 연결한 이메일을 사용하는 것이 좋습니다.
정상적으로 등록되면 다음 두 가지 설정이 확인됩니다.
user.nameuser.email
이미 설정되어 있다는 메시지가 나오면 현재 등록된 정보를 확인하고 그대로 사용해도 됩니다.
4. 프로젝트 폴더를 Git 저장소로 만들기
이제 실제 작업 폴더를 Git이 관리하도록 설정하겠습니다.
예를 들어 웹사이트 프로젝트 폴더 이름이 my-first-site라고 가정하겠습니다.
프로젝트 폴더를 안티그래비티에서 연 상태로 다음 프롬프트를 입력합니다.
현재 열려 있는 프로젝트 폴더를 Git 저장소로 초기화해줘. 기본 브랜치 이름은 main으로 설정해줘. git init -b main 명령어를 사용하고, 완료 후 git status로 현재 상태를 보여줘.
Git은 프로젝트 폴더에 .git이라는 관리 정보를 만들어 기록을 관리합니다.
작업대에 다음과 비슷한 문구가 나타나면 정상적으로 초기화된 것입니다.
Initialized empty Git repositoryOn branch main
빨간색 파일이 표시되면 오류일까?
초보자가 가장 많이 당황하는 부분입니다.
git status를 실행했을 때 빨간색 파일 이름이 여러 개 나타날 수 있습니다.
하지만 이것은 오류가 아닙니다.
아직 Git에 저장 기록을 남기지 않은 파일이라는 뜻입니다.
참고로 이미 Git 저장소로 초기화된 폴더라면 Reinitialized existing Git repository라는 문구가 나올 수도 있습니다. 이 경우에도 반드시 오류인 것은 아닙니다.
5. 커밋(Commit)으로 작업 저장하기
이제 가장 중요한 과정입니다.
Git에서 작업 내용을 저장하는 것을 커밋(Commit)이라고 합니다.
커밋은 단순히 파일을 저장하는 것과 다릅니다.
현재 프로젝트의 상태를 기록하고, 나중에 어떤 작업을 했는지 확인할 수 있도록 메시지를 남기는 과정입니다.
첫 번째 커밋 만들기
안티그래비티에 다음과 같이 요청합니다.
현재 프로젝트 폴더의 파일 전체를 첫 번째 커밋으로 저장해줘. 변경 파일을 git add로 추가하고, 커밋 메시지는 "처음 시작 - 프로젝트 생성"으로 해줘. 완료 후 git log로 저장 기록을 보여줘.
정상적으로 완료되면 첫 번째 작업 기록이 만들어집니다.
커밋 메시지는 왜 중요할까?
커밋을 할 때는 무엇을 변경했는지 알 수 있도록 메시지를 작성하는 것이 좋습니다.
| 좋지 않은 메시지 | 좋은 메시지 |
|---|---|
| 수정 | 소개 문장 추가 |
| 변경 | 배경색 변경 |
| 완료 | 로그인 기능 추가 |
나중에 작업 기록을 살펴볼 때 메시지만 보고도 무엇을 했는지 알 수 있어야 합니다.
두 번째 커밋 만들기
이번에는 프로젝트의 일부를 수정한 후 다시 저장해 보겠습니다.
예를 들어 웹사이트 이름의 글자색을 변경했다고 가정하겠습니다.
프로젝트의 이름 글자색을 청록색으로 변경해줘. 변경이 정상적으로 적용되었는지 확인하고, 두 번째 커밋을 만들어줘. 커밋 메시지는 "이름 글자색 청록으로 변경"으로 해줘. 마지막에 git log로 전체 기록을 보여줘.
이제 커밋 기록이 두 개가 됩니다.
이것이 Git을 사용하는 기본적인 방식입니다.
작업이 완료될 때마다 이 과정을 반복하면 됩니다.
6. GitHub에 저장소 만들기
지금까지 저장한 커밋은 내 컴퓨터에만 있습니다.
이제 GitHub에 프로젝트를 보관할 공간을 만들어 보겠습니다.
① GitHub 회원가입 및 로그인
먼저 GitHub 홈페이지에 접속합니다.
계정이 없다면 회원가입을 진행하고 로그인합니다.
② New repository 선택
로그인한 후 오른쪽 위의 + 버튼을 누릅니다.
메뉴에서 New repository를 선택합니다.
③ 저장소 이름 입력
Repository name에 프로젝트 이름을 입력합니다.
예를 들어 다음과 같이 입력할 수 있습니다.
my-first-site
저장소 이름은 영문과 숫자를 사용하는 것이 편리합니다.
④ 공개 여부 선택하기
GitHub에서는 저장소를 두 가지 방식으로 만들 수 있습니다.
- Public : 다른 사람도 저장소의 내용을 볼 수 있습니다.
- Private : 허용된 사용자만 저장소에 접근할 수 있습니다.
학습용 예제나 공개해도 되는 프로젝트라면 Public을 선택할 수 있습니다.
개인 프로젝트나 공개하고 싶지 않은 소스코드는 Private를 선택하는 것이 좋습니다.
Public 저장소는 소스코드가 공개됩니다. API 키, 비밀번호, 개인정보, .env 파일 등의 비밀 정보가 포함되지 않았는지 반드시 확인하세요.
⑤ 추가 옵션은 비워 두기
이번 실습은 내 컴퓨터에 이미 프로젝트와 커밋 기록이 있는 상태입니다.
따라서 처음 연결할 때는 다음 옵션을 추가하지 않는 방식으로 진행합니다.
- Add README : Off
- Add .gitignore : No .gitignore
- Add license : No license
이렇게 빈 저장소를 만들면 기존 로컬 저장소와 연결하는 과정을 단순하게 진행할 수 있습니다.
마지막으로 Create repository 버튼을 누릅니다.
⑥ HTTPS 주소 복사하기
저장소가 만들어지면 HTTPS 주소가 표시됩니다.
주소는 다음과 비슷한 형태입니다.
https://github.com/아이디/my-first-site.git
오른쪽의 복사 아이콘을 눌러 주소를 복사합니다.
이 주소는 다음 단계에서 사용합니다.
7. GitHub로 프로젝트 업로드하기 (Push)
이제 마지막 단계입니다.
내 컴퓨터의 Git 저장소와 GitHub의 저장소를 연결하고 작업 기록을 업로드하겠습니다.
안티그래비티 채팅창에 다음 프롬프트를 입력합니다.
방금 GitHub에 빈 저장소를 만들었어.
저장소 주소는 다음과 같아.
[여기에 복사한 HTTPS 주소 입력]
이 주소를 원격 저장소(origin)로 등록하고, 현재까지의 커밋 기록을 main 브랜치로 push해줘. 실행 결과를 확인하고 한국어로 설명해줘.
AI가 명령어 실행을 요청하면 실행 내용을 확인한 후 허용합니다.
이때 GitHub 로그인이 필요할 수 있습니다.
GitHub 로그인 인증하기
Windows에서 처음 업로드할 때 로그인 인증을 요청할 수 있습니다.
로그인 창이 나타나지 않는다면 AI에게 다음과 같이 요청합니다.
브라우저 인증코드 방식으로 GitHub에 로그인하고 싶어. 인증코드를 받는 방법을 안내해줘.
인증코드를 받았다면 다음 순서로 진행합니다.
- 브라우저에서 GitHub Device Activation 페이지를 엽니다.
- 화면에 표시된 계정이 내 계정인지 확인합니다.
- AI가 알려준 8자리 인증코드를 입력합니다.
- Continue를 누릅니다.
- Authorize GitHub CLI를 선택합니다.
- 승인이 완료되면 안티그래비티로 돌아갑니다.
인증코드는 본인 확인을 위한 일회성 코드입니다. 다른 사람에게 전달하거나 공개하지 마세요.
Push 성공 여부 확인하기
업로드가 완료되면 다음과 비슷한 결과를 확인할 수 있습니다.
Your branch is up to date with 'origin/main'
이 메시지가 나타나면 로컬 main 브랜치와 GitHub의 origin/main 브랜치가 최신 상태로 일치한다는 의미입니다.
8. GitHub에 파일이 제대로 올라갔는지 확인하기
AI가 성공했다고 알려주더라도 직접 확인하는 습관이 중요합니다.
다음 순서로 확인합니다.
- GitHub에서 방금 만든 저장소 페이지를 엽니다.
- 키보드의 F5를 눌러 새로 고침 합니다.
- 프로젝트 파일과 폴더가 표시되는지 확인합니다.
- 커밋 메시지가 보이는지 확인합니다.
- Commits를 눌러 저장 기록을 확인합니다.
파일 목록과 두 개의 커밋 기록이 모두 보인다면 정상적으로 업로드된 것입니다.
- 프로젝트 파일이 보이는가?
- 폴더 구조가 정상적으로 올라갔는가?
- 첫 번째 커밋 메시지가 보이는가?
- 두 번째 커밋 메시지가 보이는가?
9. Git과 GitHub 사용 중 자주 발생하는 오류
처음 Git을 사용할 때는 영어 오류 메시지가 나타날 수 있습니다.
당황하지 말고 오류 내용을 확인하면 대부분 해결할 수 있습니다.
① src refspec main does not match any
원인: main이라는 브랜치가 없거나 아직 커밋이 만들어지지 않은 경우입니다.
해결 프롬프트
② rejected (fetch first)
원인: GitHub 저장소에 이미 파일이나 커밋이 존재하는 경우입니다.
로컬 저장소와 원격 저장소의 기록이 서로 달라서 업로드가 거부될 수 있습니다.
해결 방법
먼저 두 저장소의 상태를 비교하도록 요청합니다.
무조건 저장소를 삭제하거나 강제 푸시하지 마세요. 기존 작업이 사라질 수 있습니다.
③ remote origin already exists
원인: 이미 origin이라는 원격 저장소가 등록되어 있는 상태입니다.
해결 프롬프트
④ GitHub 업로드가 로그인에서 멈춘 경우
원인: GitHub 인증이 완료되지 않은 상태일 수 있습니다.
브라우저 인증코드 방식으로 로그인하고 승인을 완료했는지 확인합니다.
⑤ GitHub 페이지에 파일이 보이지 않는 경우
원인: Push가 완료되지 않았거나 다른 저장소에 연결되었을 수 있습니다.
해결 프롬프트
10. 여러 사람이 사용하는 컴퓨터라면 로그아웃하기
교육장이나 공용 컴퓨터에서 GitHub에 로그인했다면 작업이 끝난 후 로그아웃해야 합니다.
로그인 정보가 컴퓨터에 남아 있으면 다음 사용자가 내 계정으로 작업할 위험이 있습니다.
다음 두 가지를 진행합니다.
① GitHub 웹사이트에서 로그아웃
- GitHub 오른쪽 위 프로필 사진을 누릅니다.
- Sign out을 선택합니다.
- 로그아웃이 완료되었는지 확인합니다.
② 컴퓨터에 저장된 인증 정보 정리하기
안티그래비티에 다음과 같이 요청할 수 있습니다.
이 컴퓨터에 저장된 GitHub CLI 로그인 정보와 Git Credential Manager의 GitHub 인증 정보를 확인하고 로그아웃해줘. Windows 자격 증명에 남아 있는 GitHub 관련 인증 정보도 확인해줘.
실행 전에 어떤 인증 정보가 삭제되는지 확인하고 허용해야 합니다.
개인 컴퓨터라면 매번 로그아웃할 필요는 없습니다.
11. 앞으로 Git을 사용하는 기본 습관
Git과 GitHub를 처음 설정하는 과정은 조금 복잡해 보일 수 있습니다.
하지만 한 번 설정해 놓으면 이후에는 훨씬 간단하게 사용할 수 있습니다.
프로젝트를 수정할 때마다 다음 과정을 반복하면 됩니다.
Git 기본 작업 순서
1단계. 프로젝트 수정
AI에게 필요한 기능이나 디자인 변경을 요청합니다.
2단계. 변경 사항 확인
웹사이트나 프로그램이 정상적으로 작동하는지 확인합니다.
3단계. 커밋 만들기
변경된 내용을 의미 있는 메시지와 함께 저장합니다.
4단계. GitHub에 푸시
저장한 작업 기록을 인터넷 저장소에 업로드합니다.
5단계. 업로드 확인
GitHub에서 파일과 커밋 기록을 확인합니다.
이 과정을 습관화하면 작업 중 문제가 발생해도 이전 기록을 확인할 수 있습니다.
12. Git과 GitHub 핵심 용어 정리
- Git: 파일의 변경 기록을 관리하는 도구
- GitHub: Git 저장소를 인터넷에서 관리하는 서비스
- Repository: 프로젝트의 파일과 기록을 관리하는 저장소
- Commit: 작업 상태를 기록하는 과정
- Push: 로컬 커밋을 원격 저장소에 업로드하는 과정
- Remote: 내 컴퓨터 외부에 있는 원격 저장소
- Branch: 독립적인 작업 흐름을 관리하는 가지
- main: 일반적으로 사용하는 기본 브랜치 이름
- git status: 현재 파일 변경 상태를 확인하는 명령어
- git log: 과거 커밋 기록을 확인하는 명령어
마무리: 바이브코딩을 한다면 Git은 필수 도구
AI 코딩 도구의 발전으로 프로그래밍을 잘 모르는 사람도 웹사이트와 프로그램을 만들 수 있는 시대가 되었습니다.
하지만 프로그램을 만드는 것만큼 중요한 것이 작업 결과를 안전하게 보관하는 것입니다.
Git은 작업 과정을 기록하고, GitHub는 그 기록을 인터넷에 보관하는 역할을 합니다.
처음에는 커밋과 푸시 같은 용어가 낯설 수 있습니다.
하지만 오늘 소개한 순서대로 한 번만 따라 해 보면 어렵지 않게 사용할 수 있습니다.
① Git은 내 컴퓨터에서 작업 기록을 저장합니다.
② GitHub는 작업 기록을 인터넷에 보관합니다.
③ 중요한 작업을 마칠 때마다 커밋하고 푸시하는 습관을 들이세요.
다음 단계에서는 GitHub에 올린 프로젝트를 Vercel과 연결하여 실제 인터넷에서 누구나 접속할 수 있는 웹사이트로 배포하는 방법을 배워보면 좋습니다.
참고 자료: 스마택트 바이브코딩 4차시 - 세이브 포인트, 깃과 깃허브
원본 학습 자료 보기
