Codex CLI v0.168 と v0.169 の変更点と codex exec の --trust が必要になる場面
v0.169.0 で codex exec は信頼していないプロジェクトの設定を読まなくなりました。--trust の使い方と、リリースノートに出てくる設定キーのうち設定リファレンスに載っていないものを整理します。
目次
Codex CLI の v0.168.0 と v0.169.0 で、CI の運用に効く変更が 1 件入りました。codex exec が、信頼していないプロジェクトの設定と MCP サーバーを読まなくなりました。
このリリースにはもう 1 つ注意点があります。リリースノートに登場する設定キーのうち、公式の設定リファレンスに載っていないものが 3 つあり、値の一覧が食い違っているものが 1 つあります。 設定を書く前に、どれが確認済みかを分けておく必要があります。
KEY POINT
この記事で分かること
codex execの信頼判定が何を無効にするのか、--trustをいつ付けるのか- プロジェクトの信頼を設定ファイルで指定する
projects.<path>.trust_level - リリースノートの設定キーのうち、設定リファレンスで裏が取れないもの
codex exec が untrusted なプロジェクトの設定を読まない
v0.169.0 の修正の 1 件目です。リリースノートの記述はこうです。
codex execkeeps project configuration and MCP servers disabled in untrusted directories, even with--sandbox workspace-write. Use--trustwithcodex execorcodex reviewto explicitly save project trust.
サンドボックスを広げても信頼は広がらない、という切り分けです。設定リファレンスにも前提が書かれています。「Codex loads project-scoped config files only when you trust the project」です。
信頼していない場合に何が読まれないかは、Advanced Configuration 側に具体的に書かれています。
If the project is untrusted, Codex ignores project
.codex/layers, including.codex/config.toml, project-local hooks,
プロジェクト側のルールも同様です。ユーザーレベルとシステムレベルのレイヤーは別扱いで読み込まれ続けます。フックについては「Project-local hooks load only when the project .codex/ layer is trusted.」「User-level hooks remain independent of project trust.」と明記されています。
--trust の説明は次のとおりです。
# この実行と以降のチャットに対して、このプロジェクトの信頼を保存する
codex exec --trust "Run the test suite and summarize failures"
Save project trust for this run and future chats, even with
--ephemeral. Conflicts with--ignore-user-config.
--ephemeral(セッションのロールアウトをディスクに残さない)を付けていても信頼は保存され、--ignore-user-config とは併用できません。codex review 側の --trust は「Trust this project for this review and future chats, including its configured MCP servers.」と説明されています。
MCP サーバーが読まれない理由は設定リファレンスでは確認できなかった
リリースノートは MCP サーバーも無効のままになると書いています。一方、信頼していないプロジェクトで MCP サーバーが読まれないという記述は、設定リファレンスと Advanced Configuration では確認できませんでした。 これらのページが untrusted の結果として挙げているのは、プロジェクトの .codex/ レイヤー(設定・プロジェクトローカルのフック・ルール)までです。codex review --trust の説明に「including its configured MCP servers」とあるのが、唯一それを示す記述です。
設定ファイルで先に信頼を指定しておくこともできます。
| キー | 値 | 説明 |
|---|---|---|
projects.<path>.trust_level | "trusted" / "untrusted" | 「Mark a project or worktree as trusted or untrusted」。untrusted のプロジェクトは「skip project-scoped .codex/ layers, including project-local config, hooks, and rules」 |
なお approval_policy = "untrusted" は別物で、すでに使えません。設定リファレンスは「Codex and ChatGPT Work no longer support approval_policy = "untrusted"」と書いたうえで、「Project entries with trust_level = "untrusted" in user-level ~/.codex/config.toml remain supported」としています。この 2 つの区別は Codex の trust_level の設定と untrusted の扱い にまとめてあります。
リリースノートの設定キーが設定リファレンスに無い
v0.168.0 のリリースノートには設定キーが 3 つ出てきます。2026 年 11 月 18 日時点の設定リファレンスと突き合わせると、次のようになりました。
| リリースノートの記述 | 設定リファレンスでの扱い |
|---|---|
features.tui_workspace(サイドの会話を並べる) | キーとしての記載なし。 スラッシュコマンド /side の説明の中に 1 回だけ名前が出てくる |
features.image_generation_animation(アニメーション GIF の生成) | 記載なし |
tui.notification_method = "osc777" | キーは記載あり。ただし値は auto / osc9 / bel の 3 つで、osc777 は無い |
incremental_tools_legacy_gcp(v0.167.2) | 記載なし |
tui.notification_method の説明は「Notification method for terminal notifications (default: auto).」です。auto の挙動も書かれていて、端末が対応していそうなら OSC 9 を使い、そうでなければ BEL(\x07)にフォールバックします。関連するキーとして tui.notification_condition(unfocused / always、既定は unfocused)と tui.notifications があります。
つまり、通知方式を変えたいなら osc9 か bel を指定するのが確認できる範囲です。osc777 はリリースノートにのみ書かれています。config.toml 全体の書き方は Codex の config.toml の書き方と主要な設定キー を参照してください。
features.multi_agent の非推奨はドキュメントに反映されていない
v0.168.0 のチョアに次の 1 件があります。
Codex warns when
features.multi_agentis explicitly configured and points toagents.enabledfor disabling subagent tools.
両方のキーは設定リファレンスに存在します。ただし features.multi_agent が非推奨である、という記載はありませんでした。
| キー | 設定リファレンスの説明 |
|---|---|
features.multi_agent | 「Enable multi-agent collaboration tools (spawn_agent, send_input, resume_agent, wait_agent, and close_agent)」+「(stable; on by default).」 |
agents.enabled | 「Enable or disable multi-agent tools (default: true).」 |
同じ表の中で、ほかのキーには非推奨の印が明示されています。features.codex_hooks は features.hooks の deprecated alias、features.web_search は "Deprecated legacy toggle"、agents.max_threads は agents.max_concurrent_threads_per_session の "Legacy alias" と書かれています。features.multi_agent にはこの種の印が付いておらず、stable 扱いのままです。
起動時に警告が出るようになった以上、新しく書くなら agents.enabled を使うのが無難です。ただし 現時点では、どちらが正式な指定方法なのかは公式ドキュメントでは確認できませんでした。
そのほかの変更
TUI まわりの追加です。
- サイドの会話が複数のタブに対応し、ローカルに保存したサイドチャットは再起動後に開き直せる(v0.169.0)
- 全画面のトランスクリプトで Collapse turn details を有効にすると、完了した作業をプロンプトの下にたたみ込める。回答は見えたままで、ツールの出力は検索可能(v0.169.0)
- ターミナルのレポートエディタで
Ctrl+Sを押すと、アップロードを無効にしていてもローカルに診断用の ZIP を保存できる(v0.169.0) - モデルプロバイダーを Sessions → Model providers から選び、新しいチャットの既定にできる(v0.168.0)
leader キーは公式ドキュメントに無い
v0.168.0 のリリースノートは features.tui_workspace の説明で「press leader z to zoom the focused pane」と書いています。しかし leader キーという概念は公式ドキュメントでは確認できませんでした。 キーバインドの設定 tui.keymap.<context>.<action> で使える表記は ctrl-a、shift-enter、page-down、minus のような正規化された名前で、プレフィックスを伴う指定の記載はありません。
修正では、codex exec の信頼判定のほかに、Windows の cmd.exe のパスが引用符で囲まれている場合のサンドボックス処理、共有の app server が報告しなかった MCP サーバーを待ち続けてビジー状態が続く問題、中断したターンの後片付けが直っています。承認とサンドボックスの組み合わせは Codex CLI の approval mode と sandbox 設定の違い に整理しました。
まとめ
codex execは信頼していないディレクトリでプロジェクト設定を読まない。--sandbox workspace-writeでは広がらず、--trustを明示する- 設定ファイルで先に指定するなら
projects.<path>.trust_levelに"trusted"を書く。approval_policy = "untrusted"とは別物 features.tui_workspace、features.image_generation_animation、incremental_tools_legacy_gcpは設定リファレンスに記載がないtui.notification_methodの documented な値はauto/osc9/belの 3 つで、osc777は含まれないfeatures.multi_agentは起動時に警告が出るようになったが、設定リファレンスでは非推奨の印が付いていない
よくある質問
- CI で codex exec を使うと MCP サーバーが読まれなくなりました。
- v0.169.0 の変更です。信頼していないディレクトリでは --sandbox workspace-write を付けてもプロジェクト設定と MCP サーバーが無効のままになります。--trust を明示すると、その実行と以降のチャットに対して信頼が保存されます。
- プロジェクトの信頼は設定ファイルでも指定できますか?
- できます。projects.<path>.trust_level に "trusted" か "untrusted" を書きます。untrusted のプロジェクトは、プロジェクト側の .codex/ レイヤー(設定・フック・ルール)を読み込みません。
- tui.notification_method に osc777 を設定できますか?
- 2026 年 11 月 18 日時点の設定リファレンスに載っている値は auto・osc9・bel の 3 つで、osc777 の記載はありません。v0.168.0 のリリースノートにのみ書かれている値です。
参考にした一次情報
この記事は公式ドキュメントを基に AI が下書きを作成し、運営者が内容を確認して公開しています。誤りを見つけた場合は お問い合わせからお知らせください。