Skip to content

Знакомство с Codex и четырьмя вариантами доступа

📚 Навигация по серии: Это первая, вводная статья из серии «Руководство по Codex для новичков». Никаких предварительных знаний не требуется, мы начнем с того, «что такое Codex на самом деле». В следующей статье 〈02 Краткий обзор ключевых концепций〉 мы раз и навсегда разберемся с терминологией.


Что такое Codex, для чего нужны четыре варианта доступа и чем он отличается от ChatGPT и Claude Code.

Ребята, в этом руководстве мы поговорим о Codex от OpenAI.

Codex — звучит знакомо, правда? Несколько лет назад у OpenAI уже была старая модель с названием Codex. Зайдя на официальный сайт, можно запутаться еще больше: почему тут и десктопное приложение, и командная строка, и расширение для браузера, и еще какая-то облачная веб-версия? Что из этого настоящий «Codex»? Что мне устанавливать?

Честно говоря, именно здесь Codex чаще всего сбивает с толку новичков: это не «одна программа», а один и тот же ИИ-агент для программирования (Agent) в четырех разных обличьях. Если этого не понять, вы надолго застрянете на этапе «что скачивать».

В этой статье мы не будем заниматься установкой и вводом команд (это тема 03 статьи). Она делает только одну вещь: дает вам полное понимание того, «что такое Codex, за что отвечает каждое из четырех обличий и в чем разница по сравнению с ChatGPT и Claude Code», чтобы у вас в голове появилась четкая карта. Имея такую карту, вы сами сможете решить, что устанавливать и чем пользоваться.

Прочитав эту статью, вы получите:

  • Возможность в одном предложении объяснить кому угодно, «что такое Codex», не сбиваясь с толку из-за названия
  • Сравнительную таблицу четырех вариантов доступа (Desktop App / CLI / расширение для IDE / Cloud Web), чтобы понять, с чего вам следует начать
  • Набор критериев для понимания разницы: чем Codex отличается от ChatGPT и от Claude Code, чтобы больше не путать их
  • Простое действие без затрат, позволяющее за 30 секунд проверить, знает ли ваш компьютер о его существовании

Четыре варианта доступа к Codex: Desktop App / CLI / расширение для IDE / Cloud Web, синхронизированные под одним аккаунтом

На этой картинке сразу видна вся суть статьи: Desktop App, интерфейс командной строки (CLI), расширение для IDE и Cloud Web — это четыре обличья Codex. Они выглядят по-разному и находятся в разных местах, но за ними стоит один и тот же аккаунт и один и тот же агент Codex, объединенные в единую систему.


01 Что такое Codex на самом деле

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

Компания OpenAI вам наверняка знакома — именно они создали ChatGPT. Codex — это их инструмент, специально разработанный для сценариев «написания кода». Согласно официальной документации, он выполняет в основном следующие задачи (этот список — его «перечень навыков», пока просто ознакомьтесь с ним, подробно разберем в 02 статье):

  • Написание кода: Вы описываете, что вам нужно, а он генерирует код, следуя существующей структуре и стилю вашего проекта, а не выдает изолированный фрагмент.
  • Изучение незнакомого кода: Передав ему старый проект без документации, попросите сначала «рассказать об архитектуре проекта», это будет быстрее, чем разбираться самому.
  • Анализ кода: Помогает найти потенциальные баги (bug), пропущенные граничные условия, логические ошибки.
  • Отладка и исправление: Скиньте ему ошибку, он отследит её первопричину по коду, локализует и предложит патч.
  • Автоматизация рутины: Рефакторинг, добавление тестов, миграция, настройка окружения и прочая однообразная работа поручается одной фразой.

Здесь есть ключевое различие, на котором новички спотыкаются чаще всего, поэтому выделим его отдельно:

Аналогия: поиск рецепта (ChatGPT) vs вызов личного повара на дом (Codex). Когда вы пишете код с помощью ChatGPT, это похоже на поиск рецепта — он говорит: «В это блюдо нужно добавить соль, сахар, жарить три минуты», но сковороду вам придется держать самому: копировать код, переключаться обратно в редактор, вставлять, исправлять ошибки — всё это ручной труд. С Codex всё иначе, он похож на повара, который пришел прямо на вашу кухню — вы говорите: «Я хочу это блюдо», он сам лезет в холодильник (читает файлы), зажигает плиту (выполняет команды) и подает готовое на стол (меняет код, проходит тесты), вам остается только попробовать и принять работу.

На практике эта разница ощущается как небо и земля.

Приведу пример из собственного опыта. В марте этого года я решил вернуться к небольшому парсеру на Python, который был заброшен более полугода. Зависимости устарели, при запуске сыпалась куча ошибок. Раньше мне пришлось бы копировать ошибки одну за другой в ChatGPT, он бы говорил «возможно, проблема в версии какой-то библиотеки», я бы переключался, искал, исправлял, снова запускал... Полдня ушло бы только на переключение между окнами. В этот раз я просто открыл Codex в папке проекта и бросил фразу: «Проект не запускается, найди причину и исправь так, чтобы он работал». Он сам перерыл requirements.txt и стек ошибок, локализовал две несовместимые зависимости, изменил номера версий и запустил еще раз для проверки. Я пошел налить кофе, а когда вернулся, он уже ждал, пока я просмотрю diff.

Сразу чувствуешь весь вес слова «агент (Agent, ИИ, способный автономно выполнять задачи)» — он не просто дает советы, он берет на себя выполнение работы до конца.

💡 Резюме в одном предложении: Codex = официальный ИИ-агент для программирования от OpenAI. Вы ставите цель, он всё делает сам, это не просто «чат, который умеет писать код».


02 Четыре обличья: один и тот же Codex, четыре варианта доступа

Это то, чем Codex больше всего отличается от многих других инструментов и где проще всего запутаться, поэтому давайте разберем это подробно.

При упоминании «командной строки» или «терминала» у многих новичков сразу всплывает черное окно в голове, и желание пользоваться инструментом отпадает. Без паники — как раз среди всех основных ИИ-инструментов для программирования Codex является одним из самых дружелюбных для тех, кто «не хочет трогать командную строку», потому что для него специально создано Desktop App с графическим интерфейсом.

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

Вариант доступаКак выглядитГде работаетДля кого / каких сценариев
Desktop App (Codex app)Отдельное приложение, графический интерфейс, визуальный просмотр diff, параллельный запуск задачНа вашем компьютереДля тех, кто не хочет трогать командную строку, любит кликать по интерфейсу и кому нужно отслеживать несколько задач одновременно
Командная строка CLI (Codex CLI)Инструмент командной строки, запускаемый через codex в терминалеНа вашем компьютереДля тех, кто привык к терминалу, хочет писать скрипты для автоматизации и работать на сервере / через SSH
Расширение для IDE (IDE extension)Плагин для боковой панели в VS Code / Cursor / Windsurf / JetBrainsНа вашем компьютереДля тех, кто и так постоянно сидит в редакторе кода
Cloud Web (Codex cloud)Открывается в браузере chatgpt.com/codex, задачи выполняются в облачной среде OpenAIВ облакеДля запуска долгих фоновых задач, одновременного выполнения нескольких задач без нагрузки на локальный компьютер

Первые три из них (Desktop App, CLI, расширение для IDE) — это работа на вашем собственном компьютере: они читают ваши локальные файлы и запускают локальные команды. Отличается только четвертый вариант — Cloud Web:

Аналогия: передача работы на аутсорс. Первые три варианта похожи на то, как если бы вы посадили помощника за свой рабочий стол, чтобы он работал за вашим компьютером с вашими файлами, а вы наблюдали за процессом. Cloud Web — это как передача задачи удаленной команде на аутсорсинг: вы оставляете заявку в браузере, OpenAI создает изолированную среду в своем облаке, вытягивает туда ваш репозиторий с GitHub, в закрытом режиме вносит изменения, а затем отдает вам diff или даже сразу делает PR (Pull Request, запрос на слияние). Компьютер можно выключить, а задача будет выполняться.

Такая модель «аутсорсинга» имеет два реальных преимущества: первое — параллельность (можно отправить три-пять задач одновременно, и они не будут блокировать друг друга); второе — изоляция (он возится в своей песочнице, не трогая вашу систему, и даже если всё испортит, до вас это не доберется). Я сам чаще всего комбинирую так: для мелких исправлений использую Desktop App или CLI и слежу за процессом на месте, а долгие и нудные задачи вроде «запустить все тесты и исправить проваленные» отправляю висеть в облако и возвращаюсь к ним позже.

Здесь есть критически важный момент, который стоит выделить жирным:

За всеми четырьмя вариантами доступа стоит один и тот же Codex, и их конфигурации в значительной степени синхронизированы. Например, написанный вами AGENTS.md (файл с описанием проекта, о нем будет отдельная статья) или созданные вами Skills (переиспользуемые инструкции и рабочие процессы) — как четко сказано в документации, могут использоваться совместно в Desktop App, CLI и расширении для IDE. Настроили один раз — работает везде. Если вы раньше использовали любой из этих вариантов, при открытии другого вы по-прежнему будете видеть историю своих проектов.

Дружеский совет: Новички, не мучайтесь выбором «что изучать сначала». Мой совет: если боитесь командной строки, начинайте с Desktop App (графический интерфейс, наглядный diff — самый надежный вариант); если любите зависать в терминале — сразу переходите на CLI. В следующих статьях этой серии (с 07 по 10) каждый из четырех вариантов будет разобран отдельно, а сейчас вам достаточно запомнить, что есть «один и тот же Codex в четырех обличьях».

💡 Резюме в одном предложении: У Codex есть четыре варианта доступа: Desktop App / CLI / расширение для IDE / Cloud Web. Первые три работают на вашем локальном компьютере, Cloud Web передает работу в облако на аутсорс, но база у них одна — это тот же Codex с синхронизированными настройками.


03 Что он может и чего не может

Список того, что он может, мы уже перечислили в разделе 01. Здесь же добавим вторую, самую важную половину — чего он не может. Это даже ценнее, чем понимание его возможностей, потому что именно на этом спотыкаются почти все новички.

❌ Чего от него не стоит ожидатьПочему
Что он примет за вас технические решенияКакую архитектуру выбрать, стоит ли делать рефакторинг, как расставить приоритеты требований — всё это ваша работа, он не силен в глобальном проектировании систем
Что он гарантирует код на 100% без баговОн предлагает высококачественные варианты, а не абсолютно правильные ответы, и после его правок код обязательно должны проверять вы
Что он угадает требования, которые вы не объяснилиВсю бизнес-логику, которую вы не прояснили, ему придется угадывать, и чем больше автоматизации, тем выше риск того, что его занесет не туда
Что он будет полностью автономно работать над кодом, в котором вы вообще ничего не понимаетеЕсли вы не понимаете, что он изменил, вы не сможете оценить правильность решения, это всё равно что вести машину с закрытыми глазами

Самая частая ошибка — это второй пункт. Я как-то по глупости попросил Codex массово добавить обработку ошибок в проекте. Он мигом изменил десяток файлов, и я, чтобы не заморачиваться, сразу их закоммитил (commit). Как оказалось, в двух местах он «по собственной инициативе» заодно подправил старую логику, и лишь пару дней спустя выяснилось, что поведение одного из интерфейсов изменилось. С тех пор у меня железное правило: перед коммитом просматривать через diff каждую измененную им строчку. Кстати, в руководстве по быстрому старту разработчики Codex специально отмечают: перед тем, как что-то менять, сделайте чекпойнт (checkpoint) в Git (можно представить это как «сохранение» проекта), чтобы в случае неудачных изменений можно было откатиться в один клик. Чем раньше новичок выработает эту привычку, тем лучше.

Правильный настрой при работе с Codex можно описать одной фразой:

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

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

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


04 Codex vs ChatGPT vs Claude Code

Два вопроса, которые новички задают чаще всего: «Разве Codex и ChatGPT не из одной компании? В чем разница?» и «А чем он отличается от Claude Code?». Ответим на всё сразу.

Чем отличаются Codex и ChatGPT

Оба они принадлежат OpenAI, но это вещи совершенно разных измерений.

Аналогия: советник в штабе vs спецназовец на задании. ChatGPT похож на советника, сидящего в штабе: вы описываете ему ситуацию, он дает советы и рисует план, но он не выходит на поле боя, исполнять всё придется вам. Codex — это спецназовец, который может высадиться прямо в гущу событий: вы даете ему цель, он сам проникает в ваш проект (читает файлы, выполняет команды, меняет код) и возвращается с докладом только после завершения миссии.

Проще говоря: ChatGPT отвечает на ваши вопросы, а Codex берет и делает то, что вы ему поручили. И что самое интересное — Codex уже включен в подписку ChatGPT (согласно документации, каждый аккаунт ChatGPT — включая бесплатный тариф — включает квоту на использование Codex, а у платных тарифов Plus / Pro / Business / Edu / Enterprise лимиты выше), также его можно подключить с оплатой за использование через API-ключ OpenAI. Сколько квоты дают на каждом тарифе и есть ли разница в функционале при разных способах входа — всё это быстро меняется, поэтому всегда ориентируйтесь на официальную страницу с тарифами (об этом подробно поговорим в 04 статье).

Чем отличаются Codex и Claude Code

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

ХарактеристикаCodex (OpenAI)Claude Code (Anthropic)
ПроисхождениеOpenAI, в основе модели серии GPTAnthropic, в основе модели серии Claude
Самый удобный вариант доступаОфициально выпущено Desktop App с графическим интерфейсом, что удобно для тех, кто избегает командной строкиОриентирован на терминал (CLI), обладает самым полным функционалом и позволяет лучше понять принципы работы
Файл описания проектаAGENTS.mdCLAUDE.md
Четыре варианта доступаDesktop App / CLI / расширение для IDE / Cloud WebТерминал / плагин для редактора / Desktop App / веб-версия·мобильное приложение
Может ли изменять файлы, выполнять команды?Да, это настоящий агентДа, это настоящий агент

Видите? Скелет у обоих практически идентичен: это агенты для программирования, которые «могут читать проект и работать руками», имеют несколько вариантов доступа локально + в облаке и используют файлы описания проектов для своей «тренировки». Самые очевидные различия сводятся к двум вещам: первое — разная родословная (GPT vs Claude, разные модели под капотом); второе — разный характер по умолчанию: разработчики Codex активно продвигают Desktop App с графическим интерфейсом, явно стремясь привлечь тех, кто «не хочет трогать терминал»; Claude Code же изначально создан для терминала, от него так и веет командной строкой.

Я сам использую оба инструмента, разделяя задачи примерно так: то, где нужен графический интерфейс, хочется визуально контролировать diff или параллельно запустить несколько веток работы в одном проекте, я отдаю Codex через Desktop App; задачи, где нужно копаться в терминале и подключать кучу кастомных скриптов и хуков, я оставляю Claude Code. Это не замена, а дополнение одного другим.

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

💡 Резюме в одном предложении: ChatGPT — это советник, генерирующий идеи; Codex — спецназовец от OpenAI, который работает руками; Codex и Claude Code — это агенты от разных компаний, со схожей структурой, но разными моделями и характером. Выбирайте инструмент по задаче, а не пытайтесь остановиться на одном из них.


05 Практика: проверьте за 30 секунд, знаком ли ваш компьютер с ним

Я обещал, что в этой статье не будет инструкций по установке, но оставлю одно простое действие без затрат для проверки вашей среды (установлен он или нет, эта команда выполнится и ничего не сломает).

Откройте терминал (на Mac это приложение «Терминал / Terminal», на Windows — PowerShell), введите эту строку и нажмите Enter:

bash
codex --version

Оба ожидаемых результата нормальны:

  • Ситуация первая: выскочила строка с версией — поздравляю, значит, вы уже когда-то устанавливали CLI, в 03 статье можете сразу переходить к разделу «Как использовать».
  • Ситуация вторая: ошибка command not found: codex (на Windows может быть 'codex' не является внутренней или внешней командой...) — это тоже абсолютно нормально, значит, CLI еще не установлен, и именно с этого начнется 03 статья.

Заранее покажу команду для установки CLI (пока не спешите её вводить, просто взгляните), оригинальная версия от разработчиков выглядит так:

bash
# macOS / Linux: стандартный скрипт установки
curl -fsSL https://chatgpt.com/codex/install.sh | sh
powershell
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

После установки достаточно написать в терминале codex, он предложит вам войти в систему (с аккаунтом ChatGPT или API-ключом OpenAI), и после этого можно начинать работу в текущей директории.

Напоминание первое: выше описана установка командной строки CLI. Если вы боитесь командной строки, для Desktop App есть путь графического интерфейса — «скачать установочный файл, дважды кликнуть и установить» (доступно для macOS / Windows, версия для Linux пока в очереди на релиз), что ничем не отличается от установки обычных программ — в 03 статье мы разберем все четыре варианта по шагам.

Напоминание второе: Codex привязан к системе аккаунтов OpenAI / ChatGPT, поэтому пользователям из некоторых стран для установки и входа обычно требуется «магия» (VPN), как именно это сделать и как залогиниться, подробно рассмотрим в 03 статье, сейчас на этом останавливаться не будем.

Ниже приведена схема, показывающая связь между «локальным» и «облачным» в четырех вариантах доступа. Если вы не видите картинку, это не страшно, достаточно помнить таблицу, которая была выше:

Маршрутизация четырех вариантов доступа к Codex: три локальных варианта выполняются на локальном ПК, облачный вариант проходит через песочницу OpenAI, но в итоге это один и тот же агент

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

💡 Резюме в одном предложении: Одной командой codex --version можно проверить, знаком ли компьютер с ним — ошибке не пугайтесь, это стартовое задание для 03 статьи; если боитесь командной строки, просто помните, что есть Desktop App с графическим интерфейсом.


06 Итоги

В этой статье мы не написали много команд, зато прояснили самое главное, что нужно знать вначале:

  • Что это такое: Официальный ИИ-агент для программирования от OpenAI. Даете ему цель, он читает проект, вносит изменения, выполняет команды, доводит дело до конца — это не просто «чат, умеющий писать код».
  • Четыре обличья: Desktop App, CLI, расширение для IDE и Cloud Web — это четыре входа. Первые три работают на вашем компьютере, Cloud Web передает работу в облако на аутсорс, но база одна — это тот же Codex с синхронизируемыми настройками.
  • Что может / не может: Может читать код, изменять файлы, фиксить баги и делать рутину; но принятие решений, контроль и управление требованиями — это всегда ваша работа, после него обязательно проверяйте diff.
  • С кем и как сравнивать: ChatGPT — советник, Codex — спецназовец, который делает работу руками; Codex и Claude Code — похожие агенты от разных разработчиков, у них общий скелет, но разные модели и характер, используйте их по ситуации, а не выбирайте что-то одно.

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


Следующая статья 〈02 Краткий обзор ключевых концепций〉: мы раз и навсегда разберемся с терминами в мире Codex — цикл агента, контекст, AGENTS.md, режим утверждения, песочница, Skills, MCP... Все эти слова будут встречаться каждый день. А пока введите команду codex --version из предыдущего раздела, чтобы узнать, к «ситуации один» или «ситуации два» вы относитесь, в 03 статье мы как раз решим эту проблему.


Рекомендуемое чтение