Skip to main content

Claude Code /loop 명령어 탄생기: 염소 농장 5줄 Bash에서 공식 기능까지

Published 6 min readMarkdown

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 비교

항목원조 RalphAnthropic 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 /loopDesktop 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 코딩에서 루프 패턴을 어떻게 활용하고 계신가요? 실전 경험을 공유해주세요.

참고 자료

No comments yet. Be the first to comment.

More from this blog