Source: https://aiprimetech.io/ko/claude-code/github/

[홈](/ko/) › [Claude Code](/ko/claude-code/) › GitHub

[개요](/ko/claude-code/)[설치](/ko/claude-code/install/)[CLI 참조](/ko/claude-code/cli/)[요금 및 한도](/ko/claude-code/pricing/)[Agent SDK](/ko/claude-code/sdk/)[스킬 및 플러그인](/ko/claude-code/skills/)[GitHub](/ko/claude-code/github/)[웹, 데스크톱 및 IDE](/ko/claude-code/web-and-desktop/)[모델](/ko/claude-code/models/)[오류](/ko/claude-code/errors/)[오픈 소스인가요?](/ko/claude-code/open-source/)[튜토리얼](/ko/claude-code/tutorial/)[학생용 안내](/ko/claude-code/for-students/)[QA 자동화](/ko/claude-code/qa-automation/)[Cursor와 비교](/ko/claude-code/vs-cursor/)[Codex 및 OpenCode와 비교](/ko/claude-code/vs-codex/)[하위 에이전트](/ko/claude-code/subagents/)[훅](/ko/claude-code/hooks/)[MCP](/ko/claude-code/mcp/)[생태계](/ko/claude-code/ecosystem/)[VS Code](/ko/claude-code/vscode/)[OpenRouter](/ko/claude-code/openrouter/)[요청 속도 제한](/ko/claude-code/rate-limits/)[중국어 가이드](/claude-code/zh/)

최종 업데이트: 2026년 10월 11일

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

Claude Code를 저장소의 워크플로에 통합할 수 있습니다. 풀 리퀘스트를 검토하고, 멘션되면 이슈를 구현하며, CI의 한 단계로 실행할 수 있습니다. 이를 위해 세 가지 요소가 필요합니다.

## TLDR
- /install-github-app 을 터미널 세션에서 실행하면 GitHub App과 워크플로가 설정됩니다.
- 워크플로는 anthropics/claude-code-action을 사용하며, 필요한 시크릿은 API 키 하나입니다.
- 워크플로 환경 설정에서 ANTHROPIC_BASE_URL이 게이트웨이를 가리키도록 하면 CI 실행 요금이 이곳에 청구됩니다.

## 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로 계정 만들기](/register?promo=CLAUDECODE)

## 자주 묻는 질문

Claude Code GitHub Action은 무료인가요?

Action은 오픈 소스이며 무료입니다. 실행 시에는 워크플로에서 사용하는 키로 토큰 비용이 청구됩니다.GitHub Action에서 Anthropic 이외의 엔드포인트를 사용할 수 있나요?

네. 해당 단계의 env에 ANTHROPIC_BASE_URL을 설정하고, 이에 맞는 키를 시크릿으로 제공하세요.@claude는 비공개 저장소에서도 작동하나요?

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

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

동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.[API 키 발급받기](/register?promo=CLAUDECODE) [무제한 요금제 보기](/ko/plans/)

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

## 더 많은 Claude Code 가이드

[Claude Code: 완벽 가이드](/ko/claude-code/)[Claude Code 설치 방법](/ko/claude-code/install/)[Claude Code CLI 문서: 명령어와 플래그](/ko/claude-code/cli/)[Claude Code 요금 및 한도 설명](/ko/claude-code/pricing/)[Claude Code SDK, 이제 Claude Agent SDK로](/ko/claude-code/sdk/)[Claude Code 스킬과 플러그인](/ko/claude-code/skills/)[Claude Code에 웹 인터페이스가 있나요? 웹, 데스크톱 및 IDE 설명](/ko/claude-code/web-and-desktop/)[Claude Code가 사용하는 모델과 변경 방법](/ko/claude-code/models/)[Claude Code 오류와 해결 방법](/ko/claude-code/errors/)[Claude Code는 오픈 소스인가요?](/ko/claude-code/open-source/)[Claude Code 튜토리얼: 첫 실전 세션](/ko/claude-code/tutorial/)[학생을 위한 Claude: Claude Code, API 및 교육 분야에서 실제로 제공되는 혜택](/ko/claude-code/for-students/)[QA 자동화에 Claude Code를 사용하는 방법](/ko/claude-code/qa-automation/)[Claude Code와 Cursor 비교: 어떤 도구를 언제 선택하고, 둘 다 어떻게 사용할까](/ko/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: 터미널 에이전트 비교](/ko/claude-code/vs-codex/)[Claude Code 하위 에이전트: 작동 방식, 정의 방법, 에이전트 팀](/ko/claude-code/subagents/)[Claude Code 훅: 에이전트 동작에 대한 결정론적 제어](/ko/claude-code/hooks/)[Claude Code MCP: 서버 연결, 범위, 원격 MCP와 실제 예제](/ko/claude-code/mcp/)[Claude Code 생태계: 라우터, 프레임워크, 플러그인과 이를 모아 둔 목록](/ko/claude-code/ecosystem/)[VS Code에서 Claude Code 사용하기: 확장 프로그램, 터미널 사용 방식, 오류](/ko/claude-code/vscode/)[Claude Code에서 OpenRouter를 사용하는 방법과 사용하지 않는 편이 나은 경우](/ko/claude-code/openrouter/)[Claude 요청 한도 오류: "API 오류: 요청 한도 도달"의 의미와 해결 방법](/ko/claude-code/rate-limits/)[Claude Code 사용법: 설치부터 일상적인 사용까지](/claude-code/zh/)