Implementar la aplicación para Windows y Codex CLI

Implementa la aplicación de escritorio para Windows, Codex CLI o ambas en dispositivos Windows administrados. Elige 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 distintos. Antes de implementar la CLI, elige y valida la cuenta con la que ejecutarás el instalador.

Implementar la aplicación para Windows

Elige el método según tu herramienta de administración y si los dispositivos pueden acceder a los servicios de distribución de Microsoft.

Antes de la implementación, configura los controles que correspondan siguiendo la guía de configuración administrada. Para preparar la ejecución de comandos de Codex en la aplicación de escritorio, sigue las instrucciones de configuración del sandbox de Windows. Comprueba la compatibilidad de los dispositivos y completa la configuración que requieran las implementaciones heredadas.

Los siguientes enlaces de MSIX descargan la versión más reciente para cada arquitectura. No permiten descargar versiones anteriores. Revisa el paquete descargado y conserva el artefacto aprobado en tu sistema de implementación. Sigue la guía para administrar las actualizaciones de la aplicación y coordinar el actualizador integrado con Microsoft Store, Intune y otras herramientas de implementación.

%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

winget install --id 9PLM9XGG6VKS -s msstore

#Requires -RunAsAdministrator
$ErrorActionPreference = 'Stop'

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

Implementar Codex CLI en Windows

Prepara el paquete de la CLI, aplica la política de dispositivos y verifica el acceso desde la terminal con la cuenta del empleado.

Antes de empezar

• Identifica los dispositivos Windows y los usuarios de destino, así como las arquitecturas de los procesadores. Luego elige un método de instalación. Confirma que los usuarios tengan acceso a Codex y puedan completar el proceso de inicio de sesión de tu organización.

• Para usar Intune, asegúrate de contar con permisos para administrar aplicaciones, dispositivos inscritos que cumplan los requisitos previos de Microsoft para crear paquetes Win32 y un paquete de instalación desatendida.

• Define quién se encargará de actualizar y desinstalar la CLI. Si usas npm, ten en cuenta la instalación administrada de Node.js y npm, así como la ubicación de los paquetes globales.

Elegir un método de instalación

Elige un método de instalación y una versión específica de la CLI. Revisa las versiones de la CLI en GitHub y sustituye <approved-version> en los ejemplos por el número de la versión aprobada en el formato x.y.z. Usa la misma versión en el paquete y en la regla de detección.

El instalador independiente usa latest de forma predeterminada si no se especifica una versión. Establece -Release de forma explícita para fijar la versión que se implementará. Consulta el parámetro de versión del instalador. Para obtener instrucciones generales, consulta la guía de instalación de la CLI.

Instalador independiente de PowerShell. Desde una ventana nueva de PowerShell, descarga el instalador y ejecútalo con la versión aprobada como argumento.

$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 tu organización ya administra Node.js y npm en el dispositivo, selecciona de forma explícita la versión aprobada del paquete.

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

Para la distribución administrada, conserva el instalador o el artefacto del paquete que hayas revisado, junto con la versión seleccionada, en el paquete que administra el equipo de TI. Define el contexto de instalación y cómo se detectará, desinstalará y actualizará la CLI. Seleccionar una versión no cambia la configuración predeterminada del instalador para el perfil de usuario ni proporciona un script contenedor completo para la implementación desatendida.

Establecer el contexto de instalación

De forma predeterminada, el instalador independiente guarda los archivos de ejecución en el perfil del usuario actual, usa %LOCALAPPDATA%\Programs\OpenAI\Codex\bin como directorio de comandos y lo agrega al PATH del usuario.

Si ejecutas el instalador sin modificar como SYSTEM, la instalación usa el perfil y el entorno de SYSTEM. Seleccionar Sistema en Intune no instala la CLI para todos los usuarios.

Realiza por separado la instalación para el usuario, la distribución de la política del dispositivo y la configuración del sandbox aprobada por el administrador. Cuando un procedimiento requiera el perfil de un empleado, usa la identidad de ese empleado en lugar de SYSTEM.

Mantén juntos los archivos de ejecución de la CLI independiente. Copiar solo codex.exe no basta para crear un paquete independiente completo.

Empaquetar y asignar la CLI con Intune

Prepara y valida un paquete Win32 administrado por el equipo de TI que incluya un instalador desatendido, un desinstalador y la lógica de detección adecuada para el contexto de instalación elegido.

Intune requiere una instalación desatendida. Los scripts de detección personalizados deben finalizar con el código 0 y escribir en stdout. Si escriben en stderr, la detección falla. Consulta Agregar y asignar una aplicación Win32.

Verifica la CLI desde la cuenta del empleado, incluso si el agente de administración informa un código de salida que indica que la instalación se completó correctamente.

Para Configuration Manager (SCCM), incorpora el procedimiento de instalación de la CLI que revisaste al proceso de implementación de aplicaciones, con un instalador y una regla de detección específicos para la CLI. La configuración del MSIX de la aplicación de escritorio solo se aplica a esa aplicación.

Configurar los requisitos administrados

De forma predeterminada, implementa los requisitos de Windows que impone el administrador en la siguiente ruta.

%ProgramData%\OpenAI\Codex\requirements.toml

Para usar otra ubicación, establece el valor de cadena RequirementsPath de la clave del Registro HKLM\SOFTWARE\Policies\OpenAI\Codex en la ruta absoluta del archivo.

Distribuye el archivo con tu herramienta de administración de dispositivos. Concede acceso de lectura a los usuarios de destino e impide que los usuarios sin privilegios de administrador modifiquen la política que controla el administrador.

Los requisitos limitan los valores permitidos de la configuración. Los valores predeterminados proporcionan un punto de partida. Revisa tanto el archivo local como la política de la nube que corresponda para determinar la configuración efectiva.

Elige los requisitos de permisos, aprobaciones, acceso a la red y comportamiento del sandbox. Consulta los campos compatibles y el orden de prioridad en Configuración administrada.

Después de la implementación, inicia Codex con la cuenta del empleado y usa /status y /debug-config para confirmar la política efectiva. Instalar la CLI o distribuir los requisitos no otorga acceso al Espacio de trabajo.

Configurar el sandbox de Windows

Comprueba la compatibilidad del dispositivo antes de elegir un sandbox de Windows. La guía del sandbox de Windows describe Microsoft Execution Containers (MXC) y las implementaciones heredadas.

Dar preferencia a MXC en los dispositivos compatibles

Para usar la CLI independiente, habilita la preferencia por MXC en config.toml.

[features]
prefer_mxc = true

También puedes imponer este valor mediante requirements.toml. Esta preferencia permite recurrir a una implementación heredada cuando MXC no está disponible. Antes de habilitarla, consulta los requisitos del dispositivo en la guía del sandbox de Windows.

En la versión 0.162.0 o posterior de la CLI, ejecuta 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 con el código de salida 0. Esta prueba verifica el comando que usa MXC de forma explícita. Revisa también la configuración de la sesión habitual del empleado.

Antes de la implementación, compara las restricciones de red descritas en la guía del sandbox con la política de red administrada de tu organización.

Preparar la implementación heredada de respaldo

Cuando MXC no esté disponible o esté deshabilitado, da preferencia a la implementación heredada elevated como opción de respaldo. Su configuración requiere la aprobación de un administrador, pero los comandos se ejecutan en el sandbox sin privilegios de administrador.

Sigue el procedimiento de configuración a cargo del equipo de TI para la cuenta del empleado y su directorio de inicio de Codex. Ejecuta este ejemplo desde un proceso con los privilegios elevados necesarios.

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

Sustituye la identidad y la ruta del ejemplo por las del usuario de destino. Para la configuración con privilegios elevados, usa una instalación de la CLI en la que confíe el administrador.

Para permitir únicamente la implementación heredada con configuración elevada, agrega lo siguiente a %ProgramData%\OpenAI\Codex\requirements.toml. No lo agregues a config.toml. Consulta Configurar una implementación heredada de respaldo.

[windows]
allowed_sandbox_implementations = ["elevated"]

Esto restringe las opciones heredadas de respaldo sin bloquear MXC. Antes de permitir unelevated, ten en cuenta que ofrece un aislamiento de red más débil y no admite restricciones de lectura por ruta.

Verificar la implementación de la CLI

Con la cuenta de uno de los empleados de destino, abre una ventana nueva de PowerShell sin privilegios de administrador y ejecuta estos comandos.

Get-Command codex
codex --version
codex

Confirma que el comando apunte al ejecutable de la instalación prevista y completa el proceso de inicio de sesión aprobado. Ejecuta una tarea pequeña en un proyecto destinado a pruebas y revisa la configuración activa.

Administrar las actualizaciones

Aplicación de escritorio

De forma predeterminada, la aplicación busca actualizaciones incluso después de una instalación sin conexión. Para habilitar las actualizaciones automáticas, permite que los dispositivos accedan a persistent.oaistatic.com. Si deshabilitas las actualizaciones automáticas, implementa los paquetes más recientes mediante tu herramienta de administración.

Sigue la guía para administrar las actualizaciones de la aplicación y coordinar todas las fuentes de actualizaciones. Deshabilitar el actualizador integrado no impide que Microsoft Store, Intune u otras herramientas de administración actualicen la aplicación. Tampoco permite fijar una versión administrada por OpenAI ni proporciona un canal de distribución independiente. Confirma la versión instalada mediante tu sistema de implementación.

Codex CLI

Para cada actualización de la CLI, elige una nueva versión aprobada, actualiza el valor explícito de -Release o la versión del paquete npm en tu paquete de implementación y actualiza la regla de detección. Implementa la actualización siguiendo tu proceso de distribución de paquetes. Luego verifica la versión instalada, el contexto de la cuenta y el comportamiento de la detección. Evita volver a configurar el paquete administrado con un comando de instalación que no especifique una versión. Consulta las versiones de la CLI, la guía de instalación y actualización de la CLI y la documentación de selección de versiones con npm.

Desinstalación y datos locales

Desinstala la aplicación de escritorio desde la Configuración de Windows o con tu herramienta de administración, como Intune o SCCM. La limpieza se ejecuta automáticamente durante la desinstalación.

De forma predeterminada, los chats de programación y la configuración locales se conservan en el directorio CODEX_HOME del usuario.

Para eliminar también CODEX_HOME durante la desinstalación, agrega lo siguiente al archivo config.toml de esa carpeta antes de desinstalar la aplicación.

[desktop]
uninstall_codex_home = true

Solución de problemas

Instalación y configuración de Codex CLI

Recursos relacionados

• Instalación de la CLI

• Configuración administrada

• Configuración del sandbox de Windows

• Aplicación de escritorio de ChatGPT para Windows

• Consulta la guía de Microsoft para crear paquetes Win32.

• Consulta la configuración de Microsoft para implementar aplicaciones Win32.