Cmd. /workflows
dynamic workflow의 실행 상태를 확인하고 일시정지·재개·저장으로 제어하는 명령
핵심 요약
/workflows는 실행 중·완료된 dynamic workflow의 진행 화면을 열어 watch·pause·resume·save하는 단일 진입점입니다.- dynamic workflow는 Claude가 작성한 JavaScript를 런타임이 백그라운드에서 돌리며 다수 subagent를 오케스트레이션하고, 중간 결과는 컨텍스트가 아닌 스크립트 변수에 보관됩니다(v2.1.154+ research preview).
- 진행 화면에서 phase·agent로 드릴다운해 프롬프트·최근 도구 호출·결과를 보고,
s로 런을/<name>재사용 명령으로 저장할 수 있습니다. - 한 런당 동시 agent 최대 16개·총 1,000개로 제한되고, pause한 런은 같은 세션에서만 재개되며 다수 agent로 토큰을 크게 더 씁니다.
명령어 원본 선언
/workflows공식 설명 요약
/workflows는 실행 중이거나 완료된 dynamic workflow의
진행 화면(progress view)을 여는 명령입니다. 공식 문서 표현은 "Open the workflow progress view to
watch, pause, resume, or save running and completed workflows"로, 워크플로를 보고(watch),
일시정지(pause), 재개(resume), 저장(save) 하는 단일 진입점입니다.
dynamic workflow에서는 Claude가 작성한 JavaScript 스크립트를 런타임이 백그라운드에서 돌리며 여러 subagent를 오케스트레이션합니다. 중간 결과는 Claude의 컨텍스트가 아니라 스크립트 변수에 담기므로, 세션은 그대로 응답할 수 있는 상태로 남고 Claude의 컨텍스트에는 최종 결과만 들어옵니다.
/workflows를 입력하면 실행/완료된 워크플로 목록이 뜨고, 방향키로 고른 뒤 Enter로 해당 런의
진행 화면에 들어갑니다. 진행 화면은 각 phase를 agent 수, 토큰 총량, 경과 시간과 함께 보여주고,
phase·agent로 드릴다운하면 각 agent의 프롬프트·최근 도구 호출·결과까지 확인합니다.
dynamic workflow는 research preview 단계이며, 모든 유료 플랜과 Anthropic API, Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry에서 사용할 수 있습니다. Pro 플랜은
/config의 "Dynamic workflows" 항목에서 직접 켜야 합니다.
/workflows 자체는 bundled skill이나 bundled workflow가 아니라 CLI에 내장된 일반 명령입니다.
유일한 bundled workflow는 /deep-research이며, 이 명령으로 실행한 런도 /workflows에서 함께
관리됩니다.
최소 지원 버전
v2.1.154이상 (dynamic workflows research preview 요구 버전, 공식 문서 기준)
사용법
/workflows진행 화면(progress view)의 푸터에 표시되는 키 조작:
| 키 | 동작 |
|---|---|
↑ / ↓ | phase 또는 agent 선택 |
Enter 또는 → | 선택한 phase로 드릴다운, 다시 agent로 들어가 프롬프트·최근 도구 호출·결과 확인 |
Esc | 한 단계 뒤로 |
j / k | agent 상세가 넘칠 때 스크롤 |
p | 런 일시정지 / 재개 |
x | 선택한 agent 중지, 포커스가 런에 있으면 워크플로 전체 중지 |
r | 선택한 실행 중 agent 재시작 |
s | 런의 스크립트를 명령으로 저장 |
입력창 아래 task 패널에서도 진행 상황 한 줄 요약을 볼 수 있습니다. 아래 방향키로 포커스한 뒤
Enter로 펼칠 수 있습니다.
좋은 사용 예
/deep-research로 시작한 리서치 런이 어느 phase까지 진행됐는지, 토큰을 얼마나 썼는지 확인- 대규모 마이그레이션이나 코드베이스 전수 점검 워크플로의 phase별 agent 결과를 드릴다운으로 검토
p로 런을 일시정지한 뒤 같은 세션에서 다시 재개(완료된 agent는 캐시 결과 반환)- 반복할 가치가 있는 런을
s로 저장해/<name>형태의 재사용 가능한 명령으로 만들기
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/workflows | dynamic workflow 진행 화면·제어 | 다수 subagent 오케스트레이션 런 상태 확인·일시정지·저장 |
/deep-research <question> | 내장 bundled workflow | 여러 출처를 교차 검증해 인용 포함 리포트를 만들 때 |
/tasks | 현재 세션 백그라운드 작업 목록 | 세션 안에서 돌아가는 작업 전반을 볼 때 |
/effort ultracode | xhigh + 자동 워크플로 오케스트레이션 | Claude가 작업마다 알아서 워크플로를 짜게 할 때 |
/batch <instruction> | bundled skill, worktree별 subagent | 코드베이스 대규모 변경을 독립 단위로 병렬 처리할 때 |
활용 사례
워크플로를 시작하는 두 가지 방법
- 프롬프트에
workflow단어 포함: 세션 effort를 바꾸지 않고 한 작업만 워크플로로 실행합니다. Claude Code가 해당 단어를 강조 표시하고 Claude가 스크립트를 작성합니다. 의도치 않게 강조됐다면alt+w로 이번 프롬프트에 한해 무시할 수 있습니다. /effort ultracode: xhigh 추론과 자동 워크플로 오케스트레이션을 묶은 설정입니다. 켜두면 Claude가 모든 실질적 작업마다 워크플로를 계획합니다. 한 요청이 이해→변경→검증처럼 여러 워크플로로 이어지면 토큰 사용과 소요 시간이 늘어납니다. 현재 세션에만 적용되고 새 세션에서 초기화되니, 일상 작업으로 돌아갈 때/effort high로 내립니다.
저장과 재사용
/workflows에서 런을 선택하고 s를 눌러 스크립트를 명령으로 저장합니다. 저장 위치는 Tab으로 전환:
.claude/workflows/(프로젝트 공유, repo를 clone한 모두가 사용)~/.claude/workflows/(홈 디렉터리, 모든 프로젝트에서 본인만 사용)
Enter로 저장하면 이후 세션에서 /<name>으로 실행됩니다. 같은 이름이 겹치면 프로젝트 워크플로가
우선합니다.
주의사항
- 승인 흐름: 워크플로 런은 시작 전 계획된 phase를 보여주고 승인을 요청합니다. permission mode에
따라 매번 묻거나(Default/accept edits) 최초 1회만 묻습니다(Auto). bypass permissions·
claude -p· Agent SDK에서는 즉시 시작됩니다. 워크플로가 생성한 subagent는 세션 모드와 무관하게 항상acceptEdits모드로 돌고 파일 편집은 자동 승인되지만, allowlist 밖의 셸 명령·web fetch·MCP 도구는 런 중에 별도로 물을 수 있으니 긴 런 전에 필요한 명령을 미리 allowlist에 추가하세요. - 동시성·총량 한계: 한 런당 동시 agent는 최대 16개(CPU 코어가 적으면 더 적게), 총 agent는 1,000개로 제한됩니다. 런 중간에는 사용자 입력을 받지 않으니, 단계별 사인오프가 필요하면 각 단계를 별도 워크플로로 나누세요.
- 재개 범위: pause한 런은 같은 Claude Code 세션 안에서만 재개됩니다. 워크플로 실행 중에 Claude Code를 종료하면 다음 세션에서는 처음부터 새로 시작합니다.
- 비용: 워크플로는 여러 agent를 띄우므로 대화로 같은 작업을 처리할 때보다 토큰을 크게 더 쓰고,
플랜의 usage·rate limit에 그대로 계산됩니다. 큰 런 전에는
/model을 확인하고, 필요 없는 단계는 더 작은 모델을 쓰도록 지시하세요. 완료된 작업을 잃지 않고도/workflows에서 언제든 런을 중지할 수 있습니다. - 결과 병합: 워크플로 결과는 사람이 diff와 검증 결과를 확인한 뒤 병합해야 합니다.
- 비활성화:
/config의 Dynamic workflows 토글,~/.claude/settings.json의"disableWorkflows": true, 환경변수CLAUDE_CODE_DISABLE_WORKFLOWS=1로 끌 수 있습니다. 비활성화하면 bundled workflow 명령이 사라지고workflow키워드도 동작하지 않으며/effort메뉴에서ultracode가 제거됩니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Dynamic workflows: https://code.claude.com/docs/en/workflows