Claude Code Routines – 스케줄·API·GitHub 이벤트로 작업을 자동화하는 루틴 기능

핵심 개념
트리거 종류
스케줄 트리거
API 트리거
GitHub 트리거
대표 use case
누가 쓰면 좋은가
제한 사항
라이선스 및 가용성
관련 토픽

Claude Code의 루틴(Routines)은 프롬프트·저장소·커넥터를 묶어 자동으로 반복 실행할 수 있는 작업 단위다. Anthropic의 클라우드 인프라에서 실행되므로 노트북이 꺼져 있어도 동작하며, 스케줄·API 호출·GitHub 이벤트 세 가지 방식으로 트리거할 수 있다. 복잡한 CI/자동화 파이프라인 없이도 코드 리뷰·백로그 정리·배포 검증 등 반복적인 개발 작업을 AI에게 완전히 위임하려는 팀과 개인에게 적합하다.

핵심 개념

개념	설명
루틴	프롬프트 + 저장소 + 커넥터의 묶음. 한 번 설정하면 트리거마다 자동 실행
트리거	루틴을 실행시키는 조건. 스케줄·API·GitHub 이벤트를 조합 가능
세션	트리거가 발생할 때마다 독립적으로 생성되는 Claude Code 실행 환경
커넥터	Slack·Linear·Google Drive 등 외부 서비스 연동 (MCP 기반)

루틴 세션은 완전 자율 모드로 실행된다. 권한 확인 팝업이나 승인 절차 없이 셸 명령 실행, 커넥터 호출, 브랜치 생성이 모두 가능하다. 실행 결과는 claude/ 접두사가 붙은 브랜치에 푸시된다.

트리거 종류

스케줄 트리거

매시간·매일·평일·매주 등 반복 주기로 실행. /schedule CLI 명령으로 생성하거나 웹에서 설정한다. 커스텀 주기는 cron 표현식으로 지정 가능 (최소 1시간).

API 트리거

루틴별 전용 HTTP 엔드포인트를 제공. Bearer 토큰으로 인증 후 POST 요청으로 즉시 실행할 수 있다. text 필드에 알림 본문·스택 트레이스 등 컨텍스트를 전달 가능.

curl -X POST https://api.anthropic.com/v1/claude_code/routines/<trigger_id>/fire \
  -H "Authorization: Bearer <token>" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "배포 완료. 스모크 테스트 실행 요청."}'

주의: experimental-cc-routine-2026-04-01 베타 헤더 하에 제공되며, 리서치 프리뷰 기간 중 변경될 수 있다.

GitHub 트리거

PR 오픈·푸시·이슈 생성 등 GitHub 이벤트 발생 시 자동 실행. PR 필터(작성자, 브랜치, 레이블, 드래프트 여부 등)로 실행 조건을 세밀하게 설정할 수 있다. 이벤트마다 독립적인 세션이 생성된다.

대표 use case

use case	트리거	대상
백로그 자동 정리	스케줄 (매일 밤)	이슈 트래커 연동 팀
알림 자동 트리아지	API	모니터링 시스템 운영자
맞춤형 코드 리뷰	GitHub (PR 오픈)	코드 품질 기준이 있는 팀
배포 후 검증	API (CD 파이프라인)	DevOps/SRE
문서 드리프트 탐지	스케줄 (매주)	문서 관리자
다중 SDK 동기화	GitHub (PR 머지)	여러 언어 SDK 유지보수 팀

누가 쓰면 좋은가

개인 개발자: 반복적인 코드 리뷰·문서 업데이트를 자동화하고 싶은 경우
소규모 팀: 별도 CI 봇을 운영하기 어렵고 GitHub Actions보다 자연어 프롬프트로 자동화를 설정하고 싶은 경우
DevOps/SRE: 알림 시스템과 Claude를 연결해 1차 트리아지를 자동화하려는 경우

Pro·Max·Team·Enterprise 플랜에서 Claude Code on the web이 활성화된 경우에 사용 가능.

제한 사항

루틴은 개인 계정 소유. 팀원과 공유되지 않음
GitHub 트리거: 시간당 이벤트 처리 상한 있음 (초과 시 드롭)
스케줄 최소 주기: 1시간
기본적으로 claude/ 접두사 브랜치에만 푸시 가능 (별도 설정으로 변경 가능)
API 트리거 토큰은 생성 시 1회만 표시됨

라이선스 및 가용성

Anthropic의 독점 서비스로 오픈소스가 아니다. Pro·Max·Team·Enterprise 플랜에서 Claude Code on the web이 활성화된 경우에 사용 가능하다.

AI Sparkup