topic★★★★★난이도 · 약 25분

GitHub Actions 연동 — CI/CD와 자동 리뷰

GitHub Actions 워크플로우에 Claude Code를 통합해 PR 자동 리뷰·코드 생성을 구현한다.

#GitHub Actions#CI/CD#자동 리뷰#워크플로우

왜 배우는가

PR을 올릴 때마다 사람이 리뷰할 때까지 기다리는 건 병목이다. Claude가 CI 파이프라인 안에서 자동으로 1차 리뷰를 해주면 머지 속도가 2~3배 빨라진다.

GitHub Actions는 GitHub 저장소에서 코드 변경이 일어날 때 자동으로 작업을 실행하는 CI/CD 플랫폼이다. `.github/workflows/` 디렉토리에 YAML 파일을 넣으면 push, PR, 스케줄 등의 이벤트에 반응해 빌드·테스트·배포가 자동으로 돌아간다.

GitHub Actions 워크플로우 — push/PR 이벤트 → build → test → deploy 자동 실행

yaml

# .github/workflows/claude-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Claude Code Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          model: claude-sonnet-4-20250514
          prompt: |
            이 PR의 변경사항을 리뷰해주세요.
            보안, 성능, 타입 안전성을 중점적으로 확인.

PR이 열리거나 업데이트될 때 Claude가 자동으로 코드 리뷰 코멘트를 남긴다.

기능	설명
PR 자동 리뷰	PR diff를 분석해 코멘트를 남김
@claude-code 멘션	PR 코멘트에서 `@claude-code`를 멘션하면 응답
코드 생성	Issue를 할당하면 자동으로 브랜치 생성 + 코드 작성
테스트 실행	변경된 파일에 대한 테스트를 자동 실행하고 결과 리포트

@claude-code 멘션 기능은 특히 강력하다. PR 코멘트에 `@claude-code 이 함수의 에러 핸들링을 개선해줘`라고 쓰면, Claude가 해당 코드를 수정한 커밋을 자동으로 푸시한다. 사람과 AI가 PR 안에서 대화하며 협업하는 셈이다.

보안 주의: `ANTHROPIC_API_KEY`는 반드시 GitHub Secrets에 저장해야 한다. 워크플로우 파일에 API 키를 직접 적으면 저장소가 공개될 때 키가 노출된다. Settings → Secrets and variables → Actions에서 등록하자.