GitHub 개념과 핵심 용어 쉽게 이해하기 + 바이브코딩을 위한 Claude Code 연동 방법

바이브 코딩으로 코드를 만들다 보면 “리포 클론해”, “커밋하고 푸시해”, “PR 올려” 같은 말이 툭툭 나와서 당황한 적 있다. 터미널에서 git 명령어를 다 외우지 않아도 되는데, 개념을 모르면 AI가 뭘 하는지 감을 잡기 어렵다.

결론부터 말하면 GitHub는 코드를 저장하고 변경 이력을 남기며 다른 사람과 협업하는 플랫폼이고, Claude Code와 붙이면 AI가 그 저장소 안을 읽고, 수정하고, 커밋·푸시·PR까지 자연어로 처리해 준다. 이 글을 따라 읽으면 GitHub의 핵심 원리와 자주 나오는 용어, 그리고 Claude Code와 연계하는 대표적인 방법 세 가지를 한 번에 파악할 수 있다.

2026년 10월 기준 공식 문서와 실제 워크플로를 바탕으로 정리했다. (개인 환경에서 한 번 따라 해보는 걸 권장)

1. Git과 GitHub, 뭐가 다른가?

Git은 내 컴퓨터에서 파일의 변경 이력을 기록하는 도구다. 언제 무엇을 바꿨는지 스냅샷으로 남기고, 나중에 되돌릴 수 있게 해 준다. 혼자 쓰는 메모장 같은 존재다.

GitHub는 그 Git 저장소를 인터넷에 올려 놓고 다른 사람과 공유·협업할 수 있게 만든 웹 서비스다. 백업 역할도 하고, 이슈·풀 리퀘스트·액션 같은 협업 기능도 붙여 준다.

비유하면 Git은 “일기장에 날짜별로 기록하는 습관”이고, GitHub는 “그 일기장을 클라우드에 올려 두고 친구와 같이 보는 노트 앱”이다. 바이브 코딩에서는 로컬에서 Claude Code가 코드를 만지고, 그 결과를 GitHub에 올려 두는 흐름이 가장 흔하다.

2. 꼭 알아야 할 핵심 용어

처음 보면 용어가 많아 보이지만, 결국 “내 컴퓨터 ↔ GitHub 서버” 사이에서 파일을 옮기고 이력을 관리하는 이야기뿐이다. 아래 표로 한눈에 정리했다.

GitHub·Git 핵심 용어 쉬운 설명

용어	한 줄 설명	바이브 코딩에서 자주 쓰는 순간
Repository (리포지토리, 리포)	프로젝트 폴더 + 변경 이력 전체가 담긴 저장소	새 프로젝트 시작할 때 GitHub에서 만들기
Clone (클론)	원격 리포를 내 컴퓨터로 복사해 오기	다른 사람 코드나 내 리포를 로컬에서 열 때
Commit (커밋)	현재 변경 사항을 이력에 “저장”하는 스냅샷	Claude가 코드를 고친 뒤 “커밋해 줘”라고 할 때
Push (푸시)	내 컴퓨터의 커밋을 GitHub로 업로드	작업한 내용을 서버에 반영하고 싶을 때
Pull (풀)	GitHub의 최신 변경을 내 컴퓨터로 가져오기	다른 사람이 올린 내용이나 다른 기기에서 작업한 내용 받을 때
Branch (브랜치)	메인 코드와 따로 작업하는 평행 우주	실험하거나 기능을 추가할 때 메인(main)을 망치지 않으려고
Pull Request (PR, 풀 리퀘스트)	“이 브랜치의 변경을 메인에 합쳐 주세요”라는 요청 + 리뷰 공간	Claude가 작업한 내용을 검토하고 머지할 때
Fork (포크)	다른 사람 리포를 내 계정으로 복사	오픈소스에 기여하거나 남의 코드를 내 마음대로 고쳐 보고 싶을 때
Merge (머지)	브랜치의 변경을 다른 브랜치에 합치기	PR을 승인하고 메인에 반영할 때

참고: 요즘은 기본 브랜치 이름을 master 대신 main으로 쓰는 경우가 대부분이다. 둘 다 같은 의미로 보면 된다.

3. 가장 기본이 되는 사용 흐름 (GitHub Flow)

바이브 코딩이든 일반 개발이든 가장 많이 쓰는 패턴은 이렇다.

1. GitHub에서 리포지토리를 만들거나 기존 리포를 클론한다.
2. 새 브랜치를 만들어 작업을 시작한다. (메인 브랜치를 직접 건드리지 않는 습관이 좋다.)
3. 코드를 수정한다. Claude Code에게 “로그인 버그 고쳐 줘”라고 말하면 이 단계에서 파일을 고친다.
4. 변경 사항을 커밋한다. 메시지에 왜 바꿨는지 간단히 적는다.
5. 브랜치를 푸시한다.
6. GitHub에서 풀 리퀘스트를 연다.
7. 내용을 확인하고 머지한다.

혼자 쓸 때도 브랜치 + PR 습관을 들이면 나중에 “이거 언제 고쳤더라?” 하고 헤매는 일이 줄어든다. Claude Code는 이 흐름 안에서 “커밋해 줘”, “푸시하고 PR 열어 줘” 같은 자연어 명령을 받아 실행할 수 있다.

4. Claude Code와 GitHub를 연계하는 방법

Claude Code는 터미널에서 동작하는 에이전트형 코딩 도구다. Git과 직접 대화하듯이 명령을 실행할 수 있고, GitHub와는 몇 가지 경로로 연결된다.

4-1. 로컬에서 Claude Code + Git (가장 기본)

Claude Code를 프로젝트 폴더에서 실행하면 그 폴더의 파일과 git 상태를 본다. 내가 “이 변경사항 커밋해 줘”라고 하면 Claude가 git diff를 보고 메시지를 작성한 뒤 git commit을 실행한다. gh CLI가 설치되어 있으면 PR도 열 수 있다.

특징은 Claude가 별도의 특별한 Git 기능이 있는 게 아니라, 내 컴퓨터에 설치된 git과 gh 명령을 대신 쳐 준다는 점이다. 권한 설정으로 푸시는 내가 확인하게 하는 것도 가능하다.

이 방식은 이미 로컬에 리포가 있고, 내가 옆에서 실시간으로 보고 싶을 때 가장 편하다.

4-2. Claude.ai / Claude Code 클라우드 세션에서 리포 연결

claude.ai에서 GitHub 계정을 연결하면 채팅이나 프로젝트에 리포지토리 내용을 넣어 컨텍스트로 쓸 수 있다. 이 경우는 주로 “코드를 읽어 달라”는 용도다. 파일을 직접 고치거나 PR을 여는 건 Claude Code 쪽 역할이다.

Claude Code 클라우드 세션(claude.ai/code)을 쓰면 GitHub 리포를 클라우드 VM에 클론해서 작업하고, 끝나면 새 브랜치를 푸시해 준다. 로컬에 코드를 내려받지 않아도 되고, 여러 작업을 동시에 돌릴 수 있다. 프라이빗 리포는 Claude GitHub App을 설치해야 접근할 수 있다.

설정은 claude.ai/code에서 GitHub로 로그인하거나, 터미널에서 gh auth login 후 Claude Code에서 /web-setup을 실행하는 방식이 있다.

4-3. GitHub Actions에서 @claude 부르기

리포지토리에 Claude Code GitHub Action을 설정하면 이슈나 PR 댓글에 @claude라고 적으면 Claude가 반응해서 코드를 분석하거나 수정한 뒤 커밋을 푸시할 수 있다. PR이 열릴 때마다 자동으로 리뷰하게 하는 자동화도 가능하다.

빠른 설정은 로컬 Claude Code에서 /install-github-app을 실행하는 방법이다. 그러면 GitHub App 설치, 시크릿 등록, 워크플로 파일 추가까지 도와준다. API 키나 OAuth 토큰은 GitHub Secrets에 넣어야 하고, 절대 코드에 직접 적지 않는다.

주의: Actions는 GitHub 실행 시간과 Claude API 사용량이 동시에 발생한다. 처음에는 작은 리포에서 테스트해 보고 비용과 권한을 확인하는 게 안전하다.

5. 어떤 방식을 쓰면 좋을까?

상황별 Claude Code + GitHub 연동 방법 추천

상황	추천 방법	이유
로컬에서 실시간으로 코드 만지며 대화하고 싶을 때	로컬 Claude Code + Git	가장 직관적이고 즉시 확인 가능
컴퓨터 없이 폰이나 다른 기기에서 작업 지시하고 싶을 때	클라우드 세션	리포만 연결하면 됨
코드를 읽어 설명해 달라거나 질문만 할 때	Claude.ai GitHub 통합	읽기 전용 컨텍스트로 충분
PR마다 자동 리뷰나 이슈 대응을 자동화하고 싶을 때	GitHub Actions + @claude	이벤트 기반으로 동작

혼자 바이브 코딩할 때는 로컬 방식만으로도 충분하다. 팀이 생기거나 자동화가 필요해지면 Actions를 추가하는 식으로 확장하면 된다.

6. 마무리 — 핵심 3줄 요약

• Git은 로컬 변경 이력 도구, GitHub는 그걸 공유·협업하는 플랫폼이다.
• 핵심 용어는 리포·클론·커밋·푸시·풀·브랜치·PR 정도만 알아도 흐름이 보인다.
• Claude Code는 로컬에서 git 명령을 대신 실행하거나, 클라우드에서 리포를 클론해 작업하거나, Actions로 @claude에 반응하게 할 수 있다.

다음으로 해볼 만한 것은 간단한 리포를 하나 만들고 Claude Code에게 “README 업데이트하고 커밋해 줘”라고 시켜 보는 것이다. 개념이 몸에 익으면 그다음부터는 명령어를 외우기보다 “무엇을 하고 싶은지”만 말하면 된다.