Как установить Codex в 2026: приложение на Windows и Mac, CLI и IDE

Codex от OpenAI устанавливается несколькими способами: десктопное приложение для Windows и macOS, консольный Codex CLI для терминала, расширение для редактора кода VS Code и интеграция через AI Assistant в JetBrains, по документации для IDE. Если не хочется разбираться в вариантах, ставьте приложение: сейчас это основной и самый удобный способ работать с Codex. Есть и облачная версия в браузере, о ней ниже совсем коротко. Дальше по каждому пути: требования, шаги и первый запуск.

Какой способ выбрать

Аккаунт ChatGPT один, но доступные способы работы и модели зависят от тарифа: на Free и Go Codex доступен только в десктопном приложении с GPT-6 Luna по мере развёртывания; на Plus доступны GPT-6.1 Sol и GPT-6 Luna, а также веб, CLI, расширение IDE и iOS. Условия перечислены на странице тарифов.

• Десктопное приложение рекомендуем для Windows и macOS. Агент, история задач и просмотр изменений собраны в одном окне, терминал не нужен. Подходит и для первого знакомства, и для ежедневной работы.
• Codex CLI работает в терминале и ставится одной командой. Гибкий путь для тех, кто дружит с командной строкой.
• В VS Code и совместимых редакторах Codex работает через расширение OpenAI, а в JetBrains через AI Assistant, по документации для IDE. Удобно, если вы уже правите код в редакторе.

Возможности агента и сборка проектов без опыта описаны в статье Codex для вайбкодинга.

Установка приложения Codex на Windows и macOS

Чтобы пользоваться Codex в приложении, установите ChatGPT и выберите в нём Codex: привычный чат и агент работают в одном окне, по документации приложения. Оно ведёт несколько задач параллельно, показывает изменения в файлах, умеет работать с git-ветками и запускать задачи по расписанию. Программистского опыта для установки не нужно: всё как с обычной программой.

На macOS. Понадобится Mac с Apple Silicon (M1 и новее) или Intel и macOS 14 или новее, по системным требованиям ChatGPT. Поддержка Intel Mac появилась в версии приложения 26.415 от 16 апреля 2026 года, согласно журналу изменений.

1. Откройте официальную страницу openai.com/codex и нажмите кнопку скачивания для macOS.
2. Откройте загруженный файл Codex.dmg и перетащите значок приложения в папку «Программы».
3. Запустите ChatGPT и войдите в свой аккаунт.
4. Выберите папку проекта (или создайте пустую), затем выберите Codex в приложении, нажмите New chat и опишите первую задачу своими словами. Такой порядок дан в инструкции первого запуска.

На Windows. Приложение ChatGPT распространяется через Microsoft Store.

1. Откройте страницу ChatGPT в Microsoft Store и нажмите «Установить». Альтернатива: команда winget install --id 9PLM9XGG6VKS -s msstore в PowerShell, оба способа из официальной инструкции.
2. Запустите ChatGPT и войдите в свой аккаунт.
3. Выберите папку проекта, затем выберите Codex в приложении и начните с New chat, чтобы поставить первую задачу.

Агент в приложении работает в песочнице: по умолчанию он ограничен папкой проекта и спрашивает разрешение на действия за её пределами, по документации о разрешениях. На Windows по умолчанию он работает нативно через PowerShell с песочницей Windows. Если подсистема Linux у вас уже стоит, WSL2 можно включить в настройках и перезапустить приложение, как описано в инструкции для Windows.

По теме: Скачать Codex 2026: Windows и Mac без Microsoft Store, запуск из России

Что нужно до установки

• Понадобится аккаунт ChatGPT с тарифом для выбранного способа работы. На Free и Go за 8 долларов в месяц Codex доступен только в десктопном приложении с GPT-6 Luna по мере развёртывания; веб, CLI, расширение IDE и iOS доступны с Plus за 20 долларов в месяц, по странице тарифов. Использование Codex с аккаунтом ChatGPT описано также в справке OpenAI.
• Нужен браузер для входа: при первом запуске Codex открывает страницу авторизации, где вы подтверждаете аккаунт, по инструкции входа.
• Node.js нужен только для установки CLI через npm; для пакета @openai/codex версии 0.160.1 требуется Node.js 16 или новее, по реестру npm. Автономный установщик из документации обходится без Node.js. Приложению Node.js не нужен.
• Если вы в РФ, учитывайте региональное ограничение: Россия не входит в списки поддерживаемых стран для ChatGPT и API OpenAI. Установка приложения этого не меняет. Вопросы оформления и оплаты тарифа описаны в отдельном гайде по покупке Codex из России.

Установка Codex CLI

Codex CLI устанавливается автономным установщиком без Node.js, по документации CLI. Если выбираете npm, который приходит вместе с Node.js, нужен пакет @openai/codex. Без префикса @openai команда установит посторонний пакет codex, генератор статических сайтов и документации, созданный в 2011 году. Описание и дата создания указаны в реестре npm.

1. Выберите автономный установщик: на macOS/Linux выполните curl -fsSL https://chatgpt.com/codex/install.sh | sh; на Windows откройте новое окно PowerShell и выполните powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Обе команды приведены в инструкции CLI.
2. Если предпочитаете npm, пропустите первый шаг: установите Node.js 16 или новее с сайта nodejs.org, перезапустите терминал и выполните npm i -g @openai/codex. Флаг -g ставит агент глобально, чтобы он был доступен из любой папки.
3. Проверьте установку командой codex --version, она должна показать номер версии.
4. Перейдите в папку своего проекта и запустите codex, чтобы начать первую сессию.

На macOS есть альтернатива через Homebrew: brew install --cask codex; для обновления выполните brew upgrade --cask codex, по документации CLI. Автономный установщик и npm обновляют CLI той же командой, которой вы его ставили. Под Windows есть свои нюансы с PATH и PowerShell, они описаны в инструкции как установить Codex на Windows. Свежие версии CLI выходят почти каждую неделю и публикуются в реестре npm. Дальше можно перейти к командам и режимам Codex CLI.

По теме: Как подключить Codex в 2026: аккаунт, тариф и вход с нуля

Codex в VS Code и JetBrains

В VS Code и совместимых редакторах Cursor и Windsurf установите расширение Codex от OpenAI; в JetBrains используйте интеграцию через AI Assistant, по документации для IDE. У расширения для VS Code издатель OpenAI, а идентификатор в магазине Visual Studio Marketplace указан как openai.chatgpt.

1. Откройте VS Code и перейдите на вкладку Extensions (значок с кубиками на боковой панели).
2. Введите в поиск Codex или найдите расширение по идентификатору openai.chatgpt в магазине Visual Studio Marketplace.
3. Нажмите Install, после установки выберите значок Codex. Если его не видно, откройте палитру команд и выполните Codex: Open Codex Sidebar.
4. Войдите в свой аккаунт ChatGPT прямо из панели, чтобы связать расширение с подпиской.

По документации по IDE-расширению, расширение для VS Code и совместимых редакторов делит состояние с приложением и CLI: можно начать задачу в редакторе и вернуться за результатом в другом месте. Для пользователей без VS Code расширение есть и в реестре Open VSX. В JetBrains откройте AI Chat и выберите Codex; войти можно через подписку JetBrains AI, API-ключ или аккаунт ChatGPT, по инструкции JetBrains.

Облачная версия

Облачный Codex открывается в браузере и выполняет задачи на серверах OpenAI. Как основной способ его не рекомендуем: приложению и CLI он уступает в контроле над файлами и удобстве повседневной работы. Особенности этого формата описаны в статье Codex в ChatGPT.

По теме: Codex на ПК в 2026: как запустить на компьютере и что он умеет

Первый запуск и вход в аккаунт

При первом запуске войдите через свой аккаунт ChatGPT. В приложении вы нажимаете кнопку входа, в CLI выбираете Sign in with ChatGPT: открывается страница авторизации OpenAI, вы подтверждаете аккаунт с подходящим тарифом и возвращаетесь в приложение, терминал или редактор с активной сессией. Порядок описан в инструкции входа. Оставшиеся лимиты во время сессии CLI показывает команда /status, по странице тарифов.

По умолчанию CLI хранит данные входа в открытом текстовом файле ~/.codex/auth.json: у настройки cli_auth_credentials_store значение file, как указано в примере конфигурации. Эта настройка также принимает keyring, auto и ephemeral; для системного хранилища ключей (Keychain на macOS, Credential Manager на Windows, Secret Service на Linux) используются keyring или auto, по документации входа. Файл ~/.codex/auth.json содержит токены доступа, поэтому его нельзя коммитить и пересылать. Если вход не проходит, проверьте, не перехватывает ли корпоративный прокси страницу авторизации в браузере.

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

Частые ошибки при установке

• Если ищете установочный exe для Windows, официальный загрузчик называется ChatGPT Installer.exe: скачать его можно по ссылке из инструкции OpenAI. Он ставит приложение ChatGPT из Microsoft Store; искать Codex.exe на сторонних сайтах не нужно. Альтернатива: winget install --id 9PLM9XGG6VKS -s msstore.
• Если поставили не тот пакет, проверьте команду: npm i -g codex без префикса @openai ставит посторонний проект. Если ставите через npm, правильная команда npm i -g @openai/codex.
• Если ставите через npm и версия Node.js ниже 16, обновите Node.js или используйте автономный установщик. У пакета @openai/codex версии 0.160.1 требование Node.js 16 или новее, по реестру npm; автономный способ описан в инструкции CLI.
• Если ставите CLI или расширение на Free/Go, учитывайте ограничение тарифа: на этих тарифах Codex доступен только в десктопном приложении по мере развёртывания. CLI и расширение доступны с Plus, по странице тарифов.
• Если команда codex не находится после установки, обычно дело в PATH. Перезапустите терминал; нюансы Windows описаны в отдельном гайде.

Первая настройка после установки

Когда codex --version показывает номер версии, а вход пройден, остаётся проверить четыре вещи: способ входа, модель, режим одобрений и файл конфигурации.

1. Вход. Команда codex login открывает вход через ChatGPT, а codex login status показывает, какой способ входа активен. Вход по API-ключу и вход по коду для компьютера без браузера (codex login --device-auth, бета-функция) описаны в документации входа.
2. Модель. В сессии команда /model выбирает модель и уровень рассуждения, по документации CLI. Постоянный выбор записывается ключом model в config.toml, например model = "gpt-6.1-sol", как в базовой конфигурации. Какие модели доступны, зависит от тарифа.
3. Режим одобрений. Команда /permissions меняет, что Codex разрешено делать. В папке под контролем версий по умолчанию действует режим Auto: workspace-write и on-request, то есть агент правит файлы проекта и спрашивает разрешение перед выходом за его пределы. В папке без Git Codex может стартовать в режиме read-only, пока вы не доверите каталог, по документации о разрешениях.
4. Файл конфигурации. Личные настройки лежат в ~/.codex/config.toml, настройки проекта в .codex/config.toml внутри репозитория: Codex загружает их только в доверенном проекте. Флаги командной строки перекрывают оба файла.

approval_policy = "on-request"
sandbox_mode = "workspace-write"

Значение never у approval_policy отключает вопросы, а danger-full-access у sandbox_mode снимает песочницу: на пробном проекте ни то ни другое не нужно. Значение untrusted OpenAI вывела из употребления, удалите его из старых конфигов и скриптов. Ключи конфигурации собраны в настройке Codex, команды сессии в справочнике команд и режимов Codex CLI. Если Codex должен работать с вашими открытыми вкладками и сайтами, где вы уже вошли, подключите после установки приложения расширение Chrome для Codex.

Актуальная версия Codex CLI на 9 октября 2026 года: 0.162.0, выпуск от 8 октября (релиз на GitHub). Пакет @openai/codex этой версии в реестре npm требует Node.js 16 или новее.

Ошибки входа и запуска: причина и что делать

Сообщения ниже встречаются сразу после установки. Для каждого указаны причина и первое действие; подробный разбор лежит в статье по ссылке.

• Вход обрывается на обмене токена. Сообщение token exchange failed, в Details часто error sending request for url. Частая причина: браузер открыл страницу входа, но сам процесс Codex не достучался до auth.openai.com. Что делать: проверьте, что сетевые настройки (прокси, VPN) действуют именно на Codex, а не только на браузер, и просмотрите ~/.codex/.env: если там остались старые настройки прокси, уберите их. Разбор: Codex token exchange failed.
• Ответ 403 про страну или регион. Сообщение 403 Forbidden: country, region, or territory not supported. Причина: страна или регион, из которых идёт запрос, не поддерживаются, а России нет в списках поддерживаемых стран. Что делать: см. статьи Codex и VPN, Codex в России и покупка Codex из России.
• Браузер не возвращает вас в приложение или терминал. Одна из возможных причин: заблокирован обратный вызов на localhost, по умолчанию порт 1455. Что делать: выполните codex login --device-auth или войдите на компьютере с браузером и скопируйте оттуда ~/.codex/auth.json, по документации входа. Файл хранит токены, поэтому не пересылайте его по чужим каналам.
• Ошибка 401 Unauthorized. Прочитайте подробное сообщение: оно может указывать на недействительные данные входа, неверный API-ключ, отсутствие доступа к организации или ограничение по IP-адресу. Если вы входите через ChatGPT, выполните codex logout, затем codex login; codex login status покажет активный способ входа. Другие коды: ошибки Codex и как их исправить.
• Нет доступа к CLI или расширению. Причина: на Free и Go Codex доступен только в десктопном приложении, по странице тарифов. Что делать: работайте в приложении или перейдите на Plus; порядок подключения: как подключить Codex.
• Команда codex не находится. Частая причина: терминал открыт до установки или не подхватил PATH; возможно и то, что установка не завершилась. Что делать: откройте новое окно терминала и проверьте codex --version; на macOS и Linux затем command -v codex. Порядок диагностики по этапам: Codex не устанавливается.
• PowerShell запрещает запуск npm. Сообщение npm.ps1 cannot be loaded because running scripts is disabled. Причина: политика выполнения сценариев PowerShell, поломки Codex здесь нет. Что делать: поставьте CLI автономным установщиком из раздела выше или изучите политику по документации Microsoft до её изменения. Особенности системы: установка Codex на Windows.
• Приложение не ставится из Microsoft Store. Возможная причина: магазин недоступен на этом компьютере или в вашей сети. Что делать: установите приложение командой winget install --id 9PLM9XGG6VKS -s msstore, если источник Microsoft Store доступен; сам недоступный источник эта команда не обходит. Другие способы получить приложение: скачать Codex.
• Страницу входа перехватывает корпоративный прокси. Причина: прокси подменяет сертификат. Что делать: задайте переменную CODEX_CA_CERTIFICATE с путём к PEM-файлу сертификата до входа; если её нет, Codex использует SSL_CERT_FILE, по документации входа. Сети и прокси: настройка прокси для Codex.

Если вы не в России

Если вы подключаетесь из страны, которая входит в список поддерживаемых стран ChatGPT, сначала попробуйте прямое соединение: приложение, CLI и расширение входят через обычный аккаунт ChatGPT или API-ключ. Настройки прокси и сертификатов могут понадобиться из-за ограничений вашей сети, независимо от страны. Строку про 403 по стране и ответ о России в вопросах ниже можно пропустить.

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

Можно ли установить Codex бесплатно?

Да, сами приложение, CLI и расширение скачиваются бесплатно. Но на Free и Go за 8 долларов в месяц Codex доступен только в десктопном приложении с GPT-6 Luna по мере развёртывания; веб, CLI, расширение IDE и iOS доступны с Plus за 20 долларов в месяц, по странице тарифов. При выборе тарифа учитывайте лимиты; им посвящён материал о бесплатном использовании Codex.

Что выбрать: приложение, CLI или облако?

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

Нужен ли программистский опыт, чтобы поставить Codex?

Для приложения не нужен: установка такая же, как у любой другой программы, а задачи агенту ставятся обычными словами. Для CLI выполните команду автономного установщика в терминале; Node.js нужен только при установке через npm, по инструкции CLI. Это посильно и без программирования.

Работает ли Codex из России?

Россия не входит в списки стран, где OpenAI поддерживает ChatGPT и API; сама установка этого не меняет. Способы оформить и оплатить тариф из РФ собраны в отдельном гайде про покупку Codex из России.

Что собрать на Codex первым

За вечер на Codex реально собрать сайт-визитку: для себя, своего дела или знакомого мастера, которому давно нужна страница с ценами и записью. Начните с пошаговой инструкции как сделать сайт с помощью ИИ.

Другой вариант первого проекта: телеграм-бот, который отвечает на вопросы и принимает заявки. Для сборки без программирования есть инструкция как создать бота бесплатно.