클로드코드 Dynamic Workflows 완벽 정리: 1,000개 에이전트를 코드로 조율

클로드코드 Dynamic Workflows는 2026년 5월 28일 Claude Code v2.1.154와 함께 공개된 새 기능이에요. 한마디로, Claude가 작업을 처리할 JavaScript 오케스트레이션 스크립트를 직접 작성하고, 별도 런타임이 그 스크립트를 백그라운드에서 돌리면서 다수의 subagent를 대규모로 조율하는 기능입니다. 기존 멀티에이전트가 4~5개에서 멈췄다면, 이건 한 번에 최대 1,000개까지 갑니다.

한 줄 요약: 클로드코드 Dynamic Workflows는 오케스트레이션을 모델 판단이 아니라 코드로 옮겨 토큰을 절감하고 재현성을 확보합니다.

클로드코드 Dynamic Workflows란 무엇인가

클로드코드 Dynamic Workflows의 정식 명칭은 Dynamic Workflows(동적 워크플로우)예요. Claude Code 워크플로우 기능에 대한 공식 정의는 이렇습니다. "동적 워크플로우는 subagent를 대규모로 조율하는 JavaScript 스크립트다. Claude가 작업에 맞춰 스크립트를 작성하고, 런타임이 백그라운드에서 실행하는 동안 세션은 계속 응답 가능 상태로 유지된다."

핵심은 두 가지예요. 첫째, 오케스트레이션 로직을 사람이 아니라 Claude가 쓴다는 것. 둘째, 그 로직이 평범한 코드 파일이라 백그라운드에서 돌아간다는 것이죠.

한 문장 정의

Dynamic Workflows: Claude가 작성한 JavaScript 스크립트가 subagent들을 대규모로 조율하고, 런타임이 백그라운드에서 실행하는 Claude Code의 오케스트레이션 기능.

왜 중요한가 — "계획이 코드로 이동한다"

기존 subagent 방식은 Claude가 매 턴마다 "다음에 무엇을 spawn할지"를 결정하는 모델 주도(turn-by-turn) 오케스트레이션이었어요. 문제는 모든 중간 결과가 Claude의 context로 돌아온다는 점입니다. 작업이 커질수록 context가 빠르게 차고, 같은 작업을 두 번 돌리면 결과가 달라지기도 했죠.

Dynamic Workflows는 루프, 분기(conditional), fan-out, 중간 결과를 전부 JavaScript 스크립트가 보유해요. 그래서 Claude의 context에는 최종 답만 남습니다. 결과적으로 두 가지 이득이 생겨요.

토큰 절감: 중간 과정이 대화 context를 거치지 않습니다.
재현성(결정론): 일반 코드 제어 구조라 매번 동일하게 동작하고, 중간에 멈춰도 이어서 재개할 수 있어요.

클로드코드 Dynamic Workflows는 어떻게 동작하는가

흐름은 이렇게 정리돼요.

사용자가 자연어로 작업을 요청합니다.
Claude가 loops, conditionals, pipelines, parallel execution, schemas, arguments, budgets, retry 같은 요소를 담은 JavaScript 스크립트를 작성합니다.
런타임이 그 스크립트를 백그라운드에서 phase별로 실행합니다. 중간 상태는 스크립트 변수에 보관돼요.
작업을 fresh-context subagent들로 fan-out하고, 답이 수렴할 때까지 반복(loop-until-converge)합니다.
검증을 통과한 최종 결과를 단일 리포트로 보고합니다.

adversarial 검증이란

여기서 빛나는 게 adversarial 검증(반박 패턴)이에요. subagent가 결과만 보고하는 게 아니라, 다른 subagent가 그 주장을 반박(refute)하는 임무를 맡습니다. 예를 들어 한 subagent가 "이 함수에 race condition이 있다"고 주장하면, 다른 subagent의 일은 그것을 반증하는 거예요. 반박을 통과한 주장만 사용자에게 도달합니다.

Claude Code 워크플로우와 기존 기능의 차이 (비교표)

구분	오케스트레이터	중간 결과 위치	스케일	결정론/재현성
Subagents (단일 세션)	Claude(모델) turn-by-turn	Claude context로 회귀	보통 4~5개	비결정론
Agent Teams	team lead 세션 조율	각 teammate 자체 context	다수 세션 조율(실험적)	비결정론
Dynamic Workflows	JavaScript 스크립트(코드)	스크립트 변수(대화 밖)	동시 16, 총 1,000	결정론 + 재개 가능
Agent SDK	메인 에이전트(코드)	isolated context, 요약만 회귀	다수 병렬	개발자 코드 의존

스케일을 다시 짚으면, 동시 실행 최대 16개(CPU 코어가 적은 머신은 더 적음) + 1회 실행당 총 최대 1,000개 subagent예요. 참고로 v2.1.154 자체가 총 44개 변경(신규 기능 7, 개선 5, 보안 수정 3, 버그 수정 24, deprecation 1)을 담은 큰 릴리스였습니다.

어떤 작업에 쓰면 좋은가

공식 문서가 제시하는 use case는 네 가지예요.

codebase 전체 버그 스윕
대규모 반복 변경 (500개 파일, 수십만 줄 규모 마이그레이션을 kickoff부터 merge까지)
여러 source를 서로 교차검증해야 하는 리서치 질문
커밋 전 여러 독립 각도에서 어려운 plan을 초안화

신호는 명확합니다. "한 대화가 조율할 수 있는 것보다 더 많은 에이전트가 필요할 때", 또는 "오케스트레이션을 읽고 재실행 가능한 스크립트로 코드화하고 싶을 때"예요.

클로드코드 Dynamic Workflows 시작 방법

생각보다 진입 장벽이 낮아요.

프롬프트에 "workflow"라는 단어를 쓰면 Claude가 워크플로우를 작성하도록 트리거됩니다. 최초 트리거 시에는 실행 예정 내용을 보여주고 확인을 요청해요.
가장 빠른 체험 경로는 v2.1.154부터 내장된 /deep-research입니다. 여러 source를 조사한 뒤 단일 리포트를 산출해요.
실행 상태와 이력은 /workflows 명령으로 조회합니다.

플랜별 활성화는 이렇게 나뉘어요. Max와 Team은 기본 on, Enterprise는 관리자 활성화 필요, Pro는 /config의 Dynamic workflows 섹션에서 수동으로 켜면 됩니다. 가용 환경은 전 유료 플랜(Pro/Max/Team/Enterprise) + Anthropic API + Amazon Bedrock + Google Cloud Vertex AI + Microsoft Foundry입니다.

더 자세한 단계별 절차는 클로드코드 Dynamic Workflows 시작 가이드에서 이어집니다.

자주 묻는 질문 (FAQ)

Q. 클로드코드 Dynamic Workflows는 무료로 쓸 수 있나요? A. 전 유료 플랜(Pro/Max/Team/Enterprise)에서 사용할 수 있어요. Max와 Team은 기본 활성화, Enterprise는 관리자 활성화, Pro는 /config에서 수동으로 켜면 됩니다.

Q. 한 번에 몇 개의 에이전트까지 돌릴 수 있나요? A. 동시 실행 최대 16개(CPU 코어가 적은 머신은 더 적음), 1회 실행당 총 최대 1,000개 subagent까지 가능합니다. 기존 멀티에이전트 패턴이 보통 4~5개에서 멈췄던 것과 비교하면 자릿수가 다른 규모예요.

Q. Agent Teams나 Subagents와 뭐가 다른가요? A. 가장 큰 차이는 오케스트레이션이 코드로 옮겨간다는 점이에요. Subagents는 Claude가 매 턴마다 판단하고 중간 결과가 context로 돌아오지만, 클로드코드 Dynamic Workflows는 루프·분기·중간 결과를 JavaScript 스크립트가 보유해 결정론적으로 재현되고 재개도 가능합니다.

마무리

클로드코드 Dynamic Workflows의 의미는 "오케스트레이션이 모델의 결정에서 코드의 결정으로 옮겨갔다"는 데 있어요. 사람이 일일이 단계를 짜지 않아도, Claude가 검증 패턴까지 포함한 스크립트를 써서 대규모로 돌려줍니다. 다만 아직 research preview 단계라 한도(동시 16/총 1,000)와 플랜별 활성화 정책은 변경될 수 있으니, 클로드코드 Dynamic Workflows를 도입하기 전에 공식 문서를 한 번 더 확인하는 걸 권해요.

클로드코드 Dynamic Workflows: 1,000개 에이전트를 코드로 조율하기