PuppyIP 资源中心
开发者工具动态 5 分钟 发布于 2026-11-12

Codex 0.167.2:Vertex 增量工具默认开启与关闭方法

Codex CLI 0.167.2 正式版已将 Google Cloud Vertex AI 的增量工具声明设为默认开启。使用 Vertex 的开发者应先核对实际版本与 gcp provider,再决定是否保留该行为;需要关闭时,修改的是独立的 incremental_tools_legacy_gcp 开关。

Codex CLI 0.167.2 Vertex AI 增量工具 配置

服务对象与地域限制

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

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

本文要点

  • 0.167.2 于 2026 年 11 月 11 日 22:44:46 UTC 发布为正式版;这次默认变化针对 Google Cloud Vertex AI。
  • 常规 Responses 路径中,精确的 gcp provider ID 使用 incremental_tools_legacy_gcp,默认值为 true,标记为 Stable。
  • 需要退出时,在 config.toml 的 [features] 中设置 incremental_tools_legacy_gcp = false;Bedrock 与 Responses Lite 使用其他开关。
  • 工具声明变化不等于工具已经执行,也不证明模型权限、费用、额度重置或 Tibo 的承诺已有新进展。

0.167.2 改变了哪一种请求?

OpenAI 于 2026 年 11 月 11 日 22:44:46 UTC 发布 Codex CLI 0.167.2,发布记录明确说明:Google Cloud Vertex AI 现在默认发送增量工具更新。工具声明是给模型看的工具名称、参数等目录说明;声明更新与真正调用工具、运行命令是不同环节。

这个补丁适合已经通过 Vertex 使用 Codex 的开发者核对。正式版发布不代表本机 CLI 已升级,也不代表任一账号已取得模型或区域访问资格;本文没有执行真实 Vertex 请求,亦没有测量性能或费用变化。

先确认 gcp 标识和实际请求路径

0.167.2 标签中的 provider 定义把 Google Cloud Vertex AI 的 ID 设为 gcp。在常规 Responses 路径上,最终生效的 model_provider_id 必须精确匹配这个值,才选择 IncrementalToolsLegacyGcp 对应的功能项;端点支持兼容接口或名称里写着 Vertex,本身不能证明匹配。

还要区分 Responses Lite。代码先检查 use_responses_lite;若走这条路径,使用的是 incremental_tools,而不是 Vertex 专用开关。因此,排查时应同时记录实际客户端版本、最终 provider ID、请求路径与生效配置,不能只看一个配置文件中是否出现了 gcp。

怎样关闭 Vertex 的默认增量行为?

官方发布说明给出的退出方式是:在 config.toml 的 [features] 中设置 incremental_tools_legacy_gcp = false。已有 [features] 段时,修改该段内对应键,避免为了加入这一行再复制一个同名段;保留原配置副本,便于恢复。

例如,假设团队需要比较原有工具目录布局与增量布局,可以在获准的隔离配置中明确设为 false,再观察该配置实际生效后的请求。这里是配置示例,不是本文完成的实验。若决定恢复 0.167.2 的默认行为,可移除这个显式关闭项或设为 true,再核对最终生效值。

为什么不能照搬 Bedrock 的开关?

0.167.2 对 amazon-bedrock 和 amazon-bedrock-runtime 继续选择 incremental_tools_legacy,默认值仍为 false;它与默认开启的 incremental_tools_legacy_gcp 是两个独立功能项。只把 Bedrock 那一项设为 true,不等于控制了 Vertex 的行为。

同一标签的功能表还将 Bedrock 的 legacy 项标记为 Stable;0.167.1 中的 UnderDevelopment 描述只适用于那个旧版本,不能原样当作 0.167.2 的当前阶段。Stable 标记与默认开启也应分开理解:Bedrock 这一项已标记稳定,但仍默认关闭。

如何判断变化是否真的生效?

先确认真正运行的二进制版本,再核对配置选择了哪条 provider 分支。对于获准的测试环境,可比较工具目录变化前后的请求是否出现 additional_tools 历史声明,以及模型能看到的工具是否与当时可用目录一致;诊断材料应先脱敏,不公开令牌、私人提示词或完整任务内容。

上游比较记录包含 GCP 默认开启和显式退出的测试场景,也检查了独立 Bedrock 开关。这些是仓库中的验证范围,不是你的环境已经通过验收;工具被列出、请求成功和工具实际执行成功也需要分别判断。

这次发布没有确认哪些权益或效果?

发布记录和本次标签代码没有提供延迟、token 用量、缓存命中或成本节省的测量结果,也没有宣布新增账号资格、地区开放或免费额度。访问权限、模型支持与计费仍按实际 Vertex 服务条件核实,网络出口变化不会替代这些条件。

这是一条独立的 Codex CLI 发布消息,不是 Tibo 宣布重置已发放的证据。它也不能解释所有 Workspace Agent 启动故障;遇到服务问题,应分别核对对应官方状态和原任务结果,再决定是否重试外部操作。

资料来源

常见问题

自定义 provider 别名也会默认开启吗?

不能仅凭别名判断。0.167.2 的常规 Responses 分支检查最终 model_provider_id 是否精确为 gcp;Responses Lite 另走 incremental_tools。先检查最终生效的标识和路径,再判断对应开关。

关闭这个开关会取消模型访问或重置用量吗?

本次开关控制的是工具声明布局,官方发布没有把它描述为账号权限或用量重置设置。不能用它申请模型访问、改变计费资格,或证明一次重置已到账。