Install GitHub App

소개

코드 리뷰는 소프트웨어 품질을 유지하는 핵심 프로세스지만, 리뷰어의 시간과 에너지를 많이 소모합니다. Claude Code GitHub Actions를 사용하면 AI가 PR을 자동으로 분석하고, 이슈나 PR 코멘트에서 @claude를 호출하여 즉각적인 피드백을 받을 수 있습니다.

Claude Code GitHub Actions로 할 수 있는 것:

• PR이 열리면 자동으로 코드 리뷰를 받을 수 있습니다
• 이슈나 PR에서 @claude를 멘션하여 질문하거나 수정을 요청할 수 있습니다
• 코드 변경사항에 대한 즉각적인 피드백으로 리뷰 사이클을 단축할 수 있습니다

기본 제공 Workflow

/install-github-app 명령어를 통해 2가지 기본 Workflow를 설치할 수 있습니다. 이 Workflow들은 그대로 사용하거나, 프로젝트 요구사항에 맞게 커스터마이징할 수 있습니다.

@claude 멘션 (Claude Assistant)

이슈나 PR 코멘트에서 @claude를 멘션하면 Claude가 해당 컨텍스트를 분석하고 응답합니다.

사용 예시:

• @claude 이 버그의 원인이 뭘까요?
• @claude 이 함수를 리팩토링해주세요
• @claude 테스트 케이스를 추가해주세요

자동 PR 리뷰 (Claude Code Review)

PR이 생성되거나 업데이트되면 Claude가 자동으로 코드를 분석하여 리뷰 코멘트를 남깁니다.

리뷰 범위:

• 코드 품질 및 버그 가능성
• 보안 취약점
• 성능 개선 제안
• 코드 스타일 및 가독성

Prerequisites

• Claude Code 구독: Pro, Team, 또는 Enterprise 플랜
• Claude Code CLI: 로컬에 설치 및 인증 완료
• GitHub 권한: 대상 레파지토리의 Admin 권한

설치하기

Step 1: /install-github-app 실행

터미널에서 Claude Code를 실행하고 /install-github-app 명령어를 입력합니다. 이 명령어는 GitHub App 설치 마법사를 시작하여 OAuth 인증, 레파지토리 선택, Workflow 생성까지 안내합니다.

claude
> /install-github-app

Step 2: Claude 계정 연결

브라우저가 열리면 Claude Code와 Claude chat 계정을 연결합니다. OAuth 인증을 통해 GitHub Actions에서 Claude API를 사용할 수 있게 됩니다.

Step 3: GitHub 레파지토리 선택

Claude GitHub App을 설치할 레파지토리를 선택합니다. 특정 레파지토리만 선택하거나, 조직의 모든 레파지토리에 접근 권한을 부여할 수 있습니다.

Step 4: API Key 설정

GitHub Actions에서 Claude API를 호출하기 위한 인증 방식을 선택합니다.

이 가이드에서는 Long-lived Token을 선택합니다. 구독 계정과 연동되어 별도의 API Key 관리 없이 바로 사용할 수 있습니다.

Step 5: Workflow 선택

설치할 GitHub Workflow를 선택합니다. 두 가지 Workflow가 제공됩니다:

1. Claude PR Assistant (claude.yml)

• 트리거: 이슈/PR 코멘트에서 @claude 멘션
• 동작: 멘션된 내용을 분석하고 응답
• 용도: 질문, 코드 수정 요청, 설명 요청 등

2. Claude Code Review (claude-code-review.yml)

• 트리거: PR 생성 또는 업데이트
• 동작: 변경된 코드를 자동으로 리뷰
• 용도: 코드 품질 검토, 버그 탐지, 개선 제안

두 Workflow 모두 선택하여 설치하는 것을 권장합니다.

Step 6: PR 머지

설치가 완료되면 Claude Code가 자동으로 PR을 생성합니다. 이 PR에는 .github/workflows/ 디렉토리에 선택한 Workflow 파일들이 포함되어 있습니다.

PR을 리뷰하고 머지하면 해당 레파지토리에서 Claude GitHub Actions를 사용할 수 있습니다.

Step 7: 테스트

설치가 완료되었는지 확인하기 위해 이슈나 PR에서 @claude를 멘션해봅니다.

테스트 시나리오:

1. 새 이슈를 생성하고 @claude 이 레파지토리는 어떤 프로젝트인가요?라고 코멘트
2. 기존 PR에서 @claude 이 변경사항을 요약해주세요라고 코멘트

실제 사용 예시

버그 분석 요청

@claude 이 함수에서 null pointer exception이 발생하는데, 원인을 분석해주세요.

Claude는 해당 코드와 컨텍스트를 분석하여 가능한 원인과 해결 방안을 제시합니다.

코드 개선 요청

@claude 이 컴포넌트의 성능을 개선할 방법이 있을까요?

Claude는 불필요한 리렌더링, 메모이제이션 기회, 최적화 가능한 부분을 찾아 구체적인 개선안을 제안합니다.

PR 자동 리뷰

PR이 열리면 Claude가 자동으로 변경사항을 분석하고, 인라인 코멘트로 피드백을 제공합니다. 보안 이슈, 잠재적 버그, 코드 스타일 문제 등을 발견하면 구체적인 수정 제안과 함께 알려줍니다.

관련 문서

• Claude Code GitHub Actions 공식 문서