Claude Code 상세 사용법 07: GitHub Actions로 PR 작업 자동화하기 | DAKER 커뮤니티

Claude Code 상세 사용법 07: GitHub Actions로 PR 작업 자동화하기

어제까지 Claude Code를 로컬 CLI, slash command, MCP, hooks 중심으로 다뤘다. 이제 팀 워크플로우로 올릴 차례다. 공식 Claude Code GitHub Actions 문서 기준으로, 현재 권장 경로는 저장소에 Claude GitHub App과 workflow를 붙이고 PR 또는 issue 댓글에서 @claude로 작업을 호출하는 방식이다.

1. 설치 전에 권한부터 확인한다

빠른 설치는 Claude Code 터미널에서 /install-github-app을 실행하는 것이다. 다만 저장소 관리자 권한이 필요하고, GitHub App은 Contents, Issues, Pull requests에 read/write 권한을 요청한다. 회사 저장소라면 "누가 어떤 repo에 설치할 수 있는가"를 먼저 정해야 한다.

claude
/install-github-app

수동으로 붙일 때는 ANTHROPIC_API_KEY를 GitHub repository secret에 넣고 .github/workflows/claude.yml에 anthropics/claude-code-action@v1을 둔다. secret 값은 절대 PR 본문, 로그, CLAUDE.md에 쓰지 않는다.

2. 한 댓글에 한 목표만 준다

@claude는 만능 채팅창이 아니라 CI에서 실행되는 agentic coding 트리거다. 좋은 요청은 범위, 성공 조건, 금지 조건이 짧다.

@claude fix the failing auth tests.
Keep the public API unchanged, run the targeted test, and summarize the root cause.

나쁜 요청은 "전체적으로 개선해줘"처럼 끝이 없다. GitHub Actions 비용과 리뷰 노이즈를 줄이려면 PR 하나에 한 책임, 댓글 하나에 한 목표를 지킨다.

3. workflow 파일은 작게 시작한다

처음에는 issue comment와 PR review comment 이벤트만 받게 두고, Claude가 만든 커밋도 기존 CI를 통과해야 merge되게 한다.

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

모델, max turns, 추가 system prompt는 claude_args로 넣는다. 오래 걸리는 migration이나 repo-wide refactor는 먼저 로컬 Claude Code에서 계획을 만들고, GitHub Actions에는 좁은 실행만 맡기는 편이 안전하다.

4. 실패 모드

가장 흔한 실패는 @claude가 반응하지 않는 경우다. 이때는 App 설치 repo, secret 이름, workflow trigger, 작성자 권한, PR이 열린 상태인지 확인한다. 두 번째는 Claude가 고쳤지만 CI가 깨지는 경우다. 이건 실패가 아니라 정상적인 방어선이다. Claude 결과를 신뢰하되, merge 권한은 테스트 자동화와 사람 리뷰가 가져야 한다.

Senior takeaway: Claude Code GitHub Actions는 개발자를 대체하는 버튼이 아니라, PR 안에서 반복 작업을 처리하는 팀원이다. 바이브코딩을 실무 개발 생산성으로 바꾸려면 호출 문장보다 권한, CI, 리뷰 기준을 먼저 설계해야 한다.