Нативная поддержка Windows в Codex

Codex обеспечивает нативную поддержку в Windows и может работать без WSL. В этом разделе описаны функции и конфигурация, специфичные для Windows.


Обзор поддержки Windows

Codex поддерживает следующие среды Windows:

ОкружениеСтатус поддержки
Windows 11 (нативная)Официальная поддержка
Windows 10Официальная поддержка
Windows 11 + WSL2Полная поддержка

Codex может работать нативно в Windows, сохраняя рабочий процесс Windows.

Установка

Установка с помощью winget

Установка winget

# Установка с помощью winget
winget install OpenAI.Codex

# Или установите предварительную версию
winget install OpenAI.Codex --source winget --accept-source-agreements --accept-package-agreements

Использование Chocolatey

Установка Chocolatey

# Установка с помощью Chocolatey
choco install codex -y

Установка вручную

Скачайте версию для Windows с GitHub:

https://github.com/openai/codex/releases

Скачайте установщик .exe и запустите его.

Для автоматических обновлений рекомендуется установка через winget или Chocolatey.

Нативная песочница

Codex может работать нативно в Windows PowerShell:

  • Не требуется WSL или виртуальная машина
  • Сохраните рабочий процесс Windows
  • Бесшовная интеграция с инструментами Windows

Настройка режима песочницы

Настроить песочницу

# Конфигурация Windows Sandbox
[windows]
# Режим песочницы: unelevated | elevated
sandbox = "unelevated"

# Запустить дочерний процесс песочницы на частном рабочем столе
sandbox_private_desktop = true

Описание режима песочницы

ModeОписание
unelevatedЗапуск с правами стандартного пользователя (рекомендуется)
elevatedЗапуск с правами администратора
Для обеспечения безопасности рекомендуется использовать режим без повышенных прав.

Интеграция с PowerShell

Codex можно использовать напрямую в PowerShell:

Использование в PowerShell

# Запуск Codex
codex

# Неинтерактивный режим
codex exec "Проверить код"

# Использовать команду PowerShell
codex ! Get-Process

Поддержка CMD

Codex также поддерживает традиционную среду CMD:

Использование в CMD

# Запуск в CMD
codex exec "Показать файлы"
Codex автоматически определяет тип терминала и оптимизирует вывод.

Конфигурация для Windows

Обработка путей

Пути Windows отличаются от Unix; Codex обрабатывает это автоматически:

  • Преобразование обратной косой черты в прямую косую черту
  • Обработка буквы диска
  • Поддержка UNC-путей

Переменные окружения

Переменные среды Windows

# Задать переменные среды, специфичные для Codex
set CODEX_HOME=C:\Users\YourName\.codex
set CODEX_SQLITE_HOME=C:\Users\YourName\.codex

Конфигурация прокси

Настройки прокси

# Задать прокси
set HTTP_PROXY=http://proxy.example.com:8080
set HTTPS_PROXY=http://proxy.example.com:8080

# Затем запустите Codex
codex
Если вашей сети требуется прокси, просто настройте переменные среды.

Устранение неполадок

ЧАВО

Не удаётся запустить?

  • Проверьте, установлены ли необходимые библиотеки среды выполнения Visual C++
  • Попробуйте запустить с правами администратора
  • Проверьте, не блокирует ли его антивирусная программа

Команды PowerShell не выполняются?

Убедитесь, что исполняемый файл PowerShell находится в PATH.

Проблема с путём, содержащим китайские символы?

Codex поддерживает Unicode, но у некоторых старых терминалов могут возникнуть проблемы.

Большинство проблем можно решить переустановкой или обновлением.

Расположение журнала

Расположение журналов Windows:

%USERPROFILE%\.codex\log\codex-tui.log
Проверьте журналы, чтобы увидеть подробные сообщения об ошибках.

Сравнение с WSL2

ОсобенностиНативный WindowsWSL2
ПроизводительностьБыстрееНемного медленнее
НастройкиПростаяТребуется установка WSL
СовместимостьИнструменты WindowsИнструменты Linux
ОбслуживаниеАвтоматическое обновлениеАвтономное обновление
Для большинства пользователей Windows рекомендуется нативная версия.

Лучшие практики

  • Установка с помощью winget или Chocolatey
  • Поддерживайте систему и Codex в актуальном состоянии
  • Используйте режим песочницы без повышения прав
  • Настройте подходящий прокси-сервер (при необходимости)
Поддержка нативной Windows позволяет Codex бесшовно вписаться в ваш рабочий процесс Windows.

ЧАВО

В: Что лучше — нативная версия для Windows или версия для WSL?

Для большинства пользователей нативная версия лучше — быстрее и проще.

В: Может ли она сосуществовать с WSL?

Да, обе можно установить и использовать одновременно.

В: Требуются ли права администратора?

Нет, режим без повышения прав не требует прав администратора.

Вопрос: Поддерживает ли он PowerShell ISE?

Рекомендуется использовать Windows Terminal или новую версию PowerShell.

Другие расширения