
Codexの承認モードとサンドボックスの設定|approval_policy・sandbox_modeとconfig.toml、--yoloの考え方【実機で確認・2026年10月】
「Codex に任せたいけれど、勝手にファイルを消されたり、外に通信されたりしないか心配」。「確認が出る回数を減らしたいけれど、どこまで緩めていいのか分からない」。「--yolo という名前のオプションを見かけたけれど、何なのか」。Codex を使い込むと、こんな疑問が出てきます。
この記事では、Codex の安全の仕組み(サンドボックスと承認)、設定のしかた、--yolo の考え方を、実際に動かして確かめた結果とあわせて説明します。
私は Claude Code と Codex を毎日使って、教材づくり、note・Gumroad への出品、画像づくりを自動化しています。画像づくりでは、codex exec(Codex を画面なしで1回動かす実行)を、自動で呼んでいます。
この記事の内容は、読み物のために書いたものではなく、実際に動かして確かめたものです。Windows 11 の Codex(0.162.0-alpha)で、試験用のフォルダを作り、codex exec で「書き込み」「作業フォルダの外への書き込み」「保護された場所」「ネットワーク」を、順に試しました。全文無料です。
この記事で分かること
Codex の安全の仕組み:サンドボックスと承認の違い
サンドボックスの3つのモードと、承認の値
設定する場所(config.toml・起動オプション・-c)
既定が、Git のフォルダと普通のフォルダで違うこと
実機で確かめた結果(どこまで書けて、どこで止まるか)
Windows の事情(Codex は Windows のネイティブでもサンドボックスを持つ)
--yolo の考え方、Claude Code の権限設定との違い
先に結論
Codex の安全は、サンドボックス(AI が動かすコマンドが、どこまで触れるか)と、承認(いつ人に聞くか)の2本立てです。この2つは別の設定で、組み合わせて決まります
サンドボックスは3つ:read-only(読むだけ)・workspace-write(作業フォルダの中は書ける)・danger-full-access(制限なし)
承認は、on-request(AI が必要なとき聞く)か never(聞かない)が基本です
既定は、Git のフォルダなら「workspace-write + 必要なとき聞く」、普通のフォルダなら「read-only」です(公式のドキュメント。codex exec でも実機で確かめました)
サンドボックスは、OS の仕組みで強制されます。実機でも、作業フォルダの外への書き込みは「アクセスが拒否されました」と、OS のレベルで止まりました。AI の気持ちや、CLAUDE.md のような「お願い」ではありません
ただし、一時フォルダ(%TEMP%)は、既定で書き込めることが分かりました。「作業フォルダの外は全部書けない」わけではありません
--yolo(--dangerously-bypass-approvals-and-sandbox)は、サンドボックスも承認も、全部なくすオプションです。外側で隔離された環境だけで使うものです

2本立ての仕組み
Codex が、コマンドを動かすとき、2つのことが決まっています。
サンドボックス:そのコマンドが、ファイルとネットワークのどこまで触れるか。OS の機能で強制される壁です
承認:壁の外に出ようとするとき、人に聞くか
たとえば、「作業フォルダの中は自由に書けるが、外に書こうとしたら聞く」が、標準的な形です。
イメージとしては、サンドボックスは「部屋の壁」、承認は「壁の外に出るときの受付」です。壁が低くて、受付がなければ(danger-full-access + never)、AI は何でもできます。
サンドボックスの3つのモード
公式のドキュメントでは、こうです。
read-only:ファイルを読めるだけ。編集も、コマンドの実行も、承認なしにはできません
workspace-write:作業フォルダの中なら、読み書きと、ふつうのコマンドの実行ができます。ローカルの作業の標準です。ネットワークは、既定で切れています
danger-full-access:サンドボックスなし。ファイルとネットワークの制限が、なくなります
保護された場所
workspace-write でも、作業フォルダの中の次の場所は、書き込めません(公式のドキュメントの記載)。
.git
.codex
.agents
.aws(フォルダとして存在するとき)
ネットワーク
workspace-write では、既定でネットワークが切れています。許可するには、config.toml にこう書きます。
[sandbox_workspace_write]
network_access = true承認の値
公式のドキュメントでは、次の値があります。
on-request:必要なときに、AI が人に聞く。サンドボックスの中で許されることは、聞かずに動く
never:聞かない。サンドボックスで許されないことは、そのまま失敗して、AI に返る
granular:聞く種類を細かく選ぶ(コマンドのルール、MCP、権限の追加依頼など)
untrusted:廃止された。設定ファイルから消すこと
なお、codex のコマンドで、-a on-request のように指定できる値は、on-request と never の2つです(実機で --help を見て確かめました)。
3つのよく使う組み合わせ
公式のドキュメントの、プリセットです。
Auto(標準):--sandbox workspace-write --ask-for-approval on-request。作業フォルダの中は自由、外は聞く
読み取り専用:--sandbox read-only --ask-for-approval on-request。調べるだけ。何かしようとしたら聞く
フルアクセス:--dangerously-bypass-approvals-and-sandbox(別名 --yolo)。全部なし
設定する場所
3つあります。
1. config.toml(ずっと効く)
~/.codex/config.toml に書きます(Windows なら C:\Users\自分の名前\.codex\config.toml)。
approval_policy = "on-request"
sandbox_mode = "workspace-write"2. 起動オプション(その1回だけ)
画面のある codex には、-s(サンドボックス)と -a(承認)があります。
codex --sandbox workspace-write --ask-for-approval on-request画面なしの codex exec には、-s はありますが、-a はありません。実機で codex exec -a never ... と打つと、「unexpected argument '-a' found」と言われました。exec は、承認の画面を出せないので、承認は never として動きます(後で、実機で確かめた結果を書きます)。
3. -c(1つの設定を、その場で上書き)
codex exec -c 'sandbox_mode="read-only"' "..."
codex exec -s workspace-write -c 'sandbox_workspace_write.network_access=true' "..."-c キー=値 は、config.toml の値を、その1回だけ上書きします。値は TOML として読まれます。
実際に効いている設定の確かめ方
codex exec を動かすと、最初に、効いている設定が表示されます。これが、いちばん確実な確認方法です。実機で出たのは、こうでした。
workdir: C:\...\cx
approval: never
sandbox: workspace-write [workdir, /tmp, $TMPDIR]画面のある codex では、/status で、作業フォルダに含まれるフォルダなどを確認できます(公式のドキュメントの記載)。
実機で確かめた結果
小さな試験用のフォルダ(Git のフォルダ)を作り、codex exec で試しました。notes.txt(買い物メモ)と、ダミーの値が入った .env があります。
1. read-only:書けない
-s read-only で、「notes.txt の末尾に『牛乳』と追記して」と頼みました。
結果:「ファイルシステムが読み取り専用のため、追記できませんでした」と、Codex は答えました。ファイルは変わりませんでした
2. workspace-write:作業フォルダの中は書ける
-s workspace-write で、同じ依頼をしました。
結果:追記されました。notes.txt は「買い物メモ」「牛乳」の2行になりました
3. workspace-write:作業フォルダの外
「作業フォルダの1つ上のフォルダに outside.txt を作って」と頼みました。最初は、Codex が実行する前に、「書き込み許可の範囲外で、権限の追加もできない」と断りました。
そこで、「必ず実際に実行して」と頼み直したところ、結果は、作れてしまいました。
理由は、サンドボックスの設定を見て、見当がつきました。codex exec が最初に出す設定には、こうありました。
sandbox: workspace-write [workdir, /tmp, $TMPDIR]つまり、書ける場所は、作業フォルダ(workdir)に加えて、一時フォルダ(/tmp・$TMPDIR)です。私の試験用のフォルダは、Windows の一時フォルダ(%TEMP%)の下にあったので、「1つ上のフォルダ」も一時フォルダの中で、書けたのだと考えられます。次の試験が、その裏づけです。
試験のやり直しとして、一時フォルダの外(ホームフォルダ直下)に、New-Item で空のファイルを作らせました。結果は、こうです。
New-Item : パス 'C:\Users\...\codex_probe_outside.txt' へのアクセスが拒否されました。OS のレベルで止まりました。ファイルは作られませんでした。AI が気を利かせて断ったのではなく、コマンドが実際に動いて、OS が拒否したのです。
教訓は2つです。
サンドボックスは本物の壁。AI が「やって」と言われても、壁の外には出られません
一時フォルダは、壁の中。一時フォルダに秘密を置いたり、作業フォルダを一時フォルダの下に作ったりすると、期待した壁になりません
4. 保護された場所:.git と .codex
workspace-write で、作業フォルダの中に、3つのファイルを作らせました。
.git\probe.txt:アクセス拒否
.codex\probe.txt:アクセス拒否
ok.txt(普通の場所):成功
作業フォルダの中でも、.git と .codex は書けませんでした。公式のドキュメントのとおりです。履歴や設定を、うっかり壊さないための仕組みです。
5. ネットワーク
curl.exe で https://example.com に接続させました。
普通の PowerShell(サンドボックスなし):HTTP コード 200
workspace-write(既定):接続できません(コード 000)
danger-full-access:200
ここまでは、期待どおりです。ところが、次の結果は、予想と違いました。
-c 'sandbox_workspace_write.network_access=true' を付けると、Codex が出す設定の表示は、確かに (network access enabled) に変わりました。それでも、私の Windows 11 の環境では、curl.exe は接続できませんでした(コード 000)。公式のドキュメントでは、network_access = true で通信が許されるとあります。原因は、私は調べていません。Windows のサンドボックスの種類(私の環境は elevated)や、設定の反映のしかたが関係しているのかもしれません。通信が要る作業は、まず小さな依頼で、本当に通るかを確かめてください。
6. 既定の確認:Git のフォルダと普通のフォルダ
-s を付けずに codex exec を動かしました。
Git のフォルダ:approval: never ・ sandbox: workspace-write
Git でないフォルダ:そのままでは動かず、「Not inside a trusted directory and --skip-git-repo-check was not specified.」と言われました。--skip-git-repo-check を付けると動き、このとき sandbox: read-only でした
公式のドキュメントの「Git のフォルダは Auto、そうでないフォルダは read-only」と一致します。Git のフォルダにしておくと、変更を戻せるのも、安全のうえで大きい点です。
AGENTS.md も、ここで読まれる
安全の話とは別ですが、codex exec でも AGENTS.md(Codex の指示書)が読まれることを、確かめました(CodexとClaude Codeの違いで、仕組みを説明しています)。
作業フォルダ直下の AGENTS.md に、「返答の最後の行に、必ず『(以上)』とだけ書くこと」と書きました。codex exec で「このフォルダの目的を1文で」と頼むと、返答の最後の行が (以上) になりました。
サブフォルダにも AGENTS.md(「最後の行は『(サブ)』」)を置き、-C sub(作業の起点をサブフォルダにする)で同じ依頼をすると、最後の行は (サブ) でした。近いフォルダの指示書が優先されるとおりです。
ただし、AGENTS.md は「お願い」です。ここまでの安全の仕組み(サンドボックス)とは、強さが違います。絶対に守らせたいことは、サンドボックスと承認で決めます。
Windows の事情
Claude Code と違って、Codex は Windows のネイティブにも、サンドボックスを持っています。公式のドキュメントによると、PowerShell で動く、Windows 専用の隔離の仕組みで、WSL や仮想マシンは要りません。config.toml の [windows] で選びます。
mxc:推奨(対応している場合)。管理者の承認が要らない
elevated:管理者の承認でセットアップする、従来の方式。専用の低権限ユーザーなどを使う
unelevated:管理者の承認なしで使える、弱めの方式。ネットワークの隔離が弱い
[windows]
sandbox = "elevated"私の環境では elevated になっていました。WSL2 の中で Codex を動かすなら、Linux のサンドボックスが使われます。
Claude Code のサンドボックスは、Windows のネイティブでは使えず、macOS・Linux・WSL2 だけです。Windows のネイティブで OS レベルの壁がほしいなら、Codex のほうが選べる、という違いがあります。
--yolo の考え方
--dangerously-bypass-approvals-and-sandbox(別名 --yolo)は、codex --help に、こう書かれています。
Skip all confirmation prompts and execute commands without sandboxing. EXTREMELY DANGEROUS. Intended solely for running in environments that are externally sandboxed
つまり、外側(コンテナ、VM など)がすでに隔離されている環境だけで使うものです。普段の PC で --yolo を使うと、AI が出したコマンドは、あなたの権限で、何でもできます。
確認が多くて面倒だから --yolo、と考える前に、次の順で緩めるのが安全です。
まず、workspace-write + on-request(標準)で使う
確認が多すぎる作業だけ、approval_policy = "never" にして、workspace-write の壁の中でやらせる(壁があるので、外には出られない)
通信が必要な作業だけ、network_access = true を試す(上のとおり、環境によっては通らないことがある)
それでも足りないとき、はじめて danger-full-access を、隔離された環境で検討する
「承認を never、サンドボックスを workspace-write」は、聞かずに動くけれど、壁の外には出られない、無人の実行に向いた組み合わせです。私の画像づくりの codex exec も、この形(-s workspace-write。exec の承認は never として動く)です。
Claude Code の権限設定との違い
2つのツールは、同じ「安全」を、違う方向から作っています。
Codex:壁から作る。OS の機能で、コマンドの触れる範囲を決めます(サンドボックス)。承認は、壁の外に出るときの受付
Claude Code:ルールから作る。許可・確認・拒否のルールで、AI の道具の使い方を決めます。OS の壁(サンドボックス)は、あるけれど、標準では切れていて、Windows のネイティブでは使えません
私の実機の試験では、Claude Code の Read(./.env) の拒否ルールは、Python のスクリプトが .env を開くのを止められませんでした(私の記事「Claude Codeの権限設定(パーミッション)」で書いています)。Codex の workspace-write は、作業フォルダの外への書き込みを、OS のレベルで止めました。守れる範囲の性質が違うので、両方使うなら、それぞれの得意を知っておくと安心です。
安全のために
標準(Auto)から始める:workspace-write + on-request
作業フォルダは、Git で管理する:変更を戻せる。Git でないフォルダは、そもそも read-only で始まる
秘密の鍵は、一時フォルダや作業フォルダに置かない:workspace-write は、作業フォルダの中の .env を読めるので、読まれたくないものは、そこに置かない
--yolo は、隔離された環境だけ
試す:設定を変えたら、小さな依頼で、止まるはずのことが本当に止まるか、見る
よくある疑問
Q. Codex は、workspace-write で .env を読めますか?
workspace-write は、作業フォルダの中を読み書きできます。.env が作業フォルダの中にあれば、読めます。読まれたくないなら、作業フォルダの外に置くのが確実です。この記事では、Windows のネイティブで読み取りを拒否する設定は、試していません(公式のドキュメントでは、unelevated は読み取りを拒否するパスの設定に対応しない、とあります)。
Q. codex exec で、承認の画面が出たらどうなりますか?
codex exec は、承認が never として動くので、承認の画面は出ません。サンドボックスで許されないことは、そのまま失敗して、AI に返ります。実機でも、作業フォルダの外への書き込みは、「アクセスが拒否されました」と返り、AI がそのまま報告しました。
Q. 自動で承認の判断をさせることはできますか?
公式のドキュメントには、approvals_reviewer = "auto_review" や、--approve-for-me があります(承認の依頼を、自動のレビューに回す)。この記事では試していません。
注意点
この記事の内容は、2026年10月15日の公式ドキュメントと、私の Windows 11 の環境(Codex 0.162.0-alpha)で確かめたものです。Codex は更新が速く、オプションや既定は変わることがあります。迷ったら codex exec --help と、公式のドキュメントを見てください
確かめたのは、codex exec(画面なしの実行)での動きです。画面のある codex での承認の画面、granular、auto_review、mxc、WSL2 は、試していません
ネットワークの許可(network_access = true)は、私の環境では通信できませんでした。原因は調べていません
試験は、小さな試験用フォルダで、少ない回数で行いました。AI の返事は毎回同じではありませんが、止まるかどうかは OS の側で決まります
まとめ
Codex の安全は、サンドボックス(どこまで触れるか)と承認(いつ聞くか)の2本立て
サンドボックスは read-only・workspace-write・danger-full-access。承認は on-request・never が基本
既定は、Git のフォルダなら workspace-write、そうでなければ read-only(codex exec でも実機で確認)
サンドボックスは OS が強制する。実機でも、作業フォルダの外・.git・.codex への書き込みは、アクセス拒否で止まった。ただし、一時フォルダは壁の中
設定は config.toml・-s/-a・-c で。効いている設定は、codex exec の最初の表示で確かめられる
--yolo は、隔離された環境だけ。Codex は Windows のネイティブでも OS の壁を持つ
次の一歩は、小さな試験用のフォルダを Git で作り、codex exec -s read-only と -s workspace-write で、同じ「ファイルに追記して」を頼んで、違いを見ることです。10分で、できます。
次に読む
CodexとClaude Codeの違いを比較(無料):どっちがいい?使い分けと併用のしかた
Codexの使い方・始め方入門(無料):インストールから最初の依頼まで
Claude Codeのフック(hooks)の使い方(無料):Claude Code 側の「止める仕組み」
AIエージェントとは(無料):チャットAIとの違いと、安全な始め方
Claude Code テンプレート集(¥9,800):CLAUDE.md・スキル・フック・権限セット・プロンプト100本・自動化の実物パック(Codex 対応)
このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。
この先で分かること(今後の有料記事)
そのままコピーして使える config.toml と AGENTS.md の実物(調べもの用・編集用・無人実行用)
codex exec を、壁の中で安全に自動実行する設計(画像づくりのパイプラインの例)
実際に起きた失敗と、直し方の記録
まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。