claude-review-bot

PR을 올리면 Claude가 자동으로 코드 리뷰를 달아주는 GitHub Actions 봇입니다.

PR이 처음 만들어질 때뿐만 아니라, PR에 새로운 커밋을 push할 때마다 변경된 코드를 다시 분석해서 리뷰를 새로 작성해줍니다.

이런 식으로 동작합니다

PR을 올리면, 아래처럼 Claude가 자동으로 리뷰 코멘트를 남깁니다.

개선이 필요한 부분은 중요도별로 나눠서 알려줍니다.

---

설정 방법

총 3단계로 구성되어 있습니다.

Step 1. 파일 복사

이 레포의 .github/ 폴더를 통째로 내 프로젝트에 복사하면 됩니다.

복사해야 할 파일 목록:

.github/
├── workflows/
│   └── claude-review.yml      ← GitHub Actions 워크플로우
└── scripts/
    ├── config.py              ← 설정 파일 (모델, 언어 등)
    ├── review.py              ← 리뷰 실행 스크립트
    └── test_review.py         ← 테스트

이미 .github/workflows/ 폴더가 있다면, 기존 파일은 그대로 두고 위 파일들만 추가하면 됩니다.

Step 2. Anthropic API 키 발급

Claude를 사용하려면 Anthropic API 키가 필요합니다.

1. Anthropic Console에 접속합니다
2. 로그인 후, 좌측 메뉴에서 API Keys를 클릭합니다
3. Create Key 버튼을 눌러 새 키를 생성합니다
4. 생성된 키를 복사해둡니다

이 키는 생성 시점에 한 번만 표시됩니다. 반드시 복사해두시기 바랍니다.

Step 3. GitHub Secret 등록

방금 복사한 API 키를 GitHub 레포지토리에 등록해야 합니다.

이렇게 하면 GitHub Actions가 실행될 때 이 키를 안전하게 사용할 수 있습니다.

3-1. 내 레포지토리 페이지 상단에서 Settings 탭을 클릭합니다.

3-2. 왼쪽 사이드바에서 Secrets and variables를 클릭하면 드롭다운이 열립니다. Actions를 클릭합니다.

3-3. 초록색 New repository secret 버튼을 클릭합니다.

3-4. 아래와 같이 입력한 뒤 Add secret 버튼을 클릭합니다.

• Name : ANTHROPIC_API_KEY (이 이름 그대로 입력해야 합니다)
• Secret : Step 2에서 복사한 API 키

GITHUB_TOKEN은 GitHub Actions에서 자동으로 제공되므로 별도로 등록할 필요가 없습니다.

설정이 완료되었습니다. 이제 PR을 올리면 Claude가 자동으로 리뷰를 달아줍니다.

---

설정 커스텀

.github/scripts/config.py 파일 하나에서 모든 설정을 바꿀 수 있습니다.

기본값 그대로 사용해도 동작하며, 필요에 따라 아래 항목들을 수정할 수 있습니다.

# Claude 모델 — 어떤 모델로 리뷰할지
MODEL = "claude-opus-4-6"

# 리뷰 언어 — Claude가 어떤 언어로 리뷰를 작성할지
LANGUAGE = "English"

# diff 최대 길이 — 변경사항이 이 글자 수를 넘으면 잘려서 리뷰됩니다
MAX_DIFF_LENGTH = 200_000

# Claude 응답 최대 토큰 — 리뷰 코멘트의 최대 길이
MAX_TOKENS = 4096

# GitHub API 타임아웃 — 코멘트 작성 시 대기 시간 (초)
POST_COMMENT_TIMEOUT = 30

모델 옵션

Model	특징
claude-opus-4-6	가장 정확한 리뷰. 비용 높음
claude-sonnet-4-5-20250929	속도와 품질 밸런스. 추천
claude-haiku-4-5-20251001	빠르고 저렴. 간단한 리뷰에 적합

비용 대비 성능을 고려한다면 claude-sonnet-4-5-20250929을 추천합니다.

언어 옵션

LANGUAGE 값만 바꾸면 됩니다.

LANGUAGE = "Korean"    # 한국어로 리뷰
LANGUAGE = "English"   # 영어로 리뷰
LANGUAGE = "Japanese"  # 일본어로 리뷰

---

동작 원리

내부 동작 흐름은 다음과 같습니다.

1. 트리거 — PR이 열리거나, 이미 열린 PR에 새 커밋이 push되면 GitHub Actions가 자동 실행
2. diff 추출 — base 브랜치와 비교해서 변경된 코드(diff)를 가져옴
3. Claude에게 리뷰 요청 — diff를 Claude API에 보내서 코드 리뷰를 요청
4. 코멘트 작성 — 받은 리뷰 결과를 PR에 코멘트로 작성

리뷰 기준

Claude는 아래 기준으로 코드를 검토합니다.

• 코드 품질 — 타입 안정성, 에러 처리, 성능
• 유지보수성 — 네이밍, 중복 제거
• 테스트 커버리지 — 테스트가 충분한지
• 보안 이슈 — XSS, API 키 노출 등

특별한 문제가 없는 경우에는 긍정적인 리뷰만 작성합니다. 불필요한 지적을 만들어내지 않습니다.