· 1 мин

Автономные ИИ-агенты: как остановить зацикливание и не жечь токены

Остановить зацикливание автономного ИИ-агента можно только снаружи: жёстким лимитом (--max-turns, --max-budget-usd в Claude Code, timeout на процесс), проверяемым условием 'готово', которое проверяет код, а не модель, и сторожем, который замечает, что результата давно нет. Состояние долгой задачи храни вне агента и давай ему по одной задаче за заход.

Почему автономные ИИ-агенты Claude Code и Codex зацикливаются и как их остановить: --max-turns, бюджет, таймаут, строка-итог и сторож. Опыт крон-конвейера на 1430 запусках.

Автономные ИИ-агенты: как остановить зацикливание и не жечь токены
В статье · 7 разделовразвернуть

Зацикливание ИИ-агента - это когда агент в автономном режиме повторяет одни и те же шаги без продвижения к цели: перезапускает упавшую проверку, переписывает уже готовый файл, заново читает те же логи. Остановить это можно тремя вещами снаружи агента: жёстким лимитом (ходы, время, деньги), проверяемым условием "готово" и сторожем, который замечает тишину.

Ключевое слово тут "снаружи". Просить агента в промпте "не зацикливайся" бесполезно: он и так уверен, что делает полезную работу. Ниже - как это устроено у Claude Code и Codex на ноябрь 2026, что умеют внешние надстройки вроде LoopX и как я держу на поводке свой конвейер статей, где claude -p по крону запускается каждые 2 часа уже четыре месяца.

Почему автономные ИИ-агенты уходят в бесконечный цикл

Автономный ИИ-агент уходит в бесконечный цикл, когда у задачи нет проверяемого условия остановки, а у запуска нет внешнего лимита. Агент видит ошибку, пробует снова, получает ту же ошибку и не отличает "я не справился" от "это в принципе нельзя сделать здесь". В headless-режиме рядом нет человека, который нажмёт Ctrl+C.

Типовых сценариев четыре:

  • Повтор неисправимой ошибки. В трекере Claude Code есть репорт: агент в режиме -p бесконечно повторяет запись в файл, хотя каждый раз получает отказ в разрешении (claudeissues.com, #37935).
  • Нет лимита по умолчанию. Флаг --max-turns в Claude Code ограничивает число ходов в print-режиме, но дефолта у него нет: не указал - лимита нет (агрегатор по CLI reference).
  • Субагент без потолка. В другом пользовательском репорте субагент без max_turns нагенерил JSONL-лог на 153 ГБ и 65,6 млн строк, прежде чем сессию убили (claudeissues.com, #28148). Это репорт пользователя, не подтверждённый баг, но картинка понятная.
  • Потеря контекста между сессиями. Долгая задача переживает несколько перезапусков, и каждый новый заход начинает с нуля: заново изучает репозиторий и повторяет уже сделанное.

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

Какие стоп-краны есть у Claude Code и Codex

У Claude Code в print-режиме есть два встроенных потолка - --max-turns (ходы) и --max-budget-usd (деньги), у Codex CLI - режим /goal с паузой и бюджетом. Ограничения по времени ни у кого из них нет, его даёт обёртка: timeout из coreutils или таймаут в коде. Сводка на ноябрь 2026:

Стоп-кранГдеЧто ограничиваетЧто будет при срабатывании
--max-turns NClaude Code, -pчисло ходов агентавыход с ошибкой; без флага лимита нет
--max-budget-usd XClaude Code, -pтраты на API в долларахостановка, ошибка error_max_budget_usd (по тестам пользователей)
/goal + pause/resume/clearCodex CLI с v0.128 (30.04.2026)одну цель на много ходовCodex сам проверяет условие "готово" после каждого хода
timeout -k 30 600 ...любая обёртка (coreutils)время запускаSIGTERM, через 30 с SIGKILL
flock -nлюбая обёрткапараллельные копиивторой запуск молча выходит
LoopXнадстройка над Claude Code, Codex и др. (v2.0, октябрь 2026)состояние долгой цели между сессиямиагент берёт следующую задачу из общего списка, а не придумывает сам

Источники: --max-budget-usd - mer.vin и fast.io, /goal - OpenAI и разбор Daniel Vaughan, LoopX - репозиторий. Флаги CLI меняются от версии к версии, перед боем сверяйся с claude --help.

Главная мысль из OpenAI-гайда по /goal: цель должна иметь проверяемое условие остановки. "Реализуй план" - слабая цель, "вот какое поведение ожидается и как понять, что всё готово" - сильная. Без этого агент сам решает, когда хватит, и решает плохо.

Как я останавливаю агентов в своём конвейере

В моём конвейере статей ИИ-агент - это claude -p "/blog-draft <id>", который крон запускает каждые 2 часа. С 13 июля 2026 по 13 ноября 2026 обёртка стартовала 1430 раз, и только в части запусков дело дошло до агента. Держится всё на четырёх вещах, и ни одна из них не живёт в промпте.

Вот этот сквозной пример - генерация черновика - и пойдёт дальше по всей статье.

Гейт до старта: агента не будить, если работы нет

Самый дешёвый ход агента - тот, который не случился. Перед запуском обёртка сама, без LLM, проверяет квоты по площадкам и наличие тем в беклоге. Из 1430 запусков 1074 закончились на строке "квоты на сегодня выбраны", ещё 62 - на "нет candidate-тем". То есть в 79% случаев Claude Code вообще не поднимался. Если бы решение "есть ли работа" принимал сам агент, каждый из этих запусков стоил бы токенов.

Строка-итог вместо веры на слово

Агент обязан закончить ответ строкой ровно ИТОГ: черновик #<id> ... или ИТОГ: дубль .... Обёртка не читает рассуждения, она грепает последнюю строку:

claude --model "$BP_CLAUDE_MODEL" -p "/blog-draft $TOPIC_ID" --permission-mode acceptEdits >"$OUT" 2>&1 \
  || { cat "$OUT"; exit 12; }
grep -q '^ИТОГ: дубль' "$OUT" && exit 102
grep -q '^ИТОГ: черновик #' "$OUT" || exit 13

Нет строки - код 13, тема возвращается в беклог (topic-release), мне летит алерт в Telegram. Это и есть то самое проверяемое условие "готово", только проверяет его не модель, а grep. За четыре месяца так закрылись 275 черновиков и 2 темы-дубля.

Жёсткий таймаут с убийством всей группы процессов

У бота, который отвечает на комментарии в Threads, бюджет прогона 240 секунд, а на сам вызов Claude - 150 секунд. Генерация стартует, только если до конца бюджета осталось больше 160 секунд (GEN_MIN_LEFT_S = GEN_TIMEOUT_S + 10). Деталь, на которой я споткнулся: убить только процесс claude мало, у него остаются node-дети. Поэтому запуск идёт в отдельной сессии и по таймауту прибивается вся группа:

p = popen(cmd, cwd=str(root), stdout=subprocess.PIPE,
          stderr=subprocess.STDOUT, start_new_session=True)
try:
    raw, _ = p.communicate(timeout=timeout)
except subprocess.TimeoutExpired:
    kill(p)          # os.killpg(p.pid, signal.SIGKILL) - claude и его node-дети
    p.communicate()
    raise GenError(f"таймаут {timeout} с")

Тому же боту урезаны инструменты: разрешён только Read, а Bash, Edit, Write, WebFetch и Task в запрете. Агенту, который не может ничего записать, сложно зациклиться на записи)

Честно про дыру: у генерации черновиков такого таймаута нет. Там вместо него flock - если прошлый запуск ещё висит, следующий молча уступает слот. Агент не размножится, но зависший запуск будет висеть, пока я не замечу.

Сторож, который замечает тишину

Как я замечу? Через heartbeat. Каждый джоб при старте трогает файл-отметку, а отдельный скрипт-сторож по расписанию сверяет её возраст с порогом: генерация - 6 часов, правки - 2 часа, бот-собеседник - 1 час. Сторож появился после конкретного фейла: с 1 по 9 августа 2026 сбор SEO-метрик стоял девять дней. Джоб падал до первой строчки лога, а еженедельный дайджест исправно приходил со старыми цифрами. Заметить было нечем.

Зацикленный агент и мёртвый агент снаружи выглядят одинаково: нового результата нет. Поэтому сторож следит не за агентом, а за результатом.

Читайте такжеRoutines в Claude Code против моего парка cron-обёрток на VPS: что уехало в облако, а что нетRoutines в Claude Code запускают агентов по расписанию, вебхуку и событию GitHub. Разбираю на парке из 11 cron-обёрток, что реально уехало в облако, а что осталось на VPS и почему.

Как разбить долгую задачу на агентные заходы

Долгую задачу разбивают на короткие заходы, у каждого из которых одна единица работы, внешний лимит и проверяемый итог. Состояние (что сделано, что взято, что дальше) хранится вне агента - в базе, файле или надстройке вроде LoopX. Новый заход читает состояние, берёт одну задачу и закрывает её строкой-итогом.

Пошагово на примере того же конвейера:

  1. Вынеси состояние из головы агента. У меня это таблица тем со статусами candidate, in_work, done, rejected. Агент не помнит прошлые заходы, ему и не надо.
  2. Один заход - одна единица работы. Обёртка "клеймит" одну тему (topic-claim) и передаёт агенту её id. Не "напиши статьи из беклога", а "напиши черновик по теме 152".
  3. Пропиши итог как строку, которую можно грепнуть. Свободный текст "кажется, всё готово" не годится. Формат ответа - часть контракта скилла.
  4. Поставь внешние потолки. --max-turns и --max-budget-usd для Claude Code, timeout для любого процесса. Значения подбирай по логам удачных прогонов с запасом, а не наугад.
  5. Предусмотри откат. Упал заход - тема возвращается в очередь, а не зависает в in_work навсегда.
  6. Повесь сторожа на результат. Heartbeat старта плюс проверка, что результат появился.

Это ровно та логика, которую LoopX упаковал в инструмент: цель, список задач с "захватом" и арендой (claims и leases), журнал доказательств и передачу работы между агентами. Команда loopx quota should-run отвечает на вопрос "стоит ли этому агенту действовать сейчас". А в README у них есть честная фраза: "A timer can keep a loop running without making it useful" - таймер может крутить цикл, не делая его полезным.

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

Какие инструменты следят за долгой работой ИИ-агента

За долгой автономной работой следят три класса инструментов: встроенные режимы цели (/goal в Codex CLI), внешние надстройки над агентами (LoopX) и самодельные сторожа на heartbeat и логах. Первые держат одну цель внутри одного агента, вторые - общее состояние нескольких агентов и сессий, третьи - факт, что работа вообще идёт.

  • Codex /goal. Хранит цель между ходами, умеет /goal pause, /goal resume, /goal clear. По данным разбора Daniel Vaughan, состояние лежит в SQLite со статусами вроде active, paused, budget_limited, complete.
  • LoopX. Надстройка над Codex, Claude Code, OpenCode, Cursor и ещё десятком рантаймов. loopx status показывает цель, решения, которые ждут человека, и следующую задачу. Сами авторы пишут, что это "not an autonomous production controller", то есть не замена надзору. Учти, что по умолчанию он шлёт обезличенную статистику, отключается loopx usage-ping disable.
  • Свой сторож. Heartbeat-файлы плюс скрипт, который сравнивает их возраст с порогом и шлёт алерт в Telegram. У меня это 188 строк Python на стандартной библиотеке.

Мой выбор для соло: сторожа и строки-итога хватает, пока агент один и задача укладывается в один заход. Надстройка нужна, когда агентов несколько и они делят одну многодневную цель. Как посчитать, во что обходится каждый лишний круг, я разбирал в статье про реальную стоимость прогона агента.

Когда стоп-краны не нужны

Стоп-краны не нужны, когда агент работает у тебя на глазах: в интерактивной сессии стоп-кран - это ты и Ctrl+C. Лимиты на ходы там скорее мешают - обрывают нормальную длинную задачу на середине. Ещё не стоит городить LoopX ради одного агента и одной задачи на вечер.

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

И отдельно: стоп-кран от зацикливания не защищает от агента, который уверенно делает опасное за один ход. Это другая история, про неё был разбор, где ИИ-агенту нужен стоп-кран на действия.

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

Сколько ставить --max-turns для Claude Code в headless-режиме?

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

Чем /goal в Codex отличается от /loop в Claude Code?

/goal держит одну цель и после каждого хода проверяет, достигнуто ли условие остановки, умеет паузу и бюджет. /loop просто повторяет промпт по расписанию или в своём темпе. Для задачи с понятным 'готово' удобнее цель, для периодической проверки - цикл.

Можно ли попросить агента в промпте не зацикливаться?

Можно, но это не стоп-кран. Зацикленный агент уверен, что делает полезную работу, поэтому инструкция в промпте его не остановит. Нужны внешние лимиты и проверка результата кодом.

Как готовился материал: черновик собран моим AI-конвейером по темам и заметкам из практики, факты сверены с первоисточниками, финальный текст я прочитал, поправил и утвердил перед публикацией. Обложку к статье тоже рисует нейросеть. Про сам конвейер — в разделе обо мне.

Влад Новиков
Пишу про AI-разработку без глянца. Новые разборы — сначала в канале.
Подписаться