Claude Code /loop 명령어

Claude Code에 내장된 세션 내 스케줄러 슬래시 커맨드.

기본 개념

/loop는 Claude Code에 번들된 skill로, 반복 프롬프트를 백그라운드에서 자동 발사되도록 스케줄하는 명령. interval과 작업 설명을 넘기면 Claude가 그걸 cron 표현식으로 변환하고, job ID와 함께 cadence를 확인해줌.

/loop <interval> <prompt>

사용법

기본 형태

/loop 5m check the deploy status and alert me if anything looks off
/loop 30m monitor Slack and Gmail, surface anything urgent
/loop 1h run pnpm test and summarize failures

interval 생략 interval은 옵션. 생략하면 기본 10분 간격으로 동작.

/loop check git status and summarize any new commits

Cron 표현식 --cron 플래그는 5필드 표준 cron 표현식을 받음 (특정 시각, 요일 등). 일부 버전은 --times 인자로 N회 실행 후 종료시킬 수 있음 — 무한 반복이 아니라 정해진 횟수만 자동화하고 싶을 때 유용.

기존 슬래시 커맨드/스킬 호출 스케줄될 프롬프트 자체가 다른 슬래시 커맨드나 skill 호출이 될 수 있음 — 이미 패키징해 둔 워크플로를 재실행시키는 데 유용.

/loop 1h /code-review

동작 원리

tick이 발생할 때마다 Claude Code가 그 프롬프트를 사용자가 직접 입력한 것처럼 발사함. 현재 프로젝트 컨텍스트에서 실행되고, 권한 받은 도구를 사용해서 출력을 만들거나 로깅함. 내부적으로 시간 기반 실행 패턴을 등록하는 구조라서 "cron job을 만든다"는 표현이 정확함.

⚠️ 핵심 제약: 세션 바인딩

/loop은 OS가 아니라 Claude Code 프로세스 안에서 관리됨. 세션이 살아있으면 루프가 돈다. 터미널을 닫으면 세션이 끝나고 루프도 멈춤. process-bound이지 system-bound가 아님.

즉:

• 노트북 닫으면 끝
• SSH 세션 끊기면 끝
• 새벽 3시에 자동으로 도는 cron 대체재가 아님

/schedule과의 차이 (영구 자동화가 필요할 때)

/loop은 세션이 열려 있는 동안만 동작. 터미널을 닫으면 사라짐. /schedule은 세션이 활성화되어 있지 않아도 도는 영구 작업을 등록하는 명령. Desktop 작업(앱이 켜져 있는 동안 로컬에서 실행)과 Cloud 작업(Anthropic 서버에서 디바이스가 꺼져 있어도 실행) 두 종류가 있음.

실제 활용 예시

Claude Code 제작자 Boris Cherny는 여러 loop를 병렬로 돌림 — 코드 리뷰 코멘트 자동 처리, Slack 피드백 기반 PR 생성, stale PR 정리 등.

예시:

• /loop 10m DBSAFER 보안 솔루션 상태 체크하고 끊겼으면 알림 — 작업 중 폴링
• /loop 30m Flow 채팅방 lock contention 쿼리 모니터링하고 임계치 넘으면 보고 — 디버깅 세션 동안
• /loop 1h Ontner OAuth 관련 에러 로그 grep해서 새로운 패턴 있는지 — 배포 직후 감시
• /loop 5m staging 배포 결과 확인 — 배포 babysitting

⚠️ 참고: v2.1.71에서 cron 인프라는 동작하는데 /loop 슬래시 커맨드 자체가 미인식되는 버그 리포트가 있었음 — 피처 플래그나 등록 누락으로 추정. 또 CLAUDE_CODE_DISABLE_CRON=1 환경변수가 설정돼 있으면 스케줄러가 비활성화되어 /loop 자체가 동작 안 함.