Week 03 · 목표

오늘 50분 후 — 가져갈 것 3가지

GitHub를 명령어 암기가 아니라 운영 기능으로 익힙니다. 한국어 6문장이면 끝 — 오늘 그 6문장을 직접 입력해 봅니다.

사전 준비 · 01 · OS별 설치 (3분)

터미널에서 설치 명령 한 줄

본인 운영체제에 맞는 터미널을 열고 아래 명령을 실행합니다. 과정 중 설치 또는 관리자 권한 확인이 나오면 내용을 확인하고 승인합니다.

공식 설치 출처: cli.github.com · GitHub CLI 저장소의 Windows/Linux 설치 안내

사전 준비 · 02 · 설치 확인 (2분)

gh --version이 보이면 설치 완료

설치 직후에는 새 터미널을 열어 PATH를 다시 읽게 합니다. 버전 확인까지 성공해야 다음 실습으로 넘어갑니다.

✓ 여기서는 설치만 확인합니다. GitHub 계정 인증은 PART 03 첫 실습에서 브라우저로 진행합니다.

개론 · 1.1 · GitHub이 뭔가요

GitHub = 무한 ctrl+z + 공유 가능한 폴더

파일이 바뀐 모든 시점이 자동 저장됩니다. 언제든 되돌릴 수 있고, 누구든 링크 한 줄로 받아 갈 수 있어요.

📌 핵심 — 파일 이름으로 버전을 관리하지 않습니다. "한 개 파일 + 시점 기록"이 GitHub의 본질.

개론 · 1.2 · 어떻게 쓰나요

3 동사로 끝 — 올린다 · 받는다 · 되돌린다

하루의 GitHub 사용은 거의 항상 이 3가지 동작 안에서 일어납니다. 다른 건 변종일 뿐.

💡 오늘 실습 — 이 3 동사를 전부 본인 손으로 Claude에게 시켜 봅니다

개론 · 1.3 · 왜 쓰나요

GitHub 사용 이유

"왜 굳이 복잡한 걸 배우지?" — 답은 이 5가지를 매주 쓰게 되기 때문입니다.

→ 오늘 실습은 이 5가지 중 이전 버전 복구 · 백업 · 공개 URL 3가지를 직접 경험합니다

개론 · 1.4 · 바이브코딩 × GitHub

바이브코딩에서 GitHub가 특히 중요한 이유

바이브코딩은 한 번 시킬 때마다 코드 전체가 바뀝니다. 그래서 안전망이 없으면 오늘의 결과물을 내일 잃어버려요.

용어 · 2.1 · 알아만 두면 되는 7개

개발자가 자주 쓰는 7개 용어

앞으로 동료가 "PR 보내줘"라고 했을 때 멈칫하지 않을 정도면 충분합니다. 외우려 하지 마세요.

용어 · 2.2 · ⭐ 핵심

명령어는 짧게 — 우리는 Claude로 한다

CLI 명령어는 30개가 넘어요. 다 외우는 건 개발자의 일. 우리는 한국어 한 줄이면 됩니다.

💡 git 명령어 30개 → 한국어 6문장이면 일주일치 GitHub 사용 끝

실습 · STAGE 1.1 · 한 줄 입력 (1분)

채팅창에 — 폴더 이름 한 번

가정 — 앞단 사전 준비에서 GitHub 계정과 gh CLI 설치를 완료한 상태. 인증은 아직 하지 않아도 됩니다. 한 줄로 시작하면 Claude가 로그인부터 처리합니다.

💡 다음 화면 — Claude가 gh 설치 여부를 확인한 뒤 GitHub 브라우저 인증을 시작합니다.

실습 · STAGE 1.2 · 브라우저 로그인 (2분)

브라우저에서 — Authorize 한 번

터미널 명령은 Claude가 처리. 사용자는 평소 쓰는 브라우저에서 GitHub 로그인 → 떠 있는 페이지의 녹색 Authorize 버튼 한 번이면 끝.

✓ 한 번만 거치면 됩니다 — 다음부터 Claude가 알아서 인증 사용.

실습 · STAGE 1.3 · 자동 실행 (1분)

인증 끝 → Claude가 — 알아서 끝까지

인증된 직후 Claude는 1.1의 한 줄을 다시 꺼내 — repo 생성 → 첫 commit → push까지 한 호흡에 처리. 사용자는 가만히 보면 됩니다.

💡 한 줄로 시작했지만 — 내부적으로 6단계가 자동 진행. 다음 화면에서 결과 확인.

실습 · STAGE 1.4 · 결과 확인 (1분)

github.com에 — 본인 repo 보임

브라우저에서 github.com/{내아이디} 접속 — 새 repo가 보입니다. 누구나 클릭만으로 들어올 수 있는 공개 주소를 가입 직후 7분 만에 확보.

📌 다음 STAGE 2 — v2 슬라이드 추가도 같은 한 줄로. 인증·repo 생성은 끝.

실습 · STAGE 2 · 같은 파일 · 새 시점 (4분)

slides.html을 v2로 → 한 줄로 새 시점 저장

STAGE 1에서 slides.html(v1 상태)을 올렸습니다. 같은 파일을 v2로 개선해 다시 push — 이전 v1 시점은 GitHub에 그대로 남고, v2가 새 commit으로 추가됩니다. "v1 시점으로 돌려줘"가 가능한 이유.

→ 파일은 1개(slides.html), commit은 3개(시점 3개). 언제든 "v1로 돌려줘"·"v2로 돌려줘" 가능 — 이게 GitHub 본질.

실습 · STAGE 2 · v3 마무리 push (3분)

v3까지 — 패턴 한 번 더

v2 push와 완전히 같은 한 줄 패턴. slides.html을 v3로 마지막 다듬고 push — commit 시점 3개(v1·v2·v3)가 모두 GitHub에 보존됩니다.

→ GitHub Commits 페이지 → 시점 3개 보임. 이제 다음 STAGE 3 — 안전망(롤백) 사용해 봅니다.

실습 · STAGE 3 · ⏪ 롤백 — 이전 시점 복구 (4분)

실수했을 때 — "v2 시점으로 다시"

v3까지 push했는데 "v3가 별로네 — v2가 나았다" 싶으면 한 줄로 되돌리기. commit 시점 3개를 만들어 둔 덕분. 3가지 자주 쓰는 시나리오:

💡 안전 — Claude는 git reset --hard 같은 위험 명령은 확인 묻고 진행. 작업 사라질 일 거의 없음.

실습 · STAGE 3 보너스 · 🕰 VS Code Timeline (2분)

설치 없이 — VS Code Timeline에서 시점 비교

VS Code 내장 기능. 익스텐션 설치 불필요. 파일 1개 클릭 → 좌측 사이드바 하단 TIMELINE 탭 → slides.html의 v1·v2·v3 시점이 시간순으로 보입니다.

💡 STAGE 3 안전망의 시각화 — VS Code만 열면 v1·v2·v3 시점이 마우스 한 번에 비교됩니다.

실습 · STAGE 3 보너스 · 🚫 .gitignore (2분)

올리면 안 되는 파일 — .gitignore에 적어두기

GitHub은 공개 폴더입니다. 비밀번호·API 키는 한 번 push되면 인터넷에 영원히 박제 — 그래서 .gitignore 파일에 미리 적어두면 Claude가 자동으로 제외합니다. 안전망의 또 한 축.

PART 04 · STEP 1–2 · SETTINGS → COLLABORATORS

저장소에서 Settings → Collaborators

초대는 계정 전체 설정이 아니라, 공유할 저장소의 Settings에서 시작합니다.

1

공유할 저장소 열기

상단 메뉴에서 Settings를 누릅니다.

2

Access → Collaborators

개인 저장소는 Collaborators, 조직 저장소는 Collaborators and teams로 보일 수 있습니다.

3

Add people 선택

저장소 접근 권한을 줄 사람을 추가합니다.

화면 출처: GitHub Docs 공식 UI · 조직 저장소 예시라 Add teams가 함께 보이지만 개인 저장소에서는 Add people 흐름이 동일합니다.

PART 04 · STEP 3–5 · INVITE → ACCEPT

사용자명으로 초대하고 — 상대가 수락

초대 버튼을 눌렀다고 바로 끝나지 않습니다. 정확한 GitHub 계정을 고르고, 상대방이 초대를 수락해야 접근이 활성화됩니다.

PART 05 · STEP 1–5 · SETTINGS → PAGES

Deploy from a branch로 게시 설정

저장소의 Settings → Pages에서 게시할 브랜치와 폴더를 지정합니다.

1

Settings → Pages

왼쪽 메뉴의 Code and automation 아래 Pages 선택.

2

Source 선택

Deploy from a branch를 선택합니다.

3

Branch 선택

보통 main을 선택합니다.

4

Folder 선택

루트면 /(root), 문서 폴더면 /docs.

5

Save

저장하면 GitHub Actions가 첫 배포를 시작합니다.

① 게시 브랜치 선택

② 게시 폴더 선택 — main + /(root) 예시

화면 출처: GitHub Docs 공식 UI · Configuring a publishing source for your GitHub Pages site

PART 05 · STEP 6 · PUBLIC URL

배포 완료 후 — Visit site로 확인

Pages 설정 화면에 공개 URL이 나타나면 새 창과 로그인하지 않은 창에서 모두 열어봅니다.

https://github.github.io/gfm/

6

Visit site 클릭

표시된 https://계정.github.io/저장소/ 주소를 엽니다.

✓

3가지 확인

HTTP 200 · 첫 화면 정상 · CSS/이미지 경로 정상.

↻

업데이트 방법

main에 다시 push하면 자동 재배포됩니다.

완료 기준

다른 사람에게는 저장소 URL이 아니라 Pages 공개 URL을 전달합니다.

Week 03 마무리 · Week 04 준비

GitHub로 남긴 결과를 AI 실행 체계로 확장합니다

이번 주에는 결과물을 공유·복구 가능한 기록으로 만들었습니다. 다음 주에는 그 작업을 같은 품질로 반복하는 네 가지 엔지니어링을 연결합니다.

Next Week — Prompt · Context · Harness · Loop