GitHub Pages를 켜면 이렇게 됩니다
내 컴퓨터에만 있던 파일이 전 세계에서 접속 가능한 URL로 변합니다
나만 볼 수 있음
공유하려면 파일 전송 필요
링크 하나로 누구에게나 공유
hong.github.io/my-site/
GitHub 가입하기
GitHub 계정을 만들고 첫 번째 저장소를 생성합니다
github.com 접속 → Sign up
github.com에 접속해서 Sign up 버튼을 클릭합니다. 이메일, 비밀번호, 사용자명을 입력하면 끝입니다.
💡 사용자명은 나중에 URL에 포함됩니다. 기억하기 쉬운 영문으로 만드세요. (예: honggildong → hong.github.io)
새 저장소 만들기
로그인 후 왼쪽 상단 New 버튼을 클릭합니다.
# 저장소 설정
Repository name: my-project ← 프로젝트 이름 입력
Public / Private 선택 ← 공개 or 비공개
[Create repository] 클릭
※ Private(비공개)으로 만들면 나만 볼 수 있습니다.
API Key (Personal Access Token) 발급
Claude Code가 GitHub에 접근하려면 인증 키가 필요합니다. GitHub에서 발급받으세요.
프로필 클릭
우측 상단 프로필 사진 → Settings
Developer Settings
왼쪽 맨 하단 Developer settings 클릭
토큰 생성
Personal access tokens → Tokens (classic) → Generate new token
# 토큰 설정
Note: claude-code-access ← 이름 (자유롭게)
Expiration: 90 days ← 유효기간
Scopes: repo 체크 ✓ ← 저장소 접근 권한
[Generate token] 클릭 → 토큰 복사 (한 번만 표시됩니다!)
Claude로 올리기
Claude Code에서 프로젝트를 GitHub에 올립니다
API Key를 Claude에게 전달하기
Claude Code에서 GitHub에 처음 접근할 때 API Key가 필요합니다. 이렇게 말하세요:
# Claude에게 이렇게 말하세요
> GitHub Personal Access Token은 ghp_xxxxxxxxxxxx야
> 이 키는 절대 메모리나 파일에 저장하지 마
처음 올릴 때
이미 내 컴퓨터에 프로젝트가 있다면 Claude에게 말하세요:
# Claude에게 이렇게 말하세요
> 이 프로젝트를 GitHub에 올려줘
> GitHub 주소는 https://github.com/내아이디/my-project 야
GitHub에 있는 프로젝트를 내려받고 싶다면:
# Claude에게 이렇게 말하세요
> https://github.com/내아이디/my-project 클론해줘
※ Claude가 알아서 git 명령어를 실행해줍니다. 명령어를 외울 필요 없습니다.
이후에 수정했을 때
| 하고 싶은 것 | Claude에게 이렇게 말하세요 |
|---|---|
| 변경사항 저장하기 | "지금까지 바꾼 거 커밋해줘" |
| GitHub에 올리기 | "GitHub에 푸시해줘" |
| 최신 코드 받기 | "GitHub에서 최신 코드 받아줘" |
| 이전 버전으로 돌리기 | "마지막 커밋 전으로 되돌려줘" |
막혔을 때: Claude에게 말하는 법
push가 안 돼요
인증 오류나 권한 문제로 GitHub에 업로드가 안 되는 상황
> GitHub push가 안 돼. 오류 메시지 확인해줘
실수로 잘못 커밋했어요
올리지 말아야 할 파일이나 내용을 커밋한 상황
> 마지막 커밋 취소하고 싶어. 파일은 유지해줘
GitHub Pages로 공개하기
내 URL로 접속해서 웹사이트가 열리는 것을 확인합니다
GitHub Pages 활성화 3단계
Settings 클릭
저장소 상단 탭에서 Settings 선택
Pages 메뉴
왼쪽 사이드바에서 Pages 클릭
branch 선택 후 Save
main 브랜치 선택 → Save
1~2분 후 공개됩니다
저장소에 올린 HTML/CSS/JS 파일이 바로 웹사이트로 공개됩니다. 내 URL은:
https://내아이디.github.io/프로젝트이름/
예) 아이디 hong, 저장소 my-site → https://hong.github.io/my-site/
[참고] 더 알고 싶다면
Git과 GitHub의 차이
💻 Git
변경 이력을 기록하는
도구 (일기장)
🐙 GitHub
코드를 저장하고 공유하는
공간 (구글 드라이브)
꼭 알아야 할 용어
| 용어 | 뜻 | 쉽게 말하면 |
|---|---|---|
| push (푸시) | 내 컴퓨터 → GitHub으로 올리기 | 구글 드라이브에 업로드 |
| pull (풀) | GitHub → 내 컴퓨터로 받기 | 구글 드라이브에서 다운로드 |
| clone (클론) | GitHub 저장소를 통째로 복사 | 공유 폴더를 내 컴퓨터에 복사 |
| commit (커밋) | 변경 내용을 로컬에 저장 | 게임 세이브 포인트 |
| branch (브랜치) | 독립된 작업 공간 | 원본 복사해서 따로 작업 |
| PR (풀 리퀘스트) | 코드 변경을 검토 요청 | "이거 확인해주세요" 요청서 |
| fork (포크) | 남의 저장소를 내 계정으로 복사 | 남의 레시피를 내 노트에 복사 |
| conflict (충돌) | 같은 부분을 다르게 수정했을 때 | 두 사람이 같은 문장을 다르게 고침 |
| .gitignore | Git이 무시할 파일 목록 | "이 파일들은 추적하지 마" 목록 |
Git 용어, 왜 이런 이름이 붙었을까?
| 용어 | 어원 / 유래 |
|---|---|
| Git | 2005년 리누스 토르발스(Linux 창시자)가 만들었습니다. "git"은 영국 속어로 "고집불통"이라는 뜻. 그는 농담으로 "내 이름처럼 고집 센 프로그램"이라며 이름을 붙였습니다. |
| commit | "commit to paper(기록하다)"에서 유래. 변경 내용을 영구적으로 기록한다는 의미입니다. 게임의 세이브 포인트처럼 특정 시점을 확정하는 행위입니다. |
| push / pull | 방향 비유입니다. 내 컴퓨터에서 서버로 밀어내면(push), 서버에서 내 컴퓨터로 당겨오면(pull)이라고 표현합니다. |
| branch | 나무 가지(branch)에서 유래. 메인 줄기(main)에서 뻗어나온 독립 작업 공간을 나뭇가지에 비유한 것입니다. |
| clone | 생물학의 클론(유전적으로 동일한 복제체)에서 유래. 저장소를 100% 동일하게 복사한다는 뜻입니다. |
| repository | 라틴어 "repositorium(보관소, 창고)"에서 유래. 코드와 히스토리를 보관하는 공간을 뜻합니다. |
| fork | 갈림길(fork in the road)에서 유래. 남의 저장소를 내 계정으로 복사해 독립적인 방향으로 발전시킨다는 의미입니다. |
이제 직접 해볼 차례입니다
실전 과제 4번에서 Claude와 함께 GitHub 업로드를 직접 따라해보세요.
명령어 없이, 한국어로 말하는 것만으로 완성됩니다.