클로드코드 Dynamic Workflow: 1인 개발자가 수백 개 AI 에이전트를 부리는 법 (2026)
클로드코드 Dynamic Workflow: 1인 개발자가 수백 개 AI 에이전트를 부리는 법 (2026)
혼자 일하는데 팀이 필요하다고 느껴본 적 있으신가요? 코드베이스 전체를 감사해야 하는데, 그 사이 다른 작업도 손에서 놓기 싫을 때요. 클로드코드(Claude Code)의 Dynamic Workflow는 바로 이 갈증을 풀어주는 리서치 프리뷰 기능입니다.
간단히 말하면, 이렇습니다. 여러분이 "전체 코드베이스를 보안 감사해줘"라고 한 마디 하면, Claude Code가 JavaScript 스크립트를 직접 작성하고, 수백 개의 서브에이전트를 백그라운드에서 돌려서 최종 리포트만 여러분에게 건네줍니다. 그 사이 여러분 세션은 완전히 자유롭게 유지돼요. 이게 바로 1인 개발자에게 AI 에이전트 팀이 생기는 개념입니다.
이 글에서는 Dynamic Workflows의 작동 원리, 기존 방식(Subagents·Agent Teams)과의 차이, 그리고 1인 개발자가 지금 당장 써볼 수 있는 실전 활용법을 정리했습니다. 2026-05-31 기준 공식 문서와 Anthropic 발표 자료만 근거로 작성했습니다.
Dynamic Workflows란 무엇인가요?
Dynamic Workflow는 서브에이전트를 대규모로 오케스트레이션하는 JavaScript 스크립트입니다. Claude가 요청한 작업에 맞춰 스크립트를 작성하고, 런타임이 백그라운드에서 실행하는 동안 세션은 계속 응답 가능한 상태로 유지됩니다. — Anthropic 공식 문서 (2026-05-28)
핵심은 **"스크립트가 중간 결과를 보관하고, Claude의 컨텍스트에는 최종 답만 남는다"**는 점이에요. 기존의 turn-by-turn 방식에서는 에이전트가 오고 가는 모든 과정이 Claude의 컨텍스트에 쌓였는데, Dynamic Workflows는 루프·분기·중간 결과를 스크립트 내에 격리합니다.
예를 들어, 여러 각도에서 리서치 에이전트를 fan-out시킨 뒤 독립 에이전트들이 서로의 결과물을 적대적으로(adversarially) 검토하게 할 수 있어요. 최종적으로 교차검증이 완료된 인용 리포트 한 건만 여러분에게 도착합니다.
요구 사양 (2026-05-28 기준)
| 항목 | 조건 |
|---|---|
| 상태 | research preview (정식 출시 아님) |
| 요구 버전 | Claude Code v2.1.154 이상 |
| 지원 플랜 | 모든 유료 플랜 + Anthropic API + Amazon Bedrock + Google Cloud Vertex AI + Microsoft Foundry |
| 오케스트레이션 규모 | 수십 ~ 수백(dozens to hundreds) 개 서브에이전트 |
주의할 점은 현재 research preview 단계라는 것입니다. 공식 문서도 "리서치 프리뷰"로 명시하고 있으니, 운영 환경 핵심 파이프라인에 바로 적용할 때는 이 점을 고려해 두세요.
Subagents vs Agent Teams vs Dynamic Workflows — 3계층 비교
Claude Code의 멀티에이전트 오케스트레이션은 세 가지 계층으로 나뉩니다. 어느 걸 쓸지 상황에 따라 달라지니, 한 번 확실히 짚고 넘어가겠습니다.
| 구분 | Subagents | Agent Teams | Dynamic Workflows |
|---|---|---|---|
| 통신 방식 | 오케스트레이터에만 보고 | teammate 간 직접 통신 | 스크립트가 조율 |
| 컨텍스트 | 격리, 결과만 반환 | 각자 윈도우에서 공유·논쟁 | 스크립트가 중간결과 보관, Claude에는 최종답만 |
| 토큰 비용 | 낮음 | 높음 | 컨텍스트 절약 (중간결과 분리) |
| 오케스트레이션 규모 | 소수 병렬 | 소수 협업 | 수십~수백 개 |
| 실행 방식 | turn-by-turn | turn-by-turn | 백그라운드 자율 |
| 상태 (2026-05-31) | GA | 실험적 | research preview (v2.1.154+) |
Subagents — 빠르고 저렴한 병렬 워커
Subagents는 격리된 컨텍스트 윈도우를 사용하고, 관련 정보만 오케스트레이터에 반환합니다. "결과만 중요하고 과정은 필요 없는" 집중 작업에 딱 맞아요. hub-and-spoke 패턴(메인 에이전트가 전문 워커에게 위임)이 이 구조입니다. 토큰 비용이 낮기 때문에 1인 개발자가 일상적으로 가장 많이 쓸 수 있는 방식이에요.
Agent Teams — 논쟁하고 협업하는 실험적 팀
Agent Teams는 팀원들이 각자 컨텍스트 윈도우에서 독립적으로 작업하면서 서로 직접 통신합니다. PR 리뷰, 경쟁 가설 디버깅, CLI 설계를 여러 각도로 탐색할 때 유용해요. UX 담당, 기술 아키텍처 담당, devil's advocate 담당을 각각 지정하는 식으로요.
단, 현재 실험적(experimental) 기능입니다. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 환경변수 또는 settings.json으로 활성화해야 하고, 세션 재개(/resume, /rewind) 시 in-process teammate 복원이 안 되는 알려진 한계가 있습니다.
Dynamic Workflows — 스크립트 기반 대규모 자율 실행
가장 강력하지만 요구 버전(v2.1.154+)과 유료 플랜이 필요한 방식입니다. 코드베이스 감사, 대규모 마이그레이션, 교차검증 리서치처럼 수백 개 규모의 자율 실행이 필요할 때 씁니다.
1인 개발자를 위한 실전 활용법
/deep-research — 코드 한 줄 없이 쓰는 빌트인 워크플로우
/deep-research는 Dynamic Workflow의 빌트인 예시입니다. 웹 검색을 여러 각도로 fan-out하고, 찾은 소스를 가져와 교차검증한 뒤, 인용이 포함된 리포트를 종합해 줍니다.
공식 문서 설명을 그대로 옮기면:
"/deep-research 커맨드는 여러 소스에 걸쳐 질문을 조사하는 빌트인 워크플로우로, 웹 검색을 여러 각도로 fan-out하고, 찾은 소스를 가져와 교차검증한 뒤, 인용이 포함된 리포트를 종합합니다."
에이전트들이 백그라운드에서 여러 phase를 진행하는 동안 세션은 완전히 자유롭습니다. turn-by-turn 트랜스크립트 대신 최종 리포트 1건만 받게 되죠.
핵심 팁: 마음에 드는 /deep-research 실행 결과가 나왔다면, 그 실행 스크립트를 커맨드로 저장해 두세요. 이후 매 브랜치마다 동일한 오케스트레이션을 재사용할 수 있습니다.
/loop Dynamic Mode — 폴링 없이 빌드를 지켜보는 법
/loop 커맨드는 배포 폴링, PR 감시, 장기 빌드 확인 등 "끝날 때까지 기다려야 하는" 작업을 스마트하게 처리합니다. 요구 버전은 v2.1.72 이상입니다.
동작 방식이 인상적인데요. Claude가 Monitor 도구를 직접 사용해 백그라운드 스크립트를 실행하고, 각 출력 라인을 스트리밍받아 폴링을 완전히 회피합니다. 그리고 작업이 완료됐음이 확인되면 다음 wakeup을 스케줄하지 않음으로써 Claude가 스스로 루프를 종료합니다.
몇 가지 주의사항도 있어요.
- 태스크는 현재 대화에 한정됩니다. 새 세션 시작 시 중단돼요.
- Claude Code가 실행 중이고 idle 상태일 때만 발화합니다.
- 다음 iteration 대기 중 Esc로 pending wakeup을 클리어할 수 있습니다.
Skills의 3계층 Progressive Disclosure
Skills는 컨텍스트를 동적으로 로딩하는 3계층 구조를 씁니다.
- 1계층 (YAML frontmatter): 항상 로드
- 2계층 (SKILL.md 본문): Claude가 관련 있다고 판단할 때만 로드
- 3계층 (번들 파일): 필요할 때만 탐색
스킬이 수십 개여도 컨텍스트가 폭증하지 않는 이유가 여기 있습니다. 가장 적게 호출하는 스킬의 설명부터 먼저 드롭되고, Dynamic context injection을 통해 커맨드 실행 출력이 인라인된 상태로 최신 데이터가 전달됩니다.
Hooks — 이벤트 기반 자동 컨텍스트 주입
Hooks는 세 가지 cadence로 이벤트를 처리합니다.
- 세션당 1회: SessionStart, SessionEnd
- 턴당 1회: UserPromptSubmit, Stop, StopFailure
- 모든 도구 호출마다: PreToolUse, PostToolUse
1인 개발자에게 가장 유용한 건 SessionStart입니다. 새 세션을 시작하거나 재개할 때 이슈, 최근 변경사항 같은 개발 컨텍스트를 자동으로 로딩하고 환경변수를 셋업할 수 있어요. command·mcp_tool 타입만 지원됩니다.
Opus 4.8이 Dynamic Workflows를 만나면
2026-05-28, Anthropic이 Claude Opus 4.8을 발표했습니다. 가격은 input $5/1M 토큰, output $25/1M 토큰으로 Opus 4.7과 동일합니다.
주목할 부분은 Super-Agent 벤치마크 결과입니다. Anthropic의 자체 평가에서 모든 케이스를 end-to-end로 완료한 유일한 모델로 보고됐어요. Claude Code 내에서 "올바른 질문을 던지고, 자기 실수를 잡아내고, 계획이 부실하면 스스로 반박하고, 복잡한 multi-service 탐색에서 확신을 쌓은 뒤 큰 변경을 한다"는 점이 강조됩니다.
Dynamic Workflows가 수백 개 에이전트를 오케스트레이션할 때, 각 에이전트의 자율성이 높아질수록 신뢰도도 올라가야 하는데요. Opus 4.8이 이 부분을 보완해 줍니다. 추가로 security-guidance 플러그인이 작업 중 변경사항의 취약점을 검토하고, Fast mode가 이전 모델 대비 3배 저렴해졌습니다.
지금 시작하는 법
버전 확인 및 업그레이드
Dynamic Workflows를 쓰려면 먼저 버전을 확인해야 합니다.
# 현재 버전 확인
claude --version
# 최신 버전으로 업그레이드
npm update -g @anthropic-ai/claude-code
| 기능 | 최소 버전 |
|---|---|
| Dynamic Workflows | v2.1.154+ |
/loop scheduled tasks | v2.1.72+ |
| Agent Teams (실험적) | 별도 환경변수 필요 |
플랜 요구사항
Dynamic Workflows는 모든 유료 플랜에서 사용 가능합니다. 무료 플랜에서는 지원되지 않으니 Claude.ai Pro, Team, Enterprise 또는 Anthropic API 직접 사용이 필요합니다.
Agent Teams 활성화 (실험적)
# 환경변수로 활성화
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
또는 프로젝트 .claude/settings.json에 설정해도 됩니다. 단, 실험적 기능이므로 세션 재개 시 teammate 복원이 안 되는 점을 사용 전 인지해 두세요.
Dynamic Workflow 첫 사용
# 빌트인 워크플로우로 시작
/deep-research "질문을 여기 입력"
# 결과가 마음에 들면 스크립트를 커맨드로 저장
# → 이후 매 브랜치마다 재사용 가능
마무리
클로드코드 Dynamic Workflow는 1인 개발자가 팀의 레버리지를 갖는 가장 현실적인 방법입니다. 수백 개 에이전트를 백그라운드에서 돌리면서 본인은 다른 작업에 집중할 수 있고, 교차검증된 결과만 받아볼 수 있어요.
물론 아직 research preview 단계라는 한계는 있습니다. v2.1.154+ 버전과 유료 플랜이 필요하고, 운영 환경에 바로 적용하기 전 충분히 테스트해 보시는 걸 권장드려요.
당장 시작하고 싶다면 /deep-research부터 써보세요. 코드 한 줄 없이 Dynamic Workflow의 위력을 체험할 수 있는 가장 빠른 방법입니다.
자주 묻는 질문 (FAQ)
Q: Dynamic Workflows는 정식 출시된 기능인가요?
2026-05-31 기준으로 research preview 단계입니다. 공식 문서에 "research preview"로 명시되어 있어요. Claude Code v2.1.154 이상, 모든 유료 플랜에서 사용 가능하지만, 완전한 정식 기능은 아닙니다. 실험·개발 환경에서 충분히 테스트 후 운영 적용을 권장합니다.
Q: Subagents, Agent Teams, Dynamic Workflows 중 어느 걸 써야 할까요?
빠른 판단 기준을 드리면, 결과만 중요하고 토큰을 아끼고 싶다면 Subagents, 팀원들이 서로 논쟁하며 다각도 검토가 필요하다면 Agent Teams(실험적), 코드베이스 전체 감사·대규모 마이그레이션처럼 수백 개 규모 자율 실행이 필요하다면 Dynamic Workflows입니다. 일상적인 병렬 작업은 Subagents가 가장 실용적이에요.
Q: /loop는 Claude Code가 꺼져도 계속 실행되나요?
아니요. /loop 태스크는 현재 대화에 한정됩니다. 새 세션을 시작하면 중단되고, Claude Code가 실행 중이고 idle 상태일 때만 발화합니다. 영구적인 백그라운드 스케줄링이 아니라 세션 내 장기 폴링을 대체하는 개념이에요.
Q: Agent Teams에서 실험적 기능이라는 게 어떤 의미인가요?
현재 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 환경변수나 settings.json으로 수동 활성화해야 하며, 알려진 한계가 있습니다. 가장 중요한 것은 세션 재개(/resume, /rewind) 시 in-process teammate 복원이 불가능하다는 점입니다. 재개 후 리드가 존재하지 않는 teammate에게 메시지를 보내려 시도할 수 있으니 주의가 필요해요.
Q: Opus 4.8은 가격이 얼마인가요?
2026-05-28 발표 기준 input $5/1M 토큰, output $25/1M 토큰으로 Opus 4.7과 동일합니다. Fast mode는 이전 모델 대비 3배 저렴해졌고, Super-Agent 벤치마크에서 모든 케이스를 end-to-end로 완료한 유일한 모델로 보고됐습니다.
참고 자료
- Claude Code Workflows 공식 문서 — Dynamic Workflows 정의, 사용법 (2026-05-28)
- Claude Code Agent Teams 공식 문서 — Agent Teams 구조 및 한계 (2026-05-20)
- Claude Code Scheduled Tasks 공식 문서 — /loop 사양 (2026-04-10)
- Claude Code Skills 공식 문서 — Progressive Disclosure 3계층 (2026-05-20)
- Claude Code Sub-agents 공식 문서 — Subagents 구조 (2026-05-20)
- Claude Code Hooks 공식 문서 — 이벤트 cadence (2026-05-20)
- Claude Opus 4.8 발표 — Anthropic — 가격, 벤치마크, 기능 (2026-05-28)
- Anthropic Engineering: Building Agents with the Claude Agent SDK — 에이전트 아키텍처 심층 (2026-05-15)
