ralph-claude-code: Claude Code용 자동 개발 루프(지능형 종료 감지 및 속도 제한 포함)

해결하는 문제

Ralph는 Claude Code를 위한 자동 개발 루프를 제공하여, 지속적인 수동 개입 없이 프로젝트가 완성될 때까지 반복적으로 개선할 수 있게 합니다. 수동 프롬프트‑응답 사이클 문제를 자동 실행 루프로 해결하고, 무한 루프, API 과다 사용, 비용 폭주를 방지하는 안전 장치를 구현합니다.

작동 방식

Ralph는 Claude Code를 연속 사이클에 감쌉니다: PROMPT.md 파일에서 프로젝트 목표를 읽고, AI를 실행하며, 작업 목록을 통해 진행 상황을 추적하고, 프로젝트가 완료되었는지 평가합니다. "이중 조건 종료 게이트"를 사용해 휴리스틱 완성 지표와 AI의 명시적 EXIT_SIGNAL: true 두 가지가 모두 충족될 때만 종료합니다. 안정성을 위해 오류 감지를 위한 회로 차단기, API 호출에 대한 속도 제한, 반복 간 컨텍스트를 유지하는 세션 관리 기능을 포함합니다.

대상 사용자

Claude Code를 사용하고 PRD, GitHub 이슈, 기술 사양 등에 기반한 기능 구현이나 버그 수정을 자동화하고 싶지만 루프의 모든 단계를 수동으로 진행하고 싶지 않은 개발자들을 위한 도구입니다.

주요 특징

• 자동 루프: 프로젝트 요구사항에 따라 Claude Code를 지속적으로 실행합니다.
• 지능형 종료 감지: 휴리스틱 + 명시적 신호의 이중 조건 검사를 통해 조기 종료를 방지합니다.
• 작업 통합: PRD, GitHub 이슈에서 직접 요구사항을 가져오거나 인터랙티브 ralph-enable 마법사를 통해 가져옵니다.
• 안전 가드: 속도 제한, 멈춘 루프를 위한 회로 차단기, 자동 git 백업 브랜치를 포함합니다.
• 샌드박스 지원: 격리된 Docker 또는 E2B 클라우드 샌드박스에서 Claude Code를 실행할 수 있습니다.
• 세션 관리: --resume 플래그와 구성 가능한 만료 시간 초과를 통해 세션 연속성을 지원합니다.

SUMMARY: Claude Code를 위한 자동 개발 루프로, 프로젝트 요구사항을 반복적으로 구현하면서 무한 루프와 API 과다 사용에 대한 내장 안전 장치를 제공합니다.

TITLE: ralph-claude-code: Claude Code용 자동 개발 루프(지능형 종료 감지 및 속도 제한 포함)