Cmd. /schedule

명령어 원본 선언

/schedule [description]

• 별칭(alias): /routines

공식 설명 요약

/schedule은 routine을 생성·수정·조회·실행하는 명령입니다. Claude가 대화형으로 설정 과정을 안내합니다.

공식 문서의 정의를 그대로 옮기면 다음과 같습니다.

Create, update, list, or run routines, which execute on Anthropic-managed cloud infrastructure. Claude walks you through the setup conversationally. Alias: /routines

routine은 저장된 Claude Code 구성입니다. prompt, 하나 이상의 repository, connector 묶음을 한 번 정의해 두면 자동으로 실행됩니다. Anthropic이 관리하는 클라우드 인프라에서 돌기 때문에 노트북을 닫아도 계속 작동합니다.

각 routine에는 다음 세 종류의 trigger를 하나 이상 붙일 수 있습니다.

• Scheduled: 매시간·매일·매주처럼 반복 실행하거나, 미래의 특정 시점에 한 번만 실행
• API: routine별 HTTP 엔드포인트에 bearer 토큰을 담아 POST하면 즉시 실행
• GitHub: pull request, release 등 저장소 이벤트에 반응해 자동 실행

하나의 routine에 여러 trigger를 함께 붙일 수도 있습니다.

CLI에서의 범위: /schedule로 CLI에서 만드는 routine은 scheduled trigger 전용입니다. API나 GitHub trigger를 추가하려면 웹(claude.ai/code/routines)에서 routine을 편집해야 합니다.

최소 지원 버전

• Claude Code v2.1.81 이상이 필요합니다. CLI 버전이 v2.1.81보다 낮으면 /schedule이 숨겨지며 Unknown command로 처리됩니다(claude update로 갱신). 출처: Commands 문서의 Routines 트러블슈팅 섹션.
• routine 기능 자체는 아직 research preview 단계라 동작·제한·API 표면이 바뀔 수 있습니다.

사용법

# 대화형으로 새 routine 생성 (Claude가 설정을 안내)
/schedule

# 반복 routine을 설명과 함께 바로 생성
/schedule daily PR review at 9am

# 1회성(one-off) routine — 자연어로 시점을 묘사
/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag

# 기존 routine 관리 (서브커맨드)
/schedule list      # 모든 routine 조회
/schedule update    # routine 수정
/schedule run       # 즉시 실행

• 1회성 routine은 지정 시점에 한 번 실행된 뒤 자동으로 비활성화되며, 웹 UI에 Ran으로 표시됩니다. 다시 실행하려면 새 1회성 시점을 설정해야 합니다.
• 입력한 시간은 로컬 타임존 기준으로 받아 자동으로 변환됩니다.

좋은 사용 예

1. /schedule daily PR review at 9am — 매일 오전 9시 PR 리뷰 routine
2. /schedule weekly backlog grooming report — 주간 backlog 정리 보고서
3. /schedule in 1 week, open a cleanup PR that removes the feature flag — 1주 뒤 1회성 정리 PR
4. /schedule list 후 /schedule update로 cron 식·connector 조정

비슷한 명령어 추천

활용 사례

• 매주 backlog grooming 보고서를 connector로 작성
• monitoring alert를 API trigger로 받아 원인 후보 PR 작성(웹에서 API trigger 추가)
• pull_request.opened GitHub trigger로 팀 전용 코드 리뷰 routine 운영(웹에서 GitHub trigger 추가)
• 배포 후 CD 파이프라인이 API 엔드포인트를 호출해 스모크 점검 실행

주의사항

• routine은 research preview입니다. 동작, 제한, API 표면이 바뀔 수 있습니다.
• Pro, Max, Team, Enterprise 플랜에서 Claude Code on the web이 활성화되어 있어야 합니다.
• /schedule은 claude.ai 구독 로그인이 필요합니다. Console API 키나 Bedrock/Vertex/Foundry 인증을 쓰면 명령이 숨겨집니다. ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, settings.json의 apiKeyHelper가 설정돼 있으면 먼저 제거하세요.
• DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_GROWTHBOOK 환경변수가 설정돼 있으면 feature flag 조회가 막혀 /schedule이 숨겨집니다.
• Claude Code on the web 세션 안에서는 CLI /schedule이 노출되지 않으니, 웹 UI에서 routine을 관리하세요.
• CLI의 /schedule은 scheduled trigger만 만들 수 있습니다. API·GitHub trigger는 웹에서 추가해야 합니다.
• 반복 schedule의 최소 간격은 1시간이며, 더 잦은 cron 식은 거부됩니다. 커스텀 간격은 가까운 프리셋을 고른 뒤 /schedule update로 cron 식을 지정합니다.
• /web-setup은 저장소 clone 권한만 부여합니다. Claude GitHub App을 설치하거나 webhook을 활성화하지는 않으므로, GitHub trigger를 쓰려면 trigger 설정에서 안내하는 대로 Claude GitHub App을 별도로 설치해야 합니다.
• routine은 개인 claude.ai 계정에 속하며 팀원과 공유되지 않습니다. routine이 GitHub·connector로 수행한 작업은 본인 계정으로 기록됩니다.
• routine은 권한 승인 프롬프트 없이 알아서 실행됩니다. 선택한 저장소·환경·connector 범위를 필요한 최소한으로 제한하세요. Team/Enterprise 관리자는 조직 정책에서 routine을 전체 비활성화할 수 있습니다.

출처

• Commands: https://code.claude.com/docs/en/commands
• Automate work with routines: https://code.claude.com/docs/en/routines