Перейти к основному содержанию
Dynamic workflows требуют Claude Code v2.1.154 или позже и доступны на всех платных планах, с доступом к Anthropic API, а также на Amazon Bedrock, Google Cloud’s Agent Platform и Microsoft Foundry. На Pro включите их из строки Dynamic workflows в /config.
Dynamic workflow — это JavaScript-скрипт, который оркестрирует подагентов в масштабе. Claude пишет скрипт для описанной вами задачи, а runtime выполняет его в фоне, пока ваша сессия остаётся отзывчивой. Используйте workflow, когда задача требует больше агентов, чем может координировать одна беседа, или когда вы хотите, чтобы оркестрация была закодирована в скрипт, который вы можете прочитать и переиспользовать. Примеры включают сквозную проверку кодовой базы на ошибки, миграцию 500 файлов, исследовательский вопрос, который требует перекрёстной проверки источников друг против друга, и сложный план, стоящий того, чтобы его разработать с нескольких независимых углов перед тем, как вы примете решение.

​
Когда использовать workflow

Подагенты, skills, команды агентов и workflows могут все запустить многошаговую задачу. Разница в том, кто держит план:
ПодагентыSkillsКоманды агентовWorkflows
Что этоРабочий Claude, которого вы создаётеИнструкции, которые следует ClaudeВедущий агент, контролирующий сеансы коллегСкрипт, который выполняет runtime
Кто решает, что запустить дальшеClaude, ход за ходомClaude, следуя подсказкеВедущий агент, ход за ходомСкрипт
Где живут промежуточные результатыКонтекстное окно ClaudeКонтекстное окно ClaudeОбщий список задачПеременные скрипта
Что повторяемоОпределение рабочегоИнструкцииОпределение командыСама оркестрация
МасштабНесколько делегированных задач за ходТо же, что подагентыНесколько долгоживущих коллегДесятки-сотни агентов за запуск
ПрерываниеПерезапускает ходПерезапускает ходТоварищи по команде продолжают работатьВозобновляемо в той же сессии
Workflow перемещает план в код. С подагентами, skills и командами агентов Claude является оркестратором: он решает ход за ходом, что создавать или назначать дальше, и каждый результат попадает в контекстное окно. Скрипт workflow держит цикл, ветвление и промежуточные результаты сам, поэтому контекст Claude содержит только финальный ответ. Перемещение плана в код также позволяет workflow применить повторяемый паттерн качества, а не просто запустить больше агентов: он может иметь независимых агентов, которые противоречиво рецензируют выводы друг друга перед тем, как они будут доложены, или разработать план с нескольких углов и взвесить их друг против друга, чтобы вы получили более надёжный результат, чем один проход.

​
Запустить bundled workflow

Самый быстрый способ увидеть workflow в действии — запустить /deep-research, встроенный workflow, который Claude Code включает для исследования вопроса по множеству источников. Вы увидите, как агенты работают через набор фаз в фоне, пока ваша сессия остаётся свободной, и получите один отчёт в конце вместо пошагового транскрипта.
1

Запустить workflow

Запустите /deep-research с вопросом, который вы хотите исследовать. Он распределяет веб-поиски по нескольким углам, получает и перекрёстно проверяет найденные источники и синтезирует цитируемый отчёт.
/deep-research What changed in the Node.js permission model between v20 and v22?
2

Разрешить workflows

Claude Code спрашивает, разрешить ли workflow. Выберите Yes для продолжения. Точная подсказка зависит от вашего режима разрешений. Смотрите Одобрить план перед его запуском для опций для каждого режима.
3

Смотреть прогресс

Запуск начинается в фоне. Запустите /workflows, используйте клавиши со стрелками для выбора запуска и нажмите Enter для открытия его представления прогресса:
/workflows
Представление показывает каждую фазу с количеством агентов, общим количеством токенов и прошедшим временем. Углубитесь в любую фазу, чтобы увидеть её агентов и то, что каждый из них нашёл. Смотрите Смотреть запуск для полного набора элементов управления.Вы также можете смотреть из панели задач ниже поля ввода: там появляется однострочное резюме прогресса во время выполнения запуска. Нажмите стрелку вниз для фокусировки, затем Enter для расширения.
4

Прочитать отчёт

Когда запуск завершится, отчёт попадает в вашу сессию. Он цитирует источники, из которых каждое утверждение пришло, с утверждениями, которые не пережили перекрёстную проверку, уже отфильтрованными.Начиная с версии 2.1.196, когда агенты-верификаторы не могут проверить утверждение, например после ограничения скорости или ошибки API, отчёт указывает это утверждение как непроверенное вместо того, чтобы считать его опровергнутым.
Чтобы запустить workflow для вашей собственной задачи, попросите Claude написать один, и как только запуск сделает то, что вы хотели, вы можете сохранить его как команду вашу собственную.

​
Bundled workflows

Claude Code включает /deep-research как встроенный workflow:
КомандаЧто она делает
/deep-research <question>Распределяет веб-поиски по вопросу по нескольким углам, получает и перекрёстно проверяет найденные источники, голосует по каждому утверждению и возвращает цитируемый отчёт с утверждениями, которые не пережили перекрёстную проверку, отфильтрованными. Требует, чтобы инструмент WebSearch был доступен
Workflows, которые вы сохраняете сами, становятся командами таким же образом и появляются в автодополнении / рядом с встроенными.

​
Смотреть запуск

Workflows работают в фоне, поэтому сессия остаётся отзывчивой, пока агенты работают. Запустите /workflows в любое время для списка работающих и завершённых workflows, затем выберите один для открытия его представления прогресса. 
/workflows
Представление прогресса показывает каждую фазу с количеством агентов, общим количеством токенов и прошедшим временем. Нижний колонтитул перечисляет ключ для каждого действия:
КлючДействие
↑ / ↓Выбрать фазу или агента
Enter или →Углубиться в выбранную фазу, затем в агента для чтения его подсказки, недавних вызовов инструментов и результата
EscВернуться на один уровень назад
j / kПрокручивать в деталях агента, когда это переполняется
fФильтровать список агентов в выбранной фазе по статусу. Нажмите снова для циклирования
pПриостановить или возобновить запуск
xОстановить выбранного агента или остановить весь workflow, когда фокус находится на запуске
rПерезапустить выбранного работающего агента
sСохранить скрипт запуска как команду

​
Попросить Claude написать workflow

Вы можете попросить Claude написать workflow для вашей задачи двумя способами: Вы также можете запустить команду workflow, которая уже существует: bundled workflow как /deep-research, или один, который вы сохранили.

​
Попросить workflow в вашей подсказке

Чтобы запустить одну задачу как workflow без изменения уровня усилий сессии, включите ключевое слово ultracode в вашу подсказку. Просьба в ваших собственных словах, например “использовать workflow” или “запустить workflow”, также работает: Claude рассматривает прямой запрос как то же самое согласие. До версии 2.1.160 буквальное ключевое слово было workflow; запросы на естественном языке работают в обеих версиях. 
ultracode: audit every API endpoint under src/routes/ for missing auth checks
Claude Code выделяет ключевое слово в вашем вводе и Claude пишет скрипт workflow для задачи вместо того, чтобы работать через него ход за ходом. Если вы не имели в виду запустить workflow, нажмите Option+W на macOS или Alt+W на Windows и Linux, чтобы отменить выделение для этой подсказки, или нажмите backspace, пока курсор находится прямо после выделенного ключевого слова. Чтобы остановить ключевое слово от срабатывания вообще, отключите Ultracode keyword trigger в /config. Если запуск делает то, что вы хотели, вы можете сохранить его как команду после этого. Если у вас уже есть оркестратор, построенный другим способом, например папка подсказок подагентов или навык, который распределяет работу, вы можете указать Claude на него и попросить workflow, который делает то же самое.

​
Позволить Claude решить с ultracode

Ultracode — это параметр Claude Code, который объединяет xhigh усилие рассуждения с автоматической оркестрацией workflow. С ним включённым, Claude планирует workflow для каждой существенной задачи вместо того, чтобы ждать, пока вы попросите. 
/effort ultracode
Чтобы начать сессию с уже включённым ultracode, запустите с claude --effort ultracode. Требуется Claude Code версии 2.1.203 или позже. С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий. Ultracode длится для текущей сессии и сбрасывается, когда вы начинаете новую. Вернитесь с /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Никогда. Запуск начинается немедленно
В приложении Desktop карточка одобрения показывает имя workflow, список фаз и предупреждение об использовании токенов, с действиями Once, Always и Deny. Представление прогресса появляется в боковой панели Background tasks. Ваш режим разрешений контролирует только подсказку запуска выше. Подагенты, которые создаёт workflow, всегда работают в режиме acceptEdits и наследуют ваш список разрешённых инструментов, независимо от режима вашей сессии. Редактирования файлов автоматически одобрены. Команды shell, веб-выборки и MCP-инструменты, которые не в вашем списке разрешённых, всё ещё могут вас спросить во время запуска. Чтобы избежать этого на длительном запуске, добавьте команды, которые нужны агентам, в ваш список разрешённых перед запуском. В claude -p и Agent SDK нет никого, кого спрашивать, поэтому вызовы инструментов следуют вашим настроенным правилам разрешений без интерактивного подтверждения.

​
Сохранить workflow для переиспользования

Когда Claude пишет workflow для задачи, которую вы будете повторять, вы можете сохранить скрипт этого запуска как команду. Процесс, как проверка, которую вы запускаете на каждой ветке, затем запускает ту же оркестрацию каждый раз. Запустите /workflows, выберите запуск, который вы хотите сохранить, и нажмите s. В диалоге сохранения Tab переключается между двумя местами сохранения:
  • .claude/workflows/ в вашем проекте: общее с каждым, кто клонирует репо
  • ~/.claude/workflows/ в вашем домашнем каталоге: доступно в каждом проекте, видимо только вам
Нажмите Enter для сохранения. Workflow запускается как /<name> в будущих сессиях из любого места. В монорепо с несколькими каталогами .claude/ вы можете хранить workflows рядом с пакетом, к которому они применяются. Начиная с версии 2.1.178, сохранение в местоположение проекта записывает в ближайший каталог .claude/workflows/, который уже существует между вашей рабочей директорией и корнем репозитория, или в корень репозитория, если ни один ещё не существует. Workflows проекта также загружаются из каждого .claude/workflows/ вдоль этого пути, и когда более одного определяет одно имя, Claude Code запускает тот, который ближе всего к рабочей директории. Если project workflow и personal workflow имеют одно имя, запускается project.

​
Передать входные данные в сохранённый workflow

Сохранённый workflow может принимать входные данные через параметр args. Скрипт читает его как глобальную переменную с именем args. Используйте это для предоставления исследовательского вопроса, списка целевых путей или объекта конфигурации во время вызова вместо редактирования скрипта для каждого запуска. Следующая подсказка запускает сохранённый workflow со списком номеров проблем: 
> Run /triage-issues on issues 1024, 1025, and 1030
Claude передаёт список как структурированные данные, поэтому скрипт может вызывать методы массива и объекта на args напрямую без предварительного анализа. Если args опущен, глобальная переменная имеет значение undefined внутри скрипта.

​
Примеры подсказок workflow

Workflow подходит лучше всего, когда задача больше, чем один агент может держать в контексте, или когда один и тот же шаг нужно запустить по множеству элементов. Подсказки ниже показывают общие формы. Каждая просит Claude написать и запустить workflow для этой задачи; вы не пишете скрипт сами.

​
Аудит множества файлов на одну и ту же проблему

Распределите одного агента на файл, затем соберите и проверьте выводы. 
> use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

​
Продолжайте исправлять, пока проверка не пройдёт

Запустите проверку, исправьте то, что не прошло, и повторяйте, пока это не пройдёт или не перестанет делать прогресс. 
> use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

​
Мигрировать множество файлов параллельно

Обнаружьте файлы для миграции, преобразуйте каждый в изолированную копию, чтобы редактирования не конфликтовали, и проверьте каждый результат. 
> use a workflow to migrate every component under src/components/ from styled-components to Tailwind, working on each file in its own isolated copy

​
Проверить каждый изменённый файл и написать одно резюме

Запустите рецензента на файл, затем передайте все выводы одному агенту, который ранжирует и дедублирует их. 
> use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

​
Исследовать тему по множеству источников

Распределите читателей по changelogs, issues и docs, затем синтезируйте. Встроенный workflow /deep-research делает это; вы также можете описать более узкую версию. 
> use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

​
Найти проблемы, пока список не перестанет расти

Продолжайте искать в раундах и остановитесь, когда новые раунды не найдут ничего нового. 
> use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new

​
Как выглядит сохранённый скрипт

Когда вы сохраняете workflow, файл в .claude/workflows/ содержит блок meta, за которым следует тело скрипта, который оркестрирует подагентов. Обычно вам не нужно его редактировать, но вот форма маленького, чтобы вы могли узнать, что Claude сгенерировал: 
export const meta = {
  name: 'audit-routes',
  description: 'Audit every route handler for missing auth checks',
}

const found = await agent('List every .ts file under src/routes/.', {
  schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },
})

const audits = await pipeline(found.files, file =>
  agent(`Audit ${file} for missing authentication checks.`, { label: file }),
)

return audits.filter(Boolean)
Тело — это простой JavaScript с top-level await. agent() создаёт один подагент и pipeline() запускает один на элемент в списке. Если вы хотите отредактировать скрипт вручную, попросите Claude провести вас через изменение, или смотрите запись инструмента Workflow в справочнике Agent SDK для полного набора опций.

​
Как работает workflow

Runtime workflow выполняет скрипт в изолированной среде, отдельно от вашей беседы. Промежуточные результаты остаются в переменных скрипта вместо того, чтобы попадать в контекст Claude. Каждый запуск записывает свой скрипт в файл в директорию вашей сессии в ~/.claude/projects/. Claude получает путь при запуске, поэтому вы можете попросить его. Вы можете открыть этот файл, чтобы прочитать оркестровку, которую написал Claude, сравнить его с скриптом предыдущего запуска или отредактировать его и попросить Claude перезапустить с отредактированной версии. Runtime отслеживает результат каждого агента по мере прогресса запуска, что делает запуск возобновляемым в той же сессии.

​
Поведение и ограничения

Runtime применяет следующие ограничения:
ОграничениеПочему
Нет пользовательского ввода во время запускаТолько подсказки разрешений агентов могут приостановить запуск. Для одобрения между этапами запустите каждый этап как свой собственный workflow
Нет прямого доступа к файловой системе или shell из самого workflowАгенты читают, пишут и запускают команды. Скрипт координирует агентов
До 16 одновременных агентов, меньше на машинах с ограниченными ядрами CPUОграничивает локальное использование ресурсов
1000 агентов всего за запускПредотвращает бесконечные циклы

​
Управление запусками

Как только запуск начинается, вы управляете им из представления /workflows, или расширяя его строку прогресса в панели задач ниже поля ввода.

​
Возобновить после паузы

Если вы остановите запуск, вы можете возобновить его: агенты, которые уже завершились, возвращают свои кэшированные результаты, а остальные работают в реальном времени. Возобновите приостановленный запуск из /workflows, выбрав его и нажав p, или попросите Claude перезапустить workflow с тем же скриптом. Возобновление работает в той же сессии Claude Code. Если вы выйдете из Claude Code, пока workflow работает, следующая сессия запустит workflow заново.

​
Стоимость

Workflow создаёт множество агентов, поэтому один запуск может использовать значительно больше токенов, чем работа через ту же задачу в беседе. Запуски считаются в сторону использования вашего плана и ограничений скорости, как и любая другая сессия. Чтобы оценить расходы перед выполнением крупной задачи, сначала запустите workflow на небольшом срезе: один каталог вместо всего репозитория или узкий вопрос вместо широкого. Представление /workflows показывает использование токенов каждым агентом по мере выполнения запуска, и вы можете остановить запуск там в любое время без потери завершённой работы. Ограничения агентов среды выполнения ограничивают количество агентов, которых может создать один запуск, что ограничивает стоимость неконтролируемого скрипта. Чтобы по умолчанию сохранять каждый запуск меньшего размера, установите рекомендацию по размеру в /config. Claude Code также отмечает запуск, который растёт необычно быстро. Когда workflow планирует более 25 агентов, или его прогнозируемый общий объём токенов превышает 1,5 миллиона, его строка прогресса в панели задач ниже поля ввода показывает предупреждение Large workflow. Предупреждение указывает вам на /workflows, где вы можете остановить запуск. Требуется Claude Code v2.1.203 или позже. Предупреждение носит рекомендательный характер: оно не приостанавливает и не ограничивает запуск. Два параметра изменяются, когда вы его видите:
  • Если вы установите рекомендацию по размеру, количество агентов рекомендации заменяет порог в 25 агентов.
  • Сессии с включённым ultracode не показывают предупреждение, потому что включение ultracode уже означает согласие на крупные запуски.
Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую. Чтобы контролировать стоимость модели:
  • Проверьте /model перед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы
  • Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу

​
Установить рекомендацию по размеру

Параметр Dynamic workflow size в /config сохраняет workflows, которые пишет Claude, в меньшем масштабе по умолчанию. Claude Code отправляет параметр Claude в качестве рекомендации, поэтому подсказка, которая требует другого масштаба, всё ещё переопределяет его. Требуется Claude Code v2.1.202 или позже. Каждое значение устанавливает количество агентов, на которое Claude нацелен в написанных им скриптах.
ЗначениеРекомендация, отправленная Claude
unrestrictedНет рекомендации. Это значение по умолчанию.
smallНацеливайтесь на менее 5 агентов.
mediumНацеливайтесь на менее 15 агентов.
largeНацеливайтесь на менее 50 агентов.
Изменения вступают в силу при следующем запросе. Ограничения агентов среды выполнения по-прежнему применяются независимо от параметра.

​
Отключить workflows

Workflows доступны в CLI, приложении Desktop, расширениях IDE, неинтерактивном режиме с claude -p и Agent SDK. Те же параметры отключения применяются на каждой поверхности. Чтобы отключить workflows для себя:
  • Переключите Dynamic workflows в /config. Сохраняется между сессиями.
  • Установите "disableWorkflows": true в ~/.claude/settings.json. Сохраняется между сессиями.
  • Установите CLAUDE_CODE_DISABLE_WORKFLOWS=1. Читается при запуске, поэтому применяется везде, где вы это установите.
Чтобы отключить workflows для всей вашей организации, установите "disableWorkflows": true в управляемые параметры, или используйте переключатель на странице параметров администратора Claude Code. Когда workflows отключены, встроенные команды workflow недоступны, ключевое слово ultracode больше не запускает запуск, и ultracode удаляется из меню /effort.