[Claude Code] 스케줄링 자동화 사용방법 - /loop, cron, 리마인더로 작업 자동 반복하기

 

안녕하세요!

재아군의 관찰인생입니다.

 

오늘은 Claude Code의 강력한 기능 중 하나인 스케줄링 자동화에 대해 다뤄보겠습니다.

배포 상태를 5분마다 체크하거나, PR 리뷰를 20분 간격으로 반복하거나, 45분 후에 테스트 결과를 확인하는 리마인더를 설정하는 것까지 — Claude Code 세션 안에서 모든 것이 가능합니다.

이 글에서는 /loop 명령어, CronCreate 도구, 자연어 리마인더의 사용법을 실전 예시와 함께 정리했습니다.

 

이 글은 Claude Code v2.1.72 이상이 필요합니다. claude --version으로 버전을 확인하세요.

 

 

---

 

1. Claude Code 스케줄링이란 무엇인가?

 

핵심 정의

 

Claude Code 스케줄링은 세션 내에서 프롬프트를 자동으로 반복 실행하는 기능입니다. /loop 명령어나 cron 도구를 사용해 배포 모니터링, PR 감시, 빌드 체크, 리마인더 등을 자동화할 수 있습니다.

 

핵심은 "세션이 열려있는 동안 자동으로 작업을 반복 실행한다"는 것입니다. 터미널을 닫거나 세션을 종료하면 스케줄도 함께 사라집니다.

 

등장 배경 — 기존 방식의 4가지 문제

 

1. 수동 체크의 반복: 배포 후 "끝났나?" 하고 수동으로 상태를 확인하는 행위를 5분마다 반복해야 했습니다. 컨텍스트 스위칭 비용이 상당합니다.
2. 별도 스크립트 필요: watch, crontab, while 루프 등 별도의 셸 스크립트를 작성해야 했고, 결과를 해석하는 것도 개발자 몫이었습니다.
3. AI 세션과 분리: 모니터링 결과를 AI에게 다시 복사-붙여넣기하는 비효율이 존재했습니다. Claude가 직접 확인하고 판단하면 이 단계가 제거됩니다.
4. 리마인더 부재: "45분 후에 확인해야지" 하고 잊어버리는 경우가 빈번했습니다. 세션 내 리마인더가 이를 해결합니다.

 

---

 

2. 3가지 스케줄링 옵션 비교

 

Claude Code는 반복 작업을 스케줄링하는 3가지 방법을 제공합니다. 각각의 특성을 비교해보겠습니다.

 

항목	Cloud (클라우드)	Desktop (데스크톱)	/loop (세션)
실행 위치	Anthropic 클라우드	내 컴퓨터	내 컴퓨터
컴퓨터 켜짐 필요	아니오	예	예
세션 열림 필요	아니오	아니오	예
재시작 시 유지	예	예	아니오
로컬 파일 접근	아니오 (fresh clone)	예	예
MCP 서버	태스크별 커넥터	설정 파일 + 커넥터	세션에서 상속
최소 간격	1시간	1분	1분

 

선택 가이드: 컴퓨터 없이도 안정적으로 돌려야 한다면 Cloud, 로컬 파일과 도구에 접근해야 한다면 Desktop, 세션 중 빠르게 폴링하고 싶다면 /loop을 사용하세요.

 

 

---

 

3. /loop 명령어 — 가장 빠른 반복 스케줄링

 

/loop은 Claude Code의 번들 스킬로, 반복 프롬프트를 스케줄링하는 가장 빠른 방법입니다. 간격과 프롬프트를 전달하면 백그라운드에서 cron 작업이 설정됩니다.

 

3-1. 기본 사용법

 

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

 

Claude가 간격을 파싱하고, cron 표현식으로 변환한 뒤, 작업 ID와 함께 스케줄을 확인해줍니다.

 

3-2. 간격 지정 문법

 

간격은 선택사항이며, 앞에 놓거나 뒤에 놓거나 생략할 수 있습니다.

 

형태	예시	파싱 결과
앞에 간격	/loop 30m 빌드 확인해줘	30분마다
뒤에 every절	/loop 빌드 확인해줘 every 2 hours	2시간마다
간격 생략	/loop 빌드 확인해줘	기본 10분마다

 

지원 단위: s(초), m(분), h(시간), d(일). 초 단위는 cron의 1분 단위로 반올림됩니다. 7m이나 90m처럼 깔끔하게 나누어지지 않는 간격은 가장 가까운 정수 간격으로 라운딩되며, Claude가 실제 적용된 간격을 알려줍니다.

 

3-3. 다른 명령어를 반복 실행하기

 

스케줄된 프롬프트 자체가 다른 명령어나 스킬을 호출할 수 있습니다. 이미 만들어둔 워크플로우를 반복 실행할 때 유용합니다.

 

/loop 20m /review-pr 1234

 

이렇게 하면 20분마다 Claude가 /review-pr 1234를 직접 타이핑한 것처럼 실행합니다.

 

---

 

4. 실무 활용 가이드 — 리마인더와 작업 관리

 

4-1. 자연어 리마인더 설정

 

반복이 아닌 일회성 리마인더는 자연어로 설정할 수 있습니다. Claude가 cron 표현식으로 변환하고, 실행 후 자동 삭제됩니다.

 

# 특정 시간에 리마인더
오후 3시에 릴리즈 브랜치 푸시하라고 알려줘

# 상대 시간으로 리마인더
45분 후에 통합 테스트가 통과했는지 확인해줘

 

Claude가 발동 시간을 cron 표현식의 특정 분과 시로 고정하고, 언제 실행될지 확인해줍니다.

 

4-2. 스케줄된 작업 관리하기

 

자연어로 작업을 조회하거나 취소할 수 있습니다.

 

# 현재 스케줄된 작업 목록 확인
스케줄된 작업 뭐 있어?

# 특정 작업 취소
배포 체크 작업 취소해줘

 

내부적으로 Claude는 다음 3가지 도구를 사용합니다.

 

도구	용도
CronCreate	새 작업 스케줄링. 5필드 cron 표현식, 실행할 프롬프트, 반복/일회 여부를 지정
CronList	모든 스케줄된 작업의 ID, 스케줄, 프롬프트를 조회
CronDelete	작업 ID로 취소. 각 작업은 8자 ID를 가짐

 

한 세션에서 최대 50개까지 스케줄된 작업을 유지할 수 있습니다.

 

4-3. 실전 시나리오 4가지

 

시나리오	명령어	설명
배포 모니터링	/loop 5m 배포 상태 확인	5분마다 배포 완료 여부 체크
PR 리뷰 감시	/loop 20m /review-pr 1234	20분마다 PR에 새 커밋 확인 후 리뷰
빌드 체크	/loop 10m CI 빌드 결과 확인	장시간 빌드의 상태를 주기적으로 폴링
릴리즈 리마인더	오후 3시에 릴리즈 태그 달라고 알려줘	일회성 리마인더 후 자동 삭제

 

 

---

 

5. 기술 아키텍처 — 스케줄링 동작 원리

 

Claude Code 스케줄러의 내부 동작 원리를 이해하면 더 효과적으로 활용할 수 있습니다.

 

5-1. 실행 타이밍

 

• 스케줄러는 매 초마다 실행 대상 작업을 확인합니다.
• 스케줄된 프롬프트는 사용자 턴 사이에 실행됩니다. Claude가 응답 중일 때는 발동하지 않습니다.
• Claude가 긴 작업 중이면, 작업이 예정 시간을 지나도 현재 턴이 끝난 후 한 번만 실행됩니다.
• 모든 시간은 로컬 타임존으로 해석됩니다. 0 9 * * *은 UTC가 아니라 사용자 컴퓨터의 오전 9시입니다.

 

5-2. 지터(Jitter) — 실행 시간 분산

 

모든 세션이 동일한 시각에 API를 호출하는 것을 방지하기 위해, 스케줄러는 결정적(deterministic) 오프셋을 추가합니다.

 

• 반복 작업: 주기의 10%까지 늦게 실행되며, 최대 15분 캡. 1시간 간격 작업은 :00~:06 사이에 발동할 수 있습니다.
• 일회성 작업: 정시(:00)나 반(:30)으로 설정된 경우 최대 90초 일찍 실행될 수 있습니다.
• 오프셋은 작업 ID에서 파생되므로, 같은 작업은 항상 같은 오프셋을 갖습니다.

 

팁: 정확한 타이밍이 중요하다면 :00이나 :30 대신 3 9 * * *처럼 특정 분을 지정하세요. 일회성 지터가 적용되지 않습니다.

 

5-3. 3일 자동 만료

 

반복 작업은 생성 후 3일이 지나면 자동으로 만료됩니다. 마지막 한 번 실행된 후 스스로 삭제됩니다. 잊힌 루프가 무한정 실행되는 것을 방지하는 안전장치입니다.

3일 이상 지속되어야 하는 반복 작업이라면 만료 전에 취소 후 재생성하거나, Cloud/Desktop 스케줄링을 사용하세요.

 

---

 

6. Cron 표현식 레퍼런스

 

CronCreate는 표준 5필드 cron 표현식을 사용합니다: 분 시 일 월 요일. 모든 필드에서 와일드카드(*), 단일값(5), 스텝(*/15), 범위(1-5), 쉼표 목록(1,15,30)을 지원합니다.

 

표현식	의미
*/5 * * * *	5분마다
0 * * * *	매시 정각
7 * * * *	매시 7분
0 9 * * *	매일 오전 9시
0 9 * * 1-5	평일 오전 9시
30 14 15 3 *	3월 15일 오후 2:30

 

요일은 0 또는 7이 일요일, 6이 토요일입니다. L, W, ? 같은 확장 문법이나 MON, JAN 같은 이름 별칭은 지원되지 않습니다.

일(day-of-month)과 요일(day-of-week)이 동시에 제약되면, 둘 중 하나만 맞아도 매칭됩니다. 이는 표준 vixie-cron 시맨틱을 따릅니다.

 

 

---

 

7. 제한사항 & 주의사항

 

세션 스코프 스케줄링의 본질적인 제약사항을 알아두어야 합니다.

 

• 세션 종속: Claude Code가 실행 중이고 유휴 상태일 때만 작업이 발동됩니다. 터미널을 닫거나 세션을 종료하면 모든 작업이 취소됩니다.
• 놓친 실행 미보정: Claude가 긴 요청을 처리하는 동안 예정 시간이 지나면, 유휴 상태가 된 후 한 번만 실행됩니다. 놓친 간격만큼 여러 번 실행되지 않습니다.
• 재시작 시 초기화: Claude Code를 재시작하면 모든 세션 스코프 작업이 삭제됩니다.
• 3일 자동 만료: 반복 작업은 생성 후 3일이 지나면 마지막 실행 후 자동 삭제됩니다.

 

무인 자동화가 필요하다면?

 

세션 없이 독립적으로 실행되어야 하는 자동화 작업이라면 다음 대안을 고려하세요.

 

• Cloud 스케줄 태스크: Anthropic 관리형 인프라에서 실행. 컴퓨터가 꺼져있어도 동작
• Desktop 스케줄 태스크: 로컬에서 실행되지만 세션 열림 불필요. 파일 접근 가능
• GitHub Actions: CI의 schedule 트리거를 활용한 cron 기반 자동화

 

스케줄링 비활성화

 

환경변수 CLAUDE_CODE_DISABLE_CRON=1을 설정하면 스케줄러가 완전히 비활성화됩니다. cron 도구와 /loop을 사용할 수 없게 되며, 이미 스케줄된 작업도 실행되지 않습니다.

 

---

 

마무리

 

오늘은 Claude Code의 스케줄링 자동화 기능을 깊이 있게 살펴보았습니다.

 

• /loop 명령어로 세션 내 반복 작업을 빠르게 설정할 수 있습니다.
• 자연어 리마인더로 일회성 알림을 간단하게 설정할 수 있습니다.
• Cloud, Desktop, /loop 세 가지 옵션을 상황에 맞게 선택하면 됩니다.
• 3일 자동 만료와 세션 종속이라는 제한사항을 반드시 이해하고 사용해야 합니다.

 

배포 모니터링, PR 리뷰 감시, 빌드 체크처럼 반복적인 확인 작업을 Claude Code에게 맡기면, 개발자는 핵심 코딩에 더 집중할 수 있습니다.

 

클로드 코드에 관심있으시다면? 다른 글도 살펴보세요.

 

2026.03.25 - [개발&프로그래밍] - [Claude Code Auto Mode 퍼미션] 실전 튜토리얼 — 처음부터 배포까지

[Claude Code Auto Mode 퍼미션] 실전 튜토리얼 — 처음부터 배포까지

 

2026.03.25 - [개발&프로그래밍] - [Claude Computer Use] 심층 분석 — 아키텍처와 실전 활용

[Claude Computer Use] 심층 분석 — 아키텍처와 실전 활용

 

  

2026.03.25 - [AI 트렌드&뉴스] - [Claude Code Channels] 텔레그램·디스코드로 AI 코딩 에이전트 원격 제어 — 설치부터 실전 활용까지

[Claude Code Channels] 텔레그램·디스코드로 AI 코딩 에이전트 원격 제어 — 설치부터 실전 활용까지

 

2026.03.19 - [개발&프로그래밍] - [Claude Code] 풀스택 앱 만들기 실전 가이드 — AI 페어 프로그래밍 실전 경험기

[Claude Code] 풀스택 앱 만들기 실전 가이드 — AI 페어 프로그래밍 실전 경험기

2026.03.18 - [개발&프로그래밍] - [Claude Code] API 요청 실패 시 Claude Status 체크하는 법

[Claude Code] API 요청 실패 시 Claude Status 체크하는 법

 

 

 

 

 

 

 

 

 

이 글이 도움이 되셨다면 댓글과 공유 부탁드립니다. Claude Code 관련 궁금한 점이 있다면 언제든 댓글로 남겨주세요!

 

다음 글에서 더 깊이 있는 Claude Code 활용법으로 찾아뵙겠습니다. 감사합니다!