🔍 Claude Code /workflows, 진짜 출시됐을까?
미공개 게이팅 기능을 둘러싼 소문을 공식 출처로 검증하다
최근 한 온라인 커뮤니티에서 "Anthropic이 Claude Code에 /workflows라는 기능을 조용히 출시했다가 내렸다"는 글이 화제가 됐습니다. 특정 버전 2.1.147까지 콕 집어 지목했죠. 결론부터 말하면, 기능은 실재하지만 공식적으로 출시된 적은 없으며, "2.1.147 출시설"은 사실과 다릅니다. 무엇이 진실이고 무엇이 와전된 정보인지, 공식 체인지로그를 직접 대조해 정리했습니다.
❓ 검증해야 할 세 가지
① 이 기능이 실재하는가 · ② 무엇을 목적으로 어떻게 동작하는가 · ③ 정말 2.1.147로 출시됐다가 내려갔는가. 조사 라운드마다 답이 엇갈려, 1차 출처(공식 문서)로 모순을 직접 가려냈습니다.
🧩 기초 지식 — 왜 이런 기능이 필요했나
먼저 배경을 짚어야 이야기가 와닿습니다. Claude Code는 터미널·IDE·웹에서 동작하는 AI 코딩 에이전트입니다. 복잡한 작업은 여러 서브에이전트(sub-agent)로 쪼개 처리하는데, 기존 방식에서는 하나의 메인 에이전트(LLM)가 오케스트레이터 역할을 도맡습니다. 어떤 서브에이전트를 띄울지 판단하고, 그 결과를 모두 자기 컨텍스트 윈도우(context window)에 다시 담은 뒤, 다음 단계를 계획하는 구조죠.
컨텍스트 윈도우란 모델이 한 번에 "기억"할 수 있는 토큰의 한도를 말합니다. 문제는 서브에이전트 결과가 매번 메인 컨텍스트로 재유입된다는 점입니다. 에이전트를 10개 띄우면 그때마다 메인 세션이 이른바 "토큰 세금(token tax)"을 냅니다. 윈도우가 차오를수록 판단이 흐려지고, 앞서 정한 맥락을 잊어버리는 컨텍스트 망각 현상이 심해집니다. 작업이 길어질수록 결과 품질이 떨어지는 구조적 한계인 셈입니다.
💡 /workflows의 발상은 한 문장으로 요약됩니다. "제어 흐름은 코드가, 판단은 모델이." 즉 LLM이 맡던 오케스트레이션을 결정론적인 JavaScript 코드로 대체하자는 것입니다.
⚙️ 동작 방식 — 공식·독립 출처로 교차 확인
아래 도식은 /workflows의 핵심 골격입니다. 반복문·조건문·팬아웃(fan-out)은 모두 사용자가 짜는 평범한 코드가 담당하고, 말단(leaf)의 agent() 호출만 모델 토큰을 씁니다. 게다가 각 호출은 자기만의 깨끗한 컨텍스트에서 실행되어 메인 세션을 오염시키지 않습니다.
flowchart TD
A([워크플로 시작
JS 코드]) --> B[코드가 제어
루프·조건·팬아웃]
B --> C{말단 agent
호출 지점?}
C -->|YES| D[독립 컨텍스트로
모델 실행]
C -->|NO| B
D --> E([결과 반환
메인 오염 없음])
style A fill:#3498db,stroke:#2980b9,color:#ffffff
style B fill:#e8f8f5,stroke:#16a085,color:#117a65
style C fill:#fef9e7,stroke:#f39c12
style D fill:#eafaf1,stroke:#27ae60,color:#1e8449
style E fill:#3498db,stroke:#2980b9,color:#ffffff
🔗 다이어그램 요약: /workflows는 루프·조건·팬아웃 같은 제어 흐름을 JavaScript 코드가 담당하고, 말단 agent() 호출만 각자 독립된 컨텍스트에서 모델을 실행한다. 그 결과 서브에이전트 출력이 메인 세션 컨텍스트를 오염시키지 않는다.
독립 출처들이 일치하게 설명하는 특징은 다음과 같습니다.
✓ 워크플로 = JavaScript 파일. 흐름 제어가 전부 "당신이 통제하는 평범한 코드"
✓ 말단 agent() 호출만 토큰 사용 + 각자 깨끗한 컨텍스트
✓ 결정론적(deterministic): 매 실행마다 동일하게 동작
✓ 재개 가능(resumable): 도중에 멈춰도 이어서 실행
✓ 실시간 모니터링: /workflows 명령으로 진행 상황 관찰
📊 기존 방식 vs /workflows 방식
| 구분 |
🤖 LLM 오케스트레이터(기존) |
⚙️ 코드 오케스트레이터(/workflows) |
| 흐름 제어 |
메인 모델이 매 단계 판단 |
JS 코드(루프·조건·팬아웃) |
| 컨텍스트 |
서브 결과가 메인에 재유입 → 토큰 세금 |
말단 호출마다 독립 윈도우 |
| 재현성 |
실행마다 달라질 수 있음 |
결정론적 + 재개 가능 |
| 대규모 팬아웃 |
에이전트 늘수록 윈도우 압박 |
병렬 호출에도 메인 영향 적음 |
🟢 검증 ① 실재한다 — 단, "출시"되지 않았다
/workflows는 실재하는 기능이 맞습니다. 그러나 공식적으로 출시·발표된 적은 없습니다. 이를 다루는 한 커뮤니티 스킬 저장소는 이 기능을 두고 "아직 출시되지 않았고(not released yet), 발표되지도 않았다(unreleased and unannounced)"고 명시합니다.
🟡 Claude Code 바이너리 안에는 들어 있지만, 환경 변수 뒤에 숨겨져(게이팅) 있으며 공식 문서화되지 않았습니다.
🟡 활성화 방법: export CLAUDE_CODE_WORKFLOWS=1 — "오늘날 환경 변수로 게이팅되어 있으며" 정식 출시 시 이 방식은 바뀔 수 있다고 적혀 있습니다.
바로 이것이 글쓴이가 본 "내려간 것 같다"는 현상의 정체입니다. 철회된 게 아니라, 애초에 게이팅된 미공개(preview) 기능이 잠깐 노출되었던 것으로 보입니다. 숨겨진 기능이 켜졌다 꺼지는 모습이 외부 관찰자에게는 "출시 후 회수"처럼 보였을 가능성이 큽니다.
🔴 검증 ② "2.1.147 출시설"은 거짓이다
이번 조사의 핵심입니다. 일부 라운드는 "/workflows가 v2.1.147(2026-05-21)로 배포됐다"고 단언했지만, 이는 사실이 아닙니다. 공식 Claude Code 체인지로그에는 'workflows'라는 단어 자체가 단 한 번도 등장하지 않습니다(최신 2.1.150 기준). 미출시·게이팅 기능이므로 릴리즈 노트에 있을 수가 없는 것입니다.
실제 2.1.147(2026-05-21)의 내용은 전혀 다른 것들이었습니다.
▶ /simplify → /code-review로 개명 (effort 레벨 지정, --comment로 PR 인라인 코멘트)
▶ 핀 고정 백그라운드 세션 유지 개선, 자동 업데이터 개선
▶ 대용량 diff 렌더링 성능, 프롬프트 히스토리 중복 제거, 그 외 25개+ 버그 수정
▶ (참고) 2026-05-22 핫픽스: 2.1.147에서 생긴 Bash 종료코드 127 회귀 수정
🗂️ 사실 vs 와전된 주장
| 항목 |
주장 |
검증 결과 |
| 기능 존재 |
실재 |
✅ 사실 — 단, 미공개 preview |
| 환경변수 게이팅 |
CLAUDE_CODE_WORKFLOWS=1 |
✅ 사실 (출처는 릴리즈 노트 아닌 커뮤니티 저장소) |
| 2.1.147로 출시 |
거짓 |
❌ 2.1.147은 /code-review 개명 등 별개 내용 |
| "내려갔다" |
관찰 |
🟡 철회 아닌 게이팅 노출/비노출로 해석 |
🧠 정보 위생의 교훈: 흥미롭게도 "환경 변수"와 "재개 기능"은 결과적으로 맞는 사실이었습니다. 다만 그 근거가 공식 릴리즈가 아니라 게이팅 기능을 다룬 커뮤니티 저장소였죠. 즉 맞는 사실을 틀린 출처(공식 릴리즈)에 귀속한 셈입니다. "그럴듯한 버전 번호"가 출처 없이 어떻게 확산되는지 보여주는 전형적 사례입니다.
🔭 영향과 시사점
🧭 아키텍처 방향성: "모델에게 오케스트레이션을 맡기지 말고, 결정론적 제어는 코드로 빼라"는 흐름의 연장선입니다. 메인 에이전트가 전문 서브에이전트에 위임하는 매니지드 에이전트 강화 방향과 궤를 같이합니다.
⚠️ 사용자 관점: 현재로선 프로덕션 의존은 금물입니다. 미발표·게이팅 상태이며 활성화 방식(환경 변수)이 정식 출시 때 바뀔 수 있다고 명시돼 있습니다.
🧼 정보 위생: AI 도구는 변화가 빠릅니다. 버전·기능 주장은 반드시 공식 체인지로그로 1차 대조하는 습관이 필요합니다.
✅ 결론 요약
| 항목 |
검증 결과 |
| 실재 여부 |
실재 (단, 미출시·미발표 preview) |
| 활성화 |
CLAUDE_CODE_WORKFLOWS=1 환경 변수 게이팅 (변경 가능) |
| 핵심 동작 |
JS로 제어 흐름, 말단 agent()만 독립 컨텍스트, 결정론적·재개 가능 |
| 2.1.147 출시설 |
거짓 — 공식 체인지로그에 workflows 언급 0건 |
| "내려갔다" |
철회 아닌 게이팅 기능의 노출/비노출 |
요약하면, 원글의 "기능 본질" 설명은 대체로 정확하지만 "2.1.147로 출시됐다"는 핵심 주장은 사실과 다릅니다. /workflows는 Anthropic이 아직 공식화하지 않은 실험적 기능이며, 정식 발표 전까지는 동작·활성화 방식 모두 유동적입니다. 정식 릴리즈 노트가 나오는지 추적할 가치는 충분합니다.
※ 개발 도구의 미공개·실험 기능은 예고 없이 동작·활성화 방식이 바뀔 수 있습니다. 본문 정보는 작성 시점 기준이며, 실제 적용 전 반드시 공식 문서를 확인하시기 바랍니다.
📄 Raw Data
검증이 끝났습니다. 1차 출처로 모순이 모두 가려졌습니다. 최종 보고서를 작성합니다.
---
# Claude Code `/workflows`: "출시된 적 없는" 기능을 둘러싼 사실 검증
## 1. 질문의 핵심
레딧에 올라온 글의 요지는 두 가지입니다. ① Anthropic이 Claude Code에 `/workflows`라는 기능을 조용히 출시했다(특정 버전 `2.1.147`로 지목), ② "LLM 오케스트레이터"를 코드로 대체하는 멀티에이전트 패러다임 전환이며, ③ 글쓴이 본인이 "지금은 내려간 것 같다(taken down)"고 덧붙였습니다.
검증해야 할 것은 명확합니다. **(A) 이 기능이 실재하는가, (B) 어떤 목적·동작인가, (C) 정말 `2.1.147`로 출시되었다가 내려갔는가.** 누적 조사 3개 라운드 사이에 중대한 모순이 있어, 공식 출처를 직접 확인해 정리했습니다.
---
## 2. 기초 정보 — 무엇을 해결하려는 기능인가
기존 Claude Code의 멀티에이전트 방식은 **하나의 메인 에이전트(LLM)가 오케스트레이터** 역할을 합니다. 메인이 어떤 서브에이전트를 띄울지 판단하고, **모든 중간 결과를 자기 컨텍스트 윈도우에 다시 담고**, 다음 단계를 계획합니다.
문제는 서브에이전트 결과가 매번 메인 컨텍스트로 재유입된다는 점입니다. 에이전트를 10개 띄우면 그때마다 메인 세션이 "토큰 세금(token tax)"을 내고, 윈도우가 차오를수록 판단이 흐려지고 맥락을 망각합니다.
`/workflows`의 발상은 **"제어 흐름은 코드가, 판단은 모델이"** 입니다. 즉 LLM 오케스트레이터를 **코드(JavaScript)로 대체**합니다.
---
## 3. 현황 데이터 — 공식 출처로 확인한 사실
### (A) 기능은 실재한다 — 단, "출시"되지 않았다
`/workflows`는 **실재하는 기능이 맞지만, 공식적으로 출시·발표된 적이 없습니다.** 이를 다루는 한 Claude Code 스킬 저장소는 명시적으로 이렇게 기술합니다([ray-amjad/claude-code-workflow-creator](https://github.com/ray-amjad/claude-code-workflow-creator)):
- "the Workflow tool is **not released yet**", "**unreleased and unannounced**"
- "Claude Code 바이너리 **안에 들어 있지만**, **환경 변수 뒤에 숨겨져 있고**, Anthropic이 공식 문서화하거나 발표하지 않았다"
- 활성화 방법: `export CLAUDE_CODE_WORKFLOWS=1` — "오늘날 환경 변수로 게이팅되어 있으며" 정식 출시 시 "이 방식은 바뀔 수 있다"
이것이 레딧 글쓴이가 본 현상("내려간 것 같다")의 정체입니다. **내려간 게 아니라, 애초에 게이팅된 미공개(preview) 기능이 잠깐 노출되었던 것**으로 보입니다.
### (B) 동작 방식 (독립 출처로 교차 확인)
[workflow-creator 저장소](https://github.com/ray-amjad/claude-code-workflow-creator)와 [MindStudio 분석](https://www.mindstudio.ai/blog/code-with-claude-2026-new-agent-features)이 일치하게 설명하는 동작은 다음과 같습니다.
- **워크플로는 JavaScript 파일이다.** 반복문·조건문·팬아웃(fan-out)이 모두 "당신이 제어하는 평범한 코드"
- **말단(leaf)의 `agent()` 호출만 모델 토큰을 쓴다.** 그리고 **각 호출은 자기만의 깨끗한 컨텍스트 윈도우**에서 실행된다 → 서브에이전트 출력이 메인 컨텍스트와 분리됨
- **결정론적(deterministic):** "매 실행마다 동일하게 동작"
- **재개 가능(resumable):** "도중에 멈춰도 이어서 실행 가능"
- **실시간 모니터링:** `/workflows` 명령으로 진행 상황 관찰
레딧 글이 열거한 항목(구조화 스키마, 병렬 팬아웃·스트리밍, JS 조건문·루프·예산, 자동 재시도, 라이브 진행 뷰, 백그라운드 실행)은 위 골격과 부합합니다.
---
## 4. 원인 분석 — 라운드 간 모순의 진실
이번 조사의 가장 중요한 부분입니다. 누적 결과 라운드들이 서로 엇갈렸는데, **공식 체인지로그를 직접 대조한 결과 "버전 귀속"이 틀렸음**이 확인됐습니다.
### 모순 ①: 버전 번호 `2.1.147`
> Round 2·3는 "`/workflows`가 v2.1.147(2026-05-21)로 배포됐다"고 단언했습니다. **이는 사실이 아닙니다.**
[공식 Claude Code 체인지로그](https://code.claude.com/docs/en/changelog)에는 **`workflows`라는 단어 자체가 어디에도 없습니다** (최신 버전은 2.1.150, 2026-05-23). 그리고 실제 **2.1.147(2026-05-21)의 내용**은 전혀 다른 것들입니다([Releasebot](https://releasebot.io/updates/anthropic/claude-code)):
- 핀 고정 백그라운드 세션 유지 개선
- **`/simplify` → `/code-review`로 개명** (effort 레벨 지정, `--comment`로 PR 인라인 코멘트)
- 자동 업데이터 개선, 대용량 diff 렌더링 성능, 프롬프트 히스토리 중복 제거, 그 외 25개+ 버그 수정
- (참고) 2026-05-22 핫픽스: 2.1.147에서 생긴 **Bash 종료코드 127 회귀** 수정
즉 **Round 1의 입장("공식 변경로그에서 확인 어렵다")이 옳았습니다.** 미출시·게이팅 기능이므로 릴리즈 노트에 있을 수가 없는 것입니다. Round 2·3이 인용한 "Blake Crosley 분석", "Internal release documentation"은 검증 가능한 공식 URL이 아니며, **버전 귀속은 출처 불명 과잉 구체화**였던 것으로 판단됩니다.
### 모순 ②: 환경 변수·재개 기능 등 세부 사실
흥미롭게도 Round 2가 출처 없이 제시했던 **`CLAUDE_CODE_WORKFLOWS=1`과 "단계별 재개(resumable)"는 결과적으로 사실**이었습니다. 다만 그 근거는 "릴리즈 노트"가 아니라, 게이팅된 미공개 기능을 다룬 커뮤니티 스킬 저장소였습니다. **맞는 사실을 틀린 출처(공식 릴리즈)에 귀속**한 셈입니다.
---
## 5. 영향 및 시사점
- **아키텍처 방향성:** 이는 "모델에게 오케스트레이션을 맡기지 말고, 결정론적 제어는 코드로 빼라"는 흐름의 연장선입니다. Anthropic의 매니지드 에이전트(lead→specialist sub-agent 위임)와 같은 멀티에이전트 강화 방향과 궤를 같이합니다.
- **사용자 관점:** 현재로선 **프로덕션 의존 금지**가 타당합니다. 미발표·게이팅 상태이며 활성화 방식("환경 변수")이 정식 출시 때 **바뀔 수 있다**고 명시돼 있습니다.
- **정보 위생:** 이번 사례는 "그럴듯한 버전 번호"가 어떻게 출처 없이 확산되는지 보여주는 전형입니다. AI 도구 변화는 빠르므로, 버전·기능 주장은 반드시 공식 체인지로그로 1차 대조해야 합니다.
---
## 6. 결론
| 항목 | 검증 결과 |
|------|-----------|
| `/workflows` 실재 여부 | **실재** (단, 미출시·미발표 preview) |
| 활성화 | `CLAUDE_CODE_WORKFLOWS=1` 환경 변수로 게이팅 (변경 가능) |
| 핵심 동작 | JS 파일로 제어 흐름, 말단 `agent()`만 독립 컨텍스트, 결정론적·재개 가능, `/workflows`로 라이브 모니터링 |
| `2.1.147` 출시설 | **거짓.** 2.1.147은 `/code-review` 개명 등 별개 내용. 공식 체인지로그에 `workflows` 언급 0건 |
| "내려갔다"는 관찰 | 철회가 아니라, 본래 숨겨진 게이팅 기능의 노출/비노출로 해석됨 |
요약하면, **레딧 글의 "기능 본질"에 대한 설명은 대체로 정확하지만, "2.1.147로 출시됐다"는 핵심 주장은 사실과 다릅니다.** `/workflows`는 Anthropic이 아직 공식화하지 않은 실험적 기능이며, 정식 발표 전까지는 동작·활성화 방식 모두 유동적입니다. 정식 릴리즈 노트가 나오는지 추적할 가치는 충분합니다.
## 라운드 간 모순
- Round1은 '공식 변경로그에서 삭제되어 정보 확인 어려움'이라 했으나, Round2는 정확한 배포일(2026-05-21)·환경변수(CLAUDE_CODE_WORKFLOWS=1)·디스크 영속성/재개 등 구체 사실을 1차 출처 없이 제시 — 출처 불명 과잉 구체화 가능성
- 근거로 제시된 'Blake Crosley 분석', 'Internal release documentation'은 검증 가능한 URL/공식 출처가 아니며 사용자가 요청한 공식 릴리즈노트가 아직 미확보
---
## References
- [Claude Code 공식 체인지로그](https://code.claude.com/docs/en/changelog)
- [claude-code-workflow-creator (preview 스킬 저장소)](https://github.com/ray-amjad/claude-code-workflow-creator)
- [MindStudio: Code with Claude 2026 신규 에이전트 기능](https://www.mindstudio.ai/blog/code-with-claude-2026-new-agent-features)
- [Releasebot: Claude Code 업데이트(2.1.147)](https://releasebot.io/updates/anthropic/claude-code)
댓글
댓글 쓰기