Claude Code /loop 명령으로 반복 작업 자동 실행하는 법

Claude Code 입문

Claude Code로 작업하다 보면 같은 명령을 일정 간격으로 반복해야 할 때가 있어요. /loop 명령 하나면 반복 작업을 자동화하고, 본래 작업에 온전히 집중할 수 있어요.

📌 3줄 요약

• /loop은 지정한 간격으로 프롬프트나 슬래시 명령을 자동 반복 실행하는 기능이에요.
• /loop 5m /commit처럼 한 줄로 설정하며, 자연어 프롬프트도 반복 대상으로 지정할 수 있어요.
• CI/CD 모니터링, 테스트 결과 확인, 파일 변경 감시 등 "잊으면 안 되는 반복 확인" 작업에 특히 유용해요.

📑 목차

• 1. /loop 명령이 필요한 순간
• 2. /loop 기본 문법과 설정 방법
• 3. 반복 실행 결과 확인과 중단 방법
• 4. /loop 실전 활용 시나리오와 팁

/loop 명령이 필요한 순간

Claude Code로 작업하다 보면 같은 명령을 일정 간격으로 반복해야 할 때가 있어요. 예를 들어, 빌드 상태를 5분마다 확인하거나, 배포 로그를 주기적으로 점검하는 상황이에요. 코드 리뷰를 요청해둔 뒤 승인 여부를 계속 확인하고 싶을 때도 마찬가지예요. 이런 작업은 한두 번이면 괜찮지만, 30분 넘게 반복해야 하면 금방 지치게 돼요.

이런 작업을 매번 수동으로 입력하면 번거로울 뿐 아니라 빠뜨리기도 쉬워요. /loop 명령은 지정한 간격으로 프롬프트나 슬래시 명령을 자동 반복 실행해 주는 기능이에요. 쉽게 비유하면, 스마트폰의 반복 알람과 비슷해요. 한 번 설정해두면 정해진 시간마다 Claude Code가 알아서 해당 작업을 수행하는 구조예요.

💬 수동 반복의 가장 큰 문제는 다른 작업에 집중하기 어렵다는 점이에요. "5분 뒤에 다시 확인해야지"라고 머릿속에 담아두면, 정작 코드 작성에 온전히 몰입할 수가 없어요. /loop를 활용하면 이런 반복 부담 없이 본래 작업에 집중할 수 있어요. 사람이 일일이 기억하고 있을 필요가 없다는 점이 가장 큰 장점이에요.

💬 제가 직접 써보니까, 배포 파이프라인 모니터링처럼 "잊어버리면 안 되는 반복 확인" 작업에 특히 효과적이었어요. 터미널을 켜두고 다른 작업을 하면서도 상태 변화를 놓치지 않을 수 있었어요. 특히 CI/CD 빌드처럼 완료 시점을 예측하기 어려운 작업에서 진가를 발휘해요.

 

/loop 기본 문법과 설정 방법

/loop 명령의 기본 형식은 아주 단순해요. Claude Code 입력창에 아래처럼 입력하면 바로 시작돼요.

/loop 5m /commit

이 명령은 5분 간격으로 /commit 슬래시 명령을 자동 실행하라는 뜻이에요. 5m은 5분(minute)을 의미하며, 간격을 지정하지 않으면 기본값인 10분이 적용돼요. 시간 단위는 분(m) 단위로 설정해요. 예를 들어, 10m은 10분, 30m은 30분 간격이에요. 처음 사용할 때는 5분이나 10분처럼 넉넉한 간격부터 시작하는 것을 권장해요.

슬래시 명령 대신 일반 프롬프트(prompt, AI에게 보내는 지시문)도 사용할 수 있어요. 아래처럼 자연어 문장을 반복 실행 대상으로 지정하는 것도 가능해요. 이 점이 /loop를 특히 유연하게 만들어주는 부분이에요.

/loop 10m git status를 확인하고 변경사항이 있으면 알려줘

이렇게 하면 10분마다 Claude Code가 git status를 확인하고 결과를 보고해요. 자연어로 작성하기 때문에 정해진 명령어 형식을 외울 필요가 없어요. "이런 걸 확인해줘"라고 평소에 Claude Code에게 말하듯 작성하면 돼요. 슬래시 명령과 자연어 프롬프트 모두 반복 대상이 될 수 있다는 점이 편리해요.

 

설정 직후 Claude Code가 반복 작업 등록을 확인하는 메시지를 보여줘요. 이 메시지가 나타나면 정상적으로 스케줄이 걸린 거예요. 별도의 설정 파일을 만들거나 복잡한 옵션을 지정할 필요가 전혀 없어요.

💡 한 가지 알아둘 점은, 이 기능이 현재 세션(session, 하나의 대화 창) 안에서만 동작한다는 거예요. 세션을 닫으면 등록한 /loop도 함께 종료돼요. 그래서 실수로 무한 반복이 계속될까 걱정하지 않아도 돼요. 반대로 말하면, 장기간 돌려야 하는 작업은 세션을 유지해둬야 한다는 뜻이기도 해요.

반복 실행 결과 확인과 중단 방법

/loop를 설정하면 지정한 간격마다 Claude Code가 자동으로 작업을 수행해요. 실행할 때마다 결과가 대화창에 순서대로 출력돼요. 별도의 로그 파일을 열거나 다른 터미널 창을 확인할 필요가 없어요. 대화 흐름 안에서 모든 반복 실행 결과를 바로 확인할 수 있는 구조예요.

🔍 시간 순서대로 결과가 쌓이기 때문에 변화 추이를 파악하기에도 편리해요. 예를 들어, 빌드 상태가 "진행 중 → 진행 중 → 완료"로 바뀌는 과정을 한눈에 볼 수 있어요. 문제가 발생했을 때도 어느 시점부터 상태가 달라졌는지 쉽게 추적할 수 있어요. 마치 CCTV 녹화 영상을 시간순으로 돌려보는 것과 비슷한 효과예요.

 

반복을 멈추고 싶을 때는 새로운 메시지를 입력하면 돼요. 사용자가 직접 다른 명령이나 대화를 시작하면 진행 중이던 /loop 사이클이 중단돼요. 특별한 "중지" 명령을 따로 외울 필요 없이, 그냥 평소처럼 Claude Code를 사용하면 자연스럽게 종료되는 거예요. 또한 세션 자체를 종료해도 /loop는 자동으로 해제되기 때문에 안심하고 사용할 수 있어요.

⚠️ 한 가지 주의할 점은, 반복 간격이 너무 짧으면 API 사용량이 빠르게 늘어날 수 있다는 거예요. /loop는 매 실행마다 Claude Code에게 프롬프트를 보내는 것과 동일하게 동작해요. 1분 간격으로 설정하면 1시간에 60번 호출이 발생하는 셈이에요. 꼭 필요한 경우가 아니라면 최소 5분 이상 간격을 두는 것이 비용 면에서 안전해요.

반복 실행 중에도 결과를 보면서 더 이상 필요 없다고 판단되면 즉시 중단할 수 있어요. 이런 유연한 제어가 /loop를 부담 없이 쓸 수 있게 만드는 핵심 요소예요.

/loop 실전 활용 시나리오와 팁

/loop는 단순 모니터링 외에도 다양한 자동화 시나리오에 활용할 수 있어요. 대표적인 활용 사례 몇 가지를 소개할게요.

1

CI/CD 파이프라인(자동 빌드·배포 과정) 모니터링

배포를 시작한 뒤 아래 명령을 설정하면 빌드 상태를 자동으로 추적할 수 있어요. GitHub Actions 같은 CI 도구를 사용할 때 특히 유용해요.

/loop 5m gh run list --limit 1 결과를 확인하고 성공 여부를 알려줘

이렇게 설정해두면 배포가 완료되는 순간을 놓치지 않고 바로 다음 단계로 넘어갈 수 있어요. 빌드가 실패했을 때도 빠르게 인지할 수 있어서 대응 시간이 단축돼요.

2

테스트 결과 주기적 확인

장시간 테스트를 돌릴 때 진행 상황을 놓치지 않을 수 있어요. 특히 통합 테스트처럼 실행 시간이 긴 테스트에서 유용해요.

/loop 10m 테스트 로그 파일을 읽고 실패한 항목이 있으면 알려줘

3

파일 변경 감시 용도

특정 설정 파일이 바뀌었는지를 주기적으로 체크하는 방식이에요. 팀원이 공유 설정 파일을 수정했을 때 빠르게 인지하고 싶다면 이 방법이 효과적이에요.

 

실전에서 /loop를 효과적으로 쓰기 위한 팁도 정리해 드릴게요.

1

간격은 최소 5분 이상으로 설정하는 것이 안전해요. API 호출 비용과 속도를 함께 고려하면 5~10분이 적당해요.

2

반복할 프롬프트는 짧고 명확하게 작성해요. 긴 프롬프트를 반복하면 매번 토큰(token, AI가 처리하는 텍스트 단위)을 많이 소모하게 돼요.

3

세션을 오래 유지해야 하는 경우, 중간에 다른 질문을 하면 /loop가 중단된다는 점을 기억해 두세요. 모니터링 전용 세션을 별도로 열어두는 것도 좋은 방법이에요.

/loop는 복잡한 설정 파일 없이 한 줄로 반복 자동화를 구현할 수 있다는 것이 핵심이에요. 터미널 작업 스케줄러를 따로 배우지 않아도, Claude Code 안에서 바로 쓸 수 있다는 점이 입문자에게 특히 유용해요. cron이나 Windows 작업 스케줄러 같은 시스템 도구를 몰라도 동일한 효과를 낼 수 있어요.

처음에는 git status 확인처럼 가벼운 작업부터 시작해보는 것을 추천해요. 한두 번 결과를 확인하면서 간격을 조절해보면 금방 감이 잡혀요. 익숙해지면 빌드 모니터링, 로그 분석 같은 실전 시나리오로 점차 확장할 수 있어요. 반복 작업을 Claude Code에게 맡기고, 본인은 더 중요한 코드 작성에 집중하는 습관을 만들어 보세요.

✍️ 마치며

/loop는 Claude Code에서 반복 작업을 한 줄로 자동화하는 가장 간단한 방법이에요. 빌드 확인, 테스트 모니터링, 파일 변경 감시처럼 "잊으면 안 되는 반복" 작업을 맡겨두고, 여러분은 코드 작성에만 집중하세요. 오늘 바로 /loop 5m git status를 확인해줘부터 시도해 보는 건 어떨까요?

#ClaudeCode #loop명령 #반복자동화 #AI코딩도구 #개발생산성 #CICD모니터링