Claude Code 상세 사용법 44: GitHub Actions로 PR 자동화 걸기 | DAKER 커뮤니티

Claude Code 상세 사용법 44: GitHub Actions로 PR 자동화 걸기

로컬 Claude Code가 “내 터미널의 pair programmer”라면, GitHub Actions 통합은 이슈와 PR 안에서 움직이는 자동화 작업자입니다. 공식 문서 기준으로 @claude를 이슈나 PR 댓글에 남기면 Claude Code Action이 저장소 컨텍스트를 읽고, 구현 PR을 만들거나 리뷰를 남길 수 있습니다.

설치 흐름

가장 빠른 길은 Claude Code 터미널에서 설치 명령을 실행하는 것입니다. 단, 저장소 admin 권한과 GitHub App 설치, Actions secret 설정이 필요합니다.

/install-github-app

수동 설정은 세 단계입니다.

  1. Claude GitHub App을 저장소에 설치합니다.

  2. ANTHROPIC_API_KEY를 GitHub Actions secret에 넣습니다.

  3. .github/workflows/claude.yml에 공식 예제 workflow를 추가합니다.

name: Claude
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1

좋은 @claude 요청

@claude 이 PR에서 checkout timeout 원인을 좁혀줘.
범위는 packages/checkout, tests/checkout만.
수정이 필요하면 별도 브랜치에 최소 패치와 재현 테스트를 추가해줘.
배포 설정은 건드리지 마.

바이브코딩에서 흔한 실수는 “고쳐줘”만 쓰는 것입니다. 파일 범위, 테스트, 금지 영역, 완료 기준을 넣어야 AI 코딩 결과가 리뷰 가능한 단위가 됩니다.

안전 체크

GitHub Actions는 편하지만 권한이 넓습니다. 공식 문서는 앱이 Contents, Issues, Pull requests 권한을 요청한다고 설명합니다. 그래서 저장소별로 설치하고, secret은 GitHub Secrets에만 두고, 댓글이나 로그에 키를 쓰지 않아야 합니다.

프로덕션 배포 버튼처럼 쓰는 것도 피하세요. Claude가 PR을 만들 수는 있어도, merge와 deploy gate는 CI, 코드 리뷰, 보호 브랜치가 담당해야 합니다.

실패 모드

@claude가 반응하지 않으면 먼저 앱 설치 저장소, workflow trigger, secret 이름, comment permission을 확인하세요. Claude의 커밋에서 CI가 다시 돌지 않는 경우도 있습니다. 그때는 workflow 권한과 pull request 이벤트 조건을 따로 봐야 합니다.

또 하나의 실패는 비용입니다. 큰 저장소에서 모호한 요청을 던지면 컨텍스트 탐색과 수정 루프가 길어집니다. “조사만 해줘”, “패치까지 해줘”, “테스트까지 돌려줘”를 분리하면 비용과 리뷰 피로가 줄어듭니다.

선임 엔지니어 관점

Claude Code GitHub Actions는 사람을 PR에서 빼는 도구가 아니라, 반복적인 조사와 초안 패치를 PR 안으로 끌어오는 도구입니다. 좋은 LLM 개발 워크플로우는 @claude 댓글보다 보호 장치가 먼저입니다. CLAUDE.md, 좁은 요청, CI, 리뷰 규칙을 갖춘 뒤에 자동화를 켜세요.

참고: Claude Code 공식 문서의 GitHub Actions와 CLI reference를 기준으로 작성했습니다.

Redirecting to Claude Code 상세 사용법 44: GitHub Actions로 PR 자동화 걸기 | DAKER 커뮤니티...