Как установить Codex на Windows: есть три пути - приложение ChatGPT с режимом Codex, CLI одной командой в PowerShell и CLI внутри WSL2. Нужен интерфейс с окном - бери приложение. Нужна команда codex в терминале - ставь CLI нативно, WSL2 нужен только проектам на Linux. После установки проверь версию, войди в аккаунт и запусти агента из папки проекта.
Команды и условия сверены с официальной документацией OpenAI и текстом установщика 29 октября 2026 года. На Windows я этот путь не проходил: установка, вход и первая задача здесь не выполнялись, поэтому снимков PowerShell в статье нет.
Как установить Codex на Windows: какой путь выбрать
Сначала реши, что тебе нужно: от этого зависит, как установить Codex на Windows и какой тариф ChatGPT потребуется.
| Путь | Что нужно заранее | Какой тариф | Кому подходит | Куда идти |
|---|---|---|---|---|
| Приложение ChatGPT с Codex | Аккаунт ChatGPT, Microsoft Store | Free и Go (по мере раскатки), Plus и выше | Нужны окно, чаты и просмотр правок | Раздел про приложение |
| CLI в PowerShell | PowerShell, winget |
Plus и выше или вход по API-ключу | Нужна команда codex в терминале |
Шаги 1-4 |
| CLI в WSL2 | WSL2 и Linux-оболочка | Как у CLI | Проект уже живёт в Linux | Раздел про WSL2 |
Тарифы взяты со страницы условий OpenAI на 29 октября 2026 года; цены не привожу, они меняются. Про оплату читай отдельную инструкцию.
Вставил команду и увидел ошибку про irm? Это CMD вместо PowerShell, разбор ниже в шаге 1.
Codex - агент OpenAI для работы с кодом: он читает файлы, предлагает правки и выполняет команды. Историю приложения и его связь с ChatGPT разбираю в отдельной статье. Установку на macOS и Linux и расширения для редакторов разбираю в статье как установить Codex.
Как установить Codex на Windows через приложение ChatGPT
Это самый короткий вариант, как установить Codex на Windows без терминала. В документации приложение называется ChatGPT desktop app, Codex живёт внутри него.
-
Скачай. Открой страницу Windows-приложения и нажми Download the ChatGPT desktop app: кнопка ведёт на установщик Microsoft Store. Из PowerShell то же делает команда
winget install --id 9PLM9XGG6VKS -s msstore. -
Войди в аккаунт ChatGPT.
-
Выбери Codex. В приложении переключись с ChatGPT на Codex и начни с New chat (так описывает быстрый старт OpenAI).
-
Добавь проект. Кнопка Add new project или Ctrl + O открывает окно выбора папки.
-
Включи песочницу. Под полем ввода выбери Ask for approval до первого сообщения: так, по документации, включаются защиты и в нативном режиме, и в WSL2.
-
Права администратора. Если агенту нужны повышенные права, запусти само приложение через «Пуск» командой Run as administrator: агент наследует этот уровень.
Из терминала приложение открывает codex app: если приложения нет, команда запускает установщик. Путь к папке проекта на Windows она только печатает - открой эту папку в приложении. Git ставь заранее (winget install Git.Git): он питает панель проверки правок.
Шаг 1. Открой PowerShell и запусти установщик
Это основной ответ на вопрос, как установить Codex на Windows в виде CLI. Нажми «Пуск», набери Windows PowerShell и открой найденную оболочку. В Windows Terminal выбери в меню новой вкладки профиль PowerShell: там же открываются CMD и Linux в WSL, поэтому перед вводом команды проверь, какая оболочка открыта.
Проверь систему:
winver
winget --versionПервая команда откроет сведения о Windows, вторая выведет версию пакетного менеджера. Для нативного режима OpenAI рекомендует Windows 11; полностью обновлённая Windows 10 версии 1809 и новее поддерживается по принципу best effort: работа в конкретной конфигурации не гарантируется. Документация предполагает, что winget уже установлен. Если его нет, поставь Windows Package Manager по инструкции Microsoft или обратись к администратору рабочего компьютера.
Команда для Codex CLI из официального README OpenAI:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Скопируй строку целиком, сохрани прямые кавычки и начальное powershell. Команда получает установщик с chatgpt.com и запускает его. Node.js для этого пути не нужен.
irm - короткое имя (alias) команды Invoke-RestMethod, а iex - Invoke-Expression. Первая получает текст по адресу, вторая его исполняет. Перед запуском проверь адрес: это выполнение скачанного скрипта.
Параметр -ExecutionPolicy ByPass относится к запущенной сессии PowerShell и не меняет постоянную политику в реестре. Не ставь глобальную политику Unrestricted ради этой инструкции. На рабочем устройстве установку могут ограничивать правила организации - такой отказ разбирай с администратором.
Что напишет установщик
Окно заполнится английскими строками. По тексту скрипта install.ps1 (снят 29 октября 2026 года, запускать его для чтения не нужно) главное такое:
| Строка в окне | Что это значит | Что делать |
|---|---|---|
Installing Codex CLI или Updating Codex CLI from ... to ... |
Первая установка или обновление: повторный запуск той же команды обновляет CLI | Ничего |
Detected platform: Windows (x64) или Windows (ARM64) |
Установщик выбрал сборку под твой процессор | Ничего |
Codex requires a 64-bit version of Windows. |
Windows 32-битная, установка остановлена | Нужна 64-битная Windows |
releases.openai.com is unavailable; falling back to GitHub Releases. |
Основной сервер не ответил, архив берётся с GitHub | Подожди, это не ошибка |
Detected existing npm-managed Codex at ... (или bun-managed) и вопрос Uninstall the existing npm-managed Codex now? |
Найден Codex, поставленный через npm или bun; какой запустится, решает порядок в PATH | Оставь одну установку |
PATH updated for future PowerShell sessions. |
Папка добавлена в PATH пользователя | Открой новое окно |
Codex CLI ... installed successfully. и Start Codex now? |
Готово; согласие сразу запустит codex |
Ответь на своё усмотрение |
По тексту скрипта codex.exe попадает в %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, а рабочие файлы Codex - в %USERPROFILE%\.codex. Перед распаковкой установщик сверяет контрольную сумму SHA-256 архива. Права администратора ему не нужны.
Ошибка «irm не является внутренней или внешней командой»
Строка ошибки из CMD выглядит так:
"irm" не является внутренней или внешней командой,
исполняемой программой или пакетным файлом.Если ты вставил в CMD только irm https://... | iex, CMD не знает командлеты PowerShell. Установка Codex ещё не началась. Открой PowerShell и вставь полную команду выше, ничего не вырезая из кавычек. Проверить alias можно так:
Get-Alias irmОжидаемый результат - связь irm с Invoke-RestMethod. Если alias не найден или установщик сообщает другую ошибку, сохрани её точный текст: это другая причина, и смена окна её не исправит.
Шаг 2. Проверь версию и путь к программе
После установщика закрой терминал и открой новое окно PowerShell. Установщик меняет PATH пользователя, а уже открытое окно может этого не увидеть. Затем выполни:
codex --versionВерсия в выводе подтверждает, что CLI запускается. Она не подтверждает вход в аккаунт или доступ к модели.
Если PowerShell пишет The term 'codex' is not recognized, проверь, на месте ли файл и что видит система:
Test-Path "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin\codex.exe"
Get-Command codex -All
where.exe codexTest-Path отвечает, лежит ли codex.exe в папке установщика. Get-Command показывает, что PowerShell нашёл под именем codex, а where.exe ищет файлы в текущем каталоге и PATH. PATH - список папок, в которых система ищет программы. Несколько найденных путей означают, что остались разные установки.
Если файла нет, вернись к выводу установщика: ошибка загрузки не лечится выдуманной папкой в PATH. Если файл есть, а команда его не видит, проверь PATH пользователя в настройках переменных среды Windows. Не получается разобраться - codex doctor соберёт отчёт об установке, входе и настройках.
Как обновить: повтори команду установщика или выполни codex update, если установленная версия это умеет.
Шаг 3. Войди в аккаунт и выбери способ доступа
Для входа через ChatGPT выполни:
codex loginЗаверши вход в браузере и дождись подтверждения в терминале. Затем отдельно проверь состояние входа:
codex login statusСтатус показывает активный способ входа. Он не подтверждает доступ к модели и успешную работу с проектом. В документации Authentication вход через ChatGPT отделён от входа по API-ключу: у них разные условия использования и оплаты.
По условиям OpenAI на 29 октября 2026 года, Free и Go дают Codex в десктопном приложении по мере развёртывания. Доступ к CLI указан начиная с Plus; другой вариант для CLI - вход по API-ключу. Скачивание программы не означает, что CLI доступен на твоём тарифе.
Если выбираешь API-ключ, расходы учитываются в OpenAI API отдельно от подписки ChatGPT. Способы оплаты разобраны в статье как оплатить Codex.
Я сам плачу за ChatGPT и Codex картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF
Браузер открылся, но вход не завершился
При обычном входе браузер возвращает результат в CLI на твоём компьютере. Если этот возврат (callback) заблокирован, OpenAI описывает запасной вход по коду устройства:
codex login --device-authЭто beta-вариант. Сначала вход по коду должен быть включён в настройках безопасности личного аккаунта или разрешениях рабочей организации. Затем открой предложенную ссылку и введи одноразовый код. Если организация его не разрешает, командой это ограничение не снимается. Если браузер вход принял, а CLI ответил token exchange failed, варианты этой ошибки разобраны в статье Codex: token exchange failed.
Ошибка country, region, or territory not supported относится к доступности сервиса. Смена способа входа, установка WSL2 и оплата не подтверждают доступность сервиса в твоём регионе. Проверь список поддерживаемых стран OpenAI; сетевые отказы разобраны в статье про доступ к Codex.
Шаг 4. Открой проект и дай первую задачу
Выбери существующую папку с проектом. В примере замени C:\code\my-project своим полным путём:
Set-Location 'C:\code\my-project'
Get-Location
codexGet-Location должен показать нужную папку. Если проект в Git, выполни git status до задачи и после неё: так видно, что агент ничего не менял. Внутри Codex напиши:
Назови текущую папку и перечисли до пяти файлов в ней.
Если есть README.md, прочитай его и объясни назначение проекта.
Если README.md нет, прямо скажи об этом.
Ничего не меняй и не устанавливай зависимости.Сверь названную папку и файлы с Проводником, а ответ о проекте - с README.md. Если README.md отсутствует, сообщение об этом не подтверждает чтение содержимого: выбери один текстовый файл проекта без секретов и попроси объяснить его. Вывод codex --version, статус входа и содержательный ответ на задачу - три отдельные проверки. Если ответ обрывается строкой stream disconnected before completion, причину подскажет текст после двоеточия - он разобран в статье про эту ошибку. Если агент отвечает по нужному проекту, первый запуск состоялся. Настройки разрешений посмотри командой /permissions внутри сессии Codex.
Не запускай агента из корня диска ради проверки установки: ему нужна конкретная рабочая папка. Дальше читай как пользоваться Codex, а для повторяющихся задач подойдут скиллы Codex.
Почему песочница иногда просит администратора
Песочница ограничивает команды агента. На 29 октября 2026 года документация OpenAI описывает три реализации:
| Режим | Когда используется | Нужен ли администратор для настройки |
|---|---|---|
mxc |
Рекомендуется на совместимом устройстве с поддержкой Microsoft Execution Containers | Нет |
elevated |
Предпочтительный прежний вариант, если MXC недоступен или выключен | Да |
unelevated |
Запасной прежний вариант с более слабой изоляцией сети, если elevated недоступен и политика организации разрешает его | Не требует настройки с отдельными пользователями elevated |
Наличие Windows 11 само по себе не подтверждает поддержку MXC: Microsoft ввела её в Windows 11 24H2 (сборка 26100.9278) и 25H2 (сборка 26200.9278) и раскатывает постепенно. Приложение само предпочитает MXC для личных аккаунтов, если устройство это умеет. Проверочная команда есть в разделе MXC compatibility; на Windows здесь она не запускалась.
Для отдельного CLI рекомендация MXC не означает автоматического выбора: раздел Enable MXC описывает включение через features.prefer_mxc = true. Если нужен запасной вариант elevated, настройка в config.toml выглядит так:
[windows]
sandbox = "elevated"Этот вариант использует отдельных пользователей с ограниченными правами и требует одобрения администратора. Ошибка Windows 1385 означает, что политика входа не позволяет пользователю песочницы запустить команду. На рабочем устройстве передай ошибку администратору. Отключение песочницы не входит в установку.
Как установить Codex на Windows через WSL2
Выбирай WSL2, если нужны Linux-инструменты, проект уже находится внутри Linux или нативная песочница не подходит твоему окружению. OpenAI предлагает нативный режим как отправную точку в Windows-документации.
При этом docs/install.md в репозитории указывает Windows 11 via WSL2. Источники расходятся: нативную установку разбирает отдельная Windows-документация с её режимами и ограничениями.
Для установки WSL по инструкции Microsoft открой PowerShell от имени администратора:
wsl --installПуть требует Windows 10 версии 2004 (сборка 19041) или новее либо Windows 11. После установки может понадобиться перезагрузка и первоначальная настройка пользователя Linux. Затем из PowerShell открой Linux-оболочку:
wslТеперь команды относятся к Linux. Внутри WSL установи CLI:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
codex loginВ Windows и внутри WSL CLI ставится в разных окружениях: в Linux-терминале проверяй Linux-программу. OpenAI рекомендует хранить WSL-проект в домашней папке Linux, например ~/code/my-project: работа через /mnt/c/... может быть медленнее и создавать проблемы с правами. WSL1 не поддерживается начиная с Codex 0.115.
Если ты пользуешься приложением, а не CLI, агент можно перенести в WSL2: в Settings переключи агента с Windows native на WSL и перезапусти приложение, до перезапуска настройка не действует. Проект из WSL добавляется через \\wsl$\. При нативном агенте проект лучше держать на диске Windows и открывать из WSL через /mnt/<диск>/....
Можно ли установить Codex через npm
Да, это ещё один способ, как установить Codex на Windows. Он указан в README OpenAI:
npm install -g @openai/codex
codex --versionОн подходит, когда Node.js и npm уже стоят. Дождись успешного завершения npm install и проверь версию в новом окне терминала. При ошибке про недостающую зависимость сохрани полный вывод npm и версию Node.
Не смешивай два способа установки без причины. Установщик из шага 1 сам находит Codex от npm и предлагает его удалить, иначе запустится тот, что стоит раньше в PATH. Если обновляешь одну копию, а запускается другая, проверь Get-Command codex -All.
Как отличить ошибки друг от друга
| Что видишь | Что проверить первым |
|---|---|
irm не является внутренней или внешней командой |
В CMD ли открыта вкладка; скопирована ли полная PowerShell-команда |
codex не найден |
Завершился ли установщик; что показывают Test-Path, Get-Command codex -All и where.exe codex |
Codex requires a 64-bit version of Windows. |
Нужна 64-битная Windows; на 32-битной установщик CLI не работает |
Detected existing npm-managed Codex |
Выбери одну установку: npm или установщик |
| Версия есть, но вход не завершился | Точный ответ codex login; доступность локального callback или разрешённого device-auth |
Ошибка 1385 внутри sandbox |
Политику входа пользователей песочницы с администратором устройства |
country, region, or territory not supported |
Условия региональной доступности; локальная установка это не исправляет |
| Непонятно, что сломалось | codex doctor соберёт отчёт об установке, входе и настройках |
| Нечитаемые русские символы | Какая оболочка и версия PowerShell открыты, где портится текст - в выводе или в файле |
Windows Terminal поддерживает Unicode и UTF-8, но смена окна не гарантирует правильную кодировку каждой команды и файла. Сохрани короткий пример испорченного текста, версию PowerShell и команду, которая его вывела.
Чек-лист
- Выбран нужный путь: приложение (вход и выбор Codex) или Codex CLI.
- Команда CLI вставлена целиком в PowerShell; установка завершилась без ошибки.
- В новом терминале
codex --versionпечатает версию, путь к программе понятен. - Вход подтверждён; способ ChatGPT или API-ключ выбран осознанно.
- Codex запущен из нужной папки и ответил на задачу чтения файлов.
- Режим песочницы доступен на устройстве; для WSL используется WSL2.
Теперь ты знаешь, как установить Codex на Windows каждым из трёх путей и проверить результат. Для настройки под свои задачи есть готовые инструкции в каталоге скиллов. Если остановился на ошибке, сохрани её полный текст и отметь шаг, где она появилась.