Claude Code Loop 기능 총정리 /loop, /goal, /batch 완벽 비교

📌 이 글의 핵심 요약

• Claude Code Loop는 반복 작업을 자동 스케줄링하는 네이티브 기능
• /loop, /goal, /batch 세 명령어의 역할 차이를 명확히 정리
• 실무 활용 패턴과 주의사항까지 한 번에 파악

📋 목차

1. Claude Code Loop란 무엇인가
2. /loop 명령어 기본 사용법
3. /goal, /batch와의 차이 비교
4. 실전 활용 패턴 4가지
5. 주의사항과 한계
6. 정리

Claude Code Loop란 무엇인가

Claude Code를 쓰다 보면 똑같은 작업을 손으로 반복하는 순간이 꼭 생긴다. 배포가 됐는지 5분마다 터미널을 열어 확인하거나, CI 결과를 기다리며 새로고침을 누르거나, 에러 로그를 주기적으로 스캔하는 일이 그렇다. Claude Code Loop는 이 반복을 없애기 위해 Anthropic이 2026년 3월 내장한 네이티브 자동화 기능이다.

이 기능의 뿌리는 개발자 커뮤니티의 'Ralph Wiggum 기법'이다. Geoffrey Huntley가 2025년에 bash 무한 루프로 Claude Code에 같은 프롬프트를 계속 주입하는 방식을 고안했고, 이게 실제로 생산성을 끌어올린다는 사례가 쌓이자 Anthropic이 이를 제품 안에 공식 기능으로 통합했다. 커뮤니티의 실험이 네이티브 명령어로 흡수된 케이스다.

핵심은 간단하다. 사용자가 반복할 작업과 간격을 지정하면 Claude가 내부적으로 cron 표현식을 생성해 자동 실행한다. 세션이 열려 있는 동안 사용자 개입 없이 작업이 계속 돌아간다.

---

/loop 명령어 기본 사용법

/loop는 세션 안에서 프롬프트를 지정 간격으로 반복 실행하는 명령어다. 문법은 직관적이다.

📌 기본 문법과 동작 규칙

형식: /loop [간격] [작업 설명]

간격 생략 시: 기본값 10분 자동 적용
자연어 지원: 5m, 1h, 2 hours 등 형식 모두 인식
최소 간격: 1분 (API 비용 폭증 방지 안전장치)
실행 범위: 현재 세션이 열려 있는 동안만 동작

명령을 실행하면 Claude가 cron 표현식으로 변환하고 8자리 Job ID를 발급한다. 이후 지정 간격마다 작업이 자동 처리된다. Anthropic은 API 부하 분산을 위해 최대 10% 랜덤 지터를 추가한다. 10분 루프라면 실제로는 9분 12초 또는 11분 3초에 실행될 수 있다.

💡 비용 주의

1분 간격으로 8시간 루프를 돌리면 API 호출이 480회 발생한다. 처음에는 넉넉한 간격으로 시작하고 필요에 따라 줄여나가는 것이 현명하다.

---

/goal, /batch와의 차이 비교

Claude Code Loop 기능은 /loop 하나만이 아니다. /goal과 /batch까지 함께 이해해야 상황에 맞는 선택이 가능하다.

명령어	동작 방식	종료 조건	주요 용도
/loop	지정 간격 자동 반복	세션 종료·수동 중단	모니터링, 상태 주기 체크
/goal	조건 충족까지 매 턴 실행	별도 평가 모델이 완료 판단	테스트 통과, 린트 클린까지 자율 실행
/batch	병렬 worktree 에이전트 분산	각 에이전트 작업 완료 시	대규모 리팩토링, 다수 파일 동시 변경

/loop와 /goal의 핵심 차이는 종료를 누가 판단하느냐에 있다. /loop는 Claude 자신이 매 턴 결과를 판단하고, /goal은 별도의 소형 고속 모델이 트랜스크립트를 독립적으로 읽어 완료 여부를 결정한다. 작업을 수행한 에이전트가 스스로 채점하지 않는다는 점이 /goal의 핵심이다.

---

실전 활용 패턴 4가지

① 배포 상태 자동 모니터링

5분마다 스테이징 서버 응답 여부와 HTTP 상태 코드를 확인한다. 배포가 완료되는 순간 알림을 받을 수 있어 터미널을 계속 들여다볼 필요가 없다.

② PR 자동 리뷰 및 CI 상태 감시

오픈된 PR의 CI 결과를 20분마다 체크하고 실패 시 원인과 함께 보고한다. 시간대가 다른 팀과 협업할 때 특히 유용하다. 이미 만들어둔 스킬이나 슬래시 명령과 조합하면 효과가 배가된다.

③ 에러 로그 스캔 및 자동 PR 생성

2시간마다 앱 로그에서 치명적 에러를 스캔하고 수정 가능한 항목이 있으면 PR을 자동으로 생성한다. MCP 도구와 연결하면 코드 수정까지 자율 처리할 수 있다. Claude Code Loop 기능 중 가장 자율적인 패턴이다.

④ /goal로 테스트 통과까지 완전 자율 실행

테스트가 모두 통과하고 린트 오류가 없는 상태가 될 때까지 Claude가 코드를 스스로 수정하고 재검증한다. 사용자가 자리를 비워도 작업이 진행된다. /loop와 /goal의 조합이 진정한 자율 실행을 만든다.

---

주의사항과 한계

⚠️ 세션 종속성 — 터미널 닫으면 루프 멈춘다

/loop는 현재 Claude Code 세션에 종속된다. 터미널을 닫거나 세션이 끊기면 모든 루프가 즉시 중단된다. 재부팅 후에도 루프를 유지하려면 외부 스케줄러가 필요하다.

✅ 외부 스케줄러가 필요한 경우

노트북을 닫아도 작업이 계속 돌아야 하거나, 재부팅 후에도 자동 실행이 유지돼야 하거나, 프로덕션 등급 안정성이 필요하다면 시스템 cron, GitHub Actions, Windows Task Scheduler를 함께 사용하는 것이 맞다. /loop는 세션 내 경량 자동화에 적합하다.

---

정리

✅ 핵심 정리

Claude Code Loop는 반복 작업의 수동 트리거를 없애는 네이티브 자동화 기능이다. /loop는 주기적 모니터링, /goal은 조건 충족까지 자율 실행, /batch는 병렬 대규모 처리로 역할이 나뉜다.

세션이 닫히면 루프도 멈춘다는 한계는 분명하다. 영속성이 필요한 작업은 외부 스케줄러와 병행하는 구조가 현실적이다. 처음에는 단순한 배포 모니터링 루프 하나부터 시작해 점차 워크플로우에 맞게 확장해 나가는 것을 추천한다.