Claude Code /loop 명령어 탄생기: 염소 농장 5줄 Bash에서 공식 기능까지
2026년 3월 7일, Anthropic이 Claude Code에 /loop 명령어를 공식 출시했습니다. 5분마다 배포 상태를 확인하고, 에러 로그를 자동으로 분석하고, 버그를 발견하면 자동으로 PR을 만드는 스케줄링 기능입니다. 이 기능의 뿌리를 추적하면, 호주 시골 염소 농장의 5줄짜리 Bash 스크립트에 도달합니다.
TL;DR
- 2025년 여름: 호주 개발자 Geoffrey Huntley가 5줄 Bash 스크립트 "Ralph Loop" 공개
- 2025년 12월: Anthropic이 공식 플러그인으로 채택 (Stop Hook 패턴)
- 2026년 3월 7일:
/loop명령어로 Claude Code에 내장 - 핵심 철학: "반복이 완벽을 이긴다" — AI 실패를 다음 입력으로 재활용
- 사용법:
/loop 5m check if the deployment finished한 줄이면 끝
원조: Geoffrey Huntley의 Ralph Loop
2025년 여름, 호주 시골 염소 농장에서 소프트웨어 개발자 Geoffrey Huntley가 5줄짜리 Bash 스크립트를 공개했습니다.
while :; do cat PROMPT.md | claude ; done
단순한 무한 루프입니다. AI의 출력(실패, 스택 트레이스, 할루시네이션 포함)을 그대로 다음 입력으로 넣는 구조입니다. Huntley는 이것을 "Context Engineering"이라고 불렀습니다.
AI 코딩 도구의 가장 큰 병목은 "사람이 매번 에러를 확인하고 다시 프롬프트를 입력해야 하는 것"이었습니다. Huntley는 이 병목을 제거했습니다. AI가 실패하면 그 실패를 다시 AI한테 넣고, 또 실패하면 또 넣는 구조입니다. 반복이 완벽을 대체하는 거죠.
이 스크립트의 이름은 Ralph — 심슨 가족의 Ralph Wiggum에서 따왔습니다. "영원히 혼란스럽고, 항상 실수하지만, 절대 멈추지 않는" 캐릭터입니다.
Ralph의 4가지 핵심 원칙
Huntley가 정립한 Ralph Loop의 핵심 원칙은 네 가지입니다.
1. Iteration > Perfection — 완벽한 원샷 대신 반복으로 개선
2. Failures Are Data — 실패는 버그가 아니라 다음 반복의 데이터
3. Operator Skill Matters — 좋은 프롬프트 작성이 결과를 좌우
4. Persistence Wins — 멈추지 않으면 결국 완성
커뮤니티에서는 이를 "실패를 먹고 자라는 압력솥"이라고 표현했습니다. 기존 개발 패러다임이 에러를 회피하려 했다면, Ralph은 에러를 적극적으로 수용합니다.
이 접근법이 왜 효과적인지 아키텍처 관점에서 살펴보면, 에이전틱 루프의 핵심은 "도구 호출 결과를 다음 결정에 반영하는 피드백 루프"입니다.
프롬프트 평가 → 도구 호출 결정 → 도구 실행
↑ ↓
└──── 결과를 다음 결정에 반영 ←──┘
Anthropic의 공식 채택: Stop Hook 패턴
2025년 12월, Anthropic은 이 커뮤니티 패턴을 공식 플러그인으로 채택했습니다. 핵심은 단순한 무한 루프에 기업 환경을 위한 안전 장치를 추가한 것입니다.
Stop Hook 작동 원리
1. 사용자가 작업 설명 + 완료 조건(completion promise) 설정
2. Claude가 작업 수행
3. Claude가 종료 시도
4. Stop Hook이 종료를 가로챔 (exit code 2)
5. 동일한 프롬프트를 다시 주입
6. completion promise 충족 또는 max-iterations 도달까지 반복
원조 Ralph이 "무제한 자율성"이었다면, Anthropic 버전은 가드레일이 내장된 버전입니다.
원조 vs Anthropic 비교
| 항목 | 원조 Ralph | Anthropic Ralph |
| 종료 조건 | 없음 (수동 Ctrl+C) | completion promise + max-iterations |
| 안전 장치 | 없음 | Stop Hook, 타임아웃 |
| 상태 추적 | 없음 | 반복 횟수, 완료 여부 |
| 적용 대상 | 개인 실험 | 프로덕션 환경 |
VentureBeat는 2026년 1월 기사에서 이를 "심슨 캐릭터에서 AI 코딩의 가장 큰 이름으로"라고 대서특필했습니다.
커뮤니티 확장: Continuous Claude
Ralph Loop의 영향을 받아 다양한 커뮤니티 프로젝트가 등장했습니다. 그중 가장 주목할 만한 것이 Anand Chowdhary의 Continuous Claude(GitHub 1,241 stars)입니다.
"수십만 줄 코드베이스에서 테스트 커버리지를 0%에서 80%로 올려야 했다"는 실제 계약 의무에서 탄생했습니다.
Continuous Claude 워크플로우:
브랜치 생성 → 코드 변경 → 커밋 → PR 생성 → 체크 대기 → 머지 → 반복
CI/CD 파이프라인을 Claude Code로 감싸는 CLI 래퍼인 셈입니다.
같은 시기에 Simon Willison은 "Designing Agentic Loops"에서 루프 설계 방법론을 정립했고, Fatih Yildiz는 "YOLO Mode" 실험을 공유하며 커뮤니티 확산에 기여했습니다.
/loop 명령어: 2026년 3월 7일 공식 출시
이 모든 흐름이 합류한 결과가 2026년 3월 7일에 출시된 /loop 명령어입니다.
기본 사용법
/loop 5m check if the deployment finished and tell me what happened
인터벌 구문은 5m, 1h, 30s 등을 지원하며, 내부적으로 cron 표현식으로 자동 변환됩니다.
CLI vs Desktop 비교
| 항목 | CLI /loop | Desktop Scheduled Tasks |
| 설정 | /loop 명령어 | GUI 인터페이스 |
| 지속성 | 세션 종료 시 삭제 | 앱 실행 중 영구 유지 |
| 최대 스케줄 | 50개/세션 | 제한 없음 |
| 자동 삭제 | 3일 후 | 수동 삭제 |
| 리마인더 | 지원 | 지원 |
실전 활용 예시
Claude Code 창시자 Boris Cherny의 워크플로우:
/loop 10m check open PRs and auto-fix lint issues
/loop 1h generate morning Slack summary of overnight changes
Anthropic 개발자 Thariq Shihipar의 워크플로우:
/loop 2h scan error logs and create PR for fixable bugs
진화 타임라인: 밈에서 공식 기능까지
| 시기 | 이벤트 | 핵심 |
| 2025년 여름 | Geoffrey Huntley, 원조 Ralph 공개 | 5줄 Bash 스크립트 |
| 2025년 9월 | Simon Willison, "Designing Agentic Loops" | 루프 설계 방법론 정립 |
| 2025년 11월 | Continuous Claude 출시 | PR 기반 자동화 래퍼 (GitHub 1,241 stars) |
| 2025년 12월 | Anthropic 공식 Ralph Wiggum 플러그인 | Stop Hook 패턴 공식화 |
| 2026년 1월 | VentureBeat 대서특필 | "심슨에서 AI 코딩의 가장 큰 이름으로" |
| 2026년 3월 7일 | /loop 명령어 공식 출시 | Claude Code 내장 스케줄링 기능 |
"두 개의 Ralph": 철학적 분기
현재 커뮤니티에서는 두 가지 Ralph 철학이 공존합니다.
원조 Ralph (Huntley): 혼돈에서 태어난 순수한 Bash 루프입니다. Huntley 본인은 최근 "Ralph은 단순히 앞으로 가는 것(forward mode)만이 아니다. 역방향(clean rooming)도, 마인드셋도 Ralph이다. 모든 것이 루프다"라고 설명합니다.
Anthropic Ralph: 기업 안전성을 위해 정제된 버전입니다. Stop Hook, max-iterations, completion promise 등 가드레일이 내장되어 있습니다. /loop 명령어는 이 철학의 최신 구현체입니다.
두 철학 모두 "반복이 완벽을 이긴다"는 핵심은 동일합니다.
FAQ
/loop 명령어는 무료로 사용할 수 있나요?
/loop 명령어는 Claude Code 구독(Pro/Max 플랜)에 포함된 기능입니다. 별도 추가 비용은 없으며, 세션당 최대 50개 스케줄을 등록할 수 있습니다.
/loop과 Ralph Loop의 차이점은 무엇인가요?
Ralph Loop은 원조 Bash 스크립트 기반의 무한 루프로 가드레일이 없습니다. /loop은 Anthropic이 공식화한 버전으로, 인터벌 설정, 자동 삭제(3일), 최대 반복 횟수 등 안전 장치가 내장되어 있습니다.
Desktop 앱과 CLI에서 /loop의 차이가 있나요?
CLI의 /loop은 세션 종료 시 스케줄이 삭제됩니다. Desktop 앱의 Scheduled Tasks는 GUI로 설정 가능하고, 앱 실행 중 영구적으로 유지됩니다.
Continuous Claude와 /loop의 관계는?
Continuous Claude는 Ralph Loop에서 영감을 받은 커뮤니티 프로젝트로, CI/CD 스타일의 PR 기반 워크플로우입니다. /loop은 Anthropic이 이 모든 커뮤니티 흐름을 종합하여 공식화한 내장 기능입니다.
/loop으로 어떤 작업을 자동화할 수 있나요?
배포 상태 모니터링, 에러 로그 주기적 분석, PR 자동 생성, 아침 Slack 요약 생성, 테스트 실행 결과 확인 등 반복적인 개발 작업을 자동화할 수 있습니다.
마무리: 반복이 만드는 미래
5줄 Bash 스크립트 하나가 AI 코딩의 패러다임을 바꿨습니다. "실패를 피하라"에서 "실패를 먹여라"로의 전환입니다. /loop 명령어는 이 철학을 누구나 한 줄로 실행할 수 있게 만들었습니다.
여러분은 AI 코딩에서 루프 패턴을 어떻게 활용하고 계신가요? 실전 경험을 공유해주세요.
참고 자료
- Claude Code 공식 문서 - Scheduled Tasks - /loop 명령어 상세 스펙
- Geoffrey Huntley 블로그 - Ralph Loop - 원작자 설명
- VentureBeat - "How Ralph Wiggum went from The Simpsons to AI" - 메인스트림 보도
- Continuous Claude - GitHub - 커뮤니티 CI/CD 래퍼
- The Decoder - /loop 명령어 출시 보도 - 출시 보도
- Simon Willison - Designing Agentic Loops - 루프 설계 방법론
Comments
Join the discussionNo comments yet. Be the first to comment.
