Claude Code에 /workflows 기능 추가됨
핵심 요약
Claude Code 2.1.147 업데이트로 LLM 대신 코드로 에이전트 워크플로우를 제어하는 기능이 도입됨.
- 코드 기반 오케스트레이션 — LLM 대신 JS 코드로 에이전트 흐름을 제어하여 토큰 낭비를 줄임.
- 구조화된 워크플로우 — 스키마 기반의 예측 가능한 출력과 병렬 파이프라인 처리를 지원함.
- 효율적인 제어 흐름 — 조건문, 루프, 예산 설정 등 실제 코드를 통한 정교한 에이전트 제어가 가능함.
- 백그라운드 실행 — 메인 세션을 방해하지 않고 워크플로우를 독립적으로 실행할 수 있음.
Anthropic이 Claude Code 2.1.147 버전에 /workflows를 조용히 추가했는데, 이게 멀티 에이전트 시스템을 구축하는 방식에 있어 가장 큰 변화가 될지도 모릅니다.
지금까지의 패턴은 이랬습니다:
하나의 메인 에이전트(LLM)가 어떤 서브 에이전트를 생성할지 결정하고, 모든 중간 결과를 보관하며, 다음 단계를 계획합니다.
문제는 무엇일까요?
모든 서브 에이전트의 결과가 오케스트레이터의 컨텍스트로 다시 들어온다는 점입니다.
에이전트를 10개만 돌려도 메인 세션은 매번 '토큰 세금'을 내야 하고, 컨텍스트 윈도우가 찰수록 점점 더 멍청해지고 기억력도 나빠집니다.
/workflows는 LLM 오케스트레이터를 코드로 대체합니다.
workflow.js 파일을 정의하기만 하면 됩니다.
서브 에이전트의 출력은 메인 컨텍스트 윈도우를 거치지 않고 한 단계에서 다음 단계로 직접 흐릅니다.
얻을 수 있는 이점:
-
구조화된 스키마를 가진 단계 (예측 가능한 출력)
-
병렬 팬아웃 및 스트리밍 파이프라인
-
실제 JS를 사용한 조건문, 루프, 예산 설정
-
실패 시 자동 재시도
-
/workflows를 통한 실시간 진행 상황 보기
-
메인 세션을 자유롭게 유지하면서 백그라운드에서 워크플로우 실행
흥미로운 원칙은 이것입니다:
코드가 잘하는 것(제어 흐름)에는 코드를 사용하고, 모델이 잘하는 것(각 단계 내에서의 판단)에는 모델을 사용하세요.

