Claude Code loop: как настроить безопасный цикл /loop

Claude Code loop обычно означает официальную команду /loop: она повторно запускает промпт, пока текущая сессия Claude Code остаётся открытой. Это инструмент для периодических проверок, а не бесконечный автономный работник. Ниже вы настроите цикл с понятным результатом, ограниченными действиями и безопасным выходом.

Что именно делает /loop

В справочнике команд Claude Code указана форма /loop [interval] [prompt]. Если задать интервал и промпт, проверка пойдёт по фиксированному расписанию. Если оставить только промпт, Claude сам выбирает паузу между итерациями. Пустая команда запускает встроенную проверку обслуживания или инструкции из .claude/loop.md.

Команда работает внутри текущей сессии. Для большинства людей удобнее официальное приложение Claude Code, а терминальный режим нужен, когда важны команды, логи и файлы проекта. Общая схема поверхностей описана на странице Claude Code, но сам цикл настраивается сообщением, которое начинается с /loop.

Не путайте повтор по времени с непрерывной работой до измеримого результата. Для второго случая Anthropic предлагает /goal: отдельный оценщик после каждого хода проверяет условие завершения. Разница зафиксирована в документации о целях. Простое правило выбора: /loop подходит для вопроса «проверяй каждые несколько минут», /goal подходит для задачи «работай, пока проверка не пройдёт».

Карта результата перед запуском

Без этой карты цикл легко превращается в повтор одной и той же дорогой или рискованной команды. Заполните семь пунктов до отправки /loop:

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

Безопасный цикл сначала наблюдает, затем сообщает. Изменение файлов, перезапуск службы, публикация и отправка сообщений должны быть отдельно разрешены и ограничены.

По теме: Claude JSON: структурированный вывод и проверка схемы

Как составить промпт с критерием остановки

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

/loop 5m Проверь только статус текущей сборки.
Успех: процесс завершён и проверка вернула код 0.
При успехе сообщи результат и попроси отменить фиксированный цикл.
При ошибке покажи только краткую причину.
Не меняй файлы, не перезапускай процессы и ничего не публикуй.

После отправки Claude Code должен подтвердить фактическую частоту и идентификатор задания. Это важно: согласно официальному руководству по расписанию, секунды округляются вверх до минуты, а интервалы, которые плохо переводятся в шаг cron, могут быть округлены. Поэтому 5m, 15m или 1h предсказуемее, чем 7m или 90m.

Если момент следующей проверки заранее неизвестен, уберите интервал:

/loop Проверяй, завершилась ли сборка.
Если она ещё идёт, сообщи текущий этап и выбери следующую паузу.
Если она завершилась, назови код выхода и останови цикл.
Не запускай сборку повторно и не исправляй ошибки.

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

Как проверить, что цикл настроен правильно

Проверка нужна до того, как вы оставите сессию без внимания. В общем гайде по Claude Code описан базовый запуск, а здесь важен именно контроль повторения.

1. Проверьте наличие команды. Введите /help и убедитесь, что /loop доступна в этой сессии.
2. Сверьте подтверждение. Частота и идентификатор задания должны совпадать с вашим намерением.
3. Дождитесь одной итерации. Отчёт должен показывать только оговорённый статус и доказательство.
4. Проверьте границы. Убедитесь, что Claude не изменил файлы и не запустил запрещённые действия.
5. Проверьте остановку. Отмените тестовый цикл и убедитесь по списку задач, что он исчез.

Перед циклом, который может читать закрытые файлы или запускать команды, отдельно настройте права. Практический порядок есть в статье о разрешениях Claude Code. /loop наследует разрешения текущей сессии, поэтому слишком широкие права не становятся безопаснее из-за хорошей формулировки промпта.

Диагностика: что проверить по симптому

Если цикл ведёт себя не так, не создавайте второй поверх первого. Пройдите последовательность от состояния планировщика к содержанию промпта:

1. Команды нет. Проверьте /help, версию Claude Code и переменную CLAUDE_CODE_DISABLE_CRON. Официальная документация предупреждает, что значение 1 отключает и планировщик, и /loop.
2. Итерация не запускается. Убедитесь, что Claude Code работает и сессия свободна. Запланированный промпт выполняется между ходами, а во время длинного ответа ждёт освобождения сессии.
3. Пауза отличается. Сверьте подтверждённое расписание. Секунды и неудобные интервалы округляются до шага планировщика.
4. Цикл продолжился после успеха. Это ожидаемо для фиксированного интервала. Найдите задание в списке и отмените его.
5. Каждый повтор просит подтверждение. Цикл наследует режим разрешений. Разрешите только безопасную проверку либо оставьте подтверждение ручным.
6. Расход растёт без прогресса. Отмените цикл, сократите входные данные и замените общий промпт одной проверкой с кратким ответом.

При проблемах с контекстом сначала уменьшите объём логов и не передавайте всю историю на каждой итерации. Дополнительные способы экономии описаны в разборе лимитов и токенов Claude Code. Критерий здесь простой: каждая итерация должна приносить новое состояние. Если состояние не меняется и следующая проверка ничего не решает, цикл лучше остановить.

По теме: Claude для вайбкодинга: проект по шагам в 2026

Ограничения и граничный случай

Сессионный цикл не является постоянным планировщиком. Официальное руководство указывает, что задачи срабатывают, пока Claude Code запущен и свободен; пропущенные срабатывания не догоняются по одному. Новая беседа очищает сессионные задания, а возобновление может восстановить только неистёкшие. Повторяющиеся задания автоматически истекают через семь дней.

Граничный случай: вы проверяете очередь раз в пять минут, но каждая обработка длится восемь минут. Планировщик не запускает параллельно три пропущенных итерации. Он выполнит одну проверку, когда Claude освободится. Если обработка событий не должна ждать, используйте событие из CI, серверный монитор или постоянную автоматизацию, а не /loop.

Ещё одна граница связана с остановкой. Если нужен фиксированный интервал наблюдения, используйте /loop и отменяйте задание после подтверждённого успеха. Если важнее измеримое завершение серии действий, задайте /goal с проверяемым условием. Если работа должна продолжаться после закрытия программы, выберите облачную routine, задание Desktop или GitHub Actions из вариантов, перечисленных Anthropic.

Частые вопросы

Можно ли запустить /loop без интервала?

Да. Claude будет выбирать паузу после каждой итерации. Это удобно, когда длительность проверки меняется и цикл должен остановиться после достижения результата.

Можно ли передать в /loop другую команду?

Можно передать доступный навык как повторяемый промпт. Некоторые встроенные команды, закрытые навыки и MCP-промпты придут как обычный текст, а не выполнятся. Сначала проверьте один ручной запуск.

Как полностью остановить повтор?

В саморегулируемом цикле во время ожидания помогает Esc. Для фиксированного задания надёжнее открыть список запланированных задач и отменить его по идентификатору.

Будет ли /loop работать после закрытия Claude Code?

Нет, обычная сессионная задача требует работающей сессии. Для долговременного расписания выберите облачную routine, задачу Desktop или автоматизацию в CI.

Какой интервал поставить первым?

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