studio.soluta

SOLV · 셋업

GitHub 계정과 첫 저장소 만들기

GitHub(깃허브)는 작업 폴더와 변경 기록을 인터넷에 보관하는 서비스입니다. 이 안내를 마치면 내 아이디로 로그인하고, 빈 비공개 저장소를 만든 뒤, 내 컴퓨터의 프로젝트를 처음 올릴 수 있습니다.

계정이 필요한 순간

  • 필요 없음업무별 스킬 셋업의 스킬 설치. 공개 자료를 내려받기만 하는 것이라 로그인 없이 됩니다.
  • 필요함 — 내 저장 공간을 만들고 내 작업물을 올리는 것. 이 페이지의 내용입니다.

01 · 가입

계정 만들기

브라우저에서 GitHub 가입 화면을 엽니다. 화면에 보이는 항목이 한꺼번에 나오거나 한 칸씩 나올 수 있습니다. 이 자료는 이메일로 가입하는 한 가지 순서만 설명합니다.

GitHub 가입 화면 — Email, Password, Username, Country/Region 입력칸과 Create account 버튼
2026년 7월 21일 가입 화면입니다. 현재 화면 모양이 조금 달라도 아래 항목과 Create account 버튼을 찾으면 됩니다. 출처 — github.com/signup (2026-07-21 캡처)
  1. 1. 이메일 입력 — 실제로 확인할 수 있는 이메일 주소를 넣고 Continue를 누릅니다.
  2. 2. 비밀번호 입력 — 화면에 표시된 조건을 모두 만족하는 새 비밀번호를 만들고 Continue를 누릅니다. 다른 서비스에서 쓰는 비밀번호를 다시 쓰지 않습니다.
  3. 3. 유저네임 입력 — GitHub에서 사용할 아이디를 넣습니다. 사용할 수 있다는 표시가 나오면 Continue를 누릅니다.
  4. 4. 국가 확인 — 국가 선택 항목이 보이면 Korea, South를 고릅니다.
  5. 5. 계정 만들기Create account를 누릅니다. 로봇 가입을 막는 퍼즐이 나오면 화면 안내대로 풉니다.
  6. 6. 이메일 확인 — 받은 편지함에서 GitHub가 보낸 인증 코드를 찾아 가입 화면에 입력합니다.
  7. 7. 가입 결과 확인 — 오른쪽 위에 내 프로필 사진이 보이고, 프로필을 눌렀을 때 방금 정한 유저네임이 나오면 끝입니다.

유저네임 정하는 기준

  • 유저네임은 공개되며 프로필과 저장소 주소에 들어갑니다.
  • 나중에 바꾸면 전에 공유한 주소가 달라질 수 있으므로 오래 쓸 이름을 정합니다.
  • 화면에 사용할 수 있다는 표시가 나오는 영문·숫자·하이픈 조합을 사용합니다.

02 · 2단계 인증

2FA 설정하기

2FA(Two-Factor Authentication, 2단계 인증)는 비밀번호를 알아낸 사람도 내 휴대폰 없이는 로그인하지 못하게 하는 두 번째 잠금장치입니다. GitHub는 2단계 인증 사용을 권장하며, 대상 계정에는 설정을 요구합니다. 가입 뒤 설정 안내가 보이면 표시된 기한 안에 마쳐야 합니다.

  1. 1. 인증 앱 준비 — 휴대폰에 Google Authenticator나 Microsoft Authenticator 같은 인증 앱 하나를 설치합니다.
  2. 2. 설정 화면 열기 — GitHub 오른쪽 위의 프로필 사진을 누르고 Settings를 엽니다.
  3. 3. 인증 메뉴 열기 — 왼쪽에서 Password and authentication을 누르고, Two-factor authentication의 Enable을 누릅니다.
  4. 4. QR 코드 읽기 — 휴대폰의 인증 앱에서 추가 버튼을 누르고 GitHub 화면의 QR 코드를 비춥니다.
  5. 5. 숫자 입력 — 인증 앱에 나온 6자리 숫자를 GitHub 화면에 입력합니다.
  6. 6. 복구 코드 저장Download를 눌러 복구 코드를 받고 비밀번호 관리자처럼 본인만 볼 수 있는 곳에 보관합니다.
  7. 7. 설정 결과 확인 — Two-factor authentication이 켜졌다는 표시가 나오면 끝입니다.
GitHub 2FA 설정 화면 — Setup authenticator app 단계의 QR 코드
인증 앱 등록 단계. 이 QR 코드를 인증 앱 카메라로 비추고, 앱에 뜨는 6자리 숫자를 아래 칸에 입력합니다. 출처 — GitHub 공식 문서(docs.github.com) 이미지

복구 코드를 저장하지 않고 휴대폰을 바꾸면 계정 복구가 어렵습니다. 이 단계만은 건너뛰지 않습니다.

03 · 세 단어

커밋·푸시·머지를 먼저 이해하기

블록으로 집을 만든다고 생각하면 세 단어를 구분하기 쉽습니다.

  1. 커밋(commit) — 지금 만든 집을 사진으로 남기고 “여기까지 만들었습니다”라고 메모하는 일입니다. 실제로는 내 컴퓨터에 변경 기록 하나를 저장합니다.
  2. 푸시(push) — 사진첩을 인터넷 보관함으로 올리는 일입니다. 실제로는 내 컴퓨터의 커밋을 GitHub 저장소로 보냅니다.
  3. 머지(merge) — 다른 책상에서 만든 창문을 완성할 집에 붙이는 일입니다. 실제로는 다른 브랜치에서 만든 변경을 main에 합칩니다.

첫 업로드에서 하는 일

첫 업로드에서는 커밋한 뒤 푸시합니다. 아직 따로 만든 작업을 합치지 않으므로 머지는 하지 않습니다. 그림과 함께 더 연습하려면 커밋·푸시·머지를 그림으로 이해하기를 엽니다.

04 · 첫 저장소

빈 비공개 저장소 만들기

저장소(repository)는 GitHub 안에 만드는 프로젝트 폴더입니다. 이미 내 컴퓨터에 프로젝트가 있으므로, 이번에는 파일이 하나도 없는 비공개 저장소를 먼저 만듭니다.

  1. 1. 새 저장소 화면 열기 — GitHub 오른쪽 위의 +를 누르고 New repository를 누릅니다. 새 저장소 화면을 바로 열어도 됩니다.
  2. 2. 주인 확인Owner에 방금 만든 내 유저네임이 선택되어 있는지 확인합니다.
  3. 3. 이름 입력Repository name에 영문 소문자와 하이픈으로 이름을 씁니다. 예시는 my-brand-site입니다.
  4. 4. 설명 입력Description은 선택 항목입니다. 처음에는 비워 두어도 됩니다.
  5. 5. 비공개 선택Private을 선택합니다.
  6. 6. 빈 상태 확인 — README, .gitignore, License를 추가하는 선택은 모두 그대로 두어 파일을 만들지 않습니다. 기존 프로젝트를 올릴 때 미리 파일을 만들면 기록을 합치는 단계가 더 생길 수 있습니다.
  7. 7. 저장소 만들기 — 아래의 Create repository를 누릅니다.
  8. 8. 주소 복사Quick setup 화면이 나오면 HTTPS 주소를 복사합니다. 주소는 https://github.com/내-유저네임/저장소-이름.git처럼 생겼습니다.
GitHub 오른쪽 위의 더하기 버튼을 눌렀을 때 보이는 New repository 메뉴
오른쪽 위의 더하기 버튼을 누르고 New repository를 선택합니다. 출처 — GitHub 공식 문서 이미지
저장소 만들기 화면의 Repository name 입력칸
저장소 이름 아래에 사용할 수 있다는 표시가 나오면 다음 항목으로 넘어갑니다. 출처 — GitHub 공식 문서 이미지

이 단계에서는 GitHub 웹에 빈 저장소만 만듭니다. 파일은 다음 단계에서 Codex나 Claude Code를 사용해 올립니다.

05 · 첫 업로드

첫 커밋을 만들고 푸시하기

작업하던 프로젝트 폴더를 Codex나 Claude Code에서 연 뒤, 아래 문장을 위에서부터 하나씩 보냅니다. 각 단계의 결과를 확인한 다음에 다음 문장으로 넘어갑니다.

1. GitHub 로그인 확인

그대로 붙여넣기
이 프로젝트 폴더에서 GitHub 로그인 상태와 로그인한 계정 이름만 확인해 주세요. 로그인하지 않았다면 gh auth login을 시작하고, 브라우저에서 제가 승인해야 하는 순간에 멈춰 주세요. 토큰 값은 보여 주지 말고 파일도 고치지 마세요.

2. 올리면 안 되는 파일 확인

그대로 붙여넣기
이 폴더를 GitHub에 올리기 전에 커밋할 파일과 .gitignore를 확인해 주세요. .env, 토큰, API 키, 비밀번호, 개인·고객 자료가 있으면 값을 보여 주지 말고 파일 경로와 위험 종류만 알려 준 뒤 멈춰 주세요. 문제가 없으면 커밋할 파일 목록만 보여 주세요.

3. 첫 커밋 내용 미리 보기

그대로 붙여넣기
이 폴더가 아직 Git 저장소가 아니면 main 브랜치로 시작해 주세요. 방금 확인한 안전한 파일만 첫 커밋 후보로 올리고, 바뀐 내용과 커밋 메시지 후보를 보여 주세요. 아직 커밋하거나 GitHub에 푸시하지 마세요.

4. 커밋하고 GitHub에 푸시

[여기에 복사한 저장소 주소]를 앞 단계에서 복사한 실제 주소로 바꾼 뒤 보냅니다.

주소를 바꾼 뒤 붙여넣기
제가 GitHub 웹에서 만든 빈 비공개 저장소 주소는 [여기에 복사한 저장소 주소]입니다. 확인한 파일을 첫 커밋으로 기록하고, 이 주소를 origin으로 연결한 뒤 main 브랜치를 푸시해 주세요. 끝나면 저장소 주소, origin 주소, 최근 커밋 한 건을 알려 주세요.

5. GitHub 웹에서 확인

  1. Codex나 Claude Code가 알려 준 저장소 주소를 엽니다.
  2. 저장소 이름이 내가 만든 이름과 같은지 확인합니다.
  3. 브랜치 이름에 main이 보이는지 확인합니다.
  4. 최근 커밋 문구와 프로젝트 파일 목록이 보이는지 확인합니다.

비밀번호, 토큰, API 키, .env 파일은 비공개 저장소에도 올리지 않습니다. GitHub가 푸시를 막으면 우회하지 말고 표시된 파일에서 비밀 값을 제거합니다.