11月18日、OpenAIが「Inside the Codex sandbox」と題した記事を公開した。AIコーディングエージェント「Codex」が採用するサンドボックスの内部設計——ファイルシステム・ネットワーク制限の仕組みからパーミッションプロファイルの設計まで——について詳しく紹介されている。
なぜDockerやVMではなくOS固有のサンドボックスなのか
Codexのサンドボックス設計で最も興味深い判断は、仮想マシンやコンテナを使わないという選択だ。
その理由はシンプルで実用的である。開発者のラップトップは、長年かけてカスタマイズされた「一品物の開発環境」であり、それをDockerコンテナで再現するのはコストが高い。さらに、ホスト側のツールに依存するワークフローでは再現自体が不可能なケースもある。
記事はiOSアプリ開発を例に挙げている。DockerコンテナでCodexを動かそうとすると、iOSビルドツールチェーン(Macネイティブの実行ファイル群)は実行できないし、iPhoneシミュレーターも起動できない。ビルドやシミュレーター操作をMacホストに委譲する設計も考えられるが、そうなるとそれらの操作はコンテナのサンドボックス外で動くことになり、別途制限が必要になる。
Codexはその複雑さを避けるため、macOS・Linux・Windowsそれぞれが提供するOS固有のサンドボックス機能に深く投資する方針を取った。ここでいう「ハーネス」とはエージェントの制御層——コマンドの受け取り、パーミッションの適用、プロセスの起動を担うレイヤー——を指す。ハーネスはmacOS・Linux・WindowsのOS固有サンドボックスAPIを共通インターフェースで抽象化し、コマンドとパーミッションプロファイルを受け取って制限付きのプロセスを起動する。子プロセスは親のサンドボックス制約を継承するため、コマンドが起動したプロセスツリー全体に制限が適用される。
デフォルトの境界線:何を許可し、何を塞ぐか
組み込みの:workspaceプロファイルは以下の設計になっている。
- ワークスペース内への書き込みを許可。ただし
.gitや.codexディレクトリは読み取り専用。Gitフックやconfig.tomlの直接改ざんを防ぐ - ファイルシステムの広範な読み取りを許可。コンパイラ・ランタイム・ビルドツールはリポジトリ外のSDKやライブラリに依存するため、読み取りをワークスペースのみに絞ると多くのワークフローが壊れる。トレードオフとして、APIキーを含む設定ファイルなど機密ファイルも読める状態になりうる
- ネットワークアクセスを無効化。外部サービスへのデータ漏洩を防ぐと同時に、依存関係のダウンロードといった正当な操作も遮断する
ただしこれらの制限をすり抜ける攻撃経路は残る。記事はその例として、node_modules/prettierのようなローカルインストール済みパッケージへの悪意あるコード注入を挙げている。node_modulesはGitに無視されることが多く、git statusには現れない。エディタがそのPrettierをファイル保存時に実行すれば、サンドボックス外でコードが走る。これがOpenAIが「多層防御(defense in depth)」——単一の防御策に頼らず、複数の独立した防御層を重ねることでリスクを低減するセキュリティ設計の考え方——を強調する理由であり、サンドボックスはあくまで一層にすぎない。
パーミッションプロファイルの設計
config.tomlの[permissions]セクションで独自プロファイルを定義できる。たとえば:workspaceを継承しつつ~/build-cacheへの書き込みを追加し、.vscodeを読み取り専用にするといったカスタマイズが可能だ。
ネットワーク制限は大きく3択:
- 全ネットワーク遮断(
:workspaceのデフォルト) - 完全な直接アクセス(
:danger-full-accessのデフォルト) - プロキシ経由で特定ドメインのみ許可(ワイルドカード対応、明示的denyが優先)
エンタープライズ向けには、requirements.tomlで管理者がユーザーの設定選択肢を制約できる。たとえばallowed_permission_profilesで利用可能なプロファイルの集合を絞り込み、:danger-full-accessを組織全体で禁止するといった運用が可能だ。複数の設定ファイルはテーブルが再帰的にマージされ、配列は丸ごと置き換わる。
この設計が示すのは、「誰がどのリスクを引き受けるか」を明示的に記述ファイルで管理するという思想だ。個人開発者・チーム・企業それぞれの粒度でポリシーを層状に重ねられる点は、セキュリティ要件が多様な組織での運用を強く意識している。
codex sandboxコマンド:エージェント外での活用
codex sandboxコマンドを使えば、エージェントセッションとは独立してサンドボックスを任意のコマンドに適用できる。設定テストとして「本来ブロックされるべき操作が実際にブロックされるか」を確認する用途が主だが、自分のツールにCodexのサンドボックス機構を組み込むこともできる。
記事が挙げる具体例が興味深い。MCP(Model Context Protocol)とは、AIエージェントが外部ツールやデータソースと標準化されたインターフェースで連携するためのプロトコルであり、stdioはプロセス間通信の手段としてその実装に広く使われる。@modelcontextprotocol/server-memoryのようなstdio MCPサーバーは、Codexハーネスがデフォルトではサンドボックス化しない——どのファイルやネットワークサービスが必要かを推測できないためだ。このnpxコマンドはユーザーと同等の権限で動く。
これを制限するには、専用のmemory-mcpプロファイルを定義し、codex sandbox --permission-profile memory-mcp npx ...のようにラップする。起動前にnpmキャッシュをセットアップしておけば、npx --offlineでネットワーク遮断のままサーバーを起動できる。
OS別の実装
macOS・Linux・Windowsそれぞれで異なるOS固有のサンドボックスAPIが使われており、ハーネスがそれらを共通インターフェースで抽象化する構造になっている。実装はRustで書かれており、GitHub上のCodexリポジトリで確認できる。各OS向けの具体的な実装詳細はリポジトリのソースコードを参照していただきたい。
詳細はInside the Codex sandboxを参照していただきたい。




