Codex /goal: как включить и запустить цель для агента

Codex /goal — экспериментальная команда Codex CLI, которая позволяет дать агенту одну долгую цель и не вести его за руку после каждого шага. Ниже — короткая инструкция, как включить /goal, проверить, что функция заработала, запустить первую цель и не превратить автономную сессию в хаос. Проверено на Codex CLI 0.132.0 и официальной документации OpenAI от 20 мая 2026 года.

Что такое Codex /goal

/goal — это slash-команда в Codex CLI для долгих задач. Обычный промпт чаще всего закрывает один ход: вы попросили, агент сделал, остановился и ждёт следующей инструкции. /goal работает иначе: вы задаёте не одно действие, а устойчивую цель, к которой Codex должен двигаться через несколько шагов.

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

Плохая цель звучит как список желаний: «сделай проект лучше». Хорошая цель звучит как контракт: «доведи проект до состояния, где npm run build проходит, главная страница открывается, форма отправляется, а изменения описаны в коротком отчёте».

Важное ограничение: сейчас это в первую очередь терминал

На момент написания этой инструкции /goal — экспериментальная функция Codex CLI. То есть надёжный сценарий такой: открываете терминал, заходите в папку проекта, запускаете codex и уже внутри терминального интерфейса используете /goal.

В документации OpenAI отдельно сказано, что goals пока не полностью поддерживаются в Codex app. Из приложения их можно запускать, но поведение стоит считать экспериментальным. Поэтому если вы обещаете себе «хочу, чтобы агент работал часами», начинайте именно с CLI, а не с desktop-интерфейса.

Если вы пока не ставили Codex CLI, установите его через npm и запустите первый раз:

npm i -g @openai/codex
codex

При первом запуске Codex попросит войти через ChatGPT-аккаунт или API key. Дальше команды ниже можно выполнять уже локально.

Что проверить перед включением /goal

Перед настройкой я бы сделал три простые проверки. Они экономят время, если команда не появляется или работает не так, как в ролике.

1. Обновите Codex CLI

/goal — экспериментальная команда, поэтому в старой версии CLI её может просто не быть. Обновите Codex:

npm i -g @openai/codex@latest
codex --version

2. Проверьте, что вы запускаете именно терминальный Codex

Откройте папку проекта в терминале и запустите:

codex

Если вы видите интерактивный терминальный интерфейс Codex, это нужное место. Внутри него можно вводить slash-команды: /status, /experimental, /goal.

3. Не включайте автономность на первом попавшемся проекте

Для первой проверки лучше взять безопасный черновой репозиторий или маленький pet-проект. /goal специально создан для более самостоятельной работы, поэтому не начинайте с боевого продакшена, где любое неверное изменение больно стоит.

Способ 1. Попросить Codex включить goals за вас

Самый простой путь для новичка — попросить текущего Codex-агента проверить настройку и включить её. Это удобно, если вы не хотите руками открывать config.toml и боитесь случайно сломать файл конфигурации.

Скопируйте такой запрос в Codex:

Проверь, включена ли экспериментальная функция goals в Codex CLI.
Если нет, включи её безопасным способом.
Не показывай и не трогай auth.json, токены и другие секреты.
После изменения скажи, какую команду мне выполнить для проверки.

Хороший агент в такой задаче должен сделать одно из двух: либо выполнить codex features enable goals, либо аккуратно добавить настройку goals = true в блок [features] файла ~/.codex/config.toml. После этого Codex CLI нужно перезапустить.

Способ 2. Включить через /experimental внутри CLI

Это официальный путь из интерфейса Codex. Он хорош тем, что вам не нужно помнить путь к конфигу.

1. Откройте терминал в папке проекта.
2. Запустите codex.
3. Введите /experimental.
4. Включите экспериментальную функцию goals, если она есть в списке.
5. Перезапустите Codex, если CLI попросит это сделать.

После перезапуска проверьте команду:

/goal

Если goals включены, Codex покажет состояние текущей цели или подскажет, что цель ещё не задана.

Способ 3. Включить через config.toml вручную

Если /experimental не открылся или вы настраиваете машину без интерактивного интерфейса, можно включить фичу вручную.

Откройте файл:

~/.codex/config.toml

На Windows путь обычно такой:

%USERPROFILE%\.codex\config.toml

Добавьте или найдите блок [features] и поставьте goals = true:

[features]
goals = true

Если блок [features] уже есть, не создавайте второй такой же блок. Просто добавьте строку goals = true внутрь существующего блока.

После этого закройте текущую сессию Codex и запустите её заново:

codex

Быстрая команда без ручного редактирования

В свежих версиях Codex CLI можно включить фичу отдельной командой:

codex features enable goals

Проверить состояние можно так:

codex features list

В списке должна быть строка goals со stage experimental и состоянием true.

Как запустить первую цель в Codex

Теперь откройте проект в терминале и запустите Codex:

cd path/to/your-project
codex

Внутри Codex задайте цель:

/goal Complete PLAN.md and stop when npm run build and npm test pass.

Или по-русски:

/goal Собери MVP Telegram-игры по PLAN.md. После каждого этапа запускай проверку. Остановись, когда проект собирается, основной сценарий проходит smoke-test, а в конце есть короткий отчёт.

Дальше полезно знать четыре команды управления:

Ограничение из документации OpenAI: текст цели должен быть непустым и не длиннее 4000 символов. Если инструкции длиннее, лучше положить детали в PLAN.md, TASK.md или issue, а в /goal дать ссылку на этот файл.

Как написать хорошую цель для Codex /goal

/goal раскрывается не от красивой формулировки, а от понятного договора. Агент должен заранее понимать четыре вещи: что сделать, что не трогать, как проверять прогресс и когда остановиться.

Хороший шаблон выглядит так:

/goal Сделай [результат].
Сначала прочитай [файлы/документы].
Не меняй [ограничения].
После каждого этапа проверяй [команда].
Остановись, когда [проверяемое условие готовности].

Пример для игры:

/goal Собери первую версию браузерной игры по PLAN.md.
Не меняй стек и не подключай платные сервисы.
После каждого крупного изменения запускай npm run build.
Остановись, когда игра открывается локально, есть стартовый экран, игровой цикл, экран победы/поражения и короткий список оставшихся улучшений.

Пример для рефакторинга:

/goal Перенеси старый auth-flow на новую структуру из docs/auth-plan.md.
Сохрани публичные API без изменений.
После каждого этапа запускай npm test -- auth и npm run typecheck.
Остановись, когда тесты проходят и в финальном ответе есть список изменённых файлов.

Готовые примеры /goal для копирования

Прототип продукта

/goal Реализуй MVP из PLAN.md. Двигайся по этапам, после каждого этапа запускай npm run build, исправляй ошибки сборки сам. Не добавляй новые зависимости без необходимости. Остановись, когда проект собирается и README содержит команды запуска.

Игра или интерактивный демо-проект

/goal Собери playable first version игры из GAME_SPEC.md. Проверяй, что приложение запускается локально, интерфейс не ломается на мобильной ширине, есть понятное начало и завершение игры. Остановись, когда можно пройти один полный сценарий.

Миграция

/goal Перенеси модуль payments на новую структуру из MIGRATION.md. Сохрани обратную совместимость публичных функций. После каждого checkpoint запускай npm test -- payments. Остановись, когда тесты проходят и старый путь можно оставить как rollback.

Починка тестов

/goal Добейся зелёного npm test. Не переписывай бизнес-логику ради тестов. Если тест вскрывает реальный баг, исправь код. Если тест устарел, объясни почему и обнови минимально. Остановись, когда npm test проходит или когда нужен продуктовый ответ.

Оптимизация промпта по eval

/goal Улучши prompts/support-agent.md до pass rate 90% на eval suite. После каждого изменения запускай npm run eval:support. Меняй промпт минимально, анализируй провалы и остановись, когда цель достигнута или дальнейшее улучшение требует изменения продукта.

Если вы только учитесь ставить такие задачи агентам, полезно сначала пройти базовый цикл «идея -> проект -> проверка -> публикация». В нашем мини-курсе «Вайбкодинг с нуля» мы как раз тренируем эту механику на первом продукте, чтобы Codex, Claude Code и другие агенты не были просто красивым чатом.

Как безопасно оставлять Codex работать над целью

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

• Начинайте с git-статуса. Перед долгой целью убедитесь, что важные ручные изменения сохранены или закоммичены.
• Давайте команду проверки. Не «сделай красиво», а «после каждого этапа запускай npm run build и npm test«.
• Ограничивайте область. Напишите, какие папки можно менять, а какие нельзя.
• Не давайте секреты в промпте. Ключи, токены и пароли не должны попадать в текст цели.
• Просите короткий progress log. Достаточно: текущий этап, что проверено, что осталось, есть ли блокер.

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

Если /goal не работает

Команда /goal не появляется

Скорее всего, goals не включены или Codex CLI старый. Обновите CLI, включите фичу и перезапустите терминальную сессию:

npm i -g @openai/codex@latest
codex features enable goals
codex

codex features enable goals не работает

Используйте ручной способ через ~/.codex/config.toml:

[features]
goals = true

После этого полностью закройте старую сессию Codex и откройте новую.

В Codex app поведение отличается от инструкции

Это нормально для текущего состояния фичи. OpenAI прямо помечает goals как preview/experimental и пишет, что поддержка в Codex app пока не полная. Для повторяемого результата используйте CLI.

Агент много делает, но результат мутный

Проблема обычно не в /goal, а в формулировке. Добавьте проверяемый финиш, запретите лишние зоны проекта, укажите команды проверки и попросите работать по checkpoint’ам. Чем яснее «done», тем меньше агент будет блуждать.

Цель слишком длинная

Не запихивайте весь проектный документ в одну команду. Создайте PLAN.md, положите туда детали, а в /goal напишите: «Выполни PLAN.md, остановись когда…» Это чище и ближе к тому, как OpenAI рекомендует использовать goal для длинных задач.

Codex /goal, subagents и skills: что с чем не путать

/goal — это цель текущей долгой работы. Она отвечает на вопрос: «к чему агент должен двигаться, пока задача не закрыта?»

Codex Skills — это повторяемые рабочие процессы: ревью, SEO-проверка, релизный checklist, работа с GitHub-комментариями. Skill отвечает на вопрос: «какой playbook агент должен применить?»

Subagents — это параллельные помощники под отдельные части задачи. Они отвечают на вопрос: «что можно делегировать отдельно?»

На практике это можно комбинировать: /goal держит общий финиш, skill задаёт правила процесса, а subagents помогают распараллелить независимые куски. Но для первого раза не смешивайте всё сразу. Сначала научитесь ставить одну хорошую цель.

FAQ по Codex /goal

Codex /goal бесплатный?

Это функция Codex CLI, а не отдельный продукт с отдельной кнопкой оплаты. Но сама работа Codex зависит от вашего доступа к Codex и модели, которую вы используете. Долгая автономная задача может расходовать больше лимитов, чем один короткий промпт.

Можно ли запускать /goal без проекта?

Можно, но смысл чаще всего появляется именно в папке проекта: Codex видит файлы, запускает команды, проверяет результат. Для общих рассуждений /goal обычно избыточен.

Можно ли дать несколько целей сразу?

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

Что писать в конце цели?

Условие остановки. Например: «остановись, когда npm test проходит», «остановись, когда приложение открывается на localhost и smoke-test пройден», «остановись, когда eval достигает 90%». Без условия остановки автономная работа становится угадайкой.

Нужно ли использовать /goal для каждой задачи?

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

Что важно запомнить

Если коротко: обновите Codex CLI, включите goals через codex features enable goals, /experimental или ~/.codex/config.toml, перезапустите терминальный Codex и задайте цель через /goal. Самое важное не команда, а формулировка: один результат, понятные ограничения, команда проверки и чёткое условие остановки.

Первоисточники и полезные материалы

OpenAI Follow a goal · Codex CLI slash commands · Codex CLI setup · Как установить скиллы в Codex · Скиллы для AI-агентов