2026年11月20日

OpenAIの「Codexサンドボックス」とは?OSネイティブで自律実行を安全に

Codexサンドボックスは、OpenAIが2026年11月18日に公開したエンジニアリング記事で明らかにした、コーディングエージェント「Codex」の実行境界の仕組みです。ユーザーの既存環境のままコマンドを走らせつつ、ファイルシステムとネットワークへのアクセスを制限できます。

室谷室谷代表取締役
Codexサンドボックスの話、最初に見たときは「またコンテナ隔離の話か」と思ったんですよね。でも読んでみたら真逆で、Dockerに閉じ込めない設計をわざわざ選んでいる。

そこが面白いなと。
テキトー教師テキトー教師DotAI 認定講師
そうなんですよ。単に「サンドボックスを作りました」な話じゃないんです。

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でもエージェントに何を触らせるかの線引きはいつも議論になります。

Codexサンドボックスでできること――ファイル制限とネットワーク制御

Codexサンドボックスの制御: ファイルシステムとネットワーク
ファイルシステム
  • 既定プロファイル :workspace はワークスペース内の書き込みを許可
  • `.git` と `.codex` は読み取り専用に保つ
  • `.codex/config.toml` や `.git/hooks` を直接いじれず、設定やGitフックの書き換え事故を防ぐ
  • ソースコードの編集は承認なしで進められ、作業テンポが落ちない
  • 読み取りは広めに許可(ユーザーの既存OS権限の範囲内)
  • リポジトリ外のSDK・ライブラリ・設定に依存するため、読み取りをワークスペースに閉じるとワークフローが壊れる
  • マシン上の機密ファイル(APIキーを含む設定ファイル等)も読める可能性がある
ネットワーク
  • 既定で無効
  • 外部サービスへの直接アップロード(コマンドが読めるデータの持ち出し)を防ぐ
  • 依存関係のダウンロードなど正当な操作も止まるため、追加の許可が必要
  • 子プロセスは親の制約を継承し、プロセスツリー全体に適用
  • 元のプロセスが終了した後も生き残る子孫にまで効く
テキトー教師テキトー教師DotAI 認定講師
できることを整理すると、ファイルシステムとネットワークの2軸です。まずファイル側。

Gitリポジトリをワークスペースにした場合の既定プロファイル:workspaceは、ワークスペース内の書き込みを許可しつつ、.gitや.codexは読み取り専用に保ちます。
室谷室谷代表取締役
これ地味に効くやつですよね。.codex/config.tomlや.git/hooksを直接いじられないので、設定やGitフックを勝手に書き換えられる事故を防げる。

ソースコードの編集は承認なしで進められるから、作業テンポも落ちない。
テキトー教師テキトー教師DotAI 認定講師
読み取りは広めに許可されます。ただしこれはユーザーの既存OS権限の範囲内という条件付きです。

コンパイラやランタイム、ビルドツールはリポジトリ外の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実装が使われます。
室谷室谷代表取締役
macOSは追加インストールなしで動くのが楽ですね。LinuxとWSL2はbubblewrapをパッケージマネージャで入れる必要がある。

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 認定講師
「日本で使えるのか」については、公式ドキュメントに地域限定の記載は見当たりません。現時点では明らかにされていない、というのが正確なところです。

料金についても今回の発表には含まれていません。
室谷室谷代表取締役
権限プロファイルがベータで変更されうる点、サンドボックスだけでは防げないリスクがある点は、導入前に必ず押さえておきたいですね。

New articles

新着記事

使い方

Adobe Fireflyの使い方、無料で最初の1枚を作る手順と最新料金

2026年11月20日
室谷テキトー教師
ニュース

Microsoftの「Canvas」とは?MAI Image 2.7 Flash搭載の画像編集ワークスペース

2026年11月20日
室谷テキトー教師
使い方

Perplexity Cometとは?無料プランの制限と料金、安全性を最新情報で整理

2026年11月20日
室谷テキトー教師
ニュース

Ideogram 4.6とは?ネイティブ4Kと精密編集を強化した画像モデル

2026年11月20日
室谷テキトー教師
ニュース

NVIDIAの「Nemotron-Labs-Sigma」とは?連続拡散の言語モデル群

2026年11月20日
室谷テキトー教師
ニュース

LMArenaの「Agent Arena Index」とは?Claude Fable 5.2が首位の新指標

2026年11月20日
室谷テキトー教師
ニュース

Unsloth AMD NPU対応とは?Ryzen AIで100以上のエージェント型AIアプリが低電力推論

2026年11月20日
室谷テキトー教師
ニュース

Googleの「Stitch Loop」とは?常時稼働で製品を改善するプロダクトエージェント

2026年11月20日
室谷テキトー教師
ニュース

Geminiアプリが低メモリAndroid端末に対応、Android Go editionで何ができる?

2026年11月20日
室谷テキトー教師
使い方

Geminiの回答が遅いのはなぜ?混雑・モデル設定・使用量上限の切り分けとAPIの対処まで

2026年11月20日
室谷テキトー教師

Join

AIプレナーになる。

入会は審査制です。いまの事業と、AIで何を動かしたいのかを聞かせてください。