Динамические рабочие процессы (Dynamic Workflows)

Используйте динамические рабочие процессы Claude Code, чтобы оркестрировать десятки–сотни фоновых субагентов для ревью всего репозитория, миграций и исследований — работает через QCode

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Субагенты уже позволяют «отправить клона» для параллельного изучения одного вопроса. Но когда задача становится настолько большой, что нужна «целая команда» — например, пройтись по всему репозиторию и написать ревью для каждого модуля — одного субагента недостаточно. Тут на сцену выходят динамические рабочие процессы (Dynamic Workflows).

Динамические рабочие процессы позволяют Claude Code за один раз оркестрировать десятки–сотни фоновых субагентов, каждый из которых берёт свой кусок работы и выполняется параллельно, пока вы продолжаете заниматься своими делами. Они работают на той модели, на которую в данный момент настроен Claude Code, — поэтому, как только вы направите Claude Code на QCode, рабочие процессы заработают «из коробки».

Какую задачу это решает¶

Обычные субагенты хороши для «небольшого, управляемого» параллелизма: отправить 2–3 клона, чтобы проверить API, схему и покрытие тестами соответственно. Но некоторые задачи изначально очень параллельны:

• Пофайловое ревью безопасности/качества по репозиторию из 200 файлов
• Пакетная миграция старого вызова API на новый стиль по всей кодовой базе
• Вокруг одной темы исследование десятков каталогов по отдельности с последующим сведением

При последовательном выполнении вам пришлось бы ждать, пока Claude перемалывает их по одному; запуская десятки субагентов вручную, вы сами разбиваете задачи и следите за прогрессом. Динамические рабочие процессы передают весь цикл «разбить → распределить → выполнить в фоне → свести» самому Claude Code для оркестрации.

Как запустить¶

Динамические рабочие процессы не требуют дополнительной установки, а запуск устроен легко:

• Включите ключевое слово ultracode в свой запрос; либо
• Просто попросите «запустить рабочий процесс» (run a workflow).

Как только Claude Code распознаёт намерение, он сам планирует, сколько фоновых субагентов отправить и за что отвечает каждый, после чего начинает параллельное выполнение.

> ultracode сделай ревью каждого подмодуля в src/, уделяя внимание обработке
> ошибок и валидации ввода. Пусть каждый модуль выдаст короткий отчёт, а в
> конце всё сведи в один обзор.

Или обычным естественным языком:

> Запусти для меня рабочий процесс: найди по всему репозиторию все вызовы
> старого httpClient, оцени объём изменений для миграции на новую обёртку fetch
> и сведи результаты по каталогам.

Просмотр запусков через /workflows¶

Субагенты, которых отправляет рабочий процесс, продолжают работать в фоне — они не блокируют вашу основную сессию, так что вы можете задавать другие вопросы и продолжать писать код. Чтобы увидеть, какие рабочие процессы сейчас выполняются и как далеко они продвинулись, используйте:

/workflows

Команда выводит выполняющиеся и завершённые запуски (runs) рабочих процессов, что упрощает отслеживание общего прогресса и просмотр результатов каждого субагента.

Фоновое выполнение означает, что большие задачи больше не блокируют ваше взаимодействие. Отправьте указание, займитесь чем-то другим и вернитесь, чтобы собрать результаты через /workflows.

Когда использовать рабочий процесс, а когда одного субагента¶

Оба — это одна и та же идея «параллельного делегирования» в разных масштабах, и выбор прост: смотрите на степень параллелизма и на то, нужна ли работа в фоне.

Эмпирическое правило:

• Подзадач всего несколько, и результат нужен сразу → используйте субагентов.
• Подзадач десятки или сотни, и их можно неспешно гонять в фоне → используйте динамические рабочие процессы.

Динамические рабочие процессы — это по сути «масштабированная» версия субагентов. Сначала как следует разберитесь с концепцией субагентов, и тогда рабочие процессы пойдут легче.

Использование через QCode¶

Динамические рабочие процессы работают на той модели, к которой подключён Claude Code, и не зависят от какого-либо конкретного провайдера. Это значит, что как только вы направите Claude Code на QCode, все фоновые субагенты, которых отправляет рабочий процесс, пойдут через точки доступа QCode — один и тот же API-ключ, начинающийся с cr_, действует на всём протяжении.

Минимальная настройка (протокол Anthropic):

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_ваш_ключ"

# Пользователям в Китае стоит предпочесть точку доступа asia
# export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

У BASE_URL не должно быть завершающего слэша. Обращение к этому адресу напрямую возвращает 401 — это нормально: путь верный, не хватает лишь аутентификации.

После настройки запустите Claude Code как обычно и запустите рабочий процесс с помощью ultracode. Полное описание точек доступа, три домена (api / asia / us) и пути для каждого протокола см. в разделе Точки доступа и форматы API.

Токены, потребляемые каждым фоновым субагентом в рабочем процессе, тарифицируются по выбранной вами на QCode модели. Большой рабочий процесс запускает много субагентов одновременно, поэтому расход токенов растёт пропорционально — перед крупным запуском стоит сделать пилот на небольшом объёме с флагманской моделью (например, claude-opus-5, $5/$25 за миллион токенов, контекст 1M), убедиться в качестве вывода и только потом разворачивать на полную.

Практические примеры¶

Пример 1: ревью кода по всему репозиторию¶

Пусть рабочий процесс сформирует по одному ревью на каждый крупный модуль репозитория — с единым фокусом и единым форматом вывода, а затем сведёт всё вместе:

> ultracode сделай независимое ревью кода каждого подпакета в packages/.
> Каждое ревью охватывает: обработку ошибок, граничные условия, наличие
> необработанных Promise, единообразие именования. Каждый подпакет выдаёт
> список тезисов не более 20 строк, а в конце всё сводится в одну сводную
> таблицу, отсортированную по серьёзности.

Отправив запрос, можно заниматься другими делами, позже проверить прогресс через /workflows, а когда все субагенты закончат — разом просмотреть сводную таблицу.

Пример 2: исследование масштабной миграции API¶

Прежде чем что-то менять, используйте рабочий процесс, чтобы оценить радиус поражения:

> Запусти для меня рабочий процесс: найди по всей кодовой базе все места,
> где axios используется напрямую, сгруппируй по каталогам, оцени трудозатраты
> и риски перехода на внутрипроектную обёртку httpClient и выведи таблицу
> «каталог / число вхождений / сложность миграции / замечания».

Имея полную картину, вы сможете определить порядок миграции на основе реальных данных, а не наугад.

Советы и предостережения¶

• Начинайте с малого, затем масштабируйте: при первом запуске ограничьте рабочий процесс одним каталогом или пакетом, убедитесь, что формат и качество вывода соответствуют ожиданиям, и только потом расширяйте на весь репозиторий.
• Стандартизируйте формат вывода: пропишите в запросе, что каждый субагент должен «вывести, какой длины и как отсортировать» — это сильно экономит силы на этапе сведения.
• Фон ≠ без присмотра: пока рабочий процесс выполняется, можно заниматься другим, но не забудьте вернуться и завершить дело через /workflows.
• Об изображениях: динамические рабочие процессы обрабатывают текстовые/кодовые задачи. Если вы хотите, чтобы Claude Code читал изображения (скриншоты, диаграммы архитектуры, скриншоты ошибок), это возможность визуального ввода, не связанная с рабочими процессами; если вы хотите генерировать изображения, используйте генерацию изображений gpt-image-2.
• Чтобы встроить рабочие процессы в CI/скрипты, сочетайте безголовый режим со структурированным выводом — см. Автоматизация и CI/CD.

Способы запуска и ключевые параметры¶

По состоянию на 2026-10-15, согласно официальной документации Claude Code по динамическим рабочим процессам:

В /workflows выберите запуск и нажмите s, чтобы сохранить его скрипт как свою команду: сохранение в .claude/workflows/ проекта делится с репозиторием, в ~/.claude/workflows/ — остаётся только у вас.

Запуск рабочих процессов через QCode: на что обратить внимание¶

• Параллелизм и лимиты: рабочий процесс по умолчанию может запускать 16 агентов одновременно, тогда как личный тариф QCode и разовый пакет допускают 5 одновременных запросов на API-ключ («Максимальный» — 10; см. FAQ). Если при крупном запуске срабатывает ограничение скорости (обычно 429) или сбоят отдельные агенты, сначала снизьте CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS до значения, соответствующего параллелизму вашего тарифа, и повторите.
• Стоимость: токены каждого агента оплачиваются по выбранной модели; QCode тарифицирует по токенам, цены по моделям — на qcode.cc/models. По документации, если в запуске запланировано более 25 агентов или прогноз превышает 1,5 млн токенов, на панели задач появляется предупреждение Large workflow; оно носит рекомендательный характер и запуск не приостанавливает. Безопаснее всего начать с пробы на одном каталоге или узком вопросе.
• Модель: если не указано иное, агенты используют текущую модель сессии. Для лёгких этапов при описании задачи можно попросить более лёгкую модель, например claude-haiku-5-5.

Частые ошибки и диагностика¶

Часто задаваемые вопросы¶

Можно ли продолжить после выхода из сессии?¶

В рамках той же сессии — да: попросите Claude перезапустить тот же рабочий процесс; завершённые агенты вернут сохранённые результаты, а упавшие и запущенные после них выполнятся заново. После выхода claude --resume возвращает сессию, и запуск можно воспроизвести; в заново начатой сессии записей о прошлом запуске нет.

Сколько агентов можно создать за один запуск?¶

Официальный предел — 1 000 агентов за запуск, по умолчанию 16 одновременно. Это собственные ограничения Claude Code; лимит параллелизма QCode считается отдельно, как описано выше.

Будет ли рабочий процесс дорогим?¶

Он расходует больше токенов, чем выполнение той же работы по шагам в диалоге. Сначала попробуйте на малой части, смотрите расход токенов каждого агента в /workflows и при необходимости останавливайте запуск в любой момент.

Следуют ли агенты рабочего процесса моим настройкам разрешений?¶

Да. В документации сказано, что вызовы инструментов агентов проходят те же проверки разрешений и песочницу, что и любые вызовы в вашей сессии; ключевое слово ultracode лишь определяет, как организована работа.

Как дать команде повторно использовать рабочий процесс?¶

В /workflows выберите запуск и нажмите s, сохраните его в .claude/workflows/ проекта — он будет доступен всем через репозиторий.

Хотите гонять масштабные рабочие процессы на флагманской модели, не теряя контроль над расходами? Загляните в цены QCode — один API-ключ работает на всех точках доступа.

Enterprise →