Max Nardit
← 記事
13 mindev

Codex のサンドボックス権限プロファイルと Claude Code のサンドボックス: それぞれが遮断するもの

Ubuntu で、許可ホストを 1 つだけにした Codex のプロファイルは、リストにないサイトを 403 で拒否しました。無関係な機能スイッチに見える 2 行を削除すると、同じサイトが警告なしに 200 を返します。Claude Code のネットワークフィルターがそのような形で効かなくなることはありません。その代わり、フィルターはオンにするまでオフのままで、しかも 1 つの権限モードがそれを素通りします。

目次

11月18日、OpenAI は Inside the Codex sandbox を公開しました。Codex が実行するものをどう隔離しているかを Michael Bolin が解説した記事です。Codex は macOS では Seatbelt、Linux では bubblewrap と seccomp、Windows では Microsoft の MXC ライブラリを使った新しいバックエンドを使っています。Claude Code のサンドボックスも macOS と Linux では同じ 2 つの仕組みの上に成り立っているので、当然浮かぶ疑問は、2 つの壁が同じ壁なのかどうかです。

同じではありません。違いはシェルから離れたところにあります。Codex 側は Ubuntu 24.04 上の codex-cli 0.169.0 で、codex sandbox を通して実行しました。任意のコマンドに権限プロファイルを適用するラッパーです。OS レベルの強制はエージェントセッションと共通ですが、承認の仕組みは共有しないので、以下の結果はすべてラッパーでの結果です。Claude Code 側は、1 か月前に行った Claude Code のサンドボックスと srt のテストから取っています。この作業全体に見合うだけの結果は、Codex のドメイン許可リストが設定ファイルに書かれ、完全に見えながら、まったく適用されていないことがある、という点です。Claude Code のネットワークフィルターがそのように効かなくなることはありません。そちらのリスクは、最初はオフになっているサンドボックスと、それを素通りする 1 つの権限モードです。

Codex の :workspace プロファイルは何を遮断するのか

ワークスペースと一時ディレクトリの外への書き込み、ワークスペースのルートにある少数の制御用パス、そしてネットワークです。Bolin の記事と権限のドキュメントによると、:workspace は各ワークスペースルートの .git、.codex、.agents、.aws を読み取り専用にするので、コマンドがプロジェクトの Codex 設定を書き換えたり Git フックを仕込んだりすることはできません。一方で、読み取りは広く許可したままです。

これがデフォルトで適用されるかどうかは、Codex の起動方法によります。承認のドキュメントによると、対話型の CLI はバージョン管理されたフォルダーに対して workspace-write とオンリクエストの承認を推奨し、信頼するまでは読み取り専用で起動することもあります。codex exec は読み取り専用で起動します。default_permissions 自体にはデフォルト値がありません。そこで、新しい設定ファイルに default_permissions = ":workspace" の 1 行だけを書いてプロファイルを明示的に選び、表の 1 行につき 1 つの codex sandbox コマンドを実行しました。

プローブCodex :workspacesrt、10月
touch ~/codex-probeRead-only file systemRead-only file system
作業ディレクトリへの書き込み許可許可
.git/hooks/pre-commit への書き込みRead-only file systemRead-only file system
.codex/config.toml への書き込みRead-only file system未テスト
/tmp への書き込み許可Read-only file system
~/.ssh の一覧表示許可許可
curl https://example.comCould not resolve hostプロキシでブロック
ホストの 127.0.0.1 上のサーバーに curlCouldn't connect to serverCouldn't connect to server
1.1.1.1:53 への UDP パケットsocket: Operation not permittedNetwork is unreachable
git init sub してそのフックに書き込み (同じコマンド内)許可許可
次のコマンドでそのフックに再度書き込み許可Read-only file system

両者が分かれるのは最後の行です。srt では次のコマンドが拒否リストを作り直し、新しいリポジトリを見つけて保護しました。Codex では入れ子のリポジトリのフックは書き込み可能なままでした。これは、保護がワークスペースルートの .git に対して定義されていて、sub は一度もルートではなかったからです。書かれているとおりのルールですが、プロジェクト内にベンダリングしたクローンや作業用のリポジトリがあっても、このルールの対象にはなりません。/tmp の行も同じ論理です。Codex はシステムの一時ディレクトリをワークスペースとして扱い、srt は自分専用の一時ディレクトリしか開けませんでした。そして ~/.ssh の一覧表示はできました。これは Bolin 自身が書いています。

The tradeoff is that sensitive files elsewhere on the machine may also remain readable (such as config files containing API keys).

Codex の権限プロファイルはどう書くのか

config.toml に、組み込みプロファイルを拡張する [permissions] テーブルとして書き、default_permissions で選択します。組み込みの名前はコロンで始まります。:read-only、:workspace、:danger-full-access です。パスには read、write、deny を指定し、ドキュメントによると、同じ具体性の read や write より deny が優先されます。既存の環境にコピーする前に、設定ファイル、選択された設定プロファイル、コマンドラインの --sandbox のどこにもレガシーの sandbox_mode が残っていないか確認してください。ドキュメントはどちらか一方の仕組みで設定するよう求めていて、有効な sandbox_mode は、管理された要件で別の指定がない限り default_permissions より優先されます。一度も効かないプロファイルは、以下のどの失敗にも劣らず静かに失敗します。

テストしたプロファイルは次のとおりです。専用の CODEX_HOME に置いています。

toml
default_permissions = "lab"
 
[features]
network_proxy = true
 
[permissions.lab]
description = "Workspace plus one allowed host, no ssh keys"
extends = ":workspace"
 
[permissions.lab.filesystem]
"~/.ssh" = "deny"
 
[permissions.lab.filesystem.":workspace_roots"]
"**/*.env" = "deny"
 
[permissions.lab.network]
enabled = true
 
[permissions.lab.network.domains]
"example.com" = "allow"
プローブlab での結果
~/.ssh の一覧表示Permission denied
既存の app.env の読み取りPermission denied
new.env を作成して読み取り (同じコマンド内)許可
次のコマンドで new.env を読み取りPermission denied
curl https://example.com200
curl https://www.wikipedia.orgCONNECT tunnel failed, response 403
許可したホストへの curl --noproxy '*'Could not resolve host

ここでは拒否されたパスははっきりとエラーになります。srt では拒否したディレクトリは空に見えました。bubblewrap がその上に空の tmpfs をマウントしていたからです。.env の組は、Bolin とドキュメントの両方が説明している穴です。Linux では拒否グロブはプロセスの開始時に具体的なパスに展開されるので、あとから作られたファイルはそのプロセスからは読めるままです。1 つのコマンドなら、穴が開いている時間は短く済みます。1 つのサンドボックス内で長く動くプロセス、たとえばラップしたサーバーは、その穴を動いている間ずっと開けたままにします。今回の app.env はトップレベルに置いていました。グロブをどこまで深く展開するかには一部のプラットフォームで上限があるので (glob_scan_max_depth)、シークレットが実際に置かれている深さでプローブしてください。

403 はラッパーの応答です。Bolin によると、エージェントセッションでは、ルールに一致しないドメインは承認に回されます。ユーザーへの確認か auto-review のどちらかで、その間もコマンドはサンドボックス内にとどまります。これは require_escalated とは別物です。こちらはコマンドをサンドボックスの外で完全に実行することを求めます。

Codex のドメイン許可リストにアクティブなネットワークプロキシが必要なのはなぜか

ドメインリストを適用するのはプロキシで、プロファイルの中にプロキシを起動するものは何もないからです。network.enabled = true はネットワークを開きます。そのネットワークがフィルターを通るかどうかは、[features] network_proxy = true か、管理者の管理されたネットワーク設定で決まります。上のプロファイルから [features] の 2 行を削除して、同じコマンドを実行しました。

shell
codex sandbox -- curl -sS -o /dev/null -w "%{http_code}\n" https://www.wikipedia.org
# with network_proxy = true:   403
# with [features] deleted:     200

~/.ssh の拒否は維持されました。Codex は警告を出さず、いつもどおり起動しました。ドメインリストが適用されなくなっただけです。権限のページにはこのことが、組み合わせの一覧の中で書かれています。ネットワークがオフならプロキシの設定に関係なくオフ、ネットワークがオンでプロキシがオフなら制限のない直接アクセス、ドメインルールを追加してもプロキシはオンにならない、というものです。それでも、この設定でいちばん犯しやすい間違いです。許可リストが制御そのものに見え、スイッチは無関係な機能の切り替えに見えるからです。両者を見分けられる確認は、許可していないホストへのリクエストと、許可したホストへのリクエストを 1 つずつ送ることだけです。後者があれば、オフラインのマシンがすべてを拒否して合格してしまうことはありません。

プロキシがオンでもまだ解決しないものとして、Bolin は次のものを挙げています。プロキシ変数を無視するプログラム (直接接続はブロックされているので失敗します) と、広いワイルドカードを通した DNS ベースの持ち出しです。もっと単純なものを 1 つ加えます。コマンドが出力したものは、ネットワークの有無に関係なく、ツールの出力としてモデルに戻ります。これはサンドボックスから抜け出すあらゆる経路で扱った棚卸しの問題で、ここではベンダー自身がその項目のいくつかを挙げています。

Codex のサンドボックスと Claude Code のサンドボックスを比べるとどうなるのか

シェルについては、両者が強制する内容は似ています。違いは、それ以外に何が壁を通り抜けるかと、それぞれのネットワークフィルターがどう失敗するかにあります。

CodexClaude Code
初期状態のシェルサンドボックス対話型: Git フォルダーには workspace-write を推奨、codex exec: 読み取り専用/sandbox か sandbox.enabled で有効にするまではオフ
エージェントによるファイルの読み取りと編集Bolin によると同じサンドボックス基盤を通るRead、Edit、Write は外側で、権限ルールに従って動く
Linux の仕組みbubblewrap + seccompbubblewrap + socat、seccomp フィルターは任意
ワークスペース内の読み取り専用ルートの .git、.codex、.agents、.aws.claude の設定、.mcp.json、.git/hooks、.git/config など
デフォルトの読み取りマシンのほぼ全体マシンのほぼ全体、~/.ssh を含む
ネットワーク、サンドボックスがオンのときプロファイルで有効にしない限りオフ組み込みのプロキシを経由、許可リストは空から始まる
ドメインルールが適用される条件プロキシがアクティブなとき (機能フラグまたは管理設定)サンドボックスがオンの間は常に
リストにないホストラッパー: 拒否、セッション: 承認または auto-reviewdefault モードでは確認、strict でなければ bypassPermissions で許可
サンドボックスを出る方法require_escalated、承認ポリシーに従うサンドボックスなしの再試行、allowUnsandboxedCommands が false でない限り
WindowsMXC: デスクトップアプリでは優先、CLI ではオプトインネイティブではサンドボックスなし、WSL2 を使う

強調したいのはファイルツールの行です。Bolin によると、Codex のハーネスはローカルファイルの読み取りや変更といった操作にもサンドボックスを再利用します。一方、Claude Code のサンドボックスのドキュメントには、ファイルツールは代わりに権限ルールに従うと書かれていて、denyRead のエントリは Read ツールを止めません。Codex のプロファイルで拒否した認証情報は、エージェントのファイルアクセスからも拒否されます。Claude Code では、権限ルールも必要です。

非対称が表れているのはネットワークの行です。10月のテストでは、サンドボックスをオン、許可リストを空、サンドボックスなしの再試行をオフにした状態で、リストにないホストへの curl は default モードではブロックされ、bypassPermissions では 200 を返しました。ホームディレクトリへの書き込みはそのときも失敗しています。ドキュメントでも、sandbox.network.strictAllowlist か allowManagedDomainsOnly がオンでない限りこのモードはリストにないホストを許可すると確認できます。また再試行をデフォルトのままにしておくと、失敗したコマンドが確認なしにサンドボックスの外で再実行されることもあります。つまり Claude Code のフィルターは自分で選んだモードのせいで効かなくなり、Codex のフィルターは一度も設定しなかったスイッチのせいで効かなくなります。

Codex と Claude Code のサンドボックスは何を外側に残すのか

どちらでも stdio の MCP サーバーです。Bolin によると、Codex のハーネスは MCP サーバーを起動するコマンドをサンドボックスに入れません。サーバーが何を必要とするかを推測できないからです。ドキュメントはさらに、コマンドのプロキシは MCP 接続、Web 検索、コネクタ、モデル自身のリクエストを対象にしないと書いています。Claude Code のドキュメントでは、ローカルの MCP サーバー、フック、ステータスライン、LSP サーバーは、フルアクセスのまま外側に置かれています。サーバーを自分で内側に入れることはできます。Codex ではサーバーの command に codex sandbox --permission-profile を指定し (管理者の要件を適用したい場合、0.169.0 では --include-managed-config を追加します。明示的なプロファイルを指定すると、そうしない限り要件がスキップされるからです)、Claude Code では srt で包みます。どちらの場合も、サーバーが必要とする読み取りを含めて、ポリシーは自分で書くことになります。Bolin 自身の npm の例も、書き込みを制限してネットワークを切っていますが、読み取りは広いままです。

Bolin はさらに、どのコマンドサンドボックスでも塞げない出口を 1 つ挙げています。ワークスペースが許可する書き込み、たとえば node_modules 内のフォーマッターへの書き込みを、あとでエディターがユーザーのフルアクセスで実行するケースです。Willison の external sandboxes の記事は、線のもう 1 つの引き方を説明しています。エージェントは外側にとどまり、localhost の API の向こうにある VM やコンテナにコードを送ります。Willison は、それを使えるエージェントとして Codex と Claude Code を挙げています。

Codex と Claude Code のサンドボックス設定で最初に確認すべきものは何か

Codex では、プロファイルがそもそも有効になっているか (sandbox_mode が残っていないか)、そしてプロファイルがネットワークをオンにしている場所ではプロキシがアクティブになっているかです。Claude Code では、まずサンドボックスがオンになっているかです。そのうえで、bypassPermissions を使うことがあるなら sandbox.network.strictAllowlist、失敗したコマンドが外側で再試行できないように sandbox.allowUnsandboxedCommands: false、依存関係が欠けているときにサンドボックスなしで動かず起動を止めるように sandbox.failIfUnavailable、そして sandbox.excludedCommands の確認です。キーについては、どちらも明示的な読み取りの拒否が必要で、Claude Code ではサンドボックスのエントリに加えて Read の権限ルールが必要です。

個人的な見立てでは、Codex のほうが強い位置から始まります。壁はオン、ネットワークはオフ、エージェント自身のファイルアクセスも境界の内側です。ただ、そのネットワーク制御には Claude Code にはない失敗の仕方があります。一度も適用されず、それを知らせることもない許可リストです。なので Codex では、ドキュメントが代わりにやってはくれない 2 つのプローブを済ませてから、初めてプロファイルを信頼します。実際に使うプロファイルで許可していないホストと許可したホストを試すこと、そしてプロジェクトに入れ子のリポジトリがあるなら、そこにフックを書き込んでみることです。Claude Code では、同じネットワークの組を ! のあとに自分で打つのではなく、エージェントに実行させてください。! はサンドボックスの外で実行されるからです。そしてサンドボックスなしでの再試行の提案はすべて断ってください。

01 / ディスカッション

コメント欄はありません。議論は X で行っています。

Max Nardit@mnardit

02 / ほかの記事

  1. Windows 11 のコーディングエージェント テレメトリ: オプションの診断データのスイッチが MissionControlAggregator で止めるもの、そして Microsoft が必須に挙げる開発者フラグ

    エージェントごとのビットマップはオプション扱いなので、いつものスイッチで PC の外に出なくなるはずです。ところが同じ DLL から出る、より粗い IsDeveloper コホートは Microsoft の必須イベント一覧に載っており、Home と Pro ではオプトアウトできません。スイッチをオフにした状態での検証結果は、まだ誰も公開していません。

  2. Claude Code の「Don't ask again」と settings.local.json: allow ルールに残ったパスワードの見つけ方と、変えるべきこと

    現在の Claude Code では、確認ダイアログがルールを保存する前にコマンドの大半をワイルドカードに置き換えます。それでも、プログラム名の前に書いたパスワードは残ります。セッションのトランスクリプトにはコマンド全体が記録されるので、いちばん確実な対策は、そもそも秘密情報を含まないコマンドラインにすることです。

  3. Claude Code が User-Agent にあなたのメールアドレスを入れる問題:privacy mod が確認するもの、hook と allowlist が埋める穴

    Claude Code があなたのメールアドレスを Web サイトに送る機能は、誰も作っていません。モデルはコンテキストの中にアドレスを見つけ、スクリプトでアクセスするクライアントに連絡先を求めるサイトに出会い、親切に応じます。提案されている対策はどれも、外に出ていくアドレスをフィルタするものです。だから問題は、どのフィルタがモデルの判断に左右されないか、そしてそれぞれがどの漏れ道を塞がずに残すかです。