Repolode
anthropics

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. 1

    프롬프트와 API 키 시크릿을 지정해 GitHub Actions 워크플로 파일에 이 액션을 추가하세요.

  2. 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 통계는 매일 갱신됩니다.

관련 프로젝트