Documentação do ChatGPT
Português
Contacto goolvyouyou@gmail.com

Implementar a aplicação Windows e a Codex CLI

Implemente a aplicação de ambiente de trabalho Windows e a Codex CLI com Intune, SCCM ou outra ferramenta de gestão empresarial

Implemente a aplicação de ambiente de trabalho Windows, a Codex CLI ou ambas em dispositivos Windows geridos. Escolha a aplicação para acesso no ambiente de trabalho ou a CLI para acesso no terminal.

A aplicação de ambiente de trabalho e a CLI autónoma utilizam contextos de instalação diferentes. Antes de implementar a CLI, escolha e valide a conta utilizada para executar o respetivo instalador.

O seu objetivo Comece por
Distribuir a aplicação de ambiente de trabalho Implementar a aplicação Windows
Dar aos funcionários acesso autónomo ao terminal Implementar a Codex CLI no Windows
Aplicar requisitos do Codex no Windows Configurar requisitos geridos
Preparar a execução de comandos no Windows Configurar a sandbox do Windows

Implementar a aplicação Windows

Escolha um método com base na sua ferramenta de gestão e na possibilidade de os dispositivos acederem aos serviços de distribuição da Microsoft.

Antes da implementação, configure os controlos aplicáveis através de Configuração gerida. Para preparar a execução de comandos do Codex na aplicação de ambiente de trabalho, siga Configuração da sandbox do Windows. Verifique a compatibilidade dos dispositivos e conclua qualquer configuração legada necessária.

As ligações MSIX abaixo transferem a versão mais recente para cada arquitetura, e não uma versão anterior. Reveja o pacote transferido e mantenha o artefacto aprovado no seu sistema de implementação. Siga Gerir atualizações da aplicação para coordenar o atualizador integrado da aplicação com Microsoft Store, Intune e outras ferramentas de implementação.

Origem do pacote

Implementar através da Microsoft Store

Utilize a integração do Intune com a Microsoft Store para instalar e atualizar a aplicação.

  1. No centro de administração do Intune, aceda a Aplicações > Todas as aplicações > Criar. Selecione Aplicação da Microsoft Store (nova).

  2. Procure ChatGPT da OpenAI ou introduza o ID de produto da Store 9PLM9XGG6VKS. Selecione a aplicação e reveja as respetivas definições de instalação.

  3. Em Informações da aplicação, defina Comportamento de instalação como Sistema.

  4. Em Obrigatório, adicione o grupo de destino para que o Intune instale a aplicação automaticamente e, em seguida, selecione Criar.

Para uma instalação opcional através do Company Portal, utilize Disponível para dispositivos inscritos.

Os dispositivos precisam de acesso aos endpoints da Microsoft Store e do Windows Update indicados nos requisitos de rede da Microsoft. Se estes endpoints estiverem bloqueados, selecione MSIX offline.

Para obter informações sobre o contexto de instalação, os requisitos de rede e a monitorização da implementação, consulte o guia de aplicações da Store no Intune da Microsoft.

Implementar o Codex CLI no Windows

Prepare o pacote da CLI, aplique a política de dispositivos e verifique o acesso ao terminal a partir da conta do colaborador.

Antes de começar

  • Identifique os dispositivos Windows e os utilizadores de destino, bem como as respetivas arquiteturas de processador, e escolha um método de instalação. Confirme que os utilizadores têm acesso ao Codex e conseguem concluir o fluxo de início de sessão da sua organização.

  • Para o Intune, prepare as permissões de gestão de aplicações, dispositivos inscritos que cumpram os pré-requisitos da Microsoft para o empacotamento Win32 e um pacote de instalação não assistida.

  • Atribua a responsabilidade pelas atualizações e pela remoção da CLI. Se utilizar npm, tenha em conta a instalação gerida do Node.js/npm e a localização dos respetivos pacotes globais.

Escolher um método de instalação

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

O instalador autónomo utiliza latest por predefinição quando não é especificada nenhuma versão. Defina -Release explicitamente para fixar a implementação numa versão; consulte o parâmetro de versão do instalador. Para orientações gerais de instalação, consulte Instalação da CLI.

Instalador autónomo do PowerShell. Numa nova janela do PowerShell, transfira o instalador e indique a versão aprovada:

$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 geridos no dispositivo, selecione explicitamente a versão aprovada do pacote:

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

Para uma distribuição gerida, mantenha o instalador ou o artefacto do pacote revisto e a versão selecionada no pacote sob a responsabilidade da equipa de TI. Defina o contexto de instalação e o comportamento de deteção, remoção e atualização. Selecionar uma versão não altera as predefinições do instalador relativas ao perfil de utilizador nem fornece um invólucro completo para uma implementação não assistida.

Definir o contexto de instalação

O instalador autónomo utiliza, por predefinição, ficheiros de execução no perfil do utilizador atual, um diretório de comandos em %LOCALAPPDATA%\Programs\OpenAI\Codex\bin e o PATH do utilizador.

Executar o instalador sem alterações como SYSTEM tem como destino o perfil e o ambiente de SYSTEM. Selecionar System no Intune não transforma esta instalação numa instalação para todos os utilizadores.

Opção de implementação O que validar
Instalar para o colaborador com sessão iniciada Execute a instalação e a deteção no contexto desse utilizador. Abra um novo terminal e confirme que o colaborador consegue localizar e executar codex.
Criar um pacote para todo o dispositivo Defina e valide a estrutura de instalação no computador, os ficheiros de execução, as permissões, a disponibilização no PATH, a deteção e a remoção. O instalador predefinido não fornece esta estrutura.
Utilizar npm Confirme o prefixo dos pacotes globais e a localização dos comandos para a conta que executa o npm. «Global» não significa necessariamente todos os utilizadores do Windows.

Separe a instalação para o utilizador, a distribuição da política de dispositivos e a configuração da sandbox aprovada pelo administrador. Quando um procedimento exigir o perfil de um colaborador, utilize a identidade desse colaborador em vez de SYSTEM.

Mantenha os ficheiros de execução autónomos juntos; copiar apenas codex.exe não constitui um pacote autónomo completo.

Empacotar e atribuir a CLI através do Intune

Prepare e valide um pacote Win32 sob a responsabilidade da equipa de TI, com um instalador não assistido, um desinstalador e lógica de deteção para o contexto de instalação escolhido.

  1. Prepare uma pasta de origem que contenha os ficheiros de instalação aprovados e o script de configuração não assistida. Especifique nesse script a versão aprovada da CLI em vez de permitir que selecione latest. Mantenha a ferramenta de empacotamento da Microsoft e a pasta de saída fora dessa pasta de origem.

  2. Gere o ficheiro .intunewin com a Microsoft Win32 Content Prep Tool. Este exemplo pressupõe que o script de configuração revisto tem o nome Install-Codex.ps1:

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

A ferramenta empacota o conteúdo da pasta de origem. Consulte Criar um pacote de aplicação Win32.

  1. No Intune, crie uma Aplicação Windows (Win32) e carregue o pacote.

  2. Defina os comandos de instalação e desinstalação, o comportamento de Utilizador ou Sistema, os requisitos e as regras de deteção de acordo com o pacote.

  3. Atribua-o como Obrigatório ou Disponível para dispositivos inscritos.

O Intune requer uma instalação sem intervenção. Os scripts de deteção personalizados têm de terminar com o código 0 e escrever em stdout; a saída em stderr provoca uma falha na deteção. Consulte Adicionar e atribuir uma aplicação Win32.

Verifique a CLI a partir da conta do colaborador, mesmo quando o agente de gestão comunica um código de saída de sucesso.

Para o Configuration Manager (SCCM), utilize o plano de instalação da CLI revisto no seu fluxo de trabalho de aplicações, com um instalador e uma regra de deteção específicos da CLI. As definições MSIX da aplicação de ambiente de trabalho aplicam-se apenas a essa aplicação.

Configurar requisitos geridos

Implemente os requisitos do Windows impostos pelo administrador em:

%ProgramData%\OpenAI\Codex\requirements.toml

Distribua o ficheiro através da sua ferramenta de gestão de dispositivos. Conceda acesso de leitura aos utilizadores a que se destina e impeça os utilizadores comuns de alterarem a política pertencente ao administrador.

Os requisitos limitam as definições; os valores predefinidos de configuração fornecem os valores iniciais. Reveja tanto o ficheiro local como a política de nuvem aplicável para determinar a configuração efetiva.

Escolha os requisitos para permissões, aprovações, acesso à rede e comportamento da sandbox. Consulte Configuração gerida para obter informações sobre os campos suportados e a precedência.

Após a implementação, inicie o Codex com a conta do colaborador e utilize /status e /debug-config para confirmar a política efetiva. A instalação da CLI ou a distribuição de requisitos não concede acesso ao espaço de trabalho.

Configurar a sandbox do Windows

Verifique a compatibilidade do dispositivo antes de escolher uma sandbox do Windows. O guia da sandbox do Windows abrange Microsoft Execution Containers (MXC) e as implementações legadas.

Dar preferência a MXC em dispositivos compatíveis

Para utilizar a CLI de forma autónoma, ative a preferência por MXC em config.toml:

[features]
prefer_mxc = true

Também pode impor este valor da funcionalidade através de requirements.toml. A preferência permite recorrer à alternativa legada quando MXC não está disponível. Verifique os requisitos do dispositivo no guia da sandbox do Windows antes de a ativar.

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 e um código de saída de 0. Isto verifica o comando MXC explícito; inspecione também a configuração habitual da sessão do colaborador.

Antes da implementação geral, compare as restrições de rede do guia da sandbox com a sua política de rede gerida.

Preparar a alternativa legada

Quando MXC não está disponível ou está desativado, dê preferência à alternativa legada elevated. Esta requer uma configuração aprovada pelo administrador, mas os comandos na sandbox são executados sem privilégios de administrador.

Siga o procedimento de configuração conduzido pela equipa de TI para a conta do colaborador e o diretório base do Codex. Execute este exemplo a partir de um processo com os privilégios elevados adequados:

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

Substitua a identidade e o caminho do exemplo pelos valores do utilizador pretendido. Utilize uma instalação da CLI considerada fidedigna pelo administrador para a configuração com privilégios elevados.

Para permitir apenas a implementação legada com privilégios elevados, adicione o seguinte a %ProgramData%\OpenAI\Codex\requirements.toml, e não a config.toml. Consulte Configurar uma alternativa legada:

[windows]
allowed_sandbox_implementations = ["elevated"]

Isto restringe a alternativa legada sem bloquear MXC. Antes de permitir unelevated, reveja o seu isolamento de rede mais fraco e a ausência de suporte para caminhos com leitura negada.

Verificar a implementação da CLI

Com a conta de um colaborador a que se destina a implementação, abra uma nova janela do PowerShell sem privilégios de administrador:

Get-Command codex
codex --version
codex

Confirme que o executável é resolvido para a instalação pretendida e, em seguida, conclua o fluxo de início de sessão aprovado. Execute uma pequena tarefa num projeto de teste designado e inspecione a configuração ativa.

Verificação Ação e resultado esperado
Contexto de instalação Confirme que a CLI é resolvida a partir da conta do colaborador pretendido, incluindo após um novo início de sessão.
Deteção pela ferramenta de gestão Verifique se os dispositivos com a CLI instalada são detetados e se os dispositivos sem a CLI, incluindo aqueles dos quais foi removida, não são detetados.
Requisitos geridos Confirme que a sessão apresenta a política efetiva esperada.
Sandbox do Windows Verifique se MXC funciona em dispositivos compatíveis e se a alternativa legada aprovada está aprovisionada onde for necessário.
Atualização Confirme que o colaborador consegue executar a nova versão aprovada após a implementação.
Remoção Confirme que o pacote remove a respetiva instalação e entrada em PATH sem eliminar configurações de utilizador ou dados de projetos não relacionados.

Gerir atualizações

Aplicação de ambiente de trabalho

A aplicação procura atualizações por predefinição, incluindo após uma instalação sem ligação à Internet. Para ativar as atualizações automáticas, permita que os dispositivos acedam a persistent.oaistatic.com. Se desativar as atualizações automáticas, implemente pacotes mais recentes através da sua ferramenta de gestão.

Siga as instruções em Gerir atualizações da aplicação para coordenar todas as fontes de atualização. Desativar o atualizador integrado não impede que a Microsoft Store, o Intune ou outras ferramentas de gestão atualizem a aplicação, nem permite fixar uma versão sob gestão da OpenAI ou disponibiliza um canal de lançamento separado. Confirme a versão instalada através do seu sistema de implementação.

Codex CLI

Para 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 seu pacote de implementação e atualize a respetiva regra de deteção. Implemente através do seu processo de pacotes e, em seguida, verifique a versão instalada, o contexto da conta e o comportamento da deteção. Não volte a alterar o pacote gerido para um comando de instalação sem uma versão explícita. Consulte Versões da CLI, Instalação e atualizações da CLI e Seleção de versões do npm.

Resolução de problemas

São solicitadas credenciais de administrador aos utilizadores durante a instalação

Quando os próprios utilizadores instalam a aplicação, um administrador tem de aprovar a instalação.

Para uma implementação com o Intune através da Microsoft Store:

  1. No centro de administração do Intune, aceda a Aplicações > Todas as aplicações e selecione ChatGPT.

  2. Verifique Comportamento de instalação nas Propriedades da aplicação. Se estiver definido como Utilizador, adicione novamente a aplicação como Aplicação da Microsoft Store (nova) e selecione Sistema em Informações da aplicação.

  3. Atribua a aplicação ao grupo de destino em Obrigatório ou Disponível para dispositivos inscritos. Se adicionou uma nova aplicação, remova a atribuição desse grupo da aplicação original.

  4. Sincronize o dispositivo afetado com o Intune e, em seguida, verifique Estado de instalação do dispositivo. Para uma atribuição disponível, volte a tentar a instalação no Portal da Empresa.

Se a aplicação já estiver instalada, implementá-la com o comportamento de instalação Sistema pode fazer com que o Intune comunique 0x87D1041C. A instalação continua a ser concluída com êxito neste cenário. Verifique a aplicação no dispositivo afetado.

A instalação falha com o erro `0x80073D28`

O Windows devolve 0x80073D28 (ERROR_PACKAGED_SERVICE_REQUIRES_ADMIN_PRIVILEGES) quando não consegue instalar um serviço incluído num pacote sem privilégios de administrador. Execute a instalação como administrador ou configure a sua ferramenta de implementação para instalar no contexto do dispositivo ou de Sistema.

Para uma implementação existente com o SCCM:

  1. Abra as Propriedades > Tipos de implementação da aplicação.
  2. Edite o tipo de implementação Pacote de aplicação do Windows e abra Experiência do utilizador.
  3. Ative Aprovisionar esta aplicação para todos os utilizadores do dispositivo e guarde.
  4. Atualize a política de máquina do cliente e, em seguida, tente novamente a instalação no Software Center.

Para obter detalhes sobre a definição de aprovisionamento, consulte as definições de implementação de aplicações da Microsoft.

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

Sintoma O que verificar
O Intune indica sucesso, mas o colaborador não consegue executar o Codex Verifique a conta de instalação, a localização do ambiente de execução e a conta cujo PATH foi atualizado. O instalador sem alterações, executado como SYSTEM, não instala no perfil do colaborador.
codex não é reconhecido após a instalação Abra um novo terminal. Verifique o diretório de comandos e o PATH da conta pretendida.
É iniciada a versão errada do Codex Utilize Get-Command codex para verificar se existem localizações concorrentes de instalações autónomas ou via npm.
O teste de MXC falha Verifique as capacidades do dispositivo, a versão da CLI e a política gerida face ao guia da sandbox do Windows. Disponibilize a alternativa legada aprovada, quando adequado.
A configuração da sandbox legada pede aprovação de administrador Conclua a configuração orientada pela equipa de TI para a identidade do colaborador e o diretório base do Codex.
As definições geridas diferem do ficheiro de requisitos local Utilize /status e /debug-config para rever as definições efetivas, a precedência das políticas e os campos suportados.

Recursos relacionados