Routines는 무엇인가요?

Claude Code의 자동화 워크플로 기능으로, 한 번 설정해두면 스케줄·API 호출·GitHub 이벤트에 반응해 자동으로 실행됩니다. Anthropic 클라우드 인프라에서 동작하므로 노트북을 닫아도 코드 리뷰·버그 수정·배포 검증·문서 업데이트 같은 작업을 자율 실행합니다.

어떤 트리거 방식이 있나요?

Schedule(시간/일/주 단위 반복), API(HTTP POST로 즉시 실행), GitHub(PR·푸시·이슈 등 17개 이벤트) 세 가지가 있고, 한 루틴에 여러 트리거를 조합할 수 있습니다.

어떻게 생성하나요?

웹([claude.ai/code/routines](https://claude.ai/code/routines))에서 생성·관리하거나, CLI에서 `/schedule` 명령으로 대화형 생성(스케줄 트리거만 지원), 또는 Claude Desktop의 New task → New remote task로 만들 수 있습니다.

사용 한도는 어떻게 되나요?

일일 루틴 실행 횟수 한도가 적용됩니다 — Pro 5회, Max 15회, Team/Enterprise 25회. 한도 초과 시 extra usage가 활성화된 조직은 종량제로 계속 실행 가능합니다.

팀과 공유되나요?

루틴은 개인 계정에 귀속되며 팀원과 공유되지 않습니다. 루틴이 수행한 커밋·PR·Slack 메시지 등은 본인 계정으로 표시됩니다.

공식 자료는 어디서 볼 수 있나요?

발표 블로그: claude.com/blog/introducing-routines-in-claude-code, 공식 문서: code.claude.com/docs/en/routines

Routines — Claude Code 자동화 워크플로우

핵심 요약

Claude Code에 Routines 기능이 추가되었습니다. 한 번 설정해두면 스케줄, API 호출, GitHub 이벤트에 반응하여 자동으로 실행되는 자율 워크플로우입니다. Anthropic 클라우드 인프라에서 실행되므로 노트북을 닫아도 동작하며, 코드 리뷰, 버그 수정, 배포 검증, 문서 업데이트 등 반복적인 개발 작업을 자동화할 수 있습니다.

현재 Research Preview 단계로, 동작 방식과 제한 사항이 변경될 수 있습니다.

주요 특징

3가지 트리거 방식

하나의 루틴에 여러 트리거를 조합할 수 있습니다. 예를 들어 PR 리뷰 루틴을 매일 밤 자동 실행하면서, 동시에 새 PR이 열릴 때마다 GitHub 이벤트로도 트리거할 수 있습니다.

트리거	설명	예시
Schedule	시간/일/주 단위 반복 실행	매일 새벽 2시에 Linear 상위 버그 수정 시도 → 드래프트 PR 생성
API	HTTP POST로 즉시 실행	배포 파이프라인 완료 후 스모크 테스트 자동 실행
GitHub	PR, 푸시, 이슈 등 리포 이벤트 반응	PR 열릴 때 보안·성능·스타일 체크리스트 자동 리뷰

클라우드 자율 실행

Anthropic 관리 클라우드 인프라에서 실행됩니다. 로컬 머신이 꺼져 있어도 동작하며, 셸 명령 실행, 스킬 사용, MCP 커넥터(Slack, Linear, Google Drive 등) 호출이 모두 가능합니다. 각 실행은 독립 세션으로 생성되어 결과를 브라우저에서 확인하고 이어서 대화할 수 있습니다.
GitHub 이벤트 세분화

PR, 푸시, 이슈, 릴리스, 워크플로우 실행 등 17개 이벤트 카테고리를 지원합니다. PR 트리거에는 작성자, 제목, 브랜치, 라벨, 드래프트 여부 등으로 필터링할 수 있어, 특정 조건의 PR에만 반응하도록 설정할 수 있습니다.
API 트리거 연동

각 루틴은 고유한 HTTP 엔드포인트와 Bearer 토큰을 발급받습니다. 모니터링 시스템, CI/CD 파이프라인, 내부 도구에서 HTTP 요청으로 루틴을 실행하고, 요청 본문의 text 필드로 알림 내용이나 로그를 전달할 수 있습니다.

생성 방법

방법	설명
웹	claude.ai/code/routines에서 생성·관리
CLI	`/schedule` 명령으로 대화형 생성 (스케줄 트리거만 지원)
Desktop	New task → New remote task

CLI에서 생성한 루틴도 웹에서 바로 확인·편집할 수 있습니다. API, GitHub 트리거 추가는 웹에서만 가능합니다.

활용 시나리오

백로그 정리 — 매일 밤 이슈 트래커를 스캔하여 라벨 지정, 담당자 배정, Slack 요약 발송
알림 대응 — 모니터링 알림 발생 시 스택 트레이스를 분석하고 수정 PR 자동 생성
코드 리뷰 — PR 열릴 때 팀 전용 체크리스트로 보안·성능·스타일 인라인 코멘트 자동 작성
배포 검증 — 프로덕션 배포 후 스모크 테스트 실행, 에러 로그 스캔, go/no-go 판단
문서 동기화 — 주간 단위로 머지된 PR을 스캔하여 변경된 API의 문서 업데이트 PR 생성
라이브러리 포팅 — SDK 리포에 PR이 머지되면 다른 언어 SDK에 자동으로 포팅 PR 생성

사용 한도

루틴은 일반 세션과 동일하게 구독 사용량을 소비합니다. 일일 실행 횟수 제한이 별도로 적용됩니다.

플랜	일일 루틴 실행
Pro	5회
Max	15회
Team / Enterprise	25회

한도 초과 시 extra usage가 활성화된 조직은 종량제로 계속 실행할 수 있고, 그렇지 않으면 다음 날까지 대기해야 합니다.

알아두면 좋은 점

루틴은 개인 계정에 귀속됩니다. 팀원과 공유되지 않으며, 루틴이 수행한 커밋·PR·Slack 메시지 등은 본인의 계정으로 표시됩니다.
기본적으로 claude/ 접두사 브랜치에만 푸시 가능합니다. 다른 브랜치에 푸시하려면 루틴 설정에서 “Allow unrestricted branch pushes”를 활성화해야 합니다.
자세한 설정 방법은 공식 문서를 참고하세요.