Implante o aplicativo para Windows e a CLI do Codex

Implante o aplicativo de desktop para Windows, a CLI do Codex ou ambos em dispositivos Windows gerenciados. Escolha o aplicativo para acessar o Codex pelo desktop ou a CLI para acessá-lo pelo terminal.

O aplicativo de desktop e a CLI independente usam contextos de instalação diferentes. Antes de implantar a CLI, escolha e valide a conta que executará o instalador.

Implante o aplicativo para Windows

Escolha o método de acordo com a ferramenta de gerenciamento que você usa e com a possibilidade de os dispositivos acessarem os serviços de distribuição da Microsoft.

Antes da implantação, configure os controles aplicáveis conforme as orientações em Configuração gerenciada. Para preparar a execução de comandos do Codex no aplicativo de desktop, siga as instruções de configuração do sandbox do Windows. Verifique a compatibilidade dos dispositivos e conclua a configuração da implementação herdada, se necessário.

Os links dos pacotes MSIX abaixo permitem baixar apenas a versão mais recente para cada arquitetura. Revise o pacote baixado e guarde o artefato aprovado no sistema de implantação. Siga as orientações em Gerencie as atualizações do aplicativo para coordenar o atualizador integrado do aplicativo com a Microsoft Store, o Intune e outras ferramentas de implantação.

%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

Implante a CLI do Codex no Windows

Prepare o pacote da CLI, aplique a política de dispositivos e verifique se o funcionário consegue acessar a CLI pelo terminal usando a própria conta.

Antes de começar

• Identifique os dispositivos Windows de destino, a arquitetura dos processadores e os usuários que receberão a CLI. Depois, escolha o método de instalação. Confirme que os usuários têm acesso ao Codex e conseguem concluir o processo de login da organização.

• Para usar o Intune, providencie as permissões de gerenciamento de aplicativos, dispositivos registrados que atendam aos pré-requisitos da Microsoft para criar pacotes Win32 e um pacote de instalação que dispense a intervenção do usuário.

• Defina quem será responsável pelas atualizações e pela remoção da CLI. Se usar o npm, leve em conta a instalação gerenciada do Node.js e do npm, além do local dos pacotes globais.

Escolha um método de instalação

Escolha o método de instalação e a versão específica da CLI. Consulte as versões da CLI no GitHub e substitua <approved-version> nos exemplos pelo número da versão aprovada, no formato x.y.z. Use a mesma versão no pacote e na regra de detecção.

O instalador independente usa latest por padrão quando nenhuma versão é especificada. Defina -Release explicitamente para fixar a versão implantada. Consulte o parâmetro de versão do instalador. Para orientações gerais, consulte Instalação da CLI.

Instalador independente em PowerShell. Em uma nova janela do PowerShell, baixe o instalador e passe a versão aprovada 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. Se o Node.js e o npm já forem gerenciados no dispositivo, selecione explicitamente a versão aprovada do pacote:

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

Para distribuição gerenciada, inclua no pacote mantido pela equipe de TI o instalador ou o artefato de pacote já revisado e especifique a versão selecionada. Defina o contexto de instalação e como funcionarão a detecção, a remoção e as atualizações. Mesmo com uma versão definida, o instalador usa o perfil do usuário por padrão. Para automatizar toda a implantação sem intervenção do usuário, a equipe de TI precisa preparar um script que execute o instalador.

Defina o contexto de instalação

Por padrão, o instalador independente coloca os arquivos de execução no perfil do usuário atual, usa %LOCALAPPDATA%\Programs\OpenAI\Codex\bin como diretório de comandos e adiciona esse diretório ao PATH do usuário.

Executar o instalador sem alterações como SYSTEM faz com que ele use o perfil e o ambiente da conta SYSTEM. Selecionar Sistema no Intune não torna a instalação disponível para todos os usuários.

Trate separadamente a instalação para o usuário, a distribuição da política de dispositivos e a configuração do sandbox aprovada pelo administrador. Quando um procedimento exigir o perfil de um funcionário, use a identidade desse funcionário em vez da conta SYSTEM.

Mantenha juntos os arquivos de execução da instalação independente. Copiar apenas codex.exe não é suficiente para montar um pacote independente completo.

Empacote e atribua a CLI pelo Intune

Prepare e valide um pacote Win32 mantido pela equipe de TI. Inclua um instalador que dispense a intervenção do usuário, um desinstalador e uma lógica de detecção adequada ao contexto de instalação escolhido.

O Intune exige instalação sem intervenção do usuário. Os scripts de detecção personalizados precisam terminar com o código 0 e gravar uma mensagem em stdout. Qualquer saída em stderr causa falha na detecção. Consulte Adicionar e atribuir um aplicativo Win32.

Verifique se a CLI funciona na conta do funcionário, mesmo que o agente de gerenciamento informe um código de saída de sucesso.

No Configuration Manager (SCCM), aplique o procedimento de instalação da CLI já revisado ao fluxo de implantação de aplicativos, com um instalador e uma regra de detecção específicos para a CLI. As configurações de MSIX do aplicativo de desktop se aplicam somente a esse aplicativo.

Configure os requisitos gerenciados

Por padrão, implante os requisitos do Windows impostos pelo administrador no seguinte caminho:

%ProgramData%\OpenAI\Codex\requirements.toml

Para usar outro local, defina o valor de cadeia de caracteres RequirementsPath na chave de registro HKLM\SOFTWARE\Policies\OpenAI\Codex com o caminho absoluto do arquivo.

Distribua o arquivo pela ferramenta de gerenciamento de endpoints. Conceda acesso de leitura aos usuários de destino e impeça que usuários comuns alterem a política controlada pelo administrador.

Os requisitos limitam os valores que podem ser configurados. Os padrões de configuração fornecem os valores iniciais. Revise o arquivo local e a política de nuvem aplicável para determinar qual configuração está em vigor.

Escolha os requisitos de permissões, aprovações, acesso à rede e comportamento do sandbox. Consulte Configuração gerenciada para ver os campos compatíveis e a ordem de precedência.

Após a implantação, inicie o Codex com a conta do funcionário e use /status e /debug-config para confirmar a política em vigor. Nem a instalação da CLI nem a distribuição dos requisitos concedem acesso ao espaço de trabalho.

Configure o sandbox do Windows

Verifique a compatibilidade do dispositivo antes de escolher um sandbox do Windows. O guia do sandbox do Windows aborda os Microsoft Execution Containers (MXC) e as implementações herdadas.

Dê preferência ao MXC em dispositivos compatíveis

Para usar a CLI de forma independente, habilite a preferência pelo MXC em config.toml:

[features]
prefer_mxc = true

Você também pode impor esse valor para o recurso por meio de requirements.toml. Essa preferência permite recorrer a uma implementação herdada quando o MXC não está disponível. Antes de habilitá-la, confira os requisitos do dispositivo no guia do sandbox do Windows.

Na versão 0.162.0 ou posterior da CLI, execute este teste de compatibilidade a partir de um diretório de projeto:

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

O resultado esperado é MXC_OK, com código de saída 0. Esse teste verifica o comando que seleciona o MXC explicitamente. Verifique também a configuração da sessão que o funcionário usa normalmente.

Antes da implantação, compare as restrições de rede descritas no guia do sandbox com a política de rede gerenciada da organização.

Prepare a alternativa herdada

Quando o MXC estiver indisponível ou desabilitado, dê preferência à implementação herdada elevated. A configuração exige aprovação do administrador, mas os comandos no sandbox são executados sem privilégios de administrador.

Siga o procedimento de configuração pela equipe de TI para a conta do funcionário e o diretório inicial do Codex. Execute este exemplo em um processo com os privilégios elevados necessários:

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

Substitua a identidade e o caminho do exemplo pelos valores do usuário de destino. Para a configuração com privilégios elevados, use uma instalação da CLI em que o administrador confie.

Para permitir apenas a implementação herdada que exige elevação na configuração, adicione o trecho abaixo a %ProgramData%\OpenAI\Codex\requirements.toml, e não a config.toml. Consulte Configure uma alternativa herdada.

[windows]
allowed_sandbox_implementations = ["elevated"]

Essa configuração restringe as alternativas herdadas sem bloquear o MXC. Antes de permitir unelevated, avalie o isolamento de rede mais fraco dessa implementação e a falta de suporte ao bloqueio de leitura por caminho.

Verifique a implantação da CLI

Com a conta de um funcionário que deve ter acesso à CLI, abra uma nova janela do PowerShell sem privilégios de administrador:

Get-Command codex
codex --version
codex

Confirme que o comando localiza o executável da instalação esperada e conclua o processo de login aprovado. Execute uma tarefa pequena em um projeto designado para testes e verifique a configuração ativa.

Gerencie as atualizações

Aplicativo de desktop

Por padrão, o aplicativo procura atualizações, inclusive após uma instalação offline. Para habilitar as atualizações automáticas, permita que os dispositivos acessem persistent.oaistatic.com. Se você desabilitar as atualizações automáticas, implante pacotes mais recentes pela ferramenta de gerenciamento.

Siga as orientações em Gerencie as atualizações do aplicativo para coordenar todas as fontes de atualização. Desabilitar o atualizador integrado não impede que a Microsoft Store, o Intune ou outras ferramentas de gerenciamento atualizem o aplicativo. Isso também não permite fixar uma versão gerenciada pela OpenAI nem oferece um canal de lançamento separado. Confirme a versão instalada no sistema de implantação.

CLI do Codex

A cada atualização da CLI, escolha uma nova versão aprovada, atualize o valor explícito de -Release ou a versão do pacote npm no pacote de implantação e atualize a regra de detecção. Siga o processo de implantação de pacotes da organização e verifique a versão instalada, o contexto da conta e o comportamento da detecção. Não volte a usar no pacote gerenciado um comando de instalação que não especifique a versão. Consulte as versões da CLI, as orientações de instalação e atualização da CLI e a documentação de seleção de versões no npm.

Desinstalação e dados locais

Desinstale o aplicativo de desktop pelas Configurações do Windows ou pela ferramenta de gerenciamento, como o Intune ou o SCCM. A limpeza é executada automaticamente durante a desinstalação.

Por padrão, os chats locais sobre programação e as configurações são mantidos no diretório CODEX_HOME do usuário.

Para remover também CODEX_HOME durante a desinstalação, adicione o trecho abaixo ao arquivo config.toml nessa pasta antes de desinstalar:

[desktop]
uninstall_codex_home = true

Solução de problemas

Instalação e configuração da CLI do Codex

Recursos relacionados

• Instalação da CLI

• Configuração gerenciada

• Configuração do sandbox do Windows

• Aplicativo de desktop do ChatGPT para Windows

• Consulte o guia da Microsoft para criar pacotes Win32

• Consulte as configurações da Microsoft para implantação de aplicativos Win32