Blog

클로드 코드 깃허브 액션이란?

Ashley Goolam

Ashley Goolam

9 June 2025

클로드 코드 깃허브 액션이란?

AI로 개발 워크플로우를 초고속으로 개선하고 싶으신가요? Anthropic의 Claude AI를 GitHub 리포지토리에 통합하는 혁신적인 Claude Code Github Action을 만나보세요. 풀 리퀘스트나 이슈에 @claude 멘션만 남기면, Github Actions를 통해 Claude가 전문가처럼 코드를 작성하고, 버그를 수정하거나, 리팩터링을 해줍니다. 저는 이걸 15분 만에 설정했는데, 그 효율성이 놀라울 정도입니다! 이 튜토리얼에서는 Claude Code Github Action을 설치하고, 설정하고, 코딩 작업을 자동화하는 방법을 안내해 드립니다. AI가 힘든 작업을 대신하게 할 준비가 되셨나요? 시작해봅시다!

💡
API 작업이나 프로젝트 문서화 작업을 하고 계신가요? APIdog를 사용하여 API 설계 및 테스트를 간소화하세요. Github Actions 워크플로우의 완벽한 조력자가 될 것입니다!
버튼

Claude Code Github Action이 뛰어난 이유

Claude Code Github Action은 팀에 24시간 대기하는 천재 코더를 두는 것과 같습니다. Anthropic의 Claude AI를 기반으로 구축되어, 리포지토리에서 @claude 멘션을 감지하면 Github Actions의 힘으로 즉시 실행됩니다. 왜 멋진지 알려드릴게요:

GitHub 리포지토리는 매끄러운 워크플로우를 자랑하며, 저는 몇 초 만에 리팩터링된 함수를 만들어내는 것을 보았습니다. 이제 실행해 봅시다!

claude with github actions

Claude Code Github Action 작동 방식

Claude Code는 Github Actions와 연동되어 이슈, 풀 리퀘스트 또는 리뷰 댓글에서 @claude 멘션을 모니터링합니다. 트리거되면 다음을 수행합니다:

마치 잠들지 않는 코딩 파트너를 Github Actions 러너를 통해 두는 것과 같습니다. 설정할 준비가 되셨나요? 방법은 다음과 같습니다!

단계별 설정: Claude Code Github Action

리포지토리에서 Claude Code를 실행해 봅시다. 저는 Node.js 프로젝트에서 테스트했지만, 어떤 코드베이스에서도 작동합니다. 다음 단계를 따라 약 15분 안에 워크플로우를 자동화하세요.

1. Claude GitHub 앱 설치

리포지토리에 대한 관리자 권한이 필요합니다.

download claude

2. Anthropic API 키 추가

Claude가 제대로 작동하려면 API 키가 필요합니다.

3. Claude 워크플로우 파일 추가

이제 Github Actions 워크플로우를 설정해 봅시다.

# .github/workflows/claude.yml
name: Claude PR Assistant

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude-code-action:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude PR Action
        uses: grll/claude-code-action@beta
        with:
          use_oauth: true
          claude_access_token: ${{ secrets.CLAUDE_ACCESS_TOKEN }}
          claude_refresh_token: ${{ secrets.CLAUDE_REFRESH_TOKEN }}
          claude_expires_at: ${{ secrets.CLAUDE_EXPIRES_AT }}
          
          timeout_minutes: "60"
          # Optional: add custom trigger phrase (default: @claude)
          # trigger_phrase: "/claude"
          # Optional: add assignee trigger for issues
          # assignee_trigger: "claude"
          # Optional: add custom environment variables (YAML format)
          # claude_env: |
          #   NODE_ENV: test
          #   DEBUG: true
          #   API_URL: https://api.example.com

4. GitHub App Secrets 구성

워크플로우가 앱 토큰을 생성하려면:

5. @claude로 Claude 트리거하기

이제 테스트해 보세요!

@claude Please refactor the data fetching logic in `api.js` for better error handling.
@claude

Claude Code Github Action 사용자 정의하기

Claude의 동작을 수정하고 싶으신가요? Github Actions 워크플로우는 매우 유연합니다. 나만의 것으로 만드는 방법은 다음과 같습니다:

저는 "TypeScript 선호"라는 내용을 담은 CLAUDE.md를 추가했는데, Claude의 PR이 제 스타일에 완벽하게 맞았습니다!

실제 사용 사례: Claude Code 활용

Claude Code는 개발 작업 속도를 높이는 데 탁월합니다. 제가 시도해 본 것과 Github Actions로 할 수 있는 일은 다음과 같습니다:

github actions fix results

Claude Code Github Action 활용 팁

Github Actions와 함께 Claude Code를 최대한 활용하려면:

자세한 프롬프트는 Claude의 응답 시간을 절반으로 줄이는 데 도움이 되었습니다. 정확성이 중요합니다!

Claude Code Github Action이 뛰어난 이유

Claude Code Github Action은 생산성 괴물입니다. 수동 코딩보다 빠르고, 프로젝트 스타일을 존중하며, Github Actions 러너에서 안전하게 실행됩니다. 다른 AI 도구와 비교했을 때, 단일 댓글로 전체 PR을 생성하는 Claude의 능력은 비교할 수 없습니다. 설정이 빠르고 GitHub 통합이 네이티브처럼 느껴집니다. 작은 문제점은 복잡한 작업의 경우 프롬프트 수정이 필요할 수 있지만, 레포의 예시가 도움이 됩니다.

개인 개발자이든 팀의 일원이든, Claude Code는 코딩을 마법처럼 느끼게 합니다. 꼭 한번 사용해보세요!

버튼

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드