Codexサンドボックスは、OpenAIが2026年11月18日に公開したエンジニアリング記事で明らかにした、コーディングエージェント「Codex」の実行境界の仕組みです。ユーザーの既存環境のままコマンドを走らせつつ、ファイルシステムとネットワークへのアクセスを制限できます。
室谷代表取締役Codexサンドボックスの話、最初に見たときは「またコンテナ隔離の話か」と思ったんですよね。でも読んでみたら真逆で、Dockerに閉じ込めない設計をわざわざ選んでいる。
そこが面白いなと。
そこが面白いなと。
テキトー教師DotAI 認定講師そうなんですよ。単に「サンドボックスを作りました」な話じゃないんです。
OpenAIがなぜOSネイティブという選択をしたのか、その思想まで含めて設計が語られている。講座でもエージェントの権限設計は必ず触れるテーマなので、これは受講生さんに共有したい内容です。
OpenAIがなぜOSネイティブという選択をしたのか、その思想まで含めて設計が語られている。講座でもエージェントの権限設計は必ず触れるテーマなので、これは受講生さんに共有したい内容です。
Codexサンドボックスとは?何が発表されたのか
Codexサンドボックスの要点
サンドボックスの役割
プログラムが実行中にアクセスできる範囲を制限する仕組み
設定例(写真整理)
~/Picturesの読み書きは許可しつつ、ネットワークを遮断してアップロードを防ぐ
設定例(コードレビュー)
オンラインドキュメントへのアクセスは許可し、ソースファイルは読み取り専用にする
パーミッションプロファイル
Codexでは名前付きポリシーとして権限を管理する
実行構造
モデルが生成したツール呼び出し(主にシェルコマンド)を「ハーネス」が実行し、その実行部分にサンドボックスを噛ませた
発表元と執筆者
発表はOpenAI。記事はOpenAIのMichael Bolin氏(Member of Technical Staff)が執筆
問題意識
リポジトリを編集するコマンドに自動でネットワークアクセスを許すべきではない。モデルが高機能になるほどアクセス制限が重要になる
室谷代表取締役まず前提を揃えておくと、サンドボックスはプログラムが実行中にアクセスできる範囲を制限する仕組みです。OpenAIの記事では写真整理タスクの例が出ていて、
~/Picturesの読み書きは許可しつつネットワークを遮断してアップロードを防ぐ、といった設定ができると。
テキトー教師DotAI 認定講師コーディングの現場だと、コードレビューのときにオンラインドキュメントへのアクセスは許すけれど、ソースファイルは読み取り専用にしておく、みたいな使い方ですね。これをCodexでは「パーミッションプロファイル」という名前付きポリシーで管理します。
室谷代表取締役発表の主語はOpenAIです。Codexはモデルが生成したツール呼び出し、主にシェルコマンドを「ハーネス」が実行する構造になっていて、その実行部分にサンドボックスを噛ませたと。
テキトー教師DotAI 認定講師記事を書いたのはOpenAIのMichael Bolinさんで、Member of Technical Staffですね。公式スレッドでも「モデルが高機能になるほど、何にアクセスできるかの制限が重要になる」と述べられています。
リポジトリを編集するコマンドに自動でネットワークアクセスを許すべきではない、という問題意識が起点です。
リポジトリを編集するコマンドに自動でネットワークアクセスを許すべきではない、という問題意識が起点です。
室谷代表取締役ここ大事なんですよね。能力が上がるほど、権限設計の比重が上がる。
MYUUUでもエージェントに何を触らせるかの線引きはいつも議論になります。
MYUUUでもエージェントに何を触らせるかの線引きはいつも議論になります。
Codexサンドボックスでできること――ファイル制限とネットワーク制御
Codexサンドボックスの制御: ファイルシステムとネットワーク
テキトー教師DotAI 認定講師できることを整理すると、ファイルシステムとネットワークの2軸です。まずファイル側。
Gitリポジトリをワークスペースにした場合の既定プロファイル
Gitリポジトリをワークスペースにした場合の既定プロファイル
:workspaceは、ワークスペース内の書き込みを許可しつつ、.gitや.codexは読み取り専用に保ちます。
室谷代表取締役これ地味に効くやつですよね。
ソースコードの編集は承認なしで進められるから、作業テンポも落ちない。
.codex/config.tomlや.git/hooksを直接いじられないので、設定やGitフックを勝手に書き換えられる事故を防げる。ソースコードの編集は承認なしで進められるから、作業テンポも落ちない。
テキトー教師DotAI 認定講師読み取りは広めに許可されます。ただしこれはユーザーの既存OS権限の範囲内という条件付きです。
コンパイラやランタイム、ビルドツールはリポジトリ外のSDKやライブラリ、設定に依存するので、読み取りをワークスペースに閉じると普通のワークフローが壊れてしまう。
コンパイラやランタイム、ビルドツールはリポジトリ外のSDKやライブラリ、設定に依存するので、読み取りをワークスペースに閉じると普通のワークフローが壊れてしまう。
室谷代表取締役そのトレードオフは正直に書かれていて、マシン上の機密ファイル、たとえばAPIキーを含む設定ファイルも読めてしまう可能性があると。ここは運用でカバーする話ですね。
テキトー教師DotAI 認定講師ネットワークは既定で無効です。外部サービスへの直接アップロード、つまりコマンドが読めるデータの持ち出しを防ぎます。
その代わり依存関係のダウンロードのような正当な操作も止まるので、追加の許可が要ります。
その代わり依存関係のダウンロードのような正当な操作も止まるので、追加の許可が要ります。
室谷代表取締役子プロセスは親の制約を継承して、プロセスツリー全体に適用されるのもポイントです。元のプロセスが終わった後も生き残る子孫にまで効く。
ここは設計としてかなり踏み込んでいます。
ここは設計としてかなり踏み込んでいます。
Codexサンドボックスの使い方・設定方法(権限プロファイルとネットワークプロキシ)
まとめ
Codexサンドボックス設定の要点
- 権限プロファイルはconfig.tomlの[permissions]で定義。組み込みは:read-only、:workspace、:danger-full-accessの3種類
- extendsで既存プロファイルを継承し、差分だけ追加するのが基本(例: :workspaceを継承したproject-editで**/*.envをdeny、api.openai.comをallow)
- ファイルアクセス値はread/write/denyの3つ。具体的なエントリが広いエントリを上書きし、同じパスならdeny>write>readの優先順
- ネットワークは全部無効・全部直接許可・プロキシ経由のドメイン規則の3択。プロキシ利用時はfeatures.network_proxy = trueが必須(無いとドメイン規則が効かない)
- ドメイン規則は完全一致とワイルドカードに対応し、denyがallowより優先。許可済みドメインは毎回の承認が不要
- codex sandboxコマンドでサンドボックス付きコマンド実行を自分のツールに組み込める(MCPサーバーのサンドボックス化例あり)
- 設定は階層化され組織設定と個人設定をマージ。テーブルは再帰マージ、配列は丸ごと置き換え
- 管理者はmanaged requirementsでユーザーが選べるプロファイルを制限可能。権限プロファイルはベータ扱いで変更の可能性あり
テキトー教師DotAI 認定講師設定は
config.tomlの[permissions]でプロファイルを定義します。組み込みは:read-only、:workspace、:danger-full-accessの3種類。extendsで既存プロファイルを継承できるので、ゼロから書かずに差分だけ足すのが基本です。
室谷代表取締役公式ドキュメントの例だと、
:workspaceを継承したproject-editを作って、**/*.envをdeny、api.openai.comをallowにする、みたいな形ですね。
テキトー教師DotAI 認定講師ファイルのアクセス値は
だからワークスペース全体を書き込み可にしつつ、
read、write、denyの3つです。より具体的なエントリが広いエントリを上書きし、同じパスならdenyがwriteより、writeがreadより優先される。だからワークスペース全体を書き込み可にしつつ、
.envだけdenyでくり抜く、という書き方ができます。
室谷代表取締役ネットワークは3択なんですよね。全部無効、全部直接許可、プロキシ経由でドメイン規則に従う。
プロキシを使うなら
プロキシを使うなら
features.network_proxy = trueも必要で、これが無いとドメイン規則は効かない。ここはハマりどころです。
テキトー教師DotAI 認定講師ドメイン規則は完全一致とワイルドカードに対応し、denyがallowより優先されます。許可済みドメインへのリクエストは毎回の承認が不要になるので、パッケージレジストリからの定期ダウンロードがあるビルドでは効いてきます。
室谷代表取締役あと地味に嬉しいのが
codex sandboxコマンドで、サンドボックス付きのコマンド実行を自分のツールに組み込める。MCPサーバーをサンドボックス化する例も記事にあります。
テキトー教師DotAI 認定講師設定は階層化されていて、組織のベース設定と個人設定をマージできます。テーブルは再帰的にマージされ、配列は丸ごと置き換え。
だからチームが個別エントリだけ追加・上書きして、他の項目は組織の設定変更を自動で受け継げる。
だからチームが個別エントリだけ追加・上書きして、他の項目は組織の設定変更を自動で受け継げる。
室谷代表取締役管理者側は
ちなみに権限プロファイルはベータ扱いで、変更の可能性があると明記されています。
managed requirementsでユーザーが選べるプロファイルを制限できる。企業展開ではここが効きますね。ちなみに権限プロファイルはベータ扱いで、変更の可能性があると明記されています。
なぜDockerではなくOSネイティブなのか――既存環境で動かす設計思想
テキトー教師DotAI 認定講師ここが記事の核心です。サンドボックスの一般手段はVMやDockerコンテナですが、Codexは計算を別環境に移さず、各プラットフォームのサンドボックス機能で既存環境のコマンドを制約する道を選びました。
室谷代表取締役理由がすごく実務的で。開発者のノートPCは個別カスタマイズされた環境で、コンテナで再現するのは手間がかかる。
しかもホストでしか動かないツールもある。
しかもホストでしか動かないツールもある。
テキトー教師DotAI 認定講師記事のiOSアプリの例が分かりやすいですね。MacでiOSアプリを開発するとき、Docker内のCodexはネイティブMac実行ファイルで構成されるiOSビルドツールチェーンを動かせず、iPhoneシミュレータも起動できない。
ホストに処理を委譲すると、それはサンドボックスの外での実行になって別途制限が必要になる。
ホストに処理を委譲すると、それはサンドボックスの外での実行になって別途制限が必要になる。
室谷代表取締役だったらOS側の仕組みに投資して、タスクに最適な環境でそのまま動かす方がシンプルだよね、という判断です。ハーネスはmacOS、Windows、LinuxのOS固有機能を共通APIで扱う。
spawn_command_under_sandbox()にコマンドと権限プロファイルを渡し、ネットワーク制限がある場合はプロキシも渡す形です。
テキトー教師DotAI 認定講師ちなみにWindowsサンドボックスの変遷についてはCodex Windowsサンドボックスとは?OpenAIがMXCベースの新モード投入で解説しているので、環境別の話と合わせて読むと理解が深まります。
室谷代表取締役Codex CLI全体の刷新についてはOpenAI、Codex CLI大型刷新 並列エージェントと音声にまとまっています。製品の位置づけから確認したい人はCodexロゴのすべて:デザインから正しい使い方・製品概要までもどうぞ。
既定の権限プロファイルと制約で困る点・注意すべきセキュリティリスク
室谷代表取締役ここは正直に話しておきたいところ。既定の
プロキシを有効にしてレジストリのドメインを許可するのが公式の対処です。
:workspaceはネットワーク無効なので、依存関係のダウンロードが必要なビルドはそのままでは通りません。プロキシを有効にしてレジストリのドメインを許可するのが公式の対処です。
テキトー教師DotAI 認定講師読み取りが広いのも諸刃の剣です。APIキーを含む設定ファイルが読める可能性がある。
だから
だから
denyで**/*.envやsecretsをくり抜く。~/.sshのような安定した場所は完全パスで、リポジトリごとに場所が変わるものはglobで守る、という使い分けが案内されています。
室谷代表取締役一番怖いのは、サンドボックスだけでは防げない行為があるとOpenAI自身が認めている点です。たとえば
node_modules/prettierのようなローカルにインストールされたパッケージへ悪意あるコードを注入するケース。node_modulesはGitで無視されることが多いのでgit statusに出ない。
テキトー教師DotAI 認定講師そしてユーザーのエディタが保存時にそのPrettierを実行すると、ファイルを保存しただけでサンドボックスの外で悪意あるコードが走る。だからOpenAIは訓練・アラインメントとサンドボックスを組み合わせた多層防御を採ると説明しています。
室谷代表取締役サンドボックスは万能じゃない、という前提で使うのが正解ですね。境界の内側で自律実行させ、外に出るときは承認フロー、という役割分担です。
テキトー教師DotAI 認定講師承認とサンドボックスは別の制御だ、という整理も公式ドキュメントにあります。サンドボックスが技術的な境界、承認ポリシーがそれを越えるときに止まって聞くかどうか。
on-requestとneverが代表的なポリシーで、neverは承認プロンプトで止まりません。
室谷代表取締役低リスクなローカル自動化のプリセットとしては
workspace-writeとon-requestの組み合わせが案内されています。danger-full-accessとneverの組み合わせはフルアクセスなので、意図して使うときだけ、と。macOS・Linux・Windowsでの実装の違い
テキトー教師DotAI 認定講師実装はOSごとに異なります。macOSはSeatbelt、Linuxはbubblewrap、Windowsはネイティブのサンドボックスです。
WSL2ではLinux実装が使われます。
WSL2ではLinux実装が使われます。
室谷代表取締役macOSは追加インストールなしで動くのが楽ですね。LinuxとWSL2はbubblewrapをパッケージマネージャで入れる必要がある。
Ubuntu 24.04ではインストール後もユーザー名前空間が作れない警告が出ることがあり、追加のAppArmorプロファイルを読み込む手順が案内されています。
Ubuntu 24.04ではインストール後もユーザー名前空間が作れない警告が出ることがあり、追加のAppArmorプロファイルを読み込む手順が案内されています。
テキトー教師DotAI 認定講師ネットワークプロキシは面白い構造で、要求処理とポリシーロジックの核心部分は3つのOSで共通、プロキシのセットアップとサンドボックス統合だけがOS固有です。Linuxではコマンドが分離された名前空間内のリスナーに接続し、サンドボックス外のプロセスがその接続を設定済みプロキシへ中継します。
室谷代表取締役共通化できるところは共通化して、OS依存の部分だけ分ける。設計としてきれいですよね。
テキトー教師DotAI 認定講師なお、権限プロファイルはmacOS、Linux、WSL、ネイティブWindowsでサポートされています。古いサンドボックス設定とは併用できず、
混在バージョンの企業展開では互換用の要件を一時的に残す選択肢が示されています。
sandbox_modeが読み込まれるとそちらが優先される点も注意です。混在バージョンの企業展開では互換用の要件を一時的に残す選択肢が示されています。
よくある質問
室谷代表取締役最後に、よく聞かれそうな点を整理しておきます。
テキトー教師DotAI 認定講師まず「Codexサンドボックスとは何か」。Codexがローカルでコマンドを実行するときに、ファイルシステムとネットワークのアクセス範囲を制限する技術的な実行境界です。
承認ポリシーとは別の制御で、両方を組み合わせて使います。
承認ポリシーとは別の制御で、両方を組み合わせて使います。
室谷代表取締役「なぜ必要なのか」は、マシンへの無制限アクセスを防ぎつつ自律性を確保するため。コマンドごとに承認を求める承認疲れを減らす狙いもあります。
テキトー教師DotAI 認定講師「ネットワークを制限するには」は、既定の
:workspaceが無効です。特定ドメインだけ許可するならプロキシを有効にしてドメイン規則を設定します。network.enabled = trueだけではプロキシは起動せず、ドメイン規則も効かない点に注意してください。
室谷代表取締役「書き込みできない場所がある」というのもよくある話で、
.gitや.codexは既定で読み取り専用、.envなどはdenyでくり抜く設定が例示されています。プロファイルのextendsで差分だけ足すのがおすすめです。
テキトー教師DotAI 認定講師「日本で使えるのか」については、公式ドキュメントに地域限定の記載は見当たりません。現時点では明らかにされていない、というのが正確なところです。
料金についても今回の発表には含まれていません。
料金についても今回の発表には含まれていません。
室谷代表取締役権限プロファイルがベータで変更されうる点、サンドボックスだけでは防げないリスクがある点は、導入前に必ず押さえておきたいですね。
