쉽게 배우는 Claude Code ⑯ /loop — 일정 간격으로 반복 실행하기

배포가 끝났는지 5분마다 들여다보고, 로그가 잘 쌓이는지 한 번씩 확인하고… 이렇게 “같은 점검을 일정 간격으로 반복”하는 일은 의외로 자주 생깁니다. 그때마다 직접 명령을 다시 치는 건 번거롭죠. Claude Code의 /loop은 바로 이런 반복 점검을 대신 돌려 주는 명령어입니다.

이번 편에서는 /loop이 무엇이고, 언제 쓰면 좋은지, 그리고 비슷해 보이는 /goal과 어떻게 다른지를 정리해 보겠습니다.

---

한 줄로

/loop은 세션을 열어 둔 채 같은 프롬프트를 일정 간격으로 반복 실행하는 명령어입니다. 주기적인 점검(폴링)이나 자율적인 유지보수 점검에 씁니다.

---

언제 쓰나

“일정 간격으로 같은 일을 반복하고 싶을 때” 떠올리면 됩니다. 대표적인 상황 몇 가지를 보겠습니다.

① 배포가 끝났는지 주기적으로 확인하기

배포를 걸어 두고 끝나기를 기다리는 동안, 5분마다 상태를 확인하고 끝나면 알려 달라고 시킬 수 있습니다.

/loop 5m "배포 상태 확인하고 끝났으면 알려줘"

이러면 5분 주기로 같은 점검을 반복합니다. 직접 새로고침하듯 들여다볼 필요가 없어집니다.

② 긴 작업이 도는 동안 상태 점검하기

빌드나 데이터 처리처럼 오래 걸리는 작업이 돌아가는 동안, 주기적으로 진행 상황을 들여다보게 할 수 있습니다.

/loop 10m "지금 돌고 있는 작업 진행 상황 점검하고 이상하면 알려줘"

③ 반복적인 점검·정리 루틴

간격을 생략하면, 모델이 스스로 페이스를 정해 반복합니다. 정확히 몇 분마다일 필요는 없고 “한 번씩 알아서 살펴봐 주면 되는” 자율적인 유지보수 점검에 어울립니다.

/loop "열려 있는 PR들 상태 한 번씩 점검해줘"

---

어떻게

쓰는 모양은 간단합니다.

/loop [간격] [프롬프트]

• 간격을 주면 그 주기로 프롬프트를 반복합니다. 예: /loop 5m "배포 끝났는지 확인" → 5분마다 실행.
• 간격을 생략하면 모델이 스스로 페이스를 정해 반복합니다. 점검 대상의 변화 속도에 맞춰 알아서 간격을 잡습니다.

핵심은 세션이 열린 채로 같은 프롬프트가 계속 다시 실행된다는 점입니다. 한 번 실행하고 끝나는 게 아니라, 정해진 주기마다 같은 점검을 되풀이합니다.

---

팁 & 함정

/loop vs /goal — 무엇이 다른가

이 둘은 “반복 실행한다”는 점이 닮아서 헷갈리기 쉽습니다. 하지만 반복을 멈추는 기준이 완전히 다릅니다.

	/loop	/goal
반복 방식	정해진 간격으로 반복(스케줄)	목표를 만족할 때까지 반복(결과 지향)
멈추는 기준	사용자가 멈출 때까지 계속	목표가 달성되면 종료
어울리는 일	주기적 점검·폴링	”○○가 될 때까지” 같은 결과 만들기

한 문장으로 정리하면, /loop은 ‘정해진 간격으로 반복’이고 /goal은 ‘목표를 만족할 때까지 반복’입니다. “5분마다 들여다봐”는 /loop, “테스트가 다 통과할 때까지 고쳐”는 /goal에 가깝습니다.

함정: 간격을 너무 짧게 잡지 않기

폴링 간격을 너무 짧게 잡으면 바뀐 것도 없는데 계속 확인하느라 자원을 불필요하게 씁니다. 점검 대상이 바뀌는 속도에 맞춰 간격을 정하세요. 몇 분이면 끝날 배포라면 1분 간격이 과할 수 있고, 한참 걸리는 작업이라면 더 여유 있게 잡아도 됩니다.

---

한 장 정리

항목	내용
한 줄	같은 프롬프트를 일정 간격으로 반복 실행
형식	/loop [간격] [프롬프트]
간격 줄 때	그 주기로 반복 (예: 5m)
간격 생략 시	모델이 스스로 페이스를 정해 반복
잘 맞는 일	배포·작업 상태 폴링, 주기적 점검 루틴
/goal과 차이	/loop은 스케줄 기반, /goal은 목표 달성 시 종료
주의	간격을 너무 짧게 잡으면 자원 낭비

다음 편: /background·--bg — 오래 걸리는 일은 백그라운드로.