Какой вариант Codex выбрать
С 9 июля 2026 года Codex — это не отдельная программа, а один из трёх режимов внутри обновлённого десктоп-приложения ChatGPT (Chat, Work и Codex), плюс отдельные консольная утилита и расширения для редакторов кода. Формат зависит от того, как вы собираетесь работать.
| Вариант | Для кого | ОС | Плюсы |
|---|---|---|---|
| Приложение ChatGPT (режим Codex) | Тем, кто хочет запускать задачи из привычного окна ChatGPT, без терминала | Windows, macOS | Один интерфейс для чата и кода, задачи можно ставить в фоне и следить с телефона |
| Codex CLI | Разработчикам, которые работают в терминале и хотят встроить Codex в свои скрипты | macOS, Linux, Windows | Полный контроль над репозиторием, работа без графического интерфейса, скрипты и автоматизация |
| Расширение для IDE | Тем, кто пишет код в VS Code, Cursor или похожем редакторе | Везде, где есть сам редактор | Codex прямо в панели редактора, без переключения окон |
| Codex в облаке (веб) | Для быстрых задач без установки чего-либо на компьютер | Любой браузер | Ничего ставить не нужно, задача выполняется на серверах OpenAI |
Варианты не исключают друг друга: многие ставят CLI для рабочих проектов и держат приложение или расширение для быстрых задач. Разницу между «что такое Codex» и «как им пользоваться» подробно разбирает статья как пользоваться Codex.
Что нужно заранее
- Аккаунт ChatGPT. Подходит любой план, включая бесплатный, но лимиты на использование Codex разные — сравнение тарифов в статье про подписку ChatGPT.
- Git. Codex работает с репозиториями, поэтому Git должен быть установлен и настроен (
git config user.nameиuser.email) ещё до первого запуска. - Node.js — только для CLI через npm. Нужна актуальная LTS-версия Node.js; на старых версиях глобальная установка пакета может завершаться ошибкой. Для установки через Homebrew или официальный скрипт Node не требуется.
- Права администратора / стандартные права пользователя. Для приложения и расширения IDE обычно достаточно обычной учётной записи; для глобальной установки npm-пакета на Windows иногда нужен запуск терминала от имени администратора, если возникает ошибка доступа.
- Место и терминал. Для CLI понадобится любой терминал — PowerShell/Терминал Windows, Terminal на macOS или обычный shell на Linux.
Codex работает только в странах, которые OpenAI официально поддерживает, и Россия в их число не входит: приложения ChatGPT нет в российских App Store и Google Play, российские банковские карты для оплаты платных планов не принимаются. Это ограничения самого сервиса, и мы не даём инструкций по их обходу — сайт лишь фиксирует факт.
Установка приложения Codex на Windows
9 июля 2026 года OpenAI объединила прежнее отдельное приложение Codex и десктоп-приложение ChatGPT: теперь это одна программа с тремя режимами — Chat, Work и Codex — доступными на всех тарифах, включая бесплатный.
- Откройте страницу загрузки на chatgpt.com/download и выберите Windows — ссылка ведёт в официальную карточку приложения «ChatGPT» в Microsoft Store.
- Нажмите «Установить» в Store и дождитесь окончания загрузки.
- Запустите приложение через меню «Пуск» и войдите под своим аккаунтом ChatGPT.
- В левой панели переключитесь на режим Codex — он появится рядом с Chat и Work.
- При первом запуске выберите папку проекта на диске: Codex запросит доступ именно к этой папке, а не ко всему компьютеру.
Если раньше у вас уже стояло отдельное приложение Codex — после обновления через Store оно само становится новым ChatGPT с режимом Codex, старые чаты и проекты сохраняются.
Если Microsoft Store на компьютере недоступен или отключён политиками, для работы с кодом можно обойтись без десктоп-приложения: Codex CLI и расширение для редактора ставятся отдельно (см. ниже). Не используйте сторонние «инсталляторы Codex» и файлы вроде «codex.exe» с файлообменников — это самый частый источник поддельных и вредоносных программ; к тому же под названием Codex распространяются никак не связанные с OpenAI программы для игр.
При выполнении команд песочница Codex на Windows по умолчанию ограничивает доступ к файлам и сети рамками выбранной папки проекта — это касается уже CLI и режима Codex внутри приложения (подробнее — в разделе про CLI ниже).
Установка на macOS
- Откройте chatgpt.com/download — сайт сам определит архитектуру и предложит нужный установщик.
- Скачается файл
.dmg; откройте его и перетащите значок ChatGPT в папку «Программы». - Запустите приложение из Launchpad и войдите в свой аккаунт ChatGPT.
- Переключитесь на режим Codex в боковой панели и разрешите доступ к папке с проектом, когда приложение попросит.
Актуальная сборка ориентирована на компьютеры с чипами Apple Silicon (M1 и новее) под macOS 14 и выше. Если у вас Mac на процессоре Intel, перед установкой стоит свериться со страницей загрузки — там указано, какая сборка доступна именно для вашего Mac на момент скачивания, так как поддержка платформ у OpenAI периодически меняется.
Codex CLI: установка через npm или Homebrew
Codex CLI — это консольная утилита codex, которая работает прямо в терминале и не требует десктоп-приложения. У OpenAI есть четыре официальных способа поставить её.
«npm install -g @openai/codex»
«brew install --cask codex»
Есть и официальный установочный скрипт, который сам подбирает бинарник под вашу систему без Node.js и Homebrew:
«curl -fsSL https://chatgpt.com/codex/install.sh | sh»
«powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"»
Четвёртый вариант — скачать готовый бинарник вручную со страницы релизов на github.com/openai/codex: там же можно свериться с актуальной версией и списком изменений (релизы выходят почти ежедневно).
После установки любым способом запустите:
codexПри первом запуске CLI предложит войти. Проще всего выбрать «Sign in with ChatGPT» — авторизация пройдёт через браузер и учитывает лимиты вашего плана (Plus, Pro, Business, Edu или Enterprise). Второй вариант — вход по API-ключу с platform.openai.com, если вам нужна оплата по факту использования, а не по подписке. Проверить, что утилита установилась и доступна в терминале, можно командой:
codex --versionCLI на Windows: нативно или через WSL
Официальный установщик для Windows ставит CLI нативно, через PowerShell; в этом режиме Codex использует собственную песочницу для Windows, которая ограничивает доступ команд к файлам и сети рамками текущего проекта, без необходимости ставить WSL или виртуальную машину. WSL2 остаётся хорошим выбором, если ваш проект и так живёт в Linux-окружении или вам нужна максимально строгая изоляция команд — тогда стоит поставить Codex внутри самого дистрибутива WSL, а не пытаться пробросить его из Windows.
CLI на Linux
На Linux (x86_64 и arm64) работают все четыре способа установки. Отдельных ограничений песочницы, специфичных для дистрибутива, нет — Codex использует стандартные механизмы изоляции процессов ядра Linux.
Расширение для VS Code, Cursor и других IDE
- Откройте панель расширений в редакторе и найдите «Codex».
- Официальное расширение публикует издатель openai с идентификатором
openai.chatgpt— сверьте это в карточке расширения перед установкой: в маркетплейсах встречаются похожие по названию неофициальные расширения. - Нажмите «Установить» и подтвердите доверие издателю, если редактор спросит об этом.
- После установки в боковой панели появится значок Codex — откройте его и нажмите «Sign in with ChatGPT».
- В открывшейся вкладке браузера войдите в аккаунт ChatGPT — после этого панель Codex в редакторе активируется.
Расширение работает в VS Code и в редакторах на его основе, включая Cursor — интерфейс и способ входа у них совпадают. Через терминал ту же логику входа использует и CLI, поэтому расширение и консольная утилита могут делить одну авторизацию и общий конфиг.
Первый запуск и проверка
Прежде чем давать Codex доступ к рабочему репозиторию, стоит попробовать его на тестовой папке — это касается и CLI, и расширения, и режима Codex в приложении.
- Создайте пустую тестовую папку и превратите её в git-репозиторий (
git init). - Запустите Codex в этой папке и выберите режим «только чтение» или «с подтверждением каждого действия» — так Codex будет спрашивать разрешение перед изменением файлов или выполнением команд.
- Дайте небольшую безопасную задачу, чтобы увидеть, как Codex объясняет план и какие файлы собирается менять.
«Создай в этой папке файл README.md с кратким описанием тестового проекта и покажи план действий перед тем, как что-то менять»
Если план и правки выглядят разумно, можно переходить к боевому проекту и постепенно снижать уровень подтверждений. Как правильно формулировать задачи для Codex — отдельная тема, разобранная в статье о составлении промптов.
Как обновить и удалить Codex
| Вариант установки | Обновить | Удалить |
|---|---|---|
| Приложение (Windows/macOS) | Обновляется через Microsoft Store / автообновление macOS-приложения, либо повторной загрузкой .dmg | Удалить как обычную программу — через «Приложения» в Windows или перетаскиванием в Корзину на macOS |
| CLI (npm) | npm update -g @openai/codex | npm uninstall -g @openai/codex |
| CLI (Homebrew) | brew upgrade codex | brew uninstall codex |
| CLI (установочный скрипт) | Повторный запуск того же скрипта устанавливает свежую версию поверх старой | Удалить бинарник и папку ~/.codex вручную |
| Расширение IDE | Обновляется вместе с обновлениями расширений редактора | Удалить из панели расширений, как любое другое |
Версии CLI меняются часто: например, релизы конца сентября 2026 года добавили полноэкранный режим терминала, команду /usage для просмотра статистики использования и поддержку git worktrees «из коробки». Проверить свою версию и сравнить со свежей можно командой codex --version и страницей релизов на GitHub.
Частые проблемы при установке
| Симптом | Вероятная причина | Что сделать |
|---|---|---|
После npm install -g @openai/codex команда codex не найдена | Папка глобальных npm-пакетов не попала в переменную PATH | Проверить путь командой npm config get prefix и добавить его bin-подпапку в PATH; перезапустить терминал |
| Ошибка при установке пакета (permission denied) | Слишком старая версия Node.js или npm пытается писать в системную папку без прав | Обновить Node.js до актуальной LTS и не использовать sudo npm install -g — лучше настроить npm на пользовательскую директорию |
Установили codex без scope, а не @openai/codex | Пакет без scope с именем codex в npm не относится к OpenAI — официальный пакет называется только @openai/codex | Удалить его (npm uninstall -g codex) и поставить заново с точным именем @openai/codex |
| При входе ошибка «Sign-in could not be completed: token exchange failed» | Рассинхронизация времени на компьютере, старые файлы авторизации в ~/.codex или блокировка антивирусом/файрволом | Проверить системные дату и время, попробовать выйти и войти заново, при повторении — переустановить CLI с чистой конфигурацией |
| Приложение или CLI не запускается после обновления | Осталась несовместимая старая конфигурация или кэш от прежней версии | Переустановить приложение либо очистить локальный кэш/конфиг и войти заново |
| «Codex недоступен в вашей стране» при входе | Аккаунт создаётся или используется из региона, которого нет в списке поддерживаемых OpenAI стран | Это ограничение самого сервиса; обход региональных проверок мы не описываем |
Частые вопросы
Codex бесплатный?
Сами приложение, CLI и расширение для IDE бесплатны для скачивания и работают на бесплатном плане ChatGPT, но с заметно урезанными лимитами использования. Более широкие лимиты и доступ к дополнительным моделям — на платных планах, подробнее — в статье про подписку ChatGPT.
Можно ли поставить Codex без Microsoft Store?
Десктоп-приложение для Windows распространяется через Microsoft Store (ссылка есть на странице загрузки OpenAI). Без него можно пользоваться Codex CLI — официальным скриптом для PowerShell или через npm — и расширением для IDE: они ставятся отдельно от приложения. Сторонние установщики с файлообменников использовать не стоит.
Нужен ли отдельный API-ключ для работы Codex?
Нет, для обычной работы достаточно входа через аккаунт ChatGPT — лимиты будут считаться по вашему плану. API-ключ с platform.openai.com нужен только тем, кто хочет платить по факту использования токенов вместо подписки.
Работает ли Codex на Linux?
Да, Codex CLI официально поддерживает Linux на архитектурах x86_64 и arm64 — через npm, установочный скрипт или бинарник с GitHub. Десктоп-приложения ChatGPT с режимом Codex под Linux на сентябрь 2026 года нет, доступны только Windows и macOS.
Можно ли пользоваться Codex с телефона?
Частично. По официальной таблице тарифов на сентябрь 2026 года Codex доступен в приложении ChatGPT для iOS на планах Plus и выше: с телефона можно ставить облачные задачи и следить за их выполнением. Писать и проверять код удобнее всё равно на компьютере.
Где хранятся настройки Codex после установки?
Пользовательская конфигурация CLI лежит в файле ~/.codex/config.toml (на Windows — по пути %USERPROFILE%\.codex\config.toml); файл появляется только после первого запуска или ручного создания. В свежих версиях часть настроек можно задать и на уровне проекта — актуальный порядок описан в документации Codex на learn.chatgpt.com.
Итог / чек-лист
- Решите, что нужно: приложение ChatGPT с режимом Codex для работы без терминала, CLI для консоли и автоматизации, расширение — для работы прямо в VS Code или Cursor.
- Для приложения — идите на официальную страницу загрузки ChatGPT (для Windows она ведёт в Microsoft Store, для macOS — установщик .dmg, основная платформа — Apple Silicon).
- Для CLI — выберите один способ:
npm install -g @openai/codex,brew install --cask codexили официальный скрипт с chatgpt.com/codex, и запуститеcodex --version, чтобы проверить установку. - Для IDE — ставьте расширение только от издателя
openaiс идентификаторомopenai.chatgpt. - Войдите через «Sign in with ChatGPT», первую задачу проверьте на тестовой папке в режиме подтверждения действий.
- Обновляйте тем же способом, каким ставили (npm update, brew upgrade, Store, скрипт) — версии CLI выходят часто.
- Не используйте сторонние установщики, обходы региональных ограничений и посредников для оплаты — это риск для аккаунта и данных, а не официальный способ получить доступ.