클로드 코드 완전 자동화 #3 — 리밋 걸리면? 중단과 재개 전략

Claude Code에서 만나는 리밋 4가지

리밋에 걸리면 실제로 어떻게 되나

자동화에서 리밋 대응 전략

rate_limit 감지 + 지수 백오프 재시도 래퍼 (bash)
#!/usr/bin/env bash
# claude_run.sh — rate limit 대응 재시도 래퍼
# 사용법: ./claude_run.sh "작업 프롬프트" output_file.txt

PROMPT="$1"
OUTPUT_FILE="$2"
MAX_RETRIES=5
RETRY_DELAY=60   # 초 단위 초기 대기 시간

run_claude() {
  claude -p "$PROMPT" --output-format text 2>&1
}

for attempt in $(seq 1 $MAX_RETRIES); do
  echo "[$(date '+%H:%M:%S')] 시도 $attempt / $MAX_RETRIES"
  OUTPUT=$(run_claude)
  EXIT_CODE=$?

  # 429 rate limit 감지 (exit code 및 stdout 모두 확인)
  if echo "$OUTPUT" | grep -qi "rate.limit\|429\|too many requests"; then
    WAIT=$((RETRY_DELAY * attempt))   # 지수 백오프
    echo "[RATE LIMIT] ${WAIT}초 대기 후 재시도..."
    sleep $WAIT
    continue
  fi

  # 구독 한도 / 크레딧 소진 — 재시도 불가, 즉시 중단
  if echo "$OUTPUT" | grep -qi "usage limit\|billing\|402"; then
    echo "[LIMIT REACHED] 구독 한도 또는 크레딧 소진. 수동 확인 필요."
    exit 2
  fi

  # 정상 종료
  if [ $EXIT_CODE -eq 0 ]; then
    echo "$OUTPUT" > "$OUTPUT_FILE"
    echo "[OK] 결과 저장: $OUTPUT_FILE"
    exit 0
  fi

  echo "[ERROR] exit code $EXIT_CODE. 재시도..."
  sleep $RETRY_DELAY
done

echo "[FAIL] 최대 재시도 횟수 초과."
exit 1

중단 후 이어가기 — 세션 재개 전략

headless에서 이전 세션 이어가기
# 첫 번째 실행 — 대화 ID를 파일에 저장
SESSION_ID=$(claude -p "작업 1 시작" --output-format json | jq -r '.session_id')
echo "$SESSION_ID" > .claude_session_id

# 이후 실행 — 저장된 세션 ID로 재개
SESSION_ID=$(cat .claude_session_id)
claude -p "작업 2 이어서" --resume "$SESSION_ID" --output-format text

파일 기반 상태 관리 패턴 (multi-step 작업)
#!/usr/bin/env bash
# 작업을 단계별 파일로 분리해 재개 가능하게 만드는 패턴

WORK_DIR=".claude_work"
mkdir -p "$WORK_DIR"

# 단계 1 — 코드 분석 (아직 결과 파일이 없을 때만 실행)
if [ ! -f "$WORK_DIR/step1_analysis.txt" ]; then
  echo "[STEP 1] 코드 분석 중..."
  claude -p "src/ 디렉토리의 함수 목록을 정리해줘" \
    --output-format text > "$WORK_DIR/step1_analysis.txt"
fi

# 단계 2 — 이전 단계 결과를 프롬프트에 포함
if [ ! -f "$WORK_DIR/step2_tests.txt" ]; then
  echo "[STEP 2] 테스트 생성 중..."
  ANALYSIS=$(cat "$WORK_DIR/step1_analysis.txt")
  claude -p "다음 함수 목록에 대한 단위 테스트를 작성해줘:\n\n$ANALYSIS" \
    --output-format text > "$WORK_DIR/step2_tests.txt"
fi

echo "[DONE] 모든 단계 완료."

비용 최적화 — 리밋을 덜 만나는 방법

모델 지정 — headless 모드에서 사용
# 기본 (Sonnet — 균형)
claude -p "작업 내용" --model claude-sonnet-4-5

# 저렴한 모델 (Haiku — 단순 작업용)
claude -p "작업 내용" --model claude-haiku-4-5

# 고성능 모델 (Opus — 복잡한 아키텍처 설계 등)
claude -p "작업 내용" --model claude-opus-4-5

.claudeignore 예시 — 불필요한 디렉토리 제외
# .claudeignore
node_modules/
dist/
build/
.next/
.git/
coverage/
*.log
*.lock
*.min.js
*.map
public/
assets/images/

실전 패턴 — 리밋 안전 자동화 스크립트

리밋 안전 자동화 스크립트 — 통합 버전
#!/usr/bin/env bash
# safe_claude_runner.sh — rate limit + 비용 상한 + 슬랙 알림 통합

# 설정값
SLACK_WEBHOOK="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
MAX_RUNS_PER_HOUR=10          # 시간당 최대 실행 횟수
DAILY_COST_LIMIT=5.0          # 일일 비용 상한 (달러, 개인 추적용)
RUN_LOG=".claude_run_log.txt"
COST_LOG=".claude_cost_log.txt"
WORK_DIR=".claude_work"
mkdir -p "$WORK_DIR"

send_slack_alert() {
  local MESSAGE="$1"
  if [ -n "$SLACK_WEBHOOK" ]; then
    curl -s -X POST -H 'Content-type: application/json' \
      --data "{\"text\": \"[Claude Auto] $MESSAGE\"}" \
      "$SLACK_WEBHOOK" > /dev/null
  fi
  echo "[ALERT] $MESSAGE"
}

check_hourly_rate() {
  local NOW=$(date +%s)
  local ONE_HOUR_AGO=$((NOW - 3600))
  local RECENT_RUNS=0
  if [ -f "$RUN_LOG" ]; then
    RECENT_RUNS=$(awk -v cutoff="$ONE_HOUR_AGO" '$1 > cutoff' "$RUN_LOG" | wc -l)
  fi
  if [ "$RECENT_RUNS" -ge "$MAX_RUNS_PER_HOUR" ]; then
    send_slack_alert "시간당 실행 한도($MAX_RUNS_PER_HOUR)에 도달. 다음 시간까지 대기."
    sleep 3600
  fi
  echo "$(date +%s)" >> "$RUN_LOG"
}

run_task() {
  local TASK_NAME="$1"
  local PROMPT="$2"
  local OUTPUT_FILE="$WORK_DIR/${TASK_NAME}.txt"

  # 이미 완료된 작업은 건너뜀
  if [ -f "$OUTPUT_FILE" ]; then
    echo "[SKIP] $TASK_NAME — 이미 완료됨"
    return 0
  fi

  check_hourly_rate

  echo "[RUN] $TASK_NAME"
  OUTPUT=$(claude -p "$PROMPT" --model claude-sonnet-4-5 \
    --output-format text 2>&1)
  EXIT_CODE=$?

  if echo "$OUTPUT" | grep -qi "rate.limit\|429\|too many requests"; then
    send_slack_alert "Rate limit 감지: $TASK_NAME. 60초 후 재시도."
    sleep 60
    run_task "$TASK_NAME" "$PROMPT"  # 재귀 재시도
    return
  fi

  if echo "$OUTPUT" | grep -qi "usage limit\|billing\|402"; then
    send_slack_alert "구독 한도 또는 크레딧 소진. 자동화 중단."
    exit 2
  fi

  if [ $EXIT_CODE -ne 0 ]; then
    send_slack_alert "오류 발생 (exit $EXIT_CODE): $TASK_NAME"
    return 1
  fi

  echo "$OUTPUT" > "$OUTPUT_FILE"
  echo "[OK] $TASK_NAME 완료 → $OUTPUT_FILE"
}

# 작업 목록 실행
run_task "analyze" "src/의 함수 목록을 정리해줘"
run_task "test_gen" "$(cat "$WORK_DIR/analyze.txt" 2>/dev/null) 위 함수들에 대한 단위 테스트를 작성해줘"
run_task "docs" "$(cat "$WORK_DIR/analyze.txt" 2>/dev/null) 위 함수들에 대한 JSDoc 주석을 작성해줘"

send_slack_alert "모든 작업 완료."
echo "[DONE]"

시리즈 마무리 — 핵심 체크리스트