Windowsサンドボックスの早見

CodexのWindowsサンドボックスとは?3つの方式の違いと選び方

WindowsでCodexを使うと、コマンドはサンドボックスの中で動きます。公式は、mxc・elevated・unelevated の3つの方式を案内しています。違い、設定の書き方、必要なWindowsの版、管理者の承認、エラー1385などの困りごとを、OpenAI公式の文書(2026年11月16日確認)に沿って整理します。

このサイトはCodexの公式サイトではありません。公式の文書を元に日本語で整理した解説です。画面の表示や手順は更新されるため、出典と照らして確認してください。

最初に答え

Windowsのサンドボックスは3つの方式があります。公式の順は mxc(推奨)→ elevated → unelevated です。

方式特徴
mxc(推奨)Windowsの機能によるプロセスの隔離。管理者の承認が要る準備も、追加のWindowsアカウントも、ローカルのファイアウォール規則も要りません。特定のWindowsの版が必要
elevated管理者の承認が必要。権限の低い専用ユーザー、ファイルの権限の境界、ファイアウォール規則を使う。コマンド自体は管理者権限なしで動く。読み取りを禁じるパスの指定に対応し、ネットワークの隔離も強い
unelevatedelevated を使えない時の代替。いまのユーザーから作った制限付きのトークンで動く。ネットワークの隔離は弱く、読み取りを禁じるパスの指定には非対応

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を起動します。

ネットワークの扱い

知っておく制限

困った時の見方

症状公式の見立てと対処
旧方式の準備に失敗UACの拒否、ローカルのユーザー・グループ作成の制限、ファイアウォール変更の制限、ログオン権限の制限が主な原因。再試行して承認する、IT部門に相談する、ポリシーが許せば unelevated を使う
unelevated に切り替わった設定したか、elevated の準備ができない状態。ファイルの境界は保たれるが、ネットワークの隔離は弱くなる
エラー1385Windowsが、サンドボックス用ユーザーに必要なログオンの種類を拒否している。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 の中身は送らないよう公式が案内しています。

関連ページ

出典と確認日

出典は公式の文書です。方式の名前や必要なバージョンは更新されることがあるため、迷ったら出典を優先してください。

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(公式の情報と照らした日)
更新履歴
(公開)

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。