В проекте есть функция экспорта, и пользователи жалуются, что пустая таблица вызывает ошибку. Вместо просьбы «исправь всё» полезнее задать Codex конкретный результат: найти причину, предложить минимальное изменение и подтвердить поведение на пустом и обычном входе. Такой запрос превращает диалог с моделью в работу, которую можно проверить.
Что даёт терминальный клиент
Терминальный клиент полезен, когда ответ должен опираться на существующие файлы. Для объяснения алгоритма достаточно текста. Для исправления проекта требуется понять его структуру, зависимости и принятые команды проверки. Codex может участвовать в этом процессе, но окончательное качество определяется изменением и доказательствами его работы.
Сначала сообщите правила проекта
В Codex для проектных инструкций используется AGENTS.md. Документация описывает глобальный и проектный уровни, а также более локальные инструкции по пути к рабочему каталогу. Это позволяет отделить общие правила команды от особенностей конкретной части проекта.
Хорошая инструкция коротка и проверяема. Вместо «пиши качественный код» укажите, где лежат исходники, какие проверки существуют и какие действия требуют отдельного решения. Если команда тестов неизвестна, агент должен её найти в проекте и сообщить, что именно он обнаружил, а не изобрести подходящую команду.
Полезно различать постоянные правила и текущее задание. Постоянное правило: не изменять формат данных без согласованной миграции. Текущее задание: обработать пустой набор строк в одной функции. Большое описание всей истории проекта обычно затрудняет поиск обоих.
Пример задания: пустой экспорт
Предположим, что в учебном проекте есть экспорт таблицы в CSV. Ожидаемое поведение: обычные строки экспортируются как раньше, пустая таблица возвращает файл с заголовком, а повреждённый вход вызывает понятную ошибку. Это выбранные условия примера; реальный проект может требовать другого поведения.
> Найди обработчик экспорта CSV и связанные проверки. Сначала опиши причину ошибки на пустой таблице. Затем исправь её минимальным изменением. Сохрани формат обычного экспорта. Проверь обычный вход, пустую таблицу и повреждённую строку. Не добавляй зависимости и не меняй соседние функции без необходимости. В отчёте укажи изменённые файлы и наблюдаемые результаты проверок.
Важны два ограничения. Агент не должен переписывать модуль ради одной ошибки. Он также не должен объявлять исправление успешным только потому, что внёс правку. Пустой вход, отсутствие файла и строка неверного типа являются разными ситуациями; их не стоит объединять одним результатом «ошибок нет».
Как устроить рабочий цикл
- Попросите прочитать релевантные файлы и назвать место изменения.
- Согласуйте существенный выбор поведения, если задача его не определяет.
- Получите небольшую правку, которую удобно просмотреть.
- Проверьте изменения средствами самого проекта.
- Сопоставьте итоговый отчёт с реальными результатами.
В отчёте полезны точные сведения: какая команда выполнялась, что она проверяла и чем завершилась. «Тесты пройдены» без названия набора может означать проверку совсем другого участка. Если выполнить проверку невозможно, это должно быть видно до принятия изменения.
Разрешения и текстовые инструкции
Настройки безопасности Codex определяют доступные действия и условия их выполнения. AGENTS.md сообщает агенту правила работы, но не заменяет ограничения среды.
Для проверки документации достаточно чтения. Для исправления кода нужен доступ к ограниченной области проекта. Публикация, отправка сообщений или работа с производственной системой являются отдельными действиями: они не следуют автоматически из просьбы подготовить локальное изменение.
Когда выбирать Codex CLI
Клиент подходит для задач, где терминал и файлы уже являются рабочей средой: сопровождение кода, разбор ошибок, подготовка документации по исходникам. Если основная работа идёт с визуальными интерфейсами, стоит отдельно оценить удобство среды и её доступных инструментов.
Подписка, способы входа и региональная доступность относятся к условиям сервиса; их нужно проверить для своего аккаунта. В этой статье нет сравнительного теста моделей и обещаний по времени выполнения.
Для настройки процесса читайте разбор AGENTS.md и CLAUDE.md. Для сопоставления подходов полезна статья о Claude Code, а для работы с документацией библиотек — о Context7.
Источники
Codex CLI · проектные инструкции AGENTS.md · безопасность Codex