Развёртывание приложения для Windows и Codex CLI

Разверните настольное приложение для Windows, Codex CLI или оба компонента на управляемых устройствах Windows. Выберите приложение для доступа через графический интерфейс или CLI для доступа через терминал.

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

Развёртывание приложения для Windows

Выберите способ с учётом вашего инструмента управления и доступности служб распространения Microsoft для устройств.

Перед развёртыванием настройте применимые средства управления по руководству Управляемая конфигурация. Чтобы подготовить выполнение команд Codex в настольном приложении, следуйте руководству Настройка песочницы Windows. Проверьте совместимость устройств и при необходимости выполните настройку для устаревших систем.

Приведённые ниже ссылки на MSIX загружают последний выпуск для каждой архитектуры, а не предыдущую версию. Проверьте загруженный пакет и сохраните утверждённый артефакт в своей системе развёртывания. Следуйте руководству Управление обновлениями приложения, чтобы согласовать встроенный механизм обновления приложения с Microsoft Store, Intune и другими инструментами развёртывания.

   #Requires -RunAsAdministrator
   $ErrorActionPreference = 'Stop'

   Add-AppxProvisionedPackage -Online `
     -PackagePath "$PSScriptRoot\ChatGPT.msix" `
     -LicensePath "$PSScriptRoot\ChatGPT-License.xml" `
     -Regions all

   #Requires -RunAsAdministrator
   $ErrorActionPreference = 'Stop'

   Get-AppxProvisionedPackage -Online |
     Where-Object DisplayName -eq 'OpenAI.Codex' |
     Remove-AppxProvisionedPackage -Online -AllUsers

   Get-AppxPackage -AllUsers -Name 'OpenAI.Codex' |
     Remove-AppxPackage -AllUsers

%SystemRoot%\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Install-ChatGPT.ps1

C:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Uninstall-ChatGPT.ps1

$package = Get-AppxProvisionedPackage -Online -ErrorAction Stop |
  Where-Object DisplayName -eq 'OpenAI.Codex'

if ($package) {
  Write-Output $package.PackageName
  exit 0
}
exit 1

#Requires -RunAsAdministrator
$ErrorActionPreference = 'Stop'

Add-AppxProvisionedPackage -Online `
  -PackagePath "$PSScriptRoot\ChatGPT.msix" `
  -LicensePath "$PSScriptRoot\ChatGPT-License.xml" `
  -Regions all

winget install --id 9PLM9XGG6VKS -s msstore

   Add-AppxProvisionedPackage -Online `
     -PackagePath .\ChatGPT.msix `
     -LicensePath .\ChatGPT-License.xml `
     -Regions all

Развёртывание Codex CLI в Windows

Подготовьте пакет CLI, примените политику устройств и проверьте доступ из терминала под учётной записью сотрудника.

Перед началом

• Определите целевые устройства Windows, пользователей и архитектуры процессоров, затем выберите способ установки. Убедитесь, что у пользователей есть доступ к Codex и они могут пройти процедуру входа, принятую в вашей организации.

• Для Intune подготовьте разрешения на управление приложениями, зарегистрированные устройства, соответствующие предварительным требованиям Microsoft к созданию пакетов Win32, и пакет для автоматической установки без участия пользователя.

• Назначьте ответственных за обновление и удаление CLI. Если вы используете npm, учтите управляемую установку Node.js/npm и расположение глобальных пакетов.

Выберите способ установки

Выберите способ установки и конкретный выпуск CLI. Просмотрите выпуски CLI на GitHub, затем замените <approved-version> в примерах номером утверждённой версии в формате x.y.z. Используйте одну и ту же версию в пакете и правиле обнаружения.

Если выпуск не указан, отдельный установщик по умолчанию использует latest. Явно задайте -Release, чтобы закрепить развёртывание за конкретным выпуском; см. параметр выпуска установщика. Общие инструкции по установке приведены в разделе Установка CLI.

Отдельный установщик PowerShell. В новом окне PowerShell скачайте установщик и укажите утверждённый выпуск:

$CodexRelease = '<approved-version>'
Invoke-WebRequest -UseBasicParsing -Uri 'https://chatgpt.com/codex/install.ps1' -OutFile '.\codex-install.ps1'
powershell -ExecutionPolicy Bypass -File .\codex-install.ps1 -Release $CodexRelease

npm. Если Node.js и npm уже установлены и управляются на устройстве, явно укажите утверждённую версию пакета:

$CodexRelease = '<approved-version>'
npm install -g "@openai/codex@$CodexRelease"

Для управляемого распространения включите проверенный установщик или артефакт пакета и выбранный выпуск в пакет, за который отвечает ваш ИТ-отдел. Определите контекст установки, логику обнаружения, удаления и обновления. Выбор версии не меняет настройки установщика по умолчанию, привязанные к профилю пользователя, и не обеспечивает полноценную оболочку для автоматического развёртывания без участия пользователя.

Задайте контекст установки

По умолчанию отдельный установщик размещает файлы среды выполнения в профиле текущего пользователя, использует каталог команд %LOCALAPPDATA%\Programs\OpenAI\Codex\bin и добавляет его в PATH пользователя.

При запуске неизменённого установщика от имени SYSTEM используются профиль и окружение SYSTEM. Выбор System в Intune не делает установку доступной для всех пользователей.

Разделяйте установку для пользователя, доставку политик устройств и настройку песочницы, одобренную администратором. Если для процедуры требуется профиль сотрудника, выполняйте её от имени этого сотрудника, а не SYSTEM.

Храните файлы среды выполнения отдельной установки вместе; копирование только codex.exe не даёт полноценного отдельного пакета.

Создайте пакет CLI и назначьте его через Intune

Подготовьте и проверьте пакет Win32, за который отвечает ИТ-отдел, с установщиком и средством удаления, работающими без участия пользователя, а также логикой обнаружения для выбранного контекста установки.

1. Подготовьте исходную папку с утверждёнными установочными файлами и вашим скриптом установки без участия пользователя. Укажите в скрипте утверждённый выпуск CLI, чтобы он не выбирал latest автоматически. Храните инструмент Microsoft для создания пакетов и выходную папку за пределами этой исходной папки.

2. Создайте файл .intunewin с помощью Microsoft Win32 Content Prep Tool. В этом примере предполагается, что ваш проверенный скрипт установки называется Install-Codex.ps1:

   IntuneWinAppUtil.exe -c C:\Packages\Codex\Source -s Install-Codex.ps1 -o C:\Packages\Codex\Output -q

Инструмент упаковывает содержимое исходной папки. См. Создание пакета приложения Win32.

3. В Intune создайте приложение Windows (Win32) и загрузите пакет.

4. Задайте команды установки и удаления, режим User или System, требования и правила обнаружения в соответствии с пакетом.

5. Назначьте его как Обязательное или Доступное для зарегистрированных устройств.

Intune требует установки без участия пользователя. Пользовательские скрипты обнаружения должны завершаться с кодом 0 и выводить данные в stdout; вывод в stderr приводит к сбою обнаружения. См. раздел Добавление и назначение приложения Win32.

Проверьте CLI из учётной записи сотрудника, даже если агент управления сообщает об успешном коде завершения.

Для Configuration Manager (SCCM) используйте проверенную схему установки CLI в процессе развёртывания приложений, с отдельным установщиком и правилом обнаружения для CLI. Настройки MSIX настольного приложения применяются только к настольному приложению.

Настройка управляемых требований

Разместите принудительно применяемые администратором требования для Windows по следующему пути:

%ProgramData%\OpenAI\Codex\requirements.toml

Доставьте файл с помощью средства управления конечными устройствами. Предоставьте целевым пользователям доступ на чтение и запретите обычным пользователям изменять политику, принадлежащую администратору.

Требования ограничивают настройки; значения конфигурации по умолчанию задают начальные значения. Чтобы определить итоговую конфигурацию, проверьте как локальный файл, так и применимую облачную политику.

Выберите требования к разрешениям, подтверждениям, сетевому доступу и работе песочницы. Поддерживаемые поля и порядок приоритета описаны в разделе Управляемая конфигурация.

После развёртывания запустите Codex от имени сотрудника и используйте /status и /debug-config, чтобы проверить действующую политику. Установка CLI или доставка требований не предоставляет доступ к рабочему пространству.

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

Проверьте совместимость устройств, прежде чем выбирать песочницу Windows. В руководстве по песочнице Windows рассматриваются Microsoft Execution Containers (MXC) и устаревшие реализации.

Отдавайте предпочтение MXC на совместимых устройствах

Для автономного использования CLI включите предпочтительное использование MXC в config.toml:

[features]
prefer_mxc = true

Это значение функции также можно принудительно задать через requirements.toml. Предпочтительное использование MXC допускает переход к устаревшей реализации, если MXC недоступен. Перед включением проверьте требования к устройствам в руководстве по песочнице Windows.

В CLI версии 0.162.0 или новее выполните следующую проверку совместимости из каталога проекта:

codex -c windows.sandbox=mxc sandbox --include-managed-config --permission-profile :workspace -- cmd.exe /d /c echo MXC_OK
$LASTEXITCODE

Ожидаемый результат — MXC_OK и код завершения 0. Эта проверка явно запускает команду с MXC; также проверьте конфигурацию обычного сеанса сотрудника.

Перед массовым развёртыванием сопоставьте сетевые ограничения из руководства по песочнице с управляемой сетевой политикой.

Подготовка резервной устаревшей реализации

Если MXC недоступен или отключён, отдавайте предпочтение устаревшей резервной реализации elevated. Для её настройки требуется одобрение администратора, но команды в песочнице выполняются без прав администратора.

Выполните процедуру настройки силами ИТ-отдела для учётной записи сотрудника и домашнего каталога Codex. Запустите этот пример из процесса с необходимыми повышенными правами:

codex sandbox setup --elevated --user 'DOMAIN\alice' --codex-home 'C:\Users\alice\.codex'

Замените учётную запись и путь из примера значениями целевого пользователя. Для настройки с повышенными правами используйте установку CLI, которой доверяет администратор.

Чтобы разрешить только устаревшую реализацию с повышенными правами, добавьте следующее в %ProgramData%\OpenAI\Codex\requirements.toml, а не в config.toml. См. раздел Настройка резервной устаревшей реализации:

[windows]
allowed_sandbox_implementations = ["elevated"]

Это ограничивает выбор резервной устаревшей реализации, не блокируя MXC. Прежде чем разрешать unelevated, изучите её более слабую сетевую изоляцию и отсутствие поддержки путей с запретом чтения.

Проверка развёртывания CLI

Войдите под учётной записью целевого сотрудника и откройте новое окно PowerShell без прав администратора:

Get-Command codex
codex --version
codex

Убедитесь, что используется исполняемый файл из нужной установки, затем выполните утверждённую процедуру входа. Запустите небольшую задачу в выделенном тестовом проекте и проверьте активную конфигурацию.

Управление обновлениями

Настольное приложение

По умолчанию приложение проверяет наличие обновлений, в том числе после автономной установки. Чтобы включить автоматические обновления, разрешите устройствам доступ к persistent.oaistatic.com. Если вы отключите автоматические обновления, развёртывайте новые пакеты с помощью средства управления.

Следуйте указаниям раздела Управление обновлениями приложения, чтобы согласовать все источники обновлений. Отключение встроенного механизма обновления не мешает Microsoft Store, Intune и другим средствам управления обновлять приложение, а также не обеспечивает фиксацию версии под управлением OpenAI или отдельный канал выпуска. Проверяйте установленную версию через систему развёртывания.

Codex CLI

Для каждого обновления CLI выберите новый утверждённый выпуск, обновите явно заданное значение -Release или версию пакета npm в пакете развёртывания и обновите правило обнаружения. Выполните развёртывание в рамках принятого процесса работы с пакетами, затем проверьте установленную версию, контекст учётной записи и работу обнаружения. Не возвращайте управляемый пакет к команде установщика без явно указанного выпуска. См. разделы Выпуски CLI, Установка и обновление CLI и Выбор версии npm.

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

Установка и настройка Codex CLI

Связанные ресурсы

• Установка CLI

• Управляемая конфигурация

• Настройка песочницы Windows

• Настольное приложение ChatGPT для Windows

• См. руководство Microsoft по созданию пакетов Win32

• См. настройки развёртывания Win32 от Microsoft