Codex 0.169.0 之后,CI 里的 codex exec 不再读仓库配置:把"能写"和"可信"拆成两件事

2026-11-17 SkillsCodexCI沙箱供应链安全

先说这条改动的原文,一句话:

codex exec keeps project configuration and MCP servers disabled in untrusted directories, even with --sandbox workspace-write. Use --trust with codex exec or codex review to explicitly save project trust.

翻译:没被信任过的目录里,codex exec 不再读项目配置、不再启动仓库声明的 MCP server,即使你给了写权限。要恢复,得显式 --trust。

为什么改

因为 .codex/ 目录里的配置能把 MCP server 定义成一行命令。Codex 启动时会去跑它。这行命令在沙箱之外执行——写权限管的是文件,管不了这条命令。

于是”克隆一个仓库、跑一次 codex exec --sandbox workspace-write”就等于:仓库作者决定你的机器上启动什么进程。CI 里没人盯着,fork 来的 PR 谁都能改这个文件。

旧逻辑把”允许写文件”当成了”这个目录值得信任”,这是两件事。0.169.0 把它们拆开了。

你的 CI 有没有中招

先在仓库里搜一遍:

grep -rn "codex exec\|codex review" .github scripts Makefile 2>/dev/null

每一条命中都问三个问题:

  1. 这个 job 跑在谁的目录里?(自己的仓库 / fork 的 PR / 拉下来的第三方项目)
  2. 它依赖项目级配置或仓库里声明的 MCP server 吗?
  3. 升级到 0.169.0 之后,它还需要这些吗?

三个问题里”是、是、是”的那几条,就是会静默少功能的 job。

三种处理方式,按风险从低到高

方式一(推荐):把 CI 要用的 MCP 放到 runner 的用户级配置里。

不依赖仓库配置,就不需要信任仓库,--trust 根本不用出现:

# ~/.codex/config.toml(runner 上,随镜像烤进去)
[mcp_servers.repo-checks]
command = "npx"
args = ["-y", "@your-org/repo-checks-mcp"]

仓库里的 .codex/config.json 爱写什么写什么,反正不加载。fork 的 PR 也影响不到你。

方式二:只给自己的仓库加 --trust。

codex exec --trust --sandbox workspace-write "run lint and fix"
codex review --trust

注意 codex review 同样有这个问题、同样有这个开关。信任状态会写进用户级 config.toml:

[projects."/home/runner/work/app/app"]
trust_level = "trusted"

方式三:fork 出来的目录,永远不加 --trust。 这不是”暂时不方便”,这就是这个版本想给你的保护。

五条验收标准

  1. 基线:在干净 checkout 里跑一次原来的 codex exec 命令,任务能跑完(退出码 0),但仓库里声明的 MCP 工具不在工具列表里。先把这个现象记下来,不然升级完你不知道”少了什么”
  2. 恢复:加 --trust 重跑,同样的工具回到列表里,输出和升级前一致
  3. 隔离:对 fork PR 的 checkout 不加 --trust,工具确实起不来;此时不要为了让日志看起来干净而补上这个参数
  4. 信任表干净:~/.codex/config.toml 里 [projects."…"] 只出现你自己的仓库路径。共享 runner 上留下别人的路径,等于给下一个 job 留了一把钥匙
  5. 产物一致:升级前后跑同一个真实任务,对比调用次数、用到的工具、最终产物。功能缺失不会报错,只会让 agent 换一条更笨的路

几个会踩到的坑

它不报错。 退出码是 0,任务照常”完成”,只是少了工具。有说法是日志里会留一行提示(PR 里加了 warning),但也有实测看不到的——所以验收看工具列表,别看退出码。

--trust 是持久化的。 它写进用户级配置,不是”这一次”。在共享 runner 上,这意味着这个 job 给后面的 job 留了信任记录。要一次性的话,得自己在 job 结束后清掉那条 [projects."…"]。

两个组合会被拒:--trust 不能和 --ignore-user-config 一起用;已经显式标成 untrusted 的项目会拒绝 --trust,得先改信任设置。

--ephemeral 挡不住。 不存 session 文件,但信任记录照样写。

版本要钉住。 11 月 17 日一天里这个仓库发了 5 个 alpha 版本、合了 50 个 PR。CI 里跑 codex@latest,某天早上行为变了你不会收到通知。

顺带一句,同一个版本还修了两个 Windows 沙箱问题:带引号的 cmd.exe 路径、以及 PowerShell 会话的工作目录父级不可读。在 Windows runner 上跑的人值得升。

怎么想这件事

这次改动值得抄的不是 --trust 这个参数,是那条判断:“能写文件”和”可以执行它声明的命令”是两个权限。 你有多少个工具、多少个 CI job、多少个 agent,还在把前者当成后者?

原文:https://github.com/openai/codex/releases/tag/rust-v0.169.0