비개발자를 위한 Ralph Loop 가이드

— Claude Code와 함께 일하는 분들을 위해

---

1. Ralph Loop가 뭔가요?

Claude Code에게 일을 시키면, 보통 이렇게 됩니다.

나: "한국 인스타 계정 1000개 찾아줘" Claude: 열심히 하다가… 중간에 멈춤. "여기까지 했어요!"

Claude는 한 번 대화가 끝나면 기억을 초기화합니다. 다음에 다시 시키면 처음부터 다시 하려 하거나, 이미 한 걸 또 합니다.

Ralph Loop는 이 문제를 해결합니다.

Claude에게 수첩(파일) 을 주고, 매번 수첩을 보며 이어서 일하게 만드는 방법입니다. Claude가 퇴근했다 다시 출근해도, 수첩에 "247개까지 했어요"라고 적혀 있으면 248번째부터 시작합니다.

한 줄 요약:

"Claude가 스스로 반복하면서, 목표를 달성할 때까지 알아서 이어서 일하게 하는 방법"

---

2. 왜 써야 하나요?

일반적인 방법의 문제

상황	일반 Claude	Ralph Loop
1000개 수집	중간에 멈춤	알아서 끝까지 진행
오류 발생	그냥 멈춤	다음 회차에 다시 시도
자리 비울 때	불가능	혼자 계속 작업
진행 상황 추적	매번 물어봐야 함	파일에 자동 기록

Ralph Loop의 핵심 가치

보통 Claude에게 "이렇게 해줘"라고 하면, Claude가 "아마도" 합니다. Ralph Loop를 쓰면 "반드시" 합니다.

예: "중복 계정 추가하지 마"

• 일반 방식: 깜빡할 수 있음
• Ralph Loop: 매 회차마다 파일 확인하며 무조건 체크

---

3. 어떨 때 특히 유용한가요?

Ralph Loop가 빛을 발하는 상황은 딱 이런 경우입니다.

✅ 목표 수치가 명확할 때 → "1000개 모아줘", "파일 100개 처리해줘"

✅ 같은 작업을 반복해야 할 때 → 계정 수집, 데이터 정리, 문서 변환

✅ 오래 걸리는 작업을 자리 비우고 돌릴 때 → 퇴근 전에 켜두고, 출근하면 결과 확인

✅ "됐다 / 안 됐다"를 자동으로 판단할 수 있을 때 → 1000개 채워졌는지, 오류 없는지 파일로 확인 가능

❌ 이럴 때는 Ralph Loop가 불필요해요 → 한 번 물어보면 끝나는 단순한 질문 → 판단이 필요한 창의적인 작업 (전략 수립, 글쓰기 등) → 결과를 매번 사람이 검토해야 하는 작업

---

4. Claude Code에서 어떻게 사용하나요?

방법 A. 공식 플러그인 사용 (가장 쉬움)

Claude Code에게 이렇게 말하면 됩니다.

/plugin install ralph-loop

설치 후, 이렇게 시작합니다.

/ralph-loop "한국 인스타 마이크로 인플루언서 1000개 수집"
--max-iterations 30
--completion-promise "LOOP_COMPLETE"

• max-iterations 30 : 최대 30번만 반복해 (안전장치)
• completion-promise "LOOP_COMPLETE" : Claude가 이 단어를 출력하면 끝

단, 공식 플러그인은 한 세션을 계속 유지하기 때문에 오래 돌릴수록 Claude가 지쳐 판단이 흐려질 수 있습니다. 1000개처럼 장기 작업엔 아래 방법이 더 안정적입니다.

---

방법 B. Bash Loop 방식 (더 안정적, Claude Code에게 만들어 달라고 하면 됨)

Claude Code에게 이렇게 요청하면 됩니다.

---

Claude Code에게 이렇게 시키세요:

"Ralph Loop 방식으로 인플루언서 수집 자동화를 만들어줘. 조건은 이래:

• 한국 인스타그램 계정, 팔로워 1천~10만, 뷰티/패션/라이프스타일
• 목표: 1000개
• 매 회차에 50개씩 수집
• 진행 상황은 progress.json에 저장
• 수집 결과는 found_accounts.csv에 누적
• 완료되면 Google Sheets에 업로드
• 최대 30회, 3번 연속 실패하면 자동 중단
• 10회마다 중간 저장

필요한 파일 구조랑 prompt.md, run-loop.sh 전부 만들어줘."

---

Claude Code가 아래 파일들을 만들어 줄 거예요.

influencer-finder/
├── prompt.md          ← 매 회차 Claude에게 줄 지시서
├── run-loop.sh        ← 반복 실행 스크립트 (Claude가 생성)
├── progress.json      ← 진행 수첩
├── found_accounts.csv ← 수집 결과
└── upload_sheets.py   ← Google Sheets 업로드 (Claude가 생성)

---

5. 비개발자가 직접 써야 하는 것: 업무 지시서(prompt.md)

Claude Code가 파일 구조와 스크립트를 만들어줘도, 업무 지시서 내용은 직접 써야 합니다. 이게 Ralph Loop 품질의 핵심이에요.

아래 4가지 요소를 반드시 넣으세요.

---

요소 ① 역할 — "너는 누구야"

Claude에게 정체성을 주는 것. 역할이 명확할수록 일관성 있게 일합니다.

당신은 한국 인스타그램 마이크로 인플루언서를
수집하는 리서치 전문가입니다.
이 지시서는 매 회차마다 새로 읽게 됩니다.

---

요소 ② 현재 상태 확인 — "먼저 수첩 봐"

새 회차가 시작될 때마다 어디까지 했는지 파악하게 합니다. 이게 없으면 매번 처음부터 하려 합니다.

작업 시작 전, 반드시 아래 두 파일을 먼저 읽으세요.

- progress.json
  → 지금까지 몇 개 모았는지, 마지막으로 어떤
    키워드를 검색했는지 확인

- found_accounts.csv
  → 이미 수집된 계정 목록.
    username 컬럼에 있는 계정은 이번에 추가 금지.

---

요소 ③ 이번 회차 할 일 — "오늘은 이것만 해"

한 번에 너무 많이 시키면 엉망이 됩니다. 회차당 하나의 목표만 줍니다.

이번 회차 목표: 조건에 맞는 계정 정확히 50개 추가

[수집 조건]
- 팔로워: 1,000명 이상 ~ 100,000명 이하
- 카테고리: 뷰티, 패션, 라이프스타일 중 하나 이상
- 한국 계정: 바이오가 한국어이거나
  한국어 해시태그(#한국, #뷰티 등)가 있는 계정
- 이미 found_accounts.csv에 있는 계정은 추가 금지

[저장 형식 - 이 순서 그대로]
username, 팔로워수, 카테고리, 바이오요약, 수집일시

---

요소 ④ 마무리와 완료 신호 — "끝나면 이렇게 해"

루프가 언제 멈출지 알아야 합니다. Claude가 특정 단어를 출력할 때 자동으로 멈추게 합니다.

[작업 후 반드시 이 순서대로]

1. progress.json을 업데이트하세요:
   - total_found: found_accounts.csv의 현재 총 줄 수
   - last_keyword: 이번 회차에 마지막으로 검색한 키워드
   - last_run: 지금 시각
   - iteration: 기존 숫자에서 1 증가

2. found_accounts.csv 총 계정 수 확인:
   - 1000개 이상이면 → 마지막에 정확히 이것만 출력:
     LOOP_COMPLETE
   - 1000개 미만이면 → 아무것도 출력하지 말고 종료

---

완성된 prompt.md 전체 (복사해서 바로 쓰세요)

===== 인플루언서 수집 에이전트 업무 지시서 =====

[역할]
당신은 한국 인스타그램 마이크로 인플루언서를 수집하는
리서치 전문가입니다. 이 지시서는 매 회차마다 새로 읽습니다.
매번 새로운 정신으로, 아래 파일 기록을 기반으로 작업합니다.

─────────────────────────────────────
STEP 1. 현재 상태 파악 (반드시 먼저)
─────────────────────────────────────
아래 두 파일을 읽어 현재 상황을 파악하세요.

파일 1) progress.json
  → 지금까지 몇 개 모았는지, 어떤 키워드를 썼는지 확인

파일 2) found_accounts.csv
  → 이미 수집된 계정 목록.
    username 컬럼에 있는 계정은 이번에 추가하면 안 됩니다.

─────────────────────────────────────
STEP 2. 이번 회차 수집 (50개만)
─────────────────────────────────────
조건에 맞는 한국 인스타그램 계정을 50개 찾아서
found_accounts.csv 파일 맨 아래에 추가하세요.

[수집 조건]
- 팔로워: 1,000명 이상 ~ 100,000명 이하
- 카테고리: 뷰티 / 패션 / 라이프스타일
- 한국 계정 (한국어 바이오 또는 한국어 해시태그 사용)
- 중복 계정 추가 금지

[저장 형식 - 헤더 없이 데이터만 추가]
username,팔로워수,카테고리,바이오요약,수집일시

예시:
beauty_jiyeon,45200,뷰티,일상 뷰티 유튜버,2026-03-22 14:30

─────────────────────────────────────
STEP 3. 수첩(progress.json) 업데이트
─────────────────────────────────────
작업 후 progress.json을 아래 형식으로 업데이트하세요.

{
  "total_found": [found_accounts.csv 현재 총 줄 수],
  "target": 1000,
  "last_keyword": "[이번에 마지막으로 검색한 키워드]",
  "last_run": "[지금 시각]",
  "iteration": [기존 숫자 + 1]
}

─────────────────────────────────────
STEP 4. 완료 여부 판단
─────────────────────────────────────
found_accounts.csv의 총 계정 수를 확인하세요.

1000개 이상 → 마지막에 딱 이것만 출력:
LOOP_COMPLETE

1000개 미만 → 아무것도 출력하지 말고 종료.

===== 지시서 끝 =====

---

6. 처음 시작할 때 Claude Code에게 시키는 순서

1단계. 파일 구조 만들기
─────────────────────────────────
"influencer-finder 폴더를 만들고, 안에
progress.json, found_accounts.csv, prompt.md 파일을
빈 상태로 만들어줘.
progress.json 초기값은 이렇게 해줘:
{ total_found: 0, target: 1000, iteration: 0 }"

2단계. 루프 스크립트 만들기
─────────────────────────────────
"run-loop.sh 파일을 만들어줘.
조건은 이래:
- 최대 30번 반복
- Claude 출력에 LOOP_COMPLETE가 있으면 종료
- found_accounts.csv 줄 수가 1000 이상이면 종료
- 3번 연속 오류 나면 자동 중단
- 10회마다 Google Sheets에 자동 업로드
- 각 회차 사이 5초 대기"

3단계. 테스트 실행
─────────────────────────────────
"run-loop.sh를 max-iterations 5로 수정해서
테스트 실행해줘. 잘 되는지 확인해줘."

4단계. 본 실행
─────────────────────────────────
테스트 결과 확인 후 →
"max-iterations를 30으로 바꾸고 본 실행해줘."

---

7. 한눈에 보는 비개발자 역할 분담