Windows 앱 및 Codex CLI 배포

관리 대상 Windows 디바이스에 Windows 데스크톱 앱과 Codex CLI 중 하나 또는 둘 다 배포할 수 있습니다. 데스크톱에서 사용하려면 앱을, 터미널에서 사용하려면 CLI를 선택하세요.

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

Windows 앱 배포

사용 중인 관리 도구와 디바이스의 Microsoft 배포 서비스 접근 가능 여부에 따라 배포 방법을 선택하세요.

배포하기 전에 엔터프라이즈 설정을 참고해 필요한 제어 항목을 구성하세요. 데스크톱 앱에서 Codex 명령어를 실행할 수 있도록 Windows 샌드박스 설정에 따라 디바이스 호환성을 확인하고 필요한 레거시 설정을 완료하세요.

아래 MSIX 링크에서는 아키텍처별 최신 릴리스만 다운로드할 수 있습니다. 다운로드한 패키지를 검토하고 승인된 아티팩트를 배포 시스템에 보관하세요. 앱 업데이트 관리에 따라 앱의 기본 제공 업데이트 프로그램과 Microsoft Store, Intune 및 기타 배포 도구의 업데이트를 조율하세요.

%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

Windows에 Codex CLI 배포

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 대신 해당 직원 계정으로 수행하세요.

독립 실행형 런타임 파일은 함께 보관하세요. codex.exe만 복사하면 독립 실행형 패키지에 필요한 파일이 누락됩니다.

Intune을 통한 CLI 패키징 및 할당

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

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

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

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

관리형 요구 사항 구성

관리자가 강제 적용할 Windows 요구 사항 파일의 기본 배포 위치는 다음과 같습니다.

%ProgramData%\OpenAI\Codex\requirements.toml

다른 위치를 사용하려면 RequirementsPath 문자열 값을 HKLM\SOFTWARE\Policies\OpenAI\Codex 레지스트리 키 아래에 설정하세요. 값으로는 요구 사항 파일의 절대 경로를 지정하세요.

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

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

권한, 승인, 네트워크 접근 및 샌드박스 동작에 대한 요구 사항을 선택하세요. 지원되는 필드와 우선순위는 엔터프라이즈 설정을 참고하세요.

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

Windows 샌드박스 구성

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

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

독립 실행형 CLI에서 MXC를 우선 사용하려면 config.toml에서 다음 설정을 활성화하세요.

[features]
prefer_mxc = true

requirements.toml을 통해서도 이 기능의 설정값을 강제 적용할 수 있습니다. MXC를 우선하도록 설정해도 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 버전 선택을 참고하세요.

앱 제거 및 로컬 데이터

Windows 설정 또는 Intune, SCCM 등의 관리 도구에서 데스크톱 앱을 제거하세요. 제거 중에 정리 작업이 자동으로 실행됩니다.

기본적으로 로컬 코딩 채팅과 설정은 사용자의 CODEX_HOME에 보존됩니다.

앱을 제거할 때 CODEX_HOME도 삭제하려면 제거하기 전에 해당 폴더의 config.toml에 다음 설정을 추가하세요.

[desktop]
uninstall_codex_home = true

문제 해결

Codex CLI 설치 및 구성

관련 자료

• CLI 설치

• 엔터프라이즈 설정

• Windows 샌드박스 설정

• Windows용 ChatGPT 데스크톱 앱

• Microsoft Win32 패키징 가이드 참고

• Microsoft Win32 배포 설정 참고