Cmd. /schedule
Anthropic 클라우드에서 실행되는 routine을 생성·수정·조회·실행하는 자동화 명령
핵심 요약
- cloud routine 생성·조회·실행 (
/routines) - 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
cloud routine 생성·조회·실행 (/routines)
/schedule [description]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 조건부 |
| 별칭 | /routines |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
클라우드 세션 또는 루틴 접근 권한과 필요한 계정 연결을 확인합니다.
사용 예
/schedule# 대화형으로 새 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회성 시점을 설정해야 합니다.
- 입력한 시간은 로컬 타임존 기준으로 받아 자동으로 변환됩니다.
선택 시점
/schedule daily PR review at 9am— 매일 오전 9시 PR 리뷰 routine/schedule weekly backlog grooming report— 주간 backlog 정리 보고서/schedule in 1 week, open a cleanup PR that removes the feature flag— 1주 뒤 1회성 정리 PR/schedule list후/schedule update로 cron 식·connector 조정
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/schedule | 클라우드 routine 생성·수정·조회·실행 | 반복·무인 자동화 |
/loop | 현재 로컬 세션에서 반복 실행(별칭 /proactive) | 세션 유지 중 대기·감시 작업 |
/autofix-pr | 현재 브랜치 PR을 감시해 CI 실패·리뷰 수정 | CI/리뷰 코멘트 자동 처리 |
/background | 현재 세션을 백그라운드 에이전트로 분리(별칭 /bg) | 터미널을 비우고 작업 계속 실행 |
/web-setup | gh CLI 자격증명으로 GitHub 계정 연결 | 웹 자동화 전 저장소 접근 연결 |
실행 결과와 유지 범위
클라우드에서 실행되는 루틴을 생성·변경·조회·실행합니다. 로컬 세션 종료와 독립적인 실행이 가능합니다.
/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을 편집해야 합니다.
주의사항
- 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을 전체 비활성화할 수 있습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록