Написать в Telegram

Codex: как пройти путь от идеи до работающего проекта без знания кода. Пошагово

Содержание
  1. Что получится в итоге
  2. Что понадобится
  3. Шаг 1. Открываем Codex и создаём проект
  4. Шаг 2. Описываем задачу обычными словами
  5. Шаг 3. Проверяем результат
  6. Шаг 4. Вносим правки промтом
  7. Шаг 5. Фиксируем работу через Git
  8. Шаг 6. Запускаем несколько агентов параллельно
  9. Шаг 7. Превращаем проверку в навык
  10. Шаг 8. Передаём задачу в облако
  11. Если вы работаете из России
  12. Что важно знать до старта
  13. Что дальше

У вас есть идея: небольшой внутренний сервис, прототип, страница для отдела. Но писать код некому. Обычный чат с ИИ тут помогает слабо: он выдаёт куски кода, а раскладывать их по файлам, запускать и чинить приходится самому.

Codex устроен иначе. Это ИИ-агент для работы с кодом. Он не просто отвечает, а сам создаёт файлы в папке проекта, меняет их, запускает проверки и показывает, что получилось. Теперь он встроен в десктопное приложение ChatGPT, поэтому начать можно без командной строки: достаточно описать задачу обычными словами.

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

Что получится в итоге

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

  • Проект. Папка, с которой работает агент.
  • Правки обычными словами. Попросили, проверили, уточнили.
  • Git. Контрольные точки, к которым можно вернуться.
  • Параллельные агенты. Несколько улучшений одновременно, без путаницы в основном проекте.
  • Навыки. Повторяемая инструкция, например для проверки.
  • Облако. Задача выполняется на удалённой машине, а компьютер остаётся свободным.

Что понадобится

  • Компьютер. Десктопное приложение ChatGPT есть для Windows и Mac.
  • Аккаунт ChatGPT. В приложение нужно войти, Codex открывается из него.
  • Пустая папка. Заранее создайте на компьютере папку для проекта.
  • Бесплатный аккаунт на GitHub. Он понадобится только на последнем шаге, для облака.

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

Шаг 1. Открываем Codex и создаём проект

Установите приложение ChatGPT, войдите в аккаунт и в левом верхнем углу выберите Codex. Откроется отдельное окно, это не обычный чат. Здесь агент работает с файлами и запускает команды. Использовать Codex можно и из браузера, из командной строки и из редактора кода, но для начала удобнее приложение.

Главный экран Codex: слева проекты и новый чат, в центре вопрос «What should we build?»
Главный экран Codex: слева проекты и новый чат, в центре вопрос «What should we build?»

Проект в Codex это обычная папка на компьютере, в которой агент хранит и меняет файлы. Чтобы создать его, откройте боковую панель, рядом с разделом Projects нажмите плюс. В окне Create project дайте имя, в примере это Cookie Shop Tycoon. Затем в блоке Source folders нажмите Add и выберите заранее созданную пустую папку.

Окно создания проекта: поле для имени и блок Source folders с кнопкой Add
Окно создания проекта: поле для имени и блок Source folders с кнопкой Add

Нажмите Create project. Codex спросит, доверяете ли вы папке, и нужно нажать Trust folder. Агент получит право создавать и менять в ней файлы, так что выбирайте папку, где нет ничего важного.

Шаг 2. Описываем задачу обычными словами

Теперь опишите, что нужно получить. Лучше сразу назвать правила и ограничения. Вот промт из примера на русском:

Построй браузерную игру Cookie Shop Tycoon. Игрок начинает со 100 долларами и управляет кондитерской 30 дней. Каждый день он решает, сколько печенья испечь, по какой цене продавать и сколько потратить на рекламу. В конце дня показывай, сколько продано печенья, выручку, расходы, прибыль и остаток денег. Дизайн простой и аккуратный. Игра должна легко запускаться локально в браузере.

Поле ввода с промтом: проект Cookie Shop Tycoon выбран, режим This computer, рядом переключатель Worktree
Поле ввода с промтом: проект Cookie Shop Tycoon выбран, режим This computer, рядом переключатель Worktree

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

В примере сборка заняла 3 минуты 10 секунд. В конце агент показывает сводку: что создал и сколько строк добавил. В примере это четыре файла: README.md, game.js, index.html и ещё один. Любой файл можно открыть и посмотреть, но для проверки игры читать код не обязательно.

Итог работы агента: ссылка на index.html и список из четырёх созданных файлов
Итог работы агента: ссылка на index.html и список из четырёх созданных файлов

Шаг 3. Проверяем результат

Нажмите на файл index.html в ответе агента. Справа откроется встроенный браузер с игрой. Для удобства можно развернуть окно на весь экран: в примере для этого используется сочетание Ctrl + Shift + F, и тем же сочетанием полноэкранный режим выключается.

В примере игра запустилась сразу: 100 долларов на старте, день 1 из 30, поля для количества печенья, цены и рекламы. На первый день поставили 80 печений по 2 доллара и 15 долларов на рекламу. Итог дня: прибыль 100 долларов, то есть стартовые деньги удвоились. Внизу появился журнал магазина.

Из пустой папки получилась рабочая игра, и для этого понадобился один промт.

Шаг 4. Вносим правки промтом

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

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

Агент сам нашёл нужные файлы и внёс правки. На это ушло 1 минута 49 секунд. В ответе виден список изменённых файлов: game.js (47 строк добавлено, 3 убрано), index.html и README.md. Агент также написал, что проверил суммы покупок, сброс при перезапуске и режим уменьшенной анимации, но визуально проверить не смог: встроенный браузер не открывает локальные файлы.

Промт с просьбой добавить покупателей, итог правки: три изменённых файла и счётчик добавленных и удалённых строк
Промт с просьбой добавить покупателей, итог правки: три изменённых файла и счётчик добавленных и удалённых строк

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

Так и строится работа в Codex: сказали, что хотите, проверили, дали обратную связь, получили новую версию. Проект растёт шагами.

Шаг 5. Фиксируем работу через Git

Git хранит историю изменений проекта. В Codex он встроен, и разбираться в командах не нужно. Нажмите View changes: откроется панель Changes. По умолчанию выбран режим Last turn, то есть изменения только последнего ответа агента. В меню рядом можно выбрать другие способы просмотра.

Нажмите на файл, и откроется diff: зелёным подсвечено добавленное, красным удалённое. Так видно, что именно поменял агент.

Панель Changes: список файлов и diff, зелёным добавленные строки, красным удалённые
Панель Changes: список файлов и diff, зелёным добавленные строки, красным удалённые

Когда версия вас устраивает, создайте коммит. Это контрольная точка, к которой можно вернуться, если дальше что-то сломается. Команды вводить не надо, попросите агента:

Сделай коммит текущих изменений с сообщением «Add animated customers».

Codex инициализировал Git в папке, создал коммит и сообщил, что рабочее дерево чистое, то есть все изменения сохранены. Занимает это около 30 секунд. Коммиты стоит делать после каждой удачной версии, это страховка.

Шаг 6. Запускаем несколько агентов параллельно

До сих пор работал один агент и одна задача. Codex умеет раздавать работу нескольким агентам одновременно. В примере поставили три улучшения сразу:

Хочу улучшить игру тремя функциями. Передай каждую отдельному агенту, который работает в своём изолированном рабочем дереве, чтобы они шли параллельно. 1. Добавь несколько сортов печенья с разной себестоимостью и ценой продажи. 2. Добавь систему улучшений магазина: лучшая печь, больший магазин, улучшенная реклама. 3. Улучши визуал и анимации по всей игре, не меняя игровой процесс. Пусть все три агента работают параллельно. Пока не вливай их изменения в основной проект.

Агент сделал коммит, ниже набран промт на три параллельных улучшения
Агент сделал коммит, ниже набран промт на три параллельных улучшения

Ключевое здесь изолированное рабочее дерево (work tree). Это отдельная копия проекта, поэтому три агента не мешают друг другу и основной версии. В примере все трое справились за 4 минуты 59 секунд. Каждый сделал свою ветку и свой коммит: codex/cookie-varieties, codex/shop-upgrades и codex/visual-polish. В основной проект ничего не попало.

Таблица результатов: три функции, три ветки, три коммита и ссылки для просмотра каждой версии
Таблица результатов: три функции, три ветки, три коммита и ссылки для просмотра каждой версии

Внизу ответа есть ссылки на каждую версию, и можно открыть и сравнить их. В примере один агент добавил выбор сорта печенья, второй раздел с улучшениями магазина (лучшая печь снижает себестоимость печенья с 0,5 до 0,4 доллара, больший магазин даёт на 25% больше покупателей, реклама эффективнее), третий поправил оформление.

Что оставить, решаете вы. В примере вернули в основной проект только сорта печенья:

Верни функцию сортов печенья из её рабочего дерева в основной проект. Остальные два агента пока оставь отдельно. Протестируй игру, чтобы убедиться, что всё работает, и если тесты пройдут, сделай коммит с сообщением «Add cookie varieties».

Агент справился за 1 минуту 12 секунд, проверил все четыре сорта, расчёты, анимации и 30-дневный сезон, и сделал коммит. Две другие ветки остались отдельно, их можно влить тем же способом.

Шаг 7. Превращаем проверку в навык

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

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

Создание заняло 1 минуту 8 секунд. Навык лежит в виде файла SKILL.md: в начале имя и описание, дальше раздел с границами. Там прописано, например, не править исходники и не чинить ошибки без разрешения, а если браузерная проверка недоступна, пометить её как непроверенную.

Файл навыка game-tester: имя, описание и границы, внутри которых проверка ничего не меняет
Файл навыка game-tester: имя, описание и границы, внутри которых проверка ничего не меняет

Запуск простой:

Используй навык Game Tester, чтобы проверить Cookie Shop Tycoon.

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

Шаг 8. Передаём задачу в облако

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

Для первого раза нужна настройка:

  • Подключите GitHub. Создайте бесплатный аккаунт на GitHub. В приложении ChatGPT наведите на меню Customize, откройте Plugins, найдите GitHub, установите и подключите аккаунт.
  • Отправьте проект на GitHub. Это онлайн-хранилище файлов, без него облако не увидит проект. Не нужно делать ничего вручную, попросите агента: «Создай новый репозиторий GitHub Cookie Shop Tycoon и отправь в него основной проект». Codex сначала остановился и спросил, какой должна быть видимость репозитория. В примере ответили private, то есть закрытый.
  • Создайте облачную среду. Откройте новый чат, переключите режим с компьютера на cloud, нажмите choose environment и создайте новую среду. Codex видит репозитории подключённого аккаунта: выберите нужный и нажмите get started. Он сам изучит проект и настроит среду. Затем нажмите save and publish.

Теперь ставим задачу: добавить в игру систему удовлетворённости покупателей. Она работает удалённо, и держать Codex открытым не нужно.

В итоге в игре появился показатель Customer satisfaction, в примере 75 из 100, с пояснением: честные цены и полные лотки радуют покупателей. Сначала при открытии файла была видна только голая страница, и агента попросили это исправить. Он объяснил, что предпросмотр не подгружал отдельные файлы стилей и скрипта, и встроил их прямо в index.html, после чего всё заработало.

Результат облачной задачи: на странице игры появился показатель Customer satisfaction 75 из 100
Результат облачной задачи: на странице игры появился показатель Customer satisfaction 75 из 100

Рабочий порядок получается такой: работаем локально, отправляем проект на GitHub, тяжёлые или долгие задачи отдаём в облако.

Если вы работаете из России

Приложение ChatGPT и аккаунт, через которые открывается Codex, напрямую из России недоступны. Поэтому весь описанный путь повторить получится не у каждого, и это нужно знать до старта.

Идею при этом можно перенести на другие инструменты:

  • Открытая версия Codex. По документации, у Codex в командной строке открытый код, и его можно настроить на других поставщиков моделей, в том числе на локальную модель через Ollama. Проверьте актуальные настройки в документации до внедрения.
  • Открытые модели на своём сервере. Модели для кода с открытыми весами можно запустить на собственном оборудовании. Данные не уходят наружу, а работа не зависит от доступа к зарубежным сервисам.
  • Российские модели. Для небольших задач вроде скриптов, шаблонов и простых страниц могут подойти российские языковые модели. Сначала проверьте их на своей задаче.
  • Сами приёмы. Проект как папка, правки по шагам, коммиты как страховка, параллельные ветки, навыки как инструкции работают с любым агентом для кода.

Что важно знать до старта

  • Доверие к папке. Codex получает право менять файлы. Не выбирайте папку с важными данными и держите отдельную под проект.
  • Результат нужно проверять. Агент сообщает, что проверил, но не всё может проверить сам. В примере он прямо написал, что визуальную проверку выполнить не смог, и игру пришлось смотреть самим.
  • Не всё получается с первого раза. Результат облачной задачи сначала открылся без оформления, понадобилась правка. Закладывайте время на уточнения.
  • Коммиты как страховка. Делайте их после каждой удачной версии, иначе откатиться будет некуда.
  • Что уходит в GitHub. Проект попадает во внешний сервис. Не отправляйте туда коммерческие тайны и персональные данные, а репозиторий делайте закрытым.
  • Навык не заменяет проверку человеком. В примере встроенный валидатор навыка не запустился из-за отсутствующей зависимости, и агент проверил структуру вручную.
  • Параллельные агенты требуют разбора. Три готовые версии нужно посмотреть и решить, что оставить. Ничего не вливайте в основной проект, пока не проверили.

Что дальше

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

Мы в Агентехе учим сотрудников ставить задачи ИИ-агентам для кода, проверять их результат, вести версии и оформлять повторяющиеся проверки в навыки. Как устроено обучение.

Написать в Telegram