Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
동적 워크플로우는 연구 미리보기 상태입니다. Claude Code v2.1.154 이상이 필요하며 모든 유료 요금제, Anthropic API 액세스, Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry에서 사용 가능합니다. Pro에서는
/config의 동적 워크플로우 행에서 활성화하십시오.- 서브에이전트나 스킬 대신 워크플로우를 언제 사용할지 결정하기
/deep-research로 번들된 워크플로우 실행하기- 작업을 위해 Claude가 워크플로우를 작성하도록 하기 및 저장하기
- 워크플로우가 어떻게 실행되는지 이해하고 실행 관리하기
워크플로우를 언제 사용할지
서브에이전트, 스킬, 워크플로우는 모두 다단계 작업을 실행할 수 있습니다. 차이점은 계획을 누가 보유하는지입니다:| 서브에이전트 | 스킬 | 워크플로우 | |
|---|---|---|---|
| 정의 | Claude가 생성하는 워커 | Claude가 따르는 지침 | 런타임이 실행하는 스크립트 |
| 다음에 무엇을 실행할지 결정하는 사람 | Claude, 차례대로 | Claude, 프롬프트를 따르며 | 스크립트 |
| 중간 결과가 있는 위치 | Claude의 컨텍스트 윈도우 | Claude의 컨텍스트 윈도우 | 스크립트 변수 |
| 반복 가능한 것 | 워커 정의 | 지침 | 조율 자체 |
| 규모 | 차례당 몇 가지 위임된 작업 | 서브에이전트와 동일 | 실행당 수십 개에서 수백 개의 에이전트 |
| 중단 | 차례 다시 시작 | 차례 다시 시작 | 같은 세션에서 재개 가능 |
번들된 워크플로우 실행하기
워크플로우가 실제로 작동하는 것을 보는 가장 빠른 방법은/deep-research를 실행하는 것입니다. 이는 Claude Code가 포함하는 내장 워크플로우로 많은 소스에서 질문을 조사합니다. 세션이 자유로운 상태에서 에이전트가 백그라운드에서 일련의 단계를 진행하는 것을 보고, 차례별 기록 대신 하나의 보고서를 얻습니다.
워크플로우 실행
조사하려는 질문과 함께
/deep-research를 실행합니다. 여러 각도에서 웹 검색을 확산시키고, 찾은 소스를 가져와 교차 검증하며, 인용된 보고서를 종합합니다.워크플로우 허용
Claude Code가 워크플로우를 허용할지 묻습니다. 예를 선택하여 계속합니다. 정확한 프롬프트는 권한 모드에 따라 다릅니다. 실행 전 계획 승인하기에서 모드별 옵션을 참조하십시오.
진행 상황 보기
실행이 백그라운드에서 시작됩니다. 보기는 각 단계를 에이전트 수, 토큰 총계, 경과 시간과 함께 표시합니다. 모든 단계를 드릴다운하여 해당 에이전트와 각각이 찾은 것을 확인합니다. 전체 제어 집합은 실행 보기를 참조하십시오.입력 상자 아래의 작업 패널에서도 볼 수 있습니다: 실행이 진행되는 동안 한 줄의 진행 상황 요약이 나타납니다. 아래쪽 화살표를 눌러 포커스하고, Enter를 눌러 확장합니다.
/workflows를 실행하고, 화살표 키를 사용하여 실행을 선택한 후 Enter를 눌러 진행 상황 보기를 엽니다:번들된 워크플로우
Claude Code는/deep-research를 내장 워크플로우로 포함합니다:
| 명령 | 수행 작업 |
|---|---|
/deep-research <question> | 여러 각도에서 질문에 대한 웹 검색을 확산시키고, 찾은 소스를 가져와 교차 검증하며, 각 주장에 투표하고, 교차 검증을 통과하지 못한 주장이 필터링된 인용된 보고서를 반환합니다. WebSearch 도구를 사용 가능해야 합니다 |
/ 자동완성에 나타납니다.
실행 보기
워크플로우는 백그라운드에서 실행되므로 에이전트가 작동하는 동안 세션은 응답성을 유지합니다. 언제든지/workflows를 실행하여 실행 중이거나 완료된 워크플로우를 나열한 후 하나를 선택하여 진행 상황 보기를 엽니다.
| 키 | 작업 |
|---|---|
↑ / ↓ | 단계 또는 에이전트 선택 |
Enter 또는 → | 선택한 단계로 드릴다운한 후 에이전트로 드릴다운하여 프롬프트, 최근 도구 호출, 결과 읽기 |
Esc | 한 수준 뒤로 |
j / k | 에이전트 세부 정보가 오버플로우할 때 스크롤 |
p | 실행 일시 중지 또는 재개 |
x | 선택한 에이전트 중지 또는 포커스가 실행에 있을 때 전체 워크플로우 중지 |
r | 선택한 실행 중인 에이전트 다시 시작 |
s | 실행의 스크립트를 명령으로 저장 |
Claude가 워크플로우를 작성하도록 하기
두 가지 방법으로 Claude가 작업을 위한 워크플로우를 작성하도록 할 수 있습니다:- 프롬프트에서 워크플로우 요청하기
workflow단어를 포함하면 Claude가 작업을 위한 워크플로우를 작성합니다. - ultracode로 Claude가 결정하도록 하기:
/effort ultracode를 설정하면 Claude가 세션의 모든 실질적인 작업을 위한 워크플로우를 계획합니다.
/deep-research와 같은 번들된 워크플로우 또는 저장한 것입니다.
프롬프트에서 워크플로우 요청하기
세션의 노력 수준을 변경하지 않고 단일 작업을 워크플로우로 실행하려면 프롬프트의 어디든workflow 단어를 포함하십시오.
alt+w를 눌러 이 프롬프트에서 무시합니다.
ultracode로 Claude가 결정하도록 하기
Ultracode는xhigh 추론 노력을 자동 워크플로우 조율과 결합하는 Claude Code 설정입니다. 활성화하면 Claude는 요청을 기다리는 대신 각 실질적인 작업을 위한 워크플로우를 계획합니다.
/effort high로 내려갑니다. xhigh 노력을 지원하는 모델에서 사용 가능합니다; 다른 모델에서는 /effort 메뉴가 이를 제공하지 않습니다.
실행 전 계획 승인하기
CLI에서 실행별 프롬프트는 계획된 단계와 다음 옵션을 표시합니다:- 예, 실행: 실행 시작
- 예,
<path>의<name>에 대해 다시 묻지 않기: 시작하고 이 프로젝트에서 이 워크플로우에 대해 이 프롬프트를 건너뜁니다 - 원본 스크립트 보기: 결정하기 전에 스크립트 읽기
- 아니오: 취소
Ctrl+G는 편집기에서 스크립트를 엽니다. Tab을 사용하면 실행 시작 전에 프롬프트를 조정할 수 있습니다.
이 프롬프트를 보는지 여부는 권한 모드에 따라 다릅니다:
| 권한 모드 | 프롬프트가 표시되는 경우 |
|---|---|
| 기본값, 편집 수락 | 해당 워크플로우에 대해 예, 다시 묻지 않기를 선택하지 않은 한 모든 실행 |
| 자동 | 첫 번째 실행만. 모든 예는 사용자 설정에 동의를 기록하고, 나중의 실행은 프롬프트 없이 시작합니다. ultracode가 활성화되면 완전히 건너뜁니다 |
권한 무시, claude -p, Agent SDK | 절대 안 됨. 실행이 즉시 시작됩니다 |
acceptEdits 모드에서 실행되고 세션의 모드와 관계없이 도구 허용 목록을 상속합니다. 파일 편집은 자동 승인됩니다.
허용 목록에 없는 셸 명령, 웹 페치, MCP 도구는 여전히 실행 중에 프롬프트할 수 있습니다. 긴 실행에서 이를 피하려면 에이전트가 필요로 하는 명령을 시작 전에 허용 목록에 추가하십시오.
claude -p 및 Agent SDK에서는 프롬프트할 사람이 없으므로 도구 호출은 대화형 확인 없이 구성된 권한 규칙을 따릅니다.
재사용을 위해 워크플로우 저장하기
Claude가 반복할 작업을 위한 워크플로우를 작성하면 해당 실행의 스크립트를 명령으로 저장할 수 있습니다. 모든 분기에서 실행하는 검토와 같은 프로세스는 매번 같은 조율을 실행합니다./workflows를 실행하고, 유지하려는 실행을 선택한 후 s를 누릅니다. 저장 대화에서 Tab은 두 저장 위치 사이를 전환합니다:
.claude/workflows/프로젝트에서: 저장소를 복제하는 모든 사람과 공유~/.claude/workflows/홈 디렉토리에서: 모든 프로젝트에서 사용 가능, 자신에게만 표시
/<name>으로 실행됩니다.
프로젝트 워크플로우와 개인 워크플로우가 이름을 공유하면 프로젝트 워크플로우가 실행됩니다.
워크플로우가 어떻게 실행되는지
워크플로우 런타임은 대화와 분리된 격리된 환경에서 스크립트를 실행합니다. 중간 결과는 Claude의 컨텍스트에 들어가는 대신 스크립트 변수에 남아 있습니다. 런타임은 실행이 진행되면서 각 에이전트의 결과를 추적하며, 이것이 실행을 같은 세션 내에서 재개 가능하게 만드는 것입니다.동작 및 제한
런타임은 다음 제약을 적용합니다:| 제약 | 이유 |
|---|---|
| 실행 중 사용자 입력 없음 | 에이전트 권한 프롬프트만 실행을 일시 중지할 수 있습니다. 단계 간 승인을 위해 각 단계를 자신의 워크플로우로 실행합니다 |
| 워크플로우 자체에서 직접 파일 시스템 또는 셸 액세스 없음 | 에이전트가 읽고, 쓰고, 명령을 실행합니다. 스크립트가 에이전트를 조율합니다 |
| 최대 16개의 동시 에이전트, CPU 코어가 제한된 머신에서는 더 적음 | 로컬 리소스 사용 제한 |
| 실행당 총 1,000개의 에이전트 | 폭주 루프 방지 |
실행 관리
실행이 시작되면/workflows 보기에서 또는 입력 상자 아래의 작업 패널에서 진행 상황 줄을 확장하여 관리합니다.
일시 중지 후 재개
실행을 중지하면 재개할 수 있습니다: 이미 완료된 에이전트는 캐시된 결과를 반환하고 나머지는 라이브로 실행됩니다./workflows에서 일시 중지된 실행을 재개하려면 선택하고 p를 누르거나, Claude에게 같은 스크립트로 워크플로우를 다시 시작하도록 요청합니다.
재개는 같은 Claude Code 세션 내에서 작동합니다. 워크플로우가 실행 중인 동안 Claude Code를 종료하면 다음 세션은 워크플로우를 새로 시작합니다.
비용
워크플로우는 많은 에이전트를 생성하므로 단일 실행은 대화에서 같은 작업을 수행하는 것보다 의미 있게 더 많은 토큰을 사용할 수 있습니다. 실행은 다른 세션과 마찬가지로 요금제의 사용량 및 속도 제한에 포함됩니다. 언제든지/workflows에서 실행 중인 워크플로우를 중지할 수 있으며 완료된 작업을 잃지 않습니다.
워크플로우의 모든 에이전트는 스크립트가 단계를 다른 것으로 라우팅하지 않는 한 세션의 모델을 사용합니다. 모델 비용을 제어하려면:
- 일상적인 작업을 위해 일반적으로 더 작은 모델로 전환하는 경우 대규모 실행 전에
/model을 확인합니다 - 작업을 설명할 때 Claude에게 가장 강력한 것이 필요하지 않은 단계에 더 작은 모델을 사용하도록 요청합니다
워크플로우 끄기
워크플로우는 CLI, Desktop 앱, IDE 확장, 비대화형 모드에서claude -p로, Agent SDK에서 사용 가능합니다. 같은 비활성화 설정이 모든 표면에 적용됩니다.
자신을 위해 워크플로우를 끄려면:
/config에서 동적 워크플로우를 끕니다. 세션 간에 지속됩니다.~/.claude/settings.json에서"disableWorkflows": true를 설정합니다. 세션 간에 지속됩니다.CLAUDE_CODE_DISABLE_WORKFLOWS=1을 설정합니다. 시작 시 읽으므로 설정한 곳 어디든 적용됩니다.
"disableWorkflows": true를 설정하거나 Claude Code 관리 설정 페이지의 토글을 사용합니다.
워크플로우가 비활성화되면 번들된 워크플로우 명령을 사용할 수 없고, workflow 키워드는 더 이상 실행을 트리거하지 않으며, ultracode는 /effort 메뉴에서 제거됩니다.
관련 리소스
- 에이전트를 병렬로 실행: 서브에이전트, 에이전트 보기, 에이전트 팀, 워크플로우 비교
- 사용자 정의 서브에이전트 만들기: 워크플로우가 조율하는 워커 기본 요소
- 비용 관리: 다중 에이전트 실행이 사용량 제한에 어떻게 포함되는지