Codex на Windows: приложение и CLI

Проще всего поставить Codex на Windows через приложение ChatGPT: Codex там отдельный режим. Допустим, у вас Windows-ноутбук и проект, который вы хотите отдать агенту. Вы открываете инструкцию и видите три способа: приложение из Microsoft Store, командную строку в PowerShell или командную строку внутри WSL 2.

Если вам нужен графический интерфейс, берите приложение. Если вы привыкли к терминалу, ставьте CLI одной командой в PowerShell. WSL нужен тем, чья разработка уже живёт в Linux-окружении. Что такое Codex и чем он отличается от других агентов, написано в общем руководстве по Codex, а здесь разберём установку на Windows, вход и ошибки.

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

На ноутбуке с проектом выбор упирается в вопрос, где вы хотите работать: в окне с чатами или в терминале. Но сначала про безопасность. У Codex на Windows есть песочница, которая ограничивает файлы и сеть для команд агента. Приложение и CLI в PowerShell работают с ней нативно, без WSL и виртуальной машины, а внутри WSL 2 Codex использует песочницу Linux.

Способ	Требования	Плюсы	Минусы	Песочница
Приложение ChatGPT (режим Codex)	Windows 10 версии 19041 или новее по карточке Microsoft Store, Windows 11 рекомендуется; в Store указана платформа x64	Параллельные чаты, worktrees, задачи по расписанию, Git, встроенный браузер, просмотр файлов, плагины и навыки	Без Git часть функций недоступна; весит около 950 МБ по данным Store	Нативная Windows-песочница в PowerShell; агента можно переключить на WSL 2 в настройках
CLI в PowerShell	Windows 11 рекомендуется; Windows 10 как «best effort» (без гарантий), нужна версия 1809 или новее; в релизах есть сборки x64 и ARM64	Одна команда, без Node.js в инструкции установщика, удобно для скриптов и codex exec	Работа только в терминале; для безопасного режима нужна подходящая песочница	Нативная: mxc, при её отсутствии elevated или unelevated
CLI в WSL 2	Установленный WSL 2 с Linux-дистрибутивом (например Ubuntu); WSL 1 не поддерживается с версии 0.115	Linux-инструменты, привычное окружение, быстрая работа с файлами в домашней папке Linux	Отдельный дом для настроек: вход и сессии не общие с приложением; репозиторий нужно держать в Linux-каталоге	Linux-песочница (bubblewrap)

В таблице видно, чем платите за каждый способ: приложение тяжелее, терминал аскетичнее, WSL требует отдельного Linux-окружения. OpenAI советует по умолчанию брать нативную песочницу Windows, а WSL выбирать, когда нужны Linux-инструменты или рабочий процесс уже в WSL 2.

Подойдёт ли ваш компьютер?

Прежде чем ставить, сверьте ноутбук с этим списком. Так вы не потратите вечер на установку, которая упрётся в версию Windows или в отсутствие Git.

• Windows 11. Рекомендуемая база для Codex. Для корпоративных установок документация советует именно её.
• Windows 10. Работает в режиме «best effort» (без гарантий), менее надёжно, чем 11. Codex нужна современная поддержка консоли (ConPTY), поэтому на практике нужна версия 1809 или новее. Карточка приложения в Microsoft Store требует Windows 10 версии 19041 или выше, ориентируйтесь на неё, если ставите приложение.
• Архитектура. В карточке приложения в Store указана платформа x64. У CLI в релизах на GitHub есть сборки для Windows на x64 и ARM64. Работает ли приложение на ARM64-компьютерах, в документации не сказано.
• winget. Документация предполагает, что менеджер пакетов Windows есть в системе. Если его нет, обновите Windows или установите Windows Package Manager.
• Node.js. Для установщика PowerShell и приложения в документации он не требуется. Нужен только для установки через npm. Минимальную версию Node.js документация не называет.
• Git. Желателен: без него приложение не показывает панель проверки изменений и часть других функций. Ставится командой winget install Git.Git.

Отдельно про песочницу нового поколения: для режима MXC нужна Windows 11 24H2 (сборка 26100.9278) или 25H2 (сборка 26200.9278) с возможностями Microsoft Execution Containers. Если их нет, Codex сам переходит на старые режимы песочницы, так что ноутбук без этих сборок не помеха.

Как поставить приложение ChatGPT с Codex?

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

1. Установите приложение. Вариант в PowerShell: winget install --id 9PLM9XGG6VKS -s msstore. Вариант без командной строки: страница chatgpt.com/download или карточка в Microsoft Store.
2. Откройте приложение и нажмите Continue to sign in. Вход пройдёт в браузере.
3. Добавьте проект: Add new project или Ctrl+O, выберите папку.
4. Создайте чат и выберите Codex в списке над полем ввода. Чтобы песочница работала, выберите Ask for approval под полем ввода до отправки сообщения.
5. Поставьте Git: winget install --id Git.Git. Для GitHub-функций добавьте GitHub CLI (winget install --id GitHub.cli) и выполните gh auth login.

Когда базовая установка позади, документация OpenAI предлагает поставить одной пачкой Git, Node.js LTS, Python, .NET SDK и GitHub CLI через winget. Агент работает быстрее, когда эти инструменты уже есть.

Как не поставить подделку из Store?

В Microsoft Store по запросу «Codex» встречаются приложения с похожими названиями от других издателей, и легко нажать не туда. Официальная карточка называется «ChatGPT», издатель OpenAI, идентификатор 9PLM9XGG6VKS. На этот идентификатор ведёт ссылка из документации OpenAI, а пакет в карточке называется OpenAI.Codex. Описание в Store прямо говорит, что Codex в приложении это агент для разработки.

Проверьте две вещи: в графе издателя стоит OpenAI, а идентификатор в адресе карточки совпадает с 9PLM9XGG6VKS. Если хоть одно не совпало, это не приложение OpenAI. Безопаснее ставить по ссылке из документации или командой winget выше, а ввод логина и пароля ChatGPT оставлять только в браузерном окне входа.

Как поставить CLI в PowerShell?

Если приложение вам не нужно, этот путь короче: одна команда стандартного установщика OpenAI. Документация просит запускать её в новом окне PowerShell.

1. Откройте новое окно PowerShell. Права администратора для этой команды не названы обязательными.
2. Выполните: powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
3. Закройте и откройте PowerShell заново, перейдите в папку проекта и введите codex.
4. При первом запуске выберите Sign in with ChatGPT или другой доступный способ входа.

Обновляется CLI той же командой. По README репозитория, установщик скачивает файлы с releases.openai.com, а при сбое берёт их из GitHub Releases. Если хотите сразу брать из GitHub, задайте $env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false' перед запуском.

Через npm. Есть и альтернатива: npm install -g @openai/codex. Она подойдёт, если Node.js у вас уже настроен. Но на Windows при этом можно упереться в политику выполнения скриптов PowerShell, разбор в таблице ошибок ниже. Команды winget для самого CLI в документации нет: winget в ней нужен для приложения и вспомогательных инструментов.

Как поставить CLI в WSL 2?

Этот путь для тех, чей проект уже лежит в Linux-окружении или кому нужны Linux-инструменты. Если вы не из них, вернитесь к PowerShell.

1. Откройте PowerShell от имени администратора и выполните wsl --install. По умолчанию ставится Ubuntu.
2. Запустите оболочку командой wsl.
3. Внутри Linux выполните: curl -fsSL https://chatgpt.com/codex/install.sh | sh, затем codex.
4. Держите репозитории в домашней папке Linux (например ~/code/my-app), а не в /mnt/c/...: так быстрее и меньше проблем с правами и симлинками.

Агент приложения тоже можно перенести в WSL 2. Для этого в настройках переключите агента с Windows native на WSL и перезапустите приложение, иначе изменение не вступит в силу.

Учтите, что настройки у приложения и у WSL разные. Конфигурация приложения лежит в %USERPROFILE%\.codex, а CLI внутри WSL использует домашний каталог Linux, поэтому вход и история сессий не общие. Чтобы объединить их, задайте в WSL переменную: export CODEX_HOME=/mnt/c/Users/<имя>/.codex.

Как войти: аккаунт ChatGPT или API-ключ?

Приложение, CLI и расширение для IDE поддерживают оба способа. Облачный Codex работает только со входом через ChatGPT. Выбор зависит от того, за что вы готовы платить: за подписку или за каждый запрос.

• Аккаунт ChatGPT (по подписке). В приложении: Continue to sign in. В CLI: codex login. Вход проходит в браузере.
• API-ключ (оплата по тарифам API). В приложении: Sign in another way, вставить ключ, Continue. В CLI: printenv OPENAI_API_KEY | codex login --with-api-key (в Linux и WSL). Ключ берут в панели OpenAI, на странице platform.openai.com/api-keys.

Что даёт подписка, видно на странице тарифов Codex. Планы Free и Go дают Codex в настольном приложении, а CLI и расширение для IDE перечислены начиная с Plus (20 долларов в месяц). С API-ключом облачных функций нет: ни проверки кода на GitHub, ни интеграции со Slack. Подробно о лимитах рассказано в материале про лимиты Codex.

Заработает ли это в России?

Вопрос законный, раз вы читаете это из России. Россия не входит в официальный список стран и территорий API OpenAI, и российские карты для оплаты не принимаются. Как платить за ChatGPT, мы разбирали в отдельной статье: как оплатить Claude и ChatGPT из России.

Что делает песочница на Windows?

Песочница определяет, какие папки Codex может читать и менять и есть ли у команд доступ к сети. Для вашего проекта это граница, за которую агент не выйдет. Одобрения команд настраиваются отдельно. Документация называет три реализации.

Режим	Что это	Когда используется
mxc	Нативная изоляция процессов, без одобренной администратором настройки, без новых учётных записей и правил брандмауэра	Рекомендуется, если устройство поддерживает (Windows 11 24H2 или 25H2 нужных сборок)
elevated	Отдельные пользователи с урезанными правами, правила брандмауэра; нужна настройка с одобрением администратора. Команды запускаются без прав администратора	Предпочтительный запасной вариант, когда MXC нет
unelevated	Ограниченный токен вашего пользователя и ACL; изоляция сети слабее, запретов на чтение путей нет	Запасной вариант, если настройка elevated заблокирована политикой

Из таблицы нужно запомнить порядок: сначала mxc, потом elevated, и только в крайнем случае unelevated. Приложение само выбирает MXC для личных аккаунтов, если устройство его поддерживает. В CLI режим включается в config.toml: [features] и prefer_mxc = true. Запасной режим задаётся так: [windows] и sandbox = "elevated" (или "unelevated").

Режим полного доступа убирает ограничения по папкам проекта и может привести к потере данных. Поэтому держите песочницу включённой, а исключения делайте через правила.

Что делать, если установка не пошла?

Если на вашем ноутбуке что-то упало, скорее всего, это одна из ошибок ниже. Таблица составлена по страницам документации OpenAI для приложения, песочницы и WSL.

Проблема	Причина	Что делать
npm.ps1 cannot be loaded because running scripts is disabled on this system	Политика выполнения PowerShell блокирует скрипты	Прочитайте руководство Microsoft по политикам выполнения; документация OpenAI называет частое решение Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
Настройка песочницы elevated не завершилась	Отклонён запрос UAC; запрещено создание локальных пользователей или правил брандмауэра; заблокированы права входа; корпоративная политика	Повторите настройку и подтвердите запрос администратора; на рабочем ноутбуке спросите ИТ; если политика разрешает, временно используйте unelevated
Ошибка Windows 1385 при запуске команд в песочнице	Windows запрещает тип входа, нужный пользователям песочницы	Попросите ИТ выдать этим пользователям права входа; для работы используйте unelevated; при обращении приложите CODEX_HOME/.sandbox/sandbox.log
Предупреждение «папки доступны на запись для Everyone»	Права на папки слишком широкие, песочница не может их защитить	Уберите запись для Everyone там, где это уместно, и перезапустите Codex
Команды в песочнице не выходят в сеть	Режим прав намеренно запрещает сеть	Проверьте режим, перезапустите Codex; если не помогло, соберите журнал песочницы
Песочница работала и перестала	Переносили репозиторий, менялись права или политики Windows	Перезапустите Codex; для MXC повторите проверочную команду, для elevated повторите настройку
Не работают функции Git в приложении	Git не установлен в Windows	winget install Git.Git
Git не определяется у проекта из \\wsl$	Нативный агент плохо работает с проектами внутри файловой системы WSL	Храните проект на диске Windows и открывайте из WSL через /mnt/<диск>/...
Расширение для IDE установлено, но не отвечает	Не хватает инструментов C++	Поставьте Visual Studio Build Tools (рабочая нагрузка C++) и Visual C++ Redistributable x64, например winget install --id Microsoft.VisualStudio.2022.BuildTools -e, затем полностью перезапустите VS Code
Команда codex не найдена в WSL	Бинарник не установлен или не в PATH	Проверьте which codex, при необходимости повторите установку командой для WSL
Большие репозитории тормозят в WSL	Проект лежит в /mnt/c	Перенесите его в домашнюю папку Linux; обновите WSL: wsl --update, затем wsl --shutdown
Нужны права администратора для агента	Приложение запущено от обычного пользователя	Запустите приложение через «Запуск от имени администратора»: агент унаследует права

Если проблема остаётся, OpenAI просит прислать файл CODEX_HOME/.sandbox/sandbox.log, версию Windows, выбранный режим песочницы и текст ошибки. Содержимое папки .sandbox-secrets отправлять нельзя.

Что делать после установки?

Вернёмся к вашему ноутбуку и проекту. Проверьте, что codex запускается в папке проекта, и поставьте Git-контрольную точку перед первой задачей: так любую правку можно откатить. Сравнение с другим агентом: Claude Code или Codex. Если вы ещё присматриваетесь к альтернативе, установка у неё устроена похоже: Claude Code на Windows. А когда установка позади, пригодятся навыки (skills): в Codex они тоже есть, а как их писать, показано на примере Claude Code.

Перед установкой сверьте то, что быстро меняется. Актуальные лимиты смотрите на странице тарифов. Условия сервиса и список стран проверяйте на сайте OpenAI. Данные в статье даны по документации на середину октября 2026 года, тогда последняя версия в репозитории openai/codex была 0.163.0 от 15 октября.

О чём ещё спрашивают?

Как установить Codex на Windows проще всего?

Если нужен интерфейс: winget install --id 9PLM9XGG6VKS -s msstore и вход через аккаунт ChatGPT. Если нужен терминал: одна команда установщика в новом окне PowerShell, затем codex.

Есть ли отдельное приложение Codex?

В документации Codex встроен в настольное приложение ChatGPT. В Microsoft Store оно называется «ChatGPT», издатель OpenAI. Режим Codex выбирается внутри приложения.

Работает ли Codex на Windows 10?

Документация относит свежую и полностью обновлённую Windows 10 к режиму «best effort» (без гарантий) и требует версию 1809 или новее. Для приложения карточка Store требует версию 19041 или выше. Windows 11 рекомендуется.

Нужен ли Node.js?

Для приложения и установщика PowerShell в документации он не указан. Node.js нужен для установки через npm: npm install -g @openai/codex.

Что выбрать: PowerShell или WSL?

По документации, по умолчанию берите нативную Windows-песочницу. WSL 2 выбирайте, если вам нужны Linux-инструменты или проекты уже лежат в WSL.

Можно ли войти в Codex по API-ключу?

Да, приложение и CLI это поддерживают. Облачные функции при этом недоступны, оплата идёт по тарифам API. Вход через ChatGPT нужен для облачного Codex.

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

Россия не входит в список стран API OpenAI, российские карты не принимаются. Условия смотрите на сайте OpenAI, а про оплату читайте здесь.

Поддерживается ли WSL 1?

Нет. WSL 1 работал до версии Codex 0.114, с версии 0.115 песочница Linux перешла на bubblewrap, и нужен WSL 2.