Claude Code v2.1.71 이상
Claude Code /loop schedule,
켜두지 않으면 안 됩니다
2026년 3월 7일, Anthropic이 Claude Code에 스케줄 기능을 공식 출시했습니다. /loop와 /schedule, 두 명령어로 반복 작업을 자동화할 수 있는데 — 결론부터 말씀드리면, 컴퓨터가 켜져 있고 앱이 실행 중일 때만 작동합니다. 이 조건을 모르면 자정에 예약한 PR 리뷰가 아침에도 그대로 남아있습니다.
/loop와 /schedule, 뭐가 다른가요?
Claude Code /loop schedule 기능은 크게 두 가지로 나뉩니다. 둘 다 반복 작업을 자동화하지만, 유지 시간과 용도가 다릅니다.
| 구분 | 명령어 | 유지 시간 | 특징 |
|---|---|---|---|
| 세션 스코프 | /loop |
현재 세션 종료까지 | 빠른 등록, 가볍게 사용 |
| 영구 스케줄 | /schedule 또는 GUI |
최대 3일 (자동 만료) | 크론잡 정밀 설정 가능 |
/loop는 명령어 하나로 바로 등록됩니다. 인터벌을 앞에 붙이거나(예: /loop 30m 빌드 확인), every를 뒤에 붙이는 방식(/loop 빌드 확인 every 2 hours)도 됩니다. 인터벌을 아예 생략하면 기본 10분 간격으로 잡힙니다. /schedule은 GUI에서 Hourly·Daily·Weekdays·Weekly 중 하나를 고르거나, 크론 표현식으로 분 단위까지 정밀하게 설정할 수 있습니다.
내부적으로는 CronCreate·CronList·CronDelete 세 가지 도구가 동작하고, CronDelete는 ID가 8자리 이상이어야 합니다. (출처: Claude Code 공식 문서, code.claude.com/docs/ko/scheduled-tasks)
막상 써보면 이 조건에서 멈춥니다
가장 많이 오해하는 부분입니다. 이 기능은 진짜 서버사이드 스케줄러가 아닙니다. Reddit /r/ClaudeAI 스레드(2026.03.07, 점수 1,192)에서 개발자 커뮤니티가 처음 짚어낸 핵심 지적 — “그냥 크론잡의 사용자 친화적 래퍼일 뿐”이라는 말은 틀린 게 아닙니다. 단, 일반 크론잡보다 훨씬 까다로운 조건이 하나 더 있습니다.
⚠️ 실행 조건 — 공식 문서 기준 (code.claude.com/docs/ko/scheduled-tasks)
- Claude Code(데스크탑 앱)가 실행 중이어야 합니다.
- Claude Code가 유휴(idle) 상태여야 합니다. 다른 작업을 처리 중이면 스케줄이 대기 상태로 밀립니다.
- 컴퓨터가 잠자기 모드에 들어가면 해당 주기는 건너뜁니다. 재시작 후 다음 주기에 자동 재개됩니다.
/loop는 세션 종료 시 자동 삭제되고 재시작 후 복원되지 않습니다.
즉, “자정에 PR 자동 리뷰를 걸어두고 자겠다”는 시나리오는 컴퓨터를 켜둔 채로 앱을 실행 상태로 유지해야 한다는 뜻입니다. 맥북 뚜껑을 닫으면 잠자기 모드가 되고, 그 주기는 통째로 스킵됩니다. 24시간 무중단 실행이 필요한 작업이라면 별도 서버나 GitHub Actions가 더 적합합니다.
정각에 실행되는 게 아닙니다 — 지터(Jitter) 조건
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다
기존 블로그 대부분은 “/schedule로 정각에 실행”이라고 안내합니다. 하지만 공식 문서에는 지터(Jitter) 조건이 명시되어 있습니다.
Claude Code /loop schedule은 반복 태스크에 지터를 적용합니다. 공식 문서(code.claude.com/docs/ko/scheduled-tasks) 기준:
- 주기의 최대 10%, 최대 15분 범위에서 실행 시간이 자동으로 달라집니다.
- 같은 태스크는 매번 동일한 오프셋으로 적용되어 완전 무작위는 아닙니다.
- 예:
0 9 * * *(매일 오전 9시) 설정 시, 실제 실행은 9:00 대신 9:03~9:08 사이가 될 수 있습니다.
이 말이 의미하는 건, 정확한 시각에 의존하는 작업에는 이 기능이 맞지 않는다는 겁니다. 주식 종가가 15:30 정각에 확정되는데, 크론을 30 15 * * 1-5로 걸었다면 실제 실행이 15:33이 될 수 있습니다. 공식 발표가 “정각보다 3분 지난 시각으로 설정하라”고 권고하는 이유가 바로 이겁니다.
실측 계산 예시: 60분 주기 태스크의 경우 지터 최대 범위는 60분 × 10% = 6분입니다. 즉 14:00 실행 예정이라도 실제론 14:00~14:06 사이 어느 시점에 실행됩니다. 이 범위가 비즈니스 로직에 영향을 주는지 반드시 확인해야 합니다.
토큰이 여기서 빠져나갑니다
Claude Code의 평균 비용은 개발자 1인당 하루 $6이고, 90%의 사용자가 하루 $12 이하를 유지합니다. (출처: Claude Code 공식 비용 문서, code.claude.com/docs/ko/costs) 얼핏 낮아 보이지만, /loop를 잘못 설정하면 이 숫자가 순식간에 바뀝니다.
📊 직접 따라할 수 있는 비용 계산
시나리오: /loop 30m으로 코드베이스 에러 로그 스캔을 하루 종일(8시간 기준) 실행할 경우
- 1회당 평균 API 시간 기준 토큰 소비: 코드베이스 크기에 따라 수천~수만 토큰
- 30분 주기 × 8시간 = 16회 실행
- 1회 실행에 20,000토큰(Sonnet 4.6 기준 약 $0.06) 소비 시 → 16회 × $0.06 = $0.96
- 이 루프 1개만으로 일일 평균 비용($6)의 약 16%를 점유
※ Sonnet 4.6 API 가격 기준, 1회 실행 토큰 수는 코드베이스 크기에 따라 달라집니다. 본인 환경에서 /cost 명령어로 직접 확인 권장.
더 중요한 건 루프가 여러 개일 때입니다. PR 리뷰 /loop 1개 + 에러 스캔 /loop 1개 + 종가 수집 /loop 1개를 동시에 돌리면, 세션 내 토큰 소모가 예상보다 3배 이상 빨라질 수 있습니다. Reddit 실사용자 사례(r/ClaudeCode, 2026.03.07)에서도 “PR 루프를 닫지 않고 놔뒀더니 REST API 토큰이 매시간 한도에 걸렸다”는 케이스가 보고됐습니다. 루프를 등록할 때 what scheduled tasks do I have?로 현재 활성 루프를 주기적으로 확인하는 습관이 필요합니다.
공식 문서와 실제 사용 흐름을 같이 놓고 보니
💡 공식 릴리스 노트와 Reddit 실사용 패턴을 교차해서 보면 이 차이가 드러납니다
워크트리(Worktree) 활성화 여부는 공식 문서 어디에도 “권장” 표기가 없습니다. 그런데 실제 사용자들이 가장 먼저 데이는 바로 이 부분입니다.
워크트리 옵션을 켜면, 스케줄된 작업이 실행될 때마다 독립된 Git 워크트리가 새로 생성됩니다. 메인 브랜치를 건드리지 않고 작업한 뒤, 사람이 확인하고 머지 여부를 결정하는 구조입니다. 공식 문서(code.claude.com/docs/ko/scheduled-tasks)에는 “스케줄 작업에 영향력 있는 작업을 수행할 때 워크트리를 사용하라”고만 나와 있습니다.
문제는 워크트리 없이 PR 자동 수정 루프를 돌리면, Claude가 메인 브랜치에 직접 커밋을 올릴 수 있다는 점입니다. Reddit에서 실제로 “자고 일어났더니 메인에 20개 커밋이 쌓여있었다”는 케이스가 보고됐습니다. 자동화 작업의 범위가 읽기 전용(로그 스캔, 상태 확인)인지, 쓰기 작업(커밋, PR 생성)인지에 따라 워크트리 활성화 여부를 반드시 판단해야 합니다.
작업 유형별 워크트리 권장 여부
에러 로그 스캔, 배포 상태 확인, Slack 요약 생성, 알림 발송
PR 자동 수정, 코드 자동 커밋, 의존성 업데이트 PR 생성
이 경우에만 쓰면 됩니다
솔직히 말하면, 모든 개발자에게 유용한 기능은 아닙니다. 이미 OpenClaw나 서버 기반 cron을 쓰는 환경이라면 복잡한 장기 실행 작업은 그쪽이 훨씬 안정적입니다. Claude Code /loop schedule의 진짜 가치는 지금 하고 있는 코딩 작업과 직접 연관된 단기 자동화에 있습니다.
✅ 실제로 유용한 케이스
- 배포 파이프라인 모니터링
/loop 1m 배포 상태 확인 - CI 실패 시 자동 수정 후 재시도
- MCP 연결된 Sentry 에러 주기 스캔
- 평일 정해진 시각 데이터 수집
❌ 이 경우엔 맞지 않습니다
- 컴퓨터를 끄거나 덮개를 닫는 야간 자동화
- 초 단위 정밀 실행이 필요한 알림
- 3일 이상 지속되어야 하는 장기 루프
- 이미 전문 자동화 도구를 쓰는 환경
Pro·Max·Team·Enterprise 유료 플랜 전용이라는 점도 주의해야 합니다. 무료 플랜에서는 이 명령어 자체가 동작하지 않습니다. 플랜 확인 없이 셋업했다가 아무 반응이 없으면 당황스럽습니다. 스케줄러 전체를 비활성화하고 싶을 때는 환경변수 CLAUDE_CODE_DISABLE_CRON=1을 설정하면 됩니다. (출처: Claude Code 공식 문서, code.claude.com/docs/ko/scheduled-tasks)
자주 묻는 것들
마치며
Claude Code /loop schedule 기능을 정리하면서 느낀 건, 이게 “새로운 자동화의 시대”라기보다는 “코딩 맥락 안에서 쓰기 좋은 친화적 도구”에 가깝다는 점입니다. 기술적으로는 cron의 래퍼이고, 서버가 아닌 로컬 앱 기반이라 한계도 분명합니다.
그럼에도 실제로 유용한 영역은 있습니다. 배포 파이프라인 모니터링처럼 “지금 하고 있는 작업과 연결된, 컨텍스트 스위칭을 줄여주는” 쓰임새입니다. 그 용도에서는 꽤 괜찮습니다. 다만 앱을 켜두어야 한다는 조건, 지터, 3일 만료, 유료 플랜 전용이라는 네 가지를 모르고 시작하면 예상과 다른 상황이 생깁니다.
이 기능이 출시된 지 13일밖에 안 됐습니다(2026.03.07 기준). 3일 만료 제한이나 데스크탑 전용이라는 조건은 충분히 바뀔 수 있습니다. 공식 문서(code.claude.com/docs/ko/scheduled-tasks)에서 업데이트를 주기적으로 확인하는 것이 가장 정확합니다.
본 포스팅 참고 자료
- Claude Code 공식 문서 — 일정에 따라 프롬프트 실행하기
https://code.claude.com/docs/ko/scheduled-tasks - Claude Code 공식 문서 — 비용을 효과적으로 관리하기
https://code.claude.com/docs/ko/costs - Reddit r/ClaudeCode — Claude Code just shipped /loop (2026.03.07)
https://www.reddit.com/r/ClaudeCode/comments/1rn94wp/ - Reddit r/ClaudeAI — Anthropic just made Claude Code run without you (2026.03.07)
https://www.reddit.com/r/ClaudeAI/comments/1rna5mb/
본 포스팅은 2026년 3월 20일 기준으로 작성되었습니다. Claude Code v2.1.71 이상 버전 기준이며, 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 정확한 최신 정보는 공식 문서(code.claude.com/docs/ko)를 통해 확인하시기 바랍니다.
댓글 남기기