[Claude Code #12] /loop, 반복 작업을 세션에 맡기는 법

“5분마다 배포 상태 확인해줘” 같은 일은 사람이 하기엔 지루한 데다 잊어버리기도 쉽습니다.

Claude Code의 /loop는 이런 반복을 세션에 맡기는 명령어입니다. 정해 둔 프롬프트를 간격마다 다시 실행해 줘요.

Claude Code 11편의 훅이 이벤트 자동화라면, /loop는 시간 자동화입니다.

세 가지 사용 형태

공식 스케줄 문서 기준으로, 무엇을 넘기느냐에 따라 동작이 갈립니다.

/loop 5m 배포 끝났는지 확인하고 결과 알려줘   ← 고정 간격
/loop 배포 끝났는지 확인해줘                  ← Claude가 간격 선택
/loop                                        ← 내장 유지보수 프롬프트

간격 단위는 s·m·h·d를 지원합니다. cron이 1분 단위라 초는 분으로 올림됩니다. 7m처럼 깔끔히 안 떨어지는 간격은 가까운 값으로 반올림돼요.

/loop 15m처럼 간격만 줘도 됩니다. 그 경우 내장 유지보수 프롬프트가 고정 간격으로 돌아요. 세션이 몰리지 않게 실제 발화는 간격의 절반까지 늦어질 수 있습니다.

간격을 Claude에게 맡기면

간격 없이 프롬프트만 주면 매 반복이 끝날 때마다 Claude가 다음 대기 시간을 정합니다. 1분에서 1시간 사이에서요.

빌드가 끝나 가면 짧게, PR이 조용해지면 길게 기다리는 식입니다. 고른 간격과 이유도 반복이 끝날 때마다 출력해 줘요.

작업이 끝났다고 판단하면 루프를 스스로 종료하기도 합니다.

빈 손으로 /loop만 치면

프롬프트를 생략하면 내장 유지보수 프롬프트가 돕니다. 순서는 이렇습니다.

• 대화에 남은 미완료 작업 이어 가기
• 현재 브랜치 PR 돌보기: 리뷰 코멘트, 실패한 CI, 충돌
• 할 게 없으면 버그 사냥·단순화 같은 정리 작업

작업을 끝내고 /loop만 걸어 두면 뒷정리를 맡아 주는 셈이죠.

이 기본 프롬프트는 .claude/loop.md 파일로 교체할 수 있습니다. 릴리스 브랜치 관리 같은 우리 팀만의 반복 루틴을 적어 두면 돼요.

멈추는 법과 수명

다음 반복을 기다리는 루프는 Esc로 멈춥니다. 다만 말로 걸어 둔 예약 작업은 Esc의 영향을 받지 않습니다. 지워 달라고 말해야 없어져요.

내버려 두면 반복 작업은 생성 7일 후 자동 만료됩니다. 잊힌 루프가 무한정 돌지 않게 하는 안전장치예요.

루프는 세션에 묶여 있어서 터미널을 닫으면 멈춥니다. 계속 돌리려면 /bg로 세션을 백그라운드에 넘기면 됩니다. 루프도 같이 넘어가요. --resume으로 세션을 재개하면 만료 전 루프도 복원됩니다.

한 번만 실행할 일은 말로

일회성 알림은 /loop 없이 자연어로 부탁하면 됩니다.

3시에 릴리스 브랜치 push하라고 알려줘
45분 뒤에 통합 테스트 통과했는지 확인해줘

한 번 실행되고 스스로 지워지는 예약 작업이 걸립니다.

컴퓨터를 꺼도 돌아야 한다면

/loop는 세션이 살아 있는 동안만 돕니다. 머신과 무관하게 돌아야 하는 일이라면 다른 선택지가 있어요.

• 클라우드 루틴: Anthropic 클라우드에서 실행, 내 컴퓨터 꺼져도 동작
• 데스크톱 예약 작업: 내 머신에서 세션 없이 실행, 로컬 파일 접근 가능
• /loop: 세션 안에서 빠른 폴링용

가볍게는 /loop, 본격적으로 돌려야 하면 위 두 가지로 옮기는 구도입니다.

정리

/loop는 “간격마다 다시 물어봐”를 세션에 걸어 두는 명령어입니다. 간격을 정해 줘도 되고, Claude가 상황 봐 가며 고르게 해도 됩니다.

7일 만료와 Esc 중단만 기억하면 부담 없이 걸어 둘 수 있어요.

다음 편에서는 웹 검색을 여러 갈래로 뻗어 보고서를 만들어 주는 /deep-research를 다룹니다.

출처 및 확인 기준

• Claude Code 공식 문서 — Run prompts on a schedule (Anthropic, 2026-08-14 확인)

이어서 읽기

Claude Code 시리즈

• 이전 편: [Claude Code #2] /plan 계획 모드, 수정 전에 설계부터 합의하기
• 이전 편: [Claude Code #1] /init, CLAUDE.md 자동 생성으로 시작하기

관련 주제

• [에이전트 설계 #1] 하네스 엔지니어링이란? 프롬프트 다음에 오는 것