클로드 코드(Claude Code)에서 /install-github-app 명령 하나를 실행하면, 깃허브에 PR(코드 변경 요청)을 올릴 때마다 클로드가 문제 되는 줄에 리뷰 댓글을 다는 자동화가 설정돼요. 워크플로 파일(깃허브가 자동으로 돌리는 작업 순서표)과 비밀 키 등록까지 클로드 코드가 대신 준비해 줘요.
이런 분께
- 혼자 또는 두세 명이 개발해서 코드 리뷰해 줄 사람이 없는 분
- PR마다 "이 부분 확인해 주세요"를 매번 사람에게 부탁하기 미안한 분
끝나면 이렇게 됩니다
공식 문서 예시 기준이에요.
- PR을 열거나 새로 커밋을 올리면 클로드가 PR을 읽고, 찾은 문제마다 해당 줄에 댓글을 달아요. 문제가 없으면 요약 댓글 하나만 남겨요.
- 이슈나 PR 댓글에 이렇게 쓰면 클로드가 같은 자리에 답을 달고 작업해요.
@claude fix the TypeError in the user dashboard component
@claude how should I implement user authentication for this endpoint?
초안(draft) PR, 닫힌 PR, 이미 클로드 댓글이 달린 PR은 건너뛰어요.
준비물
- 클로드 코드가 깔린 컴퓨터와 Claude Pro·Max·Team·Enterprise 요금제, 또는 Claude API 키(서비스에 접속하는 비밀 열쇠)
- github.com 저장소의 관리자(admin) 권한. GitLab이나 Bitbucket 저장소는 이 명령이 안 돼요.
- GitHub CLI(깃허브를 글자 명령으로 다루는 도구) 설치와 로그인
- 비용: 실행마다 GitHub Actions 사용 시간이 들고, API 키로 연결하면 사용한 만큼 요금이 나가요. 구독 토큰으로 연결하면 구독 사용량에서 빠져요(2026년 11월 기준).
따라 하기
- 터미널(컴퓨터에 글자로 명령하는 창)을 열어요. 윈도우는 시작 메뉴에서 '터미널', 맥은 Spotlight에서 '터미널'을 검색해요.
- GitHub CLI에 로그인해요. 안내대로 브라우저에서 승인하면 끝나요.
gh auth login
- 리뷰를 붙일 저장소 폴더로 이동해 클로드 코드를 켜고 설치 명령을 입력해요.
claude
/install-github-app
- 안내에 따라 Claude GitHub 앱을 저장소에 설치해요. 앱 권한은 일부만 고를 수 없고 통째로 승인해요.
- 인증 방식을 골라요. 구독이 있으면 구독 토큰(
CLAUDE_CODE_OAUTH_TOKEN), 아니면 API 키(ANTHROPIC_API_KEY)예요. 클로드 코드가 저장소 비밀 값(Secrets)에 알아서 저장해요. - 워크플로 고르는 화면에서
@claude응답용과 리뷰용을 둘 다 체크해요. - 브라우저에 PR 만들기 화면이 열리면 「Create pull request」를 누르고 병합(merge)해요. 이때부터 동작해요.
- 테스트 삼아 작은 수정으로 새 PR을 열고, 몇 분 뒤 「Files changed」 탭에 클로드 댓글이 달렸는지 봐요.
복사해서 쓰는 프롬프트
리뷰 기준은 저장소 맨 위 폴더의 CLAUDE.md 파일에 적어 두면 클로드가 매번 읽어요. 아래를 붙여 넣고 대괄호를 고쳐요.
