Implementar la aplicación de Windows y Codex CLI

Implemente la aplicación de escritorio de Windows, Codex CLI o ambas en dispositivos Windows administrados. Elija la aplicación para acceder desde el escritorio o la CLI para acceder desde la terminal.

La aplicación de escritorio y la CLI independiente usan contextos de instalación diferentes. Antes de implementar la CLI, elija y valide la cuenta que se usará para ejecutar su instalador.

Implementar la aplicación de Windows

Elija un método según su herramienta de administración y la posibilidad de que los dispositivos accedan a los servicios de distribución de Microsoft.

Antes de la implementación, configure los controles aplicables mediante Configuración administrada. Para preparar la ejecución de comandos de Codex en la aplicación de escritorio, siga Configuración del entorno aislado de Windows. Compruebe la compatibilidad de los dispositivos y complete cualquier configuración heredada necesaria.

Los enlaces MSIX siguientes descargan la versión más reciente para cada arquitectura, no una versión histórica. Revise el paquete descargado y conserve el artefacto aprobado en su sistema de implementación. Siga Administrar las actualizaciones de la aplicación para coordinar el actualizador integrado de la aplicación con Microsoft Store, Intune y otras herramientas de implementación.

   #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

Implemente Codex CLI en Windows

Prepare el paquete de la CLI, aplique la directiva de dispositivos y verifique el acceso desde la terminal con la cuenta del empleado.

Antes de comenzar

• Identifique los dispositivos Windows y los usuarios de destino, así como las arquitecturas de sus procesadores, y luego elija un método de instalación. Confirme que los usuarios tengan acceso a Codex y puedan completar el flujo de inicio de sesión de su organización.

• Para Intune, prepare los permisos de administración de aplicaciones, los dispositivos inscritos que cumplan los requisitos previos de Microsoft para el empaquetado Win32 y un paquete de instalación desatendida.

• Asigne la responsabilidad de las actualizaciones y la desinstalación de la CLI. Si usa npm, tenga en cuenta la instalación administrada de Node.js/npm y la ubicación de sus paquetes globales.

Elija un método de instalación

Elija un método de instalación y una versión específica de la CLI. Revise las versiones de la CLI en GitHub y luego sustituya <approved-version> en los ejemplos por el número de versión aprobado en formato x.y.z. Use la misma versión en el paquete y en la regla de detección.

El instalador independiente usa latest de forma predeterminada cuando no se especifica una versión. Establezca -Release explícitamente para fijar la implementación a una versión; consulte el parámetro de versión del instalador. Para obtener orientación general sobre la instalación, consulte Instalación de la CLI.

Instalador independiente de PowerShell. Desde una nueva ventana de PowerShell, descargue el instalador y pase la versión aprobada:

$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. Si Node.js y npm ya se administran en el dispositivo, seleccione explícitamente la versión aprobada del paquete:

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

Para la distribución administrada, conserve el instalador o el artefacto del paquete revisado y la versión seleccionada en el paquete a cargo del equipo de TI. Defina el contexto de instalación, la detección, la desinstalación y el comportamiento de las actualizaciones. Seleccionar una versión no cambia los valores predeterminados del instalador para el perfil de usuario ni proporciona un contenedor completo para la implementación desatendida.

Establezca el contexto de instalación

El instalador independiente usa de forma predeterminada archivos de ejecución en el perfil del usuario actual, un directorio de comandos en %LOCALAPPDATA%\Programs\OpenAI\Codex\bin y el PATH del usuario.

Ejecutar el instalador sin modificaciones como SYSTEM utiliza el perfil y el entorno de SYSTEM. Seleccionar System en Intune no convierte esta instalación en una instalación para todos los usuarios.

Separe la instalación del usuario, la distribución de directivas de dispositivos y la configuración del entorno aislado aprobada por el administrador. Cuando un procedimiento requiera el perfil de un empleado, use la identidad de ese empleado en lugar de SYSTEM.

Mantenga juntos los archivos de ejecución independientes; copiar solo codex.exe no constituye un paquete independiente completo.

Empaquete y asigne la CLI mediante Intune

Prepare y valide un paquete Win32 a cargo del equipo de TI con un instalador desatendido, un desinstalador y lógica de detección para el contexto de instalación elegido.

1. Prepare una carpeta de origen que contenga los archivos de instalación aprobados y su script de instalación desatendida. Especifique la versión aprobada de la CLI en ese script en lugar de permitir que use latest. Mantenga la herramienta de empaquetado de Microsoft y la carpeta de salida fuera de esa carpeta de origen.

2. Genere el archivo .intunewin con Microsoft Win32 Content Prep Tool. Este ejemplo supone que su script de instalación revisado se llama Install-Codex.ps1:

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

La herramienta empaqueta el contenido de la carpeta de origen. Consulte Crear un paquete de aplicación Win32.

3. En Intune, cree una Aplicación de Windows (Win32) y cargue el paquete.

4. Configure los comandos de instalación y desinstalación, el comportamiento de Usuario o Sistema, los requisitos y las reglas de detección para que coincidan con el paquete.

5. Asígnelo como Obligatorio o Disponible para dispositivos inscritos.

Intune requiere una instalación desatendida. Los scripts de detección personalizados deben finalizar con el código 0 y escribir en stdout; la salida en stderr provoca un error de detección. Consulte Agregar y asignar una aplicación Win32.

Verifique la CLI desde la cuenta del empleado, incluso cuando el agente de administración informe de un código de salida satisfactorio.

Para Configuration Manager (SCCM), use el diseño revisado de instalación de la CLI en el flujo de trabajo de su aplicación, con un instalador y una regla de detección específicos para la CLI. La configuración de MSIX de la aplicación de escritorio solo se aplica a la aplicación de escritorio.

Configure los requisitos administrados

Implemente los requisitos de Windows impuestos por el administrador en:

%ProgramData%\OpenAI\Codex\requirements.toml

Distribuya el archivo mediante su herramienta de administración de endpoints. Otorgue acceso de lectura a los usuarios previstos e impida que los usuarios comunes modifiquen la directiva que pertenece al administrador.

Los requisitos restringen los ajustes; los valores predeterminados de configuración proporcionan los valores iniciales. Revise tanto el archivo local como la directiva de la nube aplicable para determinar la configuración efectiva.

Elija los requisitos de permisos, aprobaciones, acceso a la red y comportamiento del entorno aislado. Consulte Configuración administrada para conocer los campos compatibles y su precedencia.

Después de la implementación, inicie Codex con la cuenta del empleado y use /status y /debug-config para confirmar la directiva efectiva. Instalar la CLI o distribuir los requisitos no concede acceso al espacio de trabajo.

Configure el entorno aislado de Windows

Compruebe la compatibilidad del dispositivo antes de elegir un entorno aislado de Windows. La guía del entorno aislado de Windows abarca Microsoft Execution Containers (MXC) y las implementaciones heredadas.

Dé preferencia a MXC en dispositivos compatibles

Para usar la CLI de forma independiente, habilite la preferencia por MXC en config.toml:

[features]
prefer_mxc = true

También puede imponer este valor de la función mediante requirements.toml. Esta preferencia permite recurrir a una implementación heredada cuando MXC no está disponible. Compruebe los requisitos del dispositivo en la guía del entorno aislado de Windows antes de habilitarla.

En la versión 0.162.0 o posterior de la CLI, ejecute esta prueba de compatibilidad desde el directorio de un proyecto:

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

El resultado esperado es MXC_OK y un código de salida de 0. Esto comprueba el comando explícito de MXC; inspeccione también la configuración de la sesión habitual del empleado.

Antes del despliegue, compare las restricciones de red de la guía del entorno aislado con su directiva de red administrada.

Prepare la alternativa heredada

Cuando MXC no esté disponible o esté deshabilitado, dé preferencia a la alternativa heredada elevated. Requiere una configuración aprobada por un administrador, pero los comandos del entorno aislado se ejecutan sin privilegios de administrador.

Siga el procedimiento de configuración dirigido por TI para la cuenta del empleado y el directorio de inicio de Codex. Ejecute este ejemplo desde un proceso con los privilegios elevados adecuados:

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

Sustituya la identidad y la ruta de ejemplo por los valores del usuario previsto. Use una instalación de la CLI de confianza para el administrador al realizar la configuración con privilegios elevados.

Para permitir únicamente la implementación heredada con privilegios elevados, agregue lo siguiente a %ProgramData%\OpenAI\Codex\requirements.toml, no a config.toml. Consulte Configurar una alternativa heredada:

[windows]
allowed_sandbox_implementations = ["elevated"]

Esto restringe la alternativa heredada sin bloquear MXC. Antes de permitir unelevated, revise su aislamiento de red más débil y la falta de compatibilidad con rutas de lectura denegada.

Verifique la implementación de la CLI

Con la cuenta de un empleado previsto, abra una nueva ventana de PowerShell sin privilegios de administrador:

Get-Command codex
codex --version
codex

Confirme que el ejecutable corresponde a la instalación prevista y, a continuación, complete el flujo de inicio de sesión aprobado. Ejecute una tarea pequeña en un proyecto de prueba designado e inspeccione la configuración activa.

Administre las actualizaciones

Aplicación de escritorio

La aplicación busca actualizaciones de forma predeterminada, incluso después de una instalación sin conexión. Para habilitar las actualizaciones automáticas, permita que los dispositivos accedan a persistent.oaistatic.com. Si deshabilita las actualizaciones automáticas, implemente paquetes más recientes mediante su herramienta de administración.

Siga Administrar las actualizaciones de la aplicación para coordinar todas las fuentes de actualización. Deshabilitar el actualizador integrado no impide que Microsoft Store, Intune u otras herramientas de administración actualicen la aplicación, ni proporciona la fijación de versiones administrada por OpenAI o un canal de lanzamiento independiente. Confirme la versión instalada mediante su sistema de implementación.

Codex CLI

Para cada actualización de la CLI, elija una nueva versión aprobada, actualice el valor explícito de -Release o la versión del paquete npm en su paquete de implementación y actualice su regla de detección. Impleméntela mediante su proceso de paquetes y, a continuación, verifique la versión instalada, el contexto de la cuenta y el comportamiento de detección. No vuelva a cambiar el paquete administrado a un comando de instalación sin una versión explícita. Consulte Versiones de la CLI, Instalación y actualizaciones de la CLI y Selección de versiones de npm.

Solución de problemas

Instaleción y configuración de Codex CLI

Recursos relacionados

• Instalación de la CLI

• Configuración administrada

• Configuración del entorno aislado de Windows

• Aplicación de escritorio de ChatGPT para Windows

• Consulte la guía de empaquetado Win32 de Microsoft

• Consulte la configuración de implementación Win32 de Microsoft