루프 엔지니어링 (/loop) 사용법

Claude Code의 /loop는 프롬프트나 슬래시 명령어를 일정 간격 또는 모델이 스스로 속도를 조절하며 반복 실행하게 해주는 기능입니다. 배포 상태 확인, 정기 점검, 장시간 자율 작업에 씁니다.

1. 언제 쓰나요

/loop는 "몇 분 간격으로 계속 확인/실행"이 필요한 작업에 적합합니다. 예: 배포가 끝날 때까지 폴링, PR 상태를 주기적으로 확인, 특정 조건이 될 때까지 점검 반복.

반대로 "완료 조건이 명확한 하나의 작업을 끝까지 밀어붙이기"는 아래 에이전트 오케스트레이션(랄프 모드) 쪽이 더 맞습니다.

$/loop 5m /check-deploy-status

간격(5m)을 생략하면 모델이 상황에 맞춰 스스로 다음 실행 시점을 정하는 "동적 모드"로 동작합니다.

$/loop 배포 로그를 확인하고 에러가 있으면 고쳐줘

루프는 별도로 멈추기 전까지 계속 도는 구조라, 프롬프트 안에 "언제 멈출지"를 분명히 적어두는 게 중요합니다. 예: "테스트가 전부 통과하면 멈춰줘", "배포 상태가 success가 되면 종료해줘".

너무 짧은 간격(1~4분)으로 자주 깨우면 매번 컨텍스트를 다시 읽어야 해서 비효율적이고, 5분을 살짝 넘기면 캐시가 만료돼 오히려 손해입니다. 실무적으로는 폴링성 작업은 60~270초, 여유 있는 점검은 20~30분 단위를 권장합니다.

더 이상 반복이 필요 없으면 대화창에 중단을 요청하면 됩니다. 루프는 세션에 종속되므로 세션을 닫아도 정지됩니다.