Claude Code, 동적 워크플로우 도입

오늘 Claude Code에 동적 워크플로우를 도입합니다. 이제 Claude는 가장 까다로운 작업도 처음부터 끝까지 직접 처리할 수 있습니다. 분기 단위로 계획하던 작업이 며칠 만에 완료됩니다. Claude는 단일 세션에서 수십에서 수백 개의 서브에이전트를 병렬로 실행하는 오케스트레이션 스크립트를 동적으로 작성하고, 최종 결과를 사용자에게 전달하기 전에 스스로 검토 과정을 거칩니다.

복잡한 레거시 코드베이스처럼 규모가 큰 문제는 단일 에이전트가 한 번에 처리하기 어렵습니다. 전체 서비스를 뒤지는 버그 탐색, 수백 개의 파일에 걸친 마이그레이션, 결정을 내리기 전에 모든 각도에서 검증이 필요한 계획 등이 그런 경우입니다. 동적 워크플로우는 이러한 작업을 모두 처음부터 끝까지 처리할 수 있습니다.

동적 워크플로우는 오늘부터 Claude Code CLI, 데스크톱, VS Code 익스텐션에서 리서치 프리뷰로 제공됩니다. Max, Team, Enterprise 플랜(관리자 활성화 시)을 비롯해 Claude API, Amazon Bedrock, Vertex AI, Microsoft Foundry에서도 사용할 수 있습니다.

참고: 동적 워크플로우는 일반적인 Claude Code 세션보다 토큰 소비가 훨씬 많을 수 있습니다. 먼저 범위가 명확한 작업에서 시작해 사용량을 파악해보시길 권장합니다.

동적 워크플로우를 가장 효과적으로 활용하려면 자동 모드를 켜두세요. 워크플로우를 시작하는 방법은 두 가지입니다.

Claude에게 직접 동적 워크플로우 생성을 요청하거나(예: "워크플로우를 만들어줘"),
Claude Code 전용 설정인 ultracode을 켜세요. 이 설정은 노력(effort) 메뉴에서 접근할 수 있으며, 노력 수준을 xhigh로 설정하면서 워크플로우 사용 여부를 Claude가 자동으로 판단하게 합니다.

동적 워크플로우 활용 사례

Anthropic 내부 팀과 얼리 액세스 사용자들은 다양한 용도로 동적 워크플로우를 활용해왔습니다.

코드베이스 전체 범위의 버그 탐색, 프로파일러 기반 최적화 감사, 보안 감사: Claude가 서비스나 저장소를 병렬로 탐색한 뒤, 각 발견 항목에 대해 독립적인 검증을 수행해 실제 문제만 보고서에 노출합니다. 전체 코드베이스에 걸쳐 인증 검사, 입력 유효성 검증, 위험 패턴을 점검하는 보안 강화 작업에도 동일한 방식으로 적용됩니다.
대규모 마이그레이션 및 현대화 작업: 수천 개의 파일에 걸친 프레임워크 교체, API 지원 종료 대응, 언어 전환을 처음부터 끝까지 처리할 수 있습니다.‍
이중 검증이 필요한 중요한 작업: 오답의 비용이 클 때, 워크플로우는 문제에 독립적으로 여러 번 접근하고 결과를 검토하는 시나리오에서 적대적 에이전트가 결함을 찾아내도록 합니다. 사용자에게 최종 결과가 전달되기 전에 충분한 검증이 이루어집니다.

동적 워크플로우로 Bun 재작성하기

동적 워크플로우가 대규모로 어떤 가능성을 열어주는지 잘 보여주는 사례가 바로 최근의 Bun 재작성입니다. Jarred Sumner는 동적 워크플로우를 활용해 Bun을 Zig에서 Rust로 포팅했으며, 기존 테스트 스위트의 99.8%가 통과했습니다. 약 75만 줄 규모의 Rust 코드로, 첫 커밋부터 머지까지 단 11일이 걸렸습니다. 첫 번째 워크플로우는 Zig 코드베이스의 모든 구조체 필드에 적합한 Rust 라이프타임을 매핑했습니다. 다음 워크플로우는 각 .zig 파일과 동일한 동작을 하는 .rs 파일을 작성했는데, 수백 개의 에이전트가 병렬로 작업하고 파일마다 두 명의 리뷰어가 검토했습니다. 이후 수정 루프가 빌드와 테스트 스위트를 반복적으로 실행해 모두 통과할 때까지 개선을 이어갔습니다. 포팅이 완료된 후에는 야간 워크플로우가 불필요한 데이터 복사를 처리하고 항목별로 최종 검토를 위한 PR을 열었습니다. 아직 프로덕션에 적용된 것은 아니지만, 이 모든 과정이 동적 워크플로우로 처리되었습니다. Jarred는 추후 이에 대해 더 자세히 글을 쓸 예정입니다.

작동 방식

워크플로우가 시작되면 Claude는 프롬프트를 기반으로 동적으로 계획을 수립하고, 작업을 하위 과제로 분해한 뒤 병렬로 실행되는 서브에이전트들에게 배분합니다. 각 결과는 통합되기 전에 검증을 거치며, 최종적으로 단일하고 일관된 답변이 반환됩니다. 에이전트들은 각자 독립적인 관점에서 문제에 접근하고, 다른 에이전트들이 그 결과를 반박하려 시도하며, 답변이 수렴될 때까지 반복합니다. 단일 실행으로는 도달하기 어려운 결과에 이를 수 있는 이유가 바로 여기에 있습니다.

동적 워크플로우는 몇 시간에서 며칠까지 이어질 수 있는 병렬·장시간 작업을 위해 설계되었으며, 이전에는 몇 주가 걸렸을 복잡한 엔지니어링 작업을 처리합니다. 진행 상황이 실시간으로 저장되기 때문에 작업이 중단되더라도 처음부터 다시 시작할 필요 없이 이어서 진행할 수 있습니다. 조율 과정이 대화 외부에서 이루어지므로 작업 규모가 아무리 커져도 계획이 일관되게 유지됩니다.

동적 워크플로우는 일반적인 Claude Code 세션보다 사용량이 눈에 띄게 많다는 점을 참고하세요. 워크플로우가 처음 실행될 때 Claude Code는 실행 내용을 보여주고 확인을 요청합니다. 조직 관리자는 관리 설정을 통해 워크플로우를 비활성화할 수도 있습니다.

시작하기

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

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