Claude Code 자동화 기본 요소: 루프, 목표, 루틴, 동적 워크플로

Claude Code 자동화 기본 요소: 루프, 목표, 루틴, 동적 워크플로
Share

Anthropic은 Claude Code의 자동화를 루프, 목표, 루틴, 동적 워크플로라는 네 가지 조합 가능한 기본 요소로 다시 포장했다. 덕분에 개발자는 더 이상 직접 "루프" 안에서 반복하는 사람이 아니라, 스스로 실행되는 루프를 설계하는 사람이 된다. 네 요소 모두 Claude Code 프롬프트가 이미 수행하는 동일한 턴 기반 사이클을 감싼다. 프롬프트를 평가하고, 도구를 호출하고, 결과를 받은 뒤, 모델이 멈출 때까지 반복하는 방식이다.

루프, 목표, 루틴, 동적 워크플로가 함께 작동하는 방식

이 네 가지 기본 요소는 세션 단위 폴링부터 클라우드에 유지되는 스케줄링, 멀티 에이전트 오케스트레이션까지 이어지는 스펙트럼을 이룬다. 각각은 Claude Code의 핵심 모델-도구 while 루프 위에 얇게 얹힌 제어 계층이다 . 루프(/loop)는 프롬프트를 일정 간격으로 다시 실행하며, 최소 1분 단위까지 설정할 수 있다. 세션당 예약 작업은 50개로 제한되고, 7일 후 자동 만료되며, 로컬 파일 접근 권한이 있는 세션이 열린 상태에서만 작동한다 . 목표(/goal)는 검증 가능한 종료 상태를 정의한다. 별도의 빠른 평가기가 Claude가 작업을 끝내려 할 때마다 중지 조건을 확인하고, 목표가 충족되거나 턴 제한에 도달할 때까지 다시 돌려보낸다 .

루틴은 반복 작업을 Anthropic이 관리하는 클라우드 인프라로 옮긴다. 로컬 파일에는 접근할 수 없지만, 머신이 종료되어도 유지되며 스케줄, API POST, GitHub 이벤트로 실행된다 . 동적 워크플로는 오케스트레이션 계층이다. Claude가 수십 개의 병렬 서브에이전트로 작업을 펼치는 JavaScript 스크립트를 자동으로 작성하고, 중간 결과를 Claude의 컨텍스트 창이 아니라 스크립트 변수에 보관한다. 따라서 최종 답변만 컨텍스트로 돌아온다 .

기본 요소실행 위치종료 후 유지 여부주요 제한
/loop로컬 세션아니요작업 50개 이하, 7일 만료
/goal로컬 세션아니요활성 목표 1개, 턴 제한
루틴Anthropic 클라우드로컬 파일 접근 불가
동적 워크플로백그라운드 JS 런타임종료 시 재시작동시 실행 16개 이하, 실행당 에이전트 1,000개

규모를 보여주는 사례도 분명하다. Jarred Sumner는 동적 워크플로를 사용해 Bun 약 750,000줄을 Zig에서 Rust로 포팅했고, 기존 테스트 스위트의 99.8%가 통과했으며, 첫 커밋부터 병합까지 걸린 시간은 11일이었다 . Source video: Anthropic walkthrough.

태그와 플랜을 먼저 확인해야 하는 이유

How Loops, Goals, Routines, and Dynamic Workflows Compose (source: mer.vin)

무엇을 조합하든 먼저 Claude Code 버전과 플랜을 확인해야 한다. 각 기본 요소마다 필요한 최소 조건이 다르기 때문이다. /loop에는 v2.1.72 이상이 필요하다 . /goal에는 2026년 5월 11일에 추가된 v2.1.139가 필요하며, 세션당 활성 목표는 하나이고 재개 시 복원된다 . 동적 워크플로는 2026년 5월 28일에 정식 제공되기 시작했고 v2.1.154 이상이 필요하다 . 실질적인 모든 작업을 자동 오케스트레이션하는 세션 단위 Ultracode 모드와 "Large workflow" 경고는 모두 v2.1.203 이상과 xhigh 지원 모델이 필요하다. Ultracode를 활성화해도 현재 세션에서만 유지된다 .

플랜 제한도 중요하다. 동적 워크플로는 모든 유료 플랜과 Anthropic API, Amazon Bedrock, Vertex, Agent Platform, Microsoft Foundry에서 실행할 수 있으며, /config의 Dynamic workflows 행에서 활성화한다 . 루틴은 웹에서 Claude Code가 활성화된 Pro, Max, Team, Enterprise 플랜이 필요하며 아직 연구 프리뷰 상태다. 따라서 동작, 제한, API 표면은 바뀔 수 있다. API는 베타 헤더 experimental-cc-routine-2026-04-01을 사용한다 .

각 프리미티브를 켜고 조합하는 방법

Tag and Plan Prerequisites (source: mer.vin)

자율성이 낮은 것부터 높은 순서로 네 가지 프리미티브를 활성화하면 됩니다. /loop/goal은 열린 Claude Code 세션 안에서 호출하는 세션 범위 슬래시 명령이고, 루틴은 Claude Code 웹 UI에 저장하며, 동적 워크플로는 자연어로 트리거합니다. 각각은 스케줄링, 검증, 지속성, 병렬 오케스트레이션이라는 서로 다른 실패 모드를 겨냥하므로 계층마다 설정 방식도 다릅니다.

빠른 답변: 세션 안에서 스케줄링하려면 /loop 5m을 입력하고(최대 50개 작업), 검증 가능한 최종 상태에는 /goal … stop after N tries를 사용하세요. 클라우드 실행이 필요하면 웹 UI에 루틴을 저장하고, 여러 에이전트로 작업을 분산하려면 "use a workflow"라고 말하면 됩니다. 단, 한 번 실행할 때 최대 1,000개로 제한됩니다.

루프(/loop). 세션이 열려 있는 동안 로컬 파일 접근 권한을 그대로 유지한 채, 1분 단위까지 내려가는 cron 같은 간격으로 반복 프롬프트를 예약합니다.

/loop 5m 열린 PR을 확인하고, 리뷰 코멘트를 처리하고, 실패한 CI를 고쳐줘

이 명령은 5분마다 실행됩니다. 한 세션에는 최대 50개의 예약 작업을 둘 수 있고, 놓친 실행은 나중에 따라잡지 않으며, 반복 작업은 안전 한계로 생성 후 7일이 지나면 자동 만료됩니다. 세션이 닫히는 순간 작업 실행도 멈춥니다.

목표(/goal). 절차 대신 검증 가능한 최종 상태와 시도 횟수 제한을 정의합니다.

/goal 홈페이지 Lighthouse 점수를 90 이상으로 만들고, 5번 시도한 뒤 멈춰줘

Claude가 멈추려고 할 때마다 별도의 빠른 평가 모델이 조건을 확인합니다. 이 평가는 Claude가 대화에 드러낸 내용만 사용하며, 자체적으로 도구를 실행하거나 파일을 검사하지 않습니다. /goal만 실행하면 지금까지의 턴 수와 토큰 사용량을 보고합니다.

루틴. Claude Code 웹 UI에서 프롬프트와 함께 저장소, 환경, 커넥터, 트리거를 저장합니다. 트리거는 일정, API POST, GitHub 이벤트가 될 수 있고, 하나의 루틴에 함께 조합할 수도 있습니다. 실행은 대화형 승인 프롬프트 없이 전체 클라우드 세션으로 수행됩니다.

동적 워크플로. 자연어로 "use a workflow"라고 말하거나, 단일 실행에는 ultracode를 입력하거나, 전체 세션에 적용하려면 /effort ultracode를 설정하세요. 그러면 Claude가 JavaScript 스크립트를 자동 생성합니다. 성공한 실행의 스크립트는 .claude/workflows/<name>.js에 저장해 재사용 가능한 /<name> 명령으로 만들 수 있으며, 런타임 입력은 args 전역으로 전달합니다. 확장성도 실제적입니다. Claude Code의 제작자로 소개된 Boris Cherny는 밤새 "몇천 개"의 에이전트를 실행했다고 설명했습니다.

자주 터지는 실수와 오해

How to Enable and Compose Each Primitive

가장 흔한 실패는 /loop를 지속적인 자동화로 여기는 것입니다. 이것은 세션 범위 기능입니다. 루프는 사용자의 머신에서 세션이 열려 있을 때만 실행되고, 세션이 닫히는 순간 작업이 멈추며, 반복 작업은 생성 후 7일이 지나면 만료됩니다 . 재부팅 후에도 살아남아야 하거나 무인 일정으로 돌아가야 하는 작업은 루틴에 넣어야 합니다. 루틴은 사용자의 머신이 켜져 있는지와 관계없이 Anthropic이 관리하는 클라우드 인프라에서 실행됩니다 .

두 번째 함정은 /goal 안에 있습니다. 별도의 평가 모델은 독립적으로 도구를 실행하거나 파일을 검사하지 않습니다. 목표는 Claude가 대화 기록에 드러낸 증거만큼만 검증 가능하므로, 증명이 대화에 나타나지 않으면 실제로는 충족되지 않았는데도 달성된 것처럼 판정될 수 있습니다 . 테스트 통과 개수, Lighthouse 90점 같은 명확하고 정량적인 기준은 안정적으로 작동합니다. 반대로 모호한 정성 목표는 평가자가 통제하기 어려운 "이 정도면 충분하다"는 판단을 부릅니다 .

루틴에서는 인프라 상태가 초록색이라고 해서 작업 자체가 성공했다는 뜻은 아닙니다. 매번 실행 대화 기록을 확인해야 하며, API 표면은 research preview 상태라 예고 없이 바뀔 수 있습니다 . 동적 워크플로에도 경계가 있습니다. 실행 도중 사용자 입력을 받을 수 없고, 파일시스템이나 셸에 직접 접근하지 않습니다. 파일을 건드리는 것은 생성된 하위 에이전트뿐입니다. Claude Code를 종료하면 워크플로는 처음부터 새로 시작됩니다. 같은 세션 안에서는 완료된 하위 에이전트 결과를 캐시해 재개하지만, 세션을 넘는 지속성은 없습니다 . "Large workflow" 경고도 주의하세요. 예약된 하위 에이전트가 25개를 넘거나 예상 토큰이 150만 개를 넘으면 v2.1.203+에서 이 경고가 표시됩니다.

프리미티브 조합: 레시피와 예시

효과는 프리미티브를 겹쳐 사람이 더 이상 반복 루프 역할을 하지 않게 만들 때 나온다. 구체적인 파이프라인은 이렇다. /loop 5m이 5분마다 풀 리퀘스트 채널을 확인하고, /goal이 최종 상태를 "all review comments addressed and CI green"으로 정의하며, 동적 워크플로가 병렬 하위 에이전트를 펼쳐 실패한 각 체크를 분류하고 수정한다 . 루프는 실행 주기를, 목표는 검증 가능한 종료 조건을, 워크플로는 병렬 처리를 맡는다.

팬아웃 패턴을 직접 작성할 필요는 없다. 기본 제공되는 /deep-research 워크플로가 이미 포함되어 있다. 이 워크플로는 여러 관점으로 웹 검색을 나누고, 출처를 교차 확인하며, 인용이 포함된 보고서를 반환하기 전에 각 주장에 대해 투표한다. v2.1.196 기준으로 검증할 수 없는 주장은 반박하지 않고 "unverified"로 표시한다 . 이 스크립트는 팬아웃, 교차 확인, 투표 패턴을 재사용할 때 참고하기 좋다.

규모는 문제에 맞게 잡아야 한다. /config 가이드라인은 실행 규모를 small(하위 에이전트 5개 미만), medium(15개 미만), large(50개 미만)로 나누며, 문제를 해결할 수 있는 가장 작은 등급을 쓰라고 안내한다 . 프로덕션 규모의 사용 사례도 이미 공개되어 있다. Claude Code의 창시자로 소개된 Boris Cherny는 "5 to 10 concurrent sessions"와 밤새 "a few thousand"개의 에이전트를 실행했다고 설명했다 . 조합 레시피 하나로 시작해 매 실행을 검증하고, 더 작은 등급으로 부족할 때만 규모를 키워라.

자주 묻는 질문

Claude Code에서 /loop와 routine은 어떻게 다른가?

/loop는 세션 범위에서 동작한다. 전체 로컬 파일 접근 권한으로 일정 간격마다 프롬프트를 다시 실행하지만, 사용자의 머신에서 세션이 열려 있는 동안에만 실행된다. 세션당 예약 작업은 50개로 제한되며, 작업은 생성 후 7일이 지나면 만료된다 . 루틴은 Anthropic이 관리하는 클라우드 인프라에서 실행되므로 사용자의 머신이 켜져 있지 않아도 동작하지만, 로컬 파일에는 접근할 수 없다. Claude Code on the web이 활성화된 Pro, Max, Team, Enterprise 플랜이 필요하며, 현재는 리서치 프리뷰 상태다 . 대화형 폴링에는 루프를 쓰고, 종료 후에도 이어져야 하는 작업에는 루틴을 써라.

/goal은 목표 조건이 실제로 충족됐다고 보장하나?

아니다. Claude가 멈추려고 할 때마다 별도의 작은 평가 모델이 조건을 확인하고, 목표가 충족되거나 턴 한도에 도달할 때까지 Claude를 다시 작업으로 돌려보낸다. 단, 이 평가기는 도구를 실행하거나 파일을 독립적으로 읽지 않는다. transcript에 Claude가 드러낸 증거만 보고 판단한다 . 테스트 통과율, 기준값 이상의 Lighthouse 점수처럼 결정적이고 정량적인 종료 조건은 신뢰할 수 있다. "looks polished" 같은 정성적 목표는 그렇지 않다. 결국 "good enough" 판단이 그대로 남기 때문이다 .

동적 워크플로에는 어떤 Claude Code 버전이 필요한가?

동적 워크플로는 2026년 5월 28일에 일반 제공 상태가 되었고, v2.1.154 이상이 필요하다 . Large workflow 경고와 세션별 Ultracode(/effort ultracode)는 v2.1.203 이상이 필요하다 . 인접한 프리미티브는 더 먼저 나왔다. /goal은 2026년 5월 11일에 추가되었고 v2.1.139 이상이 필요하며, /loop는 v2.1.72 이상이 필요하다 .

동적 워크플로를 밤새 무인으로 실행할 수 있나?

아니다. 워크플로는 세션 범위에서 동작한다. 세션 안에서는 완료된 에이전트가 캐시된 결과를 반환하므로 실행을 재개할 수 있지만, Claude Code를 종료하면 워크플로는 처음부터 새로 시작된다. 세션을 넘어 지속되는 것은 없다 . 밤새 클라우드에 유지되는 실행이 필요하다면 대신 루틴을 써라. 루틴은 사용자의 머신이 켜져 있지 않아도 Anthropic 인프라에서 실행된다 . 실무적으로는 루틴이 일정에 맞춰 작업을 트리거하고, 각 실행 안에서 워크플로가 병렬 팬아웃을 처리하게 하는 방식이 좋다.

동적 워크플로는 하위 에이전트를 동시에 몇 개까지 실행할 수 있나?

워크플로는 동시에 최대 16개 에이전트를 실행한다. CPU가 낮은 머신에서는 더 적을 수 있으며, 실행당 전체 에이전트 수는 최대 1,000개로 제한된다. 한 실행에서 25개를 넘는 에이전트를 예약하거나 150만 토큰을 초과할 것으로 예상되면 "Large workflow" 경고가 발생하며(v2.1.203 이상), /config 규모 가이드라인은 실행을 small(5개 미만), medium(15개 미만), large(50개 미만) 에이전트로 분류한다 . 실행은 일반적인 세션보다 훨씬 많은 토큰을 소비할 수 있으므로, 규모를 키우기 전에 작은 등급으로 먼저 시험해라 .

이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.

구독하기