ralph-loop — команда для Claude Code: что делает и как установить
Команда запускает автономный цикл доработки задачи в Claude Code, возвращая агенту тот же промпт при каждой попытке выхода.
/plugin install ralph-loop@claude-plugins-officialЧто делает ralph-loop
Команда вызывает bash-скрипт ${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh с заданным текстом задачи. Когда модель пробует завершить сессию, Ralph Loop отправляет исходный запрос повторно. Агент видит результаты своих прошлых шагов в изменённых файлах и истории git, продолжая править код по кругу.
Команда принимает флаги --max-iterations N и --completion-promise TEXT. Если обещание завершения задано, агент имеет право вывести эту строку только при её абсолютной истинности. Инструкция прямо запрещает выводить ложные фразы для выхода из тупика. Без лимита итераций или чёткого условия сессия будет перезапускаться бесконечно.
Какие задачи решает
- перезапускать задачу при преждевременной попытке агента выйти из диалога
- добиваться зелёных тестов через серию автономных итераций
- ограничивать количество повторных попыток через
--max-iterations - блокировать ложные отчёты о завершении с помощью
--completion-promise
Примеры запросов агенту
- /ralph-loop "Исправь падающие тесты в auth.test.ts" --completion-promise "ALL TESTS PASS"
- /ralph-loop "Приведи типы в соответствие со схемой API" --max-iterations 5
Как установить ralph-loop
1Через маркетплейс плагинов
/plugin install ralph-loop@claude-plugins-official2Вручную: положить файлы
.claude/commands/ralph-loop.mdВызов — /ralph-loop. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/ralph-loop.mdВызов — /prompts:ralph-loop. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/ralph-loop.prompt.mdВручную: положить файлы
.gemini/commands/ralph-loop.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о ralph-loop
Как установить ralph-loop в Claude Code?
Выполните команду /plugin install ralph-loop@claude-plugins-official. Также команду можно добавить вручную, создав файл .claude/commands/ralph-loop.md.
Что делает команда ralph-loop?
Она инициирует цикл выполнения, отправляя агенту один и тот же промпт каждый раз, когда он пытается завершить диалог. Прогресс отслеживается по git-коммитам и изменённым файлам.
Как работает параметр --completion-promise?
Параметр задаёт контрольный текст, который модель обязана вывести только после реального выполнения задачи. Правило запрещает отдавать эту фразу преждевременно для выхода из цикла.
Исходный текст
ralph-loop.md · Apache-2.0
---
description: "Start Ralph Loop in current session"
argument-hint: "PROMPT [--max-iterations N] [--completion-promise TEXT]"
allowed-tools: ["Bash(${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh:*)"]
hide-from-slash-command-tool: "true"
---
# Ralph Loop Command
Execute the setup script to initialize the Ralph loop:
```!
"${CLAUDE_PLUGIN_ROOT}/scripts/setup-ralph-loop.sh" $ARGUMENTS
```
Please work on the task. When you try to exit, the Ralph loop will feed the SAME PROMPT back to you for the next iteration. You'll see your previous work in files and git history, allowing you to iterate and improve.
CRITICAL RULE: If a completion promise is set, you may ONLY output it when the statement is completely and unequivocally TRUE. Do not output false promises to escape the loop, even if you think you're stuck or should exit for other reasons. The loop is designed to continue until genuine completion.
© Anthropic · Apache-2.0 · anthropics/claude-plugins-official
