Документация ChatGPT
Русский
Связаться goolvyouyou@gmail.com

WSL

Запуск и устранение неполадок Codex в Windows Subsystem for Linux

При использовании WSL2 Codex работает внутри среды Linux, а не в нативной песочнице Windows. Выбирайте WSL2, если вам нужны нативные для Linux инструменты, ваши репозитории и процесс разработки уже находятся в WSL2 или ни один из режимов нативной песочницы Windows не подходит для вашей среды.

WSL1 поддерживалась до версии Codex 0.114 включительно. Начиная с Codex 0.115, песочница Linux перешла на bubblewrap, поэтому WSL1 больше не поддерживается.

Запуск VS Code из WSL

Пошаговые инструкции приведены в официальном руководстве VS Code по WSL.

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

  • Windows с установленной WSL. Чтобы установить WSL, откройте PowerShell от имени администратора, затем выполните wsl --install (часто выбирают Ubuntu).
  • VS Code с установленным расширением WSL.

Открытие VS Code из терминала WSL

# From your WSL shell
cd ~/code/your-project
code .

Откроется удалённое окно WSL, при необходимости будет установлен VS Code Server, а интегрированные терминалы будут работать в Linux.

Проверка подключения к WSL

  • Найдите зелёную строку состояния с надписью WSL: <distro>.
  • В интегрированных терминалах должны отображаться пути Linux (например, /home/...), а не C:\.
  • Подключение можно проверить следующей командой:
  echo $WSL_DISTRO_NAME

Она выводит название вашего дистрибутива.

Если в строке состояния нет надписи «WSL: ...», нажмите Ctrl+Shift+P, выберите WSL: Reopen Folder in WSL и для максимальной производительности храните репозиторий в /home/... (а не в C:\).

Если приложение Windows или средство выбора проекта не отображает ваш репозиторий WSL, введите \\wsl$ в средстве выбора файлов или Проводнике, а затем перейдите в домашний каталог вашего дистрибутива.

Использование Codex CLI с WSL

Выполните следующие команды в PowerShell или Windows Terminal, запущенном от имени администратора:

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

Затем выполните следующие команды в оболочке WSL:

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Работа с кодом внутри WSL

  • Работа в подключённых из Windows путях, таких как /mnt/c/..., может быть медленнее, чем в нативных путях Windows. Для более быстрого ввода-вывода и уменьшения числа проблем с символическими ссылками и разрешениями храните репозитории в домашнем каталоге Linux (например, ~/code/my-app):
  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo
  • Если вам нужен доступ к файлам из Windows, они находятся в \\wsl$\Ubuntu\home\&lt;user&gt; в Проводнике.

Устранение неполадок и часто задаваемые вопросы

Большие репозитории медленно работают в WSL

  • Убедитесь, что вы не работаете в /mnt/c. Переместите репозиторий в WSL (например, в ~/code/...).
  • При необходимости увеличьте объём памяти и число процессоров для WSL; обновите WSL до последней версии:
  wsl --update
  wsl --shutdown

VS Code в WSL не может найти codex

Убедитесь, что исполняемый файл существует и находится в PATH внутри WSL:

which codex || echo "codex not found"

Если исполняемый файл не найден, следуйте инструкциям по настройке Codex CLI.