Первый запуск Codex: от пустого терминала до готового результата

Codex уже установлен, а вы всё ещё смотрите на пустой терминал и не понимаете, с чего начать? Этот гайд проведёт от команды codex до первого готового результата примерно за 15 минут. Без установки (её мы вынесли в отдельный шаг) — только первый запуск, первая задача на живом примере и главный механизм контроля, который убережёт от сюрпризов.

Что вы получите за 15 минут

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

Что нужно иметь на руках заранее:

• Установленный Codex CLI. Проверить установку — командой ниже; если её ещё нет, сначала поставьте CLI, а потом возвращайтесь сюда.
• Доступ к Codex. Он входит в планы ChatGPT Plus, Pro, Business, Edu и Enterprise (данные на 16 июля 2026). Альтернатива — вход по API-ключу, но часть функций при этом может быть недоступна.
• Любая папка с проектом — хоть код, хоть заметки. Codex одинаково работает и с репозиторием, и с обычными текстовыми файлами.
• 10–15 минут и желание не бояться чёрного окна терминала.

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

Шаг 1. Откройте проект в терминале и проверьте Codex

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

Google выпустила Gemini 3.6 Flash — агенты стали экономичнее по токенам

Лимиты Codex: одно окно на локаль и облако — и как его растянуть

Два входа в Codex: аккаунт ChatGPT для работы, API-ключ для скриптов

Codex есть в каждом плане ChatGPT — но по-разному: что выбрать и как оплатить

Codex CLI на Windows, Mac и Linux: ставим без путаницы с Node и WSL

Перейдите в папку проекта. Если вы не дружите с командной строкой, самый простой способ на macOS — открыть папку в Finder, кликнуть по ней правой кнопкой и выбрать в разделе «Службы» пункт «Новый терминал в папке». На Windows и Linux аналогичный пункт есть в контекстном меню файлового менеджера или запускается через cd путь/к/проекту.

Теперь убедитесь, что CLI на месте:

codex --version

В ответ придёт строка вида codex-cli 0.144.5 (номер версии у вас будет свой — Codex обновляется регулярно, важно лишь, что версия вообще напечаталась). Если так и есть, всё в порядке. Если терминал ругается «command not found», значит CLI не установлен или не добавлен в PATH (PATH — список папок, где система ищет команды по имени) — вернитесь к установке.

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

Шаг 2. Запустите codex и войдите

Из папки проекта запустите агента одной командой:

codex

При первом запуске Codex попросит войти. Есть два пути: аккаунт ChatGPT (подойдёт большинству — просто откроется браузер с подтверждением) или API-ключ OpenAI. Если предпочитаете явную команду входа, используйте:

codex login

После авторизации откроется интерактивный экран агента (TUI — текстовый интерфейс прямо в терминале). По умолчанию Codex сам выбирает рекомендованную модель со средним уровнем рассуждений — какое именно имя (линейка gpt-5.x), увидите командой /model. Это самое быстро устаревающее место в интерфейсе, поэтому конкретное имя модели здесь не фиксируем: на первую задачу дефолт трогать не нужно.

Шаг 3. Выберите режим одобрения

При первом запуске в новой папке Codex спросит, насколько свободно ему действовать. Это и есть режимы одобрения (permission modes) — главный рычаг контроля для новичка. Их три (состав на 16 июля 2026), и разница принципиальная: она определяет, спрашивает ли агент разрешение перед каждой правкой или делает всё сам.

Для быстрого старта совет простой: начните с read-only или оставьте дефолтный workspace-write, но одобряйте изменения вручную. danger-full-access на первом запуске не трогайте — с ним вы теряете тот самый защитный экран, ради которого песочница и придумана. Режим потом меняется в любой момент.

Шаг 4. Дайте первую задачу — безопасную

Лучшая первая задача не меняет ни одного файла, но сразу показывает, на что агент способен. Спросите Codex про сам проект обычным человеческим языком, прямо в поле ввода:

Что находится в этой папке? Объясни структуру проекта в двух абзацах.

Нажмите Enter — и наблюдайте. Codex начнёт исследовать папку: вы увидите, как он сам запускает служебные команды вроде ls (список файлов), читает ключевые файлы и шаг за шагом собирает картину. Через несколько секунд он выдаст связное описание: что за проект, из чего состоит, какие директории за что отвечают.

Это и есть первый «вау-момент»: вы не открывали ни одного файла, а уже получили карту проекта. Заодно вы увидели, как агент думает — Codex показывает ход рассуждений и команды, которые запускает. Эта прозрачность важна: вы всегда видите, что именно происходит, а не получаете ответ из чёрного ящика.

Что писать, а что не стоит

Формулируйте задачу как коллеге: конкретно и по делу. «Объясни, что делает файл main.py» или «Найди, где в проекте задаётся порт сервера» — отличные первые запросы: у них понятный результат, который легко проверить. Хорошая первая задача узкая и проверяемая — вы сразу видите, справился агент или нет.

Чего не стоит делать на старте — грузить Codex расплывчатым «улучши мой проект» или «перепиши всё красиво». Такие задачи без критериев готовности превращаются в лотерею: агент что-то сделает, но не обязательно то, что вы имели в виду. Глубокий метод постановки больших задач — как декомпозировать работу, что класть в контекст, как вести агента через сложную фичу и проверять результат — тема отдельного разбора. На первом запуске сознательно держитесь мелких точечных вопросов: так вы быстрее нащупаете, как агент «слышит» формулировки, и не потратите лимиты впустую.

Шаг 5. Вторая задача: план, дифф и одобрение

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

Добавь короткий README.md с описанием проекта и командой запуска.

Дальше разворачивается базовый цикл агентной работы:

1. План. Codex сначала описывает, что собирается сделать: какой файл создать или изменить и почему. Вы видите намерение до того, как что-то произойдёт.
2. Дифф. Перед записью на диск агент показывает изменения в виде диффа — построчно, что добавится и что удалится. Это ваш момент проверки.
3. Одобрение. Codex ждёт вашего решения: одобрить изменение или отклонить. Пока вы не согласились, файл на диске не меняется. Именно поэтому режим одобрения — не формальность, а реальная страховка.
4. Результат. После одобрения агент применяет правку, при необходимости запускает команды (например, тесты) и отчитывается, что готово.

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

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

Полезные команды первой сессии

Внутри сессии Codex понимает служебные слэш-команды — нажмите /, и появится их список. Вот те, что пригодятся сразу (перечень актуален на 16 июля 2026):

• /model — сменить модель или уровень рассуждений.
• /status — показать конфигурацию сессии и расход токенов (полезно, чтобы следить за лимитами).
• /init — создать файл AGENTS.md — постоянную инструкцию для агента по этому проекту.
• /new — начать новый разговор с чистым контекстом.
• /compact — сжать историю, когда диалог стал длинным.
• /quit — завершить сессию.

Ещё две мелочи, которые экономят время. Любую команду терминала можно выполнить прямо из сессии, поставив перед ней ! — например, !git status или !ls. Вывод останется в истории, и Codex будет его «видеть», так что не придётся переключаться между окнами. А если вы вышли из агента (Ctrl+C) и поняли, что не закончили, — Codex при выходе показывает ID сессии. Вернуться к ней можно командой codex resume <ID>, а к самой последней — codex resume --last. Логи сессий хранятся локально в папке ~/.codex/sessions/.

Где ещё живёт Codex

Codex — это не только терминал. Один и тот же агент доступен на нескольких «поверхностях»: в приложении и веб-версии ChatGPT (десктоп и браузер), расширением для редактора (VS Code), в облаке (Codex Cloud, где задача выполняется на серверах и возвращает готовый pull request) и через API. Для быстрого старта в терминале нужен именно Codex CLI — с него мы и начали. Остальные поверхности удобно осваивать потом, когда цикл «задача — дифф — результат» уже в руках.

Полезное свойство: сессии CLI и IDE-расширения — это одни и те же файлы. Начали разговор в терминале, а дальше удобнее в редакторе — открываете ту же сессию в VS Code и продолжаете с сохранённым контекстом. Так первый запуск в терминале не запирает вас в нём навсегда.

Если Codex вам зашёл, присмотритесь и к соседним инструментам экосистемы OpenAI — например, к агенту ChatGPT Work, который решает похожие задачи, но не в коде, а в документах и таблицах.

Типичные ошибки первого запуска

Большинство спотыканий новичка — из-за мелочей окружения, а не самого агента. Вот что чаще всего идёт не так и как это чинится.

Безопасность, риски и лимиты

Логичный вопрос новичка: не опасно ли пускать агента к своим файлам? Ответ — риск управляемый, и управляете им вы. Локально Codex работает в песочнице, которую операционная система (macOS, Linux, Windows, WSL) реально ограничивает на своём уровне — это не «просьба к модели не трогать лишнее», а техническое ограничение доступа. Плюс к этому режим одобрения и обязательный показ диффа: пока вы не согласились, ничего не записывается на диск.

Теперь о слабых местах. Первый риск — ошибочная правка: агент может неверно понять задачу и предложить не то. Лекарство простое и уже встроено: на старте держите read-only или внимательно читайте каждый дифф перед одобрением. Режим danger-full-access эту защиту снимает целиком, поэтому на первой задаче он не нужен — включать его стоит только осознанно и в изолированном окружении.

Второй риск — лимиты плана. Codex расходует квоту (usage) вашей подписки ChatGPT, и объёмная задача может упереться в потолок в самый неподходящий момент. Держите большие задачи разбитыми на части и поглядывайте на расход через /status. Третий момент — не риск, а честное ожидание: качество ответа зависит от формулировки и уровня рассуждений. Размытый запрос даёт размытый результат, и это лечится не мощностью модели, а точностью задачи.

Наконец, про свежесть. Первым устареет всё волатильное — состав тарифов, имя модели по умолчанию (линейка gpt-5.x обновляется чаще всего) и номер версии CLI. Команды и логика режимов меняются медленнее, но и их стоит сверять: за источником истины идите в официальную документацию Codex — ссылки собраны в блоке источников.

FAQ

Нужно ли уметь программировать, чтобы запустить первую задачу?

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

Обязательна ли платная подписка ChatGPT?

Практически да. Codex входит в планы ChatGPT Plus, Pro, Business, Edu и Enterprise (на 16 июля 2026). Альтернатива — вход по API-ключу OpenAI, но тогда часть возможностей может быть недоступна, а оплата идёт по факту использования. Для знакомства проще всего использовать уже имеющуюся подписку ChatGPT.

Codex сам всё поменяет в моём проекте без спроса?

Зависит от режима одобрения. В read-only он вообще ничего не меняет без явного разрешения. В дефолтном workspace-write он правит файлы внутри папки проекта, но перед записью показывает дифф. Полную свободу даёт только danger-full-access, который на первой задаче включать не стоит.

Что делать, если я случайно закрыл терминал посреди задачи?

Ничего страшного: Codex сохраняет сессии локально. При выходе он показывает ID сессии — верните её командой codex resume <ID>. Если ID не записали, к последней сессии можно вернуться через codex resume --last. Весь контекст разговора восстановится, как будто вы и не выходили.

Чем Codex CLI отличается от облачного Codex?

CLI работает на вашей машине с вашими файлами прямо сейчас — вы видите каждый шаг в терминале. Облачный Codex (в приложении ChatGPT) выполняет задачу на серверах OpenAI в изолированной среде с ограниченной сетью и возвращает готовый pull request, не трогая ваше рабочее дерево напрямую. Облако удобно для долгих автономных задач, а CLI — для первого знакомства и быстрой обратной связи, когда важно видеть каждый шаг вживую.