본문으로 건너뛰기

Claude Code에서 GitHub 코드 관리하기

Claude Code는 내부적으로 gh CLI를 활용해 GitHub 작업을 자연어로 수행할 수 있습니다. PR 생성, 이슈 관리, 코드 리뷰를 대화로 처리하는 방법을 안내합니다.

사전 준비​

  1. GitHub CLI 설치 및 로그인 완료 (GitHub CLI 설치 가이드 참고)
  2. Claude Code 설치 완료
  3. Git 저장소가 GitHub Remote로 연결된 상태
# gh 인증 확인
gh auth status

# Claude Code 실행
claude

PR(Pull Request) 관리​

PR 생성​

Claude Code에 다음과 같이 요청하면 변경사항을 분석해 PR을 만들어줍니다.

현재 브랜치의 변경사항으로 PR 만들어줘

Claude Code가 자동으로:

  1. git diff로 변경사항 분석
  2. 커밋 히스토리 참고해 PR 제목·본문 작성
  3. gh pr create 실행

PR 리뷰​

# 특정 PR 리뷰 요청
123번 PR 리뷰해줘

# URL로도 가능
https://github.com/org/repo/pull/123 리뷰해줘

Claude Code는 /review 슬래시 커맨드도 지원합니다:

/review 123

PR 머지​

123번 PR squash 머지해줘

Issue 관리​

이슈 생성​

"로그인 시 500 에러 발생" 이슈 만들어줘, bug 라벨 붙여서

이슈 목록 확인​

열려있는 이슈 목록 보여줘

이슈 기반 작업​

42번 이슈 내용 읽고 수정해줘

Claude Code가 이슈 내용을 gh issue view 42로 읽은 뒤 코드를 수정하고, 완료 후 PR까지 연결할 수 있습니다.

코드 리뷰·분석​

특정 파일 변경 이력​

src/auth/login.js 최근 변경 이력 보여줘

내부적으로 git log, gh api 등을 조합해 결과를 보여줍니다.

CI/CD 상태 확인​

최근 워크플로 실행 상태 확인해줘
실패한 Actions 로그 보여줘

브랜치 관리​

# 브랜치 생성 + 체크아웃
feature/login-fix 브랜치 만들고 이동해줘

# 원격에 푸시
현재 브랜치 원격에 올려줘

실무 워크플로 예시​

일반적인 기능 개발 흐름을 Claude Code와 함께 진행하는 예시입니다.

1. 이슈 확인 → 브랜치 생성​

42번 이슈 내용 보여줘
이 이슈 작업할 브랜치 만들어줘

2. 코드 수정​

이슈에서 설명한 로그인 에러를 수정해줘

3. 커밋 → PR 생성​

지금까지 변경사항 커밋하고 PR 만들어줘. 42번 이슈 연결해서.

PR 본문에 Closes #42가 자동으로 포함되어, 머지 시 이슈가 자동 닫힙니다.

4. 리뷰 반영 → 머지​

PR에 달린 코멘트 보여줘
리뷰 반영해서 수정하고 커밋해줘

팁​

  • Claude Code는 gh 명령의 결과를 파싱해 작업하므로, gh auth login이 선행되어야 합니다.
  • 민감한 작업(force push, 브랜치 삭제 등)은 Claude Code가 실행 전 확인을 요청합니다.
  • GitHub Enterprise를 사용하는 경우 gh auth login --hostname github.enterprise.com으로 별도 인증하세요.

참고 자료​