시리즈 홈
SEMINAR · 01 기본기 · GIT & GITHUB

최소한의
Git & GitHub

만든 것을 잃어버리지 않고,
링크 하나로 공유하는 법.

명령어는 외우지 않습니다. 에이전트에게 말로 시킵니다.
첫 커밋 → 사내 GitHub에 올리기 → 웹 주소로 공개 · 90분

💬 오늘 가장 많이 쓸 문장
지금까지 작업한 것 커밋하고,
사내 깃헙에 올려줘.

실습 세 개를 끝내면 내 앱이 사내 URL로 열립니다.

3분 요약 · TL;DR

결론부터 — 이 세 줄이면 됩니다

Git은 세이브 포인트입니다. 명령어는 외우지 말고 에이전트에게 말로 시키세요.

  1. 1
    잘 될 때마다 "커밋해줘" — 망가지면 한 문장으로 되돌립니다"_진짜최종_v3" 파일 대신 이력이 남습니다. AI가 빨리 고칠수록 더 자주.
  2. 2
    업무 코드는 사내 GitHub에만github.com은 개인 실험용입니다. 헷갈리면 사내 쪽이 정답.
  3. 3
    GitHub Pages — 저장소가 곧 웹사이트Settings → Pages → main · /(root) → Save. 진입 파일은 index.html, 경로는 상대 경로로.
지금 바로 써 보는 프롬프트
이 폴더를 git 저장소로 만들고, 지금 상태를 "첫 버전"으로 커밋해줘.
.env나 키 같은 민감한 파일이 있으면 커밋하기 전에 .gitignore에 넣고 알려줘.
이럴 때 이 덱을 다시 펼치세요
  • AI가 고친 뒤로 오히려 망가져서 되돌리고 싶을 때
  • 만든 도구를 링크 하나로 공유하고 싶을 때
  • 배포했는데 화면이 하얗거나 404가 뜰 때
오늘의 순서 · 이론 30% + 실습 70%

90분 뒤, 내 앱이 사내 URL로 열립니다

🧠 CH 1 · 단어 6개

저장소 · 커밋 · 브랜치 · 푸시 · 풀 · PR. 이 여섯 개면 오늘 내용이 다 읽힙니다.

🏢 CH 2 · 사내 GitHub

첫 커밋 → 사내 GitHub에 올리기 → 되돌리기. 끝나면 내 저장소 페이지가 생깁니다.

🚀 CH 3 · Pages 배포

Pages를 켜서 URL 한 줄로 공유. 화면이 깨질 때 보는 체크리스트까지.

모든 사용법은 프롬프트(말로 시키기)가 먼저입니다. 명령어는 각 장 아래 점선 상자에 참고용으로만 둡니다.

CH 1 · GIT, 딱 필요한 만큼

파일명에 "_최종"을 붙이는 대신, Git이 이력을 남깁니다

📄 보고서_v1.pptx 3월 2일
📄 보고서_최종.pptx 3월 9일
📄 보고서_진짜최종.pptx 3월 10일
📄 보고서_진짜최종_수정2.pptx 3월 11일 새벽 2시

Git을 쓰면

파일은 하나. 바꿀 때마다 "언제·무엇을·왜"가 기록됩니다.

"3월 9일 버전으로 돌아가줘"가 언제든 됩니다.

코드만이 아니라 폴더 안의 모든 파일에 쓸 수 있습니다.

CH 1 · GIT, 딱 필요한 만큼

AI가 빨리 고칠수록 세이브 포인트는 촘촘해야 합니다

🎮 잘 될 때 저장

게임에서 보스전 전에 저장하듯, 기능 하나가 잘 될 때마다 커밋합니다.

🕰 한 문장으로 되감기

"아까 잘 되던 걸로 돌려줘"면 복구됩니다. 그래서 실험이 두렵지 않습니다.

🤖 조작은 에이전트가

코딩 에이전트는 git을 잘 다룹니다. 여러분은 원하는 결과만 말하면 됩니다.

AI는 한 번에 파일 여러 개를 고칩니다. 잘 되던 상태를 잃기도 그만큼 쉽습니다 — "기능 하나 = 커밋 하나".
CH 1 · GIT, 딱 필요한 만큼

단어 6개면 오늘 내용이 다 읽힙니다

1📦 저장소 repository프로젝트 폴더 + 그 폴더의 모든 기록
2💾 커밋 commit세이브 포인트 — 지금 상태를 기록
3🌿 브랜치 branch본편을 건드리지 않는 작업용 사본
4⬆️ 푸시 push내 기록을 GitHub에 올리기
5⬇️ 풀 pullGitHub의 최신 내용을 내려받기
6🙏 PR pull request"내 작업을 본편에 합쳐 주세요" + 리뷰

rebase, stash 같은 다른 용어가 나오면? — 에이전트가 압니다. 궁금하면 "쉬운 말로 설명해줘"라고 물으면 됩니다.

CH 1 · GIT, 딱 필요한 만큼

Git은 내 컴퓨터의 기록, GitHub는 그 기록을 올려 두는 곳

📷 Git — 프로그램

내 폴더의 커밋을 만들고, 되돌리고, 브랜치를 나눕니다.

인터넷이 없어도 동작합니다.

☁️ GitHub — 웹 서비스

저장소를 보관·공유하고, 동료와 리뷰(PR)하고, 웹사이트(Pages)로 내보냅니다.

사진(Git)과 사진 앨범 서비스(GitHub)의 관계.

GitLab·Bitbucket도 같은 역할의 서비스입니다. 오늘은 회사가 쓰는 GitHub 기준으로 설명합니다.

CH 2 · 사내 GITHUB

GitHub는 두 개 — 업무 코드는 사내 GitHub에만

🌍 github.com

인터넷의 GitHub · 개인 이메일로 만든 개인 계정

· 오픈소스, 개인 공부, 토이 프로젝트용
· Public 저장소는 전 세계 누구나 봅니다

🏢 github.company.net

회사가 관리하는 GitHub Enterprise · 회사 계정(SSO)

· 업무 코드·문서는 반드시 여기
· 회사 설정에 따라 사내망에서만 열립니다

🚨 둘은 화면이 거의 똑같습니다. 올리기 전에 주소창을 보세요 — 다른 것은 주소, 계정, 그리고 "누가 볼 수 있는가"입니다.
CH 2 · 사내 GITHUB

어디에 올릴지는 질문 하나로 정합니다

Q1회사 코드·데이터·문서가 조금이라도 들어 있다→ 🏢 사내 GitHub
Q2회사 정보가 전혀 없는 개인 공부·취미→ 🌍 github.com (개인 계정)
Q3애매하다, 잘 모르겠다→ 🏢 사내 GitHub

💡 브라우저를 나누기

업무용 브라우저에는 github.company.net만 로그인해 둡니다. 계정이 섞이면 실수가 시작됩니다.

🔍 에이전트에게도 알려 주기

"이 프로젝트의 원격 저장소는 사내 GitHub야" 한 번이면 주소를 헷갈리지 않습니다.

CH 2 · 사내 GITHUB

실습 장은 모두 같은 모양 — 말로 시키고, 눈으로 확인

💬 이렇게 말하세요
하고 싶은 일을 한국어로 그대로.
정확한 용어가 아니어도 됩니다.

🔧 수동으로 하려면 — 참고용

$ 직접 치는 명령어. 몰라도 됩니다.

✅ 완료 기준

이 화면이 보이면 성공 — 다음 장으로.

🧯 막히면

에러 메시지를 통째로 복사해 에이전트에게 붙여 넣기.

에이전트가 "기록을 지울까요?", "강제로 올릴까요?"라고 되물으면 — 읽고 나서 답하세요.

🖐 실습 0 · 준비 (5분)

git이 내 이름으로 기록하게 설정합니다

배우는 것 — 커밋에는 "누가 했는지"가 남습니다. 처음 한 번만 이름과 회사 이메일을 알려 주면 됩니다.

💬 에이전트에게 이렇게 말하세요
git이 설치돼 있는지 확인해줘. 없으면 설치 방법을 알려주고,
커밋에 쓸 이름은 "홍길동", 이메일은 회사 메일로 설정해줘.

🔧 수동으로 하려면

git --version
git config --global user.name  "홍길동"
git config --global user.email "hong@company.com"

✅ 완료 기준

  • 에이전트가 git version 2.x처럼 버전 번호를 보여 준다
  • 설정된 이름·이메일이 화면에 출력된다
  • 브라우저에서 github.company.net에 로그인된다

🧯 막히면

설치 권한이 없다는 메시지 → 사내 소프트웨어 설치 절차로. 사내 GitHub 계정이 없다면 오늘은 짝꿍 화면으로 따라갑니다.

🖐 실습 1 · 첫 세이브 포인트 (5분)

내 폴더를 저장소로 만들고 첫 커밋을 남깁니다

배우는 것 — 커밋 한 번 = 되돌아올 수 있는 지점 하나. 민감한 파일은 처음부터 기록에서 뺍니다.

💬 에이전트에게 이렇게 말하세요
이 폴더를 git 저장소로 만들고 "첫 버전"으로 커밋해줘.
.env·키·개인 데이터 파일이 있으면 커밋 전에
.gitignore에 넣고 무엇을 뺐는지 알려줘.

🔧 수동으로 하려면

git init && git add -A && git commit -m "첫 버전"

✅ 완료 기준

  • "커밋 목록 보여줘" → 첫 버전 한 줄이 보인다
  • "커밋 안 된 변경 있어?" → 없다고 답한다
  • 제외한 파일이 있으면 그 목록을 들었다

🧯 막히면

"Author identity unknown" → 실습 0의 이름·이메일 설정을 다시. 폴더 안의 숨은 .git은 기록 보관함이니 지우지 않습니다.

🖐 실습 2 · 사내 GitHub에 올리기 (10분)

push 한 번이면 내 기록이 사내 GitHub에 백업됩니다

1웹에서 저장소 만들기

New repository → 이름 my-first-app → 공개 범위 Private 또는 Internal → Create

💬 2 · 에이전트에게 이렇게 말하세요
사내 깃헙에 저장소를 만들었어:
https://github.company.net/내아이디/my-first-app
여기를 원격으로 연결하고 지금까지 커밋을 푸시해줘.

🔧 수동으로 하려면

git remote add origin https://github.company.net/내아이디/my-first-app.git
git push -u origin main

✅ 완료 기준 — 3 · 브라우저 새로고침

  • 저장소 페이지에 내 파일 목록이 보인다
  • 맨 위에 커밋 메시지 첫 버전이 보인다
  • .env 같은 제외 파일은 안 보인다

🧯 막히면

  • 비밀번호·토큰을 묻는다 → "사내 깃헙 인증 방법 알려줘". 보통 Personal access token이나 SSO 승인입니다.
  • 토큰을 대화창에 붙여 넣지 마세요 — 로그인 창이나 자격 증명 관리자에 넣습니다.
🖐 실습 3 · 매일의 리듬 (5분)

고치고 → 확인하고 → 커밋·푸시, 이 네 박자를 반복합니다

STEP 1🎨 고치기

에이전트와 기능 수정

STEP 2👀 확인

브라우저에서 내 눈으로

STEP 3💾 커밋

잘 되는 상태를 저장

STEP 4⬆️ 푸시

사내 GitHub에 백업

💬 STEP 3+4를 한 번에
제목 글자색을 파란색으로 바꿔줘.
잘 되면 변경사항을 커밋하고 푸시해줘.

✅ 완료 기준

  • 사내 GitHub 저장소의 커밋 수가 2가 된다
  • 두 번째 커밋을 눌러 바뀐 줄(초록·빨강)을 본다
🖐 실습 4 · 되돌리기 (5분)

망했다? 한 문장이면 마지막 커밋으로 돌아갑니다

💬 방금 AI가 망쳤을 때
마지막 커밋 이후의 변경을 버리고 마지막 커밋 상태로 되돌려줘.
💬 예전에 잘 되던 버전으로
최근 커밋 목록을 보여줘. 어제 오후에 잘 되던 버전으로 돌아가고 싶어.

🔧 수동으로 하려면

git log --oneline   # 세이브 포인트 목록
git restore .       # 커밋 안 한 변경 버리기
git revert HEAD     # 마지막 커밋을 취소하는 커밋

✅ 완료 기준 — 일부러 망가뜨려 보기

  • "index.html 내용을 전부 지워줘" → 브라우저에서 빈 화면 확인
  • 첫 번째 프롬프트로 복구 → 새로고침하면 원래 화면

🧯 되돌려도 같은 에러가 반복되면

되돌리기는 응급처치입니다. 원인을 찾는 법은 → 고칠수록 꼬일 때 — AI와 함께 디버깅하기

🖐 실습 5 · 브랜치 & PR — 팀 작업이 시작될 때 (10분)

본편(main)은 그대로 두고, 새 기능은 브랜치에서 만듭니다

💬 브랜치에서 작업 시작
feature/dark-mode 브랜치를 만들어서 거기서 다크 모드를 추가해줘.
💬 끝나면 PR
푸시하고 main으로 Pull Request를 만들어줘. 제목과 설명도 채워줘.

🔧 수동으로 하려면

git switch -c feature/dark-mode
# 작업 후 push → 웹에서 "Compare & pull request"

✅ 완료 기준

  • 사내 GitHub의 Pull requests 탭에 내 PR이 열려 있다
  • Files changed에서 바뀐 줄이 보인다
  • Merge 후 main에 다크 모드가 들어온다

혼자 하는 프로젝트라면 당분간 main에 바로 커밋해도 됩니다. 동료와 같은 저장소를 쓰기 시작하면 이 장으로 돌아오세요.

CH 2 · 사내 GITHUB

막히면 상황을 그대로 말하세요 — 용어는 몰라도 됩니다

⚔️ "충돌(conflict)이 났대요"충돌 났어. 안전하게 해결해줘. 판단이 애매한 부분은 나한테 물어봐.
🕵️ "뭐가 바뀌었는지 모르겠어요"어제 이후 변경사항을 쉬운 말로 요약해줘.
🤝 "동료의 최신 코드를 받고 싶어요"원격의 최신 내용을 받아와줘(pull). 내 작업과 겹치면 알려줘.
🚫 "푸시가 거부됐어요"푸시가 거부됐어. 원인을 설명하고 안전하게 해결해줘. 강제 푸시는 하지 마.
📥 "동료 저장소를 받고 싶어요"이 주소를 클론해줘: https://github.company.net/팀/저장소
🔑 "API 키를 커밋해 버렸어요"키를 먼저 재발급하고, 그다음 "코드에서 키를 빼고 .gitignore 처리해줘".

에러 메시지는 요약하지 말고 통째로 붙여 넣기 — 비개발자가 쓸 수 있는 가장 강한 기술입니다.

CH 3 · 내 웹앱 배포

GitHub Pages — 저장소가 곧 웹사이트가 됩니다

1내 저장소

html · css · js 파일들 (진입 파일은 index.html)

→
2Pages 켜기

저장소 Settings에서 클릭 몇 번

→
3URL 완성

서버 없이 · 푸시하면 자동 반영

🏢 사내 GitHub

https://pages.company.net/아이디/저장소/

회사 설정에 따라 주소 형태가 다를 수 있습니다. 보는 사람 범위는 저장소 권한을 따릅니다.

🌍 github.com (개인)

https://아이디.github.io/저장소/

무료 계정은 Public 저장소에서만 Pages가 됩니다 — 즉 전 세계 공개.

되는 것: 계산기·대시보드·소개 페이지처럼 브라우저에서만 도는 앱. 안 되는 것: DB·로그인 같은 서버 기능.

CH 3 · 내 웹앱 배포

배포 방식은 두 가지 — 오늘은 설정이 없는 branch 방식

⚙️ GitHub Actions 방식

푸시하면 자동으로 빌드·배포합니다. 강력하지만 사내에서는 러너·권한 설정이 필요한 경우가 많습니다.

오늘은 다루지 않음

🌿 Deploy from a branch

"이 브랜치의 파일을 그대로 웹에 내보내"라고 정해 두는 것. 설정 파일도 서버 지식도 필요 없습니다.

오늘의 방법

branch 방식으로 안 되는 일이 생기는 날, 그때 Actions를 배워도 늦지 않습니다.

🖐 실습 6 · 첫 배포 (10분)

Pages에서 main을 고르면, 1~2분 뒤 URL이 생깁니다

1점검 맡기기

아래 프롬프트로 진입 파일·경로 확인

→
2Settings → Pages

저장소 위쪽 Settings, 왼쪽 메뉴 Pages

→
3Branch 선택

Deploy from a branch · main · /(root) → Save

→
4접속

같은 화면 위쪽에 뜨는 URL 클릭

💬 1 · 배포 전 점검
이 앱을 GitHub Pages(branch 방식)로 올릴 거야.
루트에 index.html이 있는지, css·js·이미지가
/저장소이름/ 아래에서도 열리는 상대 경로인지
점검해서 고치고 커밋·푸시해줘.

✅ 완료 기준

  • URL을 열면 내 앱이 로컬에서와 똑같이 보인다
  • 글자 하나 고쳐 푸시 → 1~2분 뒤 새로고침하면 반영된다
  • 옆자리 동료가 그 URL을 연다

🧯 막히면

Settings에 Pages 메뉴가 없다 → 사내에서 기능이 꺼져 있을 수 있습니다. 사내 GitHub 담당 조직에 문의. 화면이 깨지면 다음 장.

CH 3 · 내 웹앱 배포

배포 화면이 이상하면, 원인은 대개 이 여섯 중 하나입니다

🔍 주소에서 404진입 파일이 index.html이 아니거나, Pages가 보는 브랜치·폴더가 다릅니다.
⬜ 화면이 하얗다 · 스타일이 없다/style.css 같은 절대 경로 → ./style.css. 앱은 /저장소이름/ 아래에서 열립니다.
🔁 새로고침하면 404 (SPA)주소 기반 라우터 때문입니다. index.html을 404.html로 복사하거나 해시 라우팅으로.
📁 _로 시작하는 폴더가 안 보인다루트에 빈 .nojekyll 파일을 둡니다.
⏳ 고쳤는데 그대로다반영에 1~2분. 강력 새로고침 Ctrl+Shift+R.
🔒 동료가 못 연다 (사내)사내 Pages는 저장소 권한을 따릅니다. 동료를 초대하거나 Internal로.
💬 어느 것인지 모르겠으면
Pages에 올린 페이지가 깨져. 브라우저 콘솔 에러를 붙여 줄게 — 진입 파일·상대 경로·base 경로·404.html 중 원인을 찾아 고쳐줘.
🖐 실습 7 · 빌드가 필요한 앱(React·Vite) 배포 (10분)

React·Vite 앱은 소스가 아니라 빌드 결과물을 올립니다

배우는 것 — 소스는 main에, 완성품(dist)은 gh-pages 브랜치에. 공장과 진열대를 나누는 것입니다.

💬 에이전트에게 이렇게 말하세요
이 앱을 GitHub Pages에 branch 방식으로 배포하고 싶어.
1) base 경로를 /저장소이름/ 으로 설정하고
2) 빌드해서 dist를 gh-pages 브랜치로 올려줘.
3) Pages 설정에서 뭘 골라야 하는지 알려줘.

🔧 수동으로 하려면

npm run build
npx gh-pages -d dist   # Pages 설정: gh-pages · /(root)

✅ 완료 기준

  • 저장소 브랜치 목록에 gh-pages가 생긴다
  • URL에서 앱이 뜨고, 다른 화면으로 이동한 뒤 새로고침해도 404가 없다
💬 다음부터는
수정한 내용으로 다시 배포해줘.
⚠️ 시리즈 공통 · 보안 약속

보안 약속 3가지 — 모든 덱에서 같습니다

1회사 기밀·실데이터는 사내 승인 도구에서만 — 애매하면 넣지 않는다.저장소도 같습니다. 업무 코드는 github.company.net, github.com이 아닙니다.
2API 키·비밀번호는 코드·대화·커밋에 남기지 않는다 — 새어 나갔다면 삭제가 아니라 재발급.한 번 푸시된 키는 기록을 지워도 누군가 봤다고 가정합니다.
3회사 정책이 이 자료보다 우선한다.공개 범위·외부 게시 절차는 사내 규정을 따릅니다.
이 덱에서 하나 더 .env·키 파일은 첫 커밋 전에 .gitignore로, 그리고 Public 저장소·Pages는 "게시"입니다 — 올리기 전에 고객 정보·미공개 수치가 없는지 한 번 봅니다.

왜 이 세 가지인지는 → 사내 환경에서의 AI — 보안과 거버넌스

부록 · 프롬프트 치트시트

오늘 쓴 문장 14개 — 이 장만 찍어 가세요 📸

시작이 폴더를 git 저장소로 만들고 "첫 버전"으로 커밋해줘
연결+업로드이 주소를 원격으로 연결하고 푸시해줘: https://github.company.net/…
일상 저장변경사항 보기 좋게 커밋하고 푸시해줘
상태 확인커밋 안 된 변경이 뭐가 있는지 요약해줘
되돌리기마지막 커밋 상태로 되돌려줘 / 커밋 목록 보여줘
받아오기원격의 최신 내용을 받아와줘 (pull)
복제이 저장소를 클론해줘: https://github.company.net/…
브랜치feature/○○ 브랜치 만들어서 거기서 작업해줘
PR푸시하고 main으로 Pull Request 만들어줘. 설명도 채워줘
충돌충돌 났어. 안전하게 해결해줘. 애매하면 물어봐
배포 점검Pages에 올릴 거야. index.html·상대 경로 점검하고 커밋·푸시해줘
배포 깨짐Pages 화면이 깨져. 콘솔 에러 보고 경로·404 문제 고쳐줘
보안커밋 전에 키·비밀번호가 들어 있는지 검사해줘
배우기방금 네가 한 git 작업을 초보자에게 설명하듯 알려줘

같은 표가 저장소의 github/README.md에도 있습니다 — 복사해서 쓰세요.

마무리

커밋은 자주, 업무는 사내에, 공유는 URL로

1기능이 잘 될 때마다 "커밋해줘"
2업무 코드는 github.company.net
3만든 것은 Pages로 — URL 한 줄로 공유

🔗 다음에 펼칠 덱

다른 회사에서도 쓸 수 있습니다 — 사내 주소 표기는 github/index.html 상단 SEMINAR_CONFIG 또는 ?ghe= 파라미터로 바꿉니다.