メインコンテンツへスキップ
見出し画像

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、と考える前に、次の順で緩めるのが安全です。

    1. まず、workspace-write + on-request(標準)で使う

    2. 確認が多すぎる作業だけ、approval_policy = "never" にして、workspace-write の壁の中でやらせる(壁があるので、外には出られない)

    3. 通信が必要な作業だけ、network_access = true を試す(上のとおり、環境によっては通らないことがある)

    4. それでも足りないとき、はじめて 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分で、できます。


    次に読む

    このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。

    この先で分かること(今後の有料記事)

    • そのままコピーして使える config.toml と AGENTS.md の実物(調べもの用・編集用・無人実行用)

    • codex exec を、壁の中で安全に自動実行する設計(画像づくりのパイプラインの例)

    • 実際に起きた失敗と、直し方の記録

    まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。

    あなたへのおすすめ