Claude Code Routines 완벽 가이드: 스케줄, API, GitHub 트리거로 개발 자동화하기

2026년 4월 14일, Anthropic이 Claude Code에 Routines 기능을 Research Preview로 출시했습니다. 한마디로 요약하면, Claude Code 설정을 한 번 구성하면 노트북을 닫아도 Anthropic 클라우드에서 자동으로 실행되는 기능입니다.

크론잡을 직접 관리하거나, GitHub Actions 워크플로우를 복잡하게 구성하거나, Zapier로 우회하던 개발 자동화가 Claude Code 하나로 통합될 수 있는 가능성이 열렸습니다.

Routines란 무엇인가

Routine은 저장된 Claude Code 구성입니다. 프롬프트, 하나 이상의 GitHub 리포지토리, MCP 커넥터 세트를 한 번 패키징하면, 트리거 조건에 따라 Anthropic 관리형 클라우드 인프라에서 자동으로 실행됩니다.

핵심은 3가지 트리거 유형을 지원한다는 점입니다:

하나의 루틴에 여러 트리거를 동시에 붙일 수 있습니다. 예를 들어 PR 리뷰 루틴이 매일 밤 스케줄로 실행되면서, 동시에 새 PR이 열릴 때마다 GitHub 트리거로도 실행되는 식입니다.

3가지 트리거 상세 분석

1. Scheduled 트리거: 관리형 크론잡

스케줄 트리거는 가장 직관적입니다. 사전 설정(매시간, 매일, 평일, 매주) 중 하나를 고르면 됩니다.

주요 특징:

• 로컬 타임존 기준으로 동작 (시간대 이동해도 현지 시간 유지)
• 실행 시간에 약간의 스태거(분산) 적용
• 최소 간격 1시간 (커스텀 크론 표현식도 지원, CLI에서 /schedule update로 설정)

활용 사례:

• 매일 밤 이슈 트래커에서 새 이슈를 읽고, 라벨을 붙이고, 담당자를 배정하고, Slack에 요약 전송
• 매주 병합된 PR을 스캔하여 변경된 API 관련 문서 업데이트 PR 생성
• 매일 의존성 취약점 스캔 실행

2. API 트리거: 인프라 빌딩 블록

API 트리거가 Routines를 단순 크론잡에서 인프라 수준의 자동화 도구로 끌어올립니다.

루틴마다 전용 HTTPS 엔드포인트가 생기고, Bearer 토큰으로 인증된 POST 요청을 보내면 새 세션이 시작됩니다.

curl -X POST https://api.anthropic.com/v1/claude_code/routines/{trigger_id}/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod."}'

응답으로 세션 ID와 URL이 반환되어 실시간으로 진행 상황을 확인할 수 있습니다.

활용 사례:

• Sentry/Datadog 알림 → 자동으로 스택 트레이스 분석 + 수정 PR 생성
• CD 파이프라인 배포 후 → 스모크 테스트 + 에러 로그 스캔 + go/no-go 판단
• 내부 도구에서 버튼 하나로 Claude에게 작업 위임

3. GitHub 트리거: 코드가 일어나는 곳에서 자동 반응

GitHub 트리거는 리포지토리 이벤트에 자동으로 반응합니다.

지원 이벤트:

• Pull Request: opened, closed, assigned, labeled, synchronized 등
• Release: created, published, edited, deleted

PR 필터링 옵션:

연산자도 다양합니다: equals, contains, starts with, is one of, matches regex 등.

활용 사례:

• auth-provider 모듈을 건드리는 PR만 보안 리뷰 자동 실행
• 포크에서 온 모든 PR에 보안 + 스타일 트리아지 적용
• needs-backport 라벨이 붙은 PR만 다른 브랜치로 포팅

주의: Claude GitHub App 설치가 별도로 필요합니다. /web-setup과는 다릅니다.

루틴 생성 방법

웹 UI (가장 완전한 기능)

1. claude.ai/code/routines에서 "New routine" 클릭
2. 이름과 프롬프트 작성 (모델 선택 가능)
3. GitHub 리포지토리 추가
4. 환경(Environment) 선택 — 네트워크 접근, 환경변수, 셋업 스크립트
5. 트리거 설정 (스케줄/API/GitHub 중 선택)
6. MCP 커넥터 검토 (Slack, Linear, Drive 등)
7. "Create" 클릭

CLI

/schedule daily PR review at 9am

CLI에서는 스케줄 트리거만 생성 가능합니다. API/GitHub 트리거는 웹에서 추가해야 합니다.

Desktop 앱

Schedule 페이지 → "New task" → "New remote task" 선택. "New local task"는 로컬 스케줄 태스크로, Routine이 아닙니다.

Routines vs Desktop Scheduled Tasks vs /loop

브랜치 권한과 보안

기본적으로 루틴은 claude/ 프리픽스 브랜치에만 push할 수 있습니다. 이는 보호된 브랜치나 장기 브랜치를 실수로 수정하는 것을 방지합니다.

"Allow unrestricted branch pushes" 옵션을 켜면 이 제한을 해제할 수 있지만, 주의가 필요합니다. 루틴이 열어놓은 나쁜 PR은 실제 PR이고, 롤백 기능이 없습니다.

요금 및 제한사항

• 구독 사용량과 동일하게 차감됩니다
• 일일 루틴 실행 횟수에 별도 캡이 있습니다
• GitHub 이벤트는 시간당 제한이 있습니다 (고트래픽 리포는 이벤트 드롭 가능)
• API는 experimental-cc-routine-2026-04-01 베타 헤더 필요
• Pro, Max, Team, Enterprise 플랜 지원

Extra Usage가 활성화되면 한도 초과 시 계량형 과금으로 계속 실행할 수 있습니다.

실전 활용 시작 팁

1. 단순한 스케줄 루틴부터 시작하세요 — "매일 밤 미해결 이슈 요약"처럼 리스크가 낮은 것부터
2. 프롬프트를 자급자족 형태로 작성하세요 — 루틴은 자율 실행이므로, 성공 조건과 할 일을 명확히 기술
3. 브랜치 push 제한을 유지하세요 — 특별한 이유 없이 unrestricted로 설정하지 마세요
4. API 트리거는 기존 도구와 연동하세요 — Datadog, Sentry, GitHub Actions의 step으로 호출
5. 사용량을 모니터링하세요 — claude.ai/settings/usage에서 남은 할당량 확인

마무리

Claude Code Routines는 AI 코딩 어시스턴트가 "도구"에서 "인프라"로 진화하는 중요한 전환점입니다.

크론잡 관리, Webhook 설정, CI/CD 파이프라인 구성 없이도 프롬프트 하나와 트리거 설정만으로 개발 워크플로우의 반복적인 부분을 자동화할 수 있습니다.

아직 Research Preview라 거친 부분이 있지만, 방향은 명확합니다. 노트북을 닫아도 Claude는 일하고 있다 — 이것이 Routines의 핵심 가치입니다.

시작하려면 claude.ai/code/routines를 방문하거나, CLI에서 /schedule을 입력하세요.

참고 자료:

• Anthropic 공식 블로그 — Introducing routines in Claude Code
• Claude Code Docs — Automate work with routines
• Claude Code Docs — Run prompts on a schedule