Dynamic workflows로 대규모 오케스트레이션

기준일: 2026-07-26
난이도: 고급
공식 기준: Orchestrate subagents at scale with dynamic workflows

Dynamic workflow는 Claude가 작성한 JavaScript 스크립트가 런타임에서 다수 subagent를 오케스트레이션하는 기능입니다. 중간 결과는 스크립트 변수에 남고, 메인 대화 context는 최종 결과에 가깝게 유지됩니다. v2.1.154 이상, 유료 플랜 및 주요 cloud provider에서 사용 가능합니다. Pro는 /config의 Dynamic workflows 행에서 켤 수 있습니다.

핵심 개념

	Subagents	Agent teams	Workflows
다음 단계 결정	Claude 턴 단위	Lead agent 턴 단위	스크립트
중간 결과	context window	공유 task list	스크립트 변수
규모	턴당 소수	장시간 peer 소수	실행당 수십~수백
반복성	worker 정의	팀 정의	오케스트레이션 자체

번들 예: /deep-research <question> — 다각도 웹 검색·교차 검증·인용 보고서. v2.1.218+ 에서는 수동 호출만 가능(이전에는 Claude가 스스로 기동할 수 있었음).

선택 기준

• 코드베이스 전역 감사, 대량 마이그레이션, 교차 검증 리서치 → workflow
• 한두 개 위임 → subagent
• 상호 메시징이 필요한 장시간 협업 → agent teams

비용: 에이전트가 많아 토큰 사용이 큽니다. 먼저 한 디렉터리·좁은 질문으로 시험하세요. 런타임 상한 예: 동시 약 16(CPU에 따라 감소), 실행당 총 1,000 agents.

실습

한 번 실행

/deep-research What changed in the Node.js permission model between v20 and v22?

또는 프롬프트에 ultracode 키워드(또는 “use a workflow” 등 직접 요청):

ultracode: audit every API endpoint under src/routes/ for missing auth checks

ultracode 키워드는 사람이 직접 친 입력에서만 동작합니다. -p, webhook, PR 코멘트 중계 등에는 기본적으로 걸리지 않습니다(v2.1.210+ harden). 끄려면 /config의 Ultracode keyword trigger.

세션 전체에서 실질 작업마다 workflow를 계획하게 하려면:

/effort ultracode

claude --effort ultracode   # v2.1.203+

진행 확인 · 저장

/workflows

키	동작
↑/↓	phase/agent 선택
Enter/→	drill-in
p	pause/resume
x	agent 또는 전체 stop
s	스크립트를 커맨드로 저장

저장 위치: 프로젝트 .claude/workflows/ 또는 사용자 ~/.claude/workflows/ (CLAUDE_CONFIG_DIR 반영).

크기 가이드라인 (v2.1.202+, 기본값 변화 v2.1.219)

/config → Dynamic workflow size. 권고(강제 아님):

값	가이드
unrestricted	제한 없음
small	< 5 agents
medium	< 15 agents (2.1.219 기본 가이드)
large	< 50 agents

설정 키 workflowSizeGuideline으로도 지정 가능합니다.

끄기

• /config Dynamic workflows off
• "disableWorkflows": true
• CLAUDE_CODE_DISABLE_WORKFLOWS=1
• 조직 managed settings / admin console

도구에 입력할 프롬프트

use a workflow to audit every route handler under src/routes/ for missing
authentication checks, and adversarially verify each finding before reporting it.
먼저 phase 계획, 예상 agent 수, 토큰 위험을 보여준 뒤 승인을 기다려.

체크리스트

• v2.1.154+ 이고 workflows가 활성화되어 있다.
• allowlist에 필요한 shell/MCP를 미리 넣었다(mid-run 프롬프트 최소화).
• size guideline을 팀 비용 정책에 맞게 설정했다.
• 재사용할 스크립트는 .claude/workflows/에 저장·리뷰했다.
• ultracode는 일상 작업 후 /effort high 등으로 되돌렸다.

다음 단계

• 서브 에이전트 worker 정의를 정리합니다.
• Agent view로 독립 세션 병렬과 비교합니다.
• 비용 관리에서 multi-agent 사용량을 추적합니다.