Claude Code Dynamic Workflows란? ultracode로 병렬 서브에이전트를 쓰는 새 기능

 

Claude Code Dynamic Workflows란? 병렬 서브에이전트로 대규모 코딩 작업을 처리하는 새 기능

ultracode 설정, 사용 조건, 첫 테스트와 비용 리스크를 실제 도입 순서로 정리합니다.

 

Claude Code Dynamic Workflows란?

 

Claude Code Dynamic Workflows는 Claude가 큰 코딩 작업을 계획하고 병렬 서브에이전트로 나누어 실행한 뒤 검증 결과를 하나로 합치는 연구 미리보기 기능입니다. ultracode는 이 흐름을 자동으로 호출할 수 있게 하는 Claude Code의 effort 설정이지 별도 모델명이 아닙니다.

AI 코딩 도구를 쓰다 보면 가장 애매한 지점이 있습니다. 한 파일 수정은 잘 되는데, 여러 패키지와 테스트, 문서까지 걸린 작업은 어디서부터 맡겨야 하는지 판단하기 어렵습니다. Claude Code dynamic workflows ultracode 업데이트는 바로 그 빈틈을 겨냥합니다.

2026년 5월 28일 Claude 공식 블로그는 Dynamic Workflows를 Claude Code의 연구 미리보기 기능으로 발표했습니다. 사용자가 큰 요청을 던지면 Claude가 먼저 계획을 세우고, 오케스트레이션 스크립트로 작업을 쪼갠 뒤 여러 subagent를 병렬로 움직이며 결과를 확인합니다.

제가 보기에는 이 기능을 "AI가 알아서 대규모 개발을 끝낸다"로 읽으면 위험합니다. 더 정확한 독법은 큰 작업을 작은 검증 단위로 나누고, 그 과정을 Claude Code 안에서 관리하려는 시도에 가깝습니다. 그래서 볼 부분은 세 가지입니다. 쓸 수 있는 환경인지, 첫 테스트 범위를 얼마나 좁힐지, 토큰과 권한을 어디서 멈출지입니다.

 

 

2026년 5월 28일에 무엇이 발표됐나

 

2026-05-28 Claude는 Dynamic Workflows를 발표했고, Anthropic은 같은 날 Claude Opus 4.8 릴리스 맥락에서 이 기능을 함께 소개했습니다. 이 글은 2026-05-30 작성 기준 72시간 이내의 AI 업데이트로 다룹니다.

2026년 5월 28일 발표는 두 갈래로 읽으면 편합니다. 하나는 Claude Code 안에 들어간 Dynamic Workflows 자체이고, 다른 하나는 Claude Opus 4.8 발표와 함께 묶인 개발자 기능 업데이트입니다.

공식 발표는 Dynamic Workflows를 코드베이스 규모의 작업, 대규모 마이그레이션, 보안 감사, 복잡한 리서치에 맞춘 기능으로 설명합니다. Anthropic의 Opus 4.8 발표는 같은 날짜의 더 넓은 릴리스 맥락을 제공합니다.

여기서 중요한 표현은 "research preview"입니다. 정식 안정 기능처럼 모든 팀이 바로 표준 운영에 넣기보다, 작은 범위에서 동작 방식과 토큰 사용량을 먼저 보는 편이 맞습니다. 한국 사용자 입장에서는 영어 문서의 큰 예시보다 내 플랜, 내 저장소, 내 CI에서 감당 가능한지가 더 먼저입니다.

 

기존 subagent와 무엇이 다른가

 

기존 subagent 활용이 사용자가 일을 직접 나누는 방식에 가까웠다면, Dynamic Workflows는 Claude가 실행 계획과 워크플로우 스크립트를 만들고 이해, 구현, 검증 단계를 병렬로 운영한다는 점이 다릅니다.

실무에서 달라지는 점은 답변 길이가 아니라 실행 단위입니다. 문서에 따르면 dynamic workflow는 JavaScript 스크립트 형태로 subagent들을 오케스트레이션하고, 백그라운드 런타임이 이를 실행해 세션 반응성을 유지합니다.

즉, Claude가 단순히 긴 답변을 쓰는 것이 아닙니다. 작업을 여러 흐름으로 나누고, 각 흐름에서 나온 결과를 모아 최종 답변으로 합칩니다. 발표에서는 대규모 코드 변환 예시도 언급되지만, 그 사례를 일반 보장 성능으로 받아들이면 안 됩니다.

비교하면 차이가 더 선명합니다.

구분	일반 Claude Code 작업	Dynamic Workflows
작업 분해	사용자가 직접 지시하는 비중이 큼	Claude가 계획과 워크플로우를 제안
실행 방식	대화 중심의 순차 진행	여러 subagent 병렬 실행
확인 지점	사용자가 중간 답변을 보며 조정	`/workflows`에서 단계, agent 수, 토큰, 결과 확인
적합한 작업	좁은 수정, 질문, 단일 버그	코드베이스 감사, 마이그레이션 조사, 반복 검증

제가 보기에는 이 변화의 의미는 "더 똑똑한 자동완성"보다 작업 관리 계층이 코딩 에이전트 안으로 들어온 데 있습니다.

 

 

설치와 첫 테스트: 바로 켜기 전에 확인할 것

 

먼저 Claude Code v2.1.154 이상, 유료 플랜 또는 API/클라우드 제공 조건, 관리자 허용 여부를 확인해야 합니다. 첫 테스트는 중요한 운영 저장소가 아니라 비중요 repo에서 좁은 감사 작업으로 시작하는 편이 안전합니다.

바로 실행하기 전에 버전과 권한부터 봐야 합니다. Claude Code 문서 기준으로 Dynamic Workflows는 Claude Code v2.1.154 이상이 필요합니다. 제공 경로는 paid plan, Anthropic API, Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry로 정리되어 있으며, Pro 사용자는 `/config`의 Dynamic workflows 항목을 켜야 한다고 안내됩니다. 공식 발표는 Max, Team, Enterprise에서 관리자 허용 조건을 강조합니다.

설치 또는 업데이트부터 확인하려면 macOS, Linux, WSL에서는 문서의 CLI 설치 명령 `curl -fsSL https://claude.ai/install.sh | bash`를 기준으로 보면 됩니다. Windows PowerShell과 CMD 명령은 별도 문서에 정리되어 있습니다.

처음부터 "전체 레거시 코드를 새 프레임워크로 바꿔줘"라고 맡기는 것은 권하지 않습니다. 실제로 확인할 부분은 훨씬 작습니다.

• `src/routes/` 아래 API endpoint의 인증 누락 가능성만 감사하기
• 테스트가 있는 모듈 하나를 대상으로 deprecated API 사용처만 찾기
• `/deep-research`로 특정 런타임 변경 사항을 조사하고 출처가 붙은 보고서 품질 보기
• `/effort ultracode`를 켠 뒤 한 세션에서만 자동 workflow가 어떻게 제안되는지 보기

첫 테스트의 목적은 결과물 자랑이 아닙니다. Claude Code dynamic workflows ultracode가 내 환경에서 어떤 권한을 요구하고, 토큰을 얼마나 쓰며, 결과를 어떻게 합치는지 보는 쪽에 가깝습니다.

 

도입 시뮬레이션: install, first test, operation

 

실무 도입은 설치와 버전 확인, 플랜과 관리자 정책 확인, 작은 첫 workflow 실행, `/workflows` 모니터링, 저장과 재사용, 중단 조건 확인 순서로 설계하는 것이 현실적입니다.

아래는 제가 개인 또는 소규모 팀이라면 적용할 Claude Code dynamic workflows ultracode 도입 흐름입니다. 기준은 한 번에 큰 일을 맡기는 것이 아니라, 실패해도 복구 가능한 좁은 단위로 workflow 운영 감각을 얻는 것입니다.

1. Claude Code를 설치하거나 최신 버전으로 올리고, `claude --version` 또는 현재 환경의 버전 표시로 v2.1.154 이상인지 확인합니다.
2. Pro라면 `/config`에서 Dynamic workflows 항목을 확인하고, Team 또는 Enterprise라면 관리자 정책에서 workflow 사용이 허용되어 있는지 봅니다.
3. 비중요 저장소에서 `Run a workflow to audit every API endpoint under src/routes/ for missing auth checks`처럼 범위가 명확한 감사 요청을 합니다.
4. 실행 전 Claude가 제안하는 계획과 raw script를 확인하고, 처음에는 skip future prompts 같은 편의 옵션을 성급히 고르지 않습니다.
5. 실행 중에는 `/workflows`에서 phase, agent count, token total, elapsed time을 확인합니다.
6. 반복 가치가 있으면 `.claude/workflows/`에 프로젝트 workflow로 저장하고, 개인용이면 `~/.claude/workflows/`에 둡니다.

추천 분야는 코드베이스 전체 감사, 보안 리뷰 준비, 프레임워크 마이그레이션 조사, 반복 가능한 팀 점검 workflow입니다. 반대로 단일 파일 수정, 짧은 질의응답, 테스트가 없는 대규모 자동 수정에는 과합니다.

잘 맞는 조합도 있습니다. Claude Code custom subagents로 역할을 명확히 나누면 리뷰어, 테스트 담당, 마이그레이션 조사 담당처럼 반복 가능한 구조를 만들기 쉽습니다. worktrees를 쓰면 큰 자동 수정이 메인 작업 디렉터리를 바로 흔들지 않게 분리할 수 있습니다. 기존 테스트 suite와 CI는 선택이 아니라 사실상 안전장치입니다.

 

 

 

왜 AI 코딩 에이전트 흐름에서 중요한가

 

이 기능의 의미는 한 번의 대화로 더 긴 답변을 받는 데 있지 않습니다. 큰 개발 작업을 별도 실행 흐름으로 나누고, 병렬 처리와 검증을 포함한 운영 단위로 다루려는 변화에 있습니다.

실무적 의미는 명확합니다. 코딩 에이전트의 중심이 "답변 생성"에서 "작업 오케스트레이션"으로 이동하고 있습니다. 이전에는 사용자가 프롬프트를 쪼개고, 결과를 붙이고, 테스트 명령을 다시 던지는 일이 많았습니다. 이제는 그 반복의 일부를 workflow가 흡수하려고 합니다.

물론 이것이 사람의 리뷰를 대체한다는 뜻은 아닙니다. 오히려 역할은 더 분명해집니다. 사람은 범위, 권한, 테스트 기준, 병합 여부를 정하고, Claude는 병렬 조사와 반복 검증의 노동을 줄이는 쪽에 가깝습니다.

> 좋은 첫 사용 사례는 "큰 자동 수정"이 아니라 "넓게 살펴보고, 좁게 고치고, 다시 검증하는 작업"입니다.

한국 개발자에게는 특히 보안 감사 준비, 레거시 코드 정리, 프레임워크 업데이트 사전 조사처럼 시간이 많이 드는 준비 작업에서 의미가 있습니다. 다만 영어권 발표의 대형 사례를 그대로 자기 팀 생산성 지표로 가져오면 곤란합니다. 내 repo의 테스트 밀도, 코드 리뷰 문화, 요금제 한도에 맞춰야 합니다.

 

토큰 비용과 권한 리스크

 

Dynamic Workflows는 일반 Claude Code 세션보다 훨씬 많은 토큰을 쓸 수 있고, 여러 agent가 도구 권한과 파일 수정을 다룰 수 있습니다. `/usage`, `/model`, `/workflows`, allowlist, 작업 범위 제한을 함께 봐야 합니다.

공식 발표와 문서 모두 비용 리스크를 분명히 적고 있습니다. Dynamic Workflows는 병렬 agent를 쓰기 때문에 일반 대화형 Claude Code 세션보다 토큰 사용량이 커질 수 있고, plan usage와 rate limit에도 영향을 줍니다.

다만 여기서 조심할 점은 비용만이 아닙니다. workflow 실행 중에는 agent들이 파일을 읽고 쓰거나, 허용된 도구를 호출하거나, 필요에 따라 권한 프롬프트를 만날 수 있습니다. 문서상 workflow script 자체가 파일시스템이나 shell에 직접 접근하는 것은 아니지만, agent가 수행하는 작업은 실제 repo에 영향을 줍니다.

운영 체크는 짧게 잡는 편이 낫습니다.

• `/model`로 모든 단계가 가장 강한 모델을 써야 하는지 확인합니다.
• `/usage`로 세션 사용량을 보고, plan limit과 rate limit 여유를 남깁니다.
• `/workflows`에서 agent 수와 token total이 예상보다 커지면 중단합니다.
• shell, web fetch, MCP 도구가 필요한 workflow라면 allowlist를 먼저 검토합니다.
• 대규모 수정은 worktree, 테스트 suite, CI, 코드 리뷰를 전제로 둡니다.

Dynamic Workflows를 끄는 방법도 알아둬야 합니다. 문서에는 `/config`, `~/.claude/settings.json`의 `disableWorkflows`, `CLAUDE_CODE_DISABLE_WORKFLOWS=1`, 조직 관리 설정이 언급됩니다. 기능을 켜는 법만큼, 멈추는 법을 아는 것이 실무 도입의 기본입니다.

 

 

 

누가 먼저 써볼 만한가

 

Claude Code dynamic workflows ultracode는 코드베이스를 넓게 훑고 검증까지 묶어야 하는 개발자나 팀에게 먼저 맞습니다. 짧은 수정, 테스트 없는 운영 코드, 승인 절차가 촘촘한 작업에는 아직 신중해야 합니다.

저라면 이 기능을 개인 프로젝트의 작은 감사 작업이나 팀의 사전 조사 작업부터 넣어보겠습니다. 예를 들어 인증 누락 점검, deprecated API 정리 후보 찾기, 특정 패키지 업그레이드 영향 범위 조사처럼 결과를 사람이 다시 확인하기 쉬운 일입니다.

반대로 "프로덕션 코드를 한 번에 크게 바꾸고 바로 병합"하는 식의 사용은 피하겠습니다. 연구 미리보기이고, 토큰 사용량이 커질 수 있으며, 중간에 사람이 세밀하게 개입하기 어려운 실행 흐름도 있기 때문입니다.

Claude Code dynamic workflows ultracode의 실용적인 가치는 자동화의 크기보다 검증 가능한 작업 설계에서 나옵니다. 범위를 좁히고, 권한을 확인하고, `/workflows`로 관찰하고, 테스트로 되받아치는 팀일수록 얻을 것이 큽니다.

 

자주 묻는 질문

 

Q. Claude Code Dynamic Workflows는 무엇인가?
A. Claude가 큰 코딩 요청을 계획하고, 병렬 subagent에게 나눠 실행한 뒤, 검증 결과를 합쳐 하나의 답변으로 정리하는 Claude Code 연구 미리보기 기능입니다. 공식 발표일은 2026-05-28입니다.

Q. Claude Code ultracode는 모델 이름인가?
A. 아닙니다. ultracode는 Claude Code의 `/effort` 설정입니다. 문서 기준으로 xhigh effort와 자동 workflow 오케스트레이션을 결합해, 충분히 큰 작업에서 Dynamic Workflows를 유도합니다.

Q. Dynamic Workflows를 쓰려면 어떤 조건이 필요한가?
A. Claude Code v2.1.154 이상이 필요하고, paid plan 또는 Anthropic API, Amazon Bedrock, Vertex AI, Microsoft Foundry 같은 제공 경로가 문서에 명시되어 있습니다. Pro 사용자는 `/config`에서 Dynamic workflows 항목을 확인해야 하며, Team과 Enterprise 환경은 관리자 허용 여부가 중요합니다.

Q. `/effort ultracode`와 직접 workflow 요청은 어떻게 다른가?
A. 직접 workflow를 요청하면 특정 작업을 workflow로 만들라고 명시하는 방식입니다. `/effort ultracode`는 현재 세션에서 더 큰 작업에 대해 Claude가 자동으로 workflow 오케스트레이션을 선택할 수 있게 하는 설정이며, routine 작업으로 돌아갈 때는 `/effort high`로 낮출 수 있습니다.

Q. 처음 테스트할 때 어떤 작업이 안전한가?
A. 비중요 저장소에서 `src/routes/` 인증 누락 감사, deprecated API 후보 찾기, 문서 리서치처럼 범위가 좁고 사람이 결과를 검증하기 쉬운 작업이 적합합니다. 첫 실행부터 전체 마이그레이션이나 프로덕션 대규모 수정에 쓰는 것은 피하는 편이 좋습니다.

Q. 토큰 비용이 많이 들 수 있나?
A. 공식 발표와 문서 모두 일반 Claude Code 세션보다 토큰을 더 많이 쓸 수 있다고 경고합니다. 실행 전 `/model`을 확인하고, 실행 중 `/workflows`와 `/usage`로 agent 수와 token total을 보는 습관이 필요합니다.

Q. 완료한 workflow를 팀에서 재사용할 수 있나?
A. 가능합니다. 문서 기준으로 프로젝트용 workflow는 `.claude/workflows/`, 개인용 workflow는 `~/.claude/workflows/`에 저장해 slash command처럼 다시 실행할 수 있습니다. 다만 저장 전에는 권한, 경로, 테스트 조건이 팀 환경에 맞는지 검토해야 합니다.

함께 읽으면 좋은 글

 

• GitHub Copilot Memory 업데이트: AI가 기억하는 정보, 어디까지 통제할 수 있나 — AI UPDATES
• OpenAI Agents SDK 업데이트 핵심: 장기 실행 AI 에이전트는 어떻게 복구하고 확장할까 — AI UPDATES
• Claude 에이전트 보안 설계: Anthropic이 말한 샌드박스와 egress control — AI UPDATES

참조 링크

 

• Introducing dynamic workflows in Claude Code — Dynamic Workflows의 공식 발표, 연구 미리보기 상태, 사용 가능 환경, ultracode 언급, 토큰 경고를 확인하기 위한 1차 출처입니다.
• Orchestrate subagents at scale with dynamic workflows — 버전 조건, `/effort ultracode`, `/workflows`, `/deep-research`, 저장 위치, 제한, 비활성화 방법을 확인하기 위한 공식 문서입니다.
• Introducing Claude Opus 4.8 — Dynamic Workflows를 Claude Opus 4.8과 같은 날짜의 넓은 릴리스 맥락에서 확인하기 위한 공식 발표입니다.
• Overview - Claude Code Docs — Claude Code CLI 설치 명령과 기본 환경 확인에 참고한 공식 문서입니다.
• Manage costs effectively — `/usage`, `/model` 등 비용과 사용량 점검 관점에 참고한 공식 문서입니다.
• Create custom subagents — Dynamic Workflows와 함께 쓸 수 있는 subagent 역할 설계 관점에 참고한 공식 문서입니다.
• Worktrees - Claude Code Docs — 대규모 자동 수정 workflow를 분리된 작업 공간에서 테스트하는 운영 관점에 참고한 공식 문서입니다.