Первый сеанс

Зачем это изучать

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

Основной курс

Если вы ещё не запускали CLI, сначала пройдите пошаговую подготовку, а затем короткую миссию 1. Эта страница остаётся подробным справочником по CLI и старым ссылкам.

Откройте терминал в папке проекта. Это может быть репозиторий Git или обычная локальная папка без истории изменений:

cd /path/to/project
codex

Codex считает текущую папку рабочей областью. Он начинает видеть файлы только после запуска и только в пределах выданных прав.

Цель этой практики

Первый успех — не большая программа, а понятный ответ без неожиданных изменений. Так вы проверите папку, права и общение с Codex с минимальным риском.

Для первого знакомства попросите только объяснение:

Изучи файлы и папки этого проекта. Ничего не меняй.
Объясни простыми словами:
1. для чего нужен проект;
2. как его запустить и проверить;
3. какие файлы ты прочитал.
Если встретится незнакомый термин, сразу расшифруй его.

Затем дайте небольшую проверяемую задачу:

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

Шаблон хорошего промпта

Промпт — это запрос к Codex. Скопируйте шаблон и замените текст в угловых скобках своими сведениями. Ненужные строки удалите.

Цель:
<Какой результат мне нужен. Например: добавить кнопку печати на страницу отчёта.>

Контекст:
<В какой папке или файле работать, что уже известно, где видна проблема.>

Ограничения:
<Что нельзя менять. Например: не менять внешний вид других страниц и не
устанавливать новые программы без моего разрешения.>

Готово, когда:
<Как проверить результат. Например: кнопка печатает отчёт, существующие
проверки проходят, а Codex перечислил изменённые файлы.>

Формат ответа:
<Насколько подробно объяснить результат и какие сведения перечислить в конце.>

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

Команды внутри диалога

Команды, начинающиеся с /, называются командами с косой чертой:

Команда	Простое назначение
/status	Показать модель, права, размер текущего диалога и лимиты
/permissions	Посмотреть или изменить доступ Codex к файлам и командам
/mention	Указать файл или папку, на которые нужно обратить внимание
/diff	Показать, какие строки файлов были добавлены, удалены или изменены
/review	Отдельно проверить изменения и найти возможные ошибки

Полный список с объяснениями — в справочнике команд с косой чертой.

Запуск сразу с готовым запросом

Можно передать первый запрос вместе с командой:

codex "Объясни назначение файлов в этой папке. Ничего не меняй."

Дополнительные флаги команды задают рабочую папку, права и другие условия только для этого запуска:

codex \
  --cd /path/to/project \
  --sandbox workspace-write \
  --ask-for-approval on-request \
  "Исправь падающую проверку и проверь результат"

Здесь --cd выбирает папку; workspace-write разрешает менять файлы только внутри неё; on-request позволяет Codex попросить отдельное разрешение, если понадобится выйти за эти границы.

Куда дальше

В основном курсе следующий шаг — поставить первую задачу. Полный инженерный шаблон сохранён в справочнике prompting.

Внешние источники ↗

• Официальные рекомендации по запросам