claude-github-actions

Claude GitHub Actions

anthropics/claude-code-action@v1을 사용하여 GitHub Actions에서 Claude Code 자동화 워크플로우를 설계하고 구축하는 skill.

개요

GitHub Actions runner(ubuntu-latest) 위에서 Claude Code를 실행하여 정기 자동화, 웹 스크래핑, 메일 발송, 코드 생성 등 다양한 작업을 수행한다. MCP 서버(sequential-thinking, fetch, chrome-devtools)를 통합하여 Claude의 도구 사용 능력을 확장하고, --dangerously-skip-permissions 모드로 격리 환경에서 안정적으로 실행한다.

핵심 아키텍처

트리거 유형

트리거	용도	예시
schedule (cron)	정기 자동화	매일 뉴스 수집, 주간 리포트
workflow_dispatch	수동 실행	테스트, 일회성 작업
issue_comment	@claude 멘션	PR 리뷰, Issue 응답

필수 permissions

permissions:
  contents: write      # 파일 수정 및 push
  id-token: write      # Claude Code Action 인증
  # pull-requests: write  # PR 작업 시 추가
  # issues: write         # Issue 작업 시 추가

github_token 필수 규칙

schedule 트리거 사용 시 반드시 명시한다:

- uses: anthropics/claude-code-action@v1
  with:
    github_token: ${{ secrets.GITHUB_TOKEN }}  # 필수! 없으면 "User does not have write access" 오류
    # 인증 방식 택 1:
    claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}  # OAuth 방식
    # anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}            # API 키 방식

MCP 서버 설정

워크플로우 step에서 /tmp/mcp-config.json에 인라인 JSON을 생성한다:

- name: Create MCP Config
  run: |
    cat > /tmp/mcp-config.json << 'EOF'
    {
      "mcpServers": {
        "sequential-thinking": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
        },
        "fetch": {
          "command": "npx",
          "args": ["-y", "@anthropics/mcp-server-fetch"]
        }
      }
    }
    EOF

사용 가능한 MCP 서버 전체 목록은 references/mcp_servers.md 참조.

MCP 서버는 npx로 자동 설치되므로 별도 설치 step이 불필요하다.

Chrome DevTools MCP 패턴

GitHub Actions에서 headless Chrome을 통해 웹 페이지에 접근하고 데이터를 추출한다.

상세 설정 및 도구 목록은 references/chrome_devtools_pattern.md 참조.

핵심 요약

• ubuntu-latest에 Chrome 기본 설치됨
• MCP 설정: "chrome-devtools-mcp@latest", "--headless"
• 주요 도구: navigate_page, wait_for, take_screenshot, evaluate_script
• CAPTCHA 회피: GitHub Actions IP는 Google/DuckDuckGo 등에서 봇 탐지됨. 검색엔진 대신 대상 사이트에 직접 접근한다.