앤트로픽 클로드 코드(Claude Code) 팀이 '루프 엔지니어링' 입문 글을 공개하고, 클로드 코드 루프를 네 가지로 나눠 언제 무엇을 쓰면 되는지 정리했습니다.
요즘 AI 코딩 업계에서는 에이전트에게 매번 프롬프트를 쓰는 대신 '루프를 설계한다'는 말이 자주 나옵니다. 공식 글도 X(옛 트위터)에서 루프가 정확히 무엇인지 찾아보면 답이 제각각이라는 이야기로 시작합니다.
이번 포스팅에서는 클로드 코드 루프의 정의, 턴 기반·목표 기반·시간 기반·선제적 루프 4가지의 차이, /loop·/goal·/schedule 명령어 사용법, 코드 품질과 토큰 사용량을 관리하는 요령, 쓸 수 있는 요금제까지 정리하겠습니다.
클로드 코드 루프란?
클로드 코드 팀은 클로드 코드 루프를 '멈출 조건이 채워질 때까지 에이전트가 작업 주기를 되풀이하는 것'으로 정의합니다. 그리고 루프를 ① 무엇이 시작시키는지, ② 언제 멈추는지, ③ 클로드 코드의 어떤 기능을 쓰는지, ④ 어떤 작업에 맞는지에 따라 나눕니다.
가장 기본이 되는 것은 우리가 프롬프트를 보낼 때마다 도는 '에이전트 루프'입니다. 클로드는 맥락을 모으고, 작업을 실행하고, 결과를 확인한 뒤, 필요하면 이 과정을 반복하고 나서 답을 돌려줍니다.
그림 아래 문구처럼 이 루프는 클로드가 작업이 끝났다고 판단하거나 정해진 노력(effort) 예산을 다 쓰면 끝납니다. 공식 글은 루프마다 사람이 넘기는 것이 다르다고 설명합니다. 턴 기반은 결과 확인, 목표 기반은 멈출 조건, 시간 기반은 시작 계기, 선제적 루프는 프롬프트 자체를 넘깁니다.
| 루프 종류 | 사람이 넘기는 것 | 언제 쓰나 | 쓰는 기능 |
| 턴 기반 | 결과 확인 | 탐색하거나 방향을 정하는 중일 때 | 직접 만든 검증 스킬 |
| 목표 기반 | 멈출 조건 | 완료된 모습이 분명할 때 | /goal |
| 시간 기반 | 시작 계기 | 프로젝트 밖의 일이 일정에 따라 생길 때 | /loop, /schedule |
| 선제적 | 프롬프트 자체 | 반복되고 기준이 명확한 일일 때 | 위 기능 전부 + 동적 워크플로 |
다만 공식 글은 모든 작업에 복잡한 클로드 코드 루프가 필요한 것은 아니라며, 가장 단순한 방법부터 시작하고 이 패턴들은 골라서 쓰라고 강조합니다.
1. 턴 기반 루프 – 검증 스킬로 턴 줄이기
턴 기반 클로드 코드 루프는 사용자의 프롬프트로 시작해, 클로드가 일을 마쳤다고 판단하거나 정보가 더 필요할 때 멈춥니다. 정해진 일정 없이 그때그때 하는 짧은 작업에 알맞습니다.
예를 들어 '좋아요 버튼을 만들어 줘'라고 하면 클로드는 코드를 읽고, 고치고, 테스트를 돌린 뒤 결과를 넘겨줍니다. 그다음 사람이 직접 확인하고 다음 프롬프트를 씁니다. 매 턴의 확인을 사람이 맡는 구조입니다.
공식 글은 이 확인 단계를 스킬(SKILL.md)로 문서화해 클로드가 자기 작업을 더 많이, 처음부터 끝까지 검증하게 하라고 권합니다. 글에 실린 프런트엔드 검증 스킬 예시는 대략 아래 순서입니다.
- 개발 서버를 띄우고 수정한 페이지를 브라우저로 연다
- 바뀐 부분을 직접 눌러 보고, 상태가 바뀌는지 확인한 뒤 전후 스크린샷을 남긴다
- 브라우저 콘솔에 새 오류·경고가 없는지 본다
- Chrome DevTools MCP로 성능을 측정하고 Core Web Vitals를 점검한다
- 하나라도 실패하면 고친 뒤 처음부터 다시 확인한다
✅ 확인 기준이 숫자처럼 측정 가능할수록 클로드가 스스로 검증하기 쉽습니다. 이를 위해 결과를 보고, 재고, 조작할 수 있는 도구나 커넥터를 스킬에 함께 넣어 두라는 것이 공식 글의 조언입니다.
2. 목표 기반 루프 – /goal 사용법
복잡한 작업은 한 턴으로 끝나지 않는 경우가 많습니다. 목표 기반 클로드 코드 루프는 /goal 명령어로 '완료된 상태'를 미리 정해 두고, 그 조건을 채우거나 정한 턴 수에 닿을 때까지 클로드가 계속 일하게 합니다.
핵심은 판정을 일하는 모델이 아닌 별도의 평가 모델이 한다는 점입니다. 클로드가 턴을 마칠 때마다 평가 모델이 조건을 확인하고, 아직이면 다시 작업으로 돌려보냅니다. 공식 글의 예시는 이렇습니다./goal get the homepage Lighthouse score to 90 or above, stop after 5 tries.
홈페이지 라이트하우스 점수를 90점 이상으로 올리되, 5번 시도하면 멈추라는 뜻입니다.
공식 문서에 따르면 평가 모델은 설정된 작고 빠른 모델이고, 도구를 쓰지 않아 대화에 드러난 내용만 보고 판단합니다. 그래서 'npm test가 종료 코드 0으로 끝난다'처럼 클로드의 출력으로 증명할 수 있는 조건을 쓰는 것이 좋습니다. 통과한 테스트 수나 점수 기준처럼 결과가 딱 떨어지는 조건이 특히 효과적이라고 공식 글은 설명합니다.
/goal 조건: 목표를 걸고 바로 작업 시작(세션당 1개, 조건은 최대 4,000자)/goal: 현재 조건, 경과 시간, 평가한 턴 수, 토큰 사용량, 최근 판정 이유 확인/goal clear: 목표 해제(stop, off, cancel 등도 같은 뜻)
✅ /goal은 권한 모드를 바꾸지 않습니다. 수동 모드에서는 설정에서 미리 허용하지 않은 도구를 쓸 때마다 여전히 승인을 묻기 때문에, 자리를 비운 채 돌리려면 자동 모드에서 실행하라고 공식 문서는 안내합니다. 자동 모드가 한 턴 안의 승인을 없앤다면, /goal은 턴과 턴 사이의 프롬프트를 없애는 셈입니다.
3. 시간 기반 루프 – /loop와 /schedule 차이
할 일은 같고 입력만 바뀌는 반복 작업이 있습니다. 매일 아침 슬랙 메시지를 요약하거나, 리뷰 의견이 달리고 CI가 실패할 수 있는 PR을 지켜보는 일이 그렇습니다. 시간 기반 클로드 코드 루프는 정해진 간격마다 같은 프롬프트를 다시 실행해 이런 일을 맡습니다.
공식 글의 예시는 5분마다 내 PR을 확인해 리뷰 의견을 반영하고 실패한 CI를 고치라는 명령입니다./loop 5m check my PR, address review comments, and fix failing CI
/loop 입력 방법 3가지
| 입력 | 예시 | 동작 |
| 간격 + 프롬프트 | /loop 5m check the deploy | 정한 간격마다 고정 실행 |
| 프롬프트만 | /loop check the deploy | 클로드가 매번 1분~1시간 사이에서 간격을 정함 |
| 아무것도 없음(또는 간격만) | /loop | 내장 유지보수 프롬프트 또는 loop.md 내용 실행 |
간격 단위는 초(s), 분(m), 시간(h), 일(d)을 쓸 수 있고, 초는 1분 단위로 올림됩니다. /loop 20m /review-pr 1234처럼 스킬을 반복 실행할 수도 있습니다. 프롬프트 없이 /loop만 쓰면 남은 작업 이어 하기, 현재 브랜치 PR의 리뷰 의견·실패한 CI·병합 충돌 처리, 정리 작업 순으로 진행합니다.
알아 둘 제약도 있습니다. /loop는 내 컴퓨터의 열린 세션 안에서만 돌기 때문에 터미널을 닫거나 컴퓨터를 끄면 멈춥니다. 반복 작업은 만든 지 7일이 지나면 자동으로 끝나고, 한 세션에는 최대 50개까지 예약할 수 있습니다. 간격을 직접 정한 루프는 클로드에게 취소해 달라고 하면 멈추고, 클로드가 간격을 고르는 루프는 다음 실행을 기다리는 동안 Esc로 멈춥니다.
/schedule로 클라우드에서 돌리기
컴퓨터를 꺼도 돌아가야 한다면 /schedule로 클라우드 예약 작업(예전 이름 루틴)을 만듭니다. 앤트로픽 클라우드에서 실행되고, 일정 외에 API 호출이나 깃허브 이벤트로도 시작할 수 있습니다. 현재 리서치 프리뷰 단계이며, 웹(claude.ai/code/routines)이나 데스크톱 앱에서도 관리할 수 있습니다.
| 구분 | 클라우드(/schedule) | 데스크톱 예약 작업 | /loop |
| 실행 위치 | 앤트로픽 클라우드 | 내 컴퓨터 | 내 컴퓨터 |
| 컴퓨터 꺼도 실행 | 예 | 아니요 | 아니요 |
| 열린 세션 필요 | 아니요 | 아니요 | 예 |
| 내 컴퓨터 파일 접근 | 아니요(저장소 새로 복제) | 예 | 예 |
| 최소 간격 | 1시간 | 1분(양식으로 만들면 1시간) | 1분 |
※2026. 10. 29(목) 기준
✅ 공식 글은 시간 기반 루프의 사용량을 줄이려면 간격을 길게 잡거나, 시간 대신 이벤트가 생길 때 반응하게 만들라고 조언합니다.
4. 선제적 루프 – 사람 없이 도는 클로드 코드 루프
선제적 클로드 코드 루프는 실시간으로 지켜보는 사람 없이 이벤트나 일정에 따라 스스로 시작합니다. 각 작업은 목표를 채우면 끝나고, 루틴 자체는 사용자가 끌 때까지 돕니다. 버그 리포트 처리, 이슈 분류, 마이그레이션, 의존성 업그레이드처럼 반복되고 기준이 분명한 일에 맞습니다.
새로 생긴 명령어가 아니라 앞의 기능을 조합해 만듭니다. 들어오는 피드백을 처리하는 예시로 공식 글은 아래 조합을 듭니다.
- /schedule: 새 리포트를 확인하는 루틴을 정해진 시간마다 실행
- /goal과 스킬: 무엇이 '완료'인지 정하고, 검증 방법은 스킬로 문서화
- 동적 워크플로: 리포트마다 분류·수정·리뷰를 맡는 에이전트들을 조율
- 자동 모드: 루틴이 권한을 묻느라 멈추지 않게 함
이를 합치면 '매시간 피드백 채널에서 버그 리포트를 확인하고, 이번에 찾은 리포트를 모두 분류·조치·답변할 때까지 멈추지 말 것, 버그를 고칠 때는 병렬 작업 공간에서 세 가지 해법을 시도하고 판정 에이전트가 깐깐하게 리뷰할 것' 같은 프롬프트가 됩니다.
※ 동적 워크플로: 클로드가 작성한 스크립트로 많은 서브에이전트를 한꺼번에 돌리는 클로드 코드 기능입니다. 공식 글에서는 리서치 프리뷰로 소개됐고, 문서상 모든 유료 요금제에서 쓸 수 있지만 Pro는 /config에서 직접 켜야 합니다.
공식 글은 이런 루틴에는 작고 빠른 모델을 쓰고, 판단이 필요한 부분에만 가장 성능 좋은 모델을 쓰라고 권합니다. 작고 빠른 모델이 궁금하다면 클로드 하이쿠 5.5를, 가장 강한 모델은 클로드 오퍼스 5.5의 성능과 가격을 참고하세요.
클로드 코드 루프 품질 관리와 토큰 절약법
클로드 코드 루프가 내놓는 결과의 질은 루프를 둘러싼 환경에 달려 있습니다. 공식 글이 꼽은 품질 관리 요령은 네 가지입니다.
- 코드베이스를 깨끗하게: 클로드는 이미 있는 패턴과 규칙을 따라 합니다
- 스스로 검증할 방법 주기: 팀이 생각하는 '좋은 결과'를 스킬로 정리합니다
- 문서를 가까이: 프레임워크·라이브러리 문서에 최신 모범 사례가 있습니다
- 리뷰는 다른 에이전트에게: 맥락이 새로운 리뷰어가 덜 치우칩니다. 내장
/code-review스킬이나 깃허브용 Code Review를 쓸 수 있습니다
결과가 기준에 못 미치면 그 문제 하나만 고치고 끝내지 말고, 다음 반복부터는 같은 실수가 나오지 않도록 스킬이나 규칙에 반영하라는 것도 공식 글의 조언입니다. 사람이 일일이 지시하지 않아도 일하는 코딩 에이전트의 흐름은 AI 소프트웨어 엔지니어 데빈 글에서도 볼 수 있습니다.
클로드 코드 루프는 오래 돌수록 토큰을 많이 씁니다. 공식 글이 제시한 사용량 관리법은 다음과 같습니다.
- 작업에 맞는 기능과 모델 고르기: 작은 일에는 여러 에이전트나 루프가 필요 없습니다
- 성공·중단 기준을 구체적으로 정하기
- 큰 실행 전에 일부만 시범 운영하기: 동적 워크플로는 에이전트 수백 개를 띄울 수 있습니다
- 정해진 절차는 스크립트로 처리하기: 매번 추론하는 것보다 스크립트를 실행하는 편이 쌉니다
- 지켜보는 대상이 바뀌는 주기에 맞춰 실행 간격 정하기
- 사용량 확인하기: /usage(스킬·서브에이전트·MCP별), 인자 없이 입력한 /goal(지금까지 턴 수·토큰), /workflows(에이전트별 토큰, 중간 중지 가능)
✅ 공식 글은 모델과 노력 수준(effort) 선택이 루프 비용을 좌우하는 가장 큰 요소 중 하나라고 짚습니다.
클로드 코드 루프 쓸 수 있는 요금제와 시작 방법
클로드 코드 루프는 클로드 코드의 기능이라 클로드 코드가 포함된 유료 요금제가 필요합니다. 무료(Free) 요금제에는 클로드 코드가 포함되지 않습니다. 요금제 페이지에는 달러 가격만 표시되어 있고 원화 가격은 없습니다.
| 요금제 | 가격(세금 별도) | 클로드 코드 | 클라우드 예약 작업(/schedule) |
| Free | $0 | 미포함 | 불가 |
| Pro | 월 $20(연간 결제 시 월 $17) | 포함 | 가능 |
| Max | 월 $100부터 | 포함 | 가능 |
| Team | 스탠다드 시트 월 $25(연간 결제 시 $20) | 포함 | 가능 |
| Enterprise | 시트당 월 $20(연간, 최소 20시트) + 사용량 별도 | 포함 | 가능 |
※2026. 10. 29(목) 기준
시작은 거창할 필요가 없습니다. 공식 글은 지금 하는 일 중 내가 병목인 작업 하나를 골라 어느 부분을 넘길 수 있는지부터 생각해 보라고 합니다. 확인 절차를 글로 정리할 수 있다면 검증 스킬, 완료 기준이 분명하다면 /goal, 일이 일정에 맞춰 들어온다면 /loop나 /schedule이 출발점입니다.
클로드 코드 루프를 돌린 뒤에는 어디서 막히는지, 어디서 시키지 않은 일까지 하는지 지켜보고 계속 고쳐 나가면 됩니다. 클로드 코드에 외부 도구를 붙여 활용하는 예는 REA 사용법 글에서도 볼 수 있습니다.
지금까지 클로드 코드 루프의 정의와 4가지 루프, /loop·/goal·/schedule 사용법, 품질과 토큰 관리 요령에 대해 함께 살펴보았습니다.
코딩 에이전트를 쓰는 방식이 '잘 묻는 법'에서 '잘 돌아가게 짜는 법'으로 옮겨 가고 있습니다. 다만 루프가 길어질수록 비용과 검증 부담도 커지니, 공식 글의 조언대로 가장 단순한 루프부터 하나씩 늘려 가는 것이 좋겠습니다.
