PuppyIP 资源中心
AI 工具教程 6 分钟 发布于 2026-11-14

Codex CLI 0.169:项目信任与批准计划交接变化

Codex CLI 0.169 将文件写入权限与项目配置、MCP 信任分开处理;批准计划也会先确认新会话能完整读取,再切换上下文。

Codex CLI codex exec 项目配置与信任 批准计划

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 在未信任目录中,codex exec 即使使用 --sandbox workspace-write,仍会禁用项目配置和 MCP;文件写入权限本身不代表项目已受信任。
  • codex exec 与 codex review 可显式使用 --trust 保存当前及后续会话的项目授权;即使加上 --ephemeral,该授权仍会保留。
  • 信任项目可能加载其 MCP 配置,并允许相关 MCP 命令在 sandbox 外运行;应先审阅项目配置,再由有权限的人明确决定。
  • 批准计划先通过附件交给新执行器并核对内容;读取失败时才尝试传入完整计划,若完整计划放不下,就报错并保留原会话。

workspace-write 只说明写入权限,不等于信任项目

Codex CLI 0.169.0 于 2026 年 11 月 13 日发布。版本说明明确指出:在未信任目录中运行 codex exec 时,即使指定 --sandbox workspace-write,项目配置与 MCP 服务器仍保持禁用。workspace-write 解决的是任务可在工作区写入什么;它不会替你确认项目配置或 MCP 命令值得执行。

所以,如果自动化任务能改文件,却看不到预期的项目设置或 MCP 工具,首先要分清这两道边界:sandbox 权限决定允许哪些操作,项目信任决定是否加载项目配置及其 MCP。不要把“可以写工作区”当作项目已经审查过的证明。

exec 与 review 的 --trust 会保存项目授权

0.169 为 codex exec 和 codex review 增加 --trust,用于明确保存对项目的信任。授权适用于当前和之后的会话;加上 --ephemeral 也不会让这项信任自动变成一次性设置。需要一次性会话但不希望留下项目授权时,不能假定 ephemeral 会撤销 trust。

这项选择会使项目配置和 MCP 可参与运行,其中 MCP 命令可能在 sandbox 之外执行。CLI 会拒绝对已明确标记为不信任的项目授予信任,也不允许 --trust 与 --ignore-user-config 同时使用。

先审阅配置,再由有权限的人明确授信

在决定是否使用 --trust 前,先确认当前工作目录确实是预期项目,并阅读会被加载的项目配置、MCP 服务器定义及其启动命令。重点检查这些设置会启动什么程序、访问什么资源,以及是否符合这次任务的授权范围;文件写入 sandbox 不能替代这一步。

如果目录来源、配置内容或命令用途不清楚,继续按未信任项目运行,并先查明来源。只有审阅结果足以支持该决定、且操作者有权授信时,才显式选择 --trust。官方变更不是要求用户跳过警告,也不会自动替任何项目作出授权。

批准计划先交给新执行器验证,再清空旧上下文

“Yes, clear context and implement”(确认、清除上下文并实施)现在会把已批准的计划保存为 app-server 附件,并让新会话收到引用它的简短提示。交接准备阶段会验证新线程的执行器能够读取附件,而且读到的内容与刚批准的计划一致;这一步确认的是计划可用且匹配,不是单纯创建了一个文件。

如果附件无法写入或读取,客户端会尝试把完整计划作为 proposed_plan 工具输出放入新会话上下文,同时遵守模型上下文和截断限制。只有完整计划能够放入时才可继续;不会用一段被截断的计划冒充完整交接。

准备失败会保留会话,其他修复也有明确范围

如果完整计划无法在限制内传入,新流程会返回错误并保持当前会话;界面只会在计划准备成功后才清除上下文并切换线程。这让用户能留在原会话里处理失败,而不丢掉还没交接成功的计划。这里描述的是 0.169 的客户端交接流程,并非一次本地 CLI 升级或配置测试。

同一版本还修复了若干有边界的问题:Windows sandbox 对带引号的 cmd.exe 路径及 PowerShell 工作目录不可读父目录的处理;终端等待共享 app-server 未报告的 MCP 服务器;以及中断回合、延迟 abort 或文件审批取消误影响后续回合。它们是列明的修复范围,不证明所有卡住或长时间中断都有相同原因,也不代表所有中断问题都已解决。

资料来源

常见问题

--trust 会切换供应商,或增加模型、配额和地区权限吗?

不会因为这个标志而授予账号模型资格、配额或地区访问权限;0.169 的变更说明聚焦项目配置与 MCP 信任。项目配置获准加载后可能影响项目级设置,因此仍需审阅有效配置,并另行核实账号和供应商权限。

终端发布到 0.169,是否证明桌面、编辑器或远程主机也已更新?

不能。发布说明描述的是 Codex CLI。应在实际运行命令的主机、执行器和客户端分别核对版本;本文没有安装或升级 CLI,也没有更改设置或授予项目信任。