Windowsサンドボックスの早見
CodexのWindowsサンドボックスとは?3つの方式の違いと選び方
WindowsでCodexを使うと、コマンドはサンドボックスの中で動きます。公式は、mxc・elevated・unelevated の3つの方式を案内しています。違い、設定の書き方、必要なWindowsの版、管理者の承認、エラー1385などの困りごとを、OpenAI公式の文書(2026年11月16日確認)に沿って整理します。
最初に答え
Windowsのサンドボックスは3つの方式があります。公式の順は mxc(推奨)→ elevated → unelevated です。
| 方式 | 特徴 |
|---|---|
mxc(推奨) | Windowsの機能によるプロセスの隔離。管理者の承認が要る準備も、追加のWindowsアカウントも、ローカルのファイアウォール規則も要りません。特定のWindowsの版が必要 |
elevated | 管理者の承認が必要。権限の低い専用ユーザー、ファイルの権限の境界、ファイアウォール規則を使う。コマンド自体は管理者権限なしで動く。読み取りを禁じるパスの指定に対応し、ネットワークの隔離も強い |
unelevated | elevated を使えない時の代替。いまのユーザーから作った制限付きのトークンで動く。ネットワークの隔離は弱く、読み取りを禁じるパスの指定には非対応 |
elevated と unelevated は、どちらも既定で専用のデスクトップを使い、画面まわりの隔離を強めています。
config.tomlでの選び方
elevated か unelevated を指定する時は、config.toml に次のように書きます。
[windows]
sandbox = "elevated" # または "unelevated"mxcを優先する設定は、次のとおりです。デスクトップアプリは、一般のアカウントでは自動で有効にします。
[features]
prefer_mxc = true組織の管理者は、管理された requirements.toml で、mxcを使えなくしたり、使える旧方式を絞ったりできます。
[windows]
allow_mxc = false
allowed_sandbox_implementations = ["elevated"]2つめの例は、unelevated への切り替えを止めますが、mxcは制限しません。両方の旧方式を許すなら、2つとも書きます。方式を選んでいない時、Codexは elevated を優先します。設定ファイルの場所は.codexフォルダの場所を見てください。
mxcが使えるWindowsの版と試し方
公式によると、mxcにはWindows 11の24H2(ビルド 26100.9278)または25H2(ビルド 26200.9278)が必要です。Windows 11を推奨の基準とし、Windows 10はConPTYのために1809以降が必要で、動作は最善の努力とされています。winget が使えることも前提です。
mxcが動くかを1つのコマンドで試せます(Codex 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 です。windows.sandbox = "mxc" を明示した時に、必要な機能がない、またはポリシーで止められていると、失敗します。
管理者の承認とIT部門の準備
elevated の準備では、管理者の承認(UAC)が出ます。拒否するとセットアップは失敗します。ローカルの管理者権限がない利用者には、IT部門が管理者のプロセスから準備できます。
codex sandbox setup --elevated --user 'DOMAIN\alice' --codex-home 'C:\Users\alice\.codex'これでサンドボックスが準備され、windows.sandbox = "elevated" が保存されます。利用者はそのあと、通常のターミナルからCodexを起動します。
ネットワークの扱い
- elevated:サンドボックス用ユーザーにファイアウォール規則をかけるため、旧方式の中でいちばん強い隔離
- unelevated:環境の設定によるオフライン制御で、隔離は弱め
- mxc:管理されたネットワークには
allow_local_binding = trueが必要。自分のPC上のサービスへのループバック接続は許可される。プロキシのドメイン規則は適用され、プロキシのプライベートネットワーク宛先の検査は外される
知っておく制限
- 読み取り禁止のパターンは、各プロセスの開始時に解決されます。あとで作られたファイルは、ほかの権限が許せば、動いているプロセスから読めます(elevated とmxcの両方)
- mxcは、前面のコマンドが終わると残りの子プロセスを止めるため、切り離して動かす開発用サーバーは残らないことがあります
- unelevated は、読み取り禁止のパスに対応しません
- フルアクセスのモードはサンドボックスの外で動き、データが失われる原因になりえます。フルアクセスの危険性も確認してください
困った時の見方
| 症状 | 公式の見立てと対処 |
|---|---|
| 旧方式の準備に失敗 | UACの拒否、ローカルのユーザー・グループ作成の制限、ファイアウォール変更の制限、ログオン権限の制限が主な原因。再試行して承認する、IT部門に相談する、ポリシーが許せば unelevated を使う |
| unelevated に切り替わった | 設定したか、elevated の準備ができない状態。ファイルの境界は保たれるが、ネットワークの隔離は弱くなる |
| エラー1385 | Windowsが、サンドボックス用ユーザーに必要なログオンの種類を拒否している。Codexが作ったユーザーにログオン権限を与えるようIT部門に依頼し、CODEX_HOME/.sandbox/sandbox.log を確認する |
| 「Everyoneに書き込み権限」の警告 | 表示されたフォルダから Everyone の書き込み権限を外し、Codexを再起動するか準備をやり直す |
| ネットワークが遮断される | その会話がネットワークなしで動く設定か確認する。そうでなければ再起動してサンドボックスのログを集める |
| サンドボックスが効かなくなった | 再起動し、mxcの試しコマンドか elevated の準備をやり直す。ポリシーが許せば一時的に unelevated |
| IDE拡張が反応しない | Visual Studio Build ToolsのC++ワークロードと、x64のVisual C++再頒布可能パッケージを入れ、VS Codeを完全に再起動する |
サポートに送る情報は、sandbox.log、選んだ方式、エラーの文、Windowsのビルド、1385が出たかどうかです。CODEX_HOME/.sandbox-secrets/ の中身は送らないよう、公式が案内しています。診断コマンドはcodex doctorのページにあります。
よくある質問
どの方式を選べばよいですか。
公式は、端末とポリシーが対応していれば mxc を使うよう案内しています。そうでなければ elevated を優先し、unelevated は次の手段です。
UACの確認で「いいえ」を押しました。
elevated のセットアップは管理者の承認が必要で、拒否すると失敗します。もう一度試して承認するか、IT部門に相談します。ポリシーで許されるなら unelevated も選べます。
sandbox.log はどこにありますか。
CODEX_HOME 内の .sandbox フォルダの sandbox.log です。サポートへ送る時は、同じ場所にある .sandbox-secrets の中身は送らないよう公式が案内しています。
関連ページ
出典と確認日
- OpenAI Learn: Windows sandbox(3つの方式・設定・要件・トラブルシュート)
- OpenAI Learn: 設定の基本([windows] sandbox・prefer_mxc)
- 確認日: 2026年11月16日
出典は公式の文書です。方式の名前や必要なバージョンは更新されることがあるため、迷ったら出典を優先してください。
