Terapkan aplikasi Windows dan Codex CLI

Terapkan aplikasi desktop Windows dan Codex CLI dengan Intune, SCCM, atau alat pengelolaan perusahaan lainnya

Terapkan aplikasi desktop Windows, Codex CLI, atau keduanya pada perangkat Windows yang dikelola. Pilih aplikasi untuk akses desktop atau CLI untuk akses terminal.

Aplikasi desktop dan CLI mandiri menggunakan konteks instalasi yang berbeda. Sebelum menerapkan CLI, pilih dan validasi akun yang digunakan untuk menjalankan penginstalnya.

Tujuan Anda Mulai dengan
Mendistribusikan aplikasi desktop Terapkan aplikasi Windows
Memberi karyawan akses terminal mandiri Terapkan Codex CLI di Windows
Menerapkan persyaratan Codex di Windows Konfigurasikan persyaratan terkelola
Menyiapkan eksekusi perintah Windows Konfigurasikan sandbox Windows

Terapkan aplikasi Windows

Pilih metode berdasarkan alat pengelolaan Anda dan apakah perangkat dapat mengakses layanan distribusi Microsoft.

Sebelum penerapan, konfigurasikan kontrol yang berlaku menggunakan Konfigurasi terkelola. Untuk menyiapkan eksekusi perintah Codex di aplikasi desktop, ikuti Penyiapan sandbox Windows. Periksa kompatibilitas perangkat dan selesaikan penyiapan lama yang diperlukan.

Tautan MSIX di bawah mengunduh rilis terbaru untuk setiap arsitektur, bukan versi terdahulu. Tinjau paket yang diunduh dan simpan artefak yang disetujui dalam sistem penerapan Anda. Ikuti Kelola pembaruan aplikasi untuk mengoordinasikan pembaru bawaan aplikasi dengan Microsoft Store, Intune, dan alat penerapan lainnya.

Sumber paket

Terapkan melalui Microsoft Store

Gunakan integrasi Microsoft Store di Intune untuk menginstal dan memperbarui aplikasi.

  1. Di pusat admin Intune, buka Aplikasi > Semua aplikasi > Buat. Pilih Aplikasi Microsoft Store (baru).

  2. Cari ChatGPT dari OpenAI, atau masukkan ID produk Store 9PLM9XGG6VKS. Pilih aplikasi dan tinjau pengaturan instalasinya.

  3. Pada Informasi aplikasi, atur Perilaku instalasi ke Sistem.

  4. Di bagian Wajib, tambahkan grup target Anda agar Intune menginstal aplikasi secara otomatis, lalu pilih Buat.

Untuk instalasi opsional melalui Company Portal, gunakan Tersedia untuk perangkat terdaftar sebagai gantinya.

Perangkat memerlukan akses ke endpoint Microsoft Store dan Windows Update yang tercantum dalam persyaratan jaringan Microsoft. Jika endpoint tersebut diblokir, pilih MSIX luring.

Untuk konteks instalasi, persyaratan jaringan, dan pemantauan penerapan, lihat panduan aplikasi Store di Intune dari Microsoft.

Terapkan Codex CLI di Windows

Siapkan paket CLI, terapkan kebijakan perangkat Anda, dan verifikasi akses terminal dari akun karyawan.

Sebelum memulai

  • Identifikasi perangkat Windows dan pengguna yang menjadi target beserta arsitektur prosesornya, lalu pilih metode penginstalan. Pastikan pengguna memiliki akses Codex dan dapat menyelesaikan alur masuk organisasi Anda.

  • Untuk Intune, siapkan izin pengelolaan aplikasi, perangkat terdaftar yang memenuhi prasyarat pengemasan Win32 dari Microsoft, dan paket penginstalan tanpa interaksi pengguna.

  • Tetapkan penanggung jawab pembaruan dan penghapusan CLI. Jika Anda menggunakan npm, pertimbangkan penginstalan Node.js/npm yang dikelola serta lokasi paket globalnya.

Pilih metode penginstalan

Pilih metode penginstalan dan tentukan rilis CLI secara eksplisit. Tinjau rilis CLI di GitHub, lalu ganti <approved-version> dalam contoh dengan nomor versi yang Anda setujui dalam format x.y.z. Gunakan versi yang sama dalam paket dan aturan deteksi Anda.

Penginstal mandiri menggunakan latest secara default jika rilis tidak ditentukan. Tetapkan -Release secara eksplisit untuk mengunci penerapan ke rilis tertentu; lihat parameter rilis penginstal. Untuk panduan penginstalan umum, lihat penginstalan CLI.

Penginstal PowerShell mandiri. Dari jendela PowerShell baru, unduh penginstal dan berikan rilis yang disetujui:

$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. Jika Node.js dan npm sudah dikelola di perangkat, pilih versi paket yang disetujui secara eksplisit:

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

Untuk distribusi terkelola, sertakan penginstal atau artefak paket yang telah ditinjau beserta rilis yang dipilih dalam paket yang dikelola tim TI Anda. Tentukan konteks penginstalan, deteksi, penghapusan, dan perilaku pembaruan. Memilih versi tidak mengubah pengaturan default profil pengguna pada penginstal ataupun menyediakan skrip pembungkus lengkap untuk penerapan tanpa interaksi pengguna.

Tetapkan konteks penginstalan

Secara default, penginstal mandiri menempatkan file runtime di profil pengguna saat ini, menggunakan direktori perintah di %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, dan menggunakan User PATH.

Menjalankan penginstal tanpa modifikasi sebagai SYSTEM akan menargetkan profil dan lingkungan SYSTEM. Memilih Sistem di Intune tidak menjadikannya penginstalan untuk semua pengguna.

Pilihan penerapan Hal yang perlu divalidasi
Instal untuk karyawan yang sedang masuk Jalankan penginstalan dan deteksi dalam konteks pengguna tersebut. Buka terminal baru dan pastikan karyawan dapat menemukan dan menjalankan codex.
Buat paket untuk seluruh perangkat Tentukan dan validasi tata letak penginstalan pada komputer, file runtime, izin, ketersediaan melalui PATH, deteksi, dan penghapusan. Penginstal default tidak menyediakan rancangan ini.
Gunakan npm Pastikan prefiks paket global dan lokasi perintah untuk akun yang menjalankan npm. “Global” belum tentu berarti semua pengguna Windows.

Pisahkan penginstalan pengguna, distribusi kebijakan perangkat, dan penyiapan sandbox yang disetujui administrator. Jika suatu prosedur memerlukan profil karyawan, gunakan identitas karyawan tersebut alih-alih SYSTEM.

Simpan semua file runtime mandiri bersama-sama; menyalin hanya codex.exe tidak menghasilkan paket mandiri yang lengkap.

Kemas dan tetapkan CLI melalui Intune

Siapkan dan validasi paket Win32 yang dikelola tim TI dengan penginstal tanpa interaksi pengguna, program penghapus instalan, dan logika deteksi untuk konteks penginstalan yang dipilih.

  1. Siapkan folder sumber yang berisi muatan penginstalan yang disetujui dan skrip penyiapan tanpa interaksi pengguna Anda. Tentukan rilis CLI yang disetujui dalam skrip tersebut alih-alih membiarkannya memilih latest. Simpan alat pengemasan Microsoft dan folder keluaran di luar folder sumber tersebut.

  2. Buat file .intunewin dengan Microsoft Win32 Content Prep Tool. Contoh ini mengasumsikan skrip penyiapan yang telah Anda tinjau bernama Install-Codex.ps1:

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

Alat ini mengemas isi folder sumber. Lihat Membuat paket aplikasi Win32.

  1. Di Intune, buat Aplikasi Windows (Win32) dan unggah paketnya.

  2. Atur perintah penginstalan dan penghapusan instalan, perilaku Pengguna atau Sistem, persyaratan, dan aturan deteksi agar sesuai dengan paket.

  3. Tetapkan sebagai Wajib atau Tersedia untuk perangkat terdaftar.

Intune memerlukan instalasi tanpa interaksi pengguna. Skrip deteksi kustom harus keluar dengan kode 0 dan menulis ke stdout; keluaran pada stderr menyebabkan kegagalan deteksi. Lihat Menambahkan dan menetapkan aplikasi Win32.

Verifikasi CLI dari akun karyawan, meskipun agen pengelolaan melaporkan kode keluar yang menandakan keberhasilan.

Untuk Configuration Manager (SCCM), gunakan rancangan instalasi CLI yang telah ditinjau dalam alur kerja aplikasi Anda, dengan penginstal dan aturan deteksi khusus CLI. Pengaturan MSIX aplikasi desktop hanya berlaku untuk aplikasi desktop.

Konfigurasikan persyaratan terkelola

Secara default, terapkan persyaratan Windows yang diberlakukan administrator ke:

%ProgramData%\OpenAI\Codex\requirements.toml

Ganti lokasi ini dengan mengatur string RequirementsPath di bawah HKLM\SOFTWARE\Policies\OpenAI\Codex ke jalur file absolut.

Distribusikan berkas melalui alat pengelolaan endpoint Anda. Berikan akses baca kepada pengguna yang dituju dan cegah pengguna biasa mengubah kebijakan milik administrator.

Persyaratan membatasi pengaturan; nilai default konfigurasi menyediakan nilai awal. Tinjau berkas lokal dan kebijakan cloud yang berlaku untuk menentukan konfigurasi efektif.

Pilih persyaratan untuk izin, persetujuan, akses jaringan, dan perilaku sandbox. Lihat Konfigurasi terkelola untuk mengetahui bidang yang didukung dan urutan prioritasnya.

Setelah penerapan, jalankan Codex sebagai karyawan dan gunakan /status serta /debug-config untuk memastikan kebijakan efektif. Menginstal CLI atau mendistribusikan persyaratan tidak memberikan akses ke ruang kerja.

Konfigurasikan sandbox Windows

Periksa kompatibilitas perangkat sebelum memilih sandbox Windows. Panduan sandbox Windows membahas Microsoft Execution Containers (MXC) dan implementasi lama.

Utamakan MXC pada perangkat yang kompatibel

Untuk penggunaan CLI mandiri, aktifkan preferensi MXC di config.toml:

[features]
prefer_mxc = true

Anda juga dapat memberlakukan nilai fitur ini melalui requirements.toml. Preferensi ini mengizinkan penggunaan implementasi lama sebagai cadangan saat MXC tidak tersedia. Periksa persyaratan perangkat dalam panduan sandbox Windows sebelum mengaktifkannya.

Pada CLI versi 0.162.0 atau yang lebih baru, jalankan pemeriksaan kompatibilitas ini dari direktori proyek:

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

Hasil yang diharapkan adalah MXC_OK dan kode keluar 0. Ini memeriksa perintah MXC eksplisit; periksa juga konfigurasi sesi normal karyawan.

Sebelum peluncuran, bandingkan batasan jaringan dalam panduan sandbox dengan kebijakan jaringan terkelola Anda.

Siapkan implementasi lama sebagai cadangan

Saat MXC tidak tersedia atau dinonaktifkan, utamakan implementasi lama elevated sebagai cadangan. Implementasi ini memerlukan penyiapan yang disetujui administrator, tetapi perintah dalam sandbox berjalan tanpa hak administrator.

Ikuti prosedur penyiapan oleh tim TI untuk akun karyawan dan direktori utama Codex. Jalankan contoh ini dari proses dengan peningkatan hak akses yang sesuai:

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

Ganti contoh identitas dan jalur dengan nilai pengguna yang dituju. Gunakan instalasi CLI yang dipercaya administrator untuk penyiapan dengan peningkatan hak akses.

Untuk mengizinkan hanya implementasi lama dengan peningkatan hak akses, tambahkan yang berikut ke %ProgramData%\OpenAI\Codex\requirements.toml, bukan config.toml. Lihat Mengonfigurasi implementasi lama sebagai cadangan:

[windows]
allowed_sandbox_implementations = ["elevated"]

Ini membatasi penggunaan implementasi lama sebagai cadangan tanpa memblokir MXC. Sebelum mengizinkan unelevated, tinjau isolasi jaringannya yang lebih lemah dan tidak adanya dukungan untuk jalur yang akses bacanya ditolak.

Verifikasi penerapan CLI

Sebagai karyawan yang dituju, buka jendela PowerShell baru tanpa hak administrator:

Get-Command codex
codex --version
codex

Pastikan berkas yang dapat dieksekusi mengarah ke instalasi yang dituju, lalu selesaikan alur masuk yang disetujui. Jalankan tugas kecil dalam proyek pengujian yang ditentukan dan periksa konfigurasi aktif.

Pemeriksaan Tindakan dan hasil yang diharapkan
Konteks instalasi Pastikan CLI ditemukan dari akun karyawan yang dituju, termasuk setelah masuk kembali.
Deteksi alat pengelolaan Periksa bahwa perangkat yang telah diinstali CLI terdeteksi dan perangkat tanpa CLI, termasuk perangkat tempat CLI telah dihapus, tidak terdeteksi.
Persyaratan terkelola Pastikan sesi menampilkan kebijakan efektif yang diharapkan.
Sandbox Windows Verifikasi bahwa MXC berfungsi pada perangkat yang kompatibel dan implementasi lama cadangan yang disetujui telah disiapkan jika diperlukan.
Pembaruan Pastikan karyawan dapat menjalankan versi baru yang disetujui setelah penerapan.
Penghapusan Pastikan paket menghapus instalasi dan entri PATH-nya tanpa menghapus konfigurasi pengguna atau data proyek yang tidak terkait.

Kelola pembaruan

Aplikasi desktop

Secara default, aplikasi memeriksa pembaruan, termasuk setelah instalasi luring. Untuk mengaktifkan pembaruan otomatis, izinkan perangkat mengakses persistent.oaistatic.com. Jika Anda menonaktifkan pembaruan otomatis, terapkan paket terbaru melalui alat pengelolaan Anda.

Ikuti Mengelola pembaruan aplikasi untuk mengoordinasikan semua sumber pembaruan. Menonaktifkan pembaru bawaan tidak menghentikan Microsoft Store, Intune, atau alat pengelolaan lain memperbarui aplikasi, dan juga tidak menyediakan penguncian versi yang dikelola OpenAI atau saluran rilis terpisah. Pastikan versi yang terinstal melalui sistem penerapan Anda.

Codex CLI

Untuk setiap pembaruan CLI, pilih rilis baru yang disetujui, perbarui nilai -Release eksplisit atau versi paket npm dalam paket penerapan Anda, dan perbarui aturan deteksinya. Terapkan melalui proses pengelolaan paket Anda, lalu verifikasi versi yang terinstal, konteks akun, dan perilaku deteksi. Jangan mengembalikan paket terkelola ke perintah penginstal tanpa rilis eksplisit. Lihat Rilis CLI, Instalasi dan pembaruan CLI, dan Pemilihan versi npm.

Penghapusan instalan dan data lokal

Hapus instalan aplikasi desktop melalui Pengaturan Windows atau alat pengelolaan Anda, seperti Intune atau SCCM. Pembersihan berjalan secara otomatis selama penghapusan instalan.

Secara default, percakapan pemrograman dan pengaturan lokal disimpan di CODEX_HOME milik pengguna.

Untuk turut menghapus CODEX_HOME saat menghapus instalan, tambahkan ini ke config.toml di folder tersebut sebelum menghapus instalan:

[desktop]
uninstall_codex_home = true

Pemecahan masalah

Pengguna diminta memasukkan kredensial administrator saat menginstal

Saat pengguna menginstal aplikasi sendiri, administrator harus menyetujui instalasinya.

Untuk penyebaran Intune melalui Microsoft Store:

  1. Di pusat admin Intune, buka Aplikasi > Semua aplikasi dan pilih ChatGPT.

  2. Periksa Perilaku instalasi di Properti aplikasi. Jika nilainya Pengguna, tambahkan kembali aplikasi sebagai Aplikasi Microsoft Store (baru) dan pilih Sistem pada Informasi aplikasi.

  3. Tetapkan aplikasi ke grup sasaran Anda di bagian Wajib atau Tersedia untuk perangkat terdaftar. Jika Anda menambahkan aplikasi baru, hapus penetapan grup tersebut dari aplikasi awal.

  4. Sinkronkan perangkat yang terdampak dengan Intune, lalu periksa Status instalasi perangkat. Untuk penetapan yang tersedia, coba lagi instalasi di Company Portal.

Jika aplikasi sudah terinstal, penerapan dengan perilaku instalasi Sistem dapat menyebabkan Intune melaporkan 0x87D1041C. Instalasi tetap berhasil dalam skenario ini. Verifikasi aplikasi pada perangkat yang terdampak.

Instalasi gagal dengan kesalahan `0x80073D28`

Windows mengembalikan 0x80073D28 (ERROR_PACKAGED_SERVICE_REQUIRES_ADMIN_PRIVILEGES) saat tidak dapat menginstal layanan dalam paket tanpa hak administrator. Jalankan instalasi sebagai administrator, atau konfigurasikan alat penerapan Anda untuk menginstal dalam konteks perangkat atau System.

Untuk penyebaran SCCM yang sudah ada:

  1. Buka Properti > Jenis Penyebaran aplikasi.
  2. Edit jenis penyebaran Paket aplikasi Windows dan buka Pengalaman Pengguna.
  3. Aktifkan Sediakan aplikasi ini untuk semua pengguna di perangkat dan simpan.
  4. Perbarui kebijakan mesin klien, lalu coba ulangi instalasi di Software Center.

Untuk detail tentang pengaturan penyediaan, lihat pengaturan penerapan aplikasi dari Microsoft.

Instalasi dan konfigurasi Codex CLI

Gejala Yang perlu diperiksa
Intune melaporkan keberhasilan, tetapi karyawan tidak dapat menjalankan Codex Periksa akun instalasi, lokasi runtime, dan akun yang PATH-nya diperbarui. Penginstal tanpa modifikasi yang dijalankan sebagai SYSTEM tidak menginstal ke profil karyawan.
codex tidak dikenali setelah instalasi Buka terminal baru. Periksa direktori perintah dan PATH akun yang dituju.
Versi Codex yang salah dijalankan Gunakan Get-Command codex untuk memeriksa lokasi instalasi mandiri atau npm yang saling bersaing.
Pemeriksaan MXC gagal Periksa kemampuan perangkat, versi CLI, dan kebijakan terkelola dengan mengacu pada panduan sandbox Windows. Siapkan mekanisme cadangan lama yang disetujui jika sesuai.
Penyiapan sandbox lama meminta persetujuan administrator Selesaikan penyiapan yang dipimpin tim TI untuk identitas karyawan dan direktori utama Codex.
Pengaturan terkelola berbeda dari berkas persyaratan lokal Gunakan /status dan /debug-config untuk meninjau pengaturan yang berlaku, urutan prioritas kebijakan, dan bidang yang didukung.

Sumber daya terkait