기본 설정: GitHub Actions에서 Claude Code를 실행하려면 ANTHROPIC_API_KEY를 GitHub Secrets에 등록하고, 워크플로우에서 Claude Code를 설치한 뒤 실행한다. --dangerously-skip-permissions 플래그로 비대화형 모드에서 실행한다.
Claude Code 가이드 #6 — GitHub Actions 연동
PR 자동 코드 리뷰를 구현하는 GitHub Actions + Claude Code 워크플로우 설정법을 정리한다. YAML 구성, 시크릿 관리, 리뷰 품질 튜닝과 비용 제어 방법까지 포함한다.
한 줄 요약: Claude Code를 GitHub Actions에 연동하면 PR 자동 리뷰, 이슈 기반 코드 생성, 테스트 자동화 등 CI/CD 파이프라인에 AI를 통합할 수 있다.
Claude Code는 CLI 도구이므로 GitHub Actions 워크플로우에서 직접 실행할 수 있다. 이 가이드는 자동 PR 리뷰, 이슈 처리 자동화, 코드 품질 검사 워크플로우를 설정하는 방법을 정리한다.
GitHub Actions 워크플로우 설정
.github/workflows/claude-review.ymlname: Claude Code Review on: pull_request: types: [opened, synchronize] jobs: review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: "이 PR의 변경사항을 리뷰해줘"
PR 자동 리뷰 워크플로우name: Claude Code Review on: pull_request: types: [opened, synchronize] jobs: review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Install Claude Code run: npm install -g @anthropic-ai/claude-code - name: Run Review env: ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} run: | claude --dangerously-skip-permissions \ "Review this PR. Check for bugs, security issues, and suggest improvements. Post as PR comment."
이슈 처리 자동화: 특정 라벨(예: claude-fix)이 붙은 이슈를 Claude Code가 자동으로 처리하고 PR을 생성하는 워크플로우를 만들 수 있다. 단, 자동 생성된 PR은 반드시 인간 리뷰를 거쳐야 한다.
커스텀 리뷰 프롬프트
CLAUDE.md에 리뷰 체크리스트를 정의하면, Claude Code가 해당 기준으로 리뷰합니다. 팀의 코딩 컨벤션, 보안 정책, 성능 기준을 반영할 수 있습니다.
PR 코멘트 자동 작성
리뷰 결과를 PR 코멘트로 자동 게시할 수 있습니다. 파일별 인라인 코멘트와 전체 요약을 함께 제공합니다.
다음 편에서는 터미널 vs VS Code vs 데스크톱 환경별 사용법을 비교합니다.
비용 관리와 제한
GitHub Actions에서 Claude Code를 실행하면 API 비용이 발생한다. PR당 평균 $0.05~0.30 수준이지만, 큰 diff를 가진 PR에서는 더 높아질 수 있다. 비용 절감: 특정 파일 패턴만 리뷰하도록 제한, 드래프트 PR은 제외, max_tokens를 설정해 응답 길이 제한.
보안 주의: ANTHROPIC_API_KEY를 GitHub Secrets에 등록하고, 절대 워크플로우 파일에 직접 기재하지 말 것. fork에서 오는 PR에서는 Secrets에 접근할 수 없으므로 보안이 유지된다.
claude-code클로드 코드github-actionsci-cd자동리뷰