🗒️ 게시판

11. 내 작업 폴더를 깃허브에 올리고 다시 받기 : 깃허브

교시
2교시
선택
진행 예정
시간
10:00~10:50
회차
3회차
🎯
미션 : 서울_바이브코딩 폴더를 깃허브에 올리고, 고쳐서 커밋한 뒤, 다시 클론해서 확인하기 1 · 2회차에 만든 것(CLAUDE.md · 스킬 · 웹페이지 · brd · prd)이 바탕화면 서울_바이브코딩 폴더에 모여 있습니다. 지금은 이 PC에만 있습니다. 오늘은 이 폴더를 깃허브에 올려 두고, 어느 PC에서든 다시 받아 쓸 수 있는지 확인합니다.
  • 터미널에는 claude 하나만 입력합니다. 나머지는 모두 채팅창에 말로 시킵니다
  • 오늘 만드는 저장소는 나만 보는 비공개(Private) 입니다
⏰
2교시 · 10:00~10:50
  • 📖 알아보기 : 깃허브란? · 무엇을 올리나 5분
  • 🛠️ 실습 Step 1 깃허브 가입 · 로그인 12분
  • 🛠️ 실습 Step 2 올리기 (첫 커밋) 13분
  • 🛠️ 실습 Step 3 깃허브에서 확인 5분
  • 🛠️ 실습 Step 4 고치고 커밋하기 8분
  • 🛠️ 실습 Step 5 다시 클론해서 확인 7분
📘
따라하는 법 · 2회차와 같습니다
  • 💬 채팅창 : 클로드 코드 입력창(> 표시가 있는 곳)에 그대로 붙여 넣고 Enter
  • ⌨️ 터미널 : 오늘은 claude 를 켤 때만 씁니다
  • 빨간 【 】는 내 내용으로 바꿔 넣는 자리입니다. 【 】 표시까지 지웁니다
  • 「이 명령을 실행해도 될까요?」 창이 뜨면 1. Yes 를 고릅니다
  • 각 Step 끝의 ✅ 가 보이면 다음 Step 으로 갑니다

한눈에 보는 실습 흐름

notion image
한 줄 요약 : 내 서울_바이브코딩 폴더를 깃허브(인터넷 저장소)에 올리고, 한 줄 고쳐서 다시 올린 뒤, 새 폴더로 다시 받아 봅니다.
실습 순서
무엇을 하나
이렇게 되면 성공
Step 1. 깃허브 들어가기
깃허브 계정을 만들고, 클로드에게 「로그인해줘」라고 합니다. 클로드가 알려 준 코드를 브라우저에 넣습니다
클로드가 「○○ 계정으로 로그인됐습니다」라고 알려 줌
Step 2. 내 폴더 올리기
클로드가 올릴 파일 목록을 먼저 보여 줍니다. 이름이나 전화번호가 있으면 가리고, 나만 보는 저장소에 올립니다
내 저장소 주소를 받음
Step 3. 잘 올라갔나 보기
깃허브 화면을 열어 봅니다
Private 표시가 있고, 엑셀 · PDF 는 없음
Step 4. 고치고 기록 남기기
CLAUDE.md 에 한 줄을 추가하고, 「무엇을 고쳤는지」 이름을 붙여 저장한 뒤(커밋) 다시 올립니다
깃허브에 저장 기록이 2개
Step 5. 다시 받아 보기
깃허브에 올린 폴더를 새 폴더로 통째로 내려받습니다(클론)
고친 줄이 들어 있고, 빠진 것은 엑셀 · PDF 뿐
📌
오늘의 결과물 : 서울_바이브코딩 이 들어 있는 비공개 저장소 1개(커밋 2개)와, 깃허브에서 다시 받은 seoul-vibe-clone 폴더
기억할 말 두 개 : 고쳤으면 「커밋하고 깃허브에 올려줘」, 다른 PC에서는 「깃허브에서 ○○ 리포지토리 클론해줘」

📖
📖 알아보기 · 실습 전에 5분. 깃허브가 무엇인지, 무엇을 올리고 무엇을 올리지 않는지 봅니다

1. 깃허브란?

🐙
깃허브(GitHub) = 폴더를 인터넷에 올려 두고, 고칠 때마다 무엇을 고쳤는지 기록을 남기는 저장소 서비스입니다. 마이크로소프트가 운영합니다. 원래는 개발자들이 코드를 관리하는 데 씁니다. 우리는 클로드 코드로 만든 폴더(CLAUDE.md · 스킬 · 웹페이지 · 문서)를 보관하고 다른 PC로 옮기는 데 씁니다.

왜 쓰나요?

notion image
좋은 점
예를 들면
① 어느 PC에서나 똑같이 받는다
회사 PC에서 만든 스킬과 CLAUDE.md 를 집 PC · 노트북에서 「클론해줘」 한 마디로 그대로 받는다
② 고친 기록이 남고, 되돌릴 수 있다
스킬을 고쳤는데 결과가 나빠졌다 → 「어제 커밋 전으로 되돌려줘」
③ 팀원과 나눠 쓸 수 있다
팀 공용 스킬을 한 저장소에 두고, 초대한 팀원만 받아 쓴다. 한 사람이 고치면 나머지는 「최신 내용 받아와줘」

구글 드라이브에 올리는 것과 무엇이 다른가요?

notion image
  • 구글 드라이브도 다른 PC로 옮길 수 있습니다. 차이는 계속 고치면서 쓸 때 나타납니다
  • 드라이브는 고칠 때마다 다시 올리고 다시 받아야 하고, 「최종 · 진짜최종」 파일이 쌓이기 쉽습니다.
  • 깃허브는 「최신 받아와줘」 한 마디에 바뀐 것만 오고, 무엇을 고쳤는지도 남습니다
  • 정리하면 업무 파일(엑셀 · PDF)은 드라이브, 에이전트 폴더(CLAUDE.md · 스킬)는 깃허브에 둡니다
비교
USB · 메일 첨부
구글 드라이브
깃허브
다른 PC로 옮기기
매번 손으로 옮긴다
된다
된다 (클로드에게 말 한 마디)
고친 기록
없다
파일별 버전만
폴더 전체를 「무엇을 고쳤는지」 이름과 함께 남긴다
클로드 코드에서
직접 옮겨야 한다
직접 옮겨야 한다
「올려줘」「받아줘」로 클로드가 한다

어떻게 쓰나요? 클로드에게 이렇게 말합니다

notion image
하고 싶은 것
깃허브에서 부르는 말
💬 클로드에게 이렇게
폴더를 처음 올리기
리포지토리(저장소) 만들기
「이 폴더를 비공개 리포지토리로 만들어서 올려줘」
고친 것을 기록으로 남기기
커밋 (commit)
「무엇을 고쳤는지 이름 붙여서 커밋해줘」
남긴 기록을 깃허브로 올리기
푸시 (push)
「깃허브에 올려줘」
다른 PC에서 처음 받기
클론 (clone)
「○○ 리포지토리를 바탕화면에 클론해줘」
이미 받은 폴더를 최신으로
풀 (pull)
「깃허브에서 최신 내용 받아와줘」
기록 보기
로그 (log)
「커밋 기록 보여줘」
예전 상태로 되돌리기
되돌리기 (revert)
「○○ 커밋 전으로 되돌려줘」
올리지 않을 파일 정하기
.gitignore
「엑셀 · PDF 는 올라가지 않게 .gitignore 에 넣어줘」

비공개(Private)와 공개(Public)

notion image
비공개 (Private)
공개 (Public)
누가 보나
나 + 내가 초대한 사람만
인터넷의 누구나 (검색에도 나옴)
언제 쓰나
회사 업무 폴더는 항상 이것
모두에게 공개해도 되는 자료만
요금
무료 (개수 제한 없음)
무료
💡
클로드에게 맡길 때 기억할 것 : 저장소를 만들 때는 항상 「비공개로」라고 말합니다. 「리포지토리는 항상 비공개로 만든다」를 CLAUDE.md 에 적어 두면 다음부터는 말하지 않아도 됩니다.

업무에서는 이렇게 씁니다

  • 내 에이전트 보관 : 2회차에 만든 my-agent-team 처럼 스킬 · 서브에이전트가 든 폴더를 올려 두고, PC를 바꿔도 클론해서 바로 씁니다
  • 팀 공용 스킬 : 팀장이 「주간 보고 스킬」을 한 저장소에 올리고 팀원을 초대 → 모두 같은 스킬로 같은 양식의 보고서를 만듭니다
  • 고친 이력 관리 : CLAUDE.md 규칙을 바꿀 때마다 커밋으로 남겨, 언제 왜 바꿨는지 나중에도 봅니다
  • 웹페이지 자동 배포 : 깃허브와 버셀을 연결해 두면, 올릴 때마다 웹페이지가 알아서 새로 배포됩니다 (오늘 범위는 아닙니다)

2. 무엇이 올라가고, 무엇이 안 올라가나

서울_바이브코딩 안의 것
깃허브에
이유
CLAUDE.md · 업무 맥락 문서
✅ 올린다
내 규칙과 업무 맥락. 거래처 실명이 있으면 가린 뒤 올린다
.claude/skills/ (2회차 스킬)
✅ 올린다
다른 PC에서도 같은 스킬을 쓴다
웹페이지 index.html · brd.md · prd.md · 어투 가이드
✅ 올린다
1회차 · 2회차에 만든 문서와 웹페이지
직무 데이터 엑셀 · 메일함 요약 엑셀
❌ 안 올린다
업무 데이터. 다른 PC에서는 그 PC의 파일을 쓴다
기획서 · 보고서 PDF, 워드 · PPT · 압축 파일
❌ 안 올린다
업무 파일과 결과물. 실제 숫자 · 거래처명이 들어 있을 수 있다
.env · .claude/settings.local.json
❌ 안 올린다
키와 이 PC에서만 쓰는 설정
메모리 (2회차 4교시)
➖ 따라가지 않음
메모리는 이 폴더가 아니라 내 사용자 폴더에 저장되어 있다. 다른 PC에서도 필요한 내용은 CLAUDE.md 에 적어 둔다
⚠️
시작 전에 확인
  • 회사 보안 규정에서 깃허브 사용이 허용되는지 확인합니다. 회사 망에서 깃허브가 열리지 않으면 강사에게 알려 주세요
  • 저장소는 반드시 비공개(Private) 로 만듭니다
  • 한 번 올라간 파일은 지워도 기록에 남습니다. 그래서 올리기 전에 목록을 먼저 확인합니다 (실습 Step 2)

🛠️
🛠️ 여기부터 실습입니다 · Step 1 → Step 5 를 순서대로 따라 합니다. 각 Step 끝의 ✅ 가 보이면 다음으로 갑니다

🛠️ 실습 Step 1. 깃허브 가입 · 로그인

notion image

① 깃허브 가입 (계정이 이미 있으면 ② 로)

  • 2) 화면의 칸을 위에서부터 채웁니다
화면의 칸
무엇을 쓰나
Email
지금 바로 열어 볼 수 있는 메일 주소. 회사 메일을 권하지만, 메일이 오지 않으면 개인 메일로 합니다
Password
15자 이상, 또는 8자 이상 + 숫자 1개 + 영문 소문자 1개. 회사 계정과 다른 비밀번호로 정하고 메모해 둡니다
Username
내 깃허브 이름. 영문 · 숫자 · 하이픈(-) 만 됩니다. 저장소 주소에 들어갑니다 (예 : kimminsu88 → github.com/kimminsu88). 이미 있는 이름이면 숫자를 붙입니다
Your Country/Region
South Korea
Email preferences (체크 상자)
소식 메일을 받을지 묻는 칸. 체크하지 않아도 됩니다
  • 3) Continue(또는 Create account)를 누릅니다
  • 4) 사람인지 확인하는 퍼즐이 나옵니다. 화면 안내대로 풀고 Submit
  • 5) 메일함에 깃허브가 보낸 숫자 코드(8자리)가 옵니다. 가입 화면의 칸에 그대로 입력합니다
  • 6) 로그인 화면이 나오면 방금 만든 Username(또는 Email)과 Password 로 로그인합니다
  • 7) 「팀이 몇 명인가요」 「무엇에 관심 있나요」 같은 질문 화면이 나오면 맨 아래 Skip personalization 을 누릅니다. 요금제를 묻는다면 Free(무료)를 고릅니다
✅
깃허브 첫 화면(Dashboard)이 열리고, 오른쪽 위 내 프로필 그림이 보이면 가입 끝
💡
  • 메일 코드가 안 오면 스팸함 · 프로모션함을 봅니다. 회사 메일이 막혀 있으면 개인 메일로 다시 가입합니다
  • 「2단계 인증(2FA)을 설정하세요」 안내가 나오면 오늘은 나중에(Remind me later) 를 눌러도 됩니다. 교육 뒤에는 휴대폰 인증 앱으로 꼭 설정해 두길 권합니다
  • Username 과 Password 를 메모해 둡니다. 집 PC에서 로그인할 때 다시 씁니다

② 클로드 코드 켜기

  • 바탕화면 서울_바이브코딩 폴더를 VS Code 로 열고, 메뉴 → 터미널 → 새 터미널
⌨️
입력 1-1 · 터미널 · 오늘 터미널에 치는 것은 이것 하나입니다
claude

③ 클로드에게 로그인 부탁하기 (깃허브 CLI는 1회차에 설치했습니다)

💬
입력 1-2 · 채팅창
깃허브에 로그인하고 싶어. gh auth login 을 브라우저 방식(HTTPS)으로 백그라운드에서 실행하고, 화면에 나오는 8자리 코드와 주소를 바로 알려줘. 인증은 내가 브라우저에서 할게.
  • 실행해도 되는지 묻는 창이 뜨면 1. Yes
  • 클로드가 8자리 코드(예 : A1B2-C3D4)와 주소 github.com/login/device 를 알려 줍니다
  • 브라우저로 그 주소를 열고 → 코드 입력 → Continue → Authorize github (비밀번호를 물으면 ① 에서 만든 것)
💬
입력 1-3 · 채팅창 · 브라우저에서 인증을 끝낸 뒤
브라우저에서 인증 끝냈어. 로그인됐는지 확인하고, git 도 이 깃허브 계정을 쓰게 설정해줘.
✅
클로드가 내 Username 으로 로그인되어 있다고 알려 주면 다음 Step

🛠️ 실습 Step 2. 올리기 (첫 커밋)

notion image
💬
입력 2-1 · 채팅창 · 올릴 목록 먼저 확인
이 폴더를 깃허브 비공개 리포지토리로 올리려고 해. 아직 올리지는 마.
1) .gitignore 를 만들어서 엑셀 · PDF · 워드 · PPT · 한글 · 압축 같은 업무 파일, .env, .claude/settings.local.json 은 올라가지 않게 해줘.
2) git 을 시작하고, 올라갈 파일 목록과 빠지는 파일 목록을 보여줘.
3) 올라갈 파일 안에 거래처 실명 · 사람 이름 · 전화번호 · 이메일 · 실제 금액이 있는지 찾아서 알려줘.
  • 올라갈 목록에 엑셀 · PDF 가 없는지 눈으로 확인합니다
  • 3)에서 실명 · 금액이 나오면 💬 「찾은 것을 ○○화주 · ○○과장처럼 가려줘」라고 이어서 입력합니다. 클로드가 「가릴까요, 파일을 아예 뺄까요」라고 물으면 가리는 쪽을 고릅니다
💬
입력 2-2 · 채팅창 · 첫 커밋하고 올리기
지금 상태를 「첫 업로드」로 커밋하고, 깃허브에 【영문이름】-seoul-vibe 라는 비공개(private) 리포지토리로 만들어서 올려줘. 다 되면 리포지토리 주소를 알려줘.
✏️
예시 · 입력 2-2
지금 상태를 「첫 업로드」로 커밋하고, 깃허브에 kim-minsu-seoul-vibe 라는 비공개(private) 리포지토리로 만들어서 올려줘. …
  • 영문이름은 2회차 소개 HTML 에서 쓴 것과 같게 씁니다 (영문 소문자와 하이픈)
✅
클로드가 https://github.com/○○/○○-seoul-vibe 주소를 알려 주면 다음 Step

🛠️ 실습 Step 3. 깃허브에서 확인

💬
입력 3-1 · 채팅창
방금 올린 리포지토리를 브라우저로 열어줘.
  • 열린 깃허브 화면에서 세 가지를 봅니다
      1. 저장소 이름 옆에 Private 표시
      1. 파일 목록에 CLAUDE.md · .claude · index.html 은 있고 엑셀 · PDF 는 없음
      1. 파일 목록 오른쪽 위 시계 모양 옆 1 Commit (커밋 1개)
✅
세 가지가 맞으면 다음 Step. 브라우저 창은 닫지 않고 둡니다 (Step 4 에서 다시 봅니다)

🛠️ 실습 Step 4. 고치고 커밋하기

notion image
💬
입력 4-1 · 채팅창 · 한 줄 고치기
CLAUDE.md 맨 아래에 「보고서 맨 위에 작성일을 적는다」 한 줄을 추가해줘. CLAUDE.md 가 없으면 만들어줘.
💬
입력 4-2 · 채팅창 · 커밋하고 올리기
바뀐 내용을 「CLAUDE.md 에 작성일 규칙 추가」로 커밋하고 깃허브에 올려줘. 그리고 지금까지 커밋 기록을 보여줘.
  • 깃허브 브라우저 창을 새로고침하면 2 Commits 로 바뀝니다. 눌러 보면 커밋 이름 두 개가 보입니다
💡
커밋 이름은 「무엇을 고쳤는지」로 짓습니다. 나중에 기록만 보고도 언제 무엇을 바꿨는지 알 수 있고, 잘못 고쳤으면 그 전 커밋으로 되돌릴 수 있습니다.
✅
커밋 기록이 2개(첫 업로드 · 작성일 규칙 추가)면 다음 Step

🛠️ 실습 Step 5. 다시 클론해서 확인

notion image
💬
입력 5-1 · 채팅창 · 다시 클론
【영문이름】-seoul-vibe 리포지토리를 바탕화면에 seoul-vibe-clone 이라는 새 폴더로 클론해줘.
💬
입력 5-2 · 채팅창 · 비교
받은 폴더의 CLAUDE.md 에 방금 추가한 줄이 있는지, 커밋 기록은 몇 개인지, 원래 폴더와 비교해서 받은 폴더에 없는 파일은 무엇인지 알려줘.
notion image
✅
고친 줄이 있고, 커밋이 2개이고, 받은 폴더에 없는 것이 엑셀 · PDF 뿐이면 실습 끝입니다. 다른 PC에서도 이 순서로 받으면 똑같이 옵니다
받은 폴더에서 클로드 코드 켜 보기 (시간이 남으면)
  1. VS Code 메뉴 → 파일 → 새 창 → 폴더 열기 → 바탕화면 seoul-vibe-clone
  1. 메뉴 → 터미널 → 새 터미널 → ⌨️ claude
  1. 💬 「이 폴더의 CLAUDE.md 에 적힌 규칙과 쓸 수 있는 스킬 목록을 보여줘」
  • 원래 폴더와 같은 규칙과 스킬이 보이면, 다른 PC에서도 받아서 바로 쓸 수 있다는 뜻입니다
집 PC나 팀원과 나눠 쓰기 (시간이 남으면)
  • 집 PC : 그 PC에 클로드 코드 · Git · 깃허브 CLI가 있으면 Step 1 ③ 로그인을 한 번 하고, 💬 「깃허브의 【영문이름】-seoul-vibe 리포지토리를 바탕화면에 클론해줘」
  • 팀원 : 원래 폴더의 클로드 코드에 💬 「이 리포지토리에 깃허브 사용자 【팀원 Username】 을 협업자로 초대해줘」 → 팀원이 메일로 온 초대를 수락하고 자기 PC에서 클론합니다
  • 업무 엑셀은 깃허브로 오지 않습니다. 받은 PC에서 그 PC의 파일을 넣어 씁니다

막혔을 때

아래 문장은 모두 💬 채팅창에 입력합니다.
이럴 때
채팅창에 입력
가입 메일 코드가 안 온다
(입력 없음) 스팸함 · 프로모션함을 봅니다. 회사 메일이면 개인 메일로 다시 가입합니다
Username 이 이미 있다고 나온다
(입력 없음) 뒤에 숫자나 부서 약자를 붙입니다 (예 : kimminsu88 · kim-minsu-ops)
비밀번호가 안 된다고 나온다
(입력 없음) 15자 이상으로 하거나, 8자 이상에 숫자와 영문 소문자를 하나씩 넣습니다
로그인 코드가 안 나온다
「gh auth login 을 다시 백그라운드로 실행하고, 출력에 나온 코드를 그대로 보여줘」
「gh 를 찾을 수 없다」고 한다
「깃허브 CLI(gh)가 설치되어 있는지 보고, 없으면 설치해줘」 → 끝나면 VS Code 를 완전히 껐다 켜고 ⌨️ claude 다시 실행
브라우저에서 코드를 넣을 곳을 모르겠다
(입력 없음) 브라우저 주소창에 github.com/login/device 를 직접 입력합니다
커밋할 때 「Please tell me who you are」
「git 사용자 이름과 이메일을 내 깃허브 계정으로 설정해줘」
올라갈 목록에 엑셀 · PDF 가 보인다
「올리지 마. 이 파일들을 .gitignore 에 넣고 목록을 다시 보여줘」
이미 엑셀 · PDF 가 올라가 버렸다
강사를 부릅니다. 깃허브에서 저장소를 지우고(Settings → 맨 아래 Delete) Step 2 를 다시 합니다
클론할 때 「찾을 수 없다」고 한다
「내 깃허브 리포지토리 목록을 보여줘」 → 이름을 확인하고 5-1 을 다시
.claude 폴더가 깃허브에 안 보인다
「.claude 폴더의 스킬이 올라가지 않았어. 확인해서 커밋하고 올려줘」
  • 같은 Step 에서 10분 넘게 막히면 손을 들어 강사를 부릅니다
🌱
내일부터 쓸 때 : 스킬이나 CLAUDE.md 를 고쳤으면 💬 「무엇을 고쳤는지 이름 붙여서 커밋하고 깃허브에 올려줘」. 다른 PC에서는 💬 「깃허브의 ○○ 리포지토리 클론해줘」. 업무 엑셀은 깃허브가 아니라 각 PC에 따로 둡니다.
© Woka. All Rights Reserved