Claude Code Routines 공개

• 일정, API 호출, GitHub 이벤트에 따라 자동 실행되는 클라우드 기반 코드 자동화 기능으로, Anthropic 인프라에서 동작
• 루틴은 프롬프트, 저장소, 커넥터, 트리거로 구성되며, 노트북이 꺼져 있어도 실행 지속
• 트리거는 스케줄, API, GitHub 이벤트 세 가지 유형을 지원하며, 하나의 루틴에 복수 트리거 결합 가능
• 웹, CLI, 데스크톱 앱에서 생성 및 관리할 수 있고, GitHub·Slack·Linear 등 외부 서비스 커넥터를 통해 작업 수행
• Pro 이상 요금제에서 제공되며, 현재 리서치 프리뷰 단계로 기능과 API 사양은 변경될 수 있음

루틴으로 작업 자동화

• Claude Code 루틴은 일정, API 호출, GitHub 이벤트에 따라 자동 실행되는 저장된 코드 구성으로, Anthropic이 관리하는 클라우드 인프라에서 동작
• 루틴은 프롬프트, 저장소, 커넥터 세트로 구성되며, 노트북이 꺼져 있어도 실행 지속
• 트리거 유형은 스케줄, API, GitHub 이벤트 세 가지이며, 하나의 루틴에 여러 트리거를 결합 가능
• 루틴은 Pro, Max, Team, Enterprise 요금제에서 사용 가능하며, 웹 또는 CLI(/schedule)로 생성 및 관리
• 현재 리서치 프리뷰 단계로, 동작과 API 사양은 변경될 수 있음

루틴의 주요 활용 사례

• 백로그 유지관리: 일정 트리거가 매일 밤 이슈 트래커를 점검해 라벨 추가, 담당자 지정, Slack 요약 게시
• 알림 분류: 모니터링 도구가 오류 발생 시 API 트리거 호출, 루틴이 스택 트레이스 분석 후 수정 PR 생성
• 맞춤 코드 리뷰: GitHub 트리거가 PR 생성 시 실행되어 보안·성능·스타일 검토 코멘트 자동 추가
• 배포 검증: CD 파이프라인이 배포 후 API 트리거 호출, 루틴이 스모크 테스트와 로그 검사 수행
• 문서 동기화: 주간 스케줄 트리거로 병합된 PR을 스캔해 변경된 API 관련 문서 업데이트 PR 생성
• 라이브러리 포팅: PR 병합 시 GitHub 트리거가 다른 언어 SDK로 변경사항 포팅

루틴 생성 방법

• 루틴은 웹, 데스크톱 앱, CLI에서 생성 가능하며, 모든 인터페이스는 동일한 클라우드 계정에 연결
• 루틴 생성 시 설정 항목: 프롬프트, 저장소, 환경, 커넥터, 트리거
• 루틴은 자동 실행 세션으로, 권한 승인 없이 명령 실행 및 커넥터 호출 가능
• 루틴은 개인 계정 소유이며, 팀과 공유되지 않음. 실행 횟수는 계정의 일일 한도에 포함
• GitHub, Slack, Linear 등 커넥터를 통해 수행된 작업은 모두 사용자의 연결된 계정으로 표시

• 웹에서 생성

  • claude.ai/code/routines에서 New routine 클릭
  • 루틴 이름과 프롬프트 작성, 모델 선택
  • 저장소 선택: GitHub 저장소 추가, claude/ 접두 브랜치 사용
  • 환경 선택: 네트워크 접근, 환경 변수, 설치 스크립트 설정
  • 트리거 선택: 스케줄, GitHub 이벤트, API 중 선택 또는 조합
  • 커넥터 검토 후 필요 없는 항목 제거
  • Create 클릭 시 루틴 생성 및 즉시 실행 가능

• CLI에서 생성

  • /schedule 명령으로 대화형 생성 가능 (/schedule daily PR review at 9am)
  • CLI에서는 스케줄 트리거만 생성 가능, API·GitHub 트리거는 웹에서 추가
  • /schedule list, /schedule update, /schedule run으로 관리 가능

• 데스크톱 앱에서 생성

  • Schedule 페이지에서 New remote task 선택
  • 로컬 스케줄 작업과 루틴을 함께 표시

트리거 구성

• 루틴은 스케줄, API, GitHub 트리거 중 하나 이상을 가질 수 있음
• 트리거는 언제든 추가·삭제 가능

• 스케줄 트리거

  • 시간대에 맞춰 시간별, 일별, 주중, 주간 실행
  • 최소 실행 간격은 1시간
  • CLI에서 /schedule update로 cron 표현식 설정 가능

• API 트리거

  • 루틴별 HTTP 엔드포인트 제공, Bearer 토큰으로 인증
  • POST 요청 시 새 세션 생성 및 URL 반환
  • 요청 본문 text 필드로 실행 맥락 전달 가능
  • 토큰은 한 번만 표시되며, 재발급 또는 폐기 가능
  • /fire 엔드포인트는 experimental-cc-routine-2026-04-01 베타 헤더 필요

• GitHub 트리거

  • 연결된 저장소의 이벤트 발생 시 자동 실행
  • Claude GitHub App 설치 필요
  • 웹 UI에서만 설정 가능
  • 이벤트 초과 시 시간당 제한 적용

  • 지원 이벤트

    • Pull request, Push, Release, Issues, Discussion 등 20여 가지 GitHub 이벤트 지원
    • 각 이벤트는 세부 액션(opened, closed, edited 등)에 반응 가능

  • PR 필터링

    • 작성자, 제목, 본문, 브랜치, 라벨, 병합 여부, 포크 여부 등으로 필터링
    • 예: is draft=false → 리뷰 준비된 PR만 실행, labels include needs-backport → 특정 라벨 시만 트리거

  • 세션 매핑

    • 각 이벤트는 독립 세션으로 실행, 이벤트 간 세션 재사용 불가

루틴 관리

• 루틴 목록에서 클릭 시 상세 페이지 표시
• 저장소, 커넥터, 프롬프트, 트리거, 실행 이력 확인 가능

• 실행 보기 및 상호작용

  • 각 실행은 세션 형태로 열리며, 변경사항 검토·PR 생성·대화 지속 가능
  • 세션 메뉴에서 이름 변경, 보관, 삭제 가능

• 편집 및 제어

  • Run now로 즉시 실행
  • Repeats 토글로 일시 중지/재개
  • Edit routine에서 이름, 프롬프트, 저장소, 환경, 트리거 수정
  • 삭제 시 과거 세션은 유지

저장소 및 브랜치 권한

• 루틴은 GitHub 인증 필요, /web-setup으로 연결 설정
• 기본적으로 claude/ 접두 브랜치에만 푸시 가능
• Allow unrestricted branch pushes 옵션으로 제한 해제 가능

커넥터

• 루틴은 MCP 커넥터를 통해 Slack, Linear, Google Drive 등 외부 서비스 접근
• 기본적으로 모든 연결된 커넥터 포함, 필요 없는 항목 제거 권장
• Settings > Connectors 또는 /schedule update로 관리 가능

환경 설정

• 각 루틴은 클라우드 환경에서 실행
• 환경은 네트워크 접근, 환경 변수, 설치 스크립트 제어
• API 접근, 의존성 설치, 네트워크 제한 등을 사전 구성 가능

사용량 및 제한

• 루틴 실행은 일반 세션과 동일하게 구독 사용량 차감
• 계정당 일일 실행 한도 존재
• 초과 사용량 허용 시 과금형 초과 실행 가능
• 사용량은 claude.ai/settings/usage에서 확인

관련 자료

• /loop 및 세션 내 스케줄링: 로컬 CLI 작업 예약
• Desktop scheduled tasks: 로컬 환경에서 실행
• Cloud environment: 클라우드 런타임 구성
• MCP connectors: 외부 서비스 연동
• GitHub Actions: CI 파이프라인에서 Claude 실행