세 가지 방식, 먼저 전체 그림을 보세요

Claude Code의 스케줄링은 한 가지가 아닙니다. Cloud, Desktop, /loop — 이름만 다른 게 아니라 실행 환경과 지속성이 완전히 달라서, 잘못 고르면 정각에 실행되길 기대했다가 세션 종료와 함께 사라지는 일이 생깁니다. 공식 문서(출처: code.claude.com/docs/ko/scheduled-tasks)에 딱 이렇게 나와 있습니다.

한 줄 정리: 노트북 끄고 싶다 → Cloud. 로컬 파일 건드려야 한다 → Desktop. 지금 세션에서 잠깐 반복 → /loop.

▲ 목차로 돌아가기

Cloud(/schedule) — 진짜로 꺼도 되는 방식

터미널에서 /schedule 한 줄이면 Anthropic 서버에 크론잡이 등록됩니다. 내 노트북 상태와 완전히 무관합니다. Anthropic 내부에서 직접 이 방식을 쓴다고 밝혔는데, CI가 실패하면 Claude가 자동으로 원인을 분석하고 수정 PR을 만드는 워크플로가 대표 사례입니다. (출처: 공식 문서 — Cloud Scheduled Tasks)

CLI에서 만드는 법

# 대화형 생성
/schedule
# 설명과 함께 한 줄로 생성
/schedule daily PR review at 9am
# 목록 확인
/schedule list
# 즉시 실행 (테스트용)
/schedule run

빈도는 Hourly(매시간), Daily(매일), Weekdays(평일), Weekly(주 1회) 중 선택합니다. 웹에서는 claude.ai/code/scheduled에서 “New scheduled task”를 클릭해도 됩니다.

Anthropic 엔지니어 @noahzweben이 X에서 공개한 사례가 인상적입니다 — 활발히 개발 중인 Python 라이브러리와 동기화되는 Go 라이브러리를 Claude 스케줄 잡이 자동으로 유지보수합니다. 보통 이런 포팅 작업은 인력이 상당히 드는데, 스케줄 잡 하나로 두 언어 라이브러리를 동시에 관리합니다.

▲ 목차로 돌아가기

Desktop — 로컬 파일을 만져야 할 때

Cloud가 안 되는 걸 Desktop이 합니다 — 로컬 파일 직접 읽기·쓰기. 다만 조건이 있습니다. Claude Desktop 앱이 열려 있어야 실행됩니다. 노트북 덮개를 닫거나 앱을 종료하면 그 시간의 실행은 건너뜁니다. (출처: 공식 문서 — Desktop Scheduled Tasks)

놓친 실행은 최근 1회만 캐치업됩니다

앱이 닫혀 있는 동안 여러 번 실행이 밀렸어도, 다시 앱을 열면 최근 7일 내 놓친 실행 중 가장 마지막 1회만 자동으로 실행됩니다. 3번 놓쳤어도 1번만 처리됩니다. 이 부분이 생각과 다를 수 있습니다.

uncommitted 변경사항도 봅니다

Desktop 로컬 태스크는 현재 워킹 디렉토리 상태를 그대로 사용합니다. 커밋되지 않은 파일도 포함됩니다. 작업 중인 코드에 태스크가 영향을 주지 않도록 하려면 태스크 생성 시 워크트리 격리를 켜는 것을 권장합니다. Cloud가 fresh clone이라서 안전한 것과 반대 구조입니다. 용도에 맞게 선택해야 하는 이유가 여기에 있습니다.

▲ 목차로 돌아가기

/loop — 지금 세션에서만 쓰는 반복기

/loop는 가장 가볍고 빠르게 반복 실행을 설정할 수 있습니다. 현재 열린 터미널 세션 안에서만 동작하며, 세션을 닫으면 전부 사라집니다.

# 5분마다 배포 상태 확인
/loop 5m check if the deployment finished
# 2시간마다 빌드 체크 (자연어)
/loop check the build every 2 hours
# 간격 생략 시 기본 10분
/loop check the build
# 일회성 리마인더
in 45 minutes, check whether the integration tests passed

/loop에서 꼭 알아야 할 제약 3가지

공식 문서에 나와 있지만 많이들 지나치는 부분들입니다. (출처: code.claude.com/docs/ko/scheduled-tasks)

cron 표현식도 쓸 수 있습니다

/loop 내부는 CronCreate, CronList, CronDelete 도구를 통해 표준 5필드 cron 표현식을 지원합니다. 단, L, W, MON, JAN 같은 확장 구문은 지원하지 않습니다. 시간대 기준은 UTC이므로, 한국 시간 오전 9시에 실행하려면 cron에 0 0 * * *(UTC 0시)로 설정해야 합니다.

▲ 목차로 돌아가기

비용이 생각보다 빠르게 쌓이는 이유

공식 문서에 “평균 하루 $6″라고 적혀 있습니다. 이 수치를 그대로 믿으면 안 됩니다.

스케줄 자동화와 비용이 만나는 지점

스케줄 태스크는 매 실행마다 토큰을 소비합니다. 특히 Agent teams 기능과 조합하면 주의가 필요합니다. 공식 문서에 직접 나와 있습니다 — “Agent teams는 plan 모드에서 표준 세션 대비 약 7배 더 많은 토큰을 사용합니다. 각 팀원이 독자적인 컨텍스트 윈도우를 유지하고 별도 Claude 인스턴스로 실행되기 때문입니다.” (출처: code.claude.com/docs/en/costs) 매시간 스케줄 잡을 agent teams로 돌리면 하루 24회 × 7배 비용이 쌓입니다.

💰 비용 관리 팁: /cost 명령어로 현재 세션 토큰 소비량을 확인하고, 스케줄 잡에는 Opus 대신 Sonnet을 기본으로 사용하세요. Haiku는 단순 조회·알림 작업에 적합합니다. (출처: 공식 문서 — costs)

▲ 목차로 돌아가기

비개발자도 쓸 수 있는 실전 프롬프트 4가지

/schedule의 프롬프트는 자연어입니다. 터미널이 익숙하지 않다면 Desktop 앱 사이드바 Schedule 메뉴에서 UI로 만들면 됩니다. 한국어 지시도 그대로 따릅니다.

오늘 날짜를 확인하고, ~/projects/my-app 폴더에서
어제 하루 Git 커밋 로그를 조회하라.
커밋 메시지를 바탕으로 업무 일지를 작성해
~/Documents/daily-log.md 파일에 추가하라.

GitHub Actions 실패 여부를 확인하라.
실패한 테스트가 있으면 원인을 분석하고
수정을 적용한 뒤 claude/ci-fix 브랜치에 PR을 열어라.

어제 오후 6시부터 지금까지 Gmail 미확인 메일을 확인하라.
발신자·핵심 내용·액션 필요 여부를 1~2줄로 요약하고
중요도 순으로 정리해 ~/Documents/inbox-summary.md에 저장하라.
뉴스레터·자동발송 알림은 제외하라.

/loop 5m staging 배포가 완료됐는지 확인하라.
성공이면 알려줘. 실패하면 에러 로그를 보여줘.

📌 처음 시작할 때는 “Manual” 주기로 만들고 “Run now”를 눌러 결과를 먼저 확인한 뒤, 자동 반복으로 전환하는 것이 안전합니다.

▲ 목차로 돌아가기

Q&A — 자주 묻는 것들

▲ 목차로 돌아가기

마치며 — 직접 써본 소감

솔직히 말하면, “꺼도 일한다”는 문구에 기대치가 올라가서 막상 Desktop 태스크를 처음 써보면 “앱은 켜놔야 한다고?”에서 한 번 멈추게 됩니다. 세 가지 방식을 처음부터 비교표로 보고 시작했다면 덜 헷갈렸을 겁니다.

기능 자체는 강력합니다. Anthropic이 내부적으로 CI 자동화와 다국어 라이브러리 유지보수에 직접 쓰고 있다는 것이 그냥 마케팅 문구가 아니라는 걸 공식 발표문에서 확인했습니다. 비개발자도 자연어 프롬프트 하나로 매일 아침 받은 편지함 요약이나 업무 일지 자동화를 실제로 구성할 수 있습니다.

비용 부분은 조금 더 주의가 필요합니다. 공식 “$6/일”은 실사용 API 비용이 아니라 Max 플랜 월정액의 역산값에 가깝고, Agent teams 조합 시 토큰이 7배 늘어난다는 점은 스케줄 잡 설계 전에 반드시 고려해야 합니다.

세 방식 중 어디서 시작할지 모르겠다면 — Cloud /schedule로 PR 리뷰 자동화 하나를 만들고 “Run now”로 먼저 테스트해보는 것을 권합니다. 생각보다 간단합니다.

▲ 목차로 돌아가기

📎 본 포스팅 참고 자료

1. Claude Code 공식 문서 — 일정에 따라 프롬프트 실행하기 (/loop)
2. Claude Code 공식 문서 — Cloud Scheduled Tasks (/schedule)
3. Claude Code 공식 문서 — Manage costs effectively
4. r/ClaudeCode — “$6 per developer per day” 토론 (2026.02.27)