OpenAIは、エージェントを守るために多層防御(defense in depth)のアプローチを取っています。トレーニングとアラインメント(alignment)への投資が基本ですが、エージェントハーネス(agentic harness)であるCodexにも追加の保護機能を実装しています。Codexが行う最も一般的で、潜在的にリスクのある操作の1つはコンピュータ上でのコマンド実行であるため、OpenAIはCodex sandboxを作りました。これによりCodexは、ユーザーが制御するファイルシステムとネットワークの制限の範囲内で、既存の環境で作業できます。

sandboxとは、プログラムの実行中にアクセスできるものを制限する仕組みです。Codex sandboxを使うと、エージェントはユーザーの既存の環境で、ファイルシステムとネットワークへの明示的な制限をかけたうえで、コードを書いて実行する能力を使えます。Codex sandboxはハーネス内の再利用可能なプリミティブ(primitive)であり、`codex sandbox` コマンドによって、自分で作るツールからも使えるようになります。この`codex sandbox` コマンドにより、Codexのsandbox機構をエージェントセッションとは独立に利用できます。同じ設定言語とプラットフォーム固有の強制の仕組みを使って、自分のツールが起動するコマンドを制約できます。写真整理のタスクでは、Codex sandboxを、~/Pictures内のファイルをコマンドが読み取り・変更できるようにしつつ、アップロードを防ぐためにネットワークアクセスをブロックするよう設定できます。コードレビューにおいては、Codex sandboxを、オンラインドキュメントへのアクセスを許可しつつ、ソースファイルは読み取り専用に保つよう設定できます。例えば、保存時に悪意のある自動フォーマッタを実行するようVS Codeを設定しようとする書き込みコマンドは、`.vscode`が既に存在していれば、`dev`プロファイルでそのディレクトリが読み取り専用になっているためブロックされるはずです。`codex sandbox`コマンドは、デフォルトでカレントディレクトリ(cwd)をワークスペースのルートとして扱います。macOSでは、この書き込みは実際に失敗します。 コードを書いて実行することは、エージェントにソフトウェア開発以外の問題を解くための柔軟な方法を与えます。

Codex harnessはモデルが生成したツール呼び出しを実行する役割を担います。コーディングタスクで最もよく使われるツールは、Bashのような対話型シェルでユーザーがするのとほぼ同じようにコマンドを実行するshell toolです。ここでは、ワンショットの `exec_command` shell toolを例に、harnessがsandboxをどう使って目的の保護を実現するかを見ていきます。 例えば、エージェントが`node_modules/prettier`のようなローカルにインストールされたパッケージの中に悪意あるコードを注入する可能性があります。`node_modules`はGitに無視されることが多いため、そのような変更は`git status`には現れない場合があります。ユーザーのエディタが保存時にそのPrettierのコピーを実行すると、ファイルを保存するだけでCodex sandboxの外で悪意あるコードが実行される可能性があります。このためOpenAIは多層防御のアプローチを取っており、sandboxはコマンドがアクセスできるものを制限し、トレーニングとアラインメントはモデルがそのアクセスをユーザーの意図に沿って使うのを助けます。

shell toolは`spawn_command_under_sandbox()`の主な利用者であり、harnessはローカルファイルの読み取りや変更などの操作にも、そのsandbox基盤を再利用しています。Codex sandboxは、仮想マシンやコンテナのように計算を別環境へ移して隔離するのではなく、各プラットフォームのsandboxing機能を使って、ユーザーの既存環境で実行されるコマンドを制約する方式をとります。MacでCodexを使ってiOSアプリを開発する場合、Codexをsandbox目的でDocker内で動かすと、ネイティブMac実行ファイルで構成されるiOSビルドツールチェーンを実行できず、コードを動かすiPhoneシミュレータも起動できません。harnessは、コマンドを実行する前に、ユーザーの設定に基づいて権限要求を評価します。例えば、Codexがユーザーに直接確認を行うこともあれば、要求をauto-reviewに回すこともあります。実行が許可されると、Codexは元の `ExecCommandToolCall` のコマンド引数とともに、適切な `permission_profile` と `network_proxy` を `perform_exec_command_with_sandboxing()` に渡します。`codex sandbox`コマンドを使うと、サンドボックス化されたコマンド実行を自身のツールに組み込むことができます。名前付きの権限プロファイルを使うと、同じファイルシステムとネットワークの制限を複数のプロジェクトで再利用できます。独自のプロファイルは、`config.toml`の`[permissions]`の下に定義できます。devプロファイルは、~/build-cacheへの書き込みアクセスを追加し、ワークスペース内のファイルに追加の制限を課します。ファイルシステムのエントリは、読み取り専用アクセスのread、読み取りと書き込みのアクセスのwrite、またはアクセスの完全なブロックであるdenyのいずれかを指定できます。:workspace_rootsテーブルでは、プロジェクトのワークスペースのルートからの相対パスに対するルールを定義できます。デフォルトでは、Codex CLIは作業ディレクトリを唯一のワークスペースのルートとして使い、ChatGPTデスクトップアプリはプロジェクトのソースフォルダを使います。Codexは各ルールをすべてのワークスペースのルートに適用するため、`dev`プロファイルにおける`.vscode`エントリは、各ルートの下の`.vscode`ディレクトリを読み取り専用にします。devプロファイルは、独自のルールに加えて、:workspaceプロファイルから保護を継承します。config.tomlの例では、組み込みの:workspaceプロファイルを拡張するdevという名前の権限プロファイルを定義しています。

Codexのsandboxのデフォルトについての哲学は、意味のある作業ができる範囲で保守的なデフォルトを指定することです。Gitリポジトリをワークスペースのルートとする場合、組み込みの`:workspace`権限プロファイルは、ワークスペース内への書き込みを許可する一方、.gitや.codexなどのディレクトリは読み取り専用に保ちます。これによりCodexは変更のたびに許可を求めずにソースコードを編集できますが、`.codex/config.toml`や`.git/hooks`配下のGitフックを直接変更することは防がれます。この権限プロファイルは、ユーザーの既存のOS権限の範囲内で、ファイルシステムの広範な読み取りを許可します。コンパイラ、ランタイム、ビルドツールはリポジトリ外のSDK、ライブラリ、設定に依存しており、読み取りをワークスペースに限定すると多くの通常のワークフローが壊れるためです。トレードオフとして、APIキーを含む設定ファイルなど、マシン上の他の場所にある機密ファイルも読み取り可能なままになる場合があります。この権限プロファイルは、ネットワークアクセスを無効にします。これにより、コマンドが読み取れるデータを持ち出そうとする試みを含め、外部サービスへの直接アップロードがブロックされます。一方で、依存関係のダウンロードなど正当な操作も妨げられ、これらには追加のアクセスが必要になります。`:workspace`権限プロファイルの制限は大きな種類の悪い挙動を防ぎますが、有害な行為は依然として可能です。

多くの開発者にとって、ノートPCは思いつきで変更できる自前の開発環境ですが、その環境をDockerコンテナで再現するには手間がかかる場合があります。また、ホスト上で動くツールに依存するワークフローもあります。CodexをDockerの中で動かすsandboxでは、ビルドやiPhoneシミュレータの操作をMacホストに委譲するワークフローも可能ですが、委譲されたビルドやシミュレータの操作はコンテナのsandboxの外で実行されるため、操作ごとに独自の制限が必要になります。Codexは、作業に最も適した環境で動かせるよう、OS固有のsandboxingに重点的に投資して単純さを保つ方針をとっています。

OpenAIは今年、これより前に、Windows向けのサンドボックス化の取り組みを実装し、それについて記事にしました。その後、MicrosoftはWindows OS内のプロセス分離の新機能とともに、MXCというライブラリを公開しました。OpenAIは現在、既存のサンドボックスをMXCライブラリを使うものに置き換えています。

この記事では、Codex sandboxのデフォルト設定の背後にあるトレードオフから説明を始め、sandboxの設計とharnessがsandboxを使ってコマンドを実行する方法について解説します。また、エンドユーザーや企業が自分たちの必要に応じてsandboxの権限を調整する方法と、開発者が自分のツールでsandboxを再利用する方法についても示します。さらに、Codexのsandboxの制限がmacOS、Linux、Windowsでどのように強制されるかを検討します。なお、企業環境でsandboxの権限を調整し、他の保護と組み合わせる方法については、Codex security cookbookを参照できます。ユーザーは権限プロファイルを通じてCodex sandboxを設定します。権限プロファイルは、Codexセッションに対するファイルシステムとネットワークの制限を定義します。

harnessは、macOS、Windows、およびLinuxにおいて、OS固有のsandboxing機構を共通のAPIを通じて公開します。権限プロファイルが限定的なネットワークアクセスを許可する場合、呼び出し側はその制限を強制するネットワークプロキシを渡さなければなりません。共通APIの関数はプロセスをsandbox内で起動し、harnessが終了待ちに使える `Child` ハンドルを返します。各子プロセスは親のsandbox制約を継承するため、その制限は、コマンドが開始したプロセスツリー全体に、元のプロセスより長く生きる子孫にも及びます。

harnessは、OS固有のsandboxing機構を、macOS・Windows・Linuxに共通のAPIを通じて公開します。このAPIはコマンドと権限プロファイルを受け取ります。harnessは、コマンドをsandbox化するために、`subprocess.Popen()` の呼び出しを `spawn_command_under_sandbox()` に置き換えます。このとき、harnessは権限プロファイルと、必要な場合はネットワークプロキシを渡します。`exec_command` toolでは、モデルが個々のコマンドに異なる権限を要求できますが、その要求を許可するかどうかはharnessが決めるものとしています。`exec_command` の権限要求で `use_default` を指定すると、harnessはそのturnのデフォルトのsandbox設定を使います。`with_additional_permissions` はsandbox内での拡張アクセスを要求し、`require_escalated` はsandbox外での実行を要求します。

Codexは、`config.toml` で設定されたstdio MCPサーバーについて、サーバーの起動に使うコマンドをsandbox化しようとはしません。これは、Codexがそのサーバーが必要とするファイルやネットワークサービスを確実には推測できず、既定のsandboxプロファイルを適用すると本来有効な設定が壊れる可能性があるためです。例えば、`@modelcontextprotocol/server-memory` を設定する標準的な方法で使う `npx` コマンドはsandbox化されずに実行されるため、Codexを実行しているユーザーと同じ権限でファイルを書き込みネットワークリクエストを行え、過剰に許可的です。

@modelcontextprotocol/server-memory の起動を制限するには、`memory-mcp` という名前の権限プロファイルを定義し、元の `npx` コマンドを `codex sandbox --permission-profile memory-mcp` で包みます。これにより、サーバーの書き込み先を制限し、ネットワークアクセスを防ぐことができます。サーバーを起動する前に、データディレクトリを作成し、固定(pin)したパッケージでnpmキャッシュを埋めておくと、ネットワークアクセスを無効にするプロファイルの下でも、オフライン指定の`npx --offline`でそのサーバーを起動できます。パッケージがキャッシュされると、Codexはmemoryサーバーをネットワークアクセスなしで起動でき、書き込みはnpmキャッシュとサーバーのデータディレクトリに限定されます。Codexのサンドボックスで使われるネットワークプロキシは、リクエスト処理とポリシーの中核ロジックが主要3つのオペレーティングシステムであるmacOS、Linux、Windowsで共有されています。一方で、プロキシの設定とサンドボックスとの統合はOSごとに異なります。

sandboxの実装は、権限プロファイルをオペレーティングシステムが強制する制限に変換します。ネットワークプロキシのリクエスト処理とポリシーの中核ロジックは主要な3つのOSであるmacOS、Linux、Windowsで共有されますが、プロキシの設定とsandboxとの統合はOS固有です。権限プロファイルのネットワーク制限を強制するため、ハーネスはネットワークプロキシを起動し、sandboxがそのプロキシへの接続を許可しつつ外部ホストへの直接接続をブロックするよう設定します。プロキシは各リクエストをプロファイルのドメインルールと照らし合わせ、転送するかを判断します。

Codexのリポジトリでは、ネットワークプロキシは `codex-network-proxy` クレートで実装されています。ハーネスはこれをライブラリとして使いますが、スタンドアロンのCLIとしてビルドすることもできます。`codex-network-proxy` を有効にすると、デフォルトでHTTPプロキシとSOCKS5プロキシの両方が起動し、HTTPプロキシとSOCKS5プロキシのアドレスは環境変数を通じて、サンドボックスが起動したプロセスに伝えられます。サンドボックスが起動するプロセスには、`HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` などの標準的な環境変数に加え、`PIP_PROXY` など、広く知られたアプリケーション固有の環境変数も複数注入されます。プロキシ用の環境変数をすべてのプログラムが尊重するわけではありません。プログラムが外部ホストへ直接接続しようとした場合は、オペレーティングシステムのサンドボックス制限がそれをブロックします。

ネットワークプロキシは、権限プロファイルで定義されたネットワーク制限を実装する役割を持ちます。例えば、`dev` プロファイルは `*.openai.com` へのリクエストを許可し、`evil.example` へのリクエストを明示的に拒否します。リクエストの宛先ドメインが許可ルールにも拒否ルールにも一致しない場合、ネットワークプロキシはリクエストを一時停止し、承認をハーネスに委ねることができます。Codexがユーザーに直接確認を求める場合もあれば、リクエストをauto-reviewに回す場合もあります。判断を受け取ると、ネットワークプロキシはリクエストの続行を許可するか、エラーレスポンスで拒否します。ホスト名にエンコードされた情報はDNSルックアップだけでも漏れうるため、ネットワークプロキシは、要求されたホスト名が許可または承認されたと判断した後にのみ、そのホスト名を名前解決します。ただし、広範なワイルドカードルールやDNSサービスへのアクセスがあると、DNSベースの情報流出(exfiltration)は依然として可能になりえます。

macOSでは、CodexはAppleのカーネルが強制するサンドボックス機構であるSeatbeltを使います。Seatbeltのポリシーは、サンドボックスの制限を表現するScheme系言語であるSandbox Profile Language(SBPL)で書かれます。SBPLには `(param)` を使ったプレースホルダーを含めることができ、それらは `sandbox-exec` に渡される `-Dkey=value` オプションによって値が埋められます。CodexはmacOSで独自のサンドボックスAPIを実装するため、ベースポリシーから `sandbox-exec` への引数リストを組み立て始め、`permission_profile` やその他のコンテキストを使ってそれを修正し、完全なSeatbeltプロファイルを作ります。結果のプロファイルと付随する `-D` 引数がSeatbeltの強制する制限を設定し、ネットワークプロキシが追加のネットワークルールを強制します。macOSでサンドボックスの呼び出しの一部としてネットワークプロキシが有効な場合、接続を適切なローカルポートに限定するルールがSeatbeltプロファイルに注入されます。Codexは `/usr/bin/sandbox-exec` コマンドを通じてSeatbeltを呼び出します。このコマンドは、`codex sandbox`コマンドと同様に、サンドボックスを記述するオプションの後に実行するコマンドを取ります。PROFILEは、サンドボックスを設定するエントリを含むSBPLの文字列です。例えば、SBPLのスニペットを用いることで、サンドボックスポリシーの下で /dev/null と /dev/zero を読み書き可能にできます。Codexのプロファイルは `(deny default)` で始まるため、明示的に許可されない限り、外向きの接続はブロックされたままになります。AppleはSBPLという言語をthird-partyの利用向けに文書化していないため、正しいSBPLを生成するのは難しいです。`man sandbox-exec` には「The sandbox-exec command is DEPRECATED」と記されており、`man 3 sandbox_init` で文書化されているライブラリ関数 `sandbox_init()` も非推奨です。macOSは非推奨の警告があるにもかかわらず、今も `/usr/share/sandbox` にSeatbeltプロファイルを同梱しており、Google ChromeやChromiumを含むthird-party製ソフトウェアもSeatbeltに依存し続けているため、Codexは当面Seatbeltを使い続ける予定です。macOSでは、`sandbox-exec`への完全な引数リストが組み上がった後は、`sandbox-exec`の呼び出し自体は単純です。

Linuxでサンドボックスを作るため、Codexはbubblewrap(`bwrap`)とseccomp-bpfを組み合わせて使います。bubblewrapは隔離環境を構築するコマンドラインツールであり、seccomp-bpfはシステムコールをフィルタするLinuxカーネルの仕組みです。Linuxでは、内部ヘルパー `codex-linux-sandbox` がセットアップを取りまとめます。bubblewrapはサンドボックス実装の根幹にあたるため、Codexはユーザーが`bwrap`を入れていない場合に備えて独自のコピーをvendorしていますが、互換性のある`bwrap`が`PATH`上にあればそちらを優先します。経験的には、一部のLinuxディストリビューションはユーザー名前空間へのアクセスを既定で無効にしつつ、システムの`bwrap`には例外を認めています。Linuxで、Codexはbubblewrap(`bwrap`)でファイルシステムのビューを作るために`--bind`を使い、書き込み可能なファイルまたはディレクトリを指定します。また、`--ro-bind`は読み取り専用のファイルまたはディレクトリを指定し、`--perms 000 --tmpfs DIR --remount-ro DIR`は`DIR`へのアクセスを拒否するために使われます。さらに、`--perms 000 --ro-bind-data FD FILE`は`FILE`へのアクセスを拒否するために使われ、`FD`は`/dev/null`を指す開いたファイル記述子です。Codexでオプションを使ってdeny globを適用する場合、Codexは各コマンドを起動する前にdeny globを具体的なパスに展開します。展開後に新たに一致したパスは、起動する各コマンドのサンドボックス制限に自動では追加されません。Codexは`--unshare-ipc`や`--unshare-pid`などのオプションも指定し、サンドボックスがホスト上の他の種類のリソースにアクセスするのを防ぎます。そのためbubblewrapが影響するのはファイルの見え方だけではありません。bubblewrapを使う場合、ネットワークが無効なとき、または接続をネットワークプロキシ経由にしなければならないときは、Codexは常に`--unshare-net`を渡します。これによりサンドボックス用の新しいネットワーク名前空間が作られます。`--unshare-net`に加えて、Codexはseccomp-bpfを使い、コマンドが利用できるネットワーク関連のシステムコールとソケットファミリーに追加の制限をかけます。Codexはseccompiler crateを使い、望ましいフィルタに基づくBPFプログラムを動的にコンパイルします。それをサンドボックス内のランチャープロセスに適用することで、制約がプロセスツリー全体に継承されます。`bwrap`はユーザーのコマンドを直接実行せず、`codex-linux-sandbox`ランチャーを、ランチャー自身の設定引数とそれに続くユーザーのコマンドとともに実行します。 ファイルシステムの隔離またはプロキシ経由のルーティングが必要なとき、`codex-linux-sandbox`は`bwrap`を呼び出して最初のサンドボックス環境を作ります。続いて`bwrap`がその内側で`codex-linux-sandbox --apply-seccomp-then-exec`を起動します。この2回目の呼び出しは、ユーザーのコマンドを実行する前にseccomp-bpfで追加の制限を適用します。`codex-linux-sandbox`は、macOSの`sandbox-exec`と同様に、サンドボックス設定に続けて実行するコマンドを受け取ります。 `bwrap`も、macOSの`sandbox-exec`と同様に、サンドボックス設定に続けて、サンドボックス内で実行するコマンドを受け取ります。設定には、SBPLのような独自の設定言語ではなく、個別のフラグを使います。 最初のサンドボックス環境を作るため、Codexはbubblewrapを使い、別のマウント名前空間に、権限プロファイルのファイルシステムルールを反映したファイルシステムのビューを作ります。 昇格した権限なしでseccompフィルタを適用するため、ランチャーはLinuxのno_new_privsフラグを設定します。このフラグは子プロセスに継承され、setuid実行ファイルなど別のプログラムを実行するときに、子プロセスが追加の権限を得ることを防ぎます。

Linuxにおいて、sandbox内でネットワークプロキシが有効なとき、seccompフィルタは`codex-linux-sandbox`が作るTCPリスナーに到達できるようIPソケットを許可する一方、スタンドアロンのUnixドメインソケットの作成はデフォルトでブロックします。これは、それらがあると、ホストのリソースへ意図しないアクセスが可能になりうるためです。. Codex sandboxのseccompフィルタはネットワーク設定に依存します。. ネットワークアクセスが無効なときは、`connect(2)`や`bind(2)`など、ネットワーク関連のsyscallをいくつかブロックします。サンドボックスの設定がネットワークプロキシの使用に値する場合、Codex harnessはプロキシのインスタンスを1つ作成します。. このインスタンスは、同じCodex thread内の`codex-linux-sandbox`の複数回の起動で再利用できます。各サンドボックスは、隔離されたネットワーク名前空間(network namespace)から共有プロキシに到達する手段を必要とします。Codexはそのネットワーク名前空間内にループバックTCPリスナー(TCP listener)を用意し、サンドボックスの外側のプロセスがその接続を受け付けてプロキシへ中継するようにしています。. `codex-linux-sandbox`はbubblewrapを起動する前に、制御チャネル用のUnix socket pairを作り、自分自身をforkします。子プロセスは`run_host_bridge()`を実行し、そのチャネル経由でリスナーのファイル記述子(file descriptor)を受け取るのを待ちます。. 親プロセスは`exec`で自身のプログラムイメージを`bwrap`に置き換えます。. これによりサンドボックスが設定され、その内側で`codex-linux-sandbox --apply-seccomp-then-exec`が起動され、制御チャネルのFDが引き渡されます。サンドボックスのネットワーク名前空間内で、`codex-linux-sandbox`の2回目の起動がループバックTCPリスナーを作り、そのファイル記述子をソケット経由で渡します。リスナーはサンドボックスのネットワーク名前空間に関連付けられたままなので、サンドボックスの外側に残った子プロセスは、サンドボックス化されたプログラムからの接続を受け付けつつ、上流への接続をホストのネットワーク名前空間で開けます。. 受け渡し後、両プロセスが制御チャネルのdescriptorを閉じ、サンドボックス内のプロセスはリスナーの自分のコピーを閉じます。. サンドボックスの外側のプロセスはリスナーを開いたままにします。. 受け付けた接続ごとに、設定されたプロキシへの接続を開き、双方向にデータを中継します。この追加の仕組みにより、コマンドは別のループバック(loopback)インターフェースを含む独自のネットワーク名前空間を持ちます。. Linuxでは、コマンドは隔離されたnamespace内のリスナーに接続し、サンドボックスの外側のプロセスがその接続を設定されたプロキシへ中継します。記述子の受け渡しにより、ホストのネットワーク名前空間をコマンドに公開せずにこの接続が可能になります。.macOSでは、Seatbeltが、ホストのループバックインターフェース上の指定ポートへコマンドが直接接続することを許可します。

MXC(Microsoft eXecution Container)は、Windows、Linux、macOSにまたがる複数の封じ込めバックエンドをサポートする、Microsoft製のサンドボックス化されたコード実行システムです。Codexは互換性のあるWindowsデバイス上でMXCベースのsandboxをサポートしており、ネイティブのプロセス分離を使ってユーザーの既存環境の中でコマンドを制限します。OpenAIはセキュリティとユーザビリティを改善するためにMXCへの移行を進めており、セットアップに昇格権限/管理者アクセスが必要なこと、ACLの確認・設定操作が高コストで遅いこと、およびACL・ファイアウォールルール・サンドボックスユーザー・コントロールプレーンファイルなど、ホストマシン上にサンドボックスのセットアップ状態が残り続けることといった既存のWindowsサンドボックスの制限に対処しようとしています。MXCはJSON設定スキーマを公開しています。CodexはMXC SDKを使って、そのスキーマに従い、コマンド、作業ディレクトリ、環境、権限を含む実行リクエストを組み立てます。権限には、ファイルシステムとネットワークのアクセスに加え、デスクトップやクリップボードなどのWindowsリソースが含まれます。Codexは互換性とセキュリティのバランスを取るため、いくつかの制御に固定設定を使います。レジストリの読み取りを許可し、PowerShellが起動時に必要とするWin32kとデスクトップへのアクセスを維持しますが、クリップボードアクセス、入力インジェクション、デスクトップおよびシステム設定の制御は無効にします。また、MXCがホストのファイルシステム権限を変更する方式へフォールバックしないようにしています。MXCのファイルシステムポリシーはデフォルトでアクセスを拒否します。Codexは、権限プロファイルが許可する広範な読み取りを実現するために、ローカルドライブのルートに読み取り専用の許可を追加します。この許可は再帰的に適用され、ユーザーの既存のOS権限に従います。書き込み可能なドライブルートの許可は再帰的に適用されないため、Codexはその許可をドライブの既存の直下の子要素を含むように展開します。MXCでは、より具体的なパスが上位パスの許可を上書きします。そのため、読み取り専用の`C:\`の下でも`C:\work\demo`は書き込み可能にでき、`C:\work\demo\.git`は読み取り専用のままになります。異なるパス表記やシンボリックリンク/ジャンクションのエイリアスが同じパスを指す場合、MXCはより厳しい権限を適用します。優先順位は、denyが読み取り専用より優先され、読み取り専用が読み書きより優先されます。MXCは具体的なdenyパスのみを受け付けるため、Codexは起動前にdenyグロブを一致するファイルとディレクトリに展開します。コマンドの実行中にグロブに一致する新しいパスが作られても、自動的には追加されません。MXCは外部への直接接続をブロックする一方、プロキシへのアクセスを含むホストのループバック接続は許可し、その他のローカルサービスにも引き続き到達できます。`*.openai.com`のようなドメインルールは、先に説明した共有のCodexネットワークプロキシによって適用されます。Codexはそのプロキシをサンドボックスの外側で実行し、標準の`*_PROXY`環境変数を通じて、そのアドレスをコマンドに渡します。Codexは権限プロファイルのファイルシステムとネットワークのルールをMXCの設定に変換します。例えば、`dev`プロファイルを使用し、ローカルドライブが`C:\`, `D:\`, `Z:\`のみであり、ワークスペースのルートと作業ディレクトリが`C:\work\demo`で、ユーザーのホームディレクトリが`D:\Users\dev`(したがって`~/build-cache`は`D:\Users\dev\build-cache`に解決される)であり、denyグロブが一致するのは`C:\work\demo\config\dev.env`と`C:\work\demo\config\prod.env`のみである、と仮定します。

macOS、Linux、Windowsのいずれにおいても、ハーネスは同じサンドボックスAPIを使って権限プロファイルの下でコマンドを起動します。制限を適用するために必要なセットアップについては、各プラットフォーム固有の実装が処理を担当します。

Codexのサンドボックスのネットワーク設定には、おおよそ3つの選択肢があります。すべてのネットワークアクセスを無効にする設定は、`:workspace`プロファイルのデフォルトです。完全な直接ネットワークアクセスを有効にする設定は、`:danger-full-access`プロファイルのデフォルトです。権限プロファイルに基づいて通すものを判断するプロキシにネットワークアクセスを制限する方法もあります。

`dev`に直接ネットワークアクセスを与えるには、`config.toml`のトップレベルで`permissions.dev.network.enabled = true`を設定します。ネットワークプロキシが無効なとき、これで完全なネットワークアクセスが付与されます。

`dev`を特定のドメイン群に制限するには、ネットワークプロキシを有効にしてそのドメインルールを設定します。ドメインルールは正確なドメイン名とワイルドカードパターンをサポートし、明示的なdenyルールがallowルールより優先されます。それ以外のドメインへのリクエストは、承認が必要になるかブロックされます。個々のユーザーはプロジェクトをまたいで適用されるデフォルトを設定でき、信頼する特定のプロジェクトについてそれを上書きできます。エンタープライズ管理者は、ユーザー向けのデフォルトを設定し、ユーザーが変更できる設定を制約したい場合があります。Codexは階層化された設定(layered configuration)とmanaged requirementsを通じて、その両方をサポートします。Codexは「Configuration precedence」に記載された優先順位に従って複数の`config.toml`ファイルから設定をマージします。テーブルは再帰的にマージされ、値が競合する場合は優先順位の高いソースが勝つ一方、配列は全体が置き換えられます。権限プロファイルがファイルシステムのパスやネットワークのドメインにテーブルを使うのはこのためで、チームは自分の設定で個別のエントリを追加または上書きしつつ、組織のベース設定にある他のすべてのエントリへの変更を自動的に継承できます。管理者は`requirements.toml`を通じてmanaged requirementsを提供し、ユーザーの設定の選択肢を制約できます。その要件は、システムファイルやクラウド提供のポリシーなど、複数のソースから提供されることがあります。よくある用途は、`allowed_permission_profiles`を指定して、エンタープライズユーザーが選べる権限プロファイルの集合を制約することです。管理者がクラウドrequirementsを指定する例では、そのクラウドrequirementsが`/etc/codex/requirements.toml`にあるシステムのrequirementsファイルより優先されるため、そのファイルのエントリでは例に含まれる明示的な`":danger-full-access" = false`を上書きできません。要件(requirements)と設定を分けることで、組織は制限を強制でき、ユーザーはその制限の範囲内で自分の設定を調整できます。結果として得られる権限プロファイルは、ハーネスが使うことも、コマンドに直接適用することもできます。要件で`:workspace`を未指定のままにすると、別のrequirementsレイヤーがそのエントリを供給できます。最終的にマージされたテーブルにおいて、エントリが`false`であるもの、または存在しない権限プロファイルは利用できません。Codex CLIには`sandbox`コマンドがあり、Codex configで定義した権限プロファイルの下で任意のコマンドを実行できます。このコマンドは、プロファイルをテストし、sandboxが防ぐよう設計された挙動を実際に防いでいるか確認する用途によく使われます。例えば、保存時に悪意のある自動フォーマッタを実行するようにVS Codeを設定しようとするコマンドの例では、`.vscode` が既に存在していれば、`dev` プロファイルは `.vscode` が読み取り専用であるためこの書き込みをブロックするはずです(`codex sandbox` は既定で `cwd` をワークスペースのルートとして扱います)。

OpenAIは、エージェントが担うタスクが増えるなかで、より多くのツールや環境においてCodex sandboxを実用的にしたいと考えています。そのためには、権限を設定しやすくすることと、利用可能になったオペレーティングシステムのより良い保護機能を活用していくことが必要です。OpenAIの目標は、人々がエージェントのアクセスできる範囲を管理できる状態を保ちながら、エージェントにできることを広げることです。