Claude Code의 동적 워크플로 (Dynamic Workflows) 도입

오늘 우리는 Claude Code에서 Claude가 가장 도전적인 작업들을 엔드 투 엔드(end-to-end)로 수행할 수 있도록 돕는 동적 워크플로 (Dynamic Workflows)를 도입합니다. 평소라면 분기 단위로 계획했을 작업들이 이제 며칠 만에 완료됩니다. Claude는 단일 세션에서 수십 개에서 수백 개의 병렬 서브 에이전트 (subagents)를 실행하는 오케스트레이션 스크립트 (orchestration scripts)를 동적으로 작성하며, 작업 결과가 사용자에게 전달되기 전에 스스로 검토합니다.

특히 복잡한 레거시 코드베이스 (legacy codebases)에서는 단일 에이전트의 한 번의 실행만으로는 해결하기 너무 큰 문제들이 있습니다. 서비스 전체에 걸친 버그 추적, 수백 개의 파일에 영향을 미치는 마이그레이션 (migration), 또는 확정하기 전에 모든 각도에서 스트레스 테스트 (stress-tested)를 거치고 싶은 계획 등이 그 예입니다. 동적 워크플로는 이 모든 것을 엔드 투 엔드로 처리할 수 있습니다.

동적 워크플로는 현재 Claude Code CLI, 데스크톱 (Desktop), 그리고 Max, Team, Enterprise 플랜(관리자 활성화 시)을 위한 VS Code 확장 프로그램의 리서치 프리뷰 (research preview)에서 사용할 수 있으며, Claude API, Amazon Bedrock, Vertex AI, Microsoft Foundry에서도 사용할 수 있습니다.

참고: 동적 워크플로는 일반적인 Claude Code 세션보다 실질적으로 더 많은 토큰 (tokens)을 소비할 수 있으므로, 업무에서의 사용량을 파악하기 위해 범위를 제한한 작업 (scoped task)부터 시작하는 것을 권장합니다.

최상의 경험을 위해 동적 워크플로를 사용할 때는 자동 모드 (auto mode)를 켜십시오. 거기서 워크플로를 시작하는 두 가지 방법이 있습니다:

• Claude에게 직접 동적 워크플로 생성을 요청하거나 (예: “Create a workflow”), 또는
• ultracode라고 불리는 새로운 Claude Code 전용 설정을 켭니다.

이 설정은 노력 (effort) 메뉴를 통해 접근할 수 있으며, 노력 수준을 xhigh로 설정하는 동시에 Claude가 작업을 처리하기 위해 언제 워크플로를 사용할지 자동으로 결정하게 합니다.

동적 워크플로의 실제 활용 사례

Anthropic 내부의 얼리 액세스 (early access) 사용자 및 팀들은 다음과 같은 광범위한 유스케이스 (use cases)에 동적 워크플로를 사용해 왔습니다:

코드베이스 전반의 버그 탐색 (bug hunts), 프로파일러 기반 최적화 감사 (profiler-guided optimization audits), 그리고 보안 감사 (security audits): Claude는 서비스 또는 리포지토리 (repo)를 병렬로 검색한 다음, 모든 발견 사항에 대해 독립적인 검증을 수행하여 보고서에 실제 이슈가 나타나도록 합니다. 동일한 방식이 보안 강화 (hardening) 작업에도 적용됩니다: 코드베이스 전체에 걸친 인증 (auth) 체크, 입력 검증 (input validation), 그리고 안전하지 않은 패턴 (unsafe patterns) 탐색 등이 이에 해당합니다. 대규모 마이그레이션 (migrations) 및 현대화 작업: Claude는 수천 개의 파일에 걸쳐 진행되는 프레임워크 교체, API 폐기 (deprecations), 언어 포팅 (language ports) 작업을 엔드 투 엔드 (end-to-end)로 처리할 수 있습니다. ****두 번의 확인이 필요한 중요한 작업: 잘못된 답변의 비용이 높을 때, 워크플로 (workflow)는 Claude에게 문제에 대한 독립적인 시도를 제공하며, 사용자가 확인하기 전에 결과의 오류를 찾아내기 위해 작동하는 적대적 에이전트 (adversarial agents)를 활용합니다.

동적 워크플로를 이용한 Bun 재작성 (Rewriting Bun with dynamic workflows)

동적 워크플로가 대규모 환경에서 무엇을 실현할 수 있는지 보여주는 사례는 최근의 Bun 재작성 작업입니다. Jarred Sumner는 동적 워크플로를 사용하여 Bun을 Zig에서 Rust로 포팅하였으며, 기존 테스트 스위트 (test suite)의 99.8%를 통과했고, 약 750,000줄의 Rust 코드를 작성했으며, 첫 커밋부터 머지 (merge)까지 11일이 소요되었습니다. 하나의 워크플로는 Zig 코드베이스의 모든 구조체 필드 (struct field)에 대해 적절한 Rust 수명 (lifetime)을 매핑했습니다. 그다음 워크플로는 각 .rs 파일을 대응하는 .zig 파일과 동작이 동일한 포트 (port)로 작성했으며, 수백 명의 에이전트가 병렬로 작업하고 각 파일마다 두 명의 리뷰어 (reviewer)가 배치되었습니다. 이후 수정 루프 (fix loop)가 빌드 (build)와 테스트 스위트가 모두 깨끗하게 통과될 때까지 작업을 구동했습니다. 포팅이 완료된 후에는 밤샘 워크플로를 통해 불필요한 데이터 복사를 처리하고, 최종 검토를 위해 각각에 대한 PR을 생성했습니다. 아직 프로덕션 (production) 단계는 아니지만, 이 모든 과정이 동적 워크플로에 의해 처리되었습니다. Jarred는 향후 이에 대해 더 자세히 기술할 예정입니다.

작동 원리 (How it works)

워크플로가 시작되면, Claude는 사용자의 프롬프트(prompt)를 기반으로 동적으로 계획을 세우고, 이를 하위 작업(subtasks)으로 분해하며, 병렬로 실행되는 하위 에이전트(subagents)들에게 작업을 분산(fan out)시킵니다. 결과물은 통합되기 전에 검증 과정을 거치며, 사용자는 최종적으로 하나의 조정된 답변을 받게 됩니다. 에이전트들은 독립적인 관점에서 문제를 다루고, 다른 에이전트들은 그들이 찾아낸 내용을 반박하려고 시도하며, 답변이 수렴할 때까지 실행이 반복됩니다. 이것이 바로 워크플로가 단일 실행(single pass)으로는 도달할 수 없는 결과에 도달하는 방식입니다.

동적 워크플로는 몇 시간 또는 며칠 동안 지속될 수 있는 병렬 및 장기 실행 작업(long-running work)을 위해 구축되었으며, 이전에는 몇 주가 소요되었을 가장 복잡한 엔지니어링 작업을 수행합니다. 실행 과정 중에 진행 상황이 저장되므로, 작업이 중단되더라도 처음부터 다시 시작하는 대신 중단된 지점부터 다시 시작할 수 있습니다. 조정(coordination)이 대화 외부에서 이루어지기 때문에, 작업의 규모가 아무리 커지더라도 계획은 궤도를 유지합니다.

주의할 점은 동적 워크플로가 일반적인 Claude Code 세션보다 유의미하게 더 많은 사용량(usage)을 소비한다는 것입니다. 워크플로가 처음 트리거될 때, Claude Code는 실행될 내용을 보여주고 사용자에게 확인을 요청합니다. 조직 관리자(Organization admins)는 관리 설정(managed settings)을 통해 선택적으로 워크플로를 비활성화할 수도 있습니다.

시작하기 (Getting started)

Max 또는 Team 플랜을 사용 중이거나 API를 통해 Claude Code를 사용하는 경우, 동적 워크플로는 기본적으로 활성화되어 있습니다. 시작하려면 Claude에게 워크플로 생성을 요청하거나 Claude Code 전용 설정인 ultracode를 켜세요. Enterprise 플랜을 사용하는 경우, 출시 시점에 동적 워크플로는 기본적으로 비활성화되어 있습니다. 관리자가 Claude Code 설정에서 이를 쉽게 변경할 수 있습니다.

더 자세한 내용은 문서를 참조하세요.

Claude로 조직의 운영 방식을 혁신하세요

제품 업데이트, 사용 방법(how-tos), 커뮤니티 스포트라이트 등을 매월 이메일로 받아보세요.