Claude Code + GitHub — GitHub App, Action 워크플로, PR에서 @claude 사용(2026)

1. GitHub App 설치

claude
/install-github-app

이 명령은 저장소에 앱을 설치하고, API 키를 저장소 시크릿으로 저장하며, 워크플로 파일을 추가하는 풀 리퀘스트를 여는 과정을 안내합니다. 세 작업 모두 직접 수행할 수도 있습니다.

2. 워크플로

name: Claude
on:
  issue_comment: { types: [created] }
  pull_request_review_comment: { types: [created] }
  issues: { types: [opened, assigned] }

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude') || github.event_name == 'issues'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 1 }
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: https://aiprimetech.io

env 줄을 추가하면 CI의 모든 실행이 게이트웨이를 거칩니다. 저장소 시크릿은 게이트웨이 키이며, 사용량은 게이트웨이 잔액이나 무제한 요금제에 반영됩니다. Anthropic 계정으로 요금을 청구하려면 env 줄을 제거하세요.

3. 사용 방법

댓글 작성 @claude fix the failing test in auth.py 을 이슈에 댓글로 남기면 풀 리퀘스트를 엽니다.
댓글 작성 @claude 을 풀 리퀘스트 검토 스레드에 댓글로 남기면 응답하고 해당 브랜치에 변경 사항을 푸시합니다.
앱에 이슈를 할당하면 댓글 없이도 구현하도록 할 수 있습니다.
예약 실행하기: 고정 프롬프트(의존성 점검, 변경 로그 초안)를 사용하는 cron 트리거 워크플로를 설정하세요.

CI 비용

각 트리거는 체크아웃, 관련 파일 읽기, 계획, 수정, 테스트, 푸시를 포함하는 전체 에이전트 실행입니다. 실제 저장소에서는 실행당 수만 토큰이 사용될 것으로 예상하세요. 모든 PR에 @claude를 연결하는 팀은 토큰당 과금보다 정액 요금제가 유리한 사용자에 해당합니다. 요금 안내를 참고하세요.

권한과 안전

작업에는 해당 태스크에 필요한 권한만 부여하세요. contents: write 은 푸시에 필요합니다.
공개 저장소에서는 신뢰할 수 있는 기여자만 트리거할 수 있도록 제한하세요. 그렇지 않으면 댓글을 달 수 있는 누구나 토큰을 소비할 수 있습니다.
다음을 사용하세요: allowed_tools 을 액션 입력에 설정해 에이전트가 실행할 수 있는 범위를 제한하세요.

먼저 무료로 사용해 보세요

신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

코드 CLAUDECODE로 계정 만들기

자주 묻는 질문

Claude Code GitHub Action은 무료인가요?

Action은 오픈 소스이며 무료입니다. 실행 시에는 워크플로에서 사용하는 키로 토큰 비용이 청구됩니다.

GitHub Action에서 Anthropic 이외의 엔드포인트를 사용할 수 있나요?

네. 해당 단계의 env에 ANTHROPIC_BASE_URL을 설정하고, 이에 맞는 키를 시크릿으로 제공하세요.

@claude는 비공개 저장소에서도 작동하나요?

네. 저장소에 GitHub App이 설치되어 있고 워크플로 파일이 있으면 작동합니다.

게이트웨이에서 Claude Code 실행하기

동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.

API 키 발급받기 무제한 요금제 보기

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

GitHub에서 Claude Code 사용하기: App, Action 및 @claude

TLDR