Руководство Codex

Тема

Облачный Codex и GitHub ​

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

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

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

Если слова «репозиторий» и «ветка» пока незнакомы, сначала прочитайте простое введение в Git.

Как запустить первую небольшую задачу ​

  1. Войдите в ChatGPT через аккаунт, которому доступен Codex.
  2. Подключите GitHub — сервис, где хранится удалённая копия проекта.
  3. Разрешите доступ только к нужному репозиторию.
  4. Создайте облачную среду для этого репозитория.
  5. Запустите безопасную задачу без изменения файлов: «Прочитай проект и объясни, как его проверить. Ничего не меняй».
  6. Сравните ответ с файлами проекта.

Такой первый опыт помогает понять границы облака до того, как вы доверите ему изменения.

Что происходит после запуска ​

  1. Сервис копирует выбранную версию Git-проекта во временную среду.
  2. Подготавливает программы и зависимости, необходимые проекту.
  3. Применяет заданные правила доступа к интернету.
  4. Codex читает инструкции, работает с файлами и запускает проверки.
  5. ChatGPT сохраняет итог и сравнение изменённых строк.
  6. Вы просматриваете результат и решаете, принять его или отклонить.

Локальные файлы не копируются сами

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

Управление из терминала ​

В некоторых версиях Codex доступны экспериментальные облачные команды:

bash
codex cloud list
codex cloud exec "Исправь падающий тест и верни небольшое изменение"
codex cloud status <TASK_ID>
codex cloud diff <TASK_ID>
codex cloud apply <TASK_ID>

Здесь <TASK_ID> — номер задачи. Команды означают: показать список, запустить задачу, узнать состояние, посмотреть изменения и применить их локально. Экспериментальные команды могут меняться, поэтому сначала откройте справку:

bash
codex cloud --help
codex cloud exec --help

Для применения результата по известному номеру также используется:

bash
codex apply <TASK_ID>

Правила безопасности ​

  • Давайте GitHub доступ только к нужным проектам.
  • Храните секреты в специальных настройках среды, а не в запросе и не в Git.
  • Не открывайте весь интернет без причины.
  • Не разрешайте подготовительной команде публиковать сайт или менять реальные данные.
  • Запишите команды сборки и проверки в AGENTS.md.
  • Просмотрите изменения и результаты тестов до принятия работы.
  • Публикацию настоящего сайта оставьте отдельным шагом с подтверждением человека.

Проверка кода и задачи по расписанию ​

После подключения GitHub Codex может проверить запрос на объединение изменений. Как устроена такая проверка, рассказано на странице «Проверка изменений».

Задачи по расписанию настраиваются в ChatGPT или приложении для компьютера. Перед этим изучите простое руководство по автоматизации: задача без присмотра должна иметь особенно узкие права.

Куда дальше ​

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