Cmd. /workflows
dynamic workflow의 실행 상태를 확인하고 일시정지·재개·저장으로 제어하는 명령
핵심 요약
- dynamic workflow 진행·pause·resume·save 관리
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
dynamic workflow 진행·pause·resume·save 관리
/workflows사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 조건부 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
동적 워크플로우가 활성화된 환경에서 사용합니다.
사용 예
/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 | 코드베이스 대규모 변경을 독립 단위로 병렬 처리할 때 |
실행 결과와 유지 범위
실행 중이거나 완료된 동적 워크플로우를 보고 일시정지·재개·저장할 수 있습니다.
/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에서 함께
관리됩니다.
주의사항
- 승인 흐름: 워크플로 런은 시작 전 계획된 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가 제거됩니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록