GitHub 가입과 연결

이 장은 "가입하기"에서 "빈 저장소를 내 PC로 내려받기"까지 한 줄로 이어집니다. 내려받는 순간 GitHub 연결도 함께 끝납니다. 중간에 막혀도 괜찮습니다. 각 단계마다 성공하면 어떤 화면이 보이는지, 실패하면 무엇을 하는지 적어 두었습니다.

1. 가입
2. 보안 설정
3. 이메일 비공개
4. ai-site 저장소 만들기
5. cmd로 내려받기(연결)
6. git 이름표 설정

GitHub는 무엇인가요?

GitHub(깃허브)는 한마디로 "인터넷에 있는 내 프로젝트 폴더 보관소"입니다. 다음 세 가지 역할만 기억하면 이 교육에서는 충분합니다.

1. GitHub 가입하기

1. 가입 페이지 열기

   브라우저(Chrome, Edge 등) 주소창에 github.com/signup을 입력하고 Enter를 누릅니다. 가운데에 가입 입력 창이 나타납니다. 화면에는 "Continue with Google"처럼 구글 계정으로 가입하는 버튼도 보이는데, 이 교재는 이메일로 가입하는 방법을 기준으로 설명합니다. 화면 구성과 버튼 문구는 업데이트로 조금 다를 수 있습니다.

2. 이메일과 비밀번호 입력

   이메일 칸에 내 이메일을 쓰고 Continue를 누릅니다. 이어서 비밀번호를 정합니다. GitHub 공식 문서의 비밀번호 조건은 다음 둘 중 하나입니다.

   • 8자 이상이면서 숫자와 영어 소문자를 모두 포함
   • 또는 15자 이상 (글자 종류는 상관없음)

   다른 사이트에서 쓰던 비밀번호는 재사용하지 마세요. 비밀번호 관리 앱(브라우저의 비밀번호 저장 기능 포함)이 만들어 주는 15자 이상 문자열을 쓰는 것이 가장 안전합니다.

3. 사용자 이름 정하기 (주소에 들어갑니다)

   사용자 이름(username)은 내 GitHub 주소가 됩니다. 예를 들어 사용자 이름이 [내 사용자 이름]이면 내 페이지 주소는 github.com/[내 사용자 이름]이고, 저장소 주소는 github.com/[내 사용자 이름]/[저장소 이름] 모양이 됩니다. 이 주소는 누구나 볼 수 있습니다.

   • 사용할 수 있는 글자는 영문자, 숫자, 하이픈(-)입니다. 하이픈은 연속으로 두 개 쓰거나 맨 앞과 맨 뒤에 쓸 수 없습니다. 길이는 39자 이하입니다.
   • 실명, 회사 이름, 사번처럼 나를 바로 알아볼 수 있는 정보는 피하세요.
   • "이미 사용 중"이라는 안내가 나오면 숫자, 하이픈, 다른 철자를 덧붙여 보세요.
   • 나중에 바꿀 수는 있습니다. 다만 바꾸면 예전 이름의 프로필 주소는 열리지 않게 되고(공식 문서 안내), 이미 올린 저장소의 링크는 대부분 새 이름으로 이어집니다. 그래도 처음에 신중하게 정하는 편이 좋습니다.

4. 소식 메일 수신 여부 고르기

   "제품 소식을 이메일로 받겠습니까?" 같은 질문(y/n)이 나올 수 있습니다. 필수가 아니므로 원하는 쪽을 고르고 Continue를 누릅니다. 받지 않으려면 n을 선택하세요.

5. "사람입니다" 확인 퍼즐 풀기 (본인이 직접)

   "Verify your account" 화면에서 Start Puzzle 버튼을 누르면 그림을 맞추거나 돌리는 짧은 퍼즐이 나옵니다. 화면 안내대로 풀고 초록색 체크 표시가 나오면 통과입니다. 이 퍼즐은 "사람이 맞는지" 확인하는 장치이므로 반드시 본인이 직접 풉니다. Claude에게 대신 시키지 마세요.

   퍼즐이 안 나타나면

   광고 차단 확장 프로그램이 퍼즐을 가리는 경우가 있습니다. 확장 프로그램을 이 사이트에서만 잠시 끄고 페이지를 새로고침한 뒤 다시 시도하세요.

6. Create account 누르고, 이메일로 온 코드 입력

   퍼즐을 통과하면 Create account 버튼이 활성화됩니다. 누르면 입력한 이메일로 인증 코드가 담긴 메일이 발송되고, 화면에는 코드를 입력하는 칸이 나타납니다. 메일함을 열어 숫자 코드를 확인하고 입력 칸에 그대로 넣으세요. 칸이 여러 개로 나뉘어 있으면 첫 칸에 붙여넣기(Ctrl+V)해도 됩니다.

   메일이 1~2분 안에 오지 않으면 스팸함을 확인하고, 그래도 없으면 화면의 코드 재전송 링크(Resend)를 누르세요. 이메일 주소를 잘못 입력했다면 이전 단계로 돌아가 수정합니다.

7. 무료(Free) 플랜으로 시작하기

   인증이 끝나면 "어떻게 쓰실 건가요?" 같은 개인화 질문이나 요금제를 소개하는 화면이 나올 수 있습니다. Skip personalization, Continue for free처럼 "건너뛰기/무료로 계속"을 뜻하는 버튼을 누르세요. 이 교육은 무료 플랜(Free)으로 충분하며, 카드 번호를 입력하라는 화면이 나오면 유료 플랜을 고른 것이니 멈추고 무료 선택으로 돌아가세요. 무료 플랜에서도 비공개(Private) 저장소를 만들 수 있습니다.

   화면 문구는 업데이트로 조금 다를 수 있습니다. 질문이 많아 보여도 모두 건너뛸 수 있습니다.

2단계 인증(2FA) 켜기 (권장)

2단계 인증은 비밀번호에 "두 번째 확인"을 더하는 장치입니다. 비밀번호가 새어 나가도 휴대폰 확인이 없으면 로그인되지 않습니다. GitHub 공식 문서는 계정에 2단계 인증을 설정할 것을 강하게 권장하고 있으며, GitHub는 코드를 올리는 사용자에게 2단계 인증을 요구하는 정책도 운영합니다. 그래서 어느 시점에 "2단계 인증을 켜 달라"는 안내가 뜰 수 있습니다. 미리 켜 두면 편합니다.

1. 오른쪽 위 프로필 그림
2. Settings
3. Password and authentication
4. Two-factor authentication
5. Enable two-factor authentication

처음 켤 때는 인증 앱이나 문자 메시지로 시작하고, 패스키와 보안 키는 그 뒤에 추가하는 방식입니다(공식 문서 기준). 화면 문구와 선택지는 업데이트로 조금 다를 수 있습니다.

이메일 비공개 설정과 noreply 주소

1. Emails 설정 화면 열기

   1. 프로필 그림
   2. Settings
   3. Emails

2. 두 가지 상자에 체크

   Keep my email addresses private에 체크합니다. 웹에서 일어나는 작업과 GitHub의 공개 화면에서 내 실제 이메일 대신 noreply 주소가 쓰입니다.

   바로 아래 Block command line pushes that expose my email에도 체크합니다. 내 PC에서 올릴 때 실수로 실제 이메일이 기록되어 있으면 GitHub가 올리기를 막아 줍니다.

3. 내 noreply 주소 확인해 적어 두기

   같은 화면의 설명 문구에 내 noreply 주소가 표시됩니다. 2017년 7월 18일 이후에 만든 계정은 아래 모양입니다.

   [숫자]+[내 사용자 이름]@users.noreply.github.com

   이 주소를 메모해 두세요. 아래 "git 사용자 정보 설정"에서 사용합니다. 화면 문구는 업데이트로 조금 다를 수 있으니, Emails 화면에서 users.noreply.github.com으로 끝나는 주소를 찾으면 됩니다.

2. 사이트용 저장소 ai-site 만들기

사이트 파일을 담을 GitHub 저장소(파일 보관함)를 웹에서 먼저 하나 만듭니다. 이름은 ai-site로 하고, 안은 비워 둡니다. 이 빈 보관함을 다음 절에서 내 PC로 내려받으면, 그 폴더가 앞으로 사이트를 만드는 작업 폴더가 됩니다.

1. 새 저장소 만들기 화면 열기

   github.com에 로그인한 상태에서 오른쪽 위의 + 버튼을 누르고 New repository를 고릅니다.

   1. +
   2. New repository

2. 이름과 공개 범위 정하기

   Repository name에 ai-site를 입력합니다. 공개 범위는 Private을 고릅니다. 설명(Description)은 비워도 됩니다.

   왜 Private인가요?

   • 연습 중인 파일이 다른 사람에게 보이지 않습니다.
   • 비공개 저장소는 내려받을 때 로그인이 필요해서, 다음 절의 내려받기 한 번으로 GitHub 연결까지 끝납니다.
   • Vercel 무료(Hobby) 플랜도 내 개인 계정의 Private 저장소를 배포할 수 있습니다. 완성된 사이트는 Vercel 주소로 누구나 볼 수 있습니다.

3. 아무것도 추가하지 않고 만들기

   README, .gitignore, 라이선스를 추가하는 선택지는 모두 꺼 둔 채로 둡니다(빈 저장소). 그다음 Create repository를 누릅니다. 화면 구성과 문구는 업데이트로 조금 다를 수 있습니다.

4. 저장소 주소 복사하기

   만들어지면 "Quick setup" 안내 화면이 나옵니다. HTTPS가 선택된 상태에서 보이는 주소 https://github.com/[내 사용자 이름]/ai-site.git 오른쪽의 복사 버튼을 누릅니다. 다음 절에서 바로 씁니다.

3. cmd에서 빈 저장소 내려받기 (이때 GitHub 연결이 끝납니다)

방금 만든 빈 저장소를 내 PC로 내려받습니다. 이 작업을 clone(복제)이라고 합니다. 처음으로 GitHub에 접속하는 순간 로그인 창이 뜨고, 거기서 한 번 승인하면 내 PC와 GitHub가 연결됩니다.

1. cmd 창 열기

   Win + R을 누르고 cmd를 입력한 뒤 Enter를 누릅니다. 검은 창이 열리고 줄 맨 앞에 C:\Users\[내 이름]>처럼 보이면 준비된 것입니다.

2. 문서 폴더로 이동한 뒤 내려받기

   아래 두 줄을 한 줄씩 입력하고 Enter를 누릅니다. 두 번째 줄의 주소 자리에는 방금 복사한 내 저장소 주소를 붙여 넣으세요(cmd 창에서는 Ctrl + V 또는 마우스 오른쪽 클릭).

   cd %USERPROFILE%\Documents
   git clone https://github.com/[내 사용자 이름]/ai-site.git

3. 로그인 창에서 브라우저로 승인하기

   처음이면 "Connect to GitHub" 같은 제목의 창이 뜹니다. Sign in with your browser를 누르면 브라우저가 열리고, GitHub 로그인(이미 로그인되어 있으면 생략) 뒤 Git Credential Manager의 접근을 허락하는 화면이 나옵니다. Authorize git-ecosystem 같은 초록 버튼을 누르세요. 인증 성공 안내가 나오면 브라우저는 닫아도 됩니다. 화면 문구는 버전에 따라 조금 다를 수 있습니다.

   내가 방금 입력한 명령 때문에 뜬 창인지 확인하세요

   이 창은 방금 입력한 git clone 때문에 뜬 것입니다. 아무 작업도 하지 않았는데 GitHub 로그인이나 승인 창이 뜨면 누르지 마세요.

4. 성공 문구 확인하기

   cmd 창으로 돌아오면 아래와 비슷한 두 줄이 보입니다. 두 번째 줄은 경고처럼 보이지만 저장소가 아직 비어 있다는 안내일 뿐이라 정상입니다.

   Cloning into 'ai-site'...
   warning: You appear to have cloned an empty repository.

   파일 탐색기에서 문서 폴더를 열면 ai-site 폴더가 새로 생겨 있습니다. 이 폴더가 내 PC의 사이트 작업 폴더이고, GitHub의 ai-site 저장소와 연결되어 있습니다.

5. git 이름표 설정하기

   파일을 올릴 때 "누가 바꿨는지" 기록에 남는 이름과 이메일을 정해 둡니다. 이메일에는 앞에서 적어 둔 noreply 주소를 씁니다. 같은 cmd 창에 한 줄씩 입력하세요. 아무 문구 없이 다음 줄로 넘어가면 성공이고, 처음 한 번만 하면 됩니다.

   git config --global user.name "[GitHub 사용자 이름]"
   git config --global user.email "[내 noreply 주소]"

6. Claude 앱에서 ai-site 폴더 열기

   Claude 앱의 Code 탭에서 새 세션을 열고 Select folder로 문서 아래의 ai-site 폴더를 고릅니다. 4장부터는 이 폴더에서 일합니다. 연결이 잘 됐는지 바로 보고 싶다면 아래처럼 부탁해 보세요.

   이 폴더가 GitHub 저장소와 연결되어 있는지 확인해줘.
   - git remote -v 로 연결된 주소를 보여주고, git ls-remote origin 이 오류 없이 끝나는지 확인해줘.
   - 파일은 아무것도 바꾸거나 올리지 마.
   - 결과를 쉬운 말로 한두 줄로 알려줘.

GitHub CLI(gh)를 설치해줘.
1) 먼저 git --version 으로 Git이 설치되어 있는지 확인하고, 없으면 winget install --id Git.Git -e 로 설치해줘.
2) 그다음 winget install --id GitHub.cli 로 GitHub CLI를 설치해줘.
3) 설치가 끝나면 gh --version 결과를 보여줘.
로그인은 내가 직접 할 거라서 gh auth login 은 실행하지 마. 내 허락이 필요한 단계가 나오면 무엇을 허락하는 건지 먼저 설명해줘.

막혔을 때

이 장 끝 체크리스트

• GitHub 가입을 마치고 이메일 인증까지 끝냈습니다
• 2단계 인증을 켜고 복구 코드를 안전한 곳에 보관했습니다 (권장)
• Settings > Emails에서 이메일 비공개 설정 두 가지에 체크하고 noreply 주소를 메모했습니다
• GitHub에 Private 저장소 ai-site를 빈 상태로 만들었습니다
• cmd에서 git clone으로 내려받아 문서 아래 ai-site 폴더가 생겼고, 브라우저 승인으로 GitHub 연결을 마쳤습니다
• git 사용자 이름과 noreply 이메일을 설정했습니다