Codex CLI на Windows запускается прямо из PowerShell после установки официальным скриптом OpenAI; для проекта с Linux-инструментами подходит отдельная установка внутри WSL2. Разработчик открывает терминал в папке репозитория, проходит вход в аккаунт и даёт агенту узкую проверяемую задачу. На рабочем компьютере до первого изменения стоит проверить права песочницы, доступ к папке и правила ИТ-службы.
Выбор рабочей среды
Официальная документация OpenAI описывает два пути для Codex CLI на Windows: нативный запуск в PowerShell и установку внутри WSL2. Среду выбирают по расположению репозитория и нужным инструментам; в обеих случаях запускать агент лучше из каталога проекта.
Нативный путь удобен, если Git, сборка и тесты проекта уже работают в Windows. Терминал PowerShell открывает тот же рабочий каталог, который видит проводник. Codex читает файлы проекта, предлагает правки и запускает доступные команды в пределах настроенных разрешений. Это отдельная практическая задача по сравнению с общим процессом работы в Codex CLI: здесь решающим становится выбор среды Windows и проверка её ограничений.
WSL2 выбирают, когда приложение собирается Linux-инструментами, репозиторий уже находится в домашнем каталоге Linux или нативная песочница Windows упирается в корпоративную политику. В этом случае Codex запускают из Linux-терминала, а путь к проекту выглядит как /home/имя/code/проект. OpenAI рекомендует держать такой репозиторий внутри файловой системы WSL, поскольку работа через /mnt/c может замедлять файловые операции и создавать проблемы с правами или символическими ссылками. Для WSL1 актуальная документация Codex поддержку уже исключает.
- Проект живёт на диске Windows и локальные тесты запускаются в PowerShell — начните с нативного CLI.
- Проект живёт в WSL2 и зависит от Linux-команд — ставьте CLI внутри WSL2.
- Смешаны Windows и Linux-пути — сначала выберите одну среду для репозитория и тестов, затем устанавливайте агент.
Выбор среды влияет на команды, пути и доступ к файлам. Файл по адресу C:\work\app в PowerShell и тот же диск через /mnt/c в WSL выглядят по-разному для инструментов. Для повторяемой работы команда фиксирует среду проекта в README и проверяет локальные тесты вручную ещё до подключения ИИ-агента.
Установка CLI
Официальная инструкция OpenAI по Codex CLI предлагает для Windows самостоятельный установщик. Откройте новое окно PowerShell и выполните команду powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Команда загружает и исполняет сценарий из адреса OpenAI; на управляемом ПК такой способ стоит заранее согласовать с ИТ-службой. В документации указан и альтернативный путь через npm: npm install -g @openai/codex, если Node.js и npm уже входят в утверждённый набор инструментов.
После установки перейдите в каталог выбранного проекта и запустите codex. При первом запуске CLI предложит вход через ChatGPT либо другой доступный способ авторизации. Успешное открытие окна агента подтверждает установку. Права записи, доступ к командам сборки и политику сети проверяют отдельной задачей. Если PowerShell сообщает, что команда codex отсутствует, откройте новое окно терминала и проверьте установку и путь к исполняемому файлу по официальной инструкции.
- Откройте PowerShell с рабочими правами пользователя и уточните у ИТ-службы допустимый способ установки.
- Поставьте CLI официальным установщиком или утверждённым в компании npm-пакетом.
- Перейдите в папку репозитория, убедитесь, что Git и обычные тестовые команды доступны, затем запустите codex.
- Пройдите вход, запишите выбранную среду и перейдите к задаче только после проверки доступа к нужным файлам.
В PowerShell откройте проект командой cd C:\work\project с вашим реальным путём. Внутри WSL2 используйте Linux-путь, например cd ~/code/project. Путь из примера служит образцом записи; подставьте существующую папку на вашем компьютере.
Для WSL2 установка отдельная. Документация OpenAI предлагает сначала установить дистрибутив командой wsl --install из PowerShell с правами администратора, затем войти в WSL командой wsl. Уже в Linux-оболочке выполняют curl -fsSL https://chatgpt.com/codex/install.sh | sh и запускают codex. Установка в Windows и установка внутри WSL2 относятся к разным средам; команда из одного терминала может отсутствовать в другом. Полный маршрут описан в руководстве OpenAI по WSL.
Права песочницы
Нативный Codex использует песочницу Windows. Согласно описанию OpenAI, в агентном режиме она ограничивает запись за пределами рабочей папки и сетевой доступ без явного разрешения. Поэтому при отказе в доступе определите конкретный путь и действие. Запуск терминала с максимальными правами может обойти защитные ограничения и требует отдельного согласования. Сначала выясните, находится ли файл в репозитории и нужен ли он для текущей задачи.
Для нативной песочницы OpenAI описывает предпочтительный режим elevated и запасной unelevated. Первый требует настройки с участием администратора; второй может применяться, когда корпоративная политика блокирует такую настройку. Названия режимов описывают реализацию защитной среды Codex. Рабочий терминал запускайте с обычными правами пользователя, если ИТ-служба определила такой порядок. Разрешённый вариант для устройства устанавливает ИТ-служба.
- Отказ на чтение соседней папки: проверьте необходимость доступа и согласуйте выдачу отдельного пути.
- Ошибка настройки песочницы: сохраните текст ошибки и передайте ИТ-службе сведения о режиме Windows и политике устройства.
- Сборка требует сеть: укажите конкретный адрес или операцию и запросите разрешение в рамках принятого процесса.
- Агент предлагает запуск команды: оцените её действие до подтверждения, особенно при изменении файлов вне проекта.
Документация допускает команду /sandbox-add-read-dir C:\absolute\path для чтения существующей абсолютной папки в текущей сессии. Укажите только нужный каталог после проверки его содержимого и полномочий. Если организация запрещает такой доступ, перестройте тест так, чтобы входные данные находились в разрешённом репозитории. Для внедрения агента в командную разработку границы доступа полезно согласовать вместе с правилами внедрения ИИ и хранения кода.
Нужно настроить Codex для команды с понятными правами?
Первая проверка
Первый запрос лучше ограничить чтением. Например: «Посмотри структуру репозитория, найди команду запуска тестов в документации проекта и объясни, какие файлы понадобятся для исправления ошибки. Пока предложи план». Такой запрос проверяет, видит ли агент нужные файлы и понимает ли окружение. Если ответ ссылается на чужой каталог или придумывает команду сборки, поправьте путь и контекст до разрешения правок.
Следующий шаг — небольшое изменение с ожидаемым результатом. Попросите исправить воспроизводимую ошибку в одном модуле либо добавить проверку существующего поведения. В запросе укажите входной файл, ожидаемый итог и команду теста из репозитория. Codex может предложить правки и запустить локальные инструменты, но итоговый diff и сообщения тестов проверяет разработчик. Сохраните исходное состояние Git перед работой, чтобы было удобно сравнить результат и откатить изменение.
- Убедитесь, что рабочее дерево Git понятно: видны уже существующие изменения и выбранная ветка.
- Попросите агента назвать файл, сценарий ошибки и план минимальной правки.
- Разрешите нужные действия с учётом подсказок песочницы и сохраните вывод команд.
- Просмотрите diff построчно, запустите тест своей командой и сравните поведение с исходным условием.
- Передайте изменение в обычное ревью команды; решение о включении в продукт принимает человек.
Если сборка прошла в PowerShell, а в WSL2 падает, сравните версии зависимостей, переменные окружения и регистр имён файлов. Если агент видит файл в одной среде и теряет его в другой, проверьте текущий каталог и тип пути. Такие ошибки среды полезно отделять от качества кода: они требуют настройки окружения, а повторная генерация правки обычно сохраняет исходную проблему.
Запишите конкретный файл изменения, вывод тестовой команды, итоговый diff и список разрешений, которые понадобились агенту. Этого достаточно, чтобы коллега воспроизвёл проверку на своём Windows-компьютере без догадок о вашей среде.
Командный запуск
После первого рабочего прогона закрепите выбранный способ установки и запуска во внутренней инструкции. Для нативного проекта это PowerShell, путь к репозиторию, команда теста и политика разрешений. Для Linux-проекта — использование WSL2, расположение репозитория внутри домашнего каталога Linux и способ запуска тех же тестов. Секреты, ключи и рабочие данные держите в одобренном хранилище; в задачу агенту передавайте минимальный набор контекста.
Отдельно проверьте, какой способ входа одобрен компанией. CLI при первом запуске предлагает доступные методы, но использование личной учётной записи для рабочего репозитория может конфликтовать с внутренними правилами. Права на репозиторий, пределы доступа к сети и журналирование действий согласуются до регулярного применения агента. Внутренний порядок приёмки должен совпадать с обычным код-ревью: diff, тест, решение ответственного разработчика.
Если команде нужен Codex в редакторе, у сайта есть отдельная инструкция про работу с Codex в VS Code. Для PowerShell и WSL2 полезнее сохранить этот короткий маршрут: выбрать среду, поставить CLI официальным способом, проверить песочницу, выполнить одну ограниченную задачу и принять её по тесту. Он показывает реальные условия работы на Windows и даёт основу для повторяемого старта на следующем компьютере.
При смене машины или среды сверяйте команды установки с текущей документацией OpenAI: состав установщиков и требования к песочнице могут меняться. Локальная памятка должна указывать дату проверки и ссылку на официальный источник. Тогда сотрудник сможет отличить устаревшую команду из заметок команды от актуального порядка установки.