Windows 앱 및 Codex CLI 배포

관리형 Windows 기기에 Windows 데스크톱 앱, Codex CLI 또는 둘 다를 배포하세요. 데스크톱에서 접근하려면 앱을, 터미널에서 접근하려면 CLI를 선택하세요.

데스크톱 앱과 독립 실행형 CLI는 설치 컨텍스트가 서로 다릅니다. CLI를 배포하기 전에 설치 프로그램을 실행할 계정을 선택하고 검증하세요.

Windows 앱 배포

사용하는 관리 도구와 기기에서 Microsoft 배포 서비스에 접근할 수 있는지에 따라 방법을 선택하세요.

배포하기 전에 관리형 구성을 참조하여 해당하는 제어를 구성하세요. 데스크톱 앱에서 Codex 명령 실행을 준비하려면 Windows 샌드박스 설정을 따르세요. 기기 호환성을 확인하고 필요한 레거시 설정을 완료하세요.

아래 MSIX 링크는 이전 버전이 아닌 각 아키텍처의 최신 릴리스를 다운로드합니다. 다운로드한 패키지를 검토하고 승인된 아티팩트를 배포 시스템에 보관하세요. 앱 업데이트 관리에 따라 앱의 내장 업데이터가 Microsoft Store, Intune 및 기타 배포 도구와 조화롭게 작동하도록 조정하세요.

   #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에 Codex CLI 배포하기

CLI 패키지를 준비하고 디바이스 정책을 적용한 다음, 직원 계정에서 터미널을 통한 접근을 확인하세요.

시작하기 전에

• 대상 Windows 디바이스와 사용자, 프로세서 아키텍처를 파악한 다음 설치 방법을 선택하세요. 사용자에게 Codex 접근 권한이 있고 조직의 로그인 절차를 완료할 수 있는지 확인하세요.

• Intune을 사용하는 경우 앱 관리 권한, Microsoft의 Win32 패키징 사전 요구 사항을 충족하는 등록된 디바이스, 무인 설치 패키지를 준비하세요.

• CLI 업데이트 및 제거 담당자를 지정하세요. npm을 사용하는 경우 관리되는 Node.js/npm 설치와 전역 패키지 위치를 고려하세요.

설치 방법 선택하기

설치 방법과 특정 CLI 릴리스를 선택하세요. GitHub의 CLI 릴리스를 검토한 다음, 예제의 <approved-version>를 x.y.z 형식의 승인된 버전 번호로 바꾸세요. 패키지와 검색 규칙에 동일한 버전을 사용하세요.

독립 실행형 설치 프로그램은 릴리스를 지정하지 않으면 기본적으로 latest를 사용합니다. 배포를 특정 릴리스로 고정하려면 -Release를 명시적으로 설정하세요. 설치 프로그램의 릴리스 매개변수를 참조하세요. 일반적인 설치 안내는 CLI 설치를 참조하세요.

독립 실행형 PowerShell 설치 프로그램. 새 PowerShell 창에서 설치 프로그램을 다운로드하고 승인된 릴리스를 전달하세요:

$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. 디바이스에서 Node.js와 npm을 이미 관리하고 있다면 승인된 패키지 버전을 명시적으로 선택하세요:

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

관리형 배포를 위해 검토된 설치 프로그램 또는 패키지 아티팩트와 선택한 릴리스를 IT 부서에서 관리하는 패키지에 포함하세요. 설치 컨텍스트, 검색, 제거 및 업데이트 동작을 정의하세요. 버전을 선택해도 설치 프로그램의 사용자 프로필 관련 기본값은 바뀌지 않으며, 완전한 무인 배포 래퍼가 제공되는 것도 아닙니다.

설치 컨텍스트 설정하기

독립 실행형 설치 프로그램은 기본적으로 현재 사용자의 프로필에 런타임 파일을 배치하고, %LOCALAPPDATA%\Programs\OpenAI\Codex\bin을 명령 디렉터리로 사용하며, 사용자 PATH 를 사용합니다.

설치 프로그램을 수정하지 않고 SYSTEM 으로 실행하면 SYSTEM 프로필과 환경이 대상이 됩니다. Intune에서 System 을 선택해도 모든 사용자를 위한 설치가 되지는 않습니다.

사용자 설치, 디바이스 정책 배포, 관리자가 승인한 샌드박스 설정을 분리하세요. 절차에 직원의 프로필이 필요한 경우 SYSTEM 대신 해당 직원의 계정을 사용하세요.

독립 실행형 런타임 파일은 함께 보관하세요. codex.exe만 복사하면 완전한 독립 실행형 패키지가 되지 않습니다.

Intune을 통해 CLI 패키징 및 할당하기

선택한 설치 컨텍스트에 맞는 무인 설치 프로그램, 제거 프로그램, 검색 로직을 포함하여 IT 부서에서 관리하는 Win32 패키지를 준비하고 검증하세요.

1. 승인된 설치 페이로드와 무인 설치 스크립트가 포함된 원본 폴더를 준비하세요. 스크립트가 latest를 자동으로 선택하도록 두지 말고 승인된 CLI 릴리스를 명시하세요. Microsoft 패키징 도구와 출력 폴더는 해당 원본 폴더 외부에 두세요.

2. Microsoft Win32 Content Prep Tool로 .intunewin 파일을 생성하세요. 이 예제에서는 검토된 설치 스크립트의 이름이 Install-Codex.ps1라고 가정합니다:

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

이 도구는 원본 폴더의 내용을 패키징합니다. Win32 앱 패키지 만들기를 참조하세요.

3. Intune에서 Windows 앱(Win32) 을 만들고 패키지를 업로드하세요.

4. 패키지에 맞게 설치 및 제거 명령, 사용자 또는 시스템 동작, 요구 사항, 검색 규칙을 설정하세요.

5. 필수 또는 등록된 디바이스에서 사용 가능 으로 할당합니다.

Intune에서는 무인 설치가 필요합니다. 사용자 지정 검색 스크립트는 종료 코드 0으로 종료하고 stdout에 출력해야 합니다. stderr에 출력하면 검색이 실패합니다. Win32 앱 추가 및 할당을 참조하세요.

관리 에이전트가 성공 종료 코드를 보고하더라도 직원 계정에서 CLI를 확인하세요.

Configuration Manager (SCCM)에서는 검토를 마친 CLI 설치 설계를 애플리케이션 워크플로에 적용하고, CLI 전용 설치 프로그램과 검색 규칙을 사용하세요. 데스크톱 앱의 MSIX 설정은 데스크톱 앱에만 적용됩니다.

관리형 요구 사항 구성

관리자가 적용하는 Windows 요구 사항을 다음 위치에 배포하세요:

%ProgramData%\OpenAI\Codex\requirements.toml

엔드포인트 관리 도구를 통해 파일을 배포하세요. 대상 사용자에게 읽기 권한을 부여하고 일반 사용자가 관리자 소유 정책을 변경하지 못하도록 하세요.

요구 사항은 설정을 제한하고, 구성 기본값은 초기 값을 제공합니다. 실제 적용되는 구성을 파악하려면 로컬 파일과 해당 클라우드 정책을 모두 검토하세요.

권한, 승인, 네트워크 액세스 및 샌드박스 동작에 대한 요구 사항을 선택하세요. 지원되는 필드와 우선순위는 관리형 구성을 참조하세요.

배포 후 직원 계정으로 Codex를 실행하고 /status 및 /debug-config를 사용하여 실제 적용되는 정책을 확인하세요. CLI를 설치하거나 요구 사항을 배포하는 것만으로는 워크스페이스 액세스 권한이 부여되지 않습니다.

Windows 샌드박스 구성

Windows 샌드박스를 선택하기 전에 디바이스 호환성을 확인하세요. Windows 샌드박스 가이드에서는 Microsoft Execution Containers (MXC)와 레거시 구현을 다룹니다.

호환되는 디바이스에서 MXC 우선 사용

CLI를 단독으로 사용하는 경우 config.toml에서 MXC 우선 사용을 활성화하세요:

[features]
prefer_mxc = true

requirements.toml을 통해 이 기능 값을 강제할 수도 있습니다. 이 우선 사용 설정은 MXC를 사용할 수 없을 때 레거시 구현으로의 대체를 허용합니다. 활성화하기 전에 Windows 샌드박스 가이드의 디바이스 요구 사항을 확인하세요.

CLI 버전 0.162.0 이상에서는 프로젝트 디렉터리에서 다음 호환성 검사를 실행하세요:

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

MXC_OK가 출력되고 종료 코드가 0인지 확인하세요. 이 검사는 MXC를 명시적으로 지정한 명령을 확인하므로, 직원의 일반 세션 구성도 점검하세요.

배포 전에 샌드박스 가이드의 네트워킹 제약 조건을 조직의 관리형 네트워크 정책과 비교하세요.

레거시 대체 방식 준비

MXC를 사용할 수 없거나 비활성화한 경우 elevated 레거시 대체 방식을 우선 사용하세요. 설정에는 관리자 승인이 필요하지만 샌드박스 내 명령은 관리자 권한 없이 실행됩니다.

직원 계정과 Codex 홈에 대해 IT 주도 설정 절차를 따르세요. 적절한 권한으로 승격된 프로세스에서 다음 예제를 실행하세요:

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

예제의 계정과 경로를 대상 사용자의 값으로 바꾸세요. 권한을 승격하여 설정할 때는 관리자가 신뢰하는 CLI 설치본을 사용하세요.

권한이 승격된 레거시 구현만 허용하려면 다음 내용을 %ProgramData%\OpenAI\Codex\requirements.toml에 추가하세요. config.toml에 추가하면 안 됩니다. 레거시 대체 방식 구성을 참조하세요:

[windows]
allowed_sandbox_implementations = ["elevated"]

이 설정은 MXC를 차단하지 않으면서 레거시 대체 방식을 제한합니다. unelevated를 허용하기 전에 네트워크 격리가 더 약하고 읽기 금지 경로를 지원하지 않는다는 점을 검토하세요.

CLI 배포 확인

대상 직원 계정으로 관리자 권한 없이 새 PowerShell 창을 여세요:

Get-Command codex
codex --version
codex

실행 파일이 의도한 설치본으로 확인되는지 확인한 다음 승인된 로그인 절차를 완료하세요. 지정된 테스트 프로젝트에서 작은 작업을 실행하고 활성 구성을 점검하세요.

업데이트 관리

데스크톱 앱

앱은 오프라인으로 설치한 후에도 기본적으로 업데이트를 확인합니다. 자동 업데이트를 활성화하려면 디바이스가 persistent.oaistatic.com에 연결할 수 있도록 허용하세요. 자동 업데이트를 비활성화하면 관리 도구를 통해 최신 패키지를 배포하세요.

모든 업데이트 경로를 조율하려면 앱 업데이트 관리를 따르세요. 기본 제공 업데이터를 비활성화해도 Microsoft Store, Intune 또는 기타 관리 도구의 앱 업데이트는 중단되지 않으며, OpenAI가 관리하는 버전 고정 기능이나 별도의 릴리스 채널이 제공되는 것도 아닙니다. 배포 시스템을 통해 설치된 버전을 확인하세요.

Codex CLI

CLI를 업데이트할 때마다 승인된 새 릴리스를 선택하고, 배포 패키지에 명시된 -Release 값 또는 npm 패키지 버전을 업데이트한 다음 검색 규칙을 업데이트하세요. 패키지 배포 절차에 따라 배포한 후 설치된 버전, 계정 컨텍스트 및 검색 동작을 확인하세요. 관리형 패키지를 명시적인 릴리스 지정이 없는 설치 명령으로 되돌리지 마세요. CLI 릴리스, CLI 설치 및 업데이트, npm 버전 선택을 참조하세요.

문제 해결

Codex CLI 설치 및 구성

관련 리소스

• CLI 설치

• 관리형 구성

• Windows 샌드박스 설정

• Windows용 ChatGPT 데스크톱 앱

• Microsoft Win32 패키징 가이드 참조

• Microsoft Win32 배포 설정 참조