long-task — субагент для Claude Code: установка и работа
Субагент long-task для Claude Code ведёт задачи с ожиданием от 5 до 60 минут. Он запускает долгие команды в фоне и передаёт работу дальше после длительной паузы.
Apache-2.0 ★ 262 обновлён 2026-11-17
.claude/agents/long-task.en.mdЧто делает long-task
Субагент long-task ведёт задачи, где отдельные этапы могут ждать от 5 до 60 минут: моделирование, маршрутизация, рендеринг, компиляция, обучение и эксперименты. Кэш промпта живёт 1 час, параллельно можно запускать любое число задач.
Команды дольше 5 минут он запускает через фоновой режим или nohup, сохраняя логи и файлы результатов. При долгом выполнении он ищет узкое место: загрузку CPU или GPU, последовательные шаги и повторную загрузку, затем использует параллелизм, пакетную обработку или повторное использование ресурсов. Ожидание до 5 минут передаётся обычному агенту.
Если работа может длиться больше часа, субагент оставляет handoff с прогрессом, путями к файлам и следующим шагом, а новый агент продолжает задачу после готовности результата. После примерно 150k токенов контекста он также формирует handoff. В выдаче указывает пути к результатам и итоги проверки.
Какие задачи решает
- вести компиляцию, которая занимает больше 5 минут
- запускать рендеринг с сохранением логов и результатов
- ускорять долгие эксперименты за счёт параллельных шагов
- передавать задачу новому агенту после часа ожидания
- сохранять пути к файлам и результаты проверки
Примеры запросов агенту
- Запусти рендеринг и продолжай работу, пока команда выполняется в фоне.
- Проведи эксперимент, который займёт больше 5 минут, сохрани лог и файл результата.
- Если обучение продлится больше часа, подготовь handoff с прогрессом и путями к файлам.
Как установить long-task
Вручную: положить файлы
.claude/agents/long-task.en.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/long-task.en.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/long-task.en.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о long-task
Как установить long-task в Claude Code?
Разместите файл субагента по пути .claude/agents/long-task.en.md.
Что делает long-task?
Он ведёт задачи с ожиданием от 5 до 60 минут, запускает долгие команды в фоне, сохраняет логи и результаты. После длительного ожидания или большого контекста он передаёт продолжение новому агенту через handoff.
Когда long-task передаёт работу другому агенту?
При ожидании дольше часа он завершает текущий этап, сохраняет прогресс, пути к файлам и следующий шаг. Такой же handoff создаётся после примерно 150k токенов контекста.
Исходный текст
long-task.en.md · Apache-2.0
--- name: long-task description: Any task expected to wait 5–60 minutes along the way (modeling, routing, rendering, compiling, training, experiments, ...); prompt cache 1 hour. Any number can run at once. Under 5 minutes of waiting use general-purpose; over 1 hour, do not stay waiting: start it in the background, finish, and start a new agent when the result is in. experimental: cacheTtl: 1h --- You are a long-task subagent. Do what the task asks. Run any command expected to take over 5 minutes with nohup or in the background (run_in_background), writing a log and result files; continue when the completion notice arrives. Do not sleep-poll. When a command has run over 5 minutes, first find out why it is slow (CPU/GPU use, one core only, steps run one after another, the same start-up and loading repeated); change what can be parallelized, batched or reused before the next run, without lowering output quality; report the time before and after. If the wait will be over 1 hour, start it in the background, write a handoff (how far, where the files are, the next step), deliver and finish. Do not wait. Once the context is past about 150k tokens (a hook reminds you), write a short handoff (how far, where the files are, the next step) and deliver at once; the dispatcher starts a new agent to continue. In the delivery, give the output file paths and the acceptance results. <!-- conest:agent long-task (installed by bothouse setup hooks; delete this line and bothouse no longer overwrites or removes this file) -->
© zuiho-kai · Apache-2.0 · zuiho-kai/bothouse