PurpleSchool — курсы программирования онлайн
  • Пути
    • Frontend React разработчик
    • Frontend Vue разработчик
    • Backend разработчик Node.js
    • Fullstack разработчик React / Node.js
    • Mobile разработчик React Native
    • Backend разработчик Golang
    • Devops инженер
    • Backend разработчик Python
  • Подписка
  • AI для кодаНовое
  • О нас
    • Отзывы
    • Реферальная программа
    • О компании
    • Контакты
  • Иконка открытия меню
    • PurpleFlow
    • Сообщество
    • PurpleПлюс
    • AI Собеседование
    • AI тренажёр
    • Проекты
PurpleSchool — платформа бесплатных roadmap и курсов для разработчиков
ютуб иконка
Telegram иконка
VK иконка
VK иконка
Курсы
ГлавнаяКаталог курсовFrontendBackendFullstack
Практика
КарьераПроектыPurpleПлюсPurpleMax
Материалы
БлогБаза знаний
Документы
Договор офертаПолитика конфиденциальностиПроверка сертификатаМиграция курсовРеферальная программа
Реквизиты
ИП Ларичев Антон АндреевичИНН 773373765379contact@purpleschool.ru

PurpleSchool © 2020 -2026 Все права защищены

  • Курсы
    • FrontendИконка стрелки
    • AI разработкаИконка стрелки
    • BackendИконка стрелки
    • DevOpsИконка стрелки
    • MobileИконка стрелки
    • ТестированиеИконка стрелки
    • Soft-skillsИконка стрелки
    • ДизайнИконка стрелки
    Иконка слояПерейти в каталог курсов
  • Бесплатно
    • Курсы
    • JavaScript Основы разработкиPython Основы PythonCSS CSS FlexboxКарта развитияВопросы для собеседований
    • База знанийИконка стрелки
    • Новостные рассылкиИконка стрелки
  • PurpleSchool — курсы программирования онлайн
    • Подписка
    • AI для кодаНовое
    • Сообщество
    Главная
    Сообщество
    Ralph Loop в Codex: цикл, который работает до зелёных тестов

    Ralph Loop в Codex: цикл, который работает до зелёных тестов

    Аватар автора Ralph Loop в Codex: цикл, который работает до зелёных тестов

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

    Иконка календаря16 ноября 2026
    CodexAI-инструментыАвтоматизацияmiddleИконка уровня middle
    Картинка поста Ralph Loop в Codex: цикл, который работает до зелёных тестов

    Ralph Loop — это цикл, в котором агент запускается снова и снова, пока внешняя проверка не подтвердит результат. В Codex его легко собрать на Bash: скрипт запускает тесты, при ошибке передаёт вывод в codex exec и повторяет шаг до зелёного результата или лимита итераций. Главное правило: решение об окончании принимает не модель, а команда проверки.

    Ниже — рабочий минимум, который мы запустили на Codex CLI 0.167, ограничения подхода и случаи, когда он не нужен.

    Почему одного запроса мало

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

    В цикле роли разделены:

    • агент меняет код;
    • проверка определяет, готова ли работа;
    • скрипт управляет повторами и останавливается по лимиту.

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

    Что нужно для запуска

    1. Установленный Codex CLI.
    2. Команда, которая надёжно проверяет результат. Например, npm test, go test ./... или сборка с линтером.
    3. 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».

    Иконка глаза10

    Комментарии

    0
    Бесплатный курс

    Учитесь программировать с AI-агентом — бесплатно

    Курс «AI в обучении: OpenCode и skills»: поставите агента и разберёте с ним любую тему — как эту статью.

    opencode

    >объясни этот код и дай задачу

    ◆Читаю src/server.ts…

    ✓Разбор готов: 4 шага

    ✓Задача → practice/01.md

    • Установка и настройка OpenCode
    • Агент и skills на практике
    • 13 уроков, 3 модуля
    Начать бесплатно

    0 ₽ · доступ сразу после регистрации

    Бесплатные лекции

    Лучшие курсы по теме

    изображение курса

    Основы Git

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.9
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    HTML и CSS

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.9
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    CSS Flexbox

    Антон Ларичев
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.9
    бесплатно
    Подробнее

    Похожие статьи

    Картинка поста Как скачать и установить Codex на Windows, macOS и Linux
    Иконка аватараАнтон
    Иконка календаря14 ноября 2026
    CodexAI-инструментыУстановкаjuniorИконка уровня junior

    Как скачать и установить Codex на Windows, macOS и Linux

    Как скачать и установить Codex CLI через npm, Homebrew или установщик, настроить доступ из России и проверить запуск.

    Иконка чипа0
    Иконка глаза132
    Иконка комментариев0
    Картинка поста Claude в Казахстане, Беларуси и других странах: где работает
    Иконка аватараАнтон
    Иконка календаря15 ноября 2026
    AnthropicClaudeAI-инструментыjuniorИконка уровня junior

    Claude в Казахстане, Беларуси и других странах: где работает

    В каких странах доступен Claude: Казахстан, Узбекистан, Армения, Беларусь и Россия. Что проверить и какие есть варианты.

    Иконка чипа0
    Иконка глаза194
    Иконка комментариев0
    Картинка поста Claude Code на Mac: установка и подключение из России
    Иконка аватараАнтон
    Иконка календаря13 ноября 2026
    Claude CodeAnthropicAI-инструментыjuniorИконка уровня junior

    Claude Code на Mac: установка и подключение из России

    Как установить Claude Code на macOS через npm или Homebrew, добавить ключ в zsh и проверить работу из России.

    Иконка чипа0
    Иконка глаза523
    Иконка комментариев0
    Иконка чипа0