GitHub Actions와 Claude Code 활용법

Claude Code와 GitHub Actions로 워크플로우를 강화할 준비가 되셨나요? GitHub 리포지토리에서 바로 풀 리퀘스트를 검토하고, 버그를 수정하거나, 새로운 기능을 작성하는 AI 팀원이 있다고 상상해 보세요. 마법 같죠? Anthropic의 Claude Code는 GitHub Actions와 원활하게 통합되어 간단한 @claude 멘션으로 작업을 자동화함으로써 이를 현실로 만듭니다. 저는 Anthropic 문서와 GitHub 리포지토리에서 이 보석 같은 것을 발견했으며, 이는 개발자들에게 판도를 바꾸는 요소입니다. 이 튜토리얼에서는 GitHub Actions에서 Claude Code를 설정하고, PR을 검토하는 워크플로우를 만들고, 그 기능을 탐색하는 과정을 안내해 드리겠습니다. 시작하여 리포지토리를 더 스마트하게 만들어 보세요!

💡

API를 사용하거나 프로젝트 문서를 작성하시나요? Claude Code 프로젝트에 완벽한 API 문서 디자인, 테스트 및 공유를 간소화하려면 APIdog를 다운로드하세요!

button

Claude Code와 GitHub Actions가 멋진 이유

Claude Code는 터미널이나 IDE에서 전문가처럼 코드베이스를 이해하는 Anthropic의 에이전트형 코딩 도구입니다. GitHub Actions와 페어링하면 코드 검토를 자동화하고, 기능을 구현하며, 리포지토리에서 직접 이슈를 분류하는 가상 팀원이 됩니다. (2025년 5월 기준) 베타 버전이지만 다음과 같은 작업에서 이미 빛을 발합니다.

코드 검토: 버그, 스타일, 표준 준수 여부를 PR에서 분석합니다.
기능 구현: 이슈 설명을 작동하는 코드로 변환합니다.
버그 수정: 버그를 찾아 수정하고 병합 준비가 된 PR을 생성합니다.

GitHub 리포지토리 anthropics/claude-code-action는 @claude 댓글로 트리거되는 기능을 강조하며, 이를 통해 상호 작용적이고 개발자 친화적입니다. 이제 설정해 봅시다!

GitHub Actions용 Claude Code 설정

리포지토리를 자동화하기 전에 환경을 준비해 봅시다. 초보자에게도 친숙하며, 빠르게 진행하겠습니다!

1. 요구 사항 확인:

GitHub 리포지토리: 시크릿 및 앱을 추가하려면 관리자 액세스 권한이 필요합니다.
Anthropic API 키: console.anthropic.com에서 가져옵니다. 무료 계정도 작동하지만, 유료 플랜(Pro/Max)은 더 많은 사용량을 제공합니다.
시스템: Git 및 터미널이 설치된 모든 OS (macOS, Linux, WSL2가 설치된 Windows).
Claude Code CLI (설정 시 선택 사항): npm install -g @anthropic-ai/claude-code로 설치합니다.

2. Claude GitHub 앱 설치:

터미널을 열고 다음을 실행합니다.

claude
/install-github-app

이 명령은 Claude GitHub 앱(github.com/apps/claude)을 리포지토리에 설치하도록 안내합니다. 프롬프트를 따라 리포지토리를 선택하고 권한을 승인합니다.
404 오류가 발생하면 gh 토큰을 새로 고침합니다: gh auth refresh -h github.com -s workflow를 실행하고 다시 시도합니다.
참고: 이 빠른 시작은 Anthropic API 사용자를 위한 것입니다. AWS Bedrock 또는 Google Vertex AI의 경우 Anthropic 문서에서 수동 설정을 참조하십시오.

3. API 키 추가:

설치 후 CLI는 워크플로우 파일(.github/workflows/claude.yml)이 포함된 PR을 생성합니다. 병합하기 전에 Anthropic API 키를 GitHub 시크릿으로 추가합니다.
리포지토리의 Settings > Secrets and variables > Actions로 이동합니다.
Anthropic 콘솔에서 가져온 키로 ANTHROPIC_API_KEY라는 시크릿을 추가합니다.
PR을 병합하여 워크플로우를 활성화합니다.

저는 테스트 리포지토리에서 10분 만에 이 설정을 마쳤습니다. 매우 순조로웠습니다.

참고: API 키에는 항상 GitHub 시크릿을 사용하세요!

GitHub Actions에서 Claude Code 워크플로우 생성

이제 Claude Code가 PR을 자동으로 검토하도록 GitHub Actions 워크플로우를 만들어 봅시다. GitHub 리포지토리에서 anthropics/claude-code-action을 사용합니다.

1. 워크플로우 파일 생성:

/install-github-app이 파일을 생성하지 않았다면, 리포지토리에 .github/workflows/claude.yml을 수동으로 추가합니다.

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Run Claude Code Review
        uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          direct_prompt: |
            Review the PR changes. Focus on code quality, potential bugs, and adherence to project standards. Suggest improvements and provide a detailed explanation.

이 워크플로우는 새 PR 또는 업데이트된 PR에서 Claude Code를 트리거하여 코드 품질과 버그를 검토합니다.

2. 워크플로우 테스트:

브랜치에 변경 사항을 푸시하고 PR을 엽니다. Claude Code가 실행되어 검토 결과를 댓글로 게시합니다 (예: "main.py에서 잠재적인 널 포인터를 발견했습니다. 확인을 추가하는 것을 고려해 보세요...").
저는 Python 리포지토리에서 이를 테스트했는데, Claude가 누락된 타입 힌트를 정확하게 잡아냈습니다!

3. 트리거 사용자 정의:

수동 제어를 원하시나요? 댓글에서 트리거되도록 워크플로우를 수정합니다.

on:
  issue_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

이제 @claude review this PR이라고 댓글을 달아 트리거할 수 있습니다.

고급 작업에 Claude Code 사용

GitHub Actions의 Claude Code는 단순히 검토만을 위한 것이 아니라 기능을 구현하거나 버그를 수정할 수도 있습니다. 다음은 레벨업하는 방법입니다.

1. 기능 구현:

이슈를 생성합니다: "로그인 엔드포인트에 사용자 인증 추가".
댓글을 답니다: @claude implement this feature based on the issue description.
Claude는 이슈를 분석하고 코드를 작성하며 PR을 생성합니다. 저는 REST API에 대해 이것을 시도했는데, 기본적인 JWT 인증 설정을 추가했습니다. 인상적이었습니다.

2. 버그 수정:

이슈에 버그를 설명합니다: "dashboard.js에서 TypeError 발생".
댓글을 답니다: @claude fix the TypeError in the user dashboard component.
Claude는 이슈를 찾아 수정 사항을 푸시하고 PR을 엽니다.

3. 프로젝트 표준 추가:

리포지토리 루트에 CLAUDE.md 파일을 생성하여 코딩 표준을 정의합니다 (예: "Python에는 PEP 8 사용"). Claude는 검토 및 구현 중에 이러한 가이드라인을 존중합니다.

샘플 구현:

1. 먼저 사용자가 @Claude를 태그하여 피드백 처리를 요청하는 댓글을 남기면 GitHub Actions를 통해 Claude의 자동 응답이 트리거됩니다.

2. 그런 다음 Claude는 댓글에 자동으로 응답하고 요청된 작업(예: API 오류 처리, 중복 제거)을 수행하며 완료된 작업 목록을 체크리스트로 제공합니다.

3. 마지막으로 검토자(예: 프론트엔드 엔지니어)가 Claude가 변경한 내용을 승인하면 풀 리퀘스트가 성공적으로 병합되고 닫히며, 이는 Claude의 변경 사항이 검토를 통과했음을 나타냅니다.

Claude Code의 GitHub Actions 기능 탐색

Claude Code를 더 활용하고 싶으신가요? 몇 가지 멋진 트릭이 있습니다.

이미지 분석: 댓글에 스크린샷을 업로드하면 (예: @claude fix this UI bug [screenshot]) Claude가 이를 분석하여 수정 사항을 제안합니다. 시각적 버그에 유용합니다.
사용자 정의 도구: 고급 작업(예: 데이터 가져오기)을 위해 Bash(git:*), GlobTool 또는 MCP (Model Control Protocol) 서버와 같은 도구를 활성화합니다. 예시는 GitHub 리포지토리를 참조하십시오.
더 빠른 러너: GitHub의 기본 러너에 비해 더 빠르고 저렴한 실행을 위해 Depot 러너(runs-on: depot-ubuntu-latest)를 사용합니다.
SDK 통합: GitHub Actions를 넘어선 작업을 위해 Claude Code SDK로 사용자 정의 워크플로우를 구축합니다.

저는 CSS 버그에 대해 이미지 분석을 실험했는데, Claude가 수정 사항을 정확하게 찾아냈습니다. 정말 놀라웠습니다!

마무리: GitHub Actions로 Claude Code 마스터하기

잘하셨습니다! 이제 GitHub Actions에서 Claude Code를 활용하여 코드 검토를 자동화하고, 기능을 구현하며, 버그를 해결할 수 있게 되었습니다! GitHub 앱 설치부터 워크플로우 생성까지, 이제 리포지토리를 생산성 강자로 만들 준비가 되었습니다. MCP 도구를 추가하거나, CLAUDE.md를 수정하거나, APIdog로 API 문서를 작성해 보세요. X나 Reddit에 Claude Code 성공 사례를 공유해 주세요. 여러분의 PR이 빛나는 것을 보고 싶습니다! 즐거운 코딩 되세요!

button