OpenAI 在 2026 年 9 月 9 日把 Codex CLI 0.154.0(GitHub 标签 rust-v0.154.0)标成 Latest。发行说明里的新功能第一句是:Experimental worktree support lets you create isolated checkouts for new or forked sessions using --worktree or /worktree, then browse and resume them。ChatGPT 与 Codex 的官方 changelog 同一天用了同一句话。安装命令写的是 npm install -g @openai/codex@0.154.0。

本地用 Codex 的摩擦很具体:Agent 直接改当前工作区,未提交的试验、进行中的功能分支和一次“顺手修测试”会叠在同一份 dirty tree 上。回滚要靠 git 手拆。本文只写 worktree 这一件事:它改了会话的检出位置,没有改模型,也没有把实验标签拿掉。
AI Coding 交流群
如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。
发生了什么
0.154.0 把 Git worktree 做成 CLI 的一等入口。官方措辞是 isolated checkouts,对象是 new or forked sessions,入口是命令行 --worktree 和 TUI 的 /worktree。做完之后可以 browse 和 resume。相关 PR 在发行说明里列出:#42652、#43069、#43120、#43286。changelog 还写了配套能力:managed creation/listing,覆盖 codex exec、interactive 与 fork 会话,以及 TUI 命令、linked-worktree discovery、TUI browser。
必须保留的限定词是 Experimental。发行说明没有把它写成稳定功能,也没有宣布默认对所有旧会话生效。它解决的是“会话落到哪一份检出”,不是“Agent 是否写对代码”。同版本还有 GPT-6-Astra 进入模型选择器和 Amazon Bedrock catalogs、inline answers(会话进行中可回答问题且保留主草稿)、Windows 共享后台 server,那些是相邻功能,不是本文事件。
ChatGPT iOS 1.2026.244 的 changelog 日期是 2026 年 9 月 8 日,已经允许为新 worktree 选择起始分支,或带上当前本地改动,并在 iOS 26 用 Live Activity 显示后台创建进度。CLI 0.154.0 是同一条工作流落到终端里的版本,而不是手机端的替代说明。官方文档没有把 CLI 描述成“会自动清理所有 worktree 的管家”,人仍要把 git 工作树列表当作最终核对。
完整工作场景:新会话先换目录再动手
输入还是一条 Codex 任务,例如“给支付回调补失败重试,不要动主分支上的本地改动”。操作从“在当前仓库直接开会话”变成:用 --worktree 起新会话,或在已有会话里 /worktree 做 fork。CLI 为这次会话准备独立 checkout,Agent 的文件编辑、测试和后续 resume 都对着这份检出,而不是你正在打字的那份 dirty tree。
交付物仍是会话里的 diff 和命令输出,但反馈路径变了:主工作区可以继续手写别的功能;要复查 Agent 时,browse/resume 回到它的 worktree,而不是在 git status 里把两摊改动拆开。fork 场景更明显:你让 Agent 试另一套实现,主会话的 diff 不应被覆盖。exec 非交互任务同样走 managed creation,适合脚本里起隔离任务,而不是只在 TUI 里手点。

一个可核对的验收动作:在有未提交改动的仓库里,用 --worktree 开新会话改另一个文件;主工作区的 dirty 文件应保持不动,resume 后仍应回到 Agent 那份检出。若两条会话写在同一份工作树上,说明你没用上这个入口。试用结束后用 git worktree list 核对多余目录,不要假设 CLI 会自动清掉它没创建的路径。若 resume 时打开了错误目录,应先停掉写入,再核对会话与检出的对应关系,而不是继续让 Agent 往主树上叠补丁。
为什么这会改变工作流
因果在目录,不在模型。并行 Agent 的真实成本,经常不是 token,而是工作区互相覆盖。以前要用手执行 git worktree add、记路径、再把 Codex 指过去;现在创建、列出、恢复写进同一套 CLI/TUI。fork 会话尤其需要这条路径:你想让 Agent 试另一方案,又不想把正在看的 diff 弄乱。
它也把“能不能 resume”从会话 ID 扩展到检出路径。官方写的是 browse and resume them,意味着 worktree 不是一次性临时目录文案,而是会话生命周期的一部分。实验标签同时提醒:路径规则、清理策略和子命令覆盖范围都还可能改。发行说明没有承诺 CLI 会删除它没创建的目录,人仍要自己做卫生。和“再换一个更强模型”相比,先把文件改动隔开,往往更能减少一次返工。
对已经用 worktree 板手动并行的人,价值是少一层路径记忆;对一直在主工作区里开 Agent 的人,价值是第一次有官方入口把隔离写进会话。两种人都不应该把实验开关理解成默认安全网。
限制与人接管点
Experimental 表示行为、默认值和可用性都可以变,不适合写成团队强制规范。官方句子只覆盖 new or forked sessions,没有说正在跑的旧会话会自动迁走。登录类子命令是否拒绝该旗标,要以你安装的 0.154.0 实际报错为准,本文不把社区讨论里的拒绝列表写成已发布合同。
Worktree 不代替代码审查、测试和密钥扫描。Agent 仍可能在隔离目录里写出错误补丁,或读到仓库内本就存在的密钥文件。它也不等于企业托管沙箱:文件系统和联网策略不会因为换了 checkout 就自动收紧。同版本的 inline answers、GPT-6-Astra 选择器、Windows daemon,不要和 worktree 拼成一篇能力清单。Python SDK 0.154.0 的 ExternalMessage 以及 max/ultra reasoning-effort 是另一条 changelog,不是 CLI worktree。Agents API 公开测试是 9 月 10 日的独立事件,也不在本文范围。
官方把能力写进创建、浏览和恢复,没有把“自动合并回主分支”写成功能。人仍要自己把隔离目录里的提交做成 PR,再跑原有的测试和审查。Worktree 只保证改动先分开,不保证改动正确。
如何试用
把 CLI 升到 0.154.0:npm install -g @openai/codex@0.154.0,用 codex --version 核对。在一个有未提交改动的仓库里,用 --worktree 开新会话,或在 TUI 输入 /worktree。完成一次小改动后 browse/resume,确认主工作区未被覆盖。不要在第一次试用时对生产分支做大规模重构。若命令不被识别,先确认装到的是 0.154.0,而不是旧的全局二进制。试用完毕后检查 git worktree list,把不再需要的检出按你们仓库规范删除或归档。
信息来源
- openai/codex GitHub Release:rust-v0.154.0(2026-09-09)
- ChatGPT & Codex changelog(2026-09-09 Codex CLI 0.154.0;2026-09-08 iOS worktree)
开发必备:API 全流程管理神器 Apifox
介绍完上文的内容,我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、调试、设计、测试、Mock、自动化测试于一体的工具,Apifox 是目前提升研发效率的首选。
如果你正在开发项目,不妨试试其极其友好的界面设计,它完全兼容 Postman 和 Swagger 数据格式,导入数据非常方便,,即使是新手也能很快上手,点击这里即可注册使用。

值得一提的是,除了个人和常规团队使用,针对有高安全合规要求、或需要在内网环境协作的企业,Apifox 还提供了深度定制的私有化部署方案。
获取专属报价与部署方案
详细的私有化部署系统架构与安全白皮书
针对您公司规模的专属报价单
免费的 1v1 专属产品演示 (Demo) 机会