Claude Code GitHub Actions를 사용하여 개발 워크플로우에 Claude Code를 통합하는 방법을 알아보세요
@claude
멘션만으로 Claude가 코드를 분석하고, 풀 리퀘스트를 생성하며, 기능을 구현하고, 버그를 수정할 수 있습니다 - 모두 프로젝트 표준을 따르면서 말입니다.
CLAUDE.md
가이드라인과 기존 코드 패턴을 존중합니다/install-github-app
을 실행하기만 하면 됩니다.
이 명령은 GitHub 앱 설정과 필요한 시크릿 설정을 안내합니다.
/install-github-app
명령이 실패하거나 수동 설정을 선호하는 경우, 다음 수동 설정 지침을 따르세요:
.github/workflows/
로@claude
를 태그하여
액션을 테스트하세요!@beta
를 @v1
로 변경mode: "tag"
또는 mode: "agent"
삭제 (이제 자동 감지됨)direct_prompt
를 prompt
로 교체max_turns
, model
, custom_instructions
등을 claude_args
로 변환이전 베타 입력 | 새로운 v1.0 입력 |
---|---|
mode | (제거됨 - 자동 감지) |
direct_prompt | prompt |
override_prompt | GitHub 변수가 포함된 prompt |
custom_instructions | claude_args: --system-prompt |
max_turns | claude_args: --max-turns |
model | claude_args: --model |
allowed_tools | claude_args: --allowedTools |
disallowed_tools | claude_args: --disallowedTools |
claude_env | settings JSON 형식 |
@claude
멘션에 응답)에서 실행할지 자동화 모드(프롬프트와 함께 즉시 실행)에서 실행할지 자동으로 감지합니다.CLAUDE.md
파일을 생성하여 코드 스타일 가이드라인, 리뷰 기준, 프로젝트별 규칙, 선호하는 패턴을 정의하세요. 이 파일은 Claude가 프로젝트 표준을 이해하는 데 도움을 줍니다.
ANTHROPIC_API_KEY
라는 이름의 저장소 시크릿으로 추가anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
${{ secrets.ANTHROPIC_API_KEY }}
)를 사용하세요.
CLAUDE.md
를 간결하고 집중적으로 유지하며, 워크플로우에 적절한 타임아웃을 구성하세요.
@claude
명령을 사용하세요claude_args
에서 적절한 --max-turns
를 구성하세요prompt
사용/review
또는 /fix
와 같은 사전 구축된 프롬프트claude_args
를 통한 모든 Claude Code CLI 인수prompt
매개변수를 사용하여 지침을 제공하세요.사용자 정의 GitHub 앱 생성 (3P 공급자에게 권장)
.pem
파일을 저장.pem
파일의 내용으로 APP_PRIVATE_KEY
라는 새 시크릿 생성APP_ID
라는 새 시크릿 생성클라우드 공급자 인증 구성
AWS Bedrock
보안 참고: 저장소별 구성을 사용하고 최소 필요 권한만 부여하세요.필수 설정:
https://token.actions.githubusercontent.com
sts.amazonaws.com
token.actions.githubusercontent.com
AmazonBedrockFullAccess
정책Google Vertex AI
보안 참고: 저장소별 구성을 사용하고 최소 필요 권한만 부여하세요.필수 설정:
https://token.actions.githubusercontent.com
Vertex AI User
역할만 부여필수 시크릿 추가
ANTHROPIC_API_KEY
: console.anthropic.com의 Anthropic API 키APP_ID
: GitHub 앱의 IDAPP_PRIVATE_KEY
: 개인 키 (.pem) 내용GCP_WORKLOAD_IDENTITY_PROVIDER
GCP_SERVICE_ACCOUNT
APP_ID
: GitHub 앱의 IDAPP_PRIVATE_KEY
: 개인 키 (.pem) 내용AWS_ROLE_TO_ASSUME
APP_ID
: GitHub 앱의 IDAPP_PRIVATE_KEY
: 개인 키 (.pem) 내용워크플로우 파일 생성
AWS Bedrock 워크플로우
시크릿 이름 | 설명 |
---|---|
AWS_ROLE_TO_ASSUME | Bedrock 액세스용 IAM 역할의 ARN |
APP_ID | GitHub 앱 ID (앱 설정에서) |
APP_PRIVATE_KEY | GitHub 앱용으로 생성한 개인 키 |
us.anthropic.claude...
)와 버전 접미사가 포함됩니다.Google Vertex AI 워크플로우
시크릿 이름 | 설명 |
---|---|
GCP_WORKLOAD_IDENTITY_PROVIDER | Workload identity provider 리소스 이름 |
GCP_SERVICE_ACCOUNT | Vertex AI 액세스 권한이 있는 서비스 계정 이메일 |
APP_ID | GitHub 앱 ID (앱 설정에서) |
APP_PRIVATE_KEY | GitHub 앱용으로 생성한 개인 키 |
@claude
가 포함되어 있는지 확인하세요 (/claude
가 아님).
매개변수 | 설명 | 필수 |
---|---|---|
prompt | Claude를 위한 지침 (텍스트 또는 슬래시 명령) | 아니오* |
claude_args | Claude Code에 전달되는 CLI 인수 | 아니오 |
anthropic_api_key | Anthropic API 키 | 예** |
github_token | API 액세스용 GitHub 토큰 | 아니오 |
trigger_phrase | 사용자 정의 트리거 구문 (기본값: “@claude”) | 아니오 |
use_bedrock | Anthropic API 대신 AWS Bedrock 사용 | 아니오 |
use_vertex | Anthropic API 대신 Google Vertex AI 사용 | 아니오 |
claude_args
매개변수는 모든 Claude Code CLI 인수를 허용합니다:
--max-turns
: 최대 대화 턴 수 (기본값: 10)--model
: 사용할 모델 (예: claude-sonnet-4-20250514
)--mcp-config
: MCP 구성 경로--allowed-tools
: 허용된 도구의 쉼표로 구분된 목록--debug
: 디버그 출력 활성화/install-github-app
명령이 권장 접근 방식이지만 다음과 같은 방법도 있습니다:
CLAUDE.md
파일에서 코딩 표준, 리뷰 기준, 프로젝트별 규칙을 정의하세요. Claude는 PR을 생성하고 요청에 응답할 때 이러한 가이드라인을 따릅니다. 자세한 내용은 Memory 문서를 확인하세요.prompt
매개변수를 사용하여 워크플로우별 지침을 제공하세요. 이를 통해 다양한 워크플로우나 작업에 대해 Claude의 동작을 사용자 정의할 수 있습니다.