OpenAI Codex: что это и как начать (CLI, IDE, приложение)

OpenAI Codex — это кодинг-агент от OpenAI: вы ставите задачу обычным языком («найди причину ошибки», «добавь тест», «проверь изменения»), а он читает проект, правит файлы и запускает команды. Работает в нескольких оболочках с общим аккаунтом ChatGPT: Codex CLI (в терминале), расширение для редакторов (VS Code, Cursor, Windsurf, а также Xcode и JetBrains), приложение ChatGPT и облачный режим Codex Cloud. Чтобы начать, достаточно аккаунта ChatGPT: по официальной документации Codex входит во все тарифы, включая бесплатный, только лимитов на нём меньше. Ниже — что где ставить, как войти, сколько это стоит и чем Codex отличается от Claude Code. Все сведения — из официальной документации OpenAI (developers.openai.com/codex, сейчас она открывается на learn.chatgpt.com), репозитория github.com/openai/codex и страницы с тарифами, по состоянию на октябрь 2026.

Что такое Codex и чем он не является

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

Если вы совсем новичок в теме, сначала почитайте, как устроен такой тип инструментов, в общем разборе «Вайб-кодинг: что это и с чего начать». Здесь — практика.

Где живёт Codex: четыре способа использовать

Оболочка	Что это	Кому подходит
Codex CLI	Агент в терминале, работает в папке вашего проекта	Разработчикам, привыкшим к командной строке; автоматизации (режим codex exec)
Расширение для IDE	Боковая панель в VS Code, Cursor, Windsurf; также интеграции с Xcode и JetBrains	Тем, кто работает в редакторе и хочет видеть диффы рядом с кодом
Приложение ChatGPT	Настольное приложение (macOS, Windows, Linux) с режимом Codex: проекты, локальные файлы, долгие задачи	Тем, кто не хочет терминала и редактора
Codex Cloud (веб)	Задачи выполняются в облаке, результат смотрите в вебе, мобильном или настольном приложении	Задачам по репозиториям GitHub, которые можно отдать и вернуться позже

Подробнее про облако: на chatgpt.com (или в настольном приложении) вы создаёте окружение, выбираете «Work in → Cloud», подключаете репозитории GitHub; Codex сам изучает проект, ставит зависимости и проверяет рабочий процесс, после чего вы публикуете окружение и запускаете задачи. У каждой задачи свой рабочий каталог, а окружение переиспользуется. В настройках окружения задаются доступ в интернет, разрешённые домены для исходящих подключений, секреты и переменные окружения.

Установка Codex CLI

Варианты установки, которые называют официальные источники:

Способ	Команда
npm	npm install -g @openai/codex
Homebrew (macOS)	brew install --cask codex
Скрипт (macOS и Linux)	curl -fsSL https://chatgpt.com/codex/install.sh | sh
Готовые бинарные файлы	со страницы последнего релиза github.com/openai/codex/releases/latest

Запуск — командой codex в папке проекта. По README репозитория, CLI поддерживает macOS (Apple Silicon и x86_64) и Linux (x86_64 и arm64). Для Windows на странице установки в документации OpenAI есть отдельная вкладка, а для работы через Linux-окружение описан вариант с WSL — команду берите оттуда, она меняется. Расширение для VS Code и настольное приложение работают в Windows без CLI.

Первый запуск:

1. Перейдите в папку проекта и выполните codex.
2. Выберите «Sign in with ChatGPT» — подойдёт аккаунт с тарифом Plus, Pro, Business, Edu или Enterprise; документация OpenAI при этом сообщает, что Codex входит и в бесплатный тариф. Вход по API-ключу тоже возможен, он требует дополнительной настройки.
3. Опишите задачу, например «Расскажи про этот проект».

Основные команды и настройки

Команда	Что делает
/init	Создаёт файл инструкций AGENTS.md
/status	Показывает конфигурацию сессии
/permissions	Задаёт границы: когда правки файлов и запуск команд требуют вашего подтверждения
/model	Выбор модели и уровня рассуждений
/review	Проверка изменений на проблемы

Для неинтерактивных сценариев (скрипты, CI) есть codex exec. Файл настроек — ~/.codex/config.toml, постоянные инструкции для агента — AGENTS.md в корне проекта. Если вы работаете с Claude Code, это аналог файла CLAUDE.md. Начинающим стоит держать подтверждения включёнными: команда /permissions позволяет сначала смотреть, что агент собирается сделать, и только потом разрешать.

Расширение для IDE

Расширение поддерживает VS Code и совместимые редакторы (Cursor, Windsurf); для Xcode и JetBrains в документации описаны отдельные нативные интеграции. Установка:

1. Откройте вкладку расширений в редакторе и найдите расширение Codex, либо используйте ссылки: vscode:extension/openai.chatgpt для VS Code, cursor:extension/openai.chatgpt для Cursor, windsurf:extension/openai.chatgpt для Windsurf.
2. Нажмите на значок Codex в редакторе или откройте Command Palette и выполните «Codex: Open Codex Sidebar» (пригодится, если значка не видно).
3. Войдите в аккаунт OpenAI.
4. Пишите запрос: расширение видит открытые файлы и выделения, а диффы можно смотреть рядом с кодом.

Из расширения большую задачу можно передать в Codex Cloud, сохранив непрерывность чата. По сути это аналог подхода, о котором мы писали для Claude: если нужен разбор настройки в редакторе, откройте «Claude Code в VS Code».

Тарифы и лимиты

По данным официальной документации на октябрь 2026, Codex входит во все тарифы ChatGPT:

Тариф	Цена
Free	$0 в месяц
Go	$8 в месяц
Plus	$20 в месяц
Pro	от $100 в месяц (варианты $100, $200 и $500)
Business	$20 за пользователя в месяц, минимум 2 пользователя, годовая оплата
Enterprise и Edu	по запросу в отдел продаж

Сколько запросов вы сделаете, зависит от модели, размера и сложности задач и от того, выполняются они локально или в облаке. Для ориентира документация приводит приблизительное число локальных сообщений за пять часов на тарифах Plus и стандартном Business: для модели GPT-6 Astra — от 5 до 45, для GPT-6.1 Sol — от 15 до 160, для GPT-6 Luna — от 350 до 3000. На Pro пятичасового лимита нет. Для Enterprise и Edu с гибкой ценой фиксированных лимитов нет.

Есть и отдельный вариант — API-ключ: он подходит для автоматизации в общих средах вроде CI, оплачивается по стандартным тарифам API, а облачные функции (проверка кода в облаке, интеграция со Slack) с ключом недоступны. Лимиты и модели меняются часто, поэтому перед оплатой сверьтесь с актуальной страницей тарифов.

Важное про доступ из России: ChatGPT и OpenAI официально в России не работают — страна не входит в список поддерживаемых, российские банковские карты не принимаются. Способы оплаты разобраны в статье «Как оплатить Claude и ChatGPT из России без зарубежной карты».

Codex и Claude Code: честное сравнение

Это два однотипных агента, и выбор часто решают привычка и подписка. Что можно сказать по официальным данным:

Параметр	OpenAI Codex	Claude Code
Где работает	CLI, расширение IDE, приложение ChatGPT, облако	CLI, расширение VS Code, десктопное приложение, веб
Бесплатный доступ	Есть: Codex входит в тариф Free с меньшими лимитами	Нет: на бесплатном тарифе Claude Code не включён
Минимальная цена платного тарифа	Go — $8 в месяц	Pro — $20 в месяц ($17 при оплате за год)
Файл инструкций проекта	AGENTS.md	CLAUDE.md
Управление подтверждениями	/permissions	Режимы Auto, Manual, Plan, Edit automatically

Что в таблице не сказано, и это важно: какой агент пишет лучший код, зависит от задачи, языка, модели и вашей формулировки. Сравнивать «в среднем» по чужим тестам надёжнее на своём проекте: возьмите одну небольшую задачу и дайте обоим. Подробнее про выбор инструментов — в статье «Лучшая нейросеть для программирования», про сам Claude Code — «Claude Code: руководство для новичка». Если вы думаете о редакторе со встроенным ИИ, а не об агенте, посмотрите «Cursor AI: обзор, тарифы, как пользоваться».

С чего начать новичку

1. Выберите оболочку по привычке. Живёте в редакторе — ставьте расширение; не хотите терминал и редактор — приложение ChatGPT; любите командную строку — Codex CLI.
2. Начните на небольшом проекте и в режиме с подтверждениями: смотрите, какие файлы агент хочет править.
3. Создайте AGENTS.md командой /init и впишите туда правила проекта: как запускать тесты, какой стиль кода.
4. Просите проверку. Команда /review поможет найти проблемы в изменениях до того, как вы их сохраните.
5. Следите за лимитами. Тяжёлые модели расходуют лимит быстрее, посмотрите /model и выбирайте под задачу.

Не отправляйте агенту секреты (ключи, пароли) и не давайте ему широких прав без необходимости. Доступ облачного окружения в интернет и список разрешённых доменов настраиваются — не открывайте лишнего.

Частые вопросы

Что такое OpenAI Codex простыми словами?

Это ИИ-агент для программирования от OpenAI. Он читает ваш проект, вносит правки и запускает команды по вашему описанию задачи. Работает в терминале (Codex CLI), в редакторе (расширение), в приложении ChatGPT и в облаке.

Codex бесплатный?

По официальной документации, Codex входит и в бесплатный тариф ChatGPT, но с меньшими лимитами. Платные тарифы дают больше: Go — $8, Plus — $20, Pro — от $100 в месяц. Использование через API-ключ оплачивается по стандартным тарифам API.

Как установить Codex CLI?

Командой npm install -g @openai/codex либо через Homebrew: brew install --cask codex. На macOS и Linux есть скрипт curl -fsSL https://chatgpt.com/codex/install.sh | sh. Затем запустите codex в папке проекта и выберите «Sign in with ChatGPT».

Как пользоваться Codex?

Запустите его в папке проекта, войдите в аккаунт и опишите задачу обычным языком. Команда /permissions задаёт, что можно делать без вашего подтверждения, /review проверяет изменения, /init создаёт AGENTS.md.

Есть ли Codex для Windows?

Расширение для VS Code и совместимых редакторов работает в Windows, настольное приложение ChatGPT тоже есть для Windows. Для CLI на Windows в документации OpenAI есть отдельная инструкция по установке и вариант через WSL.

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

Это конкурирующие агенты одного класса. У Codex есть бесплатный вход и открытый код CLI, Claude Code доступен только на платных тарифах (от $20 в месяц). Оба работают в терминале, в редакторе и в отдельном приложении. Какой лучше, зависит от вашей задачи — проверяйте на своём проекте.

Можно ли пользоваться Codex из России?

Официально нет: Россия не входит в список стран, где поддерживаются ChatGPT и OpenAI, а российские карты для оплаты не принимаются. Разбор вариантов оплаты — в нашей отдельной статье.