메인 콘텐츠로 건너뛰기
루틴은 연구 미리보기 상태입니다. 동작, 제한 사항 및 API 표면이 변경될 수 있습니다.
루틴은 저장된 Claude Code 구성입니다. 프롬프트, 하나 이상의 저장소, 그리고 커넥터 세트를 한 번에 패키징하여 자동으로 실행합니다. 루틴은 Anthropic 관리 클라우드 인프라에서 실행되므로 노트북을 닫아도 계속 작동합니다. 각 루틴에는 하나 이상의 트리거를 연결할 수 있습니다.
  • 예약됨: 시간별, 야간, 또는 주간과 같은 반복 주기로 실행
  • API: HTTP POST를 루틴별 엔드포인트로 보내 베어러 토큰으로 요청 시 트리거
  • GitHub: 풀 요청 또는 릴리스와 같은 저장소 이벤트에 자동으로 반응하여 실행
단일 루틴은 트리거를 결합할 수 있습니다. 예를 들어 PR 검토 루틴은 야간에 실행되고, 배포 스크립트에서 트리거되며, 모든 새로운 PR에도 반응할 수 있습니다. 루틴은 웹에서 Claude Code가 활성화된 Pro, Max, Team 및 Enterprise 플랜에서 사용할 수 있습니다. claude.ai/code/routines에서 생성 및 관리하거나 CLI에서 /schedule로 관리하세요. 이 페이지에서는 루틴 생성, 각 트리거 유형 구성, 실행 관리 및 사용 제한 적용 방법을 다룹니다.

사용 사례 예시

각 예시는 트리거 유형을 루틴이 적합한 작업 종류와 짝지어줍니다. 무인 상태에서 반복 가능하며 명확한 결과와 연결된 작업입니다. 백로그 유지 관리. 일정 트리거가 커넥터를 통해 이슈 추적기에 대해 매주 평일 밤에 실행됩니다. 루틴은 마지막 실행 이후 열린 이슈를 읽고, 레이블을 적용하고, 참조된 코드 영역을 기반으로 소유자를 할당하고, Slack에 요약을 게시하여 팀이 정리된 큐로 하루를 시작할 수 있도록 합니다. 경고 분류. 모니터링 도구가 오류 임계값을 초과할 때 루틴의 API 엔드포인트를 호출하고 경고 본문을 text로 전달합니다. 루틴은 스택 추적을 가져오고, 저장소의 최근 커밋과 상관관계를 지으며, 제안된 수정 사항과 경고로 돌아가는 링크가 있는 초안 풀 요청을 엽니다. 온콜 담당자는 빈 터미널에서 시작하는 대신 PR을 검토합니다. 맞춤형 코드 검토. GitHub 트리거가 pull_request.opened에서 실행됩니다. 루틴은 팀의 자체 검토 체크리스트를 적용하고, 보안, 성능 및 스타일 문제에 대해 인라인 댓글을 남기고, 요약 댓글을 추가하여 인간 검토자가 기계적 검사 대신 설계에 집중할 수 있도록 합니다. 배포 검증. CD 파이프라인이 각 프로덕션 배포 후 루틴의 API 엔드포인트를 호출합니다. 루틴은 새 빌드에 대해 스모크 테스트를 실행하고, 오류 로그에서 회귀를 스캔하고, 배포 윈도우가 닫히기 전에 릴리스 채널에 진행 또는 진행 불가를 게시합니다. 문서 드리프트. 일정 트리거가 매주 실행됩니다. 루틴은 마지막 실행 이후 병합된 PR을 스캔하고, 변경된 API를 참조하는 문서에 플래그를 지정하고, 편집자가 검토할 수 있도록 문서 저장소에 대해 업데이트 PR을 엽니다. 라이브러리 포트. GitHub 트리거가 한 SDK 저장소의 병합된 PR로 필터링된 pull_request.closed에서 실행됩니다. 루틴은 변경 사항을 다른 언어의 병렬 SDK로 포트하고 일치하는 PR을 열어 두 라이브러리를 동기화 상태로 유지하며 인간이 각 변경 사항을 다시 구현할 필요가 없습니다. 아래 섹션에서는 루틴을 생성하고 이러한 각 트리거 유형을 구성하는 방법을 설명합니다.

루틴 생성

웹, 데스크톱 앱 또는 CLI에서 루틴을 생성하세요. 세 가지 표면 모두 동일한 클라우드 계정에 쓰므로 CLI에서 생성한 루틴이 즉시 claude.ai/code/routines에 표시됩니다. 데스크톱 앱에서 새 작업을 클릭하고 새 원격 작업을 선택하세요. 새 로컬 작업을 선택하면 로컬 데스크톱 예약 작업이 생성되며, 이는 머신에서 실행되고 루틴이 아닙니다. 생성 양식은 루틴의 프롬프트, 저장소, 환경, 커넥터 및 트리거를 설정합니다. 루틴은 완전한 Claude Code 클라우드 세션으로 자율적으로 실행됩니다. 권한 모드 선택기나 실행 중 승인 프롬프트가 없습니다. 세션은 셸 명령을 실행하고, 복제된 저장소에 커밋된 스킬을 사용하고, 포함된 모든 커넥터를 호출할 수 있습니다. 루틴이 도달할 수 있는 것은 선택한 저장소와 해당 브랜치 푸시 설정, 환경의 네트워크 액세스 및 변수, 그리고 포함된 커넥터에 의해 결정됩니다. 루틴이 실제로 필요한 것으로 각각을 범위 지정하세요. 루틴은 개별 claude.ai 계정에 속합니다. 팀원과 공유되지 않으며 계정의 일일 실행 허용량에 대해 계산됩니다. 루틴이 연결된 GitHub 신원 또는 커넥터를 통해 수행하는 모든 작업은 사용자로 표시됩니다. 커밋 및 풀 요청은 GitHub 사용자를 전달하고, Slack 메시지, Linear 티켓 또는 기타 커넥터 작업은 해당 서비스에 대해 연결된 계정을 사용합니다.

웹에서 생성

1

생성 양식 열기

claude.ai/code/routines를 방문하고 새 루틴을 클릭하세요.
2

루틴 이름 지정 및 프롬프트 작성

루틴에 설명적인 이름을 지정하고 Claude가 매번 실행할 프롬프트를 작성하세요. 프롬프트가 가장 중요한 부분입니다. 루틴이 자율적으로 실행되므로 프롬프트는 자체 포함되어야 하며 수행할 작업과 성공이 무엇인지에 대해 명시적이어야 합니다.프롬프트 입력에는 모델 선택기가 포함됩니다. Claude는 모든 실행에서 선택된 모델을 사용합니다.
3

저장소 선택

Claude가 작업할 하나 이상의 GitHub 저장소를 추가하세요. 각 저장소는 실행 시작 시 기본 브랜치에서 시작하여 복제됩니다. Claude는 변경 사항에 대해 claude/ 접두사가 붙은 브랜치를 생성합니다. 모든 브랜치로의 푸시를 허용하려면 해당 저장소에 대해 제한 없는 브랜치 푸시 허용을 활성화하세요.
4

환경 선택

루틴에 대해 클라우드 환경을 선택하세요. 환경은 클라우드 세션이 액세스할 수 있는 것을 제어합니다.
  • 네트워크 액세스: 각 실행 중에 사용 가능한 인터넷 액세스 수준 설정
  • 환경 변수: Claude가 사용할 수 있는 API 키, 토큰 또는 기타 비밀 제공
  • 설정 스크립트: 루틴이 필요한 종속성 및 도구를 설치합니다. 결과는 캐시됩니다. 따라서 스크립트는 모든 세션에서 다시 실행되지 않습니다.
기본 환경이 제공됩니다. 사용자 정의 환경을 사용하려면 루틴을 생성하기 전에 하나를 생성하세요.
5

트리거 선택

트리거 선택 아래에서 루틴이 시작되는 방식을 선택하세요. 하나의 트리거 유형을 선택하거나 여러 개를 결합할 수 있습니다.
사전 설정된 빈도를 선택하세요. 시간별, 일일, 평일 또는 주간. 시간대 처리, 엇갈림 및 사용자 정의 cron 간격은 일정 트리거 추가를 참조하세요.
6

커넥터 검토

연결된 모든 MCP 커넥터는 기본적으로 포함됩니다. 루틴이 필요하지 않은 것을 제거하세요. 커넥터는 Claude에게 각 실행 중에 Slack, Linear 또는 Google Drive와 같은 외부 서비스에 액세스할 수 있게 합니다.
7

루틴 생성

생성을 클릭하세요. 루틴이 목록에 나타나고 다음 번에 트리거 중 하나가 일치할 때 실행됩니다. 즉시 실행을 시작하려면 루틴의 세부 정보 페이지에서 지금 실행을 클릭하세요.각 실행은 다른 세션과 함께 새 세션을 생성하므로 Claude가 수행한 작업을 확인하고, 변경 사항을 검토하고, 풀 요청을 생성할 수 있습니다.

CLI에서 생성

모든 세션에서 /schedule을 실행하여 예약된 루틴을 대화식으로 생성하세요. /schedule daily PR review at 9am과 같이 설명을 직접 전달할 수도 있습니다. Claude는 웹 양식이 수집하는 동일한 정보를 안내한 다음 루틴을 계정에 저장합니다. CLI의 /schedule은 예약된 루틴만 생성합니다. API 또는 GitHub 트리거를 추가하려면 claude.ai/code/routines의 웹에서 루틴을 편집하세요. CLI는 기존 루틴 관리도 지원합니다. /schedule list를 실행하여 모든 루틴을 보거나, /schedule update를 실행하여 하나를 변경하거나, /schedule run을 실행하여 즉시 트리거하세요.

데스크톱 앱에서 생성

데스크톱 앱에서 일정 페이지를 열고 새 작업을 클릭한 다음 새 원격 작업을 선택하세요. 데스크톱 앱은 로컬 예약 작업과 루틴을 동일한 그리드에 표시합니다. 로컬 옵션에 대한 자세한 내용은 데스크톱 예약 작업을 참조하세요.

트리거 구성

루틴은 트리거 중 하나가 일치할 때 시작됩니다. 동일한 루틴에 일정, API 및 GitHub 트리거의 모든 조합을 연결할 수 있으며, 루틴의 편집 양식의 트리거 선택 섹션에서 언제든지 추가하거나 제거할 수 있습니다.

일정 트리거 추가

일정 트리거는 반복 주기에 따라 루틴을 실행합니다. 트리거 선택 섹션에서 사전 설정된 빈도를 선택하세요. 시간별, 일일, 평일 또는 주간. 시간은 로컬 시간대에 입력되고 자동으로 변환되므로 클라우드 인프라가 어디에 있든 루틴이 해당 벽시계 시간에 실행됩니다. 실행은 엇갈림으로 인해 예약된 시간 몇 분 후에 시작될 수 있습니다. 오프셋은 각 루틴에 대해 일관됩니다. 2시간마다 또는 매월 1일과 같은 사용자 정의 간격의 경우 양식에서 가장 가까운 사전 설정을 선택한 다음 CLI에서 /schedule update를 실행하여 특정 cron 표현식을 설정하세요. 최소 간격은 1시간입니다. 더 자주 실행되는 표현식은 거부됩니다.

API 트리거 추가

API 트리거는 루틴에 전용 HTTP 엔드포인트를 제공합니다. 루틴의 베어러 토큰으로 엔드포인트에 POST하면 새 세션이 시작되고 세션 URL이 반환됩니다. 이를 사용하여 Claude Code를 경고 시스템, 배포 파이프라인, 내부 도구 또는 인증된 HTTP 요청을 할 수 있는 곳에 연결하세요. API 트리거는 웹에서 기존 루틴에 추가됩니다. CLI는 현재 토큰을 생성하거나 취소할 수 없습니다.
1

편집을 위해 루틴 열기

claude.ai/code/routines로 이동하고, API를 통해 트리거하려는 루틴을 클릭한 다음, 연필 아이콘을 클릭하여 루틴 편집을 엽니다.
2

API 트리거 추가

프롬프트 아래의 트리거 선택 섹션으로 스크롤하고, 다른 트리거 추가를 클릭한 다음, API를 선택하세요.
3

URL 복사 및 토큰 생성

모달은 이 루틴의 URL과 샘플 curl 명령을 표시합니다. URL을 복사한 다음 토큰 생성을 클릭하고 토큰을 즉시 복사하세요. 토큰은 한 번만 표시되며 나중에 검색할 수 없으므로 경고 도구의 비밀 저장소와 같은 안전한 곳에 저장하세요.
4

엔드포인트 호출

URL에 POST할 때 Authorization: Bearer 헤더에 토큰을 보내세요. 아래의 루틴 트리거 섹션에서 완전한 예시를 보여줍니다.
각 루틴에는 자체 토큰이 있으며, 해당 루틴 트리거로만 범위가 지정됩니다. 회전하거나 취소하려면 동일한 모달로 돌아가 재생성 또는 취소를 클릭하세요.

루틴 트리거

/fire 엔드포인트에 Authorization 헤더의 베어러 토큰으로 POST 요청을 보내세요. 요청 본문은 경고 본문 또는 실패한 로그와 같은 실행별 컨텍스트에 대한 선택적 text 필드를 수락하며, 저장된 프롬프트와 함께 루틴에 전달됩니다. 값은 자유 형식 텍스트이며 구문 분석되지 않습니다. JSON 또는 다른 구조화된 페이로드를 보내면 루틴은 이를 리터럴 문자열로 받습니다. 아래 예시는 셸에서 루틴을 트리거합니다.
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/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. Stack trace attached."}'
성공한 요청은 새 세션 ID와 URL이 있는 JSON 본문을 반환합니다.
{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
브라우저에서 세션 URL을 열어 실시간으로 실행을 보거나, 변경 사항을 검토하거나, 대화를 수동으로 계속하세요.
/fire 엔드포인트는 experimental-cc-routine-2026-04-01 베타 헤더 아래에서 제공됩니다. 요청 및 응답 형태, 속도 제한 및 토큰 의미론은 기능이 연구 미리보기 상태인 동안 변경될 수 있습니다. 주요 변경 사항은 새로운 날짜 지정 베타 헤더 버전 뒤에 제공되며, 가장 최근의 이전 헤더 버전 두 개는 계속 작동하므로 호출자가 마이그레이션할 시간이 있습니다.

API 참조

모든 오류 응답, 검증 규칙 및 필드 제한을 포함한 전체 API 참조는 Claude 플랫폼 설명서의 API를 통해 루틴 트리거를 참조하세요. /fire 엔드포인트는 claude.ai 사용자만 사용할 수 있으며 Claude 플랫폼 API 표면의 일부가 아닙니다.

GitHub 트리거 추가

GitHub 트리거는 연결된 저장소에서 일치하는 이벤트가 발생할 때 자동으로 새 세션을 시작합니다. 각 일치하는 이벤트는 자체 세션을 시작합니다.
연구 미리보기 중에 GitHub 웹훅 이벤트는 루틴별 및 계정별 시간당 상한선이 있습니다. 제한을 초과하는 이벤트는 윈도우가 재설정될 때까지 삭제됩니다. claude.ai/code/routines에서 현재 제한을 확인하세요.
GitHub 트리거는 웹 UI에서만 구성됩니다.
1

편집을 위해 루틴 열기

claude.ai/code/routines로 이동하고, 루틴을 클릭한 다음, 연필 아이콘을 클릭하여 루틴 편집을 엽니다.
2

GitHub 이벤트 트리거 추가

트리거 선택 섹션으로 스크롤하고, 다른 트리거 추가를 클릭한 다음, GitHub 이벤트를 선택하세요.
3

Claude GitHub 앱 설치

Claude GitHub 앱을 구독하려는 저장소에 설치해야 합니다. 트리거 설정은 아직 설치되지 않은 경우 설치하도록 요청합니다.
CLI에서 /web-setup을 실행하면 복제를 위한 저장소 액세스 권한이 부여되지만 Claude GitHub 앱을 설치하지 않으며 웹훅 전달을 활성화하지 않습니다. GitHub 트리거는 Claude GitHub 앱을 설치해야 하며, 트리거 설정이 이를 수행하도록 요청합니다.
4

트리거 구성

저장소를 선택하고, 지원되는 이벤트 목록에서 이벤트를 선택하고, 선택적으로 필터를 추가하세요. 트리거를 저장하세요.

지원되는 이벤트

GitHub 트리거는 다음 이벤트 범주 중 하나를 구독할 수 있습니다. 각 범주 내에서 pull_request.opened와 같은 특정 작업을 선택하거나 범주의 모든 작업에 반응할 수 있습니다.
이벤트트리거 시점
풀 요청PR이 열리거나, 닫히거나, 할당되거나, 레이블이 지정되거나, 동기화되거나, 기타 방식으로 업데이트됨
릴리스릴리스가 생성되거나, 게시되거나, 편집되거나, 삭제됨

풀 요청 필터링

필터를 사용하여 새 세션을 시작하는 풀 요청을 좁히세요. 루틴이 트리거되려면 모든 필터 조건이 일치해야 합니다. 사용 가능한 필터 필드는 다음과 같습니다.
필터일치
작성자PR 작성자의 GitHub 사용자명
제목PR 제목 텍스트
본문PR 설명 텍스트
기본 브랜치PR이 대상으로 하는 브랜치
헤드 브랜치PR이 나오는 브랜치
레이블PR에 적용된 레이블
초안 여부PR이 초안 상태인지 여부
병합 여부PR이 병합되었는지 여부
포크에서PR이 포크에서 나오는지 여부
각 필터는 필드를 연산자와 쌍으로 지정합니다. 같음, 포함, 시작, 하나, 하나 아님 또는 정규식 일치. matches regex 연산자는 전체 필드 값을 테스트하며, 그 내의 부분 문자열이 아닙니다. hotfix를 포함하는 제목과 일치하려면 .*hotfix.*를 작성하세요. 주변 .* 없이는 필터가 정확히 hotfix인 제목과만 일치하며 앞이나 뒤에 아무것도 없습니다. 정규식 구문 없이 리터럴 부분 문자열 일치의 경우 대신 contains 연산자를 사용하세요. 몇 가지 예시 필터 조합:
  • 인증 모듈 검토: 기본 브랜치 main, 헤드 브랜치 포함 auth-provider. 인증을 건드리는 모든 PR을 집중된 검토자에게 보냅니다.
  • 외부 기여자 분류: 포크에서 true. 모든 포크 기반 PR을 인간이 검토하기 전에 추가 보안 및 스타일 검토를 통해 라우팅합니다.
  • 검토 준비 완료만: 초안 여부 false. 초안을 건너뛰므로 루틴은 PR이 검토 준비가 되었을 때만 실행됩니다.
  • 레이블 게이트 백포트: 레이블 포함 needs-backport. 유지 관리자가 PR에 태그를 지정할 때만 다른 브랜치로의 포트 루틴을 트리거합니다.

세션이 이벤트에 매핑되는 방식

각 일치하는 GitHub 이벤트는 새 세션을 시작합니다. GitHub 트리거 루틴의 경우 이벤트 간 세션 재사용을 사용할 수 없으므로 두 PR 업데이트는 두 개의 독립적인 세션을 생성합니다.

루틴 관리

목록에서 루틴을 클릭하여 세부 정보 페이지를 엽니다. 세부 정보 페이지는 루틴의 저장소, 커넥터, 프롬프트, 일정, API 토큰, GitHub 트리거 및 과거 실행 목록을 표시합니다.

실행 보기 및 상호 작용

모든 실행을 클릭하여 완전한 세션으로 엽니다. 거기서 Claude가 수행한 작업을 확인하고, 변경 사항을 검토하고, 풀 요청을 생성하거나, 대화를 계속할 수 있습니다. 각 실행 세션은 다른 세션처럼 작동합니다. 세션 제목 옆의 드롭다운 메뉴를 사용하여 이름을 바꾸거나, 보관하거나, 삭제하세요.

루틴 편집 및 제어

루틴 세부 정보 페이지에서 다음을 수행할 수 있습니다.
  • 지금 실행을 클릭하여 다음 예약된 시간을 기다리지 않고 즉시 실행을 시작하세요.
  • 반복 섹션의 토글을 사용하여 일정을 일시 중지하거나 재개하세요. 일시 중지된 루틴은 구성을 유지하지만 다시 활성화할 때까지 실행되지 않습니다.
  • 연필 아이콘을 클릭하여 루틴 편집을 열고 이름, 프롬프트, 저장소, 환경, 커넥터 또는 루틴의 트리거를 변경하세요. 트리거 선택 섹션은 일정, API 토큰 및 GitHub 이벤트 트리거를 추가하거나 제거하는 곳입니다.
  • 삭제 아이콘을 클릭하여 루틴을 제거하세요. 루틴에서 생성한 과거 세션은 세션 목록에 남아 있습니다.

저장소 및 브랜치 권한

루틴은 저장소를 복제하기 위해 GitHub 액세스가 필요합니다. CLI에서 /schedule로 루틴을 생성할 때 Claude는 계정에 GitHub이 연결되어 있는지 확인하고 연결되지 않은 경우 /web-setup을 실행하도록 요청합니다. GitHub 인증 옵션을 참조하여 액세스 권한을 부여하는 두 가지 방법을 확인하세요. 추가하는 각 저장소는 모든 실행에서 복제됩니다. Claude는 프롬프트에서 달리 지정하지 않는 한 저장소의 기본 브랜치에서 시작합니다. 기본적으로 Claude는 claude/ 접두사가 붙은 브랜치로만 푸시할 수 있습니다. 이는 루틴이 실수로 보호되거나 장기 브랜치를 수정하는 것을 방지합니다. 특정 저장소에 대해 이 제한을 제거하려면 루틴을 생성하거나 편집할 때 해당 저장소에 대해 제한 없는 브랜치 푸시 허용을 활성화하세요.

커넥터

루틴은 연결된 MCP 커넥터를 사용하여 각 실행 중에 외부 서비스에서 읽고 쓸 수 있습니다. 예를 들어 지원 요청을 분류하는 루틴은 Slack 채널에서 읽고 Linear에서 이슈를 생성할 수 있습니다. 루틴을 생성할 때 현재 연결된 모든 커넥터가 기본적으로 포함됩니다. 실행 중에 Claude가 액세스할 수 있는 도구를 제한하려면 필요하지 않은 것을 제거하세요. 루틴 양식 외부에서 커넥터를 관리하거나 추가할 수도 있습니다. 루틴 양식 외부에서 커넥터를 관리하거나 추가하려면 claude.ai의 설정 > 커넥터를 방문하거나 CLI에서 /schedule update를 사용하세요.

환경

각 루틴은 네트워크 액세스, 환경 변수 및 설정 스크립트를 제어하는 클라우드 환경에서 실행됩니다. 루틴을 생성하기 전에 환경을 구성하여 Claude에게 API에 액세스하거나, 종속성을 설치하거나, 네트워크 범위를 제한할 수 있게 하세요. 전체 설정 가이드는 클라우드 환경을 참조하세요.

사용 및 제한

루틴은 대화형 세션과 동일한 방식으로 구독 사용을 소비합니다. 표준 구독 제한 외에도 루틴은 계정당 시작할 수 있는 실행 수에 대한 일일 상한선이 있습니다. claude.ai/code/routines 또는 claude.ai/settings/usage에서 현재 소비 및 남은 일일 루틴 실행을 확인하세요. 루틴이 일일 상한선 또는 구독 사용 제한에 도달할 때 추가 사용이 활성화된 조직은 계량된 초과 요금으로 루틴을 계속 실행할 수 있습니다. 추가 사용이 없으면 윈도우가 재설정될 때까지 추가 실행이 거부됩니다. claude.ai의 설정 > 청구에서 추가 사용을 활성화하세요.

관련 리소스