설치 | Voicescript

사전 요구 사항

Claude Code Action을 설치하기 전에 다음을 확인하세요:

GitHub 저장소
저장소 관리자 권한
Claude Code CLI 액세스
Anthropic API 키 또는 Claude Code OAuth 토큰

빠른 설치 (권장)

Claude Code Action을 설치하는 가장 빠른 방법은 Claude Code CLI를 사용하는 것입니다:

1. Claude Code 열기

claude

2. 설치 명령 실행

/install-github-app

이 명령은 다음을 안내합니다:

Claude GitHub 앱 설치
필요한 시크릿 설정
워크플로우 파일 구성

수동 설치

수동으로 설정하거나 더 많은 제어가 필요한 경우:

1. Claude GitHub 앱 설치

https://github.com/apps/claude를 방문하여 저장소에 앱을 설치하세요.

2. 인증 설정

저장소에 다음 시크릿 중 하나를 추가하세요:

옵션 A: Anthropic API 키 (권장)

저장소 설정으로 이동
Secrets and variables → Actions로 이동
New repository secret 클릭
Name: ANTHROPIC_API_KEY
Value: Anthropic API 키

옵션 B: Claude Code OAuth 토큰

저장소 설정으로 이동
Secrets and variables → Actions로 이동
New repository secret 클릭
Name: CLAUDE_CODE_OAUTH_TOKEN
Value: OAuth 토큰

3. 워크플로우 파일 생성

저장소에 .github/workflows/claude.yml 생성:

name: Claude Code Action

on:
  issues:
    types: [opened, labeled]
  pull_request:
    types: [opened, labeled, synchronize]
  issue_comment:
    types: [created]

permissions:
  contents: write
  issues: write
  pull-requests: write

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # 또는 OAuth 토큰 사용:
          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

4. 커밋 및 푸시

git add .github/workflows/claude.yml
git commit -m "Add Claude Code Action workflow"
git push

대체 인증 방법

Amazon Bedrock

- uses: anthropics/claude-code-action@v1
  with:
    aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }}
    aws_secret_access_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    aws_region: us-east-1

Google Vertex AI

- uses: anthropics/claude-code-action@v1
  with:
    gcp_project_id: ${{ secrets.GCP_PROJECT_ID }}
    gcp_service_account_key: ${{ secrets.GCP_SERVICE_ACCOUNT_KEY }}
    gcp_region: us-central1

사용자 정의 GitHub 앱 설정 (고급)

사용자 정의 GitHub 앱이 필요한 조직의 경우:

1. GitHub 앱 생성

GitHub 설정 → Developer settings → GitHub Apps로 이동
New GitHub App 클릭
최소 권한 구성:
- Contents: Read & Write
- Issues: Read & Write
- Pull requests: Read & Write

2. 개인 키 생성

GitHub 앱 설정에서
Private keys로 스크롤
Generate a private key 클릭
.pem 파일 다운로드 및 보안 유지

3. 저장소에 앱 설치

GitHub 앱 설정으로 이동
Install App 클릭
대상 저장소 선택

4. 시크릿 추가

저장소에 다음 시크릿을 추가하세요:

APP_ID: GitHub 앱 ID
APP_PRIVATE_KEY: .pem 파일 내용

5. 워크플로우 업데이트

- uses: anthropics/claude-code-action@v1
  with:
    github_app_id: ${{ secrets.APP_ID }}
    github_app_private_key: ${{ secrets.APP_PRIVATE_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

검증

설치 후 다음을 통해 액션을 테스트하세요:

새 이슈 또는 풀 리퀘스트 생성
claude 레이블 추가 (레이블 기반 트리거 사용 시)
Actions 탭에서 워크플로우 실행 확인

보안 모범 사례

API 키를 저장소에 직접 커밋하지 마세요
모든 민감한 값에 대해 GitHub Actions 시크릿 사용
API 키와 토큰을 정기적으로 교체하세요
워크플로우 출력에 민감한 변수를 로깅하지 마세요
GitHub 앱 권한을 정기적으로 검토하세요

설치