Codex CLI v0.170 の変更点と permissions プロファイルが sandbox_mode に負ける条件
v0.170.0 は権限の更新と子スレッドがサンドボックスの制限を失う問題を修正し、permissions プロファイルの説明が追加されました。sandbox_mode が残っているとプロファイルが無視される条件を整理します。
目次
Codex CLI の v0.170.0 は、サンドボックスの制限が失われる問題の修正が入ったリリースです。緩む方向の不具合なので、更新を後回しにする理由がありません。
同時にドキュメントも更新され、permissions プロファイルとファイルシステムのルールの説明が追加されました。読んでみると、プロファイルを書いても無視される条件が明記されています。ここを知らないと設定が効かない理由が分かりません。
KEY POINT
この記事で分かること
- v0.170.0 で直った「サンドボックスの制限の喪失」が何だったのか
- permissions プロファイルの書き方と、組み込みプロファイル 3 つの違い
sandbox_modeが残っているとdefault_permissionsが無視される条件
v0.170.0 で直ったサンドボックスの制限の喪失
リリースノートの記述はこうです。
Fixed permission updates and child threads losing existing sandbox restrictions.
権限の更新と子スレッドが、すでに適用されていた制限を失っていました。子スレッドについては、公式ドキュメントが本来の挙動を明記しています。
Subagents inherit your current sandbox policy.
CLI の場合はさらに具体的で、「Subagents inherit the parent turn's current sandbox and approval settings, including changes made with /permissions」とあります。/permissions で変えた内容も引き継がれる前提です。カスタムエージェントのファイル側で上書きすることはできません。「Set sandbox and approval controls on the parent session. Custom agent instructions can ask an agent to avoid edits, but they don't create a separate read-only sandbox.」とも書かれています。
つまり v0.170.0 より前は、ドキュメントが約束している継承が成立しないことがあったということになります。Windows ではサンドボックスの権限の保持も同じリリースで直っています。
そのほかの変更は、MCP の OAuth 資格情報の競合(キャンセル・ログイン・ログアウト時)の修正、サイズ超過の WebSocket リクエストが HTTP にフォールバックするようになった点、環境をまたいで同じ名前の MCP サーバーを使う実験的サポートです。
permissions プロファイルの書き方
プロファイルは「filesystem のルールと network のルールを組み合わせた名前付きのポリシー」です。[permissions.<name>] で宣言し、トップレベルの default_permissions で選びます。
# ~/.codex/config.toml
default_permissions = "project-edit"
[permissions.project-edit]
description = "Project editing with OpenAI API access."
extends = ":workspace"
[permissions.project-edit.workspace_roots]
"~/code/app" = true
"~/code/shared-lib" = true
[permissions.project-edit.filesystem.":workspace_roots"]
"." = "write"
"docs" = "read"
"generated" = "deny"
組み込みのプロファイルは 3 つです。
| 名前 | 公式の説明 |
|---|---|
:read-only | 「keeps local command execution read-only」 |
:workspace | 「allows writes inside the active workspace roots and system temp directories」 |
:danger-full-access | 「removes local sandbox restrictions」。意図的に広げるときだけ使う |
extends には制約があります。公式ドキュメントは「A profile can extend :read-only, :workspace, or another named profile. It cannot extend :danger-full-access」と書いており、未知の親と継承の循環も拒否されます。推奨も明示されています。「Prefer extending a built-in profile over starting from scratch so baseline protections carry forward.」
:workspace を継承すると、ワークスペースルート直下の .git、.agents、.codex、.aws は明示的に上書きしない限り読み取り専用のまま保たれます。CLI でプロファイルを切り替えるには /permissions で選択画面を開きます。
プロファイルはまだ Beta
公式ドキュメントの冒頭に「Beta. Permission profiles are under active development and may change.」と書かれています。本番の運用に組み込む前に、この注記を確認してください。対応プラットフォームは「macOS, Linux, WSL, and native Windows」です。
sandbox_mode が残っていると default_permissions は無視される
ここが最も見落としやすい点です。公式ドキュメントは併用できないことをはっきり書いています。
Permission profiles do not compose with the older sandbox settings.
そしてどちらが勝つかも明記されています。
If
sandbox_modeappears in any loaded config file, you pass--sandbox, or the selected config profile setssandbox_mode, Codex uses those older sandbox settings instead ofdefault_permissions.
古い設定が優先されます。「any loaded config file」なので、システムの設定ファイルやプロファイル側に残っている sandbox_mode でも同じことが起きます。default_permissions を書いたのに効かない場合は、まず sandbox_mode と [sandbox_workspace_write] を探して消してください。
例外が 1 つあります。管理された allowed_permission_profiles が設定されている場合です。「Managed allowed_permission_profiles is the exception: it makes Codex use permission profiles.」ただしこの場合も、古い設定を先に消しておくよう案内されています。
移行の指針も書かれています。「Use one system or the other for a session, not both.」読み取り専用の作業は :read-only、編集する作業は :workspace か、:workspace_roots 経由で書き込むカスタムプロファイルから始める形です。古い設定の書き方は Codex CLI の approval mode と sandbox 設定の違い、writable_roots の広げ方は Codex の writable_roots で書き込み先を追加する にまとめてあります。
filesystem ルールと deny の落とし穴
[permissions.<name>.filesystem] はパスにアクセス値を割り当てる表です。値は read、write、deny の 3 つで、優先順位は「More specific entries override broader entries」、同じパスなら deny > write > read です。
パスには特別なトークンが使えます。
| パス | 意味 | サブパス |
|---|---|---|
:root | ファイルシステムのルート | . のみ |
:minimal | 共通のツールが必要とするプラットフォームとランタイムのパス | . のみ |
:workspace_roots | セッションのワークスペースルートと、プロファイルが追加したルート | 可 |
:tmpdir | $TMPDIR の場所(存在する場合) | . のみ |
:slash_tmp | /tmp(存在する場合) | . のみ |
/absolute/path、~/path | 絶対パス、ホーム配下のパス | 可 |
空のテーブルは危険側ではなく安全側に倒れます。 「Missing or empty filesystem tables keep filesystem access restricted and emit a startup warning.」制限されたまま起動時に警告が出ます。
deny のグロブはプロセス開始時のスナップショット
"**/*.env" = "deny" のようなグロブには、プラットフォーム依存の制限があります。公式ドキュメントの記述です。
On Linux, WSL, and native Windows with MXC or
elevated, deny-read glob matches are enumerated when each sandboxed process starts.
後から作られたファイルは、そのプロセスの deny 一覧に追加されません。 長時間動くシェル、スクリプト、ウォッチャー、開発サーバーは、起動後に作られた .env を読めてしまいます。スナップショットの寿命は「the sandboxed process's lifetime, not the whole Codex session」です。
また、read と write のグロブは「less portable on Linux, WSL, and native Windows sandboxing」とされており、"docs/**" = "read" のようなサブツリーのルールか、正確なパスを使うよう案内されています。無制限の ** を deny に使う場合は glob_scan_max_depth を 1 以上に設定します。
まとめ
- v0.170.0 は、権限の更新と子スレッドが既存のサンドボックス制限を失う問題を修正した。ドキュメントは本来「Subagents inherit your current sandbox policy」と定めている
- permissions プロファイルは
[permissions.<name>]で宣言し、default_permissionsで選ぶ。組み込みは:read-only、:workspace、:danger-full-accessの 3 つ sandbox_modeがどこかの設定ファイルに残っていると、default_permissionsは無視される。 併用はできず、古い設定が優先される- filesystem のルールは空だと制限されたまま警告が出る。deny のグロブはサンドボックスのプロセス開始時に展開され、後から作られたファイルには効かない
- プロファイルは Beta で、仕様が変わる可能性がある
よくある質問
- default_permissions を書いたのに効きません。
- どこかの設定ファイルに sandbox_mode が残っていないか確認してください。公式ドキュメントは「If sandbox_mode appears in any loaded config file, you pass --sandbox, or the selected config profile sets sandbox_mode, Codex uses those older sandbox settings instead of default_permissions」と書いています。古い設定が優先されます。
- 組み込みの permissions プロファイルは何がありますか?
- :read-only、:workspace、:danger-full-access の 3 つです。extends で継承できるのは :read-only と :workspace と別の名前付きプロファイルだけで、:danger-full-access は拒否されます。
- permissions プロファイルは安定した機能ですか?
- いいえ。公式ドキュメントの冒頭に「Beta. Permission profiles are under active development and may change.」と書かれています。
参考にした一次情報
この記事は公式ドキュメントを基に AI が下書きを作成し、運営者が内容を確認して公開しています。誤りを見つけた場合は お問い合わせからお知らせください。