클로드 코드 루틴: AI 개발 워크플로우를 위한 자동화된 클라우드 작업

Claude Code 루틴은 프롬프트, 하나 이상의 저장소, 커넥터를 Anthropic이 관리하는 클라우드 인프라에서 실행되는 자동화된 작업으로 패키징한 저장 구성입니다. 이는 로컬 머신이 오프라인 상태일 때도 루틴이 계속 실행됨을 의미합니다.

루틴 작동 방식

각 루틴에는 여러 트리거 유형이 연결될 수 있습니다:

• 예약 트리거: 매시간, 매일 밤, 매주와 같은 반복 주기로 실행
• API 트리거: 베어러 토큰 인증을 사용한 루틴별 엔드포인트에 대한 HTTP POST를 통해 요청 시 실행
• GitHub 트리거: 풀 리퀘스트, 푸시, 이슈 또는 워크플로 실행을 포함한 저장소 이벤트에 자동으로 응답하여 실행

단일 루틴이 여러 트리거를 결합할 수 있습니다. 예를 들어, PR 리뷰 루틴은 매일 밤 실행되거나, API를 통해 배포 스크립트에서 트리거되거나, 모든 새 풀 리퀘스트에 반응할 수 있습니다.

실용적인 사용 사례

문서는 루틴 응용 프로그램의 몇 가지 구체적인 예를 제공합니다:

• 백로그 유지 관리: 예약 트리거가 커넥터를 통해 이슈 트래커에 대해 매일 밤 실행되어 새 이슈를 읽고, 레이블을 적용하며, 코드 영역을 기반으로 담당자를 할당하고, 요약을 Slack에 게시합니다
• 경고 분류: 모니터링 도구가 오류 임계값을 초과할 때 루틴의 API 엔드포인트를 호출하여 경고 본문을 텍스트로 전달합니다. 루틴은 스택 추적을 가져오고, 최근 커밋과 상관관계를 분석하며, 제안된 수정 사항이 포함된 초안 PR을 엽니다
• 맞춤형 코드 리뷰: GitHub 트리거가 pull_request.opened에서 팀별 리뷰 체크리스트를 적용하고, 보안/성능/스타일 문제에 대한 인라인 코멘트를 남기며, 요약 코멘트를 추가합니다
• 배포 검증: CD 파이프라인이 프로덕션 배포 후 루틴의 API 엔드포인트를 호출합니다. 루틴은 스모크 체크를 실행하고, 회귀에 대한 오류 로그를 스캔하며, 릴리스 채널에 진행/중지 결정을 게시합니다
• 문서 드리프트 감지: 주간 예약 트리거가 병합된 PR을 스캔하고, 변경된 API를 참조하는 문서를 플래그 지정하며, 문서 저장소에 대한 업데이트 PR을 엽니다
• 라이브러리 이식: GitHub 트리거가 pull_request.closed(병합된 PR로 필터링됨)에서 변경 사항을 다른 언어의 병렬 SDK로 이식하고 일치하는 PR을 엽니다

루틴 생성 및 관리

루틴은 Claude Code가 웹에서 활성화된 Pro, Max, Team 및 Enterprise 플랜에서 사용할 수 있습니다. claude.ai/code/routines에서 또는 CLI의 /schedule 명령으로 생성하고 관리할 수 있습니다.

생성 옵션에는 다음이 포함됩니다:

• claude.ai/code/routines의 웹 인터페이스
• 데스크톱 앱: "New task"를 클릭하고 "New remote task" 선택("New local task"는 대신 로컬 데스크톱 예약 작업을 생성함)
• /schedule 명령이 있는 CLI

생성 양식은 루틴의 프롬프트, 저장소, 환경, 커넥터 및 트리거를 구성합니다. 모든 생성 방법은 동일한 클라우드 계정에 기록하므로 CLI를 통해 생성된 루틴이 웹 인터페이스에 즉시 나타납니다.

현재 상태 및 제한 사항

루틴은 현재 연구 미리보기 단계에 있어 동작, 제한 및 API 표면이 변경될 수 있습니다. 루틴은 권한 모드 프롬프트 없이 전체 Claude Code 클라우드 세션으로 실행됩니다.