Как установить Codex на Windows: четыре способа
Опубликовано · Обновлено · 12 мин чтения
Codex на Windows ставится четырьмя основными способами: приложением ChatGPT из Microsoft Store, консольным Codex CLI одной командой в PowerShell, через npm или внутри WSL2. WSL обязателен только для последнего. Node.js нужен только при установке через npm.
Все команды ниже взяты из документации OpenAI и репозитория openai/codex, данные на 2 октября 2026 года.
Какой способ установки Codex на Windows выбрать?#
| Способ | Кому подходит | Команда | Что нужно заранее |
|---|---|---|---|
| Приложение ChatGPT для Windows | нужно окно с проектами, а не терминал | winget install --id 9PLM9XGG6VKS -s msstore или Microsoft Store | Microsoft Store или winget |
| Codex CLI в PowerShell | тем, кто работает в терминале и с Windows-проектами | скрипт install.ps1 одной строкой в PowerShell, команда в разделе ниже | PowerShell, Node.js не нужен |
| Codex CLI через npm | Node.js уже стоит, и консольные инструменты удобнее держать в npm | npm install -g @openai/codex | Node.js 16 или новее по package.json |
| Codex CLI внутри WSL2 | тем, у кого репозитории и инструменты живут в Linux | скрипт install.sh в оболочке WSL, команда в разделе про WSL | установленный WSL2 |
Ограничений вида «на Windows только через WSL» в актуальной документации нет. Если вам попадётся обратное, скорее всего, это старый текст: в файле docs/install.md репозитория всё ещё написано «Windows 11 via WSL2», хотя README и раздел документации про Windows уже дают нативную установку.
Как скачать Codex на ПК из Microsoft Store или через winget#
У OpenAI и в Microsoft Store приложение для Windows называется ChatGPT, а Codex в нём — отдельный раздел: в приложении выбирают ChatGPT или Codex. Идентификатор приложения в Store — 9PLM9XGG6VKS.
Поставить его можно из Store кнопкой или из терминала одной командой winget install --id 9PLM9XGG6VKS -s msstore. В гайдах встречается короткая команда winget install Codex -s msstore. У OpenAI её нет, установка идёт по идентификатору, и мы приводим команду оттуда.
Агент в приложении запускается в одном из двух режимов: нативно в Windows или внутри WSL. Режим выбирают в настройках, а после смены приложение перезапускают.
Права агент получает от приложения. Если ему нужно выполнять команды с правами администратора, OpenAI советует запускать само приложение от администратора: найти его в меню «Пуск» и выбрать «Запуск от имени администратора».
Менять регион системы ради Store не советуем. Если Store не открывает страницу, ниже есть CLI, которому Store не нужен.
Установка Codex CLI одной командой в PowerShell#
Для консольного агента у OpenAI есть установочный скрипт для Windows. Откройте PowerShell и выполните одну строку из README репозитория openai/codex.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
irm скачивает скрипт install.ps1 с адреса OpenAI, iex его выполняет, а ключ -ExecutionPolicy ByPass снимает запрет на запуск скриптов только для этого одного процесса PowerShell. Системную политику выполнения команда не меняет.
После установки откройте новое окно терминала и запустите codex. Если команда находится, установка прошла. Если PowerShell отвечает, что такой команды нет, разбор есть в таблице ошибок ниже.
Для обновления CLI на Windows OpenAI предлагает повторно выполнить ту же команду с install.ps1. Если CLI стоит через npm, обновление — тот же npm install -g @openai/codex.
Помимо четырёх способов из таблицы, есть готовые сборки на странице последнего релиза в GitHub-репозитории openai/codex.
Нужен ли Node.js и когда ставить Codex через npm?#
Через npm Codex ставится командой npm install -g @openai/codex. В package.json пакета записано node >=16, это же поле видно в реестре npm у версии 0.160.0. В части гайдов встречается требование «Node.js 22+». Источник этого требования неясен: в файлах OpenAI такого числа нет. Если Node.js у вас свежий, вопрос снимается сам.
У npm на Windows есть своя ловушка. В PowerShell с политикой выполнения по умолчанию команда npm может упасть с ошибкой npm.ps1 cannot be loaded because running scripts is disabled on this system. Её выдаёт PowerShell, который запрещает запуск скриптов, в том числе npm.ps1. OpenAI предлагает выставить Set-ExecutionPolicy -ExecutionPolicy RemoteSigned и перед этим прочитать руководство Microsoft о политиках выполнения. Команда меняет правила для всех скриптов в системе, npm лишь один из них.
В трёх случаях WSL2 всё-таки нужен#
Эти случаи перечисляет OpenAI:
- вам нужны инструменты, которые есть только в Linux;
- репозитории и весь рабочий процесс у вас уже живут в WSL2;
- ни один режим нативной песочницы Windows на вашей машине не заработал.
Чтобы поставить CLI в WSL, откройте PowerShell или Windows Terminal от имени администратора и выполните wsl --install, затем wsl. Уже в оболочке Linux поставьте CLI командой curl -fsSL https://chatgpt.com/codex/install.sh | sh и запустите codex.
Где держать проекты, зависит от того, где работает агент. Для CLI внутри WSL OpenAI советует домашнюю папку Linux: работа в смонтированных путях Windows вида /mnt/c/... идёт медленнее и чаще спотыкается о символические ссылки и права. Для приложения с нативным агентом совет обратный. Сам WSL обновляется командами wsl --update и wsl --shutdown.
| Как вы работаете | Где держать проект | Как открыть |
|---|---|---|
| Codex CLI внутри WSL | в домашней папке Linux, например ~/code/my-app | из оболочки WSL |
| Приложение, проект уже лежит в WSL | в дистрибутиве Linux | в приложении добавить проект (или Ctrl+O) и ввести в проводнике путь \\wsl$\ |
| Приложение с нативным агентом, проект нужен и в WSL | на диске Windows | в WSL через /mnt/<диск>/...; у проектов, открытых через \\wsl$, Git может не определиться |
WSL1 не подходит. Он поддерживался до версии Codex 0.114, а с версии 0.115 песочница Linux перешла на bubblewrap, и WSL1 поддерживать перестали. Если wsl -l -v показывает у вашего дистрибутива версию 1, сначала переведите его на WSL2.
Требования к Windows и права администратора для песочницы#
OpenAI рекомендует Windows 11. На Windows 10 Codex работает менее надёжно и опирается на псевдоконсоль ConPTY, поэтому нужна версия 1809 или новее.
| Условие | Что говорит документация OpenAI |
|---|---|
| Windows 11 | рекомендуемая система |
| Windows 10 | версия 1809 или новее, работает менее надёжно, чем на Windows 11 |
| Windows 10 старше 1809 | не рекомендуется |
| winget | должен быть в системе; если его нет, обновить Windows или поставить Windows Package Manager до установки Codex |
| Права администратора для установки CLI скриптом | в документации не требуются |
| Права администратора для песочницы | основной режим настраивается с подтверждением контроля учётных записей (UAC) |
| Запуск приложения от администратора | только если агенту нужны команды с правами администратора |
Песочница ограничивает, что агент может делать в системе, пока выполняет ваши задачи: она не даёт ему писать файлы вне рабочей папки и выходить в сеть без вашего разрешения. Режимов у неё два, они задаются в файле config.toml.
| Режим | Строка в config.toml | Как изолирует | Нужен администратор | Когда работает |
|---|---|---|---|---|
| Основной | [windows] sandbox = "elevated" | отдельные пользователи с урезанными правами, границы доступа к файлам, правила брандмауэра | да, настройку подтверждает UAC | предпочтительный, если доступны оба режима |
| Запасной | [windows] sandbox = "unelevated" | урезанные права текущего пользователя, границы доступа к файлам через списки прав, изоляция сети слабее | нет; режим для машин, где политика запрещает настройку от администратора | если основной режим не встал, Codex переходит на него сам |
Основной режим, по документации, не встаёт в пяти случаях:
- вы отклонили запрос контроля учётных записей;
- на машине нельзя создавать локальных пользователей или группы;
- нельзя менять правила брандмауэра;
- корпоративная политика не пускает пользователей песочницы в систему;
- другая корпоративная политика блокирует часть настройки.
Первый запуск Codex и где упирается вход из России#
При первом запуске codex предлагает войти через аккаунт ChatGPT. Этот вход README рекомендует для планов Plus, Pro, Business, Edu и Enterprise. Вход по API-ключу OpenAI настраивается отдельно. Все команды входа собраны в таблице.
| Команда | Что делает |
|---|---|
| codex login | открывает браузер для входа через аккаунт ChatGPT |
| codex login --with-api-key | вход по API-ключу OpenAI вместо аккаунта ChatGPT |
| codex login --device-auth | вход по коду устройства для машины без браузера; бета, сначала включить в настройках безопасности ChatGPT |
| codex login status | показывает, каким способом вы вошли |
| codex logout | выход из аккаунта |
Данные входа Codex хранит либо в файле ~/.codex/auth.json (на Windows это папка %USERPROFILE%\.codex), либо в хранилище учётных данных системы. OpenAI просит обращаться с этим файлом как с паролем, то есть не коммитить в репозиторий и никому не передавать.
Шаги установки у OpenAI от страны не зависят, команды одинаковы везде. Скрипты установки скачиваются с chatgpt.com. Доступ к API OpenAI из России не разрешён: в списке стран, где OpenAI разрешает доступ к своему API, России нет (данные на 2 октября 2026 года), и OpenAI предупреждает, что доступ из стран вне списка может закончиться блокировкой аккаунта. Для входа через ChatGPT у OpenAI отдельный список стран, проверьте его перед оплатой.
Получится ли запустить Codex из России, это отдельный вопрос. Аккаунт и оплату разбирает статья Codex в России, там документы OpenAI со ссылками и датами. Сколько запросов даёт каждый план, собрано в статье про лимиты и тарифы Codex. Инструкций по обходу и оплате через посредников нет ни там, ни здесь.
Что делать при ошибках установки Codex на Windows#
| Симптом | Причина | Что сделать | Откуда решение |
|---|---|---|---|
| npm.ps1 cannot be loaded because running scripts is disabled on this system | PowerShell запрещает запуск скриптов, npm запускается как скрипт | прочитать руководство Microsoft о политиках, затем Set-ExecutionPolicy -ExecutionPolicy RemoteSigned | документация OpenAI |
| После установки codex не находится | терминал открыт до установки и не видит обновлённый PATH | закрыть и открыть терминал заново, проверить Get-Command codex | рекомендация редакции, стандартная команда PowerShell |
| Codex медленно работает с проектом в WSL | проект лежит в /mnt/c/... | перенести репозиторий в домашнюю папку Linux, например ~/code/my-app | документация OpenAI |
| Codex в WSL не работает | дистрибутив на WSL1, поддержка закончилась с версии 0.115 | перевести дистрибутив на WSL2 | документация OpenAI |
| Песочница работает в запасном режиме | отклонён запрос UAC или корпоративная политика запрещает создавать пользователей, менять брандмауэр или другую часть настройки | разрешить настройку от администратора или согласовать с ИТ-отделом | документация OpenAI |
| winget не найден | старая сборка Windows без Windows Package Manager | обновить Windows или поставить Windows Package Manager | документация OpenAI |
Ошибок входа в таблице нет. Они зависят от аккаунта, страны и плана, это тема статьи Codex в России.
Источники команд#
Документация Codex переехала: старые адреса на developers.openai.com перенаправляют на learn.chatgpt.com. Источник каждой таблицы указан в её подписи. Кроме них использованы страницы learn.chatgpt.com/docs/cli (обновление CLI) и learn.chatgpt.com/docs/app (выбор ChatGPT или Codex в приложении), package.json пакета @openai/codex (версия Node.js), сам скрипт chatgpt.com/codex/install.ps1 (архитектуры Windows) и список стран API developers.openai.com/api/docs/supported-countries (России в нём нет). Данные на 2 октября 2026 года. Команды у OpenAI меняются, перед установкой сверьте строку с README.
Та же задача в WorkAI на Windows#
Если Codex нужен ради агента, который работает с вашим проектом, WorkAI решает ту же задачу внутри IDE. Его агент читает проект, правит файлы и запускает команды. WorkAI — российская IDE, она ставится обычным установщиком .exe на Windows 10 и новее, без WSL, Node.js и Microsoft Store. Оплата в рублях, VPN не нужен.
Начать можно бесплатно и без карты. Модель WorkAI Free в списке моделей даёт пул открытых моделей бессрочно, это не пробный период.
Тариф Free добавляет 300 Ⓦ бонусом после регистрации и подтверждения почты. На 2 октября 2026 года бонус открывает в списке моделей Haiku 4.5, GPT-6 Luna, Grok 4.6, Grok 4.7 и Grok Build 0.1. Sonnet, Opus, старшие GPT-6 и GPT-5.3 Codex на бонусе закрыты. Тратить бонус можно не больше 100 Ⓦ в сутки, после приветственного периода он раз в месяц пополняется до 100 Ⓦ.
Если у вас есть ключ от любого API, совместимого с OpenAI, его можно подключить в WorkAI. Запросы по своему ключу WorkCoins не списывают.
Отдельного консольного агента, который ставится одной командой, в WorkAI нет, агент работает внутри IDE. Если нужен именно агент в терминале, варианты разобраны в статье про аналоги Claude Code.
Установщик для Windows, бесплатно и без карты.
Скачать WorkAI для WindowsЧастые вопросы
Нужен ли WSL для Codex на Windows?
Нет. Приложение ChatGPT и CLI из install.ps1 работают в Windows нативно. Три случая, когда WSL2 всё же нужен, перечислены в разделе про WSL2.
Что делать, если Node.js на машине старше 16?
Ставить CLI скриптом install.ps1 в PowerShell, ему Node.js не нужен. Либо обновить Node.js и ставить через npm.
Поставится ли Codex на Windows 10 старше 1809?
OpenAI такую версию не рекомендует: Codex опирается на псевдоконсоль ConPTY. Сначала обновите Windows.
Что делать, если Microsoft Store не открывает страницу приложения?
Поставить CLI: скрипту install.ps1, npm и готовым сборкам со страницы релизов openai/codex Store не нужен.
Что будет, если на рабочем ноутбуке нельзя подтвердить UAC?
CLI всё равно поставится, потому что скрипту установки права администратора не нужны. Не настроится основной режим песочницы, и Codex сам перейдёт на запасной, где изоляция сети слабее.
Поставится ли Codex CLI на Windows для ARM?
Да. Скрипт install.ps1 сам определяет архитектуру и ставит сборку для x64 или ARM64. На 32-битной Windows он останавливается с ошибкой, Codex нужна 64-битная система (по тексту скрипта установки, данные на 2 октября 2026 года).
Нужен ли install.sh на Windows?
Только внутри WSL2: он ставит Codex в Linux-дистрибутив. В самой Windows ставят install.ps1 из PowerShell.
Можно ли войти в Codex по API-ключу из России?
По документам OpenAI нет: России нет в списке стран, где разрешён доступ к API (данные на 2 октября 2026 года). Подробно — в статье Codex в России.
Есть ли похожий агент для Windows без зарубежного аккаунта?
Да, WorkAI: российская IDE с ИИ-агентом и оплатой в рублях.