这一版最值得升级的地方

Codex CLI 0.166.0 的主线是「长会话更好用」。终端里的 transcript 现在支持键盘按词、按行、按页选择,带集成搜索和可配置快捷键;对经常让 agent 跑几十分钟、输出几百屏的开发者,这比再调一个模型参数更直接。

codex queue --resume 解决的是另一个具体问题:消息排队后线程可能被卸载,以前要重新开一轮,现在可以把卸载的线程接回来。它适合「先让它跑着,我去开会」的用法,但恢复后仍要检查上下文有没有丢。

排障与审批

codex doctor --network-only 把网络、连接和 WebSocket 诊断单独拿出来,不跟配置检查混在一起;出错时能更快判断是代理、DNS、证书还是服务端。审批方面,恢复或 fork 线程会保留已经确认的权限设置,减少重复点「允许」;审批弹窗也不再挡住历史详情的展开。

这些改动不炫,但都指向同一个方向:让 agent 的长任务更接近「可以离开键盘一会儿」的状态。代价是权限保留得更久,团队要确认共享机器上的审批边界,别让下一个人接手时继承了不该有的权限。

模型与稳定性

GPT-6.1 Terra 进入内置、Vertex AI 和 Amazon Bedrock 的模型目录;同时修了 macOS 上安装路径含非 ASCII 字符、线程恢复、TUI 重连、推理 token 计费在 resume/fork 时提前触发压缩等问题。对中文用户名或中文路径的 macOS 用户,非 ASCII 路径修复是实打实的。

alpha 里有什么,为什么不建议直接用

11 月 3 日的 0.167.0-alpha.4 允许在审批弹窗还开着时展开代码变更详情,看完再决定是否批准。这个交互很合理,但它只在 alpha 通道,稳定版仍是 0.166.0。把它们混为一谈,会在团队里造成「文档说能,实际装不到」的落差。

适合谁,不适合谁

  • 适合:每天在终端里跑 coding agent、需要长会话检索和恢复的个人与小队。
  • 适合:用 macOS 且用户名/路径含中文,之前被安装或恢复问题卡过的人。
  • 不适合:想要图形界面、可视化 diff 和多人协作面板的团队;Codex CLI 仍是终端工具。
  • 不适合:把 alpha 功能写进生产流程的团队;0.167 的变化要单独验证。

升级检查清单

升级后先跑 codex doctor --network-only,确认代理和 WebSocket 正常;再开一条长会话,试 transcript 搜索、queue --resume 和恢复后的权限状态。团队共用机器要清点保留的审批,避免「上次允许过」变成默认放行。最后把版本号写进项目文档,别让成员以为 0.167 的 patch 预览已经可用。

一句话:0.166.0 是把长会话的摩擦力磨小的一版,值得升级;但它不是「Codex 变成了新工具」,alpha 里的好东西还得再等。