[클로드 코드] Dynamic Workflow 사용법, 이제 분업도 AI가 스스로 한다

AI를 활용하는 업무 방식이 달라지고 있습니다. 이제는 하나의 에이전트가 모든 작업을 순서대로 처리하는 것이 아니라, 업무의 특성에 맞춰 여러 에이전트를 동시에 실행하는 방향으로 변화하고 있습니다.

AI 활용이 익숙해지면서 점차 규모가 큰 프로젝트에까지 AI를 도입하려는 시도가 늘어났습니다. 작업을 잘게 나눠 처리하는 Subagent, 여러 에이전트가 협업하는 Agent Team을 넘어, 이제는 대규모 프로젝트 전체를 AI에게 맡기고자 하는 요구가 커진 것입니다. 이러한 흐름 속에서 Claude Code는 Dynamic Workflow를 선보였습니다.

이 글에서는 Claude Code의 Dynamic Workflow가 어떤 기능인지, 기존 멀티 에이전트 방식과 무엇이 다른지, 그리고 실제 개발 업무에서는 어떻게 활용할 수 있는지를 중심으로 정리해 보겠습니다. 

클로드 코드 Dynamic Workflow 핵심 요약

• 복잡한 업무를 여러 AI 에이전트가 나눠 처리합니다. Claude가 업무를 하위 작업으로 분리하고, 여러 Subagent를 동시에 실행합니다.
• 작업 계획을 스크립트로 관리합니다. Claude가 JavaScript 기반의 워크플로 스크립트를 작성합니다. 한 번 만든 작업 흐름은 저장한 뒤 다시 실행할 수 있습니다.
• 긴 작업을 백그라운드에서 실행합니다. 워크플로가 진행되는 동안에도 현재 Claude Code 세션을 계속 사용할 수 있습니다.
• 결과물을 교차 검증합니다. 여러 에이전트가 서로 다른 관점에서 결과물을 확인하고, 검증을 통과한 내용만 최종 답변에 반영합니다.
• 코드베이스 감사와 대규모 마이그레이션에 적합합니다. 여러 파일을 확인해야 하는 오류 탐색, 보안 검토, 리팩토링, 기술 조사에 활용할 수 있습니다.

클로드 코드 Dynamic Workflow란?

Dynamic Workflow는 여러 개의 Subagent를 하나의 실행 흐름 안에서 조율하는 Claude Code의 새로운 기능입니다. AI 스스로 복잡한 개발 업무를 여러 하위 작업으로 나눈 뒤, 수십에서 수백 개의 AI 에이전트가 병렬로 처리하도록 설계됐습니다.

이 기능의 핵심은 Claude가 사용자의 요청을 받아 오케스트레이션 스크립트를 직접 작성한다는 점입니다. 자연어의 요청을 Claude가 JavaScript 스크립트로 변환하고, 별도의 런타임이 이를 백그라운드에서 실행합니다. 덕분에 스크립트가 돌아가는 동안에도 대화 세션은 멈추지 않고 그대로 유지됩니다.

스크립트가 실행되면 에이전트들이 역할을 나눠 작업합니다. 일부 에이전트는 코드베이스를 분석하고, 다른 에이전트는 그 결과를 다른 관점에서 반박하거나 검증합니다. 답이 한쪽으로 수렴할 때까지 서로 다른 접근으로 작업을 반복해 결과물의 정확성을 끌어올립니다.

작업 중간에 생성되는 결과물은 Claude의 대화 맥락에 모두 들어가지 않고 별도의 스크립트 변수에 저장됩니다. 덕분에 작업 범위가 커져도 결과물이 컨텍스트 공간을 차지하지 않아, 큰 작업도 공간 부족의 문제 없이 작업을 처리할 수 있습니다. 

클로드 코드 Dynamic Workflow가 

주목받는 이유

1. AI가 스스로 업무를 여러 에이전트가 나눠 처리합니다

하나의 AI 에이전트가 대규모 코드베이스를 살펴보면 작업 시간이 길어질 수 있습니다. 확인해야 할 파일이 많아질수록 일부 내용을 빠뜨릴 가능성도 높아집니다.

Dynamic Workflow는 복잡한 업무를 여러 하위 작업으로 나눕니다. 여러 에이전트가 각자 맡은 영역을 병렬로 처리하고, 결과물을 다시 하나로 정리합니다.

이를 통해 개발자가 모든 작업을 직접 나눠 지시하지 않아도, 수백 개의 파일을 확인해야 하는 오류 탐색이나 마이그레이션 작업을 단계별로 관리할 수 있습니다. 

2. 작업 계획을 스크립트로 남길 수 있습니다

Dynamic Workflow는 실행 계획 자체를 코드로 옮깁니다. 반복문과 분기 조건, 중간 결과물, 검증 단계를 JavaScript 스크립트에서 관리합니다.

이를 통해 한 번 만든 워크플로를 저장하고 다시 실행할 수 있습니다. 매번 같은 작업 절차를 새롭게 설명하지 않아도 됩니다.

코드 리뷰와 보안 점검, 이슈 분류처럼 반복적으로 처리해야 하는 개발 업무에 유용하게 활용할 수 있습니다.

3. 결과물을 여러 관점에서 교차 검증합니다

Dynamic Workflow에서는 여러 에이전트가 독립적으로 문제를 분석합니다. 다른 에이전트가 발견된 내용을 다시 반박하거나 검토하도록 구성할 수도 있습니다.

단순히 에이전트 수를 늘리는 것이 아니라 검증 구조를 내장해 에이전트 스스로 여러 각도에서 계획을 작성해 서로 비교하도록 하여, 단일 패스보다 신뢰도 높은 결과를 만듭니다.

이를 통해 단순히 많은 결과물을 생성하는 데 그치지 않고, 검증을 통과한 내용만 최종 답변에 반영할 수 있습니다.

4. 긴 작업을 백그라운드에서 실행합니다

Dynamic Workflow는 백그라운드에서 실행됩니다. 워크플로가 진행되는 동안에도 현재 Claude Code 세션에서 다른 작업을 이어갈 수 있습니다.

덕분에 대규모 코드베이스 분석이나 마이그레이션처럼 오래 걸리는 작업도 흐름을 끊지 않고 진행할 수 있습니다.

진행 상황은 /workflows 명령어로 확인할 수 있습니다. 단계별 에이전트 수와 토큰 사용량, 실행 시간을 한눈에 살펴보고, 필요하면 워크플로를 일시 정지하거나 중단하는 것도 가능합니다. 덕분에 상황에 맞게 효율적으로 사용할 수 있습니다.

Dynamic Workflow는 

Subagent, Agent Team와 어떻게 다를까?

Claude Code에는 여러 에이전트를 활용할 수 있는 기능이 있습니다. 하지만 작업을 관리하는 방식과 적합한 규모가 다릅니다.

• 간단한 오류 수정이나 특정 파일 분석에는 Subagent만으로도 충분합니다. 여러 역할이 장시간 협업해야 한다면 Agent Team이 적합합니다.
• 반면 수백 개의 파일을 확인하거나 여러 관점의 검증이 필요한 작업이라면 Dynamic Workflow를 검토할 수 있습니다.

클로드 코드 Dynamic Workflow 사용법

Claude Code 버전 확인하기

Dynamic Workflow는 Claude Code v2.1.154 이상 버전에서 지원합니다. Claude Code 버전을 확인한 뒤 버전이 낮을 경우 claude update 명령어를 통해 버전을 업데이트합니다.

Config 메뉴에서 Dynamic Workflow 활성화하기

Claude Code가  v2.1.154 이상 버전으로 업데이트가 되었다면 /config 메뉴에서 Dynamic Workflow를 활성화합니다. /config 명령어를 입력하면 설정 목록을 확인할 수 있습니다.

/config 설정 목록을 보면 Dynamic Workflow가 false로 꺼져 있습니다. 좌우 화살표 키를 눌러 true로 변경합니다. 

Dynamic Workflow를 true로 활성화하면 /deep-research와 /workflows 명령어가 활성화되고, 이를 통해 Dynamic Workflow를 사용할 수 있습니다. 

/deep-research로 내장 워크플로를 바로 실행하거나, 프롬프트에 ultracode 키워드를 넣어 특정 작업을 워크플로로 처리할 수 있습니다. 

/effort ultracode를 켜두면 Claude가 작업마다 워크플로 사용 여부를 판단해 자동으로 Dynamic workflow를 실행합니다. 실행 중인 워크플로의 진행 상황은 /workflows에서 확인하고 관리합니다.

/deep-research로 Dynamic Workflow 실행하기

Dynamic Workflow는 여러 Subagent를 조율해 복잡한 작업을 단계별로 처리하는 구조입니다. /deep-research는 이 구조를 심층 조사에 적용한 내장 워크플로로, 사용자의 질문을 여러 관점으로 나누어 웹 검색을 진행합니다. 이후 수집한 출처를 교차 검증하고, 검증을 통과한 내용만 출처가 포함된 보고서로 정리합니다.

/deep-research가 Dynamic Workflow를 사용해 사용자의 명령을 어떻게 처리하는지 직접 시연해보겠습니다. 상황은 다음과 같습니다.

[MCP 서버를 안전하게 도입하기 위한 운영 기준 조사]

개발팀에서 Claude Code에 외부 MCP 서버를 연결하려 하지만, 어떤 위험을 확인해야 하는지 판단하기 어려운 상황입니다. 이럴 때 단순 검색은 몇 개의 문서를 읽고 요약하는 수준에 그칩니다.

반면 /deep-research를 실행하면 여러 에이전트가 보안 위험, 권한 관리, API Key 노출 가능성, 프롬프트 인젝션과 같은 항목을 나누어 조사합니다. 이후 출처가 다른 주장들을 교차 검증하고, 근거가 부족한 내용은 걸러냅니다.

이를 통해 개발팀은 MCP 서버를 도입하기 전에 확인해야 할 위험과 운영 기준을 체계적으로 정리할 수 있습니다.

테스트에 사용한 프롬프트

Claude Code에 MCP 서버를 연결했을 때의 안전성 및 사용 시 주의사항에 대한 보고서 작성을 요청하자, Dynamic Workflow가 활용된 것을 확인할 수 있었습니다. 하네스 구조로 설계된 deep-research가 실행되어 총 5단계(Scope → Search → Fetch → Verify → Synthesize)의 작업으로 진행되었습니다. 

Dynamic Workflow로 작업을 처리한 결과, 다음과 같이 5단계로 나뉘어 진행된 것을 확인할 수 있었습니다.

1. 사용자의 질문을 5개의 검색 각도로 분류하고
2. 분류된 유형에 맞춰 5가지 검색을 동시에 수행하고
3. 검색 결과 중 '검증 가능한 주장'만 추출하고
4. 추출된 주장의 사실관계를 다시 확인하고
5. 검증을 통과한 결과를 하나로 통합해 최종 보고서로 완성했습니다.

덕분에 사용자가 사실관계를 일일이 확인할 필요 없이, 곧바로 활용할 수 있는 정보로 정리되었습니다. 다만 작업 과정에서 여러 에이전트를 거쳐 검증 단계를 진행하다 보니, 평소보다 토큰 소비량이 많았고 27분 47초라는 긴 시간이 소요되었습니다.

따라서 Max 플랜에 비해 사용 한도가 상대적으로 낮은 Pro 사용자나, 여러 작업을 동시에 진행해야 하는 Max 사용자라면 Dynamic Workflow를 사용하기 전에 사용량을 한 번 고려해 보는 것이 좋겠습니다.

클로드 코드 Dynamic Workflow, 

이럴 때 활용해보세요.

1. 코드베이스 전체 보안 취약점 점검

서비스 규모가 커지면 API 경로와 입력값 검증 로직이 수백 곳으로 늘어나 사람이 일일이 확인하기 어렵습니다. 게다가 한 번 훑어보는 것만으로는 실제 위험인지 단순 경고인지 가려내기도 쉽지 않습니다.

Dynamic Workflow는 여러 에이전트가 폴더와 기능별로 나눠 분석한 뒤, 한 에이전트가 찾은 문제를 다른 에이전트가 교차 검증합니다.

이 검증 단계가 반복되며 답을 좁혀가기 때문에, 넓은 코드베이스에서도 오탐을 걸러내고 실제 위험에 집중할 수 있습니다.

- 예시 프롬프트: 

2. 여러 파일이 얽힌 대규모 마이그레이션

프레임워크나 API 버전을 바꾸면 수백 개 파일을 함께 수정해야 합니다. 한 단계의 수정 결과가 다음 단계에 영향을 주고, 일부 파일을 빠뜨리면 곧바로 빌드 오류와 기능 장애로 이어집니다.

Dynamic Workflow는 한 단계의 결과가 다음 단계를 결정하는 작업에 강합니다. 대상 파일을 나눠 수정하고, 그 결과로 테스트를 돌린 뒤, 실패한 항목을 다시 검토하는 흐름을 하나의 스크립트로 묶어 처리하기 때문에 누락된 파일을 놓치지 않고 잡아낼 수 있습니다.

- 예시 프롬프트: 

3. 여러 관점에서 검증하는 기술 조사

새로운 기술을 도입하기 전 호환성 변경 사항을 조사할 때, 자료마다 설명이 다르거나 오래된 정보가 섞여 있는 경우가 많습니다. 검색 한 번으로는 어떤 내용이 신뢰할 만한지 판단하기 어렵습니다.

Dynamic Workflow는 코드 작업뿐 아니라 자료 조사에도 활용할 수 있습니다. /deep-research를 사용하면 여러 에이전트가 서로 다른 출처를 확인하고, 출처가 충돌하거나 근거가 부족한 내용을 걸러낸 뒤 검증된 내용만 보고서로 정리합니다. 덕분에 한 번의 검색으로는 놓치기 쉬운 호환성 이슈까지 확인할 수 있습니다.

- 예시 프롬프트: 

클로드 코드 Dynamic Workflow 사용 시 주의사항

간단한 작업에는 사용하지 않는 편이 좋습니다

Dynamic Workflow는 여러 에이전트를 실행하기 때문에 일반적인 Claude Code 작업보다 더 많은 토큰을 사용합니다. 간단한 오류 수정과 단일 파일 편집에는 Subagent나 일반 Claude Code 세션이 적합합니다.

처음에는 전체 저장소보다 특정 폴더를 대상으로 실행하는 편이 좋습니다. 실제 토큰 사용량과 결과물을 확인한 뒤 범위를 넓혀야 합니다.

한 번의 실행에서 모든 결정을 자동화하지 않는 편이 좋습니다

워크플로가 실행되는 동안에는 사용자가 중간 단계에 직접 개입할 수 없습니다. 권한 승인이 필요한 경우를 제외하면 작업이 끝날 때까지 별도의 피드백을 입력하기 어렵습니다. 중간 검토가 필요한 업무라면 분석과 수정, 테스트 단계를 각각 별도의 워크플로로 나누는 것이 좋습니다.

동시에 실행되는 에이전트 수에는 제한이 있습니다

Dynamic Workflow는 한 번에 최대 16개의 에이전트를 동시에 실행하고, 전체 실행 과정에서는 최대 1,000개의 에이전트를 사용합니다. 컴퓨터의 CPU 코어가 부족하면 동시에 실행되는 에이전트 수는 그만큼 줄어듭니다.

종료 후에는 같은 지점에서 이어지지 않습니다

워크플로를 일시 정지한 경우 같은 Claude Code 세션 안에서는 이어서 실행할 수 있습니다. 이미 완료된 에이전트의 결과도 유지됩니다. 

하지만 Claude Code를 종료하면 다음 세션에서는 처음부터 다시 실행됩니다. 긴 작업을 진행할 때는 세션을 종료하지 않도록 주의해야 합니다.

권한과 도구 허용 범위를 먼저 확인해야 합니다

Dynamic Workflow에서 실행되는 Subagent는 파일 수정 권한을 자동으로 승인받습니다. 쉘 명령어와 웹 요청, MCP 도구는 허용 목록에 포함되지 않았다면 실행 중간에 승인을 요구합니다.

긴 작업을 시작하기 전에는 허용할 명령어와 도구 범위를 먼저 정리하는 편이 좋습니다. 운영 서버와 민감한 데이터에 접근할 수 있는 환경에서는 권한을 제한해야 합니다.

효율성을 배로 늘리는 Claude Code 사용법이 궁금하다면

Claude Code /goal 출시: 목표만 주면 AI가 끝까지 처리한다

Claude Code용 Codex 플러그인 사용법, 아직도 모르고 있었다면

Claude Code Agent View 사용법 총정리: 실행 방법부터 주요 명령어까지