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.
Dynamic workflows находятся в исследовательском превью. Они требуют Claude Code v2.1.154 или позже и доступны на всех платных планах, с доступом к Anthropic API, а также на Amazon Bedrock, Google Cloud Vertex AI и Microsoft Foundry. На Pro включите их из строки Dynamic workflows в
/config.- Решить, когда использовать workflow вместо подагентов или skills
- Запустить bundled workflow с
/deep-research - Попросить Claude написать workflow для вашей задачи и сохранить его
- Понять, как работает workflow и управлять запусками
Когда использовать workflow
Подагенты, skills и workflows могут все запустить многошаговую задачу. Разница в том, кто держит план:| Подагенты | Skills | Workflows | |
|---|---|---|---|
| Что это | Рабочий Claude, которого вы создаёте | Инструкции, которые следует Claude | Скрипт, который выполняет runtime |
| Кто решает, что запустить дальше | Claude, ход за ходом | Claude, следуя подсказке | Скрипт |
| Где живут промежуточные результаты | Контекстное окно Claude | Контекстное окно Claude | Переменные скрипта |
| Что повторяемо | Определение рабочего | Инструкции | Сама оркестрация |
| Масштаб | Несколько делегированных задач за ход | То же, что подагенты | Десятки-сотни агентов за запуск |
| Прерывание | Перезапускает ход | Перезапускает ход | Возобновляемо в той же сессии |
Запустить bundled workflow
Самый быстрый способ увидеть workflow в действии — запустить/deep-research, встроенный workflow, который Claude Code включает для исследования вопроса по множеству источников. Вы увидите, как агенты работают через набор фаз в фоне, пока ваша сессия остаётся свободной, и получите один отчёт в конце вместо пошагового транскрипта.
Запустить workflow
Запустите
/deep-research с вопросом, который вы хотите исследовать. Он распределяет веб-поиски по нескольким углам, получает и перекрёстно проверяет найденные источники и синтезирует цитируемый отчёт.Разрешить workflows
Claude Code спрашивает, разрешить ли workflow. Выберите Yes для продолжения. Точная подсказка зависит от вашего режима разрешений. Смотрите Одобрить план перед его запуском для опций для каждого режима.
Смотреть прогресс
Запуск начинается в фоне. Запустите Представление показывает каждую фазу с количеством агентов, общим количеством токенов и прошедшим временем. Углубитесь в любую фазу, чтобы увидеть её агентов и то, что каждый из них нашёл. Смотрите Смотреть запуск для полного набора элементов управления.Вы также можете смотреть из панели задач ниже поля ввода: там появляется однострочное резюме прогресса во время выполнения запуска. Нажмите стрелку вниз для фокусировки, затем Enter для расширения.
/workflows, используйте клавиши со стрелками для выбора запуска и нажмите Enter для открытия его представления прогресса:Bundled workflows
Claude Code включает/deep-research как встроенный workflow:
| Команда | Что она делает |
|---|---|
/deep-research <question> | Распределяет веб-поиски по вопросу по нескольким углам, получает и перекрёстно проверяет найденные источники, голосует по каждому утверждению и возвращает цитируемый отчёт с утверждениями, которые не пережили перекрёстную проверку, отфильтрованными. Требует, чтобы инструмент WebSearch был доступен |
/ рядом с встроенными.
Смотреть запуск
Workflows работают в фоне, поэтому сессия остаётся отзывчивой, пока агенты работают. Запустите/workflows в любое время для списка работающих и завершённых workflows, затем выберите один для открытия его представления прогресса.
| Ключ | Действие |
|---|---|
↑ / ↓ | Выбрать фазу или агента |
Enter или → | Углубиться в выбранную фазу, затем в агента для чтения его подсказки, недавних вызовов инструментов и результата |
Esc | Вернуться на один уровень назад |
j / k | Прокручивать в деталях агента, когда это переполняется |
p | Приостановить или возобновить запуск |
x | Остановить выбранного агента или остановить весь workflow, когда фокус находится на запуске |
r | Перезапустить выбранного работающего агента |
s | Сохранить скрипт запуска как команду |
Попросить Claude написать workflow
Вы можете попросить Claude написать workflow для вашей задачи двумя способами:- Попросить workflow в вашей подсказке со словом
workflow, и Claude напишет один для задачи. - Позволить Claude решить с ultracode: установите
/effort ultracodeи Claude спланирует workflow для каждой существенной задачи в сессии.
/deep-research, или один, который вы сохранили.
Попросить workflow в вашей подсказке
Чтобы запустить одну задачу как workflow без изменения уровня усилий сессии, включите словоworkflow где-нибудь в вашу подсказку.
alt+w для игнорирования его для этой подсказки.
Позволить Claude решить с ultracode
Ultracode — это параметр Claude Code, который объединяетxhigh усилие рассуждения с автоматической оркестрацией workflow. С ним включённым, Claude планирует workflow для каждой существенной задачи вместо того, чтобы ждать, пока вы попросите.
/effort high, когда вы вернётесь к рутинной работе. Это доступно на моделях, которые поддерживают xhigh усилие; на других моделях меню /effort не предлагает это.
Одобрить план перед его запуском
В CLI подсказка для каждого запуска показывает запланированные фазы и эти опции:- Yes, run it: начать запуск
- Yes, and don’t ask again for
<name>in<path>: начать и пропустить эту подсказку для этого workflow в этом проекте с этого момента - View raw script: прочитать скрипт перед решением
- No: отменить
Ctrl+G открывает скрипт в вашем редакторе. Tab позволяет вам отрегулировать подсказку перед запуском.
Видите ли вы эту подсказку, зависит от вашего режима разрешений:
| Режим разрешений | Когда вас спрашивают |
|---|---|
| Default, accept edits | Каждый запуск, если вы не выбрали Yes, and don’t ask again для этого workflow в этом проекте |
| Auto | Только первый запуск. Любой Yes записывает согласие в ваши пользовательские параметры, и более поздние запуски начинаются без подсказки. Полностью пропущено, когда ultracode включён |
Bypass permissions, claude -p, Agent SDK | Никогда. Запуск начинается немедленно |
acceptEdits и наследуют ваш список разрешённых инструментов, независимо от режима вашей сессии. Редактирования файлов автоматически одобрены.
Команды shell, веб-выборки и MCP-инструменты, которые не в вашем списке разрешённых, всё ещё могут вас спросить во время запуска. Чтобы избежать этого на длительном запуске, добавьте команды, которые нужны агентам, в ваш список разрешённых перед запуском.
В claude -p и Agent SDK нет никого, кого спрашивать, поэтому вызовы инструментов следуют вашим настроенным правилам разрешений без интерактивного подтверждения.
Сохранить workflow для переиспользования
Когда Claude пишет workflow для задачи, которую вы будете повторять, вы можете сохранить скрипт этого запуска как команду. Процесс, как проверка, которую вы запускаете на каждой ветке, затем запускает ту же оркестрацию каждый раз. Запустите/workflows, выберите запуск, который вы хотите сохранить, и нажмите s. В диалоге сохранения Tab переключается между двумя местами сохранения:
.claude/workflows/в вашем проекте: общее с каждым, кто клонирует репо~/.claude/workflows/в вашем домашнем каталоге: доступно в каждом проекте, видимо только вам
/<name> в будущих сессиях из любого места.
Если project workflow и personal workflow имеют одно имя, запускается project.
Как работает workflow
Runtime workflow выполняет скрипт в изолированной среде, отдельно от вашей беседы. Промежуточные результаты остаются в переменных скрипта вместо того, чтобы попадать в контекст Claude. Runtime отслеживает результат каждого агента по мере прогресса запуска, что делает запуск возобновляемым в той же сессии.Поведение и ограничения
Runtime применяет следующие ограничения:| Ограничение | Почему |
|---|---|
| Нет пользовательского ввода во время запуска | Только подсказки разрешений агентов могут приостановить запуск. Для одобрения между этапами запустите каждый этап как свой собственный workflow |
| Нет прямого доступа к файловой системе или shell из самого workflow | Агенты читают, пишут и запускают команды. Скрипт координирует агентов |
| До 16 одновременных агентов, меньше на машинах с ограниченными ядрами CPU | Ограничивает локальное использование ресурсов |
| 1000 агентов всего за запуск | Предотвращает бесконечные циклы |
Управлять запусками
Как только запуск начинается, вы управляете им из представления/workflows, или расширяя его строку прогресса в панели задач ниже поля ввода.
Возобновить после паузы
Если вы остановите запуск, вы можете возобновить его: агенты, которые уже завершились, возвращают свои кэшированные результаты, и остальные работают вживую. Возобновите приостановленный запуск из/workflows, выбрав его и нажав p, или попросите Claude перезапустить workflow с тем же скриптом.
Возобновление работает в той же сессии Claude Code. Если вы выйдете из Claude Code, пока workflow работает, следующая сессия запустит workflow заново.
Стоимость
Workflow создаёт множество агентов, поэтому один запуск может использовать значительно больше токенов, чем работа через ту же задачу в беседе. Запуски считаются в сторону использования вашего плана и ограничений скорости, как и любая другая сессия. Вы можете остановить работающий workflow из/workflows в любое время без потери завершённой работы.
Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую. Чтобы контролировать стоимость модели:
- Проверьте
/modelперед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы - Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу
Отключить workflows
Workflows доступны в CLI, приложении Desktop, расширениях IDE, неинтерактивном режиме сclaude -p и Agent SDK. Те же параметры отключения применяются на каждой поверхности.
Чтобы отключить workflows для себя:
- Переключите Dynamic workflows в
/config. Сохраняется между сессиями. - Установите
"disableWorkflows": trueв~/.claude/settings.json. Сохраняется между сессиями. - Установите
CLAUDE_CODE_DISABLE_WORKFLOWS=1. Читается при запуске, поэтому применяется везде, где вы это установите.
"disableWorkflows": true в управляемые параметры, или используйте переключатель на странице параметров администратора Claude Code.
Когда workflows отключены, встроенные команды workflow недоступны, ключевое слово workflow больше не запускает запуск, и ultracode удаляется из меню /effort.
Связанные ресурсы
- Запустить агентов параллельно: сравнить подагентов, представление агента, команды агентов и workflows
- Создать пользовательские подагенты: примитив рабочего, который оркестрируют workflows
- Управлять затратами: как многоагентные запуски считаются в сторону ограничений использования