Skip to content

ClaudeCode:Actions

GitHub PR과 이슈에서 코드 질의응답과 수정 자동화를 지원하는 범용 액션

About

  • 코드 리뷰와 구현 자동화를 통해 개발 워크플로우 효율을 높이는 Claude 기반 GitHub Action
  • 지능형 모드 감지 기능으로 별도 설정없이 @claude 멘션, 이슈 할당, 자동화 프롬프트 등 상황에 맞게 동작
  • Claude 가 코드, 아키텍처, 프로그래밍 관련 질의응답 지원
  • PR 변경사항을 분석하고 개선을 제안
  • 자동 코드 작성: 단순 수정, 리팩터링, 신규 기능 구현까지 수행
  • GitHub 댓글 및 PR 리뷰와 통합되어 협업 흐름에 자연스럽게 연결
  • GitHub API 및 파일 조작 권한을 활용하며, 설정을 통해 추가 도구 확장 가능
  • 체크박스 기반으로 진행 상태를 표시하고, 작업 완료 과정을 시각적으로 추적
  • 단일화된 설정 구조(prompt, claude_args) 로 간결하고 강력한 구성 지원

claude.yml — Claude Code (멘션 기반)

@claude가 포함된 경우에만 실행됩니다:

트리거 이벤트

조건

Issue 코멘트 생성

코멘트 본문에 @claude 포함

PR 리뷰 코멘트 생성

코멘트 본문에 @claude 포함

PR 리뷰 제출

리뷰 본문에 @claude 포함

Issue 생성/할당

제목 또는 본문에 @claude 포함 

name: Claude Code

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

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

      - name: Run Claude Code
        id: claude
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

          # This is an optional setting that allows Claude to read CI results on PRs
          additional_permissions: |
            actions: read

          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
          # prompt: 'Update the pull request description to include a summary of changes.'

          # Optional: Add claude_args to customize behavior and configuration
          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
          # or https://code.claude.com/docs/en/cli-reference for available options
          # claude_args: '--allowed-tools Bash(gh pr:*)'

claude-code-review.yml — Claude Code Review (자동)

PR이 열리면 자동으로 코드 리뷰를 수행합니다:

트리거 이벤트

조건

Pull Request

opened, synchronize, ready_for_review, reopened

별도의 @claude 멘션 없이 PR 생성/업데이트 시 자동 실행됩니다. code-review 플러그인을 사용합니다. 

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
    # Optional: Only run on specific file changes
    # paths:
    #   - "src/**/*.ts"
    #   - "src/**/*.tsx"
    #   - "src/**/*.js"
    #   - "src/**/*.jsx"

jobs:
  claude-review:
    # Optional: Filter by PR author
    # if: |
    #   github.event.pull_request.user.login == 'external-contributor' ||
    #   github.event.pull_request.user.login == 'new-developer' ||
    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'

    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 Code Review
        id: claude-review
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
          plugins: 'code-review@claude-code-plugins'
          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
          # or https://code.claude.com/docs/en/cli-reference for available options

See also

Favorite site