Claude Code 스케줄: /loop 한 번으로 AI가 혼자 3일 일하는 법
2026년 3월 7일, Anthropic이 조용히 업무 자동화의 판을 바꿨습니다. Claude Code 스케줄 기능이 정식 출시됐고, 이제 AI는 당신이 자리를 비워도 알아서 일합니다.
⏰ 최대 3일 자율 실행
💡 유료 플랜 전용
🔧 /schedule + /loop
왜 지금 Claude Code 스케줄이 화제인가?
Claude Code 스케줄 기능은 단순한 업데이트가 아닙니다. 2026년 3월 7일을 기점으로 Anthropic은 AI가 “명령받을 때만 일하는 도구”에서 “알아서 일정 관리까지 하는 에이전트”로 진화했음을 선언했습니다. 실제로 AI 에이전트 오픈소스 도구인 OpenClaw가 Github Star 20만 개를 돌파하며 상시 자율 가동 수요를 증명했고, Anthropic은 이를 공식 기능으로 내재화했습니다.
핵심은 두 가지 명령어입니다. /schedule은 영구적으로 최대 3일간 반복 실행되는 스케줄을 등록하고, /loop는 현재 세션 안에서 즉각 반복 모니터링을 걸어줍니다. 내부적으로는 CronCreate, CronList, CronDelete 세 가지 도구가 자동으로 작동합니다.
지원 플랫폼은 Claude.ai(웹), Claude Code(터미널/데스크탑), Claude Cowork(데스크탑 앱)입니다. 단, 유료 플랜(Pro, Max, Team, Enterprise)에서만 사용 가능하며, 무료 플랜에서는 작동하지 않습니다. 이 점은 반드시 먼저 확인해야 합니다.
/schedule vs /loop: 두 명령어의 결정적 차이
이 두 명령어를 혼동하면 원하는 자동화를 설정하지 못합니다. 목적 자체가 다르기 때문입니다. 아래 비교표를 먼저 보면 한 번에 이해됩니다.
| 구분 | 명령어 | 유지 기간 | 주요 용도 |
|---|---|---|---|
| 세션 스코프 | /loop |
세션 종료까지 | 배포 모니터링, 집중 리마인더 |
| 영구 스케줄 | /schedule (또는 GUI) |
최대 3일 (자동 만료) | 매일 브리핑, 주가 분석, PR 모니터링 |
/loop 명령어 사용법
/loop는 설정이 가장 빠릅니다. 인터벌(주기)을 앞이나 뒤에 붙이면 되고, 생략하면 기본 10분마다 반복됩니다. 지원 단위는 s(초), m(분), h(시간), d(일)이며, 초 단위를 입력해도 내부적으로 분 단위로 반올림됩니다.
/loop 30m 현재 빌드 상태 확인하고 에러 있으면 알려줘
# 2시간마다 실행 (뒤에 every 절 방식)
/loop Sentry 에러 풀링해줘 every 2 hours
# 인터벌 생략 시 기본 10분
/loop 집중 상태 체크하고 진행 상황 요약해줘
/schedule 명령어 사용법
/schedule은 반영구적 반복 작업을 등록합니다. GUI로도 등록할 수 있는데, Claude Cowork 사이드바의 “Scheduled” 탭에서 “+ New task” 버튼을 누르면 됩니다. 명령어 방식은 /schedule을 입력하면 Claude가 필요한 정보를 순서대로 물어봅니다.
# 1. 이름/설명
# 2. 실행 프롬프트
# 3. 빈도 (Hourly/Daily/Weekdays/Weekly/Manual)
# 4. 작업 폴더 (선택사항)
# 5. 워크트리 사용 여부
/schedule 명령어로 입력하세요. “평일 오후 3시 30분에 종가 분석해줘”처럼 한국어로 말해도 Claude가 알아서 크론 표현식으로 변환해 줍니다.
크론 표현식 없이도 정밀 설정하는 법
크론 표현식이라는 단어 자체에서 거부감을 느끼는 분이 많습니다. 그런데 Claude Code 스케줄에서는 크론 문법을 외울 필요가 없습니다. 한국어로 자연어를 입력하면 Claude가 올바른 크론 표현식을 생성해 줍니다. 그래도 어떤 구조인지 한 번은 이해해 두면 나중에 확인할 때 편합니다.
크론 표현식은 5개 필드로 구성됩니다. 왼쪽부터 분(0~59) / 시(0~23) / 일(1~31) / 월(1~12) / 요일(0~6, 일요일=0) 순서입니다.
| 크론 표현식 | 실행 시점 | 실제 활용 예 |
|---|---|---|
*/5 * * * * |
5분마다 | 단기 배포 모니터링 |
0 * * * * |
매시간 정각 | 뉴스 수집 자동화 |
0 8 * * * |
매일 오전 8시 | 아침 업무 브리핑 |
0 9 * * 1-5 |
평일 오전 9시 | 출근 전 슬랙 요약 |
30 15 * * 1-5 |
평일 오후 3시 30분 | 주식 종가 자동 분석 |
0 0 * * 1 |
매주 월요일 자정 | 주간 경쟁사 뉴스 리포트 |
Anthropic 공식 문서에 따르면 최소 실행 단위는 1분입니다. 초 단위 실행이 필요하다면 별도 스크립트를 연동해야 합니다. 또한 반복 태스크에는 지터(Jitter)가 적용됩니다. 주기의 최대 10%, 최대 15분 범위에서 실행 시간이 미세하게 달라지는데, 동일한 태스크는 항상 같은 오프셋이 적용되므로 예측 불가능한 지연은 아닙니다. 단, 정각 실행에 민감한 금융·거래 자동화에서는 이 점을 감안해야 합니다.
워크트리(Worktree): 메인 브랜치 지키는 비결
스케줄 자동화에서 가장 간과하기 쉬운 리스크가 있습니다. AI가 자동으로 코드를 수정하다가 메인 브랜치에 실수로 커밋할 수 있다는 점입니다. Claude Code 스케줄의 워크트리(Worktree) 기능은 이 문제를 해결합니다.
워크트리 토글을 켜면, 스케줄된 작업이 실행될 때마다 독립된 Git 워크트리가 새로 생성됩니다. AI가 모든 변경 사항을 별도 브랜치에서 수행하고, 완료 후 사람이 확인한 뒤 머지 여부를 결정합니다. 메인 브랜치에는 단 한 줄도 영향이 없습니다.
워크트리가 필수인 경우
-
1에러 로그 자동 수정 PR: 1시간마다 Sentry를 확인해 수정 가능한 버그를 PR로 올리는 작업. 워크트리 없이 실행하면 메인에 직접 커밋될 위험이 있습니다.
-
2자동 코드 리뷰 반영: PR 리뷰 코멘트를 읽고 자동으로 코드를 수정하는 시나리오. 사람의 최종 승인 전에 메인에 닿지 않아야 안전합니다.
-
3데이터 스크래핑 후 파일 생성: 주식 종가 데이터를 크롤링해 분석 파일을 저장하는 경우. 독립 워크트리에 결과물이 쌓이므로 원본 프로젝트는 항상 깨끗합니다.
실전 자동화 시나리오 5가지
개념을 알아도 실제로 어떻게 쓸지 막막한 경우가 많습니다. 현업에서 바로 복사해서 쓸 수 있는 5가지 시나리오를 정리했습니다.
시나리오 1. 배포 파이프라인 모니터링 (/loop)
개발자가 가장 자주 겪는 컨텍스트 스위칭 낭비는 ‘배포 상태 확인’입니다. 다른 작업 중에 Vercel이나 CI/CD 대시보드를 열어 상태를 확인하는 것 자체가 흐름을 끊습니다.
시나리오 2. 에러 로그 주기 확인 (/loop + MCP)
Sentry, Postgres, Google Analytics 등 서비스가 MCP 서버로 연결되어 있다면 훨씬 강력합니다. 에러를 가져와서 수정 가능한 이슈를 자동으로 정리해 줍니다.
시나리오 3. 매일 오전 8시 업무 브리핑 (/schedule)
출근 전에 슬랙 요약, 오늘 할 일 우선순위, 팀 현황이 마크다운 파일로 자동 생성됩니다. 구글 캘린더, Jira, Slack MCP 커넥터와 연결하면 모든 채널을 한 번에 통합합니다.
# 빈도: Daily, 시간: 오전 8시
매일 아침 슬랙 #general 어젯밤 대화 요약 + 오늘 우선순위 3가지 정리해서 데스크탑에 마크다운으로 저장해줘
시나리오 4. 주식 종가 자동 분석 (/schedule + 크론잡)
평일 오후 3시 30분, 주식 장 마감 직후에 자동 실행됩니다. 크론 표현식 30 15 * * 1-5을 직접 입력하거나, “평일 오후 3시 30분”이라고 말해도 됩니다.
# 크론: 30 15 * * 1-5
관심 종목 10개 종가 데이터 수집하고 변동률 분석 리포트 생성해서 저장해줘
시나리오 5. PR 자동 모니터링 및 코멘트 반영 (/schedule + 워크트리)
Anthropic 개발자 Boris Cherny가 직접 공개한 활용 사례입니다. PR 리뷰 코멘트를 주기적으로 확인하고, 수정 가능한 항목을 자동으로 반영한 후 다음 날 아침 요약을 전송합니다. 워크트리를 반드시 활성화해야 메인 브랜치에 영향 없이 작동합니다.
놓치면 낭패: 제한 사항 & 주의점 총정리
Claude Code 스케줄은 강력하지만, 몇 가지 중요한 제약이 있습니다. 이를 모르고 도입하면 예상치 못한 상황이 생깁니다. Anthropic 공식 문서 기준으로 정리했습니다.
| 항목 | 내용 | 실무 의미 |
|---|---|---|
| 실행 조건 | Claude Code 실행 중 + 유휴 상태일 때 | 다른 작업 처리 중이면 대기 |
| 최대 태스크 | 세션당 50개 | 웬만한 개인 사용은 충분 |
| 자동 만료 | 생성 후 최대 3일 | 장기 실행은 재등록 필요 |
| 최소 단위 | 1분 (초 단위 불가) | 초 단위는 별도 스크립트 필요 |
| 놓친 실행 | 복구 없음, 다음 주기 대기 | 컴퓨터 꺼지면 해당 회차 건너뜀 |
| /loop 복원 | 재시작 후 복원 불가 | 세션 종료 시 재등록 필요 |
| 잠자기 모드 | 건너뜀, 재시작 후 자동 실행 | 24시간 무중단은 별도 서버 필요 |
| 필요 플랜 | Pro, Max, Team, Enterprise | 무료 플랜 미지원 |
스케줄러 전체 비활성화 방법
보안 이슈나 성능 문제로 스케줄 기능을 완전히 끄고 싶을 때는 환경변수를 설정하면 됩니다.
export CLAUDE_CODE_DISABLE_CRON=1
이 기능이 적합하지 않은 경우
솔직히 말하면, 이미 n8n이나 Zapier 같은 전문 워크플로우 자동화 도구를 사용 중이라면 복잡한 장기 실행 작업은 그쪽에서 계속 돌리는 게 더 안정적입니다. Claude Code 스케줄의 진가는 코딩 작업과 직접 연관된 자동화, 그리고 현재 진행 중인 개발 세션과 연동된 모니터링에서 발휘됩니다. 코딩 컨텍스트와 무관한 범용 알림이나 비개발 업무 자동화라면 기존 도구가 더 유리할 수 있습니다.
❓ Q&A — Claude Code 스케줄 자주 묻는 질문 5가지
Claude Code 스케줄은 무료로 사용할 수 있나요?
컴퓨터를 끄면 스케줄이 날아가나요?
/schedule로 등록한 영구 스케줄은 컴퓨터를 재시작해도 삭제되지 않습니다. 다만 컴퓨터가 꺼진 동안은 실행되지 않고, 앱을 다시 열면 자동으로 재개됩니다. 반면 /loop로 등록한 세션 스코프 반복 작업은 세션이 종료되면 함께 사라지므로, 재시작 후에는 다시 등록해야 합니다.
/schedule로 등록한 스케줄은 얼마나 오래 유지되나요?
한국어로 자연어 입력이 가능한가요?
30 15 * * 1-5)으로 변환해 등록해 줍니다. 영어 크론 문법을 외울 필요 없이 자연어 입력만으로 정밀한 스케줄 설정이 가능합니다.
스케줄 실행 중 Claude Code로 다른 작업을 하면 어떻게 되나요?
🏁 마치며 — 총평
Claude Code 스케줄은 2026년 AI 도구 패러다임 전환을 상징하는 기능입니다. 사람이 매번 명령을 입력해야 했던 시대에서, AI가 시간표를 갖고 자율적으로 일하는 시대로 넘어가고 있습니다. 배포 모니터링, 에러 추적, 주식 데이터 분석, 아침 브리핑 — 반복적으로 해왔던 이 작업들을 설정 한 번으로 위임할 수 있게 됐습니다.
다만 냉정하게 평가하면, 아직은 “완전 자율 가동”보다 “개발 컨텍스트 안에서의 자동화 보조”에 가깝습니다. 컴퓨터가 꺼지면 멈추고, 3일이 지나면 만료되는 제약은 기업 수준 운영 환경에서는 분명한 한계입니다. 개인 개발자나 소규모 팀에게는 충분히 강력하지만, 24시간 무중단이 필요한 프로덕션 자동화에는 추가 인프라가 필요합니다.
그럼에도 불구하고 지금 이 기능을 써야 하는 이유는 명확합니다. 경쟁 도구들이 검증한 수요를 Anthropic이 공식 기능으로 흡수했다는 것은, 앞으로 이 방향이 표준이 된다는 신호입니다. 지금 익혀두면 AI 자동화 흐름에서 앞서 나갈 수 있습니다. /loop 1m 배포 상태 확인해줘 — 이 한 줄부터 시작해 보시기 바랍니다.
※ 본 포스팅은 2026년 3월 11일 기준으로 작성되었으며, Anthropic의 공식 문서 및 업데이트 내용을 바탕으로 합니다. 기능 사양·요금제·플랜 지원 여부는 Anthropic의 정책 변경에 따라 달라질 수 있으므로, 최신 정보는 Anthropic 공식 문서에서 확인하시기 바랍니다. 본 포스팅은 유료 광고 및 제휴 관계가 없는 독립적 정보 제공을 목적으로 합니다.
댓글 남기기