Claude Code の /schedule で「자는 동안 일 시키기」를 실현하자 — /loop와의 차이점도 철저히 해설

「매일 아침 PR을 확인해서, 머지된 게 있으면 문서를 업데이트해 둬」

그런 지시를 Claude에게 내리고, 나머지는 내버려 둘 수 있다면 최고겠죠.

2026년 3월 24일, Claude Code에 /schedule 커맨드가 추가되었습니다. 이를 사용하면 Anthropic의 클라우드 인프라 위에서 정기적으로 태스크를 자동 실행할 수 있습니다. 노트북을 닫고 있어도, 자고 있어도, Claude가 묵묵히 일을 해주는 것입니다.

이 글에서는 /schedule의 사용법을 자세히 설명하면서, 얼마 전 추가된 /loop 커맨드와의 차이점도 정리해 보겠습니다.

/schedule이란

/schedule은 Claude Code의 프롬프트를 클라우드 상에서 정기 실행하기 위한 커맨드입니다.

예를 들어, 이런 것들이 가능합니다.

• 매일 아침 9시에 오픈된 PR을 리뷰한다
• CI가 실패하면 원인을 분석해서 요약을 출력한다
• PR이 머지되면 문서를 자동으로 동기화한다
• 매주 의존 패키지 체크를 실행한다

포인트는 클라우드 상에서 동작한다는 것입니다. 로컬의 Claude Code 세션이 동작하고 있을 필요가 없습니다. 태스크는 Anthropic의 인프라 위에서 실행되며, 결과는 claude.ai/code/scheduled의 세션으로 확인할 수 있습니다.

/loop와의 차이점

Claude Code에는 얼마 전 /loop라는 정기 실행 커맨드도 추가되었습니다. 「그럼 /schedule과 뭐가 다른 거야?」라는 의문이 생길 것 같으니, 비교해 보겠습니다.

간단히 말하면, /loop는 「잠깐 지켜봐 줘」, /schedule은 「매일 이거 해 줘」 라는 식으로 구분해서 사용합니다.

/loop 사용법

/loop에 대해서는 이쪽 글에서 자세히 설명하고 있습니다. → Claude Code에서 프롬프트를 정기 실행! /loop 커맨드와 스케줄 태스크 사용법

여기서는 /schedule과의 비교를 위해 핵심만 짚어보겠습니다. /loop는 세션 내에서 간편하게 사용할 수 있습니다.

/loop 5m 배포가 완료되었는지 확인하고, 결과를 알려줘

이렇게 하면 5분마다 확인해 줍니다. 편리하지만, CLI 세션을 닫으면 멈추고, 3일이 지나면 자동으로 만료됩니다. 「지금 진행 중인 배포를 지켜보고 싶다」는 식의 단기적인 용도에 딱 맞습니다.

간격 지정에는 s（초）, m（분）, h（시간）, d（일）을 사용할 수 있습니다. 간격을 생략하면 기본값으로 10분이 됩니다.

/loop check the build              # 10분마다（기본값）
/loop 30m check the build          # 30분마다
/loop check the build every 2h     # 2시간마다（뒤에 써도 OK）

다른 커맨드나 스킬을 루프시킬 수도 있습니다.

/loop 20m /review-pr 1234

/schedule 사용법

/schedule은 CLI에서 대화형으로 설정할 수 있습니다. 예를 들어 「매일 아침 9시에 PR을 리뷰하는」 태스크를 만들려면, 이렇게 입력합니다.

/schedule daily PR review at 9am

그러면 Claude가 다음과 같은 항목을 대화 형식으로 설정해 줍니다.

1. 태스크 이름과 프롬프트 — Claude에게 무엇을 시킬지 작성한다. 자율적으로 동작하므로, 구체적이고 자기 완결적인 지시로 만드는 것이 포인트
2. GitHub 리포지토리 — 대상 리포지토리를 선택. 매번 기본 브랜치에서 클론된다
3. 스케줄 — 실행 빈도를 선택（매시간·매일·평일만·매주）
4. 환경 설정（선택） — 네트워크 접근, 환경 변수, 설정 스크립트 설정
5. 커넥터（선택） — Slack이나 Linear 등 외부 서비스와의 연동

Web UI（claude.ai/code/scheduled）나 데스크톱 앱에서는 폼 형식으로 동일한 항목을 설정할 수 있습니다. 환경 설정이나 커넥터는 필요 없으면 기본값 그대로 진행해도 문제없습니다.

스케줄 관리

/schedule list      # 태스크 목록 표시
/schedule update    # 태스크 편집
/schedule run       # 지금 바로 실행

Web UI에서는 태스크의 일시 정지·재개·삭제도 할 수 있습니다. 실행 결과는 세션으로 남기 때문에, Claude가 무엇을 했는지 나중에 확인하거나 PR을 생성할 수 있습니다.

브랜치 처리

기본적으로 Claude는 claude/ 프리픽스가 붙은 브랜치에만 푸시할 수 있습니다. main이나 develop을 직접 변경해 버릴 걱정은 없습니다. 필요에 따라 리포지토리별로 제한을 해제하는 것도 가능합니다.

어떤 용도로 사용할 수 있을까?

개발 팀을 위한 활용 예시

• 매일 아침 PR 리뷰: 9시에 오픈된 PR을 일괄 리뷰하여 코멘트나 요약을 남긴다
• CI 실패 자동 분석: 야간에 실행된 CI가 실패했다면 원인을 분석하여 아침까지 리포트를 준비
• 문서 자동 동기화: PR이 머지될 때마다 관련 문서를 업데이트
• 의존 패키지 주간 감사: 매주 월요일에 의존 패키지를 체크하여 보안 알림이나 업데이트가 있으면 보고

개인 개발자·프리랜서를 위한 활용 예시

• 블로그 리포지토리 교정: 매일 아침 초안 글을 교정하여 개선 제안을 PR로 제출
• 경쟁 서비스 모니터링: 정기적으로 경쟁사의 리포지토리나 changelog를 확인하여 변경 사항을 요약
• 코드베이스 건강 진단: 매주 기술 부채나 코드 품질 점수를 체크하여 리포트 작성

주의사항과 베스트 프랙티스

프롬프트는 구체적으로 작성한다

/schedule에서 실행되는 태스크는 완전히 자율적으로 동작합니다. 대화를 주고받으며 수정하는 것은 불가능하므로, 프롬프트는 모호함을 배제하고 성공 조건을 명확히 해야 합니다.

❌ PR을 리뷰해 줘
✅ 오픈된 PR을 모두 확인하여, 코드 품질·보안·테스트 커버리지 관점에서 리뷰 코멘트를 남겨 주세요.
   중대한 문제가 없으면 approve해 주세요.

/loop와 /schedule을 구분해서 사용한다

• 지금 하고 있는 작업 모니터링 → /loop（배포 모니터링, 테스트 결과 대기）
• 매일·매주 정기 태스크 → /schedule（PR 리뷰, 문서 업데이트）
• 한 번만 하는 리마인더 → 자연어로（「45분 후에 테스트 결과를 확인해 줘」）

이용 한도 소비를 의식한다

/schedule의 태스크는 매번 클라우드 상에서 Claude 세션을 시작하기 때문에, 플랜의 이용 한도를 소비합니다. Pro / Max 플랜의 경우 추가 요금이 발생하는 것은 아니지만, 일반 채팅이나 Claude Code와 동일한 이용 한도를 공유하고 있습니다. 「매시간 실행」을 무심코 설정하면 평소 작업에 사용할 수 있는 한도가 줄어들 수 있으므로, 빈도는 필요 최소한으로 해두는 것이 무난합니다.

정리

/schedule과 /loop를 정리하면 이렇게 됩니다.

• /loop: 세션 내의 경량 스케줄러. 「잠깐 지켜봐 줘」에 최적. 3일 후 만료
• /schedule: 클라우드 기반의 본격 스케줄러. 「매일 이거 해 줘」를 실현. PC를 닫아도 동작

/schedule의 등장으로 Claude Code는 「대화형 코딩 어시스턴트」에서 「자율적으로 일하는 개발 팀 멤버」로 또 한 걸음 진화했습니다. 특히 정형적인 작업（PR 리뷰, 문서 업데이트, 보안 체크 등）을 자동화할 수 있다는 것은 개인 개발자에게도 팀에게도 큰 장점입니다.

또한, n8n에서 Claude API를 사용하던 처리도 어쩌면 이 /schedule로 이전할 수 있을지도 모릅니다.

자는 동안 Claude가 일을 처리해 주는 경험, 이것이야말로 AI 활용의 큰 목적 중 하나입니다!

참고 링크

• Run prompts on a schedule - Claude Code 공식 문서
• Schedule tasks on the web - Claude Code 공식 문서
• Claude Code Changelog