PR과 이슈에서 Claude Code를 실행해 질문에 답하고, 변경 사항을 리뷰하며, 코드를 구현하는 GitHub Action입니다.
anthropics/claude-code-base-action
GitHub Actions 워크플로에서 Claude Code를 실행해 그 위에 맞춤형 자동화를 구축할 수 있는 GitHub Action입니다.
- 스타
- 1,015
- 포크
- 603
- 열린 이슈
- 14
- 마지막 커밋
- 8시간 전
어떤 프로젝트인가요?
Claude Code Base Action은 사용자가 지정한 프롬프트와 옵션으로 Claude Code를 설치하고 실행하는 가벼운 GitHub Actions 래퍼입니다. 별도의 claude-code-action이 제공하는 기본 @claude 멘션 방식 대신, Claude Code를 바탕으로 맞춤형 워크플로를 구축하는 데 초점을 둡니다.
프롬프트를 인라인으로 지정하거나 파일에서 불러올 수 있고, 허용할 도구, 턴 제한, 시스템 프롬프트, 모델 선택 등의 추가 CLI 인자를 전달할 수 있습니다. Claude 설정과 MCP 구성은 JSON으로 지정할 수 있습니다. 인증에는 Anthropic API 키, OAuth 토큰, workload identity federation을 사용하거나 Amazon Bedrock, Google Vertex AI, Microsoft Foundry에서 OIDC를 사용할 수 있습니다. 출력으로는 결론 상태, 실행 로그 파일, 이어서 실행할 수 있는 세션 ID가 제공되며, JSON 스키마를 지정하면 구조화된 출력도 받을 수 있습니다.
이 액션은 전달받은 작업 디렉터리와 프롬프트를 사용해 Claude Code를 실행하므로, 신뢰 여부를 판단하는 책임은 호출자에게 있습니다. 외부 이슈나 포크된 pull request처럼 신뢰할 수 없는 입력을 처리하는 워크플로에는 대신 기본 claude-code-action을 사용해야 한다고 프로젝트에서 안내합니다.
핵심 기능
- 01직접 입력한 프롬프트나 프롬프트 파일을 사용해 모든 GitHub Actions 워크플로에서 Claude Code를 실행합니다.
- 02허용할 도구, 최대 턴 수, 시스템 프롬프트 등의 사용자 지정 CLI 인자를 전달합니다.
- 03Anthropic API 키, OAuth 토큰, workload identity federation을 사용한 인증을 지원합니다.
- 04OIDC를 통해 Amazon Bedrock, Google Vertex AI, Microsoft Foundry에 접근할 수 있습니다.
- 05실행 상태, 로그 파일 경로, 이어서 실행할 수 있는 세션 ID와 선택적 구조화 출력을 제공합니다.
활용 사례
- pull request에 댓글을 남기는 맞춤형 예약 코드 리뷰 작업을 구축합니다.
- 저장소에서 리팩터링이나 의존성 업데이트 작업을 자동으로 실행합니다.
- CI 파이프라인의 일부로 보고서나 문서를 생성합니다.
- Bedrock이나 Vertex AI 같은 클라우드 제공업체의 인증 정보를 사용하는 워크플로에서 Claude Code를 호출합니다.
빠른 시작
- 1
프롬프트와 API 키 시크릿을 지정해 GitHub Actions 워크플로 파일에 이 액션을 추가하세요.
- 2
Anthropic API 키를 `ANTHROPIC_API_KEY` 저장소 시크릿으로 저장하고 워크플로에서 참조하세요.
사용 전 알아둘 점
- 이 프로젝트는 미러입니다. 이슈와 pull request는 메인 claude-code-action 저장소에 제출해야 합니다.
- 신뢰 경계를 적용하지 않으므로 fork PR과 같은 신뢰할 수 없는 입력에는 대신 메인 claude-code-action을 사용해야 합니다.
- 실행하려면 Anthropic API 키나 OAuth 토큰 또는 페더레이션 설정이 필요합니다.
토픽
자주 묻는 질문
- claude-code-base-action은(는) 무엇인가요?
- GitHub Actions 워크플로에서 Claude Code를 실행해 그 위에 맞춤형 자동화를 구축할 수 있는 GitHub Action입니다. Claude Code Base Action은 사용자가 지정한 프롬프트와 옵션으로 Claude Code를 설치하고 실행하는 가벼운 GitHub Actions 래퍼입니다. 별도의 claude-code-action이 제공하는 기본 @claude 멘션 방식 대신, Claude Code를 바탕으로 맞춤형 워크플로를 구축하는 데 초점을 둡니다.
- claude-code-base-action은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- claude-code-base-action은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- claude-code-base-action은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. claude-code-base-action의 마지막 커밋은 2026년 10월 22일입니다.
- claude-code-base-action은(는) 어디에 사용할 수 있나요?
- pull request에 댓글을 남기는 맞춤형 예약 코드 리뷰 작업을 구축합니다. 저장소에서 리팩터링이나 의존성 업데이트 작업을 자동으로 실행합니다. CI 파이프라인의 일부로 보고서나 문서를 생성합니다. Bedrock이나 Vertex AI 같은 클라우드 제공업체의 인증 정보를 사용하는 워크플로에서 Claude Code를 호출합니다.
- claude-code-base-action는 어떻게 설치하나요?
- 프롬프트와 API 키 시크릿을 지정해 GitHub Actions 워크플로 파일에 이 액션을 추가하세요. Anthropic API 키를 `ANTHROPIC_API_KEY` 저장소 시크릿으로 저장하고 워크플로에서 참조하세요.
- claude-code-base-action은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/anthropics/claude-code-base-action
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
CI/CD 워크플로에서 SSH로 원격 서버에 명령을 실행하는 GitHub Action
Markdown으로 AI 기반 저장소 자동화를 작성하고 GitHub Actions에서 안전하게 실행하는 GitHub CLI 확장 프로그램입니다.
AI 어시스턴트가 저장소를 읽고 이슈와 pull request를 관리하며 GitHub Actions를 다루도록 하는 GitHub 공식 MCP 서버입니다.
기존 CI 파이프라인에서 Terraform과 OpenTofu를 실행하고, pull request 댓글로 plan과 apply를 수행하는 오픈소스 IaC 오케스트레이션 도구입니다.
저장소에서 Gemini CLI를 실행해 pull request를 검토하고 이슈를 분류하며 @gemini-cli 요청을 처리하는 GitHub Action입니다.