Claude가 Git · GitHub를 대신 관리하게 하는 방법 — 커밋도 말로 하는 세팅 가이드

이 글을 읽고 나면 Claude에게 "커밋하고 푸시해줘"라고 말만 해도 AI가 직접 처리해줍니다.

---

왜 이 세팅이 필요한가?

Git은 코드 변경 이력을 관리하는 도구입니다. 개발자들이 필수로 쓰지만 명령어가 많고 처음엔 어렵게 느껴집니다.

Claude와 함께하면 Git을 몰라도 됩니다.

세팅 전:  git add . → git commit -m "..." → git push  (직접 입력)
세팅 후:  "커밋하고 푸시해줘" → Claude가 알아서 처리

Claude에게 이렇게 말하면 모두 자동으로 됩니다:

"커밋하고 푸시해줘"
"GitHub에 새 레포 만들어서 올려줘"
"변경사항 저장해줘"

---

전체 흐름

1. Git 설치
2. GitHub 계정 생성
3. GitHub CLI 설치 + 로그인
4. Git 사용자 정보 설정
5. 완료 — Claude가 Git/GitHub를 대신 처리

---

STEP 1. Git 설치

Mac

터미널에서 확인:

git --version

버전이 나오면 이미 설치된 것. 없다면:

xcode-select --install

Windows

👉 https://git-scm.com/downloads/win 에서 다운로드 후 설치

설치 옵션은 모두 기본값으로 진행해도 됩니다.

설치 확인 (PowerShell):

git --version

---

STEP 2. GitHub 계정 만들기

GitHub는 내 코드를 인터넷에 저장하는 서비스입니다.

👉 https://github.com 에서 무료 회원가입

이메일, 비밀번호, 닉네임만 있으면 됩니다.

---

STEP 3. GitHub CLI 설치 + 로그인

GitHub CLI(gh) 는 터미널에서 GitHub를 조작하는 도구입니다. 이게 핵심이에요 — Claude가 새 레포를 만들고 코드를 올리는 것을 모두 이 도구로 처리합니다.

Mac

brew install gh

Homebrew가 없다면 먼저:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Windows

👉 https://cli.github.com 에서 Windows 인스톨러 다운로드 후 설치

또는 PowerShell에서:

winget install GitHub.cli

설치 확인:

gh --version

---

GitHub 로그인

gh auth login

아래 순서로 선택하면 됩니다:

? What account do you want to log into?
→ GitHub.com

? What is your preferred protocol for Git operations?
→ HTTPS

? Authenticate Git with your GitHub credentials?
→ Yes

? How would you like to authenticate GitHub CLI?
→ Login with a web browser

브라우저에서 GitHub 계정으로 로그인하면 완료.

로그인 확인:

gh auth status

✓ Logged in to github.com 이 나오면 성공.

---

STEP 4. Git 사용자 정보 설정

커밋할 때 "누가 저장했는지" 기록됩니다. 한 번만 설정하면 됩니다.

git config --global user.name "내 닉네임"
git config --global user.email "내 이메일@gmail.com"

GitHub 계정과 같은 이메일을 쓰면 커밋 이력이 내 프로필에 연결됩니다.

---

세팅 완료 — Claude에게 맡기기

이제 모든 Git 작업을 Claude에게 말로 지시할 수 있습니다.

자주 쓰는 명령 예시

상황	Claude에게 하는 말
작업 후 저장	"커밋하고 푸시해줘"
새 프로젝트 시작	"GitHub에 새 레포 만들어서 올려줘"
상태 확인	"지금 변경된 파일 뭐야?"
이전으로 되돌리기	"마지막 커밋 전으로 돌려줘"

Claude가 실제로 하는 일

"커밋하고 푸시해줘"라고 하면 Claude는 내부적으로 이렇게 처리합니다:

git status              # 변경된 파일 확인
git add .               # 변경 파일 선택
git commit -m "작업 내용 요약"  # 이력 저장
git push                # GitHub에 업로드

이 명령어들을 외울 필요가 전혀 없습니다.

---

Git이 왜 중요한가?

명령어는 Claude가 다 해주지만, Git이 뭔지는 알아두면 좋습니다.

상황	Git 없이	Git 있을 때
파일 실수로 삭제	복구 불가	이전 버전으로 복구 가능
코드가 망가짐	처음부터 다시	잘 되던 시점으로 되돌리기
다른 기기에서 작업	USB로 복사	GitHub에서 바로 다운로드
협업	이메일로 파일 전송	자동으로 합치기

한 줄 요약: Git = 내 작업물의 타임머신 + 클라우드 저장소

---

세팅 체크리스트

• Git 설치 (git --version 확인)
• GitHub 계정 생성
• GitHub CLI 설치 (gh --version 확인)
• gh auth login 완료
• git config --global user.name/email 설정

---

트러블슈팅

Windows에서 gh 명령어를 못 찾을 때

PowerShell을 완전히 닫고 다시 열기. 그래도 안 되면 Claude에게 "gh 명령어 PATH 추가해줘"라고 하면 해결해줍니다.

"remote: Permission denied" 오류

gh auth login을 다시 실행해서 재로그인.

커밋이 GitHub 프로필에 안 보일 때

git config --global user.email이 GitHub 계정 이메일과 동일한지 확인.