Антон Ларичев

Ralph Loop — это цикл, в котором агент запускается снова и снова, пока внешняя проверка не подтвердит результат. В Codex его легко собрать на Bash: скрипт запускает тесты, при ошибке передаёт вывод в codex exec и повторяет шаг до зелёного результата или лимита итераций. Главное правило: решение об окончании принимает не модель, а команда проверки.
Ниже — рабочий минимум, который мы запустили на Codex CLI 0.167, ограничения подхода и случаи, когда он не нужен.
Почему одного запроса мало
Обычный запрос заканчивается, когда агент решил, что задача готова. Это мнение модели, а не факт. Она могла не запустить тесты, исправить только часть ошибок или неверно понять сообщение компилятора.
В цикле роли разделены:
- агент меняет код;
- проверка определяет, готова ли работа;
- скрипт управляет повторами и останавливается по лимиту.
Важно и то, что каждая итерация начинается со свежего контекста. Вместо длинной истории неудачных попыток агент получает текущий код и последнюю ошибку.
Что нужно для запуска
- Установленный Codex CLI.
- Команда, которая надёжно проверяет результат. Например,
npm test,go test ./...или сборка с линтером. - Git, чтобы посмотреть и при необходимости откатить изменения.
Если проверки нет, цикл не поможет: ему нечем определить готовность. Сначала напишите падающий тест, а уже потом запускайте агента.
Минимальный Ralph Loop
Создайте файл PROMPT.md:
Тесты проекта падают. Найди причину и исправь код. Не меняй и не удаляй тесты.Затем ralph.sh:
#!/usr/bin/env bash
set -u
MAX_ITERATIONS=5
mkdir -p .ralph
for ((i = 1; i <= MAX_ITERATIONS; i++)); do
if npm test > .ralph/last.log 2>&1; then
echo "Тесты зелёные на итерации $i"
exit 0
fi
echo "Итерация $i: тесты падают, запускаю Codex"
codex exec --sandbox workspace-write --ephemeral \
"$(cat PROMPT.md)
Вывод тестов:
$(tail -n 80 .ralph/last.log)" < /dev/null
done
echo "Лимит итераций исчерпан"
exit 1Запустите его:
chmod +x ralph.sh
echo ".ralph/" >> .gitignore
./ralph.shНа тестовом проекте функция sum вычитала вместо сложения. Первая итерация запустила Codex, он исправил код, а вторая подтвердила результат:
Итерация 1: тесты падают, запускаю Codex
Тесты зелёные на итерации 2Из чего состоит команда
--sandbox workspace-write разрешает запись внутри рабочей папки и не даёт агенту писать за её пределами.
--ephemeral не сохраняет сессию. Для такого цикла история не нужна: состояние находится в файлах и выводе тестов.
< /dev/null важнее, чем кажется. При запуске из скрипта или CI codex exec может ждать дополнительный ввод из stdin и пишет Reading additional input from stdin.... В нашем прогоне без этого перенаправления команда зависла.
tail -n 80 ограничивает объём лога. Если ошибка находится в начале вывода, увеличьте значение или настройте тесты на более короткий отчёт.
Как не сломать проект
Цикл усердно добивается зелёной проверки, поэтому ограничения нужно задать заранее.
- Запретите менять тесты. Иначе самый короткий путь к успеху — ослабить проверку. Запрет в промпте полезен, но надёжнее сравнить тесты после запуска:
git diff -- '*.test.js'. - Держите лимит итераций. Каждый запуск расходует токены.
- Начинайте с чистого git. Так вы увидите только изменения агента.
- Не используйте полный доступ без изоляции. Режим обхода песочницы подходит только для одноразового окружения.
- Проверяйте итог сами. Зелёные тесты подтверждают только то, что покрыто тестами.
Чтобы цикл не тратил итерации впустую, можно останавливать его, если ошибка повторяется:
current=$(shasum .ralph/last.log | cut -d ' ' -f 1)
if [ "${current}" = "${previous:-}" ]; then
echo "Ошибка не изменилась, нужна помощь человека"
exit 2
fi
previous="${current}"Этот блок вставляется внутрь цикла после неудачной проверки. Учитывайте, что если в логе есть время выполнения, хэш будет меняться: тогда сравнивайте только строки с ошибками.
Когда Ralph Loop подходит
| Подходит | Не подходит |
|---|---|
| Исправить тесты после обновления зависимости | «Сделай интерфейс красивее» |
| Реализовать задачу по готовому тесту | Задача без проверяемого результата |
| Устранить ошибки типов или линтера | Решение, которое зависит от бизнес-контекста |
| Выполнять задачи из заранее разбитого списка | Изменения в продакшене |
Если задач несколько, не отдавайте их в одном большом промпте. Запускайте цикл на одну задачу, проверяйте её и только потом переходите к следующей.
Как развивать цикл
Рабочий вариант для проекта обычно сложнее:
- задачи берутся из файла с планом по одной;
- после успешной проверки создаётся коммит;
- отдельный запуск агента проводит код-ревью, а замечания возвращаются в цикл;
- прогресс записывается в файл, чтобы цикл можно было продолжить;
- работа идёт в отдельной ветке или worktree.
В курсе «Продвинутый Codex» этому посвящён отдельный модуль: архитектура цикла, разбивка фазы на задачи, возврат ошибок агенту, код-ревью внутри цикла, режим AFK и приёмка результата.
Частые вопросы
Откуда название? Приём получил название в честь Ральфа Виггама из «Симпсонов»: агент упорно повторяет попытки, а простота метода — часть идеи.
Сколько это стоит? Расход зависит от размера проекта и числа итераций. Начните с небольшого лимита и посмотрите, сколько токенов уходит на один запуск.
Чем это отличается от /goal? /goal ведёт длинную задачу внутри сессии Codex, а Ralph Loop управляется вашим скриптом и внешней проверкой.
Можно ли использовать Codex из России? Да, через свой провайдер в config.toml. Инструкция — в статье Как войти в Codex из России.
Итог
Ralph Loop прост: проверка, запуск агента, повтор, лимит. Его ценность в том, что готовность определяет внешняя команда, а не сама модель. Начните со скрипта выше на одной маленькой задаче. Если хотите построить такой процесс для реального проекта, посмотрите программу курса «Продвинутый Codex».






Комментарии
0