Windows uygulamasını ve Codex CLI'ı dağıtın

Windows masaüstü uygulamasını, Codex CLI'ı veya her ikisini yönetilen Windows cihazlarına dağıtın. Masaüstü erişimi için uygulamayı, terminal erişimi için CLI'ı seçin.

Masaüstü uygulaması ve bağımsız CLI farklı kurulum bağlamları kullanır. CLI'ı dağıtmadan önce yükleyicisini çalıştırmak için kullanılacak hesabı seçin ve doğrulayın.

Windows uygulamasını dağıtın

Yönetim aracınıza ve cihazların Microsoft'un dağıtım hizmetlerine erişip erişemediğine göre bir yöntem seçin.

Dağıtımdan önce, Yönetilen yapılandırma kılavuzunu kullanarak geçerli denetimleri yapılandırın. Masaüstü uygulamasında Codex komutlarının yürütülmesini hazırlamak için Windows korumalı alan kurulumu kılavuzunu izleyin. Cihaz uyumluluğunu kontrol edin ve gerekiyorsa eski sistemler için kurulum adımlarını tamamlayın.

Aşağıdaki MSIX bağlantıları, her mimari için geçmiş bir sürümü değil, en son sürümü indirir. İndirilen paketi inceleyin ve onaylanan dosyayı dağıtım sisteminizde saklayın. Uygulamanın yerleşik güncelleyicisini Microsoft Store, Intune ve diğer dağıtım araçlarıyla koordine etmek için Uygulama güncellemelerini yönetin kılavuzunu izleyin.

   #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

Windows'ta Codex CLI dağıtımı

CLI paketini hazırlayın, cihaz politikanızı uygulayın ve çalışanın hesabından terminal erişimini doğrulayın.

Başlamadan önce

• Hedef Windows cihazlarını, kullanıcıları ve işlemci mimarilerini belirleyin, ardından bir kurulum yöntemi seçin. Kullanıcıların Codex erişimine sahip olduğunu ve kuruluşunuzun oturum açma akışını tamamlayabildiğini doğrulayın.

• Intune için uygulama yönetimi izinlerini, Microsoft'un Win32 paketleme ön koşullarını karşılayan kayıtlı cihazları ve katılımsız kurulum paketini hazırlayın.

• CLI güncellemeleri ve kaldırma işlemleri için sorumluları belirleyin. npm kullanıyorsanız yönetilen Node.js/npm kurulumunu ve genel paket konumunu hesaba katın.

Bir kurulum yöntemi seçin

Bir kurulum yöntemi ve belirli bir CLI sürümü seçin. GitHub'daki CLI sürümlerini inceleyin, ardından örneklerdeki <approved-version> yer tutucusunu x.y.z biçimindeki onaylı sürüm numaranızla değiştirin. Paketinizde ve algılama kuralınızda aynı sürümü kullanın.

Bağımsız yükleyici, sürüm belirtilmediğinde varsayılan olarak latest değerini kullanır. Dağıtımı belirli bir sürüme sabitlemek için -Release parametresini açıkça belirtin; yükleyicinin sürüm parametresine bakın. Genel kurulum yönergeleri için CLI kurulumu bölümüne bakın.

Bağımsız PowerShell yükleyicisi. Yeni bir PowerShell penceresinde yükleyiciyi indirin ve onaylı sürümü parametre olarak iletin:

$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. Cihazda Node.js ve npm zaten yönetiliyorsa onaylı paket sürümünü açıkça seçin:

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

Yönetilen dağıtım için incelenmiş yükleyiciyi veya paket çıktısını ve seçilen sürümü BT ekibinizin sorumluluğundaki pakette saklayın. Kurulum bağlamını, algılama, kaldırma ve güncelleme davranışlarını tanımlayın. Bir sürüm seçmek, yükleyicinin kullanıcı profiline ilişkin varsayılanlarını değiştirmez veya gözetimsiz dağıtım için eksiksiz bir sarmalayıcı sağlamaz.

Kurulum bağlamını ayarlayın

Bağımsız yükleyici, varsayılan olarak çalışma zamanı dosyalarını geçerli kullanıcının profiline yerleştirir, komut dizini olarak %LOCALAPPDATA%\Programs\OpenAI\Codex\bin konumunu kullanır ve kullanıcı PATH değişkenini ayarlar.

Yükleyiciyi değiştirmeden SYSTEM olarak çalıştırmak, SYSTEM profilini ve ortamını hedefler. Intune'da System seçeneğini seçmek, kurulumu tüm kullanıcılar için geçerli hâle getirmez.

Kullanıcı kurulumunu, cihaz ilkesinin dağıtımını ve yönetici onaylı korumalı alan kurulumunu ayrı tutun. Bir işlem çalışanın profilini gerektiriyorsa SYSTEM yerine ilgili çalışanın kimliğini kullanın.

Bağımsız çalışma zamanı dosyalarını bir arada tutun; yalnızca codex.exe dosyasını kopyalamak, eksiksiz bir bağımsız paket oluşturmaz.

CLI'yi Intune üzerinden paketleyin ve atayın

Seçilen kurulum bağlamı için gözetimsiz yükleyici, kaldırıcı ve algılama mantığı içeren, BT ekibinin sorumluluğunda bir Win32 paketi hazırlayıp doğrulayın.

1. Onaylı kurulum içeriğini ve gözetimsiz kurulum betiğinizi içeren bir kaynak klasör hazırlayın. Betiğin latest değerini çözümlemesine izin vermek yerine, onaylı CLI sürümünü bu betikte belirtin. Microsoft paketleme aracını ve çıktı klasörünü bu kaynak klasörün dışında tutun.

2. Microsoft Win32 Content Prep Tool ile .intunewin dosyasını oluşturun. Bu örnekte, incelenmiş kurulum betiğinizin adının Install-Codex.ps1 olduğu varsayılır:

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

Araç, kaynak klasörün içeriğini paketler. Win32 uygulama paketi oluşturma bölümüne bakın.

3. Intune'da bir Windows app (Win32) oluşturun ve paketi yükleyin.

4. Yükleme ve kaldırma komutlarını, User veya System davranışını, gereksinimleri ve algılama kurallarını pakete uygun şekilde ayarlayın.

5. Paketi Required veya Available for enrolled devices olarak atayın.

Intune, gözetimsiz kurulum gerektirir. Özel algılama betikleri 0 koduyla çıkmalı ve stdout'a çıktı yazmalıdır; stderr'e yazılan çıktı, algılamanın başarısız olmasına neden olur. Win32 uygulaması ekleme ve atama bölümüne bakın.

Yönetim ajanı başarılı bir çıkış kodu bildirse bile CLI'yi çalışanın hesabından doğrulayın.

Configuration Manager (SCCM) için uygulama iş akışınızda, CLI'ye özgü bir yükleyici ve algılama kuralıyla birlikte incelenmiş CLI kurulum tasarımını kullanın. Masaüstü uygulamasının MSIX ayarları yalnızca masaüstü uygulaması için geçerlidir.

Yönetilen gereksinimleri yapılandırın

Yönetici tarafından zorunlu tutulan Windows gereksinimlerini şu konuma dağıtın:

%ProgramData%\OpenAI\Codex\requirements.toml

Dosyayı uç nokta yönetim aracınız üzerinden dağıtın. Hedef kullanıcılara okuma erişimi verin ve standart kullanıcıların yöneticiye ait ilkeyi değiştirmesini engelleyin.

Gereksinimler ayarları sınırlar; yapılandırma varsayılanları ise başlangıç değerlerini sağlar. Etkin yapılandırmayı belirlemek için hem yerel dosyayı hem de geçerli bulut ilkesini inceleyin.

İzinler, onaylar, ağ erişimi ve korumalı alan davranışı için gereksinimleri seçin. Desteklenen alanlar ve öncelik sırası için Yönetilen yapılandırma bölümüne bakın.

Dağıtımdan sonra Codex'i çalışanın kimliğiyle başlatın ve etkin ilkeyi doğrulamak için /status ve /debug-config komutlarını kullanın. CLI'yi kurmak veya gereksinimleri dağıtmak, çalışma alanına erişim sağlamaz.

Windows korumalı alanını yapılandırın

Bir Windows korumalı alanı seçmeden önce cihaz uyumluluğunu kontrol edin. Windows korumalı alan kılavuzu, Microsoft Execution Containers (MXC) ve eski uygulamaları kapsar.

Uyumlu cihazlarda MXC'yi tercih edin

Bağımsız CLI kullanımı için config.toml dosyasında MXC tercihini etkinleştirin:

[features]
prefer_mxc = true

Bu özellik değerini requirements.toml üzerinden de zorunlu kılabilirsiniz. Bu tercih, MXC kullanılamadığında eski uygulamaya geri dönülmesine izin verir. Etkinleştirmeden önce Windows korumalı alan kılavuzundaki cihaz gereksinimlerini kontrol edin.

CLI'nin 0.162.0 veya sonraki bir sürümünde, bir proje dizininden şu uyumluluk denetimini çalıştırın:

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

MXC_OK çıktısını ve 0 çıkış kodunu almanız gerekir. Bu işlem, açıkça MXC kullanan komutu denetler; çalışanın normal oturum yapılandırmasını da inceleyin.

Dağıtıma geçmeden önce korumalı alan kılavuzundaki ağ kısıtlamalarını yönetilen ağ ilkenizle karşılaştırın.

Eski uygulamaya geri dönüşü hazırlayın

MXC kullanılamadığında veya devre dışı bırakıldığında, geri dönüş seçeneği olarak elevated eski uygulamasını tercih edin. Bu uygulama yönetici onaylı kurulum gerektirir, ancak korumalı alandaki komutlar yönetici ayrıcalıkları olmadan çalışır.

Çalışan hesabı ve Codex ana dizini için BT ekibi tarafından yürütülen kurulum prosedürünü izleyin. Bu örneği, gerekli yükseltilmiş ayrıcalıklara sahip bir işlemden çalıştırın:

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

Örnekteki kimliği ve yolu hedef kullanıcının değerleriyle değiştirin. Yükseltilmiş ayrıcalıklarla kurulum için yöneticinin güvendiği bir CLI kurulumu kullanın.

Yalnızca yükseltilmiş ayrıcalıklı eski uygulamaya izin vermek için aşağıdakileri %ProgramData%\OpenAI\Codex\requirements.toml dosyasına ekleyin; config.toml dosyasına eklemeyin. Eski uygulamaya geri dönüşü yapılandırma bölümüne bakın:

[windows]
allowed_sandbox_implementations = ["elevated"]

Bu, MXC'yi engellemeden eski yönteme geri dönüşü kısıtlar. unelevated seçeneğine izin vermeden önce, bu seçeneğin daha zayıf ağ yalıtımını ve okuma erişimi engellenen yolları desteklememesini değerlendirin.

CLI dağıtımını doğrulayın

Hedef çalışan hesabıyla, yönetici ayrıcalıkları olmadan yeni bir PowerShell penceresi açın:

Get-Command codex
codex --version
codex

Yürütülebilir dosyanın hedeflenen kurulumdan çözümlendiğini doğrulayın, ardından onaylanan oturum açma akışını tamamlayın. Belirlenen bir test projesinde küçük bir görev çalıştırın ve etkin yapılandırmayı inceleyin.

Güncellemeleri yönetin

Masaüstü uygulaması

Uygulama, çevrimdışı kurulumdan sonra da varsayılan olarak güncellemeleri denetler. Otomatik güncellemeleri etkinleştirmek için cihazların persistent.oaistatic.com adresine erişmesine izin verin. Otomatik güncellemeleri devre dışı bırakırsanız daha yeni paketleri yönetim aracınız üzerinden dağıtın.

Tüm güncelleme kaynaklarını koordine etmek için Uygulama güncellemelerini yönetme yönergelerini izleyin. Yerleşik güncelleyiciyi devre dışı bırakmak, Microsoft Store, Intune veya diğer yönetim araçlarının uygulamayı güncellemesini engellemez; OpenAI tarafından yönetilen sürüm sabitleme veya ayrı bir yayın kanalı da sağlamaz. Kurulu sürümü dağıtım sisteminiz üzerinden doğrulayın.

Codex CLI

Her CLI güncellemesinde onaylanan yeni bir sürüm seçin, dağıtım paketinizdeki açıkça belirtilen -Release değerini veya npm paketi sürümünü ve algılama kuralını güncelleyin. Paket süreciniz üzerinden dağıtın, ardından kurulu sürümü, hesap bağlamını ve algılama davranışını doğrulayın. Yönetilen paketi, açıkça bir sürüm belirtmeyen yükleyici komutuna geri döndürmeyin. CLI sürümleri, CLI kurulumu ve güncellemeleri ve npm sürüm seçimi kaynaklarına bakın.

Sorun giderme

Codex CLI kurulumu ve yapılandırması

İlgili kaynaklar

• CLI kurulumu

• Yönetilen yapılandırma

• Windows korumalı alan kurulumu

• Windows için ChatGPT masaüstü uygulaması

• Microsoft Win32 paketleme kılavuzuna bakın

• Microsoft Win32 dağıtım ayarlarına bakın