Как создать первый рабочий проект в Codex без опыта программирования

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

Допустим, вам нужен список задач для себя. Вы хотите записать дело, отметить его выполненным и завтра увидеть тот же список. Это подходящий первый проект: результат можно проверить несколькими действиями. Общая просьба «сделай систему управления компанией» оставляет слишком много решений на усмотрение агента.

Короткий ответ: выберите один сценарий, откройте для него отдельную папку, попросите Codex объяснить план и только затем разрешите изменения. Запустите результат по инструкции, проверьте основной сценарий и ошибочный ввод. Сохраните рабочую версию перед следующей доработкой. Знание языка программирования для такого старта не обязательно, но проверять результат и принимать решения всё равно придётся вам.

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

Если CLI ещё не установлен, сначала пройдите официальную настройку. Команды ниже рассчитаны на терминал macOS или Linux. В Windows используйте подходящую инструкцию OpenAI для вашей среды, а не переносите команды вслепую.

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

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

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

Запишите критерии до реализации:

1. После добавления «Позвонить поставщику» запись появляется один раз.
2. Пустая строка не создаёт задачу, интерфейс объясняет причину.
3. Отметка выполнения видна и сохраняется после перезагрузки.
4. Удалённая задача не появляется снова после перезагрузки.
5. Страница остаётся удобной на узком экране.

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

Откройте терминал там, где храните учебные проекты. Выполните:

mkdir codex-first-project
cd codex-first-project

Если папка с таким именем уже существует, выберите новое имя. Не удаляйте существующие файлы ради повторения инструкции. Затем проверьте CLI:

codex --version
codex --help

Первая команда должна вывести установленную версию, вторая — справку. Эти команды проверены в среде подготовки статьи; это не проверка входа в ваш аккаунт или доступности модели. Если терминал сообщает, что команда не найдена, вернитесь к установке и проверьте путь к исполняемому файлу.

Запустите интерактивную сессию командой `codex`. Это документированный шаг; интерактивный вход и создание проекта через модель в ходе подготовки статьи не выполнялись. Пройдите вход по официальной инструкции. Не отправляйте пароль или ключ в переписку с помощником.

Передайте Codex следующий запрос. Это текст задания, а не команда терминала:

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

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

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

У разных проектов будут разные команды запуска. Не угадывайте их и не копируйте случайный `npm run dev`, пока README не объясняет, что требуется. Если агент выбрал инструмент, которого нет на компьютере, сначала уточните способ установки и его необходимость.

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

Откройте адрес из инструкции или файл, если проект рассчитан на такой способ запуска. Добавьте задачу, отметьте её, перезагрузите страницу. Затем попробуйте пустую строку, длинное название и удаление. Если автоматический тест проходит, а задача исчезает при обновлении, основной сценарий всё ещё не принят.

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

Опишите последовательность действий и разницу между ожиданием и результатом. Например:

Добавил задачу «Позвонить поставщику», отметил её выполненной и обновил страницу. Задача осталась, но отметка исчезла. Нужно сохранить состояние выполнения. Исправь только эту ошибку и добавь проверку, которая воспроизводит её.

После исправления повторите именно этот сценарий, а затем проверьте добавление и удаление. Изменение одной функции может затронуть другую. Если Codex предлагает переписать весь проект, попросите сначала объяснить, почему локального исправления недостаточно.

Официальный quickstart рекомендует контрольные точки Git. Для новичка смысл простой: перед следующей доработкой должна остаться версия, к которой можно вернуться. Попросите Codex объяснить предлагаемые изменения и показать список файлов перед сохранением.

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

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

Учебная версия готова, когда вы сами прошли основной сценарий, проверили ошибочный ввод, подтвердили сохранение данных и смогли повторно запустить проект по README. Это локальная готовность. Безопасность публичного сервиса, резервное копирование, работа с реальными пользователями и поддержка требуют отдельной проверки.

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

Нужен ли GitHub перед первым запуском?

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

Можно ли просто доверить Codex всю проверку?

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

Что делать, если в инструкции непонятная команда?

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

Сохраните критерии приёмки рядом с проектом и повторите их после следующего изменения. Если хотите выбрать дальнейшую тему, откройте базу статей «Человек 2.0». Это подборка материалов, а не обещание готового проекта или персональной проверки.

1. Codex CLI: работа в выбранной папке, запуск и вход.

• Codex Quickstart: локальный и облачный сценарии, контрольные точки Git.
• Разрешения и безопасность агента: модель разрешений и ограничения среды.

Документация проверена 18 сентября 2026 года. Технические шаги следует пересмотреть через 30 дней. Пример списка задач является учебным заданием; статья не утверждает, что Codex уже создал и проверил такое приложение в рамках этого материала.