Как запустить Codex на Windows через WSL (2026)

OpenAI Codex CLI — терминальный AI-ассистент для разработки, который читает кодовую базу, пишет код, выполняет команды и управляет файлами — всё из командной строки. Загвоздка в том, что он создан для macOS и Linux. Если вы работаете на Windows, его нужно запускать через WSL (Windows Subsystem for Linux).

Это руководство проведёт вас через полную настройку — от установки WSL до первого запуска Codex на вашей Windows-машине.

Что такое OpenAI Codex CLI?

Codex CLI — open-source инструмент командной строки OpenAI для AI-assisted разработки программного обеспечения. Думайте о нём как о терминальном агенте для кодирования, который умеет:

Читать и понимать всю структуру вашего проекта
Писать, редактировать и рефакторить код сразу в нескольких файлах
Выполнять команды в оболочке и интерпретировать результат
Отлаживать ошибки по логам и трассировкам стека
Работать с любым языком программирования

Запускается локально, но использует API OpenAI (или совместимые эндпоинты) в качестве языковой модели.

Предварительные требования

Требование	Подробности
Windows 10 (сборка 19041+) или Windows 11	WSL2 требует актуальной версии Windows
Права администратора	Необходимы для установки WSL
API-ключ OpenAI	Получите на platform.openai.com
8+ ГБ RAM	WSL2 запускает настоящее ядро Linux параллельно с Windows
Стабильный интернет	Требуется для API-вызовов к OpenAI

Шаг 1: Установите WSL2

Если WSL2 ещё не установлен, откройте PowerShell от имени администратора и выполните:

wsl --install

Это установит WSL2 с Ubuntu в качестве дистрибутива по умолчанию. При запросе перезагрузите компьютер.

После перезагрузки терминал Ubuntu откроется автоматически. Задайте имя пользователя и пароль для Linux.

Проверьте, что WSL2 работает

# В PowerShell
wsl --list --verbose

Вы должны увидеть что-то вроде:

  NAME      STATE           VERSION
* Ubuntu    Running         2

Если в столбце VERSION стоит 1, обновитесь до WSL2:

wsl --set-version Ubuntu 2

Шаг 2: Настройте среду Linux

Откройте терминал WSL (найдите «Ubuntu» в меню «Пуск») и обновите пакеты:

sudo apt update && sudo apt upgrade -y

Установите Node.js

Codex CLI требует Node.js 18+. Установка через nvm (Node Version Manager):

# Установите nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# Перезагрузите конфигурацию оболочки
source ~/.bashrc

# Установите Node.js LTS
nvm install --lts

# Проверьте
node --version  # Должно показать v22.x или новее
npm --version

Установите Git (если отсутствует)

sudo apt install -y git

Шаг 3: Установите Codex CLI

Установите Codex глобально через npm:

npm install -g @openai/codex

Проверьте установку:

codex --version

Шаг 4: Настройте API-ключ

Codex требует API-ключ OpenAI. Задайте его как переменную окружения:

# Добавьте в конфиг оболочки для постоянного сохранения
echo 'export OPENAI_API_KEY="sk-your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

Либо создайте файл .env в директории проекта:

echo 'OPENAI_API_KEY=sk-your-api-key-here' > .env

Использование другого провайдера LLM

Codex поддерживает любой API, совместимый с OpenAI. Для использования другого провайдера задайте базовый URL:

# Пример: локальный экземпляр Ollama
export OPENAI_API_KEY="ollama"
export OPENAI_BASE_URL="http://localhost:11434/v1"

# Пример: xAI Grok
export OPENAI_API_KEY="your-xai-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"

Шаг 5: Доступ к файлам Windows

WSL имеет доступ к файловой системе Windows через /mnt/c/. Ваши Windows-проекты доступны по пути:

# Перейдите к директории проекта в Windows
cd /mnt/c/Users/YourUsername/Projects/my-app

# Список файлов
ls -la

Для лучшей производительности клонируйте репозитории прямо в файловую систему WSL:

# Нативная директория WSL (значительно быстрее I/O)
cd ~
mkdir projects
cd projects
git clone https://github.com/your-repo/my-app.git

Важно: файловые операции на /mnt/c/ значительно медленнее, чем в нативной файловой системе WSL (~/). Для лучшей производительности Codex работайте в домашней директории WSL.

Шаг 6: Запустите Codex

Перейдите в директорию проекта и запустите Codex:

cd ~/projects/my-app

# Запуск в интерактивном режиме
codex

# Или задайте конкретную задачу
codex "Add error handling to all the API route handlers in this project"

Режимы автономности Codex

Codex предлагает три уровня автономности:

Режим	Флаг	Что может делать
Suggest	`--suggest`	Читать файлы, предлагать изменения (по умолчанию)
Auto-edit	`--auto-edit`	Читать файлы, применять изменения кода
Full auto	`--full-auto`	Читать файлы, редактировать код, выполнять команды

# Позволить Codex вносить изменения кода автоматически
codex --auto-edit "Refactor this Express app to use TypeScript"

# Позволить Codex также выполнять команды (осторожно)
codex --full-auto "Set up ESLint and Prettier for this project, install dependencies, and fix all linting errors"

Практические примеры

Исправить ошибку по сообщению:

codex "I'm getting 'TypeError: Cannot read property of undefined' on line 42 of src/utils/parser.ts. Fix it."

Написать тесты для существующего кода:

codex "Write unit tests for all functions in src/services/auth.ts using Jest"

Рефакторинг компонента:

codex "Convert the UserProfile class component in src/components/UserProfile.jsx to a functional component with hooks"

Устранение типичных проблем

«codex: command not found»

Убедитесь, что глобальная директория bin npm находится в PATH:

# Проверьте, куда npm устанавливает глобальные пакеты
npm config get prefix

# Добавьте в PATH при необходимости
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

Медленный доступ к файлам

Если Codex медленно работает с файлами на /mnt/c/, переместите проект в файловую систему WSL:

cp -r /mnt/c/Users/YourUsername/Projects/my-app ~/projects/my-app
cd ~/projects/my-app

Высокое потребление памяти WSL

WSL2 может потреблять много памяти. Создайте файл .wslconfig в домашней директории Windows для ограничения:

# C:\Users\YourUsername\.wslconfig
[wsl2]
memory=8GB
processors=4
swap=4GB

Перезапустите WSL после изменения конфигурации:

# В PowerShell
wsl --shutdown

Сетевые проблемы (API-вызовы не проходят)

Если Codex не может подключиться к OpenAI API, проверьте настройки DNS в WSL:

# Проверьте, работает ли DNS-разрешение
nslookup api.openai.com

# Если не работает, исправьте DNS
sudo rm /etc/resolv.conf
sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'
sudo bash -c 'echo "[network]\ngenerateResolvConf = false" > /etc/wsl.conf'

GUI-приложения и буфер обмена

Чтобы скопировать вывод Codex в буфер обмена Windows:

# Перенаправьте вывод в буфер обмена Windows
codex "explain this function" | clip.exe

# Или установите xclip для двустороннего буфера
sudo apt install -y xclip

Интеграция с VS Code

Для лучшего опыта используйте VS Code с расширением WSL:

Установите расширение «WSL» в VS Code
Откройте проект WSL командой code . из терминала WSL
Встроенный терминал VS Code будет автоматически использовать WSL
Запускайте Codex прямо в терминале VS Code

# Из директории проекта WSL
code .

# Затем в терминале VS Code (который теперь WSL)
codex "Add a README with setup instructions for this project"

Codex vs другие AI-инструменты для разработки

Возможность	Codex CLI	Claude Code	Cursor	GitHub Copilot
Интерфейс	Терминал	Терминал	IDE	IDE
Редактирование файлов	Да	Да	Да	Только предложения
Выполнение команд	Да	Да	Ограничено	Нет
Поддержка WSL	Через WSL	Через WSL	Нативно	Нативно
Open source	Да	Нет	Нет	Нет
Гибкость моделей	Любой совместимый с OpenAI	Только Claude	Несколько	GPT-based
Офлайн-режим	Нет (нужен API)	Нет	Нет	Нет
Цена	Только API	Подписка Claude	$20+/месяц	$10+/месяц

Заключение

Запуск Codex на Windows через WSL даёт тот же опыт, что у пользователей macOS и Linux. Настройка занимает около 15 минут, а интеграция WSL2 достаточно зрелая, чтобы разница практически не ощущалась. Для лучшей производительности держите файлы проекта в файловой системе WSL, а не обращайтесь к дискам Windows.

Если ваши проекты включают AI-генерируемые медиа наряду с кодом, посмотрите на Hypereal AI — единый API для генерации изображений, видео, говорящих аватаров и многого другого. Карты российских и СНГ банков принимаются без VPN.

Попробуйте Hypereal AI бесплатно — 35 кредитов, банковская карта не нужна.