/schedule

무엇이고 누가 쓸 수 있나

클라우드 예약 작업(예전 이름은 루틴)은 프롬프트, 저장소 하나 이상, 커넥터를 묶어 저장한 설정입니다. 클라우드 세션으로 실행되며 셸 명령을 쓰고 스킬을 쓰고 포함한 커넥터를 호출합니다.

공식 문서 기준으로 Pro, Max, Team, Enterprise 요금제에서 쓸 수 있고, claude.ai/code/routines 웹에서 또는 CLI의 /schedule로 만듭니다. 별칭은 /routines입니다. 웹, 데스크톱, CLI는 같은 계정에 저장됩니다.

작업은 내 계정 소유이며 팀원과 공유되지 않습니다. 커밋, PR, Slack 메시지는 내 GitHub와 연동 계정으로 남습니다.

CLI에서 만들기

설명을 주면 Claude가 일정, 저장소, 프롬프트를 되물은 뒤 저장합니다. 인증하라거나 원격 계정에 연결할 수 없다는 답이 나오면 작업은 만들어지지 않은 것입니다.

프롬프트는 실행 때마다 사람 없이 수행되므로, 무엇을 하고 어떤 상태가 성공인지 스스로 알 수 있게 구체적으로 써야 합니다.

/schedule daily PR review at 9am
/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule list      # 목록
/schedule update    # 수정
/schedule run       # 지금 실행

트리거와 제한

• 일정(Schedule): 매시, 매일, 매주 같은 반복 또는 특정 시각 한 번. 한 번짜리는 실행 뒤 스스로 꺼집니다.
• API: 작업 전용 주소에 토큰으로 POST하면 실행됩니다. 웹에서만 추가할 수 있습니다.
• GitHub 이벤트: PR이 열리거나 릴리스가 생길 때 실행됩니다. 웹에서 추가합니다.
• 최소 간격은 1시간이고 그보다 잦은 cron은 거부됩니다. 정각은 몇 분 늦게 시작할 수 있어 9:07처럼 정각을 피하라고 문서가 권합니다.
• 5필드 cron을 직접 쓰면 시간은 UTC 기준입니다(CRON_TZ= 접두어가 있으면 그 시간대).
• 예약 실행은 계정당 시간당 100회로 제한됩니다.
• 변경은 claude/ 접두어가 붙은 브랜치로 올라갑니다. 매 실행은 저장소를 새로 클론합니다.

/loop, 데스크톱 예약과 비교

공식 문서의 비교표 기준입니다. 클라우드 예약은 컴퓨터와 세션이 꺼져 있어도 되지만 로컬 파일에 접근하지 못하고(새 클론) 최소 간격이 1시간입니다. 데스크톱 예약은 내 컴퓨터가 켜져 있어야 하고 로컬 파일을 쓸 수 있습니다. /loop은 열려 있는 세션 안에서만 돌며 최소 간격은 1분이고, 반복 작업은 만든 지 7일이 지나면 만료됩니다.

그래서 컴퓨터를 꺼도 돌아야 하면 /schedule, 로컬 파일이 필요하면 데스크톱 예약, 배포를 잠깐 지켜보는 용도면 /loop이 맞습니다. 한 번 실행하는 스크립트용은 claude -p입니다.

실제 예시

/schedule daily at 9:07am, summarize yesterday's merged PRs in this repository

/schedule in 1 week, open a cleanup PR that removes the feature flag

흔한 실수와 쓰지 말아야 할 때

• 프롬프트가 모호하면 아무도 보지 않는 상태에서 엉뚱하게 실행됩니다. 성공 기준을 적으세요.
• 커넥터는 기본으로 모두 포함됩니다. 쓰기 권한이 있는 커넥터가 불필요하게 들어가지 않게 빼세요.
• 로컬에만 있는 파일, 커밋하지 않은 변경은 클라우드 세션에서 보이지 않습니다.
• 연구 프리뷰라 동작과 한도가 바뀔 수 있습니다. 중요한 업무 흐름은 결과를 주기적으로 확인하세요.
• API 트리거 토큰은 생성할 때 한 번만 보입니다. 바로 안전한 곳에 저장하세요.

자주 묻는 질문