만든 것을 잃어버리지 않고,
링크 하나로 공유하는 법.
명령어는 외우지 않습니다. 에이전트에게 말로 시킵니다.
첫 커밋 → 사내 GitHub에 올리기 → 웹 주소로 공개 · 90분
지금까지 작업한 것 커밋하고, 사내 깃헙에 올려줘.
실습 세 개를 끝내면 내 앱이 사내 URL로 열립니다.
Git은 세이브 포인트입니다. 명령어는 외우지 말고 에이전트에게 말로 시키세요.
이 폴더를 git 저장소로 만들고, 지금 상태를 "첫 버전"으로 커밋해줘. .env나 키 같은 민감한 파일이 있으면 커밋하기 전에 .gitignore에 넣고 알려줘.
저장소 · 커밋 · 브랜치 · 푸시 · 풀 · PR. 이 여섯 개면 오늘 내용이 다 읽힙니다.
첫 커밋 → 사내 GitHub에 올리기 → 되돌리기. 끝나면 내 저장소 페이지가 생깁니다.
Pages를 켜서 URL 한 줄로 공유. 화면이 깨질 때 보는 체크리스트까지.
모든 사용법은 프롬프트(말로 시키기)가 먼저입니다. 명령어는 각 장 아래 점선 상자에 참고용으로만 둡니다.
파일은 하나. 바꿀 때마다 "언제·무엇을·왜"가 기록됩니다.
"3월 9일 버전으로 돌아가줘"가 언제든 됩니다.
코드만이 아니라 폴더 안의 모든 파일에 쓸 수 있습니다.
게임에서 보스전 전에 저장하듯, 기능 하나가 잘 될 때마다 커밋합니다.
"아까 잘 되던 걸로 돌려줘"면 복구됩니다. 그래서 실험이 두렵지 않습니다.
코딩 에이전트는 git을 잘 다룹니다. 여러분은 원하는 결과만 말하면 됩니다.
rebase, stash 같은 다른 용어가 나오면? — 에이전트가 압니다. 궁금하면 "쉬운 말로 설명해줘"라고 물으면 됩니다.
내 폴더의 커밋을 만들고, 되돌리고, 브랜치를 나눕니다.
인터넷이 없어도 동작합니다.
저장소를 보관·공유하고, 동료와 리뷰(PR)하고, 웹사이트(Pages)로 내보냅니다.
사진(Git)과 사진 앨범 서비스(GitHub)의 관계.
GitLab·Bitbucket도 같은 역할의 서비스입니다. 오늘은 회사가 쓰는 GitHub 기준으로 설명합니다.
인터넷의 GitHub · 개인 이메일로 만든 개인 계정
· 오픈소스, 개인 공부, 토이 프로젝트용
· Public 저장소는 전 세계 누구나 봅니다
회사가 관리하는 GitHub Enterprise · 회사 계정(SSO)
· 업무 코드·문서는 반드시 여기
· 회사 설정에 따라 사내망에서만 열립니다
업무용 브라우저에는 github.company.net만 로그인해 둡니다. 계정이 섞이면 실수가 시작됩니다.
"이 프로젝트의 원격 저장소는 사내 GitHub야" 한 번이면 주소를 헷갈리지 않습니다.
하고 싶은 일을 한국어로 그대로. 정확한 용어가 아니어도 됩니다.
🔧 수동으로 하려면 — 참고용
$ 직접 치는 명령어. 몰라도 됩니다.
✅ 완료 기준
이 화면이 보이면 성공 — 다음 장으로.
🧯 막히면
에러 메시지를 통째로 복사해 에이전트에게 붙여 넣기.
에이전트가 "기록을 지울까요?", "강제로 올릴까요?"라고 되물으면 — 읽고 나서 답하세요.
배우는 것 — 커밋에는 "누가 했는지"가 남습니다. 처음 한 번만 이름과 회사 이메일을 알려 주면 됩니다.
git이 설치돼 있는지 확인해줘. 없으면 설치 방법을 알려주고, 커밋에 쓸 이름은 "홍길동", 이메일은 회사 메일로 설정해줘.
🔧 수동으로 하려면
git --version git config --global user.name "홍길동" git config --global user.email "hong@company.com"
✅ 완료 기준
🧯 막히면
설치 권한이 없다는 메시지 → 사내 소프트웨어 설치 절차로. 사내 GitHub 계정이 없다면 오늘은 짝꿍 화면으로 따라갑니다.
배우는 것 — 커밋 한 번 = 되돌아올 수 있는 지점 하나. 민감한 파일은 처음부터 기록에서 뺍니다.
이 폴더를 git 저장소로 만들고 "첫 버전"으로 커밋해줘. .env·키·개인 데이터 파일이 있으면 커밋 전에 .gitignore에 넣고 무엇을 뺐는지 알려줘.
🔧 수동으로 하려면
git init && git add -A && git commit -m "첫 버전"
✅ 완료 기준
🧯 막히면
"Author identity unknown" → 실습 0의 이름·이메일 설정을 다시. 폴더 안의 숨은 .git은 기록 보관함이니 지우지 않습니다.
New repository → 이름 my-first-app → 공개 범위 Private 또는 Internal → Create
사내 깃헙에 저장소를 만들었어: 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 · 브라우저 새로고침
🧯 막히면
에이전트와 기능 수정
브라우저에서 내 눈으로
잘 되는 상태를 저장
사내 GitHub에 백업
제목 글자색을 파란색으로 바꿔줘. 잘 되면 변경사항을 커밋하고 푸시해줘.
✅ 완료 기준
마지막 커밋 이후의 변경을 버리고 마지막 커밋 상태로 되돌려줘.
최근 커밋 목록을 보여줘. 어제 오후에 잘 되던 버전으로 돌아가고 싶어.
🔧 수동으로 하려면
git log --oneline # 세이브 포인트 목록 git restore . # 커밋 안 한 변경 버리기 git revert HEAD # 마지막 커밋을 취소하는 커밋
✅ 완료 기준 — 일부러 망가뜨려 보기
🧯 되돌려도 같은 에러가 반복되면
되돌리기는 응급처치입니다. 원인을 찾는 법은 → 고칠수록 꼬일 때 — AI와 함께 디버깅하기
feature/dark-mode 브랜치를 만들어서 거기서 다크 모드를 추가해줘.
푸시하고 main으로 Pull Request를 만들어줘. 제목과 설명도 채워줘.
🔧 수동으로 하려면
git switch -c feature/dark-mode
# 작업 후 push → 웹에서 "Compare & pull request"
✅ 완료 기준
혼자 하는 프로젝트라면 당분간 main에 바로 커밋해도 됩니다. 동료와 같은 저장소를 쓰기 시작하면 이 장으로 돌아오세요.
에러 메시지는 요약하지 말고 통째로 붙여 넣기 — 비개발자가 쓸 수 있는 가장 강한 기술입니다.
html · css · js 파일들 (진입 파일은 index.html)
저장소 Settings에서 클릭 몇 번
서버 없이 · 푸시하면 자동 반영
https://pages.company.net/아이디/저장소/
회사 설정에 따라 주소 형태가 다를 수 있습니다. 보는 사람 범위는 저장소 권한을 따릅니다.
https://아이디.github.io/저장소/
무료 계정은 Public 저장소에서만 Pages가 됩니다 — 즉 전 세계 공개.
되는 것: 계산기·대시보드·소개 페이지처럼 브라우저에서만 도는 앱. 안 되는 것: DB·로그인 같은 서버 기능.
푸시하면 자동으로 빌드·배포합니다. 강력하지만 사내에서는 러너·권한 설정이 필요한 경우가 많습니다.
오늘은 다루지 않음
"이 브랜치의 파일을 그대로 웹에 내보내"라고 정해 두는 것. 설정 파일도 서버 지식도 필요 없습니다.
오늘의 방법
branch 방식으로 안 되는 일이 생기는 날, 그때 Actions를 배워도 늦지 않습니다.
아래 프롬프트로 진입 파일·경로 확인
저장소 위쪽 Settings, 왼쪽 메뉴 Pages
Deploy from a branch · main · /(root) → Save
같은 화면 위쪽에 뜨는 URL 클릭
이 앱을 GitHub Pages(branch 방식)로 올릴 거야. 루트에 index.html이 있는지, css·js·이미지가 /저장소이름/ 아래에서도 열리는 상대 경로인지 점검해서 고치고 커밋·푸시해줘.
✅ 완료 기준
🧯 막히면
Settings에 Pages 메뉴가 없다 → 사내에서 기능이 꺼져 있을 수 있습니다. 사내 GitHub 담당 조직에 문의. 화면이 깨지면 다음 장.
Pages에 올린 페이지가 깨져. 브라우저 콘솔 에러를 붙여 줄게 — 진입 파일·상대 경로·base 경로·404.html 중 원인을 찾아 고쳐줘.
배우는 것 — 소스는 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)
✅ 완료 기준
수정한 내용으로 다시 배포해줘.
왜 이 세 가지인지는 → 사내 환경에서의 AI — 보안과 거버넌스
같은 표가 저장소의 github/README.md에도 있습니다 — 복사해서 쓰세요.
다른 회사에서도 쓸 수 있습니다 — 사내 주소 표기는 github/index.html 상단 SEMINAR_CONFIG 또는 ?ghe= 파라미터로 바꿉니다.