Чтобы пользоваться Codex после установки, запустите его в папке проекта, задайте границы доступа и поручите одну небольшую задачу. Затем сравните изменённые файлы и проверьте результат. В этой инструкции первое упражнение - страница со счётчиком нажатий, которую можно открыть прямо в браузере.
План рассчитан примерно на 10 минут ваших действий, когда Codex уже установлен и вход выполнен. Скорость ответа сервиса и время на исправления могут отличаться. Результат упражнения - файл index.html: при открытии счётчик показывает 0, после двух нажатий 2, после перезагрузки снова 0.
Команды и режимы доступа сверены с официальной документацией OpenAI 30.10.2026. Упражнение ниже - учебное задание, которое вы можете повторить в пустой папке.
Как пользоваться Codex, если вы не программист
Codex CLI - агент OpenAI в терминале. Он читает файлы, вносит изменения и запускает доступные ему команды. Вы описываете задачу обычными словами, а после работы проверяете получившийся файл, страницу или программу.
Здесь разбираем CLI: команды со знаком / вводятся в разговор с агентом, команды вроде codex resume - в обычный терминал. Если хотите работать в отдельном окне, начните со статьи про приложение Codex. Для работы в браузере с удалённым окружением есть Codex Cloud. Их интерфейсы отличаются от терминала.
Установка в эту инструкцию не входит. Если команда codex не находится, нужна установка Codex, для Windows - отдельная инструкция. Здесь начинаем с момента, когда агент уже запускается и принимает сообщения.
Что понадобится, чтобы начать
- Отдельная пустая папка
codex-proba. Не используйте для упражнения рабочий сайт или папку со всеми документами. - Установленный Codex CLI с выполненным входом и доступным объёмом работы в аккаунте.
- Git для просмотра изменений через
/diffи обычный браузер для проверки страницы.
Аккаунты GitHub, сервер, библиотеки и платные подключения для учебной страницы не нужны. Счётчик будет работать локально. В нём нет отправки данных и сохранения на сервере.
Если вы открыли существующий проект, сначала сохраните нужные файлы отдельно или сделайте точку возврата в Git. Новый разговор с агентом не создаёт резервную копию проекта. В быстром старте OpenAI тоже советуют сохранять состояние Git до и после задачи.
Если работаете из России. На 30.10.2026 России нет в списке поддерживаемых стран ChatGPT. OpenAI предупреждает, что доступ из неподдерживаемых стран может привести к блокировке или приостановке аккаунта. Права на файлы и новая подписка эту причину не устраняют. Сетевые ошибки разбираем в статье Codex и VPN, а ошибку обмена токена - в token exchange failed.
Шаг 1. Запустить агента в папке проекта
Создайте пустую папку codex-proba и откройте в ней терминал. Важно, чтобы это была именно учебная папка. Если открываете её командой cd, подставьте свой полный путь вместо примера:
cd "/полный/путь/к/codex-proba"
git init
codex --sandbox read-only --ask-for-approval on-requestgit init создаёт локальный репозиторий в выбранной папке. Он ничего не отправляет на GitHub. Если Git не установлен, можно сначала выполнить упражнение без него и проверить файл в браузере; просмотр через /diff потребует репозитория.
В окне Codex отправьте:
Назови полный путь текущей папки и перечисли файлы в ней.
Это учебный проект. Ничего не создавай и не меняй.Ожидаемый ответ - путь к codex-proba и сообщение о пустой папке либо только служебных файлах Git. Если агент описывает другой проект, остановитесь и откройте нужную папку. До исправления пути задачу на запись не отправляйте.
Настройки сессии показывает команда:
/statusПо справочнику OpenAI она выводит модель, политику одобрений, доступные для записи каталоги и использование контекста. Попросить агента назвать текущий путь полезно отдельно: название папки в его ответе должно совпасть с той, которую вы подготовили.
Готово, когда агент работает в codex-proba, а учебных файлов пока не создал.
Шаг 2. Решить, что агенту разрешено
Для знакомства мы явно выбрали режим read-only: агент может изучать доступные файлы и запускать команды в пределах этого режима. Создавать страницу пока нельзя. Текст «ничего не меняй» в сообщении дополняет техническое ограничение.
Чтобы разрешить создание файла, введите:
/permissionsВыберите Auto, затем снова проверьте /status. Для этого упражнения нужны workspace-write и on-request. Именованные профили или ограничения организации могут изменить доступные варианты - ориентируйтесь на фактический вывод вашей сессии.
| Настройка | На какой вопрос отвечает | Что важно в первом упражнении |
|---|---|---|
Песочница read-only |
Какие действия технически разрешены | Можно изучать файлы; запись ограничена |
Песочница workspace-write |
Где разрешена запись и какие команды можно выполнить | Можно создать index.html в рабочей папке |
Политика on-request |
Когда запрашивать разрешение на действие | Для выхода за действующие ограничения может понадобиться подтверждение |
Политика never |
Будут ли запросы разрешения | Запросов нет, ограничения песочницы сохраняются |
В Auto Codex может править файлы в рабочей папке без вопроса перед каждой записью. Просьба «сначала покажи план» помогает согласовать работу, но не превращает этот режим в обязательное подтверждение каждой правки.
По документации OpenAI о доступах, в стандартном workspace-write сеть для команд выключена, пока её не включили в настройках. Это ограничение команд; встроенный веб-поиск и MCP имеют свои настройки. Нашей учебной странице сеть не нужна.
В стандартной политике workspace-write каталоги .git, .agents, .codex и .aws доступны агенту только для чтения. Это описание конкретной политики. Из него не следует, что запись в эти каталоги запрещена при любых настройках Codex.
Для первого задания достаточно Auto в учебной папке. Если позже понадобится соседняя папка, документация предлагает добавлять конкретный путь через --add-dir. Расширять доступ ко всему компьютеру ради одного файла не требуется.
Готово, когда вы проверили права на запись и понимаете, что агент сможет создать файл без дополнительного вопроса.
Шаг 3. Поставить одну задачу с понятным результатом
Скопируйте в разговор:
Создай только файл index.html в этой учебной папке.
В нём должны быть заголовок «Мой первый проект», счётчик и кнопка
«Добавить 1». Начальное значение счётчика - 0. Каждое нажатие
увеличивает его на 1. После перезагрузки страницы снова 0.
Весь HTML, CSS и JavaScript положи в один файл. Без библиотек,
установки пакетов, сетевых запросов и сохранения данных.
Другие файлы не меняй, коммиты и публикацию не делай.
После работы назови созданный файл, объясни, как его открыть,
и перечисли проверки: что выполнил сам, что осталось проверить мне.
Если для задачи не хватает доступа, объясни, какого именно.Здесь заранее задан результат, место сохранения и способ проверки. У агента меньше причин создавать сложный проект, ставить зависимости или подключать сервер. Для первой работы достаточно одного файла.
Во время выполнения Codex показывает ход работы и команды. Если появляется запрос на установку пакетов или внешний доступ, прочитайте его: в нашем задании таких действий нет. Можно отклонить запрос и уточнить в разговоре: «Сделай одним локальным HTML-файлом, как указано в задании».
Если после ответа вместо файла получился только пример кода в чате, уточните:
Нужен сохранённый index.html в текущей учебной папке.
Проверь, что файл существует, и назови его полный путь.
Если создать его не удалось, напиши причину.Для задачи в готовом проекте структура запроса такая же: назовите файл, желаемое изменение и проверку. Например: «В index.html кнопка «Показать описание» ничего не делает. Исправь только её обработчик. После нажатия должен появляться уже существующий текст описания».
Чтобы сослаться на файл, можно набрать @ и выбрать его в поиске рабочей папки. Когда путь известен, его также можно написать прямо в сообщении. Если хотите разобраться с формулировкой подробнее, рядом есть разбор промпта.
Готово, когда в папке появился index.html, а агент перечислил выполненные и оставшиеся проверки.
Я сам плачу за ChatGPT и Codex картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF
Шаг 4. Посмотреть правки и проверить страницу
Сначала введите в Codex:
/diffКоманда показывает изменения Git, включая новые файлы. В учебном примере ожидается один index.html. Если изменилось что-то ещё, спросите, зачем это понадобилось, и разберите ответ до продолжения работы.
Теперь откройте index.html из учебной папки в браузере. Локальная страница со встроенным JavaScript должна работать без размещения на сайте.
| Что сделать | Что должно получиться | Что проверяет этот шаг |
|---|---|---|
| Открыть файл | Заголовок «Мой первый проект», счётчик 0 и кнопка «Добавить 1» | Нужный файл создан и открывается |
| Нажать кнопку дважды | Счётчик показывает 2 | Кнопка действительно выполняет действие |
| Перезагрузить страницу | Снова 0 | Значение не сохраняется между загрузками, как и было задано |
Если кнопка не работает, сообщите точное наблюдение:
Открыл index.html. Счётчик показывает 0, но после двух нажатий
на «Добавить 1» число не меняется. Исправь только эту ошибку.
Объясни причину и покажи, как проверил обработчик кнопки.После исправления повторите те же действия. Фраза «починил» и отсутствие ошибок в ответе агента ещё не подтверждают работу кнопки. Если агент проверил только синтаксис JavaScript, так и должно быть написано в отчёте. Поведение в браузере проверяется отдельно.
Для дополнительного разбора изменений есть /review. По документации команды она ищет проблемы в рабочем дереве. Такой разбор полезен, но запуск страницы он не заменяет.
Если результат нужно вернуть назад
Перед правками существующего проекта сохраните копию файлов или состояние Git. Тогда можно сравнить результат и вернуть конкретный файл к выбранной версии.
Не выполняйте общий откат всей папки, если в ней есть ваши несохранённые изменения. В одном файле могут оказаться и ваши правки, и правки агента. Сначала сравните их, затем восстанавливайте только то, что решили убрать.
Возврат к раннему сообщению или запуск codex resume не следует считать восстановлением файлов на диске. История разговора и состояние проекта проверяются отдельно. В пустой учебной папке можно сохранить получившийся вариант и повторить задачу в другой папке, не рискуя рабочим проектом.
Готово, когда вы проверили страницу по трём условиям, просмотрели список файлов и сохранили нужный результат.
Шаг 5. Выйти и вернуться к разговору
Назовите разговор через /rename, например «Учебный счётчик». Затем выйдите:
/exitВ следующий раз откройте терминал в той же папке и выполните:
codex resume --lastЕсли нужно выбрать другую сессию, используйте codex resume без флага. codex resume --all расширяет поиск за пределы текущей папки, а /resume открывает выбор внутри уже запущенного Codex. Эти варианты описаны в справочнике CLI.
После возврата попросите агента проверить текущий файл, прежде чем продолжать: за время перерыва его могли изменить вы или другая программа. Старый ответ в разговоре не подтверждает нынешнее содержимое папки.
Готово, когда нужный разговор найден и агент проверил актуальный index.html.
Что делать, если пользоваться Codex пока не получается
| Что вы наблюдаете | Что проверить первым | Следующее действие |
|---|---|---|
| Агент описывает чужие файлы | Полный путь рабочей папки | Выйти и запустить Codex в нужной папке |
| Агент объясняет задачу, но не создаёт файл | /status и режим Read Only |
Для записи выбрать Auto через /permissions |
| Запись запрещена даже в Auto | Фактические права и путь назначения | Попросить назвать конкретное ограничение; проверить, находится ли файл в рабочей папке |
| Запрашивается доступ в сеть | Какую команду агент собирается выполнить | В учебном задании вернуть его к одному HTML-файлу без пакетов и сети |
| Файл создан, кнопка не работает | Повторяемые действия и результат | Передать точное наблюдение и повторить проверку после исправления |
| Разговор не находится | Папку запуска и список сессий | Открыть codex resume, при необходимости добавить --all |
| Ответы перестали учитывать детали | Остаток контекста и содержание задачи | Сохранить краткое состояние работы, использовать /compact или начать /new |
| Сообщение говорит об исчерпанном лимите | Какой именно лимит закончился | Свериться со статьёй про лимиты Codex |
/compact сокращает историю разговора, /new начинает новый разговор. Они не пополняют лимит аккаунта. Для первого упражнения не нужно менять модель или переписывать настройки. Выбор модели вынесен в отдельный разбор, изменение настроек - в статью Codex config.
Что дальше
Следующей задачей поменяйте подпись кнопки, сохранив поведение счётчика. Снова посмотрите /diff и проверьте страницу в браузере.
Когда начнёте работать со своим проектом, запишите постоянные требования в AGENTS.md. Команда /init создаёт заготовку, которую нужно просмотреть и уточнить. OpenAI описывает, как Codex подхватывает такие инструкции. Укажите границы работы и признак готовности: какие файлы менять, как запускать проверку, что нельзя публиковать без вашего решения.
Повторяющуюся задачу можно оформить в скилл для Codex. Готовые открытые наборы с инструкциями установки лежат в каталоге скиллов. Подключение внешних инструментов разобрано в статье про MCP, а совместная работа с другим агентом - в сравнении Codex и Claude Code.
Если нужен следующий шаг после упражнения, в подписке ClaudeBase есть «Codex Starter: полная настройка проекта», «Superpowers для Codex» и материал «Правила агента: CLAUDE.md и AGENTS.md». Базу можно подключить к агенту через MCP, чтобы он находил материалы под задачу. Подписка оформляется на странице оплаты, доступ к материалам и код подключения находятся в кабинете. Описание базы - на главной странице ClaudeBase.
Источники
Проверено 30.10.2026:
- OpenAI: Codex CLI - запуск в папке проекта и первая задача.
- OpenAI: команды Codex -
/status,/permissions,/diff,/reviewи продолжение разговора. - OpenAI: разрешения и песочница - запись в файлы, сеть и защищённые каталоги.
- OpenAI: инструкции AGENTS.md - постоянные правила проекта.
- OpenAI: поддерживаемые страны ChatGPT - ограничения доступа по странам.