작성자 주: PR 검토, 배포 모니터링, 코드 품질 관리, 보안 스캔, 로그 분석 등 6가지 주요 시나리오를 아우르는 검증된 Claude Code /loop 루프 작업 프롬프트 20개를 정리했습니다. 실행 간격 설정 팁도 함께 포함되어 있습니다.
Claude Code의 /loop 명령어는 2026년 3월에 도입된 가장 실용적인 신기능입니다. 이 기능을 통해 Claude Code는 단순한 '일회성 대화 도우미'에서 '지속적으로 실행되는 백그라운드 작업자'로 진화했습니다. 하지만 막상 /loop를 설정하고 나면 무엇을 시켜야 할지 고민되는 경우가 많죠. 본 글에서는 실전에서 검증된 20개의 /loop 프롬프트를 6가지 시나리오별로 분류하여, 바로 복사해서 사용할 수 있도록 정리했습니다.
핵심 가치: 일상적인 개발 업무에서 가장 빈번하게 발생하는 자동화 요구사항을 충족하는 20개의 프롬프트와 함께, 각 작업에 권장되는 실행 간격 및 주의사항을 제공합니다.
/loop 기초 지식 빠르게 훑어보기
프롬프트를 다루기 전에 /loop의 핵심 메커니즘을 먼저 빠르게 살펴볼게요.
| 차원 | 설명 |
|---|---|
| 기본 문법 | /loop [간격] [작업 설명] |
| 기본 간격 | 10분 (간격을 지정하지 않을 경우) |
| 간격 형식 | 5m(분), 2h(시간), 1d(일) |
| 최대 동시 작업 | 세션당 50개의 예약 작업 |
| 자동 만료 | 3일 후 자동 삭제 |
| 중단 조건 | 터미널 종료 / 세션 로그아웃 / SSH 연결 끊김 |
| 특징 | 자연어 설명으로 Claude가 자동으로 cron 표현식으로 변환 |
시나리오 1: PR 순찰 (프롬프트 4가지)
PR 순찰은 /loop를 가장 가치 있게 활용할 수 있는 시나리오예요. 많은 개발자가 코드 리뷰와 실제 코딩 사이를 오가며 컨텍스트 스위칭 비용을 크게 치르고 있죠. Claude가 백그라운드에서 자동으로 순찰하게 두고, 알림이 올 때만 확인해 보세요.
프롬프트 #1: CI 상태 모니터링
/loop 10m 모든 open 상태인 PR의 CI 상태를 확인해 줘. 새로 실패한 항목이 있다면 어떤 PR인지, 어떤 job이 실패했는지, 그리고 실패 원인이 무엇인지 알려줘.
권장 간격: 10분
가치: GitHub 페이지를 새로고침할 필요 없이 CI 실패를 즉시 파악할 수 있어요.
프롬프트 #2: PR 댓글 팔로업
/loop 15m 내가 생성한 모든 open PR을 확인해 줘. 새로운 댓글이나 리뷰 피드백이 있다면 내용을 요약하고, 내가 답장해야 할 항목이 무엇인지 알려줘.
권장 간격: 15분
가치: 리뷰 댓글을 놓치지 않고 제때 대응할 수 있어요.
프롬프트 #3: 병합 충돌 감지
/loop 30m main 브랜치의 최신 커밋을 확인해 줘. 현재 브랜치와 main 브랜치 사이에 충돌이 발생했다면 충돌이 난 파일 목록을 알려줘.
권장 간격: 30분
가치: PR 병합 시점에 당황하지 않도록 미리 충돌을 발견할 수 있어요.
프롬프트 #4: PR 자동 리뷰
/loop 15m 새로 열린 PR이 있는지 확인해 줘. 있다면 변경 내용을 자동으로 리뷰하고 다음 내용을 요약해 줘: 1) 무엇이 변경되었는지 2) 잠재적인 문제점 3) 개선 제안
권장 간격: 15분
가치: Claude를 24시간 대기 중인 코드 리뷰어로 활용해 보세요.
시나리오 2: 배포 모니터링 (프롬프트 3개)
프롬프트 #5: 서비스 상태 체크
/loop 5m curl localhost:3000/health, 만약 200 이외의 상태 코드가 반환되거나 타임아웃이 발생하면 즉시 서비스 상태와 최근 에러 로그를 알려줘
권장 간격: 5분
가치: 로컬 개발 시 서비스 중단 상황을 즉시 파악 가능
프롬프트 #6: 빌드 파이프라인 모니터링
/loop 5m GitHub Actions의 최신 실행 상태를 확인해. 만약 실패한 워크플로우가 있다면 어떤 워크플로우인지, 어떤 단계(step)에서 실패했는지, 그리고 실패 로그의 핵심 라인을 알려줘
권장 간격: 5분
가치: Actions 페이지를 계속 새로고침하며 빌드 결과를 기다릴 필요 없음
프롬프트 #7: 배포 후 회귀 테스트
/loop 2m npm test -- --testPathPattern="critical"을 실행하고 결과를 확인해. 테스트 실패 시 즉시 알려주고, 3회 연속 통과하면 중지해
권장 간격: 2분 (배포 직후 단기 모니터링)
가치: 배포 후 자동으로 핵심 테스트를 수행하여 회귀 오류 방지
시나리오 3: 보안 스캔 (프롬프트 3개)
프롬프트 #8: 의존성 취약점 탐지
/loop 24h npm audit을 실행하여 모든 high 및 critical 등급의 취약점을 나열하고, 권장되는 수정 작업(버전 업그레이드 또는 패키지 교체)을 제안해
권장 간격: 24시간
가치: 매일 자동으로 의존성 보안을 검사하여 수동 audit 부담 해소
프롬프트 #9: 민감 정보 스캔
/loop 1h 최근 1시간의 git diff를 스캔하여 API 키, 비밀번호, 토큰 등 민감 정보가 실수로 커밋되었는지 확인하고, 발견 시 즉시 경고해
권장 간격: 1시간
가치: git 기록에 민감 정보가 유출되는 것을 방지
프롬프트 #10: 보안 모드 코드 리뷰
/loop 2h src/ 디렉토리에서 새로 추가되거나 수정된 파일을 스캔하여 SQL 인젝션, XSS, 명령 인젝션 등의 보안 취약점을 검사하고, 발견 시 즉시 수정 PR을 생성해
권장 간격: 2시간
가치: 지속적인 보안 감사 및 문제 발생 시 즉각적인 수정
시나리오 4: 코드 품질 (4가지 프롬프트)
프롬프트 #11: 테스트 커버리지 모니터링
/loop 1h 테스트 커버리지 검사를 실행하고, 전체 커버리지가 80% 미만이거나 테스트가 누락된 새 파일이 있으면 해당 파일 목록과 제안 사항을 나열해 줘
프롬프트 #12: Lint 오류 자동 수정
/loop 30m eslint src/ --fix를 실행하고, 자동으로 수정할 수 없는 오류가 있으면 오류 유형과 위치를 요약해 줘
프롬프트 #13: TODO/FIXME 요약
/loop 2h 코드 내의 모든 TODO 및 FIXME 주석을 스캔하고, 우선순위에 따라 정렬한 뒤 7일 이상 처리되지 않은 항목이 있는지 확인해 줘
프롬프트 #14: 함수 복잡도 모니터링
/loop 2h src/에서 최근 수정된 파일을 검사하고, 함수의 순환 복잡도(Cyclomatic Complexity)가 15를 초과하거나 코드 라인 수가 100줄을 넘으면 리팩토링이 필요하다고 알려줘
시나리오 5: 로그 분석 (3가지 프롬프트)
프롬프트 #15: FATAL 오류 실시간 탐지
/loop 5m ./logs/app.log에서 최근 5분 동안 새로 발생한 FATAL 및 ERROR 항목을 스캔해. 만약 수정 가능한 오류가 발견되면 즉시 수정 PR을 생성해 줘
가치: 자동 탐지와 자동 수정을 결합하여 /loop의 활용도를 극대화합니다.
프롬프트 #16: 오류 추세 분석
/loop 1h ./logs/ 디렉토리에서 최근 1시간 동안의 ERROR 발생 건수를 집계하고, 이전 시간과 비교해서 증가율이 50%를 넘으면 경고를 보내줘
프롬프트 #17: API 응답 시간 이상 탐지
/loop 10m ./logs/access.log에서 최근 10분간의 API 요청을 확인하고, 평균 응답 시간이 2초를 초과하거나 10초 이상 걸리는 요청이 있으면 상세 내역을 나열해 줘
시나리오 6: 팀 협업 (프롬프트 3개)
프롬프트 #18: 일일 코드 변경 요약
/loop 24h 지난 24시간 동안의 모든 git 커밋을 요약해줘. 모듈별로 그룹화하고, 개발자별 변경 사항 요약과 관련 파일을 나열해줘.
가치: 팀 일일 보고서를 자동으로 생성하여 개별 작성 부담을 줄여줍니다.
프롬프트 #19: 만료된 브랜치 정리
/loop 24h 30일 이상 업데이트되지 않은 모든 원격 브랜치를 나열해줘. main 브랜치에 병합되었는지 여부를 표시하고, 안전하게 삭제할 수 있는 브랜치를 추천해줘.
프롬프트 #20: README 동기화 확인
/loop 2h README.md의 설치 단계와 API 문서가 실제 코드와 일치하는지 확인해줘. 만약 오래된 내용이 있다면 표시해줘.
/loop 사용 모범 사례
/loop 간격 선택 요약표
| 긴급도 | 권장 간격 | 적용 시나리오 |
|---|---|---|
| 긴급 | 2-5m | 배포 후 회귀 테스트, 서비스 상태 점검 |
| 중요 | 10-15m | CI 모니터링, PR 리뷰 팔로업, API 이상 감지 |
| 일반 | 30m-2h | 코드 품질, 보안 스캔, 로그 트렌드 분석 |
| 저빈도 | 24h | 의존성 감사, 일일 보고서 생성, 브랜치 정리 |
/loop 프롬프트 작성 팁
| 팁 | 설명 | 예시 |
|---|---|---|
| 명확한 경고 조건 | 정보 과부하를 방지하기 위해 이상 발생 시에만 알림 | "실패 시 알려줘" (매번 보고하는 대신) |
| 행동 방안 지정 | 문제 발견 시 자동으로 수정 실행 | "수정 가능하면 바로 PR 생성" |
| 범위 제한 | 전체 프로젝트 스캔으로 인한 시간 낭비 방지 | "src/ 디렉토리 스캔" (모든 파일 대신) |
| 종료 조건 설정 | 무의미한 지속 실행 방지 | "3회 연속 통과 시 중단" |
| 외부 도구 조합 | /loop 출력을 알림 트리거로 활용 | "출력 내용을 alert.log에 기록하여 모니터링 시스템이 읽게 함" |
🎯 실전 제안: PR 순찰(#1-#2)과 배포 모니터링(#5)부터 시작해 보세요. 이 시나리오들의 투자 대비 효과(ROI)가 가장 높습니다. 익숙해지면 보안 스캔이나 코드 품질 관련 순환 작업을 추가해 보세요.
API를 통해 Claude 모델로 더 복잡한 자동화 작업을 구현하고 싶다면, APIYI(apiyi.com)를 통해 Claude Opus 4.6을 20% 할인된 가격으로 이용해 보시는 것을 추천합니다.
자주 묻는 질문 (FAQ)
Q1: /loop은 토큰을 얼마나 소모하나요?
매번 루프가 실행될 때마다 하나의 완전한 Claude 요청이 발생하며, 토큰 소모량은 작업의 복잡도에 따라 달라집니다. 간단한 상태 확인(#5)은 매회 약 5001,000 토큰, 복잡한 코드 리뷰(#10)는 매회 5,00010,000 토큰 정도 소모될 수 있습니다. 팁: 모니터링 작업은 짧은 간격(510분)으로, 분석 작업은 긴 간격(12시간)으로 설정하여 토큰 낭비를 방지하세요. APIYI(apiyi.com)를 통해 Claude API를 호출하면 20% 할인된 가격으로 이용할 수 있습니다.
Q2: 터미널을 닫으면 /loop 작업도 종료되나요?
네, 종료됩니다. /loop 작업은 Claude Code 세션이 활성화되어 있는 동안에만 실행됩니다. 터미널을 닫거나, 세션을 종료하거나, SSH 연결이 끊기면 모든 예약 작업이 사라지며 복구할 수 없습니다. 24시간 내내 지속되는 작업이 필요하다면 cron + claude -p를 조합한 헤드리스(headless) 모드를 사용하거나, 시스템 수준의 cron을 통해 Claude Code를 주기적으로 호출하는 방식을 권장합니다.
Q3: 50개의 동시 작업이면 충분한가요?
대부분의 상황에서 충분합니다. 본문에 소개된 20개의 프롬프트를 모두 실행해도 20개만 사용됩니다. 다만, 우선순위에 따라 선택적으로 실행하는 것을 권장합니다. PR 검토와 배포 모니터링은 필수(고가치)로 설정하고, 보안 스캔이나 코드 품질 검사는 필요할 때만 켜두세요. 또한, 각 작업은 실행될 때마다 토큰을 소모하므로 너무 많은 작업을 동시에 돌리면 할당량을 빠르게 소진할 수 있습니다.
Q4: /loop을 외부 알림(Slack/이메일)과 연동할 수 있나요?
/loop 자체적으로 알림을 직접 보내지는 않지만, 프롬프트에 외부 도구를 결합할 수 있습니다. 예를 들어 "경고 메시지를 ./alerts.log에 추가해줘"라고 설정한 뒤, 다른 스크립트로 해당 파일을 모니터링하며 Slack이나 이메일로 알림을 보내는 방식입니다. 더 고급 방법으로는 MCP 커넥터를 통해 Slack을 직접 제어하거나, 특정 이벤트 발생 시 Claude Code의 Hooks를 사용하여 알림을 트리거할 수 있습니다.
요약
Claude Code /loop 실용 프롬프트의 핵심 포인트:
- 6개 분야 20개 프롬프트: PR 검토(4개), 배포 모니터링(3개), 보안 스캔(3개), 코드 품질(4개), 로그 분석(3개), 팀 협업(3개) — 복사해서 바로 사용하세요.
- 좋은 프롬프트의 4요소: 간격 + 작업 + 알림 조건 + 행동 계획. 이상이 있을 때만 알림을 받고, 문제 발견 시 자동으로 수정하도록 설정하세요.
- PR 검토부터 시작하기: PR 검토와 배포 모니터링은 투자 대비 효율(ROI)이 가장 높은 분야입니다. 이 두 가지부터 시작해 보세요.
APIYI(apiyi.com)를 통해 Claude Opus 4.6 API를 20% 할인된 가격으로 연동하는 것을 추천합니다. /loop 작업은 물론 다양한 AI 개발 환경에서 높은 동시성, 속도 제한 없는 안정적인 서비스를 누릴 수 있습니다.
📚 참고 자료
-
Claude Code 예약 작업 공식 문서: /loop 및 /schedule에 대한 전체 설명
- 링크:
code.claude.com/docs/en/scheduled-tasks - 설명: 문법, 제한 사항 및 설정 방법 포함
- 링크:
-
Claude Code /loop 실전 가이드: 3가지 실제 워크플로우 사례
- 링크:
medium.com/@joe.njenga/claude-code-loop-create-new-native-autonomous-loops-that-work - 설명: PR 검토, 빌드 모니터링 및 로그 스캔의 전체 구현 방법 포함
- 링크:
-
Claude Code /loop 자동화 개발 워크플로우: 상세 사용법 및 팁
- 링크:
verdent.ai/guides/claude-code-loop-command - 설명: 간격 선택, 프롬프트 최적화 및 외부 통합 방법 포함
- 링크:
-
APIYI 문서 센터: Claude Opus 4.6 API 20% 할인 연동
- 링크:
docs.apiyi.com - 설명: /loop 작업의 토큰 소모량은 APIYI를 통해 할인 혜택을 받을 수 있습니다.
- 링크:
작성자: APIYI 기술팀
기술 교류: 댓글로 자유롭게 의견을 나눠주세요. 더 많은 자료는 APIYI docs.apiyi.com 문서 센터에서 확인하실 수 있습니다.
