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 を返し、標準出力に書き込む必要があります。標準エラー出力に書き込むと、検出に失敗します。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 展開設定