Что такое /goal в Claude Code: как пользоваться, писать условия и результаты на практике

Команда /goal в Claude Code позволяет написать одно условие, по которому понятно, что задача выполнена, и Claude будет сам продолжать работу, пока не достигнет этого результата. Каждый раз, когда завершается ход (один ответ Claude), отдельная небольшая модель проверяет, выполнено ли условие. Если нет, Claude переходит к следующему шагу. В этой статье по официальной документации (проверено 24 октября 2026 г.) описано, как пользоваться командой и при каких условиях она останавливается. Кроме того, приведены результаты проверки на реальной работе на этом сайте, включая расход токенов и проверку качества итогового результата.

1. Что такое /goal: отличия от обычного запроса, /loop и хуков Stop

Обычную задачу Claude выполняет до тех пор, пока не решит, что она завершена, а затем останавливается и ждёт следующей инструкции. Если задать /goal, то в конце каждого хода (одного ответа Claude) запускается проверка. Если условие ещё не выполнено, следующий ход начинается даже без вашего сообщения. В официальной документации в качестве примеров подходящих больших задач, у которых конечное состояние можно проверить, приводятся такие:

• перенести модуль на новый API, пока все места вызова не скомпилируются и тесты не пройдут
• реализовать проектный документ, пока не выполнятся все критерии приёмки
• разбить большие файлы, пока каждый не станет не больше заданного размера
• разобрать список задач с метками, пока он не опустеет

Есть три похожих механизма. Официальная документация объясняет, что выбирать между ними нужно по тому, что запускает следующий ход.

По сути, /goal — это «хук Stop, который проверяет с помощью промпта», и работает он только внутри текущего диалога. Хук Stop записывается в файл настроек и действует во всех диалогах. /goal задаётся на месте и действует только в этом диалоге.

Источник: Keep Claude working toward a goal (официальная документация Claude Code, проверено 24 октября 2026 г.).

2. Как пользоваться: установка, проверка состояния, сброс

В одном диалоге может быть только одна цель. Одна и та же команда /goal служит для установки, проверки и сброса — в зависимости от того, что написано после неё.

1. Установить: введите /goal и условие Пример: /goal тесты в test/auth все проходят, и lint тоже чистый. После установки ход начинается сразу, а само условие служит инструкцией, поэтому отдельный запрос отправлять не нужно. Если цель уже есть, новое условие её заменяет. Условие может содержать до 4 000 символов.
2. Посмотреть состояние: введите только /goal Выводятся условие, прошедшее время, количество проверок, использованные токены и причина последней проверки. Количество проверок и причина появляются после первой проверки.
3. Остановить: /goal clear Цель снимается до того, как произойдёт проверка. Одинаковый результат дают stop, off, reset, none и cancel. Если начать диалог заново командой /clear, цель тоже пропадёт.

Если возобновить диалог, цель, которая ещё не была выполнена, вернётся. Условие сохранится, а счётчики ходов, времени и токенов начнутся заново. Команда работает в настольном приложении, в удалённых сеансах и при автоматическом запуске через claude -p. Команда claude -p "/goal …" выполняется в одном запуске до достижения цели, поэтому, если хотите видеть ход работы, добавьте --output-format stream-json --verbose.

3. Как работает проверка и когда команда останавливается

Каждый раз, когда ход заканчивается, Claude Code отправляет условие и диалог до этого момента «маленькой быстрой модели». Результат проверки бывает трёх видов, и к каждому прилагается короткая причина. В среде этого сайта проверяющей моделью была Claude Haiku 5.5 (это подтверждено по записям диалога).

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

Остановка из-за ошибки

Когда работают субагенты или фоновые задачи

Если в конце хода ещё работает субагент или фоновая команда, проверка для этого хода откладывается. Когда результаты вернутся, они поступят Claude как новый ход. Если ожидание длится 30 минут, запускается «промежуточная проверка». Она читает вывод работающей задачи: если прогресс есть, команда продолжает ждать, а если работа застряла, Claude получает подсказку исправить проблему или остановиться. По умолчанию интервал удваивается: через 30 минут, через час и через два часа, а после этого повторяется каждые два часа. Первый интервал можно изменить переменной окружения CLAUDE_CODE_GOAL_CHECKIN_MINUTES. Если задать 0, промежуточные проверки и автоматические повторы отключаются.

Когда использовать нельзя и сколько это стоит

Проверяющая модель входит в механизм хуков, поэтому, как и хуки, она не работает в папках, которым вы не доверяете. Она также не работает, если в настройках disableAllHooks установлено в true или если в настройках администратора включено allowManagedHooksOnly. В этих случаях выводится причина. Токены на проверку тарифицируются по цене маленькой быстрой модели. Официальная документация говорит, что обычно это «очень немного по сравнению с основной работой». Модель для проверки можно сменить через ANTHROPIC_DEFAULT_HAIKU_MODEL, однако эта настройка действует и на другие процессы, которые используют маленькую модель, например на сжатие диалога.

Источник: Keep Claude working toward a goal (проверено 24 октября 2026 г.).

4. Как писать условие

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

Если нужно ограничить длительность работы, добавьте ограничение в само условие, например «или остановиться через 20 ходов». В официальной документации нет отдельной настройки, похожей на бюджет токенов в /goal Codex.

Одно замечание, которое мы поняли при проверке на этом сайте: то, что должно соблюдаться, пишите в самом условии, а не в отдельной инструкции. Проверяющая модель судит буквально по условию, поэтому инструкция, записанная в другом файле, может быть засчитана как «выполнено», даже если её не соблюли. В эксперименте на этом сайте это и произошло (см. главу 5).

5. Результаты двух проб /goal (для сравнения — одна обычная просьба)

Мы использовали /goal для статьи на этом сайте: выравнивание точек в конце предложений. В японских статьях накопилось 1 035 мест в уже существующих статьях, где закрывающая «。» была или отсутствовала (подсчёт проводился скриптом проверки конечных знаков препинания на этом сайте). Правило исправления было определено, а конечное состояние — «0 замечаний в проверке», поэтому мы выбрали задачу, подходящую для /goal. Мы запустили /goal дважды с разным объёмом, а для сравнения поставили рядом одну обычную просьбу.

Для сравнения взят запуск, в котором мы попытались использовать /goal, вставив условие целиком. Как описано в предупреждении из главы 2, команда не сработала, и задача выполнилась как обычная просьба. В таблице он приведён как справочное значение для такой же задачи, сформулированной обычным образом (объём и количество элементов различаются, поэтому это не строгое сравнение). Для двух запусков /goal мы ввели /goal вручную, выбрали его и проверили строку «Goal set:». Запуски проходили 23 октября 2026 г. в настольном приложении для Windows: Claude Code 2.1.308, рабочая модель Claude Opus 5.5, режим разрешений auto.

Цифры подсчитаны по записям каждого диалога (файлы JSONL, которые сохраняет Claude Code). Эквивалентная стоимость — это расчёт Claude Code по ценам API, записанный в журнал. По подписке она не списывается. Каждый результат получен в одном запуске, а объём и количество элементов от запуска к запуску различаются. При другом типе задачи или другой модели цифры будут другими. Запись в кэш у проверяющей модели соответствует объёму диалога, загруженного для проверки. Эквивалентная стоимость — это сумма по рабочей и проверяющей моделям.

Условия, которые мы написали на самом деле

Это условия, которые шли после /goal в двух запусках. Названия, относящиеся только к этому сайту (скрипт проверки, файл рабочих заметок, инструменты обновления записей), заменены описанием того, что они делают. Подробные шаги работы (прецеденты исправления и файлы, которые нельзя трогать) записаны в файле рабочих заметок (Markdown), а в условии был указан этот файл.

# Запуск меньшего объёма
Для японского текста статей с 200 по 209 (9 статей) скрипт проверки конечных знаков препинания выдаёт 0 замечаний (покажи в диалоге результат проверки для каждой из 9 статей). Commit и push выполнены по шагам из рабочих заметок. Остановиться через 30 ходов.

# Запуск большего объёма
Для японского текста статей со 100 по 199 скрипт проверки конечных знаков препинания выдаёт 0 замечаний. Соблюдать: шаги из рабочих заметок (исправлять только знаки препинания по уже принятым прецедентам; слова, смысл, переводы, метаданные и инструменты не менять). В конце каждого хода писать одну строку «осталось ○ замечаний (○ статей)». В конце показать в диалоге результаты проверки всех 48 статей из объёма, список изменённых файлов (только текст и записи сверки), пройденную проверку тегов и результат обновления записей сверки, затем выполнить commit и push по путям. Не деплоить. Остановиться через 40 ходов.

В меньшем запуске фраза «каждый ход писать оставшееся количество» была записана только в рабочих заметках. Claude завершил работу, не написав её, и проверяющая модель присвоила статус «выполнено», указав в причине, что «инструкция из процедуры не соблюдена, но условие этого не требует». Этот урок (глава 4) мы учли в условии для большего запуска.

Проверка готового результата

Мы не принимали «выполнено» от проверяющей модели на веру. Каждый раз мы в отдельном диалоге построчно проверяли различия и заново запускали проверки.

6. Что мы поняли: подходящие и неподходящие задачи

Механические задачи выполняются за один ход

Каждый запуск завершил работу за один ход. Внутри одного хода Claude может использовать инструменты десятки раз (в большем запуске Bash использовался 32 раза), поэтому задача, которую можно решить скриптом, выполняется за один раз даже при 321 элементе. Из-за этого главное преимущество /goal — «если не хватает, продолжить в следующем ходе» — для такого типа работы ни разу не сработало. Результаты получены по одному запуску на каждый объём, но между справочной обычной просьбой и двумя запусками /goal мы не увидели большой разницы ни во времени, ни в качестве результата. Дополнительные затраты составили одну проверку на запуск; каждая проверка заняла 5,6 с и 9,0 с (вся работа заняла около 6 минут и около 10 минут).

Проверяющая модель читает весь диалог

В большем запуске проверяющая модель прочитала 114 410 токенов — весь рабочий диалог целиком. Чем длиннее диалог, тем тяжелее каждая проверка. Для работы, которая идёт много ходов, или при запуске /goal в середине уже длинного диалога стоимость проверок, вероятно, будет больше, чем в этом запуске.

Проверяющая модель смотрит, выполнено ли условие

Проверяющая модель точно проверяла пункты условия, например результаты проверок и наличие commit. С другой стороны, она не смотрит на качества, которые не выражаются цифрами, например на то, естественно ли звучит предложение. «Выполнено» означает, что написанное в условии появилось в диалоге. Это не заменяет проверку готового результата.

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

7. Отличия от /goal в Codex

У OpenAI Codex тоже есть команда /goal с таким же названием. Идея (продолжать работу, сохраняя условие завершения) та же, но управление и способ задавать ограничения различаются. Подробные инструкции по Codex см. в статье Как пользоваться /goal в Codex.

Источники: для Claude Code — Keep Claude working toward a goal; для Codex — Using Goals in Codex (OpenAI Cookbook) и статья этого сайта «Как пользоваться /goal в Codex». Оба источника актуальны на 24 октября 2026 г.

Итоги

• /goal — команда, в которой вы задаёте одно условие завершения, а отдельная модель проверяет его в конце каждого хода и удерживает Claude в работе, пока условие не будет выполнено. Установка, проверка состояния и сброс выполняются одной командой.
• Проверяющая модель читает только диалог. Пишите условие так, чтобы конечное состояние, способ проверки и то, что нельзя менять, можно было подтвердить выводом Claude. Ограничение тоже включайте в условие.
• Режим разрешений не меняется, поэтому, если хотите передать работу целиком, сочетайте /goal с auto.
• В эксперименте на этом сайте механическая задача с 321 элементом завершилась за один ход. Для такой одноходовой задачи дополнительные затраты составили одну проверку. По мнению автора, польза проявляется в работе, которая не укладывается в один ход.
• «Выполнено» означает, что написанное в условии появилось в диалоге. Качество готового результата, например естественность предложений, проверяйте отдельно.
• В настольном приложении при вставке условия целиком команда может не сработать. Проверяйте по строке «Goal set:».

Как начать: переключите режим на auto → напишите условие по схеме из главы 4 (конечное состояние, способ проверки, что нельзя менять, ограничение) → введите /goal вручную, вставьте условие и проверьте строку «Goal set:» → после статуса «выполнено» сами прочитайте различия.

FAQ

Вопрос: Повышает ли /goal стоимость работы?

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

Вопрос: Как остановить работу на полпути?

Снимите цель командой /goal clear. Так же работают stop и cancel. Если работа запущена через claude -p, остановите её сочетанием Ctrl+C. Снятие цели не отменяет изменения, уже внесённые к этому моменту.

Вопрос: Может ли проверяющая модель сказать «ещё не выполнено», если Claude говорит, что закончил?

Может. Для этого проверку и выполняет отдельная модель. Если проверяющая модель говорит «ещё не выполнено», следующий ход начинается с учётом её причины. И наоборот: если в диалоге появились результаты, соответствующие условию, статус становится «выполнено», поэтому качество, которое вы не записали в условии, не гарантируется.

Вопрос: Сколько ходов работа может продолжаться до остановки?

Фиксированного предела нет. Работа останавливается, когда условие выполнено, признано невыполнимым, появилась ошибка, которую нужно исправить, или вы сняли цель. Если хотите ограничение, запишите его в условии, например «или остановиться через 20 ходов». Проверяющая модель читает только диалог, поэтому полезно добавить в условие что-то вроде «в конце каждого хода указывать количество прошедших ходов». (Ни один запуск в этом эксперименте не завершился за один ход, поэтому остановку по ограничению мы не проверяли.)

Вопрос: Что использовать: /loop или /goal?

Если конечное состояние определено, используйте /goal. Если нужно через заданные промежутки времени проверять одно и то же, используйте /loop. Например, «проверять каждые 5 минут, пока не завершится деплой» подходит для /loop, а «исправлять, пока все тесты не пройдут» — для /goal.

Источники: Keep Claude working toward a goal, Run prompts on a schedule и Hooks guide (официальная документация Claude Code); Using Goals in Codex (OpenAI Cookbook). Проверено 24 октября 2026 г.