Claude Code Dynamic Workflows: 대규모 작업을 서브에이전트로 나누는 실무법 | DAKER 커뮤니티

Claude Code Dynamic Workflows: 대규모 작업을 서브에이전트로 나누는 실무법

Claude Code의 Dynamic Workflows는 큰 리팩터링, 코드 감사, 조사 작업을 여러 서브에이전트로 나눠 실행하는 기능입니다. Dynamic workflows란 Claude가 작성한 JavaScript 계획으로 여러 subagent를 오케스트레이션하는 실행 방식입니다. 오늘 바로 확인할 곳은 Claude Code의 /config,

이미지: 클로드 코드 Dynamic Workflows가 대규모 작업을 subagent 병렬 실행으로 나누는 대표 카드.

문제 상황: 큰 코드 작업을 한 세션에 몰아넣으면 어디서 깨질까?

한 줄 요약: Dynamic Workflows는 "한 에이전트가 오래 붙잡는 일"을 "계획된 여러 에이전트 작업"으로 바꾸는 선택지입니다.

500개 파일 마이그레이션, 저장소 전체 보안 감사, 여러 관점의 기술 조사처럼 범위가 큰 작업은 단일 프롬프트로 끝내기 어렵습니다. 중간 상태를 잃기 쉽고, 어떤 하위 작업이 느린지 보기도 어렵습니다. Anthropic 문서는 Dynamic Workflows를 이런 대규모 작업을 백그라운드에서 여러 subagent로 분할 실행하는 방식으로 설명합니다.

DAKER 클로드 코드 디렉터리에는 상태표시줄, 스킬, 권한 설정처럼 단일 기능을 고정하는 글이 많습니다. 이

이미지: 클로드 코드 Dynamic Workflows에서 계획, 실행, 검증을 분리하는 워크플로 카드.

단계별 사용법: Dynamic Workflows는 어떻게 시작하고 관찰하나?

  1. 먼저 버전을 확인합니다. 공식 문서 기준 최소 버전은 Claude Code v2.1.154입니다.

  2. Pro 환경이라면 /config에서 Dynamic Workflows 사용 여부를 확인합니다.

  3. 작업 프롬프트에 ultracode, use a workflow, 또는 /effort ultracode를 명시합니다.

  4. Claude가 제안한 workflow script와 실행 계획을 검토합니다.

  5. 실행 중 /workflows에서 단계, agent 수, token 사용량, elapsed time을 봅니다.

  6. 문제가 생기면 p로 일시정지/재개, x로 중지, r로 특정 agent 재시작, s로 script 저장을 사용합니다.

실무 팁은 작게 시작하는 것입니다. Dynamic Workflows는 비용과 토큰 사용량이 커질 수 있으므로, 전체 저장소보다 한 모듈이나 20개 파일 같은 작은 샘플에서 workflow 품질을 먼저 확인하는 편이 안전합니다.

짧은 예시: 마이그레이션 검토를 workflow로 맡기기

/effort ultracode
이 저장소의 auth 모듈을 새 토큰 검증 방식으로 옮기는 계획을 세워줘.
먼저 10개 파일만 대상으로 Dynamic Workflow를 실행하고,
위험한 변경, 테스트 필요 지점, 반복 가능한 스크립트 저장 여부를 보고해줘.

이 프롬프트의 핵심은 "전체 적용"이 아니라 "작은 표본 실행"입니다. workflow가 잘못 쪼개지면 /workflows에서 멈추고 계획을 수정하면 됩니다.

팀 적용 체크리스트: Dynamic Workflows를 언제 허용할까?

주의할 점도 있습니다. workflow 자체는 사용자에게 중간 질문을 하지 못하고, 직접 파일시스템이나 shell에 접근하지 않습니다. 실제 파일 변경과 명령 실행은 내부 agent가 수행합니다. 공식 문서에는 동시 agent 최대 16개, 한 실행당 총 agent 1,000개 제한도 명시되어 있습니다.

공식 출처: 2026년 6월 19일 기준 확인한 문서

FAQ: Claude Code Dynamic Workflows를 팀에서 쓸 때 자주 묻는 질문

Dynamic Workflows는 일반 subagent 실행과 무엇이 다른가요?

일반 subagent는 개별 위임에 가깝고, Dynamic Workflows는 Claude가 script로 전체 실행 계획을 만든 뒤 여러 subagent를 단계적으로 오케스트레이션합니다.

Dynamic Workflows를 켜면 비용이 많이 늘어나나요?

작업 크기에 따라 늘어날 수 있습니다. /workflows에서 token totals를 보면서 작은 범위로 먼저 실행하는 방식이 안전합니다.

저장한 workflow는 팀에서 공유할 수 있나요?

프로젝트 안의 .claude/workflows/에 저장하면 저장소 규칙으로 공유하기 쉽습니다. 개인 실험은 ~/.claude/workflows/에 두는 편이 낫습니다.

언제 Dynamic Workflows를 쓰지 않는 편이 좋나요?

파일 몇 개의 작은 수정, 빠른 버그 재현, 사람이 중간 결정을 자주 내려야 하는 작업에는 과합니다. 이때는 일반 Claude Code 세션이나 명시적 subagent 위임이 더 단순합니다.

다음에 큰 작업을 맡기기 전, 먼저 작은 샘플에서 Dynamic Workflows가 어떤 계획을 만드는지 확인해보세요.

번 글은 그보다 한 단계 큰 "작업 편성" 관점입니다.

핵심 개념: Dynamic Workflows는 무엇을 자동화하나?

핵심 포인트는 세 가지입니다.

공식 문서 기준으로 Dynamic Workflows는 Claude Code v2.1.154 이상에서 제공됩니다. Pro 사용자는 /config에서 켤 수 있고, 문서에는 paid plans, Anthropic API access, Bedrock, Vertex, Foundry 지원도 함께 안내되어 있습니다. Anthropic의 Opus 4.8 공지는 이 기능을 research preview로 소개하며 Claude가 계획을 세우고 병렬 subagent를 실행한 뒤 결과를 검증하는 흐름을 강조했습니다.

/effort ultracode, 그리고 실행 중 /workflows 화면입니다.

Redirecting to Claude Code Dynamic Workflows: 대규모 작업을 서브에이전트로 나누는 실무법 | DAKER 커뮤니티...