Codex WSL: как запустить в Linux на Windows и проверить работу

Codex можно запускать внутри WSL2 на Windows, когда проект и инструменты уже находятся в Linux. Для большинства обычных проектов сначала удобнее настольное приложение Codex в Windows; WSL выбирайте ради Linux-среды, а не как обязательный способ установки. Ниже путь от проверки WSL2 до тестовой задачи, с диагностикой проблем.

Когда выбирать WSL для Codex

В официальном руководстве OpenAI WSL2 предложена тем, кому нужны инструменты Linux, чей репозиторий уже находится в WSL, либо кому не подходит родная среда Windows. Если проект открыт и нормально работает в Windows, дополнительный слой Linux может только усложнить пути к файлам и установку зависимостей. Для общего знакомства начните с настольного приложения, затем переносите конкретную задачу в WSL при необходимости.

• Выбирайте обычное приложение Windows, если проект, терминал и файлы уже находятся в Windows, а Linux-команды не нужны.
• Выбирайте WSL2, если сборка проекта, зависимости или рабочие скрипты требуют Linux и проект уже лежит в домашнем каталоге дистрибутива.
• Не переносите проект ради одной команды Codex без проверки, какие зависимости и файлы должны остаться рядом с ним.
• На управляемом рабочем компьютере сначала уточните возможность установки WSL и права администратора.

Граница выбора: агент должен работать там же, где лежат код и зависимости проекта. Если среду разделить, ошибка пути выглядит как ошибка Codex.

Как проверить и установить WSL2

Откройте PowerShell от имени администратора. Microsoft рекомендует команду wsl --install для установки WSL и стандартного дистрибутива Ubuntu с последующей перезагрузкой. Если WSL уже настроен, не повторяйте установку вслепую: сначала посмотрите список дистрибутивов.

wsl --list --verbose
wsl --install

В выводе wsl --list --verbose найдите нужный дистрибутив и столбец VERSION. Для этой инструкции требуется значение 2: OpenAI сообщает, что WSL1 более не поддерживается в актуальном Linux-песочном режиме Codex. Если установка WSL блокируется системной политикой, остановитесь и обратитесь к администратору устройства.

Microsoft описывает переход существующего дистрибутива на WSL2 командой wsl --set-version Ubuntu 2, если его имя именно Ubuntu. Подставляйте имя из своего вывода, не угадывайте. Перед изменением существующей рабочей среды сохраните проект и убедитесь, что используемые программы совместимы.

По теме: Codex не устанавливается: диагностика по этапам в 2026

Где хранить проект

Поместите код в домашний каталог Linux, например ~/code/my-app, и запускайте команды из него. OpenAI предупреждает, что проекты под /mnt/c могут работать медленнее и вызывать сложности с ссылками и разрешениями. Если проект пока находится на диске Windows, сперва сделайте копию или повторно клонируйте репозиторий в Linux, проверьте сборку, а потом выбирайте основную папку.

1. Откройте терминал WSL командой wsl из PowerShell. Убедитесь, что приглашение терминала относится к Linux.
2. Создайте рабочую папку ~/code и перенесите туда свой тестовый проект выбранным способом.
3. Выполните обычную команду сборки или теста проекта до запуска Codex. Так вы отделите старую проблему окружения от новой установки.
4. Оставьте доступную резервную копию, пока не убедитесь, что Linux-версия проекта открывается и содержит нужные файлы.

Как установить и запустить Codex внутри WSL

Документация OpenAI даёт установку через официальный скрипт, который запускается именно в терминале WSL, после чего вызывается codex. Запускать эти команды в PowerShell вместо Linux-терминала означает установить инструмент в другую среду.

cd ~/code/my-app
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

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

По теме: Codex и Blender: автоматизация сцены через Python

Как убедиться, что всё работает в одной среде

Проверка состоит из нескольких независимых частей. Наличие команды Codex ещё не доказывает, что открыт нужный проект, а успешный вход не подтверждает, что сборка проекта работает.

• wsl --list --verbose в PowerShell показывает VERSION 2 для используемого дистрибутива.
• В терминале WSL команда pwd показывает путь под /home/, а не /mnt/c/.
• command -v codex выполняется в том же терминале WSL, где вы откроете проект.
• Codex отвечает на безопасную задачу о структуре проекта и ссылается на существующие файлы, которые вы видите сами.
• После работы git diff показывает только ожидаемые изменения либо пустой результат, если вы просили анализ без правок.

Если используете VS Code, запускайте code . из WSL и проверяйте признак подключения к WSL в окне редактора. OpenAI описывает эту проверку и Linux-пути в интегрированном терминале. Установка расширения в Windows-окне сама по себе не означает, что команды редактора идут в WSL.

Частые сбои и безопасный выход

При codex: command not found сначала выполните command -v codex внутри WSL и убедитесь, что установка проходила в этом же дистрибутиве. OpenAI советует проверить путь исполняемого файла и затем повторить официальную установку при его отсутствии. Не копируйте случайный бинарник с форума.

Если wsl --install не завершает работу, посмотрите раздел Microsoft об установке: он описывает просмотр доступных дистрибутивов и загрузку, если обычный путь зависает. Если проблема в корпоративных ограничениях, используйте разрешённую среду Windows вместо изменения политик устройства.

Если проект под /mnt/c работает медленно или теряет права на файлы, перенесите тестовую копию в ~/code и сравните запуск. OpenAI указывает Linux-каталог как предпочтительный для WSL. Не удаляйте старую копию до проверки сборки и данных.

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

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

Нужен ли WSL для Codex на Windows?

Нет. OpenAI поддерживает родное приложение и запуск в Windows; WSL2 выбирают под Linux-инструменты.

Можно ли использовать WSL1?

Актуальная документация OpenAI указывает, что после перехода песочницы на bubblewrap WSL1 не поддерживается.

Почему Codex не видит файлы проекта?

Проверьте pwd и папку, из которой запущен инструмент. OpenAI рекомендует держать проект в Linux-домашнем каталоге.

Как открыть WSL-проект в VS Code?

Откройте WSL-терминал в каталоге проекта и выполните code .; проверка OpenAI описывает признаки подключения.