Как пользоваться Codex: 26 команд, 8 горячих клавиш, 7 практических советов

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

«Программисту больше не обязательно объяснять компьютеру каждый шаг вручную: достаточно сформулировать задачу, а ИИ-агент поможет превратить идею в работающий код».

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

Что такое Codex

Codex — это семейство инструментов и моделей OpenAI, предназначенных для решения задач программирования с помощью искусственного интеллекта. В отличие от обычного чат-бота, который преимущественно объясняет код и предлагает фрагменты для копирования, Codex может выступать в роли агента, работающего непосредственно с проектом. Он исследует файлы, учитывает существующую архитектуру, вносит изменения и помогает проверять их корректность.

«Главное отличие ИИ-агента от простого помощника в чате — способность не только предложить решение, но и выполнить последовательность действий для достижения результата».

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

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

Команды Codex CLI

Codex CLI — это инструмент OpenAI, который позволяет работать с ИИ-агентом для программирования прямо из командной строки (CLI). Он помогает создавать и редактировать код, анализировать проекты, исправлять ошибки, запускать команды и выполнять задачи разработки по текстовым инструкциям.

Функции Codex CLI — это команды для управления работой ИИ-агента: запуск задач в интерактивном и автоматическом режимах, анализ изменений кода, управление сессиями, авторизация, подключение MCP-серверов и плагинов, настройка безопасности, диагностика и обновление инструмента.

Функция (/slug)	Краткое описание
Codex app	Запуск настольного приложения Codex с графическим интерфейсом из терминала.
Codex app-server	Запуск серверного интерфейса для взаимодействия приложений с Codex через программный протокол.
Codex apply	Применение подготовленных Codex изменений к файлам проекта с помощью патчей.
Codex archive	Архивирование поддерживаемых объектов Codex для упорядочивания активных задач и сессий.
Codex cloud	Взаимодействие с облачными задачами Codex и получение результатов работы ИИ-агента.
Codex completion	Генерация сценариев автодополнения команд Codex CLI для поддерживаемых оболочек.
Codex debug app-server send-message-v2	Отладка обмена сообщениями версии 2 в серверном интерфейсе Codex.
Codex debug models	Диагностика сведений о моделях, доступных или используемых в Codex CLI.
Codex debug prompt-input	Исследование входных данных промпта при отладке работы Codex.
Codex delete	Удаление поддерживаемых объектов Codex; перед использованием важно проверить, какие именно данные будут удалены.
Codex doctor	Диагностика установки и конфигурации Codex CLI для поиска возможных причин сбоев.
Codex exec	Запуск заданий Codex без обычного интерактивного интерфейса, в том числе из скриптов и CI/CD.
Codex execpolicy	Работа с политиками выполнения команд и правилами безопасности Codex.
Codex features	Просмотр и настройка поддерживаемых возможностей Codex CLI, включая экспериментальные функции, если они доступны.
Codex fork	Создание ответвления существующей сессии для альтернативного сценария работы с сохранением исходного контекста.
Codex login	Авторизация в Codex CLI для доступа к функциям, требующим учётной записи.
Codex logout	Выход из учётной записи и завершение текущего сеанса авторизации Codex CLI.
Codex mcp	Управление подключениями к MCP-серверам, предоставляющим Codex доступ к внешним инструментам и данным.
Codex mcp-server	Запуск Codex в режиме MCP-сервера для взаимодействия с другими совместимыми приложениями.
Codex plugin	Управление плагинами Codex, расширяющими возможности инструмента.
Codex plugin marketplace	Работа с каталогами плагинов, из которых можно получать доступные расширения.
Codex remote-control	Организация удалённого взаимодействия с Codex в поддерживаемых сценариях.
Codex resume	Возобновление предыдущей сессии Codex с сохранением контекста работы.
Codex review	Анализ изменений кода для поиска потенциальных ошибок и проблем перед отправкой изменений.
Codex sandbox	Работа с механизмами изоляции выполнения команд и ограничения доступа в Codex CLI.
Codex unarchive	Возвращение архивированных объектов в активное состояние, если это поддерживается соответствующей командой.
Codex update	Обновление Codex CLI с учётом способа установки и проверка актуальности версии.

Горячие клавиши

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

Список горячих клавиш

Команда или сочетание клавиш	Описание
@	Поиск файла в рабочей области и добавление его пути в запрос.
Up / Down	Перемещение по истории черновиков и восстановление предыдущих вариантов ввода.
Ctrl + R	Поиск по истории запросов. Нажмите Enter, чтобы использовать найденный запрос, или Escape, чтобы отменить поиск.
Ctrl + O	Копирование последнего завершённого ответа Codex. Альтернатива — команда /copy.
!	Выполнение локальной команды оболочки с текущими настройками подтверждений и песочницы.
Tab	Добавление дополнительного запроса, слеш-команды или команды оболочки в очередь, пока Codex выполняет текущую задачу.
Enter	Добавление новых инструкций в текущий ход работы Codex, пока агент выполняет задачу.
Escape дважды	При пустом поле ввода позволяет отредактировать предыдущее сообщение пользователя и создать ответвление диалога с этого момента.
Ctrl + C	Завершение сеанса. Альтернативный способ — команда /exit.

Пример 1. Добавление файла в запрос через @

Если необходимо изменить конкретный файл, используйте символ @, чтобы найти его в рабочей области и добавить в контекст запроса. Это помогает Codex быстрее определить, с каким участком проекта нужно работать.

Измени файл @src/auth.php.
Добавь проверку входных данных и обработку ошибок,
не меняя существующий интерфейс авторизации.

Пример 2. Поиск предыдущего запроса

Если вы ранее формулировали похожую задачу, необязательно вводить её заново. Нажмите Ctrl + R, найдите запрос в истории, подтвердите выбор клавишей Enter или отмените поиск с помощью Escape.

Ctrl + R
Поиск: добавь тесты для авторизации
Enter — использовать найденный запрос
Escape — отменить поиск

Пример 3. Выполнение команды оболочки

Символ ! в начале строки позволяет выполнить локальную команду оболочки непосредственно из интерфейса Codex CLI. Например, можно посмотреть состояние Git перед внесением изменений. Команда выполняется с учётом действующих настроек подтверждений и песочницы.

!git status

!git diff

!php -v

Пример 4. Постановка дополнительной задачи в очередь

Если Codex уже выполняет задачу, можно подготовить следующую инструкцию, не дожидаясь завершения текущего хода. Нажмите Tab, чтобы поставить её в очередь. Если же нужно дополнить текущую задачу новыми указаниями, используйте Enter.

Текущая задача:
Исправить обработку ошибок в API.

Следующий запрос — Tab:
Добавить тесты для новых сценариев.

Дополнительная инструкция — Enter:
Не изменять формат существующих ответов API.

Советы по работе с Codex

Чтобы Codex приносил максимальную пользу, важно не только правильно формулировать задачи, но и организовать работу с ИИ-агентом так, чтобы контролировать качество кода, избегать лишних изменений и быстрее получать предсказуемый результат. Следующие советы помогут эффективнее использовать возможности Codex в повседневной разработке.

Формулируйте конкретные задачи

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

Задача: добавь в форму регистрации проверку электронной почты.
Требования:
- Проверь корректность формата адреса.
- Покажи понятное сообщение при ошибке.
- Не изменяй дизайн формы.
- Добавь тесты для корректных и некорректных адресов.
- Перед завершением перечисли изменённые файлы.

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

Предоставляйте контекст проекта

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

Пример AGENTS.md:

- Используй PHP 8.1.
- Сохраняй совместимость с WordPress API.
- Не изменяй публичные имена функций без необходимости.
- Проверяй входные данные перед обработкой.
- После изменений запускай доступные тесты.
- Не добавляй зависимости без согласования.

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

Разбивайте сложные задачи на этапы

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

Этап 1. Изучи проект и предложи план реализации.
Этап 2. Опиши изменения в структуре данных и API.
Этап 3. Реализуй первый компонент.
Этап 4. Добавь тесты и проверь результат.
Этап 5. Перейди к следующему компоненту.

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

Проверяйте изменения перед их принятием

Успешное завершение задачи ещё не означает, что код работает правильно. Codex может допустить логическую ошибку, пропустить граничный случай или изменить поведение компонента, который не упоминался в задании. Поэтому изучайте diff — разницу между исходным и изменённым кодом, запускайте тесты и проверяйте, соответствует ли результат первоначальным требованиям.

«Код, написанный ИИ, необходимо проверять так же внимательно, как код любого другого участника команды. Уверенное объяснение решения не заменяет тестирование и проверку фактического поведения программы».

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

Используйте автоматизацию для повторяющихся операций

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

# Пример запуска задачи из терминала
codex exec "Проанализируй проект и найди функции без тестов"

# Ещё один пример
codex exec "Проверь изменения на потенциальные ошибки"

Эти примеры показывают общий принцип: агенту можно передавать ограниченные задачи, которые удобно выполнять из сценариев и инструментов разработки. Реальные параметры запуска и доступность команд зависят от установленной версии Codex CLI. Перед включением агента в CI/CD проверьте его права, способ авторизации и правила обработки ошибок, чтобы автоматизация не могла бесконтрольно изменять важные данные.

Настройте безопасную среду работы

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

Перед выполнением задачи:

1. Сохрани важные изменения в Git.
2. Проверь, какие файлы будут доступны агенту.
3. Не передавай секреты и токены без необходимости.
4. Ограничь выполнение опасных команд.
5. Изучи diff и запусти тесты перед принятием изменений.

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

Заключение

Codex — это ИИ-агент, который помогает разработчикам писать код, анализировать проекты, исправлять ошибки и автоматизировать рутинные задачи. Он способен ускорить разработку, но качество результата во многом зависит от точности инструкций и предоставленного контекста.

Чтобы эффективно работать с Codex, формулируйте конкретные задачи, разбивайте сложную работу на этапы и обязательно проверяйте изменения. **Сочетание возможностей ИИ с опытом разработчика** позволяет получать более качественный код и тратить меньше времени на рутинные операции.