Claude Loops는 Claude를 단발성 채팅이 아니라 반복 실행되는 작업 루프로 설계하는 Anthropic의 가이드다. 핵심은 “한 번 답하고 끝”에서 벗어나, 목표 달성·정해진 시간·외부 이벤트를 기준으로 Claude가 계획, 실행, 점검, 수정 단계를 반복하게 만드는 것이다.
세 가지 루프
| 루프 | 트리거 | 예시 |
|---|---|---|
| 목표 기반 루프 | 특정 목표가 끝날 때까지 반복 | 테스트가 통과할 때까지 코드 수정 |
| 시간 기반 루프 | 일정 주기마다 반복 | 매일 아침 리포트 작성, 주간 코드 정리 |
| 능동형 루프 | 이벤트나 상태 변화에 반응 | 새 이슈·PR·알림을 감지해 작업 시작 |
이 패턴은 claude-code-routines와 연결된다. 루틴은 스케줄과 이벤트로 작업을 시작하고, 루프는 시작된 작업 안에서 에이전트가 어떻게 반복할지를 정한다.
설계 원칙
좋은 루프는 “계속 해”라는 프롬프트가 아니다. 종료 조건과 검증 조건이 분명해야 한다.
- 목표를 관찰 가능한 상태로 정의한다.
- 각 반복마다 무엇을 확인할지 정한다.
- 실패 시 같은 행동을 반복하지 않도록 로그와 반성 단계를 둔다.
- 사람이 승인해야 하는 지점과 자동 진행 가능한 지점을 나눈다.
- 비용·시간·위험 상한을 둔다.
실무 예시
목표: failing test 3개를 통과시킨다.
반복:
1. 실패 로그를 읽는다.
2. 가장 작은 수정 후보를 적용한다.
3. 관련 테스트만 실행한다.
4. 통과하면 전체 테스트로 확대한다.
종료: 전체 테스트 통과 또는 같은 실패 3회 반복.관련 문서
- claude-code-routines — 스케줄·API·GitHub 이벤트로 Claude Code 작업 자동화
- loop-library — 반복 가능한 AI 에이전트 루프 카탈로그
- long-running-agents — 장시간 자율 작동하는 에이전트 설계
- self-improving-agent-loops — 자기 개선형 에이전트 루프
참고 자료
- Getting started with loops — Claude Blog (2026-06-30)