공식 문서 · 빌드 심화 11

자동화 — Actions·스케줄·헤드리스

PR마다 자동 리뷰, 매일 밤 점검 — 반복을 없앤다.

성격 자동 실행방식 Actions · 스케줄 · CI트리거 이벤트·시간
자동화반복 없애기

PR마다 리뷰, 매일 밤 점검 — 자동으로

Claude를 GitHub Actions·클라우드 스케줄·CI 스크립트·훅으로 자동 실행하면, 반복 작업을 사람이 매번 시키지 않아도 된다.

한 문장으로"언제(트리거) → 무엇을(지시문)"만 정해두면 Claude가 알아서 실행한다.

네 가지 자동화

Actions
GitHub Actions
PR 코멘트 @claude 에 자동 응답
·
Routines
클라우드 스케줄
매일/매주 정해진 시간에 실행
·
Headless
CI 스크립트
claude -p 로 한 번 실행·결과 반환
·
Hooks
이벤트
편집·커밋 시 자동 실행

① GitHub Actions — PR 자동 리뷰

가장 쉬운 설치는 세션에서 /install-github-app. 이후 PR 코멘트에 @claude 를 멘션하면 워크플로가 자동 실행돼 결과를 코멘트로 남긴다.

/install-github-app

② Routines — 클라우드 스케줄

내 컴퓨터가 꺼져 있어도 도는 예약 실행. CLI에서 만들거나 웹(claude.ai/code/routines)에서 관리한다.

/schedule 매일 아침 9시에 needs-review 라벨 PR을 리뷰하고 요약을 남겨줘

③ Headless — CI·배치

대화 없이 한 번 실행하고 결과(JSON)를 돌려준다. 권한을 자동 승인하므로 신뢰된 환경에서만.

claude -p "린트 오류를 모두 고쳐줘" --allowedTools "Bash,Edit"
초보자 주의Headless는 권한을 자동 승인하니 신뢰된 CI에서만 쓴다. Routines(클라우드 스케줄)는 Pro 이상·일일 실행 제한이 있다. 스케줄은 로컬(데스크톱)과 클라우드(Routines) 두 종류가 있다.
Windows / 참고GitHub Actions는 러너에서 실행되므로 로컬 OS와 무관. 편집 후 자동 검사는 으로 — 위 메뉴 심화 → 훅 참고.
출처: code.claude.com/docs/en/{github-actions, headless, routines}
클로드코드 시작하기공식 문서 · 11 자동화