anthropics/claude-code-base-action

해결하는 문제

이 프로젝트는 개발자가 Claude Code —— 에이전트 기반 CLI 도구 —— 를 GitHub Actions 워크플로우에 직접 통합할 수 있도록 해주는 GitHub Action을 제공합니다. CI/CD 파이프라인 내에서 Claude Code를 실행함으로써 PR 리뷰, 종속성 업데이트, 환경별 배포와 같은 복잡한 코드 작업을 자동화할 수 있습니다.

작동 방식

이 액션은 Claude Code CLI의 가벼운 래퍼입니다. CLI를 설치하고 제공된 입력을 사용하여 실행합니다. Anthropic API 키, OAuth 토큰, 그리고 Anthropic, Amazon Bedrock, Google Vertex AI와의 보안적인 키리스 인증을 위한 Workload Identity Federation (OIDC)를 포함한 여러 인증 방식을 지원합니다.

사용자는 prompt 또는 prompt_file를 통해 에이전트의 동작을 구성하고, CLI 인수(예: --allowedTools로 도구 접근 제한) 및 JSON 형식의 설정을 전달하여 모델, 환경 변수, 도구 권한을 제어할 수 있습니다.

대상 사용자

GitHub Actions 내에서 Claude Code를 기반으로 사용자 정의 자동화 워크플로우를 구축하고자 하는 개발자 및 DevOps 엔지니어. 특히 코드 수정 및 리뷰에 에이전트 기반 접근이 필요한 작업에 적합합니다.

주요 특징

• 유연한 인증: API 키, OAuth 토큰, OIDC 기반 Workload Identity Federation 지원.
• 클라우드 공급업체 통합: Amazon Bedrock 및 Google Vertex AI와 호환.
• 사용자 정의 도구: CLI 인수를 통해 특정 도구(Bash, Read, Glob 등)의 허용 또는 제한 가능.
• MCP 지원: 확장 기능을 제공하는 Model Context Protocol (MCP) 서버와의 통합.
• 구조화된 출력: --json-schema를 지원하며, structured_output 액션 출력을 통해 타입 지정된 자동화 출력을 제공합니다.