코드를 고칠 때마다 재고조회_최종_진짜최종.html 같은 파일이 늘어나고 있다면, 이미 GitHub가 필요한 상황입니다. 이 자료는 GitHub를 코딩을 몰라도 이해할 수 있게 식당 하나에 빗대어 설명합니다. 프로그램은 식당의 메뉴, 코드는 레시피, GitHub는 레시피를 고칠 때마다 기록해 두는 금고입니다.
위 영상(약 2분)으로 흐름을 먼저 보시고, 자세한 내용은 아래 첨부한 PDF(20쪽, 읽는 데 10분)를 보시면 됩니다. 개발 도구 3종 시리즈의 첫 편이고, 다음 편은 Vercel(매장)과 Supabase(창고·장부)입니다.
이 자료로 알게 되는 것
- GitHub가 왜 필요한지 — 파일 이름에 "최종"을 붙여 버전을 관리하는 문제를 어떻게 없애 주는지
- 용어 다섯 개의 뜻 — 저장소, 커밋, 푸시, 되돌리기, 비공개
- AI 코딩 도구(Claude Code 등)에게 뭐라고 말하면 되는지
GitHub 용어를 주방 말로 바꾸면
| GitHub 용어 | 주방 말로 하면 |
|---|---|
| 저장소 (repository) | 메뉴 하나의 레시피 바인더 |
| 커밋 (commit) | "이번 판" 레시피 확정 |
| 히스토리 (log) | 바인더 앞장의 수정 기록표 |
| 되돌리기 (revert) | "지난번 맛이 나았어" — 그 판 꺼내기 |
| 푸시 (push) | 본사 금고에 사본 맡기기 |
Git과 GitHub는 다른 것입니다. Git은 내 PC 안에서 기록하는 방법이고, GitHub는 그 기록을 맡기는 인터넷 위의 금고입니다.
AI 코딩 도구에게 이렇게 말하면 됩니다
| 이렇게 말하면 | 도구가 하는 일 |
|---|---|
| 여기까지 저장해줘 | 커밋 — 지금 상태를 한 판으로 확정 |
| GitHub에 올려줘 | 푸시 — 쌓인 판들을 금고로 |
| 지금까지 저장 기록 보여줘 | 수정 기록표 보기 |
| 아까 저장한 데로 돌려줘 | 이전 판으로 되돌리기 |
| 어제랑 지금 뭐가 달라졌어? | 두 판 사이에 바뀐 곳 보기 |
명령어는 외울 필요가 없습니다. 언제 저장할지만 정하시면 됩니다. 잘 될 때마다 "여기까지 저장해줘", 하루를 마칠 때 "GitHub에 올려줘" 정도면 충분합니다.
꼭 지킬 것 두 가지
- 저장소는 항상 비공개(Private)로 만듭니다. 공개로 만들면 누구나 볼 수 있습니다. AI 도구에게도 "비공개로 올려줘"라고 말하세요.
- API 키나 비밀번호를 코드에 적은 채 올리지 않습니다. 한 번 올라간 키는 지워도 수정 기록에 남아서, 키를 새로 발급받아야 합니다. "키는 .env에 두고 .gitignore에 넣어줘"라고 말하면 됩니다.
용어를 더 알고 싶으면 커밋? 푸시? 브랜치? — 초보자를 위한 GitHub 용어 사전도 함께 보세요. 궁금한 점은 Teams로 편하게 물어봐 주세요.