---
title: "Claude Code /loop 명령어"
description: "Claude Code에 내장된 세션 내 스케줄러 슬래시 커맨드. 기본 개념 는 Claude Code에 번들된 skill로, 반복 프롬프트를 백그라운드에서 자동 발사되도록 스케줄하는 명령. interval과 작업 설명을 넘기면 Claude가 그걸…"
date: 2026-05-03
updated: 2026-05-03T12:37:14.825Z
tags: [claude, claude code, loop, 클로드]
canonical: https://blog.wooncloud.com/posts/3
---

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

## 기본 개념

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

```bash
/loop <interval> <prompt>
```

## 사용법

**기본 형태**
```bash
/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분 간격으로 동작.
```bash
/loop check git status and summarize any new commits
```

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

**기존 슬래시 커맨드/스킬 호출**
스케줄될 프롬프트 자체가 다른 슬래시 커맨드나 skill 호출이 될 수 있음 — 이미 패키징해 둔 워크플로를 재실행시키는 데 유용.
```bash
/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 서버에서 디바이스가 꺼져 있어도 실행) 두 종류가 있음.

| | `/loop` | `/schedule` (Desktop) | `/schedule` (Cloud) | GitHub Actions |
|---|---|---|---|---|
| 실행 위치 | 현재 세션 | 로컬 머신 | Anthropic 서버 | GitHub runner |
| 세션 종료 시 | ❌ 멈춤 | ✅ (앱 켜져 있으면) | ✅ | ✅ |
| 머신 꺼짐 시 | ❌ | ❌ | ✅ | ✅ |
| 팀 공유 | ❌ | ❌ | ❌ | ✅ |

## 실제 활용 예시

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` 자체가 동작 안 함.